CEMT INQUIRE PIPELINE

Retrieve information about an installed pipeline.

In the CICS Explorer, the Pipelines operations view provides a functional equivalent to this command.

Description

Use the INQUIRE PIPELINE command to retrieve information about an installed pipeline.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT INQUIRE PIPELINE (or suitable abbreviations for the keywords). You get a screen that lists the current status.
Type CEMT INQUIRE PIPELINE (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i pi en, the resulting display shows the details of only those process-types that are enabled.

You can change various attributes in the following ways:

Overtype your changes on the INQUIRE screen after tabbing to the appropriate field.
Use the CEMT SET PIPELINE command.

ALL: The default. Information about all pipelines is displayed, unless you specify a selection of pipelines to be queried.
(value): The 1- to 8-character name of an installed PIPELINE definition.

Displayed fields

CHANGEAGENT(value)

Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DREPAPI: The resource definition was last changed by a CICSPlex SM BAS API command.

CHANGEAGREL(value)

Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(date time)

Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

CHANGEUSRID(value)

Displays the 8-character user ID that ran the change agent.

CIDDOMAIN(value)

Displays the name of the domain that is used to generate MIME content-ID values that identify binary attachments.

CONFIGFILE(value)

Displays the name of the pipeline configuration file associated with the PIPELINE resource. The name can be up to 255 characters long.

DEFINESOURCE(value)

Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.

DEFINETIME(date time)

Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

ENABLESTATUS

Displays the status of the pipeline:

ENABLED: The pipeline is ready for use.
DISABLED: The pipeline is not processing requests, and cannot accept new work. It might have failed to initialize or might have been explicitly disabled.
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 current 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 current work to complete.

INSTALLAGENT(value)

Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

BUNDLE: The resource was installed by a bundle deployment.
CREATESPI: The resource was installed by an EXEC CICS CREATE command.
CSDAPI: The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST: The resource was installed by GRPLIST INSTALL.

INSTALLTIME(date time)

Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLUSRID(value)

Displays the 8-character user ID that installed the resource.

MODE(value)

Displays the operating mode of the pipeline.

PROVIDER: CICS® is using the pipeline as a service provider of web services.
REQUESTER: CICS is using the pipeline as a service requester of web services.
UNKNOWN: The operating mode of the pipeline cannot be determined.

MTOMNOXOPST(value)

Displays the status of the pipeline for sending outbound messages in MIME format when binary attachments are not present.

MTOMNOXOP: Outbound messages are sent in MIME format, even when there are no binary attachments present.
NOMTOMNOXOP: Outbound messages are sent in MIME format only when there are binary attachments present.

MTOMST(value)

Displays the status of the MTOM handler in the pipeline.

MTOM: The MTOM handler is enabled in the pipeline.
NOMTOM: The MTOM handler is not enabled in the pipeline.

RESPWAIT (value)

Displays the number of seconds that an application program waits for an optional message from a remote web service. If no value is displayed, the default timeout value of the transport protocol is being used.

The default timeout value for HTTP is 10 seconds.
The default timeout value for WebSphere® MQ is 60 seconds.

SENDMTOMST(value)

Displays the status of the pipeline for sending outbound messages in MIME format.

NOSENDMTOM: Outbound messages are never sent in MIME format.
SAMESENDMTOM: Outbound messages are sent in MIME format only when the inbound message is in MIME format.
SENDMTOM: Outbound messages are always sent in MIME format.

SHELF(value)

Displays the name of the shelf directory. The name can be up to 255 characters long. This field is blank for a PIPELINE resource that is installed in a CICS bundle.

SOAPLEVEL(value)

Displays the level of SOAP that is supported in the pipeline. The SOAP level can be 1.1 or 1.2. If the pipeline is not being used for SOAP messages, a value of NOTSOAP is displayed.

WSDIR(value)

Displays the name of the web service binding directory (also known as the pickup directory). The name can be up to 255 characters long.

XOPDIRECTST(value)

Displays the status of the pipeline for handling XOP documents and binary attachments in direct or compatibility mode.

XOPDIRECT: The pipeline is processing XOP documents and binary attachments in direct mode.
NOXOPDIRECT: The pipeline is processing XOP documents and binary attachments in compatibility mode.

XOPSUPPORTST(value)

Displays the status of the application handler for processing XOP documents and binary attachments directly.

XOPSUPPORT: The application handler supports the direct handling of XOP documents and binary attachments.
NOXOPSUPPORT: The application handler does not support the direct handling of XOP documents and binary attachments.