Pipelines - PIPELINE

The Pipeline (PIPELINE) views display information about the processing nodes that will act on a service request and on the response to it when a CICS application acts in the role of a web service provider or requester.

Supplied views

To access from the main menu, click:

CICS operations views > TCP/IP service operations views > Pipelines

Table 1. Views in the supplied Pipeline (PIPELINE) view set
View Notes
Pipeline

EYUSTARTPIPELINE.DETAIL1

Detailed information about the resource signature.
Pipeline

EYUSTARTPIPELINE.DETAILED

Detailed information about a selected pipeline.
Pipeline

EYUSTARTPIPELINE.DISABLE

Rejects inbound service requests.
Pipeline

EYUSTARTPIPELINE.DISCARD

Removes this PIPELINE definition. The PIPELINE must be disabled before it can be discarded.
Pipeline

EYUSTARTPIPELINE.ENABLE

Processes inbound service requests normally.
Pipeline

EYUSTARTPIPELINE.SCAN

Scans the PIPELINE's web service binding directory.
Pipeline

EYUSTARTPIPELINE.SET

Set attributes according to values specified in input fields
Pipeline

EYUSTARTPIPELINE.TABULAR

Tabular information about pipeline.

Actions

Table 2. Actions available for PIPELINE views
Action Description
DISABLE Rejects inbound service requests.
DISCARD Removes this PIPELINE definition. The PIPELINE must be disabled before it can be discarded.
ENABLE Processes inbound service requests normally.
SCAN Scans the PIPELINE's web service binding directory.
SET Set attributes according to values specified in input fields

Fields

Table 3. Fields in PIPELINE views
Field Attribute name Description
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
MIME content id domain name CIDDOMAIN Displays the name of the domain that is used to generate MIME content-ID values that identify binary attachments.
Configuration file name on zFS for this pipeline CONFIGFILE Specifies the name of an zFS file that contains information about the processing nodes that will act on a service request, and on the response.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Status ENABLESTATUS Specifies the initial status of the PIPELINE when it is installed:
  • ENABLED: Web service requests for this PIPELINE are processed normally.
  • DISABLED: Web service requests for this PIPELINE cannot be processed.
  • ENABLING - The PIPELINE is being initialized; it is not yet ready to accept work.
  • DISABLING - The PIPELINE is quiescing before entering DISABLED state. It is not accepting new work, but is allowing currently-executing work to complete.
  • DISCARDING - A DISCARD command has been issued for the PIPELINE. The PIPELINE is quiescing before being discarded. It is not accepting new work, but is allowing currently-executing work to complete.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
  • BUNDLE - The resource was installed by a bundle deployment.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
Format of messages processed by the pipeline MSGFORMAT Returns a 8-character string that indicates the format of messages processed by the pipeline. Possible values are: JSON, OTHER, SOAP11, SOAP12.
Use MTOM even when no XOP attachments are present MTOMNOXOPST Returns a value that indicates whether MTOM should be used for outbound SOAP messages when there are no binary attachments present. The values are: YES : Use MTOM, even when there are no binary attachments present. NO : Do not use MTOM unless there are binary attachments present.
SOAP MTOM status MTOMST Returns a value that indicates whether support for MTOM has been enabled in the pipeline. The values are: SUPPORTED : MTOM support has been enabled in the pipeline. NOTSUPPORT : MTOM support has not been enabled in the pipeline.
Name NAME Specifies the name of this PIPELINE. The name can be up to eight characters in length.
Pipeline operation mode PIPEMODE The mode that that pipeline is operating in.
Number of times pipeline has been used PIPEUSECOUNT Specifies the number of times pipeline has been used
Name of the pipeline policy directory on zFS POLICYDIR This field is not available yet for use but reserved for future development.
Response wait time for Requester Pipelines RESPWAIT Specifies a time control, in seconds, on the wait time for an application program to wait for an optional reponse message from a remote web service. The value can range from 0 to 9999 seconds, or will have the standard null value of -1 if RESPWAIT(DEFT) is specified on the PIPELINE definition. If RESPWAIT(DEFT) was specified for this attribute, the default timeout value of the transport protocol is used:
  • The default timeout value for HTTP is 10 seconds.
  • The default timeout value for MQ is 60 seconds.
Note that the value of this attribute may not be reset to -1 (DEFT) - only 0 to 9999 may be applied. If you need to reset the RESPWAIT value to -1, you will have to delete the current PIPELINE object, and INSTALL another instance of it, where the RESPWAIT value specifies DEFT.
Outbound SOAP message MTOM status SENDMTOMST Returns a value that indicates when MTOM should be used for outbound SOAP messages. The values are: YES : Always use MTOM for outbound SOAP messages. NO : Do not use MTOM for outbound SOAP messages. SAME : Use MTOM for outbound SOAP message responses when the inbound message is received in MTOM format.
Name of a directory (shelf) for WSBind files SHELF Specifies the 1 to 255 character fully-qualified name of a directory (a shelf, primarily for Web service binding files) on zFS.
SOAP level supported by the pipeline SOAPLEVEL Specifies the version of SOAP that is supported in the pipeline. Values can be blank, 1.1 or 1.2.
SOAP release number part of SOAPLEVEL SOAPRNUM Returns a fullword binary value of the release number for the SOAP level that is used in the PIPELINE.
SOAP version number part of SOAPLEVEL SOAPVNUM Returns a fullword binary value of the version number for the SOAP level that is used in the PIPELINE.
Name of the WSBind (pickup) directory on zFS WSDIR Specifies the 1 to 255 character fully-qualified name of the Web service binding directory (also known as the pickup directory) on zFS.
Pipeline direct mode XOP status XOPDIRECTST Returns a value that indicates whether the pipeline can currently handle XOP documents in direct mode.
Pipeline application handler XOP capability XOPSUPPORTST Returns a value that indicates whether the application handler for the pipeline supports the processing of XOP documents and binary attachments.


eyua3vq.html | Timestamp icon Last updated: Sunday, 4 June 2017