js2ls command

Generate a CICS application as a Web service provider or requester, starting with one or more JSON schemas.
Important: Before attempting to run a CICS Web Service on Enterprise Server, review the information in the Configuration Requirements for CICS Web Services topic.

Syntax:

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

Parameters:

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.
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.
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).
wsbind=bind-file
The fully qualified name of the Web service bind file.
bundle=folder-name
The path to and name of the bundle directory and archive file (.zip or .jar).
ccsid=ccsid
The CCSID used at run time to encode character data into the application data structure.
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.
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.
default-char-maxlength=max-length
The default string size to use for unbounded strings when none is specified in the JSON schema.
http-methods={GET|POST|PUT|DELETE|HEAD}[,...]
For RESTful services only, specify one or more methods that are accepted by the RESTful service. Separate multiple methods with a comma (,).
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 to 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.
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.
logfile=logfile
The fully qualified name of a logfile to contain output information generated by the js2ls command. When not specified, no logfile is generated.
pdsmem=pds-prefix
The prefix to use for the copybook containing the generated data structure. For linkable and RESTful services only.
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.
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.
-help
Displays information about js2ls parameters.

Example

js2ls pgmname=reverseJ reqmem=req respmem=resp wsbind=C:\tutorials\BookREST\loadlib\BookREST.wsbind logfile=C:\tutorials\BookREST\loadlib\MyTest.log json-schema-request=C:\tutorials\BookREST\json\reverseReq.json json-schema-response=C:\tutorials\BookREST\json\reverseResp.json uri=/cics/services/json/reverse pgmint=channel http-methods={GET,POST,PUT,DELETE,HEAD} inline-maxoccurs-limit=255