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 CCSID Conversion Tables for more information.

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]
     [ccsid=ccsid]
     [synconreturn={yes|no}]
     [data-truncation={enabled|disabled}] 
     [datetime={unused|packed15}]

ls2ws -help

Parameters:

pgmint={channel|commarea}

channel: Pass data via a channel container.
commarea: Pass data via a commarea.

pgmname=program-name

The name of the target application program to expose as a Web service.

uri=address

The relative or absolute URI to be used by a client to access the Web service.

wsbind=bind-file

The fully qualified name of the Web service bind file.

wsdl=wsdl-file

The fully qualified name of the WSDL file to contain the Web service description.

reqmem=request-copy-file

The fully qualified name of the copybook file containing the high-level language structure for the Web service request.

respmem=response-copy-file

The fully qualified name of the copybook file containing the high-level language structure for the Web service response.

operation-name=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=wsdl-namespace

The CICS namespace used in the generated WSDL file. When not specified, this defaults to http://www.pgmname.com.

contid=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.

ccsid=ccsid

The CCSID used at runtime to encode character data into the application data structure.

synconreturn={yes|no}

yes: The remote service can issue a sync point.
no: The remote service cannot issue a sync point.

data-truncation={enabled|disabled}

enabled: Variable-length data is tolerated in a fixed-length field structure.
disabled: Variable-length data is not tolerated in a fixed-length field structure.

datetime={unused|packed15}

unused: Packed decimal fields of length 15 (8 bytes) in the data structure are not used.
packed15: Packed decimal fields of length 15 (8 bytes) in the data structure are treated as CICS ABSTIME fields and mapped as timestamps.

-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