The Function Definition (Program) 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 program.
The Function Definition (Program) screen is used to:
Information provided on this screen applies only to a current function associated with a user program.
Up to eight records can be specified on one page of the Function Definition (Program) screen.
The application developer can scroll between pages using the control keys associated with paging forward and paging backward. Refer to the table earlier in this section for a listing of the default control key assignments for the application compiler.
When a function associated with a user program is initiated at runtime, CA ADS passes control to the program. Additionally, the runtime system passes the data in the record buffers and control blocks specified on the Function Definition (Program) screen. CA ADS maintains all application record buffers at the level at which control was relinquished.
When a user program finishes execution, control returns to the mapout operation of the function from which the program was initiated or, if the program was initiated by an EXECUTE NEXT FUNCTION command, to the command that follows EXECUTE NEXT FUNCTION. Note that a user program must process its own responses. Valid responses cannot be specified for the function associated with the program.
The Function Definition (Program) screen is similar to the USING clause of the LINK TO PROGRAM control command.
Sample Screen
Function Definition (Program) Application name: TEST1 Version: 1 Function name: PROG01 Drop function (/) _ Associated program . . . . PROG01 Description . . . . . . . UNDEFINED Records passed Drop record (/) 1. ________________________________ _ 2. ________________________________ _ 3. ________________________________ _ 4. ________________________________ _ 5. ________________________________ _ 6. ________________________________ _ 7. ________________________________ _ 8. ________________________________ _ Enter F1=Help F3=Exit F4=Prev F5=Next F7=Bkwd F8=Fwd
Field descriptions
Specifies the name of the current application, as specified on the Main Menu screen. This field is protected.
Specifies the version number, in the range 1 through 9999, of the current application.
This field is protected.
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.
Removes the function definition from the application.
Displays the name of the user program with which the current function is associated, as specified on the Response/Function List screen.
This field is protected.
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.
Specifies the data passed to the user program. The application developer specifies record names and/or control block names as follows:
The record and control block names must be entered from left to right, top to bottom, in the same order in which they are defined in the program.
Removes the record from its association with the program function, but does not delete the record definition from the dictionary.
|
Copyright © 2014 CA.
All rights reserved.
|
|