Troubleshooting the z/Server configuration

Mainframe Access Configuration Utility

The z/Server Configuration Utility 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 Web 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.

Error messages

Use the information in any error messages to determine what the possible issues might be.

For example, trying to start the MFA Server holder process with an invalid XML results in the MFA Server 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:

Reason

The Reason code indicates a specific problem with the XML code - check the section Reason codes listed by value in IBM's "z/OS V2R1.0 XML System Services User's Guide and Reference" (SA38-0681).

Error offset

The location in hexadecimal from the start of the XML document where the error occurred.

The error message quoted earlier is caused by the following invalid XML code:

<Configuration
                     TCP_PORT="2020"
                     NETWORK_ID="DDINET1"
                     LU62_APPLID="MFM62ACB"
                     APPLID_PASSWORD="MFM62PSW"
                     TRACING="0"
                     ORGANIZATION="YOUR_COMPANY_NAME"
                     SVC_NO="NNN" 
                     DSP_TOKEN="TAURSERV" 
                     IPSTACK="TCPIP"
> 
...
    <!-- Application Server address space definitions  -->
    <ApplicationServers>
        <!-- z/Server Scheduler -->
        <Scheduler   SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200"
                     FIRST_PORT="1201" LAST_PORT="1249"
                     USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
                     DEFAULT="1"
        >
            <UserServer CCSID="037" />
        </Scheduler>
    </ApplicationServers>
...
</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.

XML validation tools

You can use any third-party XML validation tool to check the XML configuration file against the XML schema file available in hlq.ZSERVER.CONFIG(MFASCHEM).