SET PIPELINE

Change the status of an installed PIPELINE.

SET PIPELINE

Read syntax diagramSkip visual syntax diagramSET PIPELINE( data-value)ENABLESTATUS( cvda)ENABLEDDISABLEDRESPWAIT( data-area)

Conditions: INVREQ, NOTAUTH, NOTFND

This command is threadsafe.

Description

Use the SET PIPELINE command to change the status of an installed PIPELINE.

You cannot use the SET PIPELINE command to change the ENABLESTATUS of a PIPELINE resource that was defined and installed in a CICS® bundle. If you attempt to do so, an INVREQ response with a RESP2 value of 300 is issued. You can modify all the other attributes of a dynamically generated PIPELINE resource, but the changes are not cataloged and will not be recovered across a warm restart of CICS. If you want to change an attribute of a resource that was installed by a bundle, you should disable and discard the CICS bundle, and install a new version of the bundle with the required changes.

You can control the status of dynamically generated PIPELINE resources by enabling or disabling the BUNDLE resources that installed them.

You can modify the definition of dynamically generated PIPELINE resources using the resource editor in the CICS Explorer®. To update the definition, replace the old version of the CICS bundle with the new one, following the instructions in Working with bundles in the CICS Explorer product documentation. CICS bundles that were deployed on their own or with a platform can be updated individually. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

Options

PIPELINE(data-value)
Specifies the 8-character name of the PIPELINE about which you are inquiring.
ENABLESTATUS(cvda)
Specifies the status of the PIPELINE:
ENABLED
Inbound service requests for this PIPELINE are processed normally.
DISABLED
Inbound service requests for this PIPELINE are rejected.
RESPWAIT(data-area)
Specifies the number of seconds that an application program should wait for an optional response message from a remote web service. The value can range from 0 to 9999 seconds. If you do not specify a value, the default timeout value of the transport protocol is used.
  • The default timeout value for HTTP is 10 seconds.
  • The default timeout value for WebSphere® MQ is 60 seconds.

Conditions

INVREQ
RESP2 values:
5
An attempt was made to set an invalid value for RESPWAIT.
11
An attempt was made to enable or disable an PIPELINE that is in an invalid state
300
You specified an operation that is invalid for a resource that is 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:
3
The PIPELINE was not found.