CA ADS Application Compiler (ADSA) › Application Compiler Screens › Response/Function List Screen

Response/Function List Screen

The Response/Function List screen is accessed from the Main Menu by choosing option 2 at the Screen prompt. This screen is used to:

• Identify each response name for the application
• Identify the associated control key
• Identify the function associated with the response
• Specify the function type
• Name the program or dialog

For each response defined, the combination of response name, associated assigned key, and function initiated must be unique within the application.

Up to 12 responses and functions can be entered on one page of the Response/Function List 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.

From the Response/Function List screen, the application developer can further define both responses and functions by accessing the following screens:

• Response Definition screen
• Function Definition (Dialog) screen
• Function Definition (Program) screen
• Function Definition (Menu) screen

To access one of these screens, a nonblank character is placed in the appropriate Select field.

Sample Screen

                             Response/Function List            Page  1 of  1

 Application name:  TESTAPP1   Version:    1

 Select    Response    Assigned      Select    Function             Program/
  (/)      name        key            (/)      name/type(1,2,3)*    Dialog name

   _       ________     _____          _       ________ / _         ________

   _       ________     _____          _       ________ / _         ________

   _       ________     _____          _       ________ / _         ________

   _       ________     _____          _       ________ / _         ________

                                        * Type: 1. Dialog  2. Program  3. Menu


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

Field Descriptions

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.

Select

Placing a nonblank character in this field allows the developer to select a particular response or function for further definition.

Response Name

Displays the name of the application response.

The following considerations apply:

• For CA ADS, the response name cannot contain embedded blanks. At runtime, the response name can be used in a $RESPONSE map field to select the response. The response name is also stored by the runtime system in the AMR-RESPONSE-FIELD of ADSO- APPLICATION-MENU-RECORD for use in runtime menus.
• For CA ADS Batch, if the response field for an input record is the concatenation of several fields, the response name specified on the Response Definition screen must include any embedded blanks that occur in a concatenation. For example, the entry 'ADD ''E' is made for a response field that is the concatenation of two fields, the first being six bytes long and the second being one byte long. The first field contains the field value of ADD and the second field contains E.

Assigned Key

Specifies an online control key or a batch control event that selects the response at runtime.

The following considerations apply:

• Valid online assigned key specifications are ENTER, CLEAR, PA1 through PA3, PF1 through PF24. LPEN can be specified as a control key if the use of light pens is supported by the installation. The following consideration applies:
  • CLEAR, PA1, PA2, and PA3 do not transmit data.
• Valid batch control events are EOF and IOERR. The following considerations apply:
  • EOF indicates that the most recent input-file read operation resulted in an end-of-file condition.
  • IOERR indicates that the most recent input file read operation resulted in a physical input-error condition. In CA ADS Batch, an output error causes the runtime system to terminate the application.

Function Name/Type

Displays the name and type of the application function associated with the response.

The function name cannot contain embedded blanks.

The application compiler supplies a function type by crosschecking the defined functions and responses.

Function types are as follows:

1. Dialog — The response is associated with a dialog function.
2. Program — The response is associated with a user program function.
3. Menu — The response is associated with a menu function.

For example, if the application developer specifies Menu and also provides a dialog name in the Associated dialog field, of a Function Definition screen, the function is associated with a menu.

When the application developer associates the response process with the dialog, using the dialog compiler Process Modules screen, the Value and Key specified should match the Response name and Assigned key entered on the Response/Function List screen.

Associating a response with an internal function causes the dialog's response process to be displayed as a valid response on runtime menu and help screens.

Program/Dialog Name

Specifies the name of the program or dialog associated with the function.

Response/Function Search

The ADSA compiler:

• Supports up to 999 pages of responses and function relationships
• Returns to the current Response/Function screen when the selection list of responses and functions has been exhausted
• Provides a search function that allows partial keys and both next (forward) and previous (backward) searches.

An example of the search function follows.

Invoking the Search Function

Pressing [PF6] brings up the search window. In this example, a partial key— 'IUA'— has been entered. The search will attempt to match any response name beginning with those letters:

 RELEASE nn.n                                                  volser
                       Response/Function List         Page   1 of   2

 Application name:  METAPPL1   Version:    1

 Select  Response  Assigned  Select   Function            Program/
  (/)    name      key        (/)     name/type(1,2,3)*   Dialog name

   _     R1         ENTER      _      F1       / 1        JPKSQLD1

   _     R3         ┌────────────────────────────────┐    STEVEDLG
                    │ Search for. . .                │
   _     R2         │  Response  Assigned  Function  │    ________
                    │  name      key       name      │
   _     R4         │                                │    DIAL4
                    │  IUA       _____     ________  │
   _     R5         │--------------------------------│    DIAL5
                    │  F3=Exit  F7=Prev  F8=Next     │
   _     LINKOLQR   └────────────────────────────────┘    IDMSOLQS

                              * Type: 1. Dialog  2. Program  3. Menu

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

Search Result

Pressing [PF8] initiates a forward search. In this example, response IUADOLQR is found:

 RELEASE nn.n                                                  volser
                       Response/Function List         Page   2 of   2

 Application name:  METAPPL1   Version:    1

 Select  Response  Assigned  Select   Function            Program/
  (/)    name      key        (/)     name/type(1,2,3)*   Dialog name

   _     IUADOLQR   PF07       _      IUADOLQF / 1        IUADOLQ1

   _     ________   ┌────────────────────────────────┐    ________
                    │ Search for. . .                │
   _     ________   │  Response  Assigned  Function  │   ________
                    │  name      key       name      │
   _     ________   │                                │   ________
                    │  IUA       _____     ________  │
   _     ________   │--------------------------------│   ________
                    │  F3=Exit  F7=Prev  F8=Next     │
   _     ________   └────────────────────────────────┘    ________

                              * Type: 1. Dialog  2. Program  3. Menu
 DC451536 Matching entry found on page   2

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

More information:

Response Definition Screen

Function Definition (Dialog) Screen

Function Definition (Program) Screen

Function Definition (Menu) Screen

CA ADS Dialog Compiler (ADSC)