DISCARD PROGRAM

Remove the definition of a program, map set, or partition set.

Read syntax diagramSkip visual syntax diagramDISCARD PROGRAM
 
>>-DISCARD PROGRAM(data-value)---------------------------------><
 

Conditions: INVREQ, NOTAUTH, PGMIDERR

Description

The DISCARD PROGRAM command removes the definition of a program, map set, or partition set (a load module resource) from the local CICS system, so that the system no longer has access to the resource; that is, it revokes the earlier installation of a PROGRAM, MAPSET, or PARTITIONSET definition of the same name.

You cannot discard a module that is being executed or otherwise used by a task. Definitions supplied by CICS (modules whose name begin with DFH) and modules defined as user-replaceable (such as autoinstall programs) also are ineligible.

See Discarding resource definitions for general information about discards.

Options

PROGRAM(data-value)
specifies the 8-character name of the program, map set, or partition set that is to be removed.

Conditions

INVREQ
RESP2 values:
1
The resource cannot be discarded because its name begins with DFH.
11
The resource definition is currently in use.
15
The resource cannot be discarded because it is a user-replaceable module.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
PGMIDERR
RESP2 values:
7
The resource definition cannot be found.
[[ Contents Previous Page | Next Page Index ]]