Rational Developer for System z, Version 7.6

Dialog/Screen Definition tab

This tab is common to the Dialog and its constituting Screens. It enables you to specify the presentation characteristics of the Screens and the default values of the Screen attributes. The values chosen at the Dialog level become the default values of the Screens and are marked as 'Inherited' on the Screen Definition tab. Inappropriate default values can be overridden at the Screen level.

Dialog type
This field allows to initialize the Dialog or Screen type.
Type of Cobol to generate
In this field, you specify the COBOL variant for the generated Screen.
Value Meaning
Default Value of the Generated Language field in the Library Definition tab.
N No generation
X IBM MVS COBOL II, IBM VSE COBOL II
0 IBM MVS COBOL/VS
1 IBM VSE COBOL/VS
3 MICROFOCUS COBOL, IBM AIX-OS/2-WINDOWS/NT COBOL
4 BULL GCOS7 COBOL
5 BULL GCOS8 COBOL
6 BULL GCOS8 COBOL, TP8 Screens
8 UNISYS A-SERIES COBOL
F TANDEM COBOL
I DEC/VAX VMS COBOL
K ICL 2900 COBOL
O IBM AS/400 COBOL
Q ACU COBOL
R TUXEDO COBOL
U UNISYS 2200–SERIES COBOL
TP Monitor Variant
In this field, you specify the variant of the TP Monitor for the generated Screen.
Values Meaning
Default Retrieval of default value
N No generation
0 Variants 0, 1, X for CICS (IBM) (programs and BMS maps).

Variant 2 for IBM 36, monochrome map.

Variant 3 for PC/MICROFOCUS (MS/DOS).

Variants 4, 5, 6 for QUESTAR.

Variant 7 for VPLUS.

Variant 8 for UNISYS A-Series SDF format.

Variant I for DEC/VAX.

Variant M for GCOS6-DTF-DFC-Vision.

Variant Q for UNIX, Windows (ACUCOBOL).

Variant U for UNISYS 2200 (programs and FLDP maps).

Variant Y for IBM 38.

Variant O for AS 400.

1 Variants 0, X for IMS (IBM) (programs and MFS maps).

Variant 2 for IBM 36, color map.

Variant 3 for PC/MICROFOCUS (OS2).

Variants 4, 5, 6 for VIP TYPE.

2 Variants 0, 1, X for CICS (IBM), BMS color map

Variant 3 for MICROFOCUS (UNIX).

3 Variants 0, X for IMS (IBM), MFS map in color.
4 Variants 0, X for IMS (IBM) monitor.

Variant 3 for IBM VISUALAGE COBOL Program.

5 Variants 0, X for CICS (IBM) monitor.
C Variants 4, 5, 6, U for MULTI-TERMINAL.

Variants 0, 1, X for CICS MULTI-TERMINAL.

Variant K for ICL.

Variant 8 for UNISYS A-Series Logical Screen.

F Variant 4 for TDS FORMS (BULL GCOS7).

Variant M for DM6 TP FORMS.

Variant R for 'TPSVRINIT service' type Program or 'TPSVRDONE service' type Program.

R Variant F for 'REQUESTER' type Program. or variant R for 'CLIENT' type Program.
S Variant F for 'SERVER' type Program. or variant R for 'SERVICE' type Program.
'Label presentation' initialization value
The values of this field correspond to the association between the Data Element and the presentation characteristics for these labels (left-justified...).

At the Screen level, it is used to override the selection made at the Dialog level.

There are four possible labels:
  • The long label (36 positions), entered on the Data Element Definition tab.
  • The short label (18 positions), entered on the Data Element -D Lines tab.
  • The relational label (18 positions), entered on the Data Element -D Lines tab.
  • The column heading label, entered on the Data Element -D Lines tab.
You must select a value among the following ones:
Value Comment
Default value Defaults to the value specified in the Dialog.
F: Data Element only  
L: Data Element with long label, left-justified The Data Element is preceded by the Data Element label, left-justified, on 36 positions.
M: Data Element with long label, right-justified The Data Element is preceded by the Data Element label, right-justified, on 36 positions.
N: Data Element with long label, left-justified, trimmed right The Data Element is preceded by the Data Element label, left-justified with suppression of blanks on the right.
R: Data Element with long relational label, left-justified The Data Element is preceded by the relational label, left-justified on 18 positions.
S: Data Element with short label, left-justified The Data Element is preceded by the short label, left-justified, on 18 positions.
T: Data Element with short label, right-justified The Data Element is preceded by the short label, right-justified, on 18 positions.
U: Data Element with short label, left-justified, trimmed right The Data Element is preceded by the short label, left-justified, with suppression of blanks on the right.
1: Data Element topped by a single line column label  
2: Data Element topped by a 2–line column label  
3: Data Element topped by a 3–line column label  
Note: The ':' character is generated for the Data elements preceded by a long, short or relational label. For the Data elements topped by a column label, the greatest length of the Data Element's label and content is taken into account for the relative positioning in the Screen.
Program external name
This is the name of the program that is used in the IDENTIFICATION DIVISION of the generated program and the name of the module in the library of executable modules.
Note: For a Dialog, this field is used only if a monitor is generated.
Map external name
This field is not available on a Dialog.

For CICS, you indicate the MAPSET name.

For IMS, you indicate the FORMAT name.

For TANDEM, you indicate the name of the associated SERVER for an R-type Screen (REQUESTER).

Transaction code
This field corresponds to:
  • The 4-character transaction code (Dialog default code) for a CICS variant.
  • The transaction code associated with the Dialog for an IMS variant. This field appears on all the Dialog Screens except if the MONITOFF option (one transaction code per Screen, no generated Monitor) option is specified.
Screen size: number of lines
This field indicates the number of lines per Screen. This number must range between 1 and 62 inclusive. The Default value is 24 at the Dialog level.
Screen size: number of columns
This field indicates the number of columns per Screen. This number must range between 1 and 80 inclusive. The Default value is 80 at the Dialog level.

The format (number of lines and number of columns) specifies the overall dimensions of the Screen.

When Screen 'X' calls Screen 'Y', the size taken by Screen 'Y' is the size specified on its Definition tab. The relative positioning of the Data Element immediately following the called Screen therefore depends on the format of the called Screen.

'Tabs' initialization value
This field indicates the number of tabulation points per line. The default value is 1 at the Dialog level and the maximum number authorized is 50.

It is used to automatically position the Data Elements on the screen. The tabulation points are the invisible points on the screen, which divide each line into equal parts.

Each Data Element for which no absolute positioning is indicated will automatically be positioned on the next available tabulation point.

'Character' initialization value
In this field, you specify the default initial value for the variable Data Elements called in the Screen.

This initial value will be positioned in the program associated with the Screen.

Help character for screen
The character you enter here will be used to request documentation on a screen. You can enter any character, left-justified.
It is recommended to use this character only for the call of screen help. The documentation request will be automatically taken into account by the generated program
Note: If the Generated language specified in the Library Definition tab is COBOL II or 85, the tests generated in F8150 to detect the characters for documentation request are carried out on the first character of the field only and not on the whole field as it is the case for standard COBOL.
For the environments which allow the use of PFkeys, you can enter a specific PFkey to call the documentation associated with the screen.
Note: A PFkey and a character cannot be used together for documentation requests in the same Dialog.
Depending on the type of COBOL to generate, some specificities are added:
  • IBM CICS, IBM IMS, AS/400 variants: If you enter a character here, the numeric fields will not be generated as such at the Map level.
  • CICS variants: The following values may also be entered:
    • A1 for the AP1 function key,
    • A2 for the AP2 function key,
    • EN for the Enter key,
    • 00 for the Clear key.
  • BULL multi-screens variant: PFkeys may be used on 3270 screens. In this case, they work as in an IBM environment.
  • TANDEM variant: Entering a character is not allowed; only the values ranging from 01 to 32, corresponding to 'F1' to 'SF16', may be used.
  • DEC/VAX variant: Values 02, 03, 06 to 11 and 14 to 20 may be used for the PFkeys. .
  • MICROFOCUS variant: Values ranging from 01 to 24 may be used for the PFkeys.
  • HP3000 variant: The Help function can only be activated by a character.
Help character for element
You can enter any character in this field. It must be left-justified.

It is recommended to reserve this character for field help.

The documentation request will be automatically taken into account by the generated program.

The character for documentation request at the Data Element level is taken into account.
Note: If the Generated language specified in the Library Definition tab is COBOL II or 85, the tests generated in F8150 to detect the characters for documentation request are carried out on the first character of the field only and not on the whole field as it is the case for standard COBOL.
For the environments which allow the use of PFkeys, you can enter a specific PFkey to call the documentation associated with the a field.
Note: A PFkey and a character cannot be used together for documentation requests in the same Dialog.

The documentation request will automatically be recognized by the generated program when the user places the cursor on a Data Element and presses the PFkey.

Depending on the type of COBOL to generate, some specificities are added:
  • IBM CICS, IBM IMS, AS/400 variants: If the field is coded with a specific character, numeric fields will not be generated as such at the Map level.
  • CICS variants: The following values may also be used:
    • A1 for the AP1 function key,
    • A2 for the AP2 function key,
    • EN for the Enter key,
    • 00 for the Clear key.
  • BULL multi-screen variant: PFkeys may be used if the screens are of the 3270 type. In this case, they work as in an IBM environment.
  • TANDEM variant: Entering a character is not allowed; only the values ranging from 01 to 32, corresponding to 'F1' to 'SF16', may be used.
  • DEC/VAX variant: Values 01, 02, 03, 06 to 11 and 14 to 20 may be used for the PFkeys.
  • MICROFOCUS variant: Values ranging from 01 to 24 may be used for the PFkeys.
  • HP3000 variant: The Help function can only be activated by a character. Since the screen reception does not allow cursor positioning, it would be impossible to find which Data Element was selected.

Intensity attributes

You select here the intensity attributes for five types of fields: Label, Display, Entry, Error message, and Error Field.

These may be selected at the Dialog level and defaulted or overridden at the Screen level. The possible values for each attribute are the same whatever the field type:
  • Default value,
  • N: Normal,
  • B: Bright: The field will be highlighted,
  • D: Dark: The field will be hidden.
Label
Select here the intensity attribute of label-type fields.
Display
Select here the intensity attribute of the display fields of the Screen
Input
Select here the intensity attribute of the input fields of the Screen
Error message
Select here the intensity attribute of the error messages of the Screen
Error field
You select here the intensity attribute of the error fields of the Screen

Presentation attributes

You select here the presentation attributes for five types of fields: Label, Display, Entry, Error message, and Error Field.

These may be selected at the Dialog level and defaulted or overridden at the Screen level. The possible values for each attribute are the same whatever the field type:
  • Default value
  • N: Normal
  • B: Blinking
  • R: Reversed video
  • U: Underlined
Label
Select here the presentation attribute of label-type fields.
Display
Select here the presentation attribute of the display fields of the Screen
Input
Select here the presentation attribute of the input fields of the Screen
Error message
Select here the presentation attribute of the error messages of the Screen
Error field
You select here the presentation attribute of the error fields of the Screen

Color attributes

You select here the color attributes for five types of fields: Label, Display, Entry, Error message, and Error Field.

These may be selected at the Dialog level and defaulted or overridden at the Screen level. The possible values for each attribute are the same whatever the field type:
  • W: Normal
  • B: Blue
  • R: Red
  • P: Pink
  • Y: Yellow
  • G: Green
  • T: Turquoise
Label
Select here the color attribute of label-type fields.
Display
Select here the color attribute of the display fields of the Screen
Input
Select here the color attribute of the input fields of the Screen
Error message
Select here the color attribute of the error messages of the Screen
Error field
You select here the color attribute of the error fields of the Screen

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)