DISCARD PROCESSTYPE

Remove a PROCESSTYPE definition.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

DISCARD PROCESSTYPE

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

Conditions: INVREQ, NOTAUTH, PROCESSERR

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The DISCARD PROCESSTYPE command removes a CICS® business transaction services (BTS) PROCESSTYPE definition from the local CICS region.
Note:
  1. Only disabled process-types can be discarded.
  2. If you are using BTS in a single CICS region, you can use the DISCARD PROCESSTYPE command to remove process-types. However, if you are using BTS in a sysplex, it is strongly recommended that you use CICSPlex® SM to remove them. If you don't use CICSPlex SM, problems could arise if Scheduler Services routes to this region work that requires a discarded definition.

See Discarding resource definitions for general information about discards.

Options

PROCESSTYPE(data-value)
specifies the 8-character name of the PROCESSTYPE that you want to remove.

Conditions

INVREQ
RESP2 values:
2
The process-type named in the PROCESSTYPE option is not disabled.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
PROCESSERR
RESP2 values:
1
The process-type named in the PROCESSTYPE option is not defined in the process-type table (PTT).