CA ADS Application Compiler (ADSA) › Application Compiler Screens › Function Definition (Dialog) Screen

Function Definition (Dialog) Screen

The Function Definition (Dialog) 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 dialog.

This screen is used to:

• Provide a description of the dialog function
• Identify the associated dialog name
• Identify a user exit dialog
• Name the default response
• Specify valid responses for the current dialog function

The screen provides an alphabetical listing of all responses valid for the application. Responses that are valid are indicated by an X.

The application developer can select additional valid responses by typing a nonblank character in the 1-byte field immediately preceding the applicable response. The application developer can deselect any valid response by overwriting the 1-byte field immediately preceding the response with a blank or by using the ERASE EOF key.

Up to 6 responses can be displayed on one page of the Function Definition screen.

The application developer can scroll between pages using the control keys associated with paging forward and paging backward. See earlier in this section for a listing of the default control key assignments for the application compiler.

Sample Screen

                          Function Definition (Dialog)       Page   1 of   2

 Application name:  GWGAPP01   Version:    1
 Function name:     F1                                   Drop function (/) _
 Description . . .  DEFINED

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

 Valid                                     Valid
 response(/)  Response Key   Function      response(/)  Response Key   Function

     _        R1       PF01  F1                _        R15      _____ ________
     _        R10      _____ ________          _        R2       PF02  F2
     _        R11      _____ ________          _        R3       PF08  FWD
     _        R12      _____ ________          _        R4       _____ FORWARD
     _        R13      _____ ________          _        R6       _____ HELP
     _        R14      _____ ________          _        R7       _____ ________

                                                             more ...

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

Field Descriptions

Page

Specifies the page number of the Function Definition (Dialog) screen to be displayed. If more than one page exists for the screen, this field displays the current page of the total number of pages, as shown on the sample screen above.

This field is modifiable so that you can access the valid responses for the displayed dialog function quickly. To request the next map page to be displayed:

• Press the control key associated with paging forward or paging backward one page (the system generation defaults are [PF8] and [PF7], respectively)
• Enter a numeral for the page that you want to access, and press any control key other than keys assigned for paging forward or backward

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.

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 response. The response 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.

You must change the literal, UNDEFINED, to something else, or CA ADS displays the following error message:

DC462226 FUNCTION FUNC4 IS UNDEFINED

Only the first 12 bytes of each description are displayed.

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.

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.

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.

Valid Response

A nonblank character in this field indicates that this response is valid for this function.

Response

Displays the name of a response from the Response/Function List screen.

Key

Displays the assigned key that initiates the response.

Function

Displays the name of the function initiated by the response.

More information:

System Records

CA ADS Runtime System