Diagnosing problems accessing IMS from Java applications

If you are unable to access IMS™ from your Java™ application, verify that IMS TM resource adapter is properly set up and configured, that IMS Connect and IMS are active, and that you can access the host system by using the ping command.

About this task

  • Verify that you have the correct setup and configurations for using the IMS TM resource adapter. See the topic on supported versions, configurations, and platforms for supported configurations.
  • Verify that IMS Connect is active by ensuring that the outstanding IMS Connect reply HWSC0000I *IMS CONNECT READY* ims_connect_name is displayed on the system console of the target system.
  • Verify that the port and data store 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* is displayed on the system console of the target system.
  • Verify that the cross-system coupling facility (XCF) service 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 will be similar to the following output:
    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 access the target host system by using the ping command. If you cannot ping the host system 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 that is returned by the IMS application program matches the output COBOL definition used by the service. For a Java EE 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 the topic on logging and tracing with the IMS TM resource adapter for instructions on how to turn on the IMS TM resource adapter trace.