The Delete_Program Call - IBM SC34-6814-04 Customization Manual

PROGRAM_TOKEN(name4),
RESPONSE and REASON values for RELEASE_PROGRAM:
RESPONSE
OK
EXCEPTION
DISASTER
INVALID
KERNERROR
PURGED
Note:

The DELETE_PROGRAM call

DELETE_PROGRAM removes the definition of a named program from the catalog
and from the list of current programs. When this request executes successfully,
subsequent ACQUIRE_PROGRAM requests fail with a REASON value of
'PROGRAM_NOT_DEFINED'.
DELETE_PROGRAM
DFHLDLDX [CALL,]
This command is threadsafe.
PROGRAM_NAME(name8 | string | "string")
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.
specifies a token identifying the program to be released.
name4
The name of a location containing an 4-byte token obtained by a
previous DEFINE_PROGRAM or ACQUIRE_PROGRAM call.
1. For more detail, refer to the explanation of RESPONSE and REASON in
"Making an XPI call" on page 308.
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.
[CLEAR,]
[IN,
FUNCTION(DELETE_PROGRAM),
PROGRAM_NAME(name8 | string | 'string' ),]
[OUT,
RESPONSE(name1 | *),
REASON(name1 | *)]
specifies the name of the program to be deleted.
name8
The name of a location containing an 8-byte program name.
REASON
None
PROGRAM_NOT_DEFINED
PROGRAM_NOT_IN_USE
None
None
None
None
Chapter 3. The user exit programming interface (XPI)
359