Previous Topic Next topic Print topic


js2ls command

Expose a CICS application as a Web service provider or construct a Web service requester.
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:

js2ls pgmint={channel|commarea}
      wsbind=bind-file
     {json-schema=json-filename|
      json-schema-request=request-filename
      json-schema-response=response-filename|
      json-schema-restful=rest-filename}
     [jsontransfrm=transform-filename]
      pgmname=program-name 
     [reqmem=request-prefix]
     [respmem=response-prefix]
     [uri=address]
     [contid=container-name]
     [ccsid=ccsid]
     [synconreturn={yes|no}]
     [data-trunction={enabled|disabled}]
     [bundle=folder-name]
     [char-whitespace={collapse|replace|preserve}]
     [http-methods={GET|POST|PUT|DELETE|HEAD}...]
     [pdsmem=pds-prefix]
js2ls -help

Parameters:

pgmint={channel|commarea}
Note: For generating a Web service provider.
channel
Create a service provider that passes data to the target application program via a channel container.
commarea
Create a service provider that passes data to the target application program via a commarea.
wsbind=bind-file
The fully qualified name of the Web service bind file.
json-schema=json-filename
The fully qualified name of the JSON schema file. LINKable interfaces only.
json-schema-request=request-filename
The fully qualified name of the JSON schema file that contains the input data area. Must be used with json-schema-response=response-filename. For Request-Response services only.
json-schema-response=response-filename
The fully qualified name of the JSON schema file that contains the output data area. Must be used with json-schema-request=request-filename. For Request-Response services only.
json-schema-restful=rest-filename
The fully qualified name of the JSON schema file. For RESTful services only.
jsontransfrm=transform-filename
The name to use for the JSONTRANSFRM bundle resource in CICS; also the name of the generated JSBIND file. LINKable interfaces only.
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).
reqmem=request-prefix
A one- to six-character prefix used in naming the request copybook file generated for a Web service. The generated copybook file contains the Web service request data structures.
respmem=response-prefix
A one- to six-character prefix used in naming the response copybook file generated for a Web service. The generated copybook file contains the Web service response data structures.
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.
contid=container-name
For generating a Web service provider, 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.
bundle=folder-name
The path to and name of the bundle directory and archive file (.zip or .jar).
http-methods={GET|POST|PUT|DELETE|HEAD}...
For RESTful services only, specify one or more methods that are accepted by the RESTful service.
pdsmem=pds-prefix
The prefix to use for the copybook containing the generated data structure. For LINKable and RESTful services only.
-help
Displays information about ws2ls parameters.
Previous Topic Next topic Print topic