Running the web services assistant program DFHLS2WS

The CICS web services assistant consists of two batch programs that can help you to transform existing CICS applications into web services, and to enable CICS applications to use web services provided by external providers. Program DFHLS2WS transforms a language structure to generate a web service binding file and a web service description.

Procedure

Copy the supplied sample JCL to a suitable working file.
The JCL is supplied in samples/webservices/JCL/LS2WS.
Add a valid JOB card to the JCL.
Code the parameters for DFHLS2WS.
The following parameters are required for the INQUIRE SINGLE ITEM function of the example application are:
```
//INPUT.SYSUT1 DD *                     
LOGFILE=/u/exampleapp/wsbind/inquireSingle.log      
PDSLIB=CICSHLQ.SDFHSAMP                 
REQMEM=DFH0XCP4
RESPMEM=DFH0XCP4                        
LANG=COBOL 
PGMNAME=DFH0XCMN                        
PGMINT=COMMAREA                         
URI=mycicsserver:myport/exampleApp/inquireSingle
WSBIND=/u/exampleapp/wsbind/inquireSingle.wsbind    
WSDL=/u/exampleapp/wsdl/inquireSingle.wsdl          
*/                                      
```
LOGFILE=/u/exampleapp/wsbind/inquireSingle.log

The file that is used to record diagnostic information from DFHLS2WS. The file is normally used only by IBM software support organization.

PDSLIB=CICSHLQ.SDFHSAMP

The name of the partitioned data set (PDS) where the web services assistant looks for copybooks that define the request and response structures. In the example, this is the CICS installed data set SDFHSAMP.

REQMEM=DFH0XCP4

RESPMEM=DFH0XCP4

These parameters define the language structure for the request and the response to the program. In the example, the request and the response have the same structure and are defined by the same copybook.

LANG=COBOL

The target program and the data structures are written in COBOL.

PGMNAME=DFH0XCMN

The name of the target program that is started when a web service request is received.

PGMINT=COMMAREA

The target program is invoked with a COMMAREA interface.

URI=mycicsserver:myport/exampleApp/inquireSingle
The unique part of the URI that is used in the generated web service definition, and used to create the URIMAP resource that maps incoming requests to the correct web service. The value specified results in the service being available to external clients at:
http://mycicsserver:myport/exampleApp/inquireSingle
where mycicsserver and myport are the CICS server address and the port onto which this WEBSERVICE resource has been installed.
Note: The parameter does not have a leading '/'.
WSBIND=/u/exampleapp/wsbind/inquireSingle.wsbind

The location on z/OS UNIX to which the web service binding file is written.
Note: If the file is to be used with the pipeline scanning mechanism it must have the extension .wsbind.

WSDL=/u/exampleapp/wsdl/inquireSingle.wsdl

The location on z/OS UNIX to which the file containing the generated web service description is written. It is good practice to use matching names for the web service binding file and its corresponding web service description.

Conventionally, files containing web service descriptions have the extension .wsdl.

The web services description provides the information that a client must use to access the web service. It contains an XML schema definition of the request and response, and location information for the service.
Run the job.
A web service description and web service binding file are created in the locations specified.