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.
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.
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]
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.
CICS/TS CICS TS CICS Transaction Server
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.