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.