PGLD gate, LOAD_EXEC function
The LOAD_EXEC function of the PGLD gate is used to load a program in response to an EXEC CICS LOAD command.
Input Parameters
- HOLD_LIFETIME
- determines for how long the program is to be loaded; that is, for the life-time of CICS (or until explicitly deleted) or for the lifetime of the task (unless explicitly deleted by the task).
- Values for the parameter are:
- CALLER_MANAGED
- CICS_LIFE
- TASK_LIFE
- PROGRAM_NAME
- is the name of the program resource to be defined.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- AUTOINSTALL_FAILED
- AUTOINSTALL_INVALID_DATA
- AUTOINSTALL_MODEL_NOT_DEF
- AUTOINSTALL_URM_FAILED
- JVM_PROGRAM
- NOT_AUTHORIZED
- NOT_INITIALIZED
- PROGRAM_NOT_DEFINED
- PROGRAM_NOT_ENABLED
- PROGRAM_NOT_LOADABLE
- REMOTE_PROGRAM
- The following values are returned when RESPONSE is INVALID:
- INVALID_FUNCTION
- ENTRY_POINT
- is the token defining the entry point of the program.
- LOAD_POINT
- is the load point address of the program returned by the loader domain on the ACQUIRE_PROGRAM call.
- PROGRAM_LENGTH
- is the length of the program. returned by the loader domain on the ACQUIRE_PROGRAM call.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- LANGUAGE_TOKEN
- Optional Parameter
- is a token representing the AP domain language block for the program.