SNA NRJE Node Managers Guide (30292-90007)

60 Chapter5
SNA NRJE Troubleshooting
The Tracing Facility
The Tracing Facility
Tracing is an interpretive diagnostic technique that provides data for
analysis, and can be done at many levels. SNA link tracing is done at
the lowest level and at an intermediate level (see the SNA Link
Services Reference Manual, or the SNA Link/XL Node Manager’s
Guide). SNA NRJE tracing is at the highest level, and is controlled
through MPE commands or NRJE commands (see Chapter 6 ,
“Commands,” of this manual).
The tracing facility for SNA NRJE performs two types of tracing:
intrinsic tracing and LU tracing.
Intrinsic Tracing
Intrinsic tracing records NRJE intrinsics called by NRJE users or
invoked through NRJE commands. Intrinsic trace records are created
after successful completion of the intrinsic. If the intrinsic fails, only
the
Result array parameter is traced. Intrinsic tracing is turned on
with the NRJECONTROL START or NRJECONTROL TRACEON MPE command,
or with the STARTWS or TRACEON NRJE command. It is turned off with
the NRJECONTROL TRACEOFF MPE command or the TRACEOFF NRJE
command. Intrinsic tracing goes to a disk file. The trace file name can
be specified as an argument to any of the commands used to start
tracing. Naming the file this way allows the contents of the file to be
overwritten each time a new trace is started. (No warning is issued.) Or
you can let the default name be assigned: NMTC
nnnn .PUB.SYS, where
nnnn is a number from 0000 through 9999.
The trace file can be formatted through the NMDUMP utility. Using
NMDUMP for SNA NRJE is described later in this chapter. More
detailed information about NMDUMP is contained in the SNA Link
Services Reference Manual (for MPE V) and in Using the Node
Management Services Utilities (for MPE XL).
LU Tracing
You should use LU tracing only under the recommendation of an
HP service representative.
LU tracing records NRJE internal program events. Most modules are
traced during LU tracing. LU tracing for a workstation can be initially
turned on only when the workstation is started. After that, it can be
turned off or on as long as the workstation is active. LU tracing is
turned on with the NRJECONTROL START or (once the workstation is
active) NRJECONTROL TRACEON MPE command, or with the STARTWS or
(once the workstation is active) TRACEON NRJE command. It is turned
off with the NRJECONTROL STOP or NRJECONTROL TRACEOFF MPE
command, or the STOPWS or TRACEOFF NRJE command. LU tracing goes