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:
idmscu
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 NameSpecifies the name of the current application, as specified on the Main Menu screen. This field is protected.
- VersionSpecifies the version number, in the range 1 through 9999, of the current application.
- SelectPlacing a nonblank character in this field allows the developer to select a particular response or function for further definition.
- Response NameDisplays 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 KeySpecifies an online control key or a batch control event that selects the response at runtime.The following considerations apply:
- Validonlineassigned 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,andPA3do not transmit data.
- Validbatchcontrol events are EOF and IOERR. The following considerations apply:
- EOFindicates that the most recent input-file read operation resulted in an end-of-file condition.
- IOERRindicates 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/TypeDisplays 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:
- Dialog-- The response is associated with a dialog function.
- Program-- The response is associated with a user program function.
- Menu-- The response is associated with a menu function.
Menuand also provides a dialog name in theAssociated dialogfield, 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, theValueandKeyspecified should match theResponse nameandAssigned keyentered 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 NameSpecifies 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