PERFORM PIPELINE

Initiate a scan of the web service binding files that are associated with a PIPELINE resource.

PERFORM PIPELINE

Conditions: DUPRES, INVREQ, NOTAUTH, NOTFND

This command is threadsafe.

Description

Use the PERFORM PIPELINE command to initiate a scan of the web service binding directory that is specified in the WSDIR attribute of the PIPELINE definition. If the WSDIR attribute is not specified, there is nothing to scan, and control returns to your program.

If the directory location specified is valid, CICS® examines the web service binding files in the directory to determine if they can be installed into the system:

CICS installs any files that are not installed already.
If a file is already installed, but the file in the directory is newer than the one currently in use, the one that is in use is discarded, and the newer file is installed in its place.

If, for any reason, CICS fails to install an individual web service binding file, processing continues with the remaining files in the directory. When the scan completes, the pipeline is available for use with whichever of the binding files were installed successfully.

For service providers deployed using the CICS web services assistant, URIMAP resources are created automatically when the pickup directory is scanned. This scan occurs when the PIPELINE resource is installed or as a result of a PERFORM PIPELINE SCAN command. The URIMAP resource that provides CICS with the information to associate the WEBSERVICE resource with a specific URI is a required resource. The attributes for this resource are specified by a web service binding file in the pickup directory. The URIMAP resource that provides CICS with the information to associate the WSDL archive file or WSDL document with a specific URI is an optional resource and is created if either a WSDL file or WSDL archive file are present in the pickup directory.

For service requesters, CICS does not create any URIMAP resources automatically when the PIPELINE resource is installed or as a result of a PERFORM PIPELINE SCAN command.

Options

PIPELINE(data-value)

Specifies the 8–character name of the PIPELINE.

ACTION(cvda)

SCAN

Specifies a CVDA value that indicates the action to be taken on the PIPELINE. CVDA values are:

SCAN: Scan the web service binding directory of the pipeline.

Conditions

DUPRES

RESP2 values:

29

During a scan, one or more web service binding files failed to install because of a naming conflict with an existing resource. This error can occur for two reasons:

The conflict is with an existing definition that is associated with a different PIPELINE. The newly generated resource cannot be treated as an update, because the existing definition specifies a different PIPELINE.
The conflict is with a statically installed definition. You cannot use the scanning mechanism to update a static web service binding.

INVREQ

RESP2 values:

5: The specified CVDA value is invalid; that is, it is not SCAN.
10: A scan of the web service binding directory is already in progress.
11: Read access is denied to the directory specified in the WSDIR attribute for the PIPELINE resource.
25: PIPELINE scan error.
27: The web service binding directory cannot be accessed.

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

3: The named PIPELINE resource cannot be found.