ls2ws command

Exposes a CICS application program as a Web service by generating a Web service description (WSDL) file and a Web service bind (WSBIND) file.

Attention: This feature is in Early Adopter Product (EAP) release status. We intend to provide the finalized feature in a future release. Please contact Micro Focus SupportLine if you require further clarification.

The CICS Web Services feature is EAP for development and testing usage. It should not be used for production deployment in this product release

Important: As a prerequisite to using the CICS Web Services feature, you must first install the IBM CCSID Conversion Tables and configure accordingly. See Install and Configure CCSID Conversion Tables for instructions.

Syntax:

ls2ws pgmint={channel|commarea}
      pgmname=program-name
      uri=address
      wsbind=bind-file
      wsdl=wsdl-file
      reqmem=request-copy-file
     [respmem=response-copy-file]
     [operation-name=operation-name]
     [wsdl-namespace=wsdl-namespace]
     [contid=container-name]

ls2ws -help

Parameters:

channel: Pass data via a channel container.
commarea: Pass data via a commarea.
program-name: The name of the target application program to expose as a Web service.
address: The relative or absolute URI to be used by a client to access the Web service.
bind-file: The fully qualified name of the Web service bind file.
wsdl-file: The fully qualified name of the WSDL file to contain the Web service description.
request-copy-file: The fully qualified name of the copybook file containing the high-level language structure for the Web service request.
response-copy-file: The fully qualified name of the copybook file containing the high-level language structure for the Web service response.
operation-name: The operation name used in the generated WSDL file. When not specified, this defaults to the value of program-name plus the literal value Operation.
wsdl-namespace: The CICS namespace used in the generated WSDL file. When not specified, this defaults to http://www.pgmname.com.
container-name: The name of the container that holds the top-level data structure used to represent a SOAP message. When not specified, this defaults to DFHWS-DATA.
-help: Displays information about ls2ws parameters.

Examples:

Example 1

The following command uses the incpy.cpy request copybook and the outcpy.cpy response copybook to communicate with the comml1 CICS program, and generates the mywsdl.wsdl WSDL file and the mywsbind.wsbind Web service bind file:

ls2ws pgmname=comml1 
      pgmint=channel 
      reqmem=incpy.cpy 
      respmem=outcpy.cpy 
      wsdl=mywsdl.wsdl 
      wsbind=mywsbind.wsbind 
      uri=/mysvc/operation

Example 2

The following command uses the set1.cpy request copybook to communicate with the set1 CICS program, and generates the set1.wsdl WSDL file and the set1.wsbind Web service bind file that each contain a newly defined operation named newOperation:

ls2ws pgmname=set1 
      pgmint=commarea 
      reqmem=set1.cpy 
      wsdl=set1.wsdl 
      wsbind=set1.wsbind 
      uri=/mysvc/operation 
      operation-name=newOperation