IBM Support

CNX0104E markup in the document preceding the root element must be well-formed

Troubleshooting


Problem

You are trying to connect your CICS Explorer to a standalone CICS region. This fails with message CNX0104E Connection failed with exception The markup in the document preceding the root element must be well-formed. In CICS, you receive message DFHWB0101 CWWU The CICS Web Interface program DFHWBA detected a failure in DFHWBBLI.

Symptom

Here is the complete DFHWB0101 message:
DFHWB0101 CWWU The CICS Web Interface alias program DFHWBA detected a failure in program DFHWBBLI. Host IP address: hostIPAddr Client IP address: ClientIPAddr. TCPIPSERVICE: TCPIPService

Looking at the Explorer trace, you see that the CICS region is sending a 500 Internal Server Error.

Cause

Group DFHFEPI which contains program DFHEITSZ is not being installed in the CICS region. DFHFEPI is in the DFHLIST startup group list, so this should have been done automatically when CICS was installed. However, a customized list is being used instead of DFHLIST.

Diagnosing The Problem

To see the cause of this 500 Internal Server Error, capture a dump of message DFHWB0101 with CICS internal trace active.

Looking at the trace, you will see:
AP 4593 WBBLI *EXC* - RESPONSE_INVALID_LENGTH
which caused the 500 Internal Server Error to be sent back to the client.

Backing up from here, you see an exception trace entry coming from DFHWUIPG
AP A221 WUIPG *EXC* - ldTable_TSZ

This is what causes the Invalid Length on the response. The reason for the ldTable_TSZ exception is because CICS failed to load program DFHEITSZ.

From the Explorer side, you can turn on the trace before recreating the problem by clicking on Explorer > Trace > Collect Service Data. When you open the log files contained within the .zip file that is created, you will see the following trace entries:
com.ibm.cics.sm.comm.sm.internal.SMCPSMConnection.get() [500, Internal  
Server Error, text/html]                                                
com.ibm.cics.sm.comm.sm.internal.SMCPSMConnection$ErrorHandler.
fatalError()[org.xml.sax.SAXParseException: The markup in the document preceding the root element must be well-formed., <!do]        

Resolving The Problem

Install group DFHFEPI in your CICS region. Also, make sure group DFHFEPI is in a list that is included in the group list (GRPLIST) at CICS startup.

Related Information

[{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Explorer","Platform":[{"code":"PF035","label":"z\/OS"},{"code":"PF033","label":"Windows"}],"Version":"5.1;4.2;4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICS TS CICS Transaction Server

Document Information

Modified date:
15 June 2018

UID

swg21469891