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 The RESPONSE parameter on domain interfaces.

LANGUAGE_TOKEN

Optional Parameter

is a token representing the AP domain language block for the program.