SNA NRJE User/Programmer Reference Manual (30292-90006)

Chapter 6 201
NRJE Manager Intrinsics
NRJEStartWS
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
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.