Skip to Content

Dialog Editor

The Dialog Editor is a new component of ISPW. The Editor gives administrators a new way to create customization dialogs. In the initial version of this enhancement, the dialogs are only for the Generate processing and are only displayed within the Topaz Workbench.

Using the Dialog Editor to Create a Custom Dialog

This section provides an overview of how you would use the Editor to create a dialog.

Once you are in the Assignment, you issue the Add command. An example is shown in the following figure.

Add Command in SITE Assignment

ISPW    ADD TASK TO ASSIGNMENT SITE000006
COMMAND ===>

  CUSTOM DIALOGS

  Type (See list of valid types below )
  Name
  Action(C-Compile, D-Delete, F=Fallback, H=History )
  ApplicationSITE(Default=SITE )
  StreamSITE(Default=SITE )
  PathTEST(TEST )

  Filter( " PROD HOLD )

  Release(Default= )
  ImportN(Import From External Source Y/N )

CCLST MSGS PANL SKEL WDLG


Plus module type DATA

Press ENTER to add entry, END to terminate

Notice that the WDLG type is shown in the list of available types. You would enter the Type as WDLG and give the dialog a name in the Name field. An assignment with WDLG types is shown in the following figure.

SITE Assignment with WDLG Type

image2021-2-1_11-49-54.png

The screen shown in the following figure is displayed when you select the new entry. You can only update the title in the Dialog Title field.

ISPW Dialog Definition Screen - Attributes

image2021-2-1_11-50-51.png

Adding an Area

When you have updated the title and pressed Enter, the screen shown in the following figure is displayed.

ISPW Dialog Definition Screen - Edit

image2021-2-1_11-53-39.png

You would select the Area item to get started creating the dialog. The screen shown in the following figure is displayed.

ISPW Dialog Definition Screen - Editing Area

image2021-2-1_11-54-16.png

The ID field is used in a Fld definition that can toggle the Area between being visible and invisible.

  • The Label is the title on the dialog when displayed to users in Topaz.
  • The Cols field is required. It is the number of columns in this Area. It must be a positive integer without a sign.
  • Specifying a Y in the Group field cause the Area and its Flds to be enclosed in a box on the dialog.

The following figure shows an example of a completed entry.

ISPW Dialog Definition Screen - Completed Entry

image2021-2-1_11-55-22.png

Adding a Field

Once you have an Area, you now add Flds to it. You would issue an Insert command on the Area as shown in the following figure.

ISPW Dialog Definition Screen - Insert Command

image2021-2-1_11-56-13.png

The screen shown in the following figure is then displayed. The panel is entirely empty.

ISPW Dialog Definition Screen - Empty Panel

image2021-2-1_11-56-58.png

You must specify Fld. The ID, Type, and Size fields must be specified as well.

  • The ID is the name used to reference the field. This ID cannot contain spaces.
  • The Type defines the field characteristics. The valid values are shown in the Edit panel.
  • The Size defines the number of characters that can be entered of a text Type or the number of items in a List type.
  • The Validator can be used to define one of four validation functions for the field. The available functions are:
    • NONEMPTY
    • DATENOTPAST
    • TIME
    • NUMBER.

An example of a field definition with a validator is shown in the following figure. From the definition, the value entered in the field is expected to be a TIME value. This field is part of the dialog shown in TIME Validation of fld010 in Topaz Workbench Dialog. Notice that the OK button is disabled. When a valid time value is entered in field fld010 (TIME Validation Enables OK Button), the OK button becomes enabled.

Validator Field

image2021-2-1_11-58-42.png

TIME Validation of fld010 in Topaz Workbench Dialog

image2021-12-14_16-48-36.png

TIME Validation Enables OK Button

image2021-12-14_16-49-3.png

  • For a checkbox, the true and false values can be specified.
  • The Toggle Area contains an Area ID that can toggle between being visible and invisible based on the state of the checkbox.
  • The Radio/Combo/List specifies the labels displayed in the dialog and the values returned from the dialog. Use a blank to separate the values and labels. The values and labels can only fill the line in the dialog. An example of the edit dialog is shown in the following figure, and the dialog displayed in Topaz is shown in List for fld050 in Topaz Workbench Dialog.

Dialog Definition Example

image2021-2-1_12-1-42.png

List for fld050 in Topaz Workbench Dialog

image2021-12-14_16-49-31.png

Completed ISPW Dialog Definition

The following figure shows a completed entry for field CMPLEXIT.

ISPW Dialog Definition Screen - Completed Panel

image2021-2-1_12-3-56.png

The following figure shows an example of a completed dialog definition that includes the field CMPLEXIT defined above.

ISPW Dialog Definition Screen - Completed Dialog Definition

image2021-2-1_12-4-43.png

The XML associated with the completed dialog definition is shown in the following figure.

Completed Dialog Definition XML

image2021-2-1_12-5-51.png

Once you have completed the dialog, you must issue a dialog refresh command. The dialog will not be available to Topaz Workbench until this done. To refresh custom dialog data, enter D on the COMMAND line of the M.SM screen as shown in the following figure.

Refreshing Custom Dialog Data

image2021-2-1_12-6-41.png

The following figure shows what a dialog looks like in Topaz Workbench when you select Generate with Parms on a COBOL program.

ISPW Custom Dialog in Topaz Workbench

image2021-12-14_16-50-54.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Compuware ISPW 18.02