SNA NRJE User/Programmer Reference Manual (30292-90006)
206 Chapter6
NRJE Manager Intrinsics
NRJETrace
Following is an example of
Traces
for LU tracing only:
1
0
TraceFileLen
An input integer. The
TraceFileLen
parameter is
the length in characters of the trace file designator,
TraceFile
.
The number of characters may be between one and
thirty-five. If this parameter is zero, the trace is
recorded in the
DefaultFile
.
TraceMedium
An input integer.
TraceMedium
indicates the
TraceFile
device type. This parameter is called by
reference. The only valid value for
TraceMedium
is 0,
which indicates that the trace information will be
written to a disk file.
TraceSize
An input single-word integer.
TraceSize
contains
the maximum number of logical records
TraceFile
is
to contain, from 0 through 32767.
A logical record is 128 words long. If
TraceSize
is zero,
the default size of 1024 records is used.
TraceFile
An input byte array. The
TraceFile
byte array
contains an actual file designator used for trace output.
This parameter is used only when
TraceFileLen
is
greater than zero. This parameter identifies a disk
trace output file.
TraceFile
can contain a fully
qualified 35-character disk file name, with lockword, in
this form:
filename[lockword][groupname[acctname]
]
The contents of
TraceFile
must be left-justified, with
trailing blanks, and meet MPE standards for an actual
file designator.
If you specify a disk file that does not exist (a NEW file),
then it will be created as the destination for trace
output.
If you specify an OLD file (it already exists), and it
already is in use for trace output, then trace output
records for this activity are interleaved with other trace
output records. You minimize the use of disk space by
using an OLD file appropriately; however, trace output
can be overwritten. If you specify an OLD file that is not
already open, the file will be overwritten with new trace
data. No warning is issued. Trace file records are
created after successful completion of the intrinsic. If
an error is encountered during the execution of the