LDLD gate, DELETE_PROGRAM function

The DELETE_PROGRAM function of the LDLD gate is used to remove a program from the CICS system. All subsequent ACQUIRE requests for the named program fail with a reason of PROGRAM_NOT_DEFINED. Any instance of the program in use at the time the DELETE is received continue to exist until a RELEASE request reduces the use count to zero, at which time the instance is removed from memory.

Input Parameters

APPL_CONTEXT_TOKEN
Optional parameter
A token representing the application context of PLATFORM_ID, APPLICATION_ID, APPL_MAJOR_VER, APPL_MINOR_VER, and APPL_MICRO_VER.
APPLICATION_ID
Optional parameter
The 64-character name of the application associated with the task.
APPL_MAJOR_VER
Optional parameter
The fullword binary value that is the major version of the application associated with the task.
APPL_MINOR_VER
Optional parameter
The fullword binary value that is the minor version of the application associated with the task.
APPL_MICRO_VER
Optional parameter
The fullword binary value that is the micro version of the application associated with the task.
PLATFORM_ID
Optional parameter
The 64-character name of the platform associated with the task.
PROGRAM_NAME
specifies the name of the required program.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOOP
The following values are returned when RESPONSE is EXCEPTION:
  • PROGRAM_NOT_DEFINED
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
NEW_APPL_CONTEXT_TOKEN
Optional parameter
A token to be used on subsequent calls, representing the application context of PLATFORM_ID, APPLICATION_ID, APPL_MAJOR_VER, APPL_MINOR_VER, and APPL_MICRO_VER.


dfhs3_LDLDdelete_program.html | Timestamp icon Last updated: Monday, 5 June 2017