Starting the trace

To start the DC trace for any terminal in the IMS network, enter one of the /TRACE commands from the master terminal or the z/OS® console.

Specify at least level 3 in the command because buffer contents are usually required for complete diagnosis. If you specify level 4, the trace writes a save area set for certain entries (C00-C12, D05, AER1, and AER2).

  • For VTAM® terminals:
     /TRACE SET ON NODE P1 LEVEL 1|2|3|4 MODULE DDM|MFS|ALL
  • For ISC links:
     /TRACE SET ON NODE P1 LEVEL=1|2|3|4 MODULE DDM|MFS|ALL
                           or
     /TRACE SET ON NODE P1 USER P2
  • For logical LINKs:
     /TRACE SET ON LINK P1,..,Pn|ALL LEVEL 1|2|3|4 MODULE DDM|MFS|ALL
  • For UNITTYPE:
     /TRACE SET ON UNITTYPE P1,..,Pn LEVEL 1|2|3|4 MODULE DDM|MFS|ALL
      UPDATE MSLINK NAME(linkname|linkname*|*) START(TRACE)
    Note: The type-2 command UPDATE MSLINK NAME(linkname) START(TRACE) uses the same level and module settings that were used the last time the /TRACE SET (ON) LINK command was issued. If a /TRACE SET (ON) LINK command has not been issued since the last cold start, this command defaults to MODULE=ALL and LEVEL=4.
  • For an XRF environment:
     /TRACE SET ON NODE xxx TAKEOVER
     
     /TRACE SET ON LINE xxx TAKEOVER
     
     /TRACE SET ON LINK xxx TAKEOVER
    
    UPDATE MSLINK NAME(linkname) START(TRACE) SET(TKOTRC((Y))
    Tip:
    • The /TRACE SET ON NODExxx TAKEOVER command starts the trace for the specified terminals during takeover only.
    • You can enter this command only from the active system in an XRF environment.
    • After a terminal has switched successfully, the trace is automatically turned off for that terminal.
    • Because this command is recovered across restart and takeover, you need to enter it only once. After a cold start, you must enter the command again.
    • Tracing occurs only if the session was active at the time of the takeover.
    • If you enter a /TRACE command with and without the TAKEOVER keyword, the last command you entered is in effect.
    • You can issue this command for VTAM nodes and MSC links during takeover.
    • The /TRACE SET OFF NODE xxx TAKEOVER, /TRACE SET OFF LINE xxx TAKEOVER, /TRACE SET OFF LINK xxx TAKEOVER or UPDATE MSLINK NAME (linkname) STOP(TRACE) SET(TKOTRC(N)) command turns off the trace anytime before takeover.