HP 3000 Manuals HP 3000 Manuals
NRJECONTROL START
Starts a workstation or individual LUs, and optionally starts intrinsic
and/or LU tracing.
Syntax
_____________________________________________________________________________
| |
| NRJECONTROL STAR[TWS];W[SID]=Wsid |
| [;CH[AINSIZE]=NumRUs] |
| [;LU=LUName[,LUName]...] |
| [;TR[ACE]=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.
NumRUs The number (from 0 through 99) of request units (RUs) that NRJE
is to send before requesting a definite response from the host.
LUName For NRJE/V, this is the name of the SNA node LU class you want
to start. (Node classes are configured on the MPE V SNA
Configuration: Classes screen.) For NRJE/XL, this is the
configured LU Name (not the NAU number) of the LU you want to
start. (LUs are configured on the MPE XL SNANode Configuration:
PU and LU Data screen.)
The name can be up to eight alphanumeric characters long; the
first character must be alphabetic. You can specify a maximum
of five LUNames. If you do not specify any LUNames, all LUs
that are configured to be initially started are started.
You cannot start an LU that is already started.
Type The type of trace to be started:
* INTRINSIC: for 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
When the NRJECONTROL START command is issued, the NRJE monitor is
streamed and runs as an MPE job. (See Chapter 4 of this manual.) You
can start a workstation or individual LUs.
If you do not specify any LUNames, all LUs configured to be initially
started are started. If you specify LUName, only those LUs are started.
You also can start intrinsic and/or LU tracing (with the Type parameter)
with this command. Note that LU tracing can be started for an active
workstation only.
NOTE If an error occurs because of a bad trace parameter, the
workstation or LUs will not start.
Text Reference
See STARTWS later in this chapter. NRJEStartWS is the manager intrinsic
counterpart of this command; it is described in the SNA NRJE
User/Programmer Reference Manual.