NRJECONTROL


NRJECONTROL

     The NRJECONTROL command is available to the MPE/iX user with
NM capability to start or stop an NRJE workstation and LUs,
or to start or stop tracing associated with a workstation. (CM)

SYNTAX


NRJECONTROL HA[LT];W[SID]=wsid[;[LU=luname[,luname]...]

NRJECONTROL STAR[TWS];W[SID]=wsid
[;CH[AINSIZE]=numrus]
[;LU=luname[,luname]...]
[;TR[ACE]=type[,[type][,[file][,size]]]]

NRJECONTROL STO[P];W[SID]=wsid[;LU=luname[,luname]...]

NRJECONTROL TRACEOFF;W[SID]=wsid[;TRACE=type[,type]]

NRJECONTROL TRACEON;W[SID]=wsid
[;TRACE=type[,[type][,[file][,size]]]]

NRJECONTROL VERSION


PARAMETERS


HALT Stops active LU-LU sessions immediately.

STARTWS Starts a workstation or individual LUs, and,
optionally, starts intrinsic and LU tracing.

STOP Stops active LU-LU sessions in an orderly manner.

TRACEOFF Stops intrinsic and LU tracing for a workstation.

TRACEON Starts intrinsic and LU tracing for a workstation.

VERSION List the versionnumber of the SNARJE software.

wsid One to eight character workstation name.

luname One to eight character LU name. A maximum of five
LUs can be identified. This is the configured LU
name (not the Network Addressable Unit--NAU) of the LU.

numrus The number (from 0 through 99) of request units to
send before requesting a definite response.

type A keyword identifying the type of trace to be started
or stopped. The possible types are LU and INTRINSIC.

file The file name of the disk file in which the trace
data is stored.

size The number (from 0 to 32767) of logical records to
store in the trace file.


OPERATION

     When you issue the NRJECONTROL command and specify the
STARTWS parameter, NRJE initiates the workstation, LUs,
and the specified type of tracing. Default LU names and
chainsize value are obtained from the NRJE configuration,
if necessary. If the specified workstation is already
active, NRJE initiates the specified LUs and traces.

When you issue the NRJECONTROL command and specify the
TRACEON parameter, NRJE starts recording the indicated
trace information in the specified file. If no file is
indicated, the trace is written to the Network Management
default file. If no traces are specified, NRJE will start
intrinsic and LU traces.

When you issue the NRJECONTROL command and specify the
TRACEOFF parameter, NRJE stops the indicated traces. If
no traces are specified, all tracing of the indicated
workstation is terminated.

When you issue the NRJECONTROL command and specify the
STOPWS parameter, NRJE stops the specified LUs. If no LUs
are indicated, NRJE stops all of the LUs of the workstation.

When you issue the NRJECONTROL command and specify the
HALT parameter, NRJE aborts the specified LUs. If no LUs
are indicated, NRJE aborts all of the LUs of the workstation.


EXAMPLE(S)

     NRJECONTROL STARTWS;WSID=BAEDP;CHAINSIZE=15

This command initiates the workstation "BAEDP" with those
LUs that are configured for automatic initiation. These
LUs will transmit with a chain size of 15.

NRJECONTROL STARTWS;WSID=BAEDP;LU=BLUE;CHAINSIZE=21

This command initiates the LU "BLUE" at the workstation
"BAEDP" (whether or not that workstation is already
active). The command also specifies that "BLUE" will
transmit with a chain size of 21.

NRJECONTROL TRACEON;WSID=BAEDP;TRACE=INTRINSIC

This initiates INTRINSIC tracing on the workstation
"BAEDP" to the default trace file. A message is returned
that indicates the name of the trace file.

NRJECONTROL HALT;WSID=BAEDP;LU=BLUE

The LU "BLUE" is aborted. The LU process is terminated
and a protocol shutdown sequence is not executed.

NRJECONTROL TRACEOFF;WSID=BAEDP

Tracing for the workstation is turned off.

NRJECONTROL STOPWS;WSID=BAEDP

The "BAEDP" workstation is stopped and all LUs become inactive.