DISCARD PIPELINE
Remove a PIPELINE definition.
Syntax
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).
Conditions: INVREQ, NOTAUTH, NOTFND
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.
This command is threadsafe.
Description
Use the DISCARD PIPELINE to remove an PIPELINE from your CICS® region. The PIPELINE must be disabled before it can be discarded.
You cannot discard a PIPELINE resource that is created by a BUNDLE resource. To discard the pipeline, you must disable and discard the BUNDLE resource.
See Discarding resource definitions for general information about discards.
Options
- PIPELINE(data-value)
- specifies the 8-character name of the PIPELINE whose definition is to be discarded.
Conditions
- INVREQ
- RESP2 values:
- 8
- The PIPELINE cannot be discarded because it is not disabled.
- 22
- Delete is in progress for this PIPELINE.
- 200
- The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
- 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 PIPELINE cannot be found