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