Previous Topic: Architecture

Next Topic: Sample Flow

Web Services Limitations

This feature relies on the Web Services Server which is part of the IBM i operating system. Only 2E service programs generated as RPG ILE or COBOL ILE are candidates for exposure. The Web Service client portion is not created by this feature.

IBM states: "There are a few limitations within the Web services server regarding the deployment of services. To retrieve the most current information on restrictions, refer to the document located at /QIBM/ProdData/OS/WebServices/V1/server/docs/readme.txt."

The YCRTWS and YUNSWS commands require the user issuing command to have special authorities *ALLOBJ and *IOSYSCFG. This is due to the underlying IBM IWS scripts requiring those special authorities.

One of these limitations you need to be aware of is this: When a module is defined with a RCD parameter definition, in the generated source a data structure is used as the parameter for the *ENTRY PLIST. If some of the fields on the RCD parameter data structure are not being used as parameters, then due to an IBM limitation in the PCML generation, in the IBM Test client interface you will see redundant parameters (or subfields) named "_unnamed_1", "_unnamed_2", etc. These can be ignored and do not cause any problems.

Full details of the restrictions can be viewed in IBM's documentation.

Note: To call a deployed web service on a web services server, the user ID that is on the Properties for the web service needs to satisfy the following criteria: 1. The user ID must have the necessary authority to this program object and any other additional program objects. 2. The server profile QWSERVICE must have *USE authority to the user ID.