CA IDMS Reference 19.0

PDF
English

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.
idmscu
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.