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