HP 3000 Manuals HP 3000 Manuals
TRACEON
Turns on intrinsic and/or LU tracing for a workstation.
Syntax
_____________________________________________________________________________
| |
| TRACEON[;W[SID]=Wsid] |
[;TR[ACE]=Type[,Type][,File][,Size]]
_____________________________________________________________________________
Parameters
Wsid The workstation name. This can be up to eight alphanumeric
characters long; the first character must be alphabetic.
If you omit this parameter, the default workstation identifier
is used. You can specify a default workstation identifier in
the NRJE command.
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 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. Tracing is described in Chapter 5 of this manual. You can
specify a particular workstation by specifying a Wsid. Note that LU
tracing can be started for an active workstation only.
Text Reference
See NRJECONTROL TRACEON earlier in this chapter. NRJETrace is the
manager intrinsic counterpart of this command; it is described in the SNA
NRJE User/Programmer Reference Manual.