The RELEASE_PROGRAM call
RELEASE_PROGRAM decrements the use count of a currently loaded program by one.
If the program has been defined with the RELOAD attribute, the storage occupied by this copy of the program is released.
You should issue the ACQUIRE_PROGRAM and RELEASE_PROGRAM requests for a single program during the same execution of the exit program. If you do not want to do this, you should acquire the program once during CICS® initialization, and leave it resident until CICS termination.
RELEASE_PROGRAM
DFHLDLDX [CALL,]
[CLEAR,]
[IN,
FUNCTION(RELEASE_PROGRAM),
ENTRY_POINT(pointer),
{PROGRAM_NAME(name8 | string | 'string')|
PROGRAM_TOKEN(name8)},]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]
This command is threadsafe.
- ENTRY_POINT(pointer)
- Specifies the address of the entry point of this copy of the named program.
- PROGRAM_NAME(name8 | string | "string")
- Specifies the name of the program to be released.
- name8
- The name of a location containing an 8-byte program name.
- string
- A string of characters naming the program.
- "string"
- A string in quotation marks. The string length is set to 8 by padding with blanks or truncating.
- PROGRAM_TOKEN(name8),
- Specifies a token identifying the program to be released.
- name8
- The name of a location containing the 8-byte token obtained from a previous DEFINE_PROGRAM or ACQUIRE_PROGRAM call.
RESPONSE and REASON values for RELEASE_PROGRAM
| RESPONSE | REASON |
|---|---|
| OK | None |
| EXCEPTION | PROGRAM_NOT_DEFINED |
| PROGRAM_NOT_IN_USE | |
| DISASTER | None |
| INVALID | None |
| KERNERROR | None |
| PURGED | None |
Note:
- For more detail, refer to the explanation of RESPONSE and REASON in Making an XPI call.
- ‘PROGRAM_NOT_DEFINED’ is returned if the program that you name is not known to the system.
- ‘PROGRAM_NOT_IN_USE’ is returned when the use count for the named program is already zero.