CWWKG0014E XML error when defining REST client service for z/OS Connect EE

Question & Answer

Question

Why am I receiving message CWWKG0014E indicating "query" must end with the ';' delimiter when setting up the z/OS Connect Enterprise Edition (EE) REST client service? I have defined a REST client service using the following elements in server.xml

 <zosconnect_zosConnectService id="example" 
     serviceName="example"
     serviceRef=“exampleService”
     serviceDescription="Example Service"
     requireSecure="false" requireAuth="false"/>
 <zosconnect_zosConnectServiceRestClient 
     id="exampleService"          httpMethod="POST" 
     uri="/resource/item&query=filter"
     connectionRef="ref"/>

But trying to start the server produces the error message:

CWWKG0014E: The configuration parser detected an XML syntax error while parsing the root of the configuration and the referenced configuration documents. Error: The reference to entity "query" must end with the ';' delimiter. File: file:/var/zosconnect/servers/default/server.xml Line: 58 Column: 78

Answer

The uri parameter contains a query parameter so the & used to indicate the start of the query parameters should be escaped as & to have valid XML in the server.xml configuration file.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

zCEE

Was this topic helpful?

Document Information

Modified date:
14 February 2023

UID

dwa1311063

Tips