- Project
- Shows the name of the project in which the CICS Web service is created. The default is the current project. Click
Browse to specify a different project.
- Program location
- The location of the program from which to create the Web service. Click
Browse to select a location.
- Program name
- The name of the program from which to create the Web service.
- Service location
- The endpoint URL used to invoke the Web service, consisting of the server, port, and a URI used to identify the Web service
in
Enterprise Server.
- Program interface
- Lists the types of interfaces you can select for this Web service: COMMAREA or CHANNEL.
- Container name
- Shows the name of the container associated with the selected interface. The default name for the COMMAREA interface is DFHWS-DATA,
which cannot be changed. For a CHANNEL interface, this field is enabled so you can type in the name of the container.
- Operation name
- The name of the operation defined in the service interface. The default is
program-nameOperation.
- Request structure
- The path or virtual path to and name of a program or copybook that contains the data structures required to request data.
Click
Browse to select a file.
- Response structure
- The path or virtual path to and name of a program or copybook that contains the data structures required to send data. Click
Browse to select a file.
- Additional parameters
- Any additional parameters. See the
ws2ls reference topic for a list of parameters.
- Log File
- The path and filename of the log file created during CICS Web service generation.
- Service definition
- The WSDL file used to create the Web service. Click
Browse to select a file.
- Program name
- The name of the generated Web service program.
- Request file prefix
- A file prefix for the generated copybook containing the request data structure.
- Response file prefix
- A file prefix for the generated copybook containing the response data structure.
- Change preferences
- Access the CICS Web Services preferences page to make changes if required.
- Default string length
- The maximum number of characters that can be processed in a COMMAREA or CHANNEL string.
- Default array size
- The maximum number of times a single array can be processed by a COMMAREA or CHANNEL string.
- WSDL Namespace
- The namespace used in the provided WSDL file.
- From group
-
- From
- WSDL only. The name of the WSDL file that describes the Web service.
- WSDL Service
- WSDL only. For WSDL files that define more than one service, select a service from the drop-down list. The default is the
first service defined in the WSDL file.
- WSDL Port
- WSDL only. If the selected
WSDL Service defines more than one port, select a port from the drop-down list. The default is the first port defined in the WSDL file
for the selected service.
- (For request)
- JSON only.
The name of a request JSON Schema file that defines an input data structure, or the name of a JSON Schema file that defines
both input and output data structures.
- (For request)
- JSON only. The name of a request JSON Schema file that defines an input data structure , or the name of a JSON Schema or OpenAPI
(Swagger) file that defines both input and output data structures.
- Operation(s)
- From the drop-down list, check one or more operations found in the WSDL file or JSON Schema. The default is
All. For WSDL, only operations corresponding to the selected
WSDL Port are listed.
- Operation(s)
- From the drop-down list, check one or more operations found in the WSDL file, JSON Schema, or OpenAPI (Swagger) file. The
default is
All. For WSDL, only operations corresponding to the selected
WSDL Port are listed.
- (For response)
- JSON only.
The name of a response JSON Schema file that defines an output data structure or, if using a JSON Schema file that defines both input and output data structures,
<None>.
- (For response)
- JSON only. The name of a response JSON Schema file that defines an output data structure or, if using a JSON Schema or OpenAPI
(Swagger) file that defines both input and output data structures,
<None>.
- Generate group
-
- Service
- Generate a service interface file and skeleton COBOL program. Also enables the
Name field below.
- Name
- The name of the generated service interface file. The default is the name of the WSDL
or
JSON file selected. Available only when
Service is selected.
- Client
- Generate a skeleton CICS client application.
- Client
- Generate a COBOL console client application.
- Name
- The name of the generated COBOL program file without the file extension.
- Default string length
- The default string length in the generated service or client.
- Default array size
- The default size for unbounded arrays in the generated service or client. Available only when
Inline array size limit is
0.
- Character Set
- Available only when
Client is selected. Select
ASCII or
EBCDIC as appropriate to generate the client application with the character set used at run time.
- Bit Mode
- Available only when
Client is selected. Select
32 or
64 as appropriate to generate the client application with the bit mode used at run time.
- No separate structures (0)
- All variable arrays are generated inline within the main structure. Default.
- All arrays, including optional fields (1)
- All variable arrays are generated as separate structures for dynamic allocation.
- All arrays, excluding optional fields (2)
- All variable arrays, except those that occur at most once, are generated as separate structures for dynamic allocation. Arrays
that occur at most once are generated into the main structure.
- Only unbounded arrays (32767)
- Only unbounded arrays are generated as separate structures for dynamic allocation.
Note: For complete information about how
Visual COBOL generates COBOL variable-length array structures for CICS Web services from WSDL and JSON, see
Handling Variable Arrays in WSDL and JSON - CICS COBOL.