ws2ls command

Syntax:

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

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.

ccsid=ccsid

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

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 maximum size an array can be before it is replaced with a container-based mapping in the generated service or client. Valid values are from 1 through 32767 inclusive.

Note: For complete information about how Enterprise Developer generates COBOL variable-length array structures for CICS Web services from WSDL and JSON, see Handling Variable Arrays in WSDL and JSON - CICS COBOL.

logfile=logfile

The fully qualified name of a logfile to contain output information generated by the ws2ls command. When not specified, no logfile is generated.

operations=op-name-1[,op-name-n[,...]]

Specifies a subset of valid WSDL operations to use in generating the WSBIND file; requester mode only.

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.

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.

synconreturn={yes|no}

yes

The remote service can issue a sync point.

no

The remote service cannot issue a sync point.

uri=address

For Web service providers, specifies the relative URI used by a client 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.

-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