CA ADS Dialog Compiler (ADSC) › Dialog Compiler Screens › Map Specifications Screen

Map Specifications Screen

The Map Specifications screen is used to specify a map and map options for a dialog, such as the:

• Map name
• Method of map paging, including overriding automatic display of the first page of a pageable map

Sample Screen

                               Map Specifications

                         Dialog  JPKTD01   Version     1


   Map name  . . . .   ________             Input map . . . . .   ________
   Version . . . . .   ____                 Version . . . . . .   ____
                                            Label . . . . . . .   ________
   Paging options    _ 1. Wait
                       2. No Wait           Output map  . . . .   ________
                       3. Return            Version . . . . . .   ____
                                            Label . . . . . . .   ________
   Paging mode . . . _ Update
                     _ Backpage             Suspense file label   ________
                     _ Auto display


 Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F6=Switch Protection

Field Descriptions

Dialog

Displays the 1- to 8- character name of the current dialog, as specified on the Main Menu screen. This field is protected.

Version

Displays the version number, in the range 1 through 9999, of the current dialog, as specified on the Main Menu screen. This field is protected.

Map Name

Specifies the 1- to 8-character name of the map associated with the current dialog.

The specified map must be defined in the data dictionary. The map load module does not have to exist. If no map name is specified, only a premap process (not a response process) can be associated with the dialog.

Version

Specifies a 1- to 4-digit version number, in the range 1 through 9999, of the corresponding map.

If no version number is specified, version defaults to 1.

Paging Options

Specifies the method used to determine the runtime flow of control when the user presses a control key during a map paging session.

No Wait is the default for pageable maps.

Note: The map paging dialog options No Wait and Update cannot be specified together.

Paging Mode

Specifies parameters for a map paging session.

Update

Specifies that the user can modify map data fields in a map paging session, subject to restrictions specified in the mapping facility and by the map modification process commands. Update is the default for pageable maps.

Note: The map paging dialog options No Wait and Update cannot be specified together. When Update is not selected, all map data fields except $RESPONSE and $PAGE will be protected.

Backpage

Specifies that a previous map pages can be displayed during a map paging session. Backpage is the default for a pageable map.

Auto display

Specifies an override of the automatic mapout of the first page of a pageable map.

When the Auto display option is not chosen, process logic must detect when the first page of the map is built and map out the first page when it is ready for display, even if the page is not full.

The $PAGE-READY pageable map condition should be used to detect completion of the first page. The $PAGE-READY condition should be tested while building the map page to determine when the page is ready for display.

Auto display is the default for pageable maps.

Input Map

(CA ADS/Batch only) Specifies that the named map is an input file map.

Note: Select Switch Protection [PF6] to unprotect the CA ADS/Batch input fields.

Version

Specifies the version number, in the range 1 through 9999, of the current map. If no version number is specified, version defaults to 1.

Label

(CA ADS Batch only) Specifies the z/OS ddname (z/VSE filename and z/VM ddname) of a batch dialog input file map. Specifications made in these fields can be overridden at runtime.

The runtime label for an input map can be specified only if the dialog is associated with an input file map.

Output Map

(CA ADS Batch only) Specifies that the named map is an output file map.

Version

Specifies the version number, in the range 1 through 9999, of the current map. If no version number is specified, version defaults to 1.

Label

(CA ADS Batch only) Specifies the z/OS ddname (z/VSE filename, z/VM ddname) of a batch dialog output file map. Specifications made in these fields can be overridden at runtime.

A runtime label for an output map can be specified only if the dialog is associated with an output file map.

Suspense File Label

(CA ADS Batch only) Specifies the z/OS ddname (z/VSE filename, z/VM ddname) of a batch dialog suspense file. Specifications made in these fields can be overridden at runtime.

The runtime label for a suspense file can be specified only if the dialog is associated with an input file map. A runtime label for a suspense file implicitly specifies that a suspense file is required for the dialog.

Map Considerations

The specified map must be defined in the data dictionary. However, the map load module does not have to exist. If no map name is specified, only a premap process (not a response process) can be associated with the dialog.

The following rules apply to the environments in which a map can be executed.

• A dialog associated with an online map cannot be associated with an input or output file map.
• A dialog associated with an input or output map cannot be run in the online environment.
• A dialog can be associated with both an input and an output file map.
• If a dialog is not associated with any map, it is a mapless dialog and can be executed in both batch and online environments.

More information:

Pageable Maps

Conditional Expressions