Changes to the system programming interface

CREATE PIPELINE command

Use the CREATE PIPELINE command to dynamically create a PIPELINE in your CICS® region. The attributes you can specify on this command are described in PIPELINE attributes.

CREATE WEBSERVICE command

Use the CREATE WEBSERVICE command to dynamically create a WEBSERVICE in your CICS region. The attributes you can specify on this command are described in WEBSERVICE attributes.

DISCARD PIPELINE command

Use the DISCARD PIPELINE pipeline to remove a PIPELINE from your CICS region. The PIPELINE must be disabled before it can be discarded.

DISCARD WEBSERVICE command

Use the DISCARD WEBSERVICE command to remove a WEBSERVICE from your CICS region. The WEBSERVICE must be disabled before it can be discarded.

INQUIRE PIPELINE command

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

Read syntax diagramSkip visual syntax diagram
INQUIRE PIPELINE

                                  .---------------------------.   
                                  V                           |   
>>-INQUIRE--PIPELINE(data-value)----+-----------------------+-+-><
                                    +-CONFIGFILE(data-area)-+     
                                    +-ENABLESTATUS(cvda)----+     
                                    +-SHELF(data-area)------+     
                                    '-WSDIR(data-area)------'     

You can browse through all the PIPELINEs installed in your system by using the browse options (START, NEXT, and END) on INQUIRE PIPELINE commands.

Options

CONFIGFILE(data-area)
Returns the name of the pipeline configuration file associated with the PIPELINE resource. The name can be up to 255 characters long.
ENABLESTATUS(cvda)
Returns the status of the PIPELINE:
ENABLED
The PIPELINE is ready for use.
DISABLED
The PIPELINE is not processing requests, and is unable to accept new work. It may have failed to initialize, or may 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 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.
PIPELINE(data-value)
Specifies the name of the PIPELINE about which you are inquiring. The name can be up to 8 characters long.
SHELF(data-area)
Returns the name of the shelf directory. The name can be up to 255 characters long.
WSDIR(data-area)
Returns the name of the Web service binding directory (also known as the pickup directory). The name can be up to 255 characters long.

INQUIRE WORKREQUEST command

There is a new value for the WORKTYPE option on the INQUIRE WORKREQUEST command:
SOAP
Specifies that the work is being executed for a Web service request.

PERFORM PIPELINE command

Use the PERFORM PIPELINE command to initiate a scan of the Web service binding files that are associated with a PIPELINE.

Read syntax diagramSkip visual syntax diagram
PERFORM PIPELINE

>>-PERFORM--PIPELINE(name)--+--------------+-------------------><
                            +-ACTION(cvda)-+   
                            '-SCAN---------'   

The Web service binding files that are scanned are located in the directory that is specified in the WSBIND attribute of the PIPELINE definition. If the WSBIND 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 should be installed into the system:
  • CICS installs any files it finds that have not been installed already.
  • If a file has been installed already, 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.

Options

ACTION(cvda)
Specifies a CVDA value indicating the action to be taken on the PIPELINE. CVDA values are:
SCAN
Scan the PIPELINE's Web service binding directory
PIPELINE(name)
Specifies the name of the PIPELINE.

Conditions

DUPRES
RESP2 values:
29
During a scan one or more Web service binding file 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 exsiting definition refers to 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
9
The state of the PIPELINE is not ENABLED
25
An error occurred when scanning the PIPELINE's Web service binding directory
26
A scan of the PIPELINE's Web service binding directory is already in progress
27
The PIPELINE's Web service binding directory could not be accessed
NOTAUTH
Resp2 values:
100
The user associated with the issuing task is not authorized to use this command
NOTFND
Resp2 values
1
The PIPELINE was not found

PERFORM STATISTICS RECORD command

This command supports the following new options:
PIPELINE
Records statistics related to a PIPELINE. This includes information about HFS files.

SET PIPELINE command

Use the SET PIPELINE command to change the status of an installed PIPELINE:
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.

SET WORKREQUEST command

There is a new value for the WORKTYPE option on the SET WORKREQUEST command:
SOAP
Specifies that the work is being executed for a Web service request.