SNA NRJE User/Programmer Reference Manual (30292-90006)
Chapter 6 207
NRJE Manager Intrinsics
NRJETrace
intrinsic, only the status array will be traced.
DefaultFile
An output byte array. The
DefaultFile
parameter
is the file designator of the default trace file. A default
file name is created whenever
TraceFileLen
is zero.
Default file names are in the form NMTC
nnnn
.PUB.SYS,
where
nnnn
is a four-digit number that is incremented
each time a default trace is created. Default file names
are up to 27 bytes long. The last character is always a
blank. You can always retain trace data by using a
DefaultFile
; however, considerable disk space might
be used.
Result
An eight-element integer output array (required).
The
Result
array contains error codes that occurred
during execution of this intrinsic.
The first element of the
Result
array is set to zero if no
errors took place. The structure of the
Result
array is
described in “Parameters Common to NRJE Intrinsics”
in the introduction to Chapter 5 , “User Intrinsics.”
Always test the first element of
Result
immediately
after you call this intrinsic. If the first element of
Result
is not zero, test the other elements of
Result
to
determine the nature of the problem that has occurred.
Description
NRJETrace starts and stops NRJE tracing. Specify trace types and trace
file characteristics in the input parameters. Tracing can also be
initiated when a STARTWS or TRACEON command is issued, or when an
NRJEStartWS or another NRJETrace intrinsic is called. If you set
TraceFileLen
to zero, then a default trace file, NMTC
nnnn
.PUB.SYS, is
created and identified in
DefaultFile
. You can always retain trace
data this way; however, considerable disk space might be used.
This intrinsic examines all input parameters when
TraceOnOff
=1, but
it examines
Traces
only when
TraceOnOff
=0, which stops tracing.
When NRJETrace returns control to your program, test the first element
of
Result
.
Text Reference
TRACEON and TRACEOFF are NRJE subsystem commands that turn trace
on and off. See the SNA NRJE Node Manager’s Guide for more
information on these commands.
NRJECONTROL TRACEON and NRJECONTROL TRACEOFF are MPE
commands that turn trace on and off. Also see the SNA NRJE Node
Manager’s Guide for more information.