Previous Topic Next topic Print topic


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
Previous Topic Next topic Print topic