Considerations when creating a web service

This topic provides a link to information about how to invoke a service flow as the application program component of a web service and also provides some troubleshooting information.

Invoking a web service generated from a service flow project

For a description of how to invoke a service flow as the application component of a web service, see the relevant chapter in the CICS® Service Flow Runtime documentation (see Supported runtime environments for each project type).

Troubleshooting information for creating web services

When troubleshooting web services, do the following:
  • Ensure that the code page conversion tables on the z/OS® system include the code page that you specified when generating the web service. For double-byte code pages, there must be a conversion between the specified code page and UTF-8 (code page 1208).
  • Verify that the data length specified for Link with COMMAREA nodes is less than or equal to the length of the message (structure) that maps the input and output messages.
    Note: If the Generate Runtime Code wizard automatically calculated the value for the maximum COMMAREA length, then you do not need to verify this value (see Generation properties of the LINK with COMMAREA invoke type).
  • Verify that the correct request name is specified in the service call. (For the meaning of request name see Common generation properties of all three flow types.)