Reviewing IBM Connect:Direct Messages and Sense Codes

As you research a problem, note any messages issued by IBM® Connect:Direct®. Look specifically for messages displayed by the API through the IUI or batch interface. If an error occurred in a file transfer, look at messages for any Processes executing at that time for both nodes.

Also, check for messages in the JES log for z/OS.

IBM Connect:Direct messages contain short and long text to explain the error. Connect:Direct for z/OS® displays the short text when an event occurs. The following information is displayed for each message if you request the long text:

  • Module issuing the message
  • Short and long message texts
  • System action as a result of the message situation
  • User response to correct the situation
Note: For z/OS, press PF1 to display the longer explanation if the message is issued in an ISPF panel.

IBM Connect:Direct sense codes address connection errors involving the netmap and the DGADETLU (alias of DMGNETLU) module. The following is an example of a sense code display containing both the long and short text. For additional information, see Messages in IBM Connect:Direct for z/OS User Guide.

 Connect:Direct MESSAGE DISPLAY
                                                             DATE => 2010.07.22
                                                             TIME => 09:53
  MESSAGE ID==> SENS4022
  MODULE    ==> DMGNETLU
  ==============================================================================

  SHORT TEXT==> LUNAME does not match name of node in NETMAP
  LONG TEXT:
     LINE 1 ==> The LUNAME or the remote node does not match the LUNAME
     LINE 2 ==> that is associated with the symbolic node name in the
     LINE 3 ==> C:D Network Map file. See messages SVTR014I and SVTR021I.
     LINE 4 ==>
     LINE 5 ==>
     LINE 6 ==> SYSTEM ACTION: The session is terminated unless NETMAP.CHECK
     LINE 7 ==> is specified in the INIT parms with the WARN parameter.
     LINE 8 ==>
     LINE 9 ==>
     LINE 10==> RESPONSE: The Adjacent.Node entry in the Network Map must be
     LINE 11==>           updated to reflect the proper LUNAME, OR the remote
     LINE 12==>           node should call in with correct LUNAME.

  COMMAND  ===> ________  ENTER 'DIR' TO DISPLAY THE DIRECTORY