HP 3000 Manuals HP 3000 Manuals
STARTWS
Starts a workstation or individual LUs, and optionally starts intrinsic
and/or LU tracing.
Syntax
_____________________________________________________________________________
| |
| STAR[TWS][;W[SID]=Wsid] |
| [;CH[AINSIZE]=NumRUs] |
| [;LU=LUName[,LUName]...] |
| [;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.
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
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 STARTWS 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 a Wsid, the default workstation identifier is used.
You can specify a default workstation identifier in the NRJE command.
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. Tracing is described in Chapter 5 of this manual.
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 NRJECONTROL START earlier in this chapter. NRJEStartWS is the
manager intrinsic counterpart of this command; it is described in the SNA
NRJE User/Programmer Reference Manual.