You can use the following diagnostic tools and information to troubleshoot issues with the z/Server configuration:
The z/Server Configuration Utility (Technical Preview) makes it easier to download, validate and edit a configuration file. This utility is available from the Product Updates section of the Micro Focus SupportLine site. To download the utility, once you have logged in to the SupportLine site, navigate to the latest version of Enterprise Developer and select z/Server Configuration Utility.
Use the information in any error messages to determine what the possible issues might be.
For example, trying to start the holder process with an invalid XML results in the holder failing to start and you receive a message indicating there is a problem with the XML validation - for example:
XCO0021E 10:50:59.846 XML Validation has failed. Reason = 8800. Error offset into XML document = 00000020.
Such messages include a reason code and an error offset:
The error message quoted earlier is caused by the following invalid XML code:
<Configuration SVC_NO="NNN" DSP_TOKEN="TAURSERV" IPSTACK="TCPIP">
<STCScheduler
SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200" FIRST_PORT="1201"
LAST_PORT="1249" USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
>
<UserServer CCSID="037" />
</STCScheduler>
</Configuration>
Use the reason code and the offset shown in this message to determine the cause of the error. In this example, the offset points to a location in the first line of the XML configuration file. Here there is an invalid attribute value in the <Configuration> section - SVC_NO="NNN" is invalid because SVC_NO must be a numeric value.