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:
  1. For more detail, refer to the explanation of RESPONSE and REASON in Making an XPI call.
  2. ‘PROGRAM_NOT_DEFINED’ is returned if the program that you name is not known to the system.
  3. ‘PROGRAM_NOT_IN_USE’ is returned when the use count for the named program is already zero.


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