DISCARD PARTNER

Remove a PARTNER definition.

DISCARD PARTNER

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

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

Description

The DISCARD PARTNER command removes the definition of a partner from the local CICS system, so that the system no longer has access to the partner; that is, it revokes the earlier installation of a PARTNER resource definition of the same name.

See Discarding resource definitions for general information about discards.

Options

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

Partners whose names begin with the letters DFH are assumed to be CICS-defined partners and cannot be discarded.

Conditions

INVREQ
RESP2 values:
2
The PARTNER definition is currently in use.
3
The partner cannot be discarded because its name begins with DFH.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
PARTNERIDERR
RESP2 values:
1
The partner cannot be found.
5
The Partner Resource Manager (PRM) is not active, because it failed to initialize during CICS initialization.