Pipeline definitions - PIPEDEF

The Pipeline definition (PIPEDEF) views display information about the message handler programs that act on a service request and on the response. A pipeline resource definition is used when a CICS application is acting as a web service provider or requester.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Pipeline definitions

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

EYUSTARTPIPEDEF.ADDTOGRP

 Add one or more Pipeline definitions to a resource group.
Pipeline definitions

EYUSTARTPIPEDEF.CREATE

 Create a pipeline definition and add it to the data repository.
Pipeline definitions

EYUSTARTPIPEDEF.DETAILED

 Detailed information about a selected Pipeline definition.
Pipeline definitions

EYUSTARTPIPEDEF.INSTALL

 Install a Pipeline definition in an active system. Any Pipeline to be overwritten through FORCE install must be disabled.
Pipeline definitions

EYUSTARTPIPEDEF.REMOVE

 Remove a Pipeline definition from the data repository.
Pipeline definitions

EYUSTARTPIPEDEF.TABULAR

 Tabular information about all Pipeline definitions for the current context.

Actions

Table 2. Actions available for PIPEDEF views
Action Description
ADDTOGRP Add one or more Pipeline definitions to a resource group.
CREATE Create a pipeline definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a Pipeline definition in an active system. Any Pipeline to be overwritten through FORCE install must be disabled.
REMOVE Remove a Pipeline definition from the data repository.
UPDATE Update a Pipeline definition in the data repository.

Fields

Table 3. Fields in PIPEDEF views
Field Attribute name Description
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
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.
Configuration file name on zFS for this pipeline CONFIGFILE The name of the pipeline configuration file associated with the PIPELINE resource. The name can be up to 255 characters long.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the definition.
Name NAME The name of the definition.
Name of the pipeline policy directory on zFS POLICYDIR This field is not available for use but is a placeholder for future development
Response wait time for Requester Pipeline (SSSS) RESPWAIT Specifies the number of seconds that an application program should wait for a response message from a remote Web service. The value can range from 0 to 9999 seconds, or may specify the keyword value of DEFT. If you specify RESPWAIT(DEFT) 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.
Name of a directory (shelf) for WSBind files SHELF The name of the shelf directory. The name can be up to 255 characters long.
ENABLED status STATUS The status of the PIPELINE:
  • ENABLED - Web service requests for this PIPELINE are processed normally.
  • DISABLED - Web service requests for this PIPELINE cannot be processed.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
Name of the WSBind (pickup) directory on zFS WSDIR The name of the Web service binding directory (also known as the pickup directory). The name can be up to 255 characters long.