HPlogo SNA NRJE Node Manager's Guide: HP 3000 MPE/iX Computer Systems > Chapter 6 Commands

NRJECONTROL START

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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:

  • LU: for NRJE LU procedures.

  • 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
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 disk 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 disk space might be used.

If you specify a disk 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 disk 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 “NA NRJE Workstation Startup and Shutdown” 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.

Feedback to webmaster