Previous Topic: Function Definition (Program) ScreenNext Topic: Global Records Screen


Function Definition (Menu) Screen

The Function Definition (Menu) screen is accessed by entering a nonblank character in the appropriate Select field on the Response/Function List screen and pressing [PF5]. The function chosen must be associated with a type of menu.

The Function Definition (Menu) screen is made up of two screens used to specify the characteristics of runtime menu screens and the responses to be listed on that menu.

Page 1 of the Function Definition (Menu) screen allows the application developer to specify:

Page 2 of the Function Definition (Menu) screen allows the application developer to specify:

To specify the number of responses per page, the application developer specifies that the menu is user-defined and specifies the number of responses, from 0 to 50. If the application developer specifies that the menu is system-defined, the number of responses is set by CA ADS: 12 for a signon menu, 15 for a nonsignon menu that uses long descriptions, and 30 for a nonsignon menu that uses short descriptions.

The Function Definition (Menu) screen also allows the application developer to specify up to three lines of heading text for display at the top of each menu page. The heading text can use any or all of the three lines available.

Information provided on the Function Definition (Menu) screens applies only to a current function associated with a menu or a menu/dialog. The Function Definition (Menu) screen is not available when defining CA ADS Batch.

Page 1 of Function Definition (Menu)

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

Field descriptions for page 1

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:

Description Length

Specifies the description length for nonsignon menus, as follows:

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.

Page 2 of Function Definition (Menu)

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

Field Descriptions for Page 2

Note: Page 2 of the Function Definition (Menu) only appears when you have previously defined responses.

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.

More information:

System Records

System-Defined Menu Maps

CA ADS Runtime System