NRJECONTROL

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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.


Back to Main Index