DISCARD PROFILE

Remove a PROFILE definition.

DISCARD PROFILE

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

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

Description

The DISCARD PROFILE command removes the definition of a profile from the local CICS system, so that the system no longer has access to the profile; that is, it revokes the earlier installation of a PROFILE resource definition of the same name. You cannot discard a profile while any installed TRANSACTION definitions point to it.

See Discarding resource definitions for general information about discards.

Options

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

Profiles whose names begin with the letters DFH are assumed to be CICS-supplied profiles and cannot be discarded.

Conditions

INVREQ
RESP2 values:
2
The PROFILE definition is currently in use.
3
A TRANSACTION definition points to the profile.
4
The profile 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.
PROFILEIDERR
RESP2 values:
1
The profile cannot be found.