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.