HP 3000 Manuals HP 3000 Manuals
NRJECONTROL TRACEON
Turns on intrinsic and/or LU tracing for a workstation.
Syntax
_____________________________________________________________________________
| |
| NRJECONTROL TRACEON;W[SID]=Wsid |
[;TRACE=Type[,Type][,File][,Size]]
_____________________________________________________________________________
Parameters
Wsid Required. The workstation name. This can be up to eight
alphanumeric characters long; the first character must be
alphabetic.
The workstation must have been configured.
Type The type of trace to be started:
* INTRINSIC: for commands and intrinsics accessed by NRJE
workstation users and managers. These intrinsics are
traced:
NRJEAlter NRJELUList NRJEStopWS
NRJECancel NRJELUStatus NRJESubmit
NRJEConsole NRJEQueue NRJE2Submit
NRJEHJCancel NRJERdrAccess NRJETrace
NRJEHJInfo NRJERdrFence NRJEWriter
NRJEJobInfo NRJEStartWS NRJEWSInfo
* LU: for NRJE LU procedures.
NOTE Use this option only when recommended by your HP representative.
This type of tracing can have a performance impact.
LU tracing for a workstation can be initially started only when the
workstation is started. After that, it can be started and stopped
at any time, as long as the workstation is active.
File An actual file designator of a disc file used for trace output
data.
If you do not specify the name of a trace output file, the
default file name NMTCnnnn.PUB.SYS is used, where nnnn is a
number from 0000 through 9999. The nnnn integer is incremented
to form and find the next available trace file name. You can
always retain trace data by using a default file name; however,
considerable disc space might be used.
If you specify a disc file that does not exist, it will be
created as the destination for trace output.
If you specify an existing file, 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 disc 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.
Size The number of logical records to be stored in the trace file,
from 0 through 32767. A logical record occupies one sector. A
trace file is created with 16 extents. One extent is initially
allocated, and additional extents are allocated one at a time,
as needed. If the trace file becomes full and more trace data
is to be written, the file is overwritten (beginning with the
first record). If you omit this parameter, a default of 1024 is
used.
Description
This command is used to start intrinsic and/or LU tracing for a
workstation. Note that LU tracing can be started for an active
workstation only. Tracing is described in Chapter 5 of this manual.
Text Reference
See TRACEON later in this chapter. NRJETrace is the manager intrinsic
counterpart of this command; it is described in the SNA NRJE
User/Programmer Reference Manual.