Rational Developer for System z, Version 7.5

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 and Map to generate

Type of Cobol to generate
In this field, you specify the COBOL variant for the generated Screen.
Values 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 SERIES A 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 SERIES 2200 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 Series A 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 Series A 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
Here you select the type of label which will be associated with each Data Element on the Screen.

At the Screen level, it is used to override the global selections 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.

The values for the label type correspond to the association between the Data Element and the presentation characteristics for these labels (left-justified...).

You must select a value among the following ones:
Values Comments
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 position
T: Data Element with short label, right-justified The Data Element is preceded by the short label, right-justified, on 18 position
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 2–line column label  
3: Data Element topped by 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 contents 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.
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.

Character for screen help
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 hardware using PFkeys, instead of entering a character in this field, you can assign 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 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 on as in an IBM environment.
  • TANDEM variant: It is not possible to use a character; only the values ranging from 01 to 32, corresponding to 'F1' to 'SF16', are possible.
  • DEC/VAX variant: The values used for PFKeys coding are 01, 02, 03, 06 to 11' and 14 to 20.
  • 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.
Character for data element help
You can enter any character, left-justified, in this field. It is recommended to use this character only for the call of 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 hardware using PFkeys, instead of entering a character in this field, you can assign a specific PFkey to call the documentation associated with the field. If the screen Help call field is coded with one character, you must also code this field with one character, In the same way, if it is coded with a PFkey number, you must also code this field with a PFkey number.

The documentation request will automatically be taken into account by the generated program by positioning the cursor on the selected Data Element or by pressing the PFkey defined at this level.

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: It is not possible to use a character; only the values ranging from 01 to 32, corresponding to 'F1' to 'SF16', are possible.
  • DEC/VAX variant: The values used for PFKeys coding are 01, 02, 03, 06 to 11' and 14 to 20.
  • 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 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)