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

NRJECONTROL TRACEON

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Turns on intrinsic and/or LU tracing for a workstation.

Syntax

 
NRJECONTROL TRACEON;W[SID]=Wsid
                   [;TRACE=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.

Type

The type of trace to be started:

  • LU: for NRJE LU procedures.

  • INTRINSIC: for commands and 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

This command is used to start intrinsic and/or LU tracing for a workstation. Note that LU tracing can be started for an active workstation only. Tracing is described in Chapter 5 “SNA NRJE Troubleshooting” of this manual.

Text Reference

See TRACEON later in this chapter. NRJETrace is the manager intrinsic counterpart of this command; it is described in the SNA NRJE User/Programmer Reference Manual.

Feedback to webmaster