ws2ls command

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