Diagnosing problems when using the IMS TM resource adapter

If you are unable to access IMS™ from your Java™ application, consider performing the following actions to diagnose the problem:
  • Verify that you have the correct prerequisites for using the IMS resource adapter. See Prerequisites for using the IMS TM resource adapter.
  • Verify that IMS Connect is active by ensuring that the outstanding IMS Connect reply "HWSC0000I *IMS CONNECT READY* ims_connect_name" appears on the system console of the target machine.
  • Verify that the PORT and DATASTORE are ACTIVE by entering the IMS Connect command VIEWHWS at the IMS Connect outstanding reply.
  • Verify that IMS is active by ensuring that the outstanding IMS reply "DFS996I *IMS READY*" appears on the system console of the target machine.
  • Verify that the XCF status of both the IMS and IMS Connect members is ACTIVE by entering the IMS command /DISPLAY OTMA at the outstanding IMS reply. The display output should be similar to the following:
    DFS000I     GROUP/MEMBER      XCF-STATUS   USER-STATUS     
    SECURITY    IMS1
    
    DFS000I     XCFGRPNM                                               
        IMS1
    
    DFS000I     -IMSNAME          ACTIVE       SERVER           FULL   
        IMS1
    
    DFS000I     -ICONNAME         ACTIVE       ACCEPT TRAFFIC          
        IMS1
    
    DFS000I     *02033/143629*   IMS1
  • If you are using TCP/IP to communicate between the Java application and IMS Connect, verify that you can successfully "ping" the target host machine. If you cannot ping the host machine and you are using a host name rather than an IP address, ensure that the host name is sufficiently qualified.

If your IMS service is not providing the expected output from the IMS transaction, ensure that the output message returned by the IMS application program matches the output COBOL definition used by the service. For a J2EE application, you can view the IMS OTMA message containing the message returned by the IMS application program by setting the traceLevel property to 3. See Logging and tracing with the IMS TM resource adapter for instructions on how to turn on the IMS resource adapter trace. For more information on the IMS OTMA message, go to the IMS web site, http://www.ibm.com/ims and select IMS Connect.

Related tasks
Logging and tracing with the IMS TM resource adapter
Related reference
J2CA0056I, WLTC0017E, HWSP1445E, and HWSSL00E Error Messages
IMS TM resource adapter messages and exceptions

Feedback