CA ADS provides three system-defined menu maps, as follows:
The format for a system-defined nonsignon menu map is specified on the Function Definition (Menu) screen during application definition. The application developer can select a short description format (ADSOMUR1) or a long description format (ADSOMUR2) for nonsignon menus.
Short Description Format
The short description format displays 30 responses per menu page; the long description format displays 15 responses per menu page. The number of responses that are displayed can be modified on the Function Definition (Menu) screen by specifying that the menu is site-defined and by entering the number of responses per page.
Runtime Display
When a menu screen is displayed at runtime, ADS builds the menu by storing the appropriate information in ADSO-APPLICATION- MENU-RECORD. System-defined nonsignon menus map to all but two of the fields in ADSO-APPLICATION-MENU-RECORD.
Sample Short Description Menu Screen (ADSOMUR1)
DIALOG: PAGE: 1 OF: 1 DATE: mm/dd/yy NEXT PAGE: TEST APPLICATION _ PAGETEST (PF22) TEST DIALOG _ FORWARD (PF8) FORWARD _ BACKWARD (PF7) BACKWARD _ POPTOP (PF3) POP TO TOP _ HELP (PF1) HELP _ QUIT (PF24) QUIT _ POP (PF2) POP 1 LEVEL _ LINKMENU (PF13) LINKTO SUBMENU _ LINKPAGE (PF14) LINK TO DIALOG _ START START OF LIST _ EDIT (PF17) TESTING BUG FIX RESPONSE: SEND DATA--> MODE: STEP
Sample Long Description Menu Screen (ADSOMUR2)
DIALOG: PAGE: 1 OF: 1 DATE: mm/dd/yy NEXT PAGE: TEST APPLICATION _ PAGETEST (PF22) TEST DIALOG _ FORWARD (PF8) FORWARD _ BACKWARD (PF7) BACKWARD _ POPTOP (PF3) POP TO TOP _ HELP (PF1) HELP _ QUIT (PF24) QUIT _ POP (PF2) POP 1 LEVEL _ LINKMENU (PF13) LINKTO SUBMENU _ LINKPAGE (PF14) LINK TO DIALOG _ START START OF LIST _ EDIT (PF17) TESTING BUG FIX RESPONSE: SEND DATA--> MODE: STEP
Field Descriptions
Specifies the name of the dialog associated with the current menu/dialog function. The field is blank if no dialog is associated with the current function.
This field is protected.
Specifies the current date in the format selected on the Main Menu screen during application definition.
This field is protected.
Specifies the current page of the menu screen.
This field is protected.
Specifies the total number of pages for the current menu.
This field is protected.
Specifies the next page of the menu screen to be displayed. To page forward or backward, the user enters the applicable page number and presses the ENTER key. The FORWARD and BACKWARD system functions can also be used if they are valid for the current function.
Displays the heading for the current menu, as specified on the Function Definition (Menu) screen during application definition.
Displays the available valid responses for the current function and, for each response, provides a 1-byte field that the user can use to select the response. A short description menu displays 30 responses per page; a long description menu displays 15 responses per page.
The responses are listed in the order specified on the Function Definition (Menu) screen during application definition. For each response listed, the following information, which is supplied on the Response/Function List screen during application definition, is displayed:
If the menu has a short description format, the description text is truncated to 12 bytes. If the menu has a long description format, the entire 28-byte description is displayed. If the response has no description, the description for the function associated with the response is displayed.
Displays informational and error messages returned by the CA ADS runtime system.
This area is protected.
Specifies the default response (if any) for the current function.
The user can select the default response by pressing the ENTER key without modifying the screen.
The user can select a different response than the default response by overwriting the default response with a nonblank character in the 1-byte field preceding the applicable response, or by pressing the control key associated with the response. If an invalid response name is entered, the value is replaced by the default next response.
Specifies a 32-byte field that is mapped to the AMR-PASSING field of ADSO-APPLICATION-MENU-RECORD and then moved to the AGR-PASSED-DATA field of ADSO-APPLICATION-GLOBAL- RECORD. The AGR-PASSED-DATA field can be accessed in the process code of a dialog function or user program. AMR-PASSING is initialized to spaces before the menu is mapped out. If AMR- PASSING contains all spaces, nothing is moved to AGR-PASSED- DATA.
Specifies an execution mode of STEP or FAST for the function. This specification is valid only if the application developer coded procedures for controlling the execution mode of the current dialog function.
Signon Menu Maps
The application developer defines a menu as a signon menu on the application compiler Function Definition (Menu) screen.
Signon menus are similar to nonsignon menus, except that signon menus map to two additional fields (AMR-USER-ID and AMR- PASSWORD) in ADSO-APPLICATION-MENU-RECORD. If the system function SIGNON is associated with a valid response for the signon menu function, the runtime system submits the values entered in the AMR-USER-ID and AMR-PASSWORD fields to DC/UCF for security clearance when SIGNON is initiated.
If the return code from DC/UCF indicates a successful signon, CA ADS moves the value in AMR-USER-ID to the AGR-USER-ID field of ADSO-APPLICATION-GLOBAL-RECORD. The AMR-PASSWORD field is overwritten with blanks after being passed to DC/UCF.
If a signon is required, the runtime system does not allow any other application activity to occur until a successful signon is processed.
Signon menu maps can be site-defined or system-defined.
Sample Signon Menu Screen (ADSOMSON)
DIALOG: PAGE: 1 OF: 1 DATE: mm/dd/yy NEXT PAGE: TEST APPLICATION ENTER USER ID---> PASSWORD--------> _ PAGETEST (PF22) TEST DIALOG _ FORWARD (PF8) FORWARD _ BACKWARD (PF7) BACKWARD _ POPTOP (PF3) POP TO TOP _ HELP (PF1) HELP _ QUIT (PF24) QUIT _ POP (PF2) POP 1 LEVEL _ LINKMENU (PF13) LINKTO SUBMENU _ LINKPAGE (PF14) LINK TO DIALOG _ START START OF LIST _ EDIT (PF17) TESTING BUG FIX RESPONSE: SEND DATA--> MODE: STEP
Field Descriptions
Specifies the name of the dialog associated with the current menu/dialog function. The field is blank if no dialog is associated with the current function.
This field is protected.
Specifies the current date in the format selected on the Main Menu screen during application definition.
This field is protected.
Specifies the current page of the menu screen.
This field is protected.
Specifies the total number of pages for the current menu.
This field is protected.
Specifies the next page of the menu screen to be displayed. To page forward or backward, the user enters the applicable page number and presses the ENTER key. The FORWARD and BACKWARD system functions can also be used if they are valid for the current function.
Displays the heading for the current menu, as specified on the Function Definition (Menu) screen during application definition.
Prompts for the user's user id.
This 32-byte field is mapped to the AMR-USER-ID field of ADSO-APPLICATION-MENU-RECORD.
Prompts for the user's password.
This 8-byte field is mapped to the AMR-PASSWORD field of ADSO- APPLICATION-MENU-RECORD. This is a darkened field; characters entered in this field do not appear on the screen.
Displays the available valid responses for the current function and, for each response, provides a 1-byte field that the user can use to select the response.
The signon menu screen displays 12 responses per page. The responses are listed in the order specified on the Function Definition (Menu) screen during application definition.
For each response listed, the following information, which is supplied on the Response/Function List screen during application definition, is displayed:
Note: If a signon is required for the application, at least one valid response must be associated with the system function SIGNON.
Displays informational and error messages returned by the CA ADS runtime system.
This area is protected.
Specifies the default response (if any) for the current function.
The user can select the default response by pressing the ENTER key without modifying the screen.
The user can select a different response than the default response by overwriting the default response, by entering a nonblank character in the 1-byte field preceding the applicable response, or by pressing the control key associated with the response.
Specifies a 32-byte field that is mapped to the AMR-PASSING field of ADSO-APPLICATION-MENU-RECORD and then moved to the AGR-PASSED-DATA field of ADSO-APPLICATION-GLOBAL- RECORD. The AGR-PASSED-DATA field can be accessed in the process code of a dialog function or user program. AMR-PASSING is initialized to spaces before the menu is mapped out. If AMR- PASSING contains all spaces, nothing is moved to AGR-PASSED-DATA.
Specified an execution mode of STEP or FAST for the function. If the user specifies an acceptable signon and the execution mode is STEP, the runtime system redisplays the signon menu. The user must press the ENTER key to proceed to the first application function.
If the execution mode is FAST, the runtime system immediately proceeds to the first function. Except for its use in signon menus, the execution mode specification is valid only if the application developer coded procedures for controlling the execution mode of the current dialog function.
|
Copyright © 2014 CA.
All rights reserved.
|
|