CA ADS Runtime System › Runtime Menu and Help Screens › Menu Screens

Menu Screens

Specifying a Menu Function

Functions are defined as menu functions or menu/dialog functions on the Response/Function List screen during application definition. The menu associated with a function can be further described by using the Function Definition (Menu) screen. The application developer can indicate on this series of screens whether the menu map is system-defined or site-defined and provide a heading for the menu map.

System-defined menu maps can be associated with menu functions or with menu/dialog functions. A site-defined menu map must be associated with a menu/dialog function.

ADSO-APPLICATION- MENU-RECORD

The CA ADS runtime system uses ADSO-APPLICATION-MENU- RECORD to create menus. All menu maps must include ADSO- APPLICATION-MENU-RECORD as a map record.

When the map of a menu function or menu/dialog function is mapped out, the runtime system initializes ADSO-APPLICATION-MENU- RECORD and moves as many responses and descriptions as possible into the fields provided by the menu map. If the menu is defined on the Function Definition (Menu) screen as a site-defined menu, the runtime system moves as many responses and descriptions as specified on the Function Definition (Menu) screen. If a response has no description, the runtime system displays the description for the function associated with the response. AMR-RESPONSE-FIELD is initialized with the default response specified for the function.

Selecting a Response

When the menu is displayed on the screen, the user can select a response in one of the following ways:

• By pressing the control key associated with the applicable response
• By entering a nonblank character in the field immediately preceding the applicable response
• By entering a response name in the field that maps to AMR-RESPONSE-FIELD

The runtime system passes the selected response to the AMR- RESPONSE-FIELD of ADSO-APPLICATION-MENU-RECORD. If the user uses more than one type of response selection, the response selected by using a control key has precedence over a response selected by a nonblank character, which has precedence over a response name entered in a RESPONSE field. If the user presses the ENTER key without selecting a response, the default response remains in AMR-RESPONSE-FIELD and is considered in the determination of the runtime flow of control.

The value in AMR-RESPONSE-FIELD determines the next function to be executed from a menu function.

The CA ADS runtime system processes system-defined and site-defined menu maps in the same way, as described below.

More information:

CA ADS Application Compiler (ADSA)

System Records

Runtime Flow Of Control