DISCARD LIBRARY

Remove a specified LIBRARY from the running CICS system.

DISCARD LIBRARY

Read syntax diagramSkip visual syntax diagramDISCARD LIBRARY( data-value)

Conditions: INVREQ, NOTAUTH, NOTFND

Description

The DISCARD LIBRARY command removes the definition of a LIBRARY from the local CICS system, so that the system no longer has access to the LIBRARY, that is, it revokes the earlier installation of a LIBRARY resource definition of the same name. A LIBRARY must be disabled for its definition to be discarded.

See Discarding resource definitions for general information about discards.

You cannot discard a LIBRARY resource that is created by a BUNDLE resource. To discard the library, you must disable and discard the BUNDLE resource.

Options

LIBRARY(data-value)
specifies the 8-character name of the LIBRARY that is to be removed.

Conditions

INVREQ
RESP2 values:
3
The LIBRARY is not disabled.
6
The LIBRARY name is DFHRPL, and the static DFHRPL cannot be discarded.
7
A failure was encountered on the second attempt at deconcatenating the LIBRARY data sets.
8
A failure occurred on the second attempt at deallocating the LIBRARY data sets.
9
A failure occurred while attempting to delete LIBRARY control structures.
10
A failure occurred on the second attempt at closing the LIBRARY.
300
The resource cannot be discarded because it was installed by a BUNDLE resource.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The named LIBRARY cannot be found.