Previous Topic Next topic Print topic


ws2ls command

Expose a CICS application as a Web service provider or construct a Web service requester. Generates COBOL data structures, a skeleton COBOL program, and a Web service bind (WSBIND) file from a Web service description file (WSDL).
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:

ws2ls pgmname=program-name
      wsdl=wsdl-file
      wsbind=bind-file
     [reqmem=request-prefix]
     [respmem=response-prefix]
     [pgmint={channel|commarea}]
     [uri=address]
     [contid=container-name]
     [default-char-maxlength=max-length]
     [inline-maxoccurs-limit=max-occurs]
     [ccsid=ccsid]
     [synconreturn={yes|no}]
ws2ls -help

Parameters:

pgmname=program-name
The fully qualified file name to use for the generated skeleton CICS program. Depending on other supplied parameters, this skeleton program is generated either to invoke a Web service (requester), or to be exposed as a Web service (provider).
wsdl=wsdl-file
The fully qualified name of the WSDL file that contains the Web service description.
wsbind=bind-file
The fully qualified name of the Web service bind file.
reqmem=request-prefix
Specifies a one- to six-character prefix used in naming copybook files generated for requester Web services. A unique two-digit number is appended to this prefix to produce uniquely named copybook files. Each generated copybook file contains the request data structures for one operation defined in the given WSDL file.
respmem=response-prefix
Specifies a one- to six-character prefix used in naming copybook files generated for provider Web services. A unique two-digit number is appended to this prefix to produce the copybook file name. The generated copybook file contains the Web service response data structures.
pgmint={channel|commarea}
channel
Create a service provider that passes data to the target application program via a channel container.
Note: Do not specify the pgmint parameter when constructing a Web service requestor.
commarea
Create a service provider that passes data to the target application program via a commarea.
Note: Do not specify the pgmint parameter when constructing a Web service requestor.
uri=address
For Web service providers, specifies the relative URI used by a to access the Web service. For Web service requesters, specifies an absolute URI used in the EXEC CICS INVOKE SERVICE call within the generated skeleton program. When a URI is not supplied for a requestor Web service, the EXEC CICS INVOKE SERVICE call uses the service end point address found in the WSDL file.
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. Used only when generating a Web service provider.
default-char-maxlength=max-length
The default string size to use for unbounded strings when none is specified in the WSDL file.
inline-maxoccurs-limit=max-occurs
The default array size to use for unbounded arrays; this indicates whether inline variable repeating content is used.
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.
-help
Displays information about ws2ls parameters.

Examples:

Example 1
The following command uses the mywsdl.wsdl WSDL file to create the program.cbl skeleton COBOL program and the mywsbind.wsbind Web service bind file:
ws2ls wsdl=mywsdl.wsdl
      pgmname=program.cbl 
      wsbind=mywsbind.wsbind 
      pgmint=channel 
      reqmem=REQ 
      respmem=RESP
Example 2
The following command uses the mywsdl.wsdl WSDL file and the /mysvc/operation URI to create the mywsbind.wsbind Web service bind file, appropriate request and response copybook files, and the program.cbl skeleton COBOL program, which uses a Commarea interface to receive requests and return responses:
ws2ls wsdl=mywsdl.wsdl
		pgmname=program.cbl
		wsbind=mywsbind.wsbind
		reqmem=REQ
		respmem=RESP
		uri=/mysvc/operation
		pgmint=commarea
Previous Topic Next topic Print topic