A description of the menu
The name of the associated dialog if this is a menu/dialog
The default response, if any
The name of the user exit dialog, if any
Whether the menu is defined by the site or the system
The description length
The number of responses per page
The number of heading lines and their content

The responses to be displayed on the menu
The order in which the responses will be displayed at runtime

                          Function Definition (Menu)           Page  1 of  2

 Application name:  TEST       Version:    1
 Function name:     MENU1                                Drop function (/) _
 Description . . .  UNDEFINED

 Associated dialog . . . . .  ________
 Default response  . . . . .  ________     User exit dialog . . . .  ________

 Use signon menu (/). . . . . . . . . . _
 Menu defined by:                       2  1. User      2. System
 Description length . . . . . . . . . . 1  1. Long (28) 2. Short (12)
 Responses per page . . . . . . . . . . 15
 Number of heading lines (0-3). . . . . 0
 Heading line text
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....

 Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F8=Fwd

Application Name
Specifies the name of the current application, as specified on the Main Menu screen. This field is protected.
Version
Specifies the version number, in the range 1 through 9999, of the current application.
This field is protected.
Function Name
Displays the name of the current function, as specified on the Response/Function List screen. The function must be associated with a user program.
This field can be modified by the user. The first character of the Function name cannot be blank. If modified, the user should insure that the combination of response name, assigned key, and associated function name must be unique within the application.
Drop Function
Removes the function definition from the application.
Description
Specifies a 1- to 28-byte description of the current function. The function description is displayed with the associated response name on runtime menu and help screens. Note that the specified description is truncated to 12 characters on the short description menu screen.
Associated Dialog
Specifies the name of the dialog or user program associated with the function. If this field is left blank, the function is associated with a system-defined menu.
If the application developer provides a dialog name and also specifies
Menu
as the
Function type
on the Response/Function List screen, the function is associated with a menu.
Menu
cannot be specified for CA ADS Batch applications.
Default Response
Specifies the name of the response initiated by the runtime system when the user presses [Enter] without entering a specific response. The default response is displayed in bright intensity on the Function Definition screen for each function.
User Exit Dialog
Specifies the name of a dialog to which a dialog function can LINK internally.
When the dialog function is initiated at runtime, the name of the dialog supplied as the user exit dialog is stored in the AGR-EXIT-DIALOG field of ADSO-APPLICATION-GLOBAL-RECORD. When the runtime system encounters a LINK TO AGR-EXIT-DIALOG command, the dialog named in the AGR-EXIT-DIALOG field becomes the object of the LINK command.
Use Signon Menu
Specifies whether the menu is a signon menu. At runtime, the menu uses the AMR-USER-ID and AMR-PASSWORD fields of ADSO-APPLICATION-MENU-RECORD.
If the signon menu is system-defined, up to 12 responses are displayed on each page at runtime.
Menu Defined By
Specifies whether the menu is system-defined or user-defined, as follows:
specifies that the menu is user-defined, meaning that the user can specify the number of responses per page, from 0 to 50.
(default) specifies that the menu is system-defined, meaning that CA ADS determines the number of responses per menu page: 12 for a signon menu, 15 for a nonsignon menu that uses long descriptions, and 30 for a nonsignon menu that uses short descriptions.
Description Length
Specifies the description length for nonsignon menus, as follows:
(default) specifies that each function description displayed on the menu screen contains the complete 28-byte description text. The long description allows up to 15 responses to be displayed on each page of a system-defined menu.
specifies that each description displayed on the menu screen is truncated to the first 12 bytes of the description text. The short description allows up to 30 responses to be displayed on each page of a system-defined menu.
At runtime, the description displayed is the description specified on the Response Definition screen. If the response definition has no description, the runtime system displays the description of the associated function for the response.
Responses Per Page
Specifies the maximum number of responses, in the range 0 through 50, that can be displayed on one page of a user-defined menu at runtime.
The maximum number of responses per page for a system-defined menu is determined by the menu format. A system-defined signon menu has 12 responses per page. Other system-defined menus have either 15 or 30 responses per page, depending on the length of the description (see
Description length
).
The default is 15.
Number of Heading Lines
Specifies the number of heading lines displayed at the top of each page of the runtime menu screen.
The default is 0 (that is, no heading lines).
Heading Line Text
Specifies the heading text displayed at the top of each page of the runtime menu screen. The application developer can enter free-form text in the three 79-byte fields provided.

                           Function Definition (Menu)          Page  2 of  2

 Application name:  TEST1      Version:    1
 Function name:     MENU1

 Valid   Seq.   Response  Key  Function  Valid   Seq.   Response  Key  Function
 resp.    #                              Resp.    #

   _    ______  ADD      PF02  F2          _    ______  ________ _____ ________

   _    ______  QUIT     PF01  QUIT        _    ______  ________ _____ ________

   _    ______  ________ _____ ________    _    ______  ________ _____ ________

   _    ______  ________ _____ ________    _    ______  ________ _____ ________
 Enter F1=Help F3=Exit F4=Prev F5=Next F7=Bkwd F8=Fwd F9=Update Seq

Application Name
Specifies the name of the current application, as specified on the Main Menu screen. This field is protected.
Version
Specifies the version number, in the range 1 through 9999, of the current application. This field is protected.
Function Name
Displays the name of the current function, as specified on the Response/Function List screen. The function must be associated with a user program. This field is protected.
Valid Response
A nonblank character in this field indicates that this response is valid for this function.
Seq.#
Specifies the sequence number of each response. The application developer can modify the position or suppress the display of a response by overwriting the sequence number in this field.
Response
Specifies the name of each response selected as valid for the current function.
This field is protected.
Key
Specifies the control key or control event associated with the current application response, as specified on the Response/Function List screen.
This field is protected.
Function
Specifies the name of the current function, as specified on the Response/Function List screen. The function must be associated with a menu or a menu/dialog.
This field is protected.