IBM Support

How to preserve server.xml layout for z/OS Connect EE while configuring the IMS service provider?

Question & Answer


Question

I edited the server.xml file to configure the IMS service provider for use in z/OS Connect EE by following the doc here: http://www.ibm.com/support/knowledgecenter/SS4SVW_2.0.0/com.ibm.zosconnect.doc/configuring/mobile_configure.html

I also added some line breaks for readability. However, after the server starts up, all my line breaks are gone. How can I preserve the layout I want for server.xml?

Answer

During server startup, when the imsmobile feature (enabled through the <feature>imsmobile:imsmobile-2.0</feature>
tag in the <featureManager> section) is detected in server.xml, several statements are inserted automatically if they do not already exist.
These statements point to the required IMS service registry that stores the information related to connections, interactions, and transaction message metadata. During this insert operation, the server.xml is re-written, and any custom format is lost.

 To ensure your custom layout is preserved, you have two options:

  1. Option 1. Add the following statements in server.xml before you start up the server. If these statements already exist, the server.xml won't be rewritten. Make sure to replace <WLP_USER_DIR> with ther WLP_USER_DIR from your environment and <SERVER_NAME> with your th ename of your server.

    <include location="/<WLP_USER_DIR>/servers/<SERVER_NAME>/resources/imsmobile-config/interactions/ims-interactions.xml" optional="true"/> <include location="/<WLP_USER_DIR>/servers/<SERVER_NAME>/resources/imsmobile-config/connections/ims-connections.xml" optional="true"/> <include location="/<WLP_USER_DIR>/servers/<SERVER_NAME>/resources/imsmobile-config/services/ims-services.xml" optional="true"/> <include location="/<WLP_USER_DIR>/servers/<SERVER_NAME>/ims-admin-services.xml" optional="true"/>

  2. Option 2. Modify the server.xml file for your custom layout after the imsmobile feature tag is added and the server starts up.

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

Product Synonym

zCEE

Document Information

Modified date:
14 February 2023

UID

dwa1320504