SWITCHNMLOG



SWITCHNMLOG

     Closes the current log file and creates and opens a new one.
     Node Manager (NM) capability required.  (CM)

SYNTAX


SWITCHNMLOG [UPDATE]
[filenumber]

PARAMETERS


UPDATE Updates logging configurations for all subsystems.
If you change the logging configuration using
NMMGR, you can update the configuration
without stopping NS or transport by issuing
the SWITCHNMLOG command with the UPDATE option.

filenumber Closes the current NMLG file and opens a new file
with the specified number. The number can be
any number from 0 to 9999.

OPERATION


SWITCHNMLOG closes the current NMLG file and creates and
opens a new one.

When SWITCHNMLOG is entered, NMS displays the following
messages to the user who entered the command

NMLG FILE NUMBER nnnn IS mm% FULL
NMLG FILE NUMBER pppp ON

and the following message on the system console

NMLG FILE NUMBER pppp ON

where nnnn is the previous NMLG FILE number, mm is the
percentage of file space used, and pppp is the newly opened
file numbered one more than the last file number. The
numbers nnnn and pppp correspond to the files NMLGnnnn.PUB.SYS
and NMLGpppp.PUB.SYS.

If NMS logging is enabled but currently suspended due to a
recoverable error, NMS displays the following messages
explaining the cause

NMLG FILE NUMBER nnnn IS mm% FULL
NMLG FILE NUMBER nnnn ERROR #ee. NM LOGGING SUSPENDED.
(NMCNERR 38)

where ee is the FSERR number. Once the underlying cause of the
error is corrected, the RESUMENMLOG command will resume NMS
logging.

If NMS logging is disabled due to an irrecoverable error, NMS
displays the following message

NMLG FILE NUMBER nnnn ERROR #ee. NM LOGGING STOPPED.
(NMCNERR 36)

where ee is the FSERR number if ee <> 1, or specifies that an
error occurred while accessing the cold load area of the system
disk if ee = 1. Once the underlying cause of the error is
corrected, the system must be restarted to start NMS logging again.

EXAMPLE(S)

     No Error

       SWITCHNMLOG
       NMLG FILE NUMBER nnnn IS mm% FULL
       NMLG FILE NUMBER pppp ON

     Recoverable Error

       SWITCHNMLOG
       NMLG FILE NUMBER nnnn ERROR #nn. NM LOGGING SUSPENDED.
       (NMCNERR 38)

     Irrecoverable Error

       SWITCHNMLOG
       NMLG FILE NUMBER nnnn ERROR #nn. NM LOGGING STOPPED.
       (NMCNERR 36)

     In these examples, nnnn is the NMLG file number corresponding
     to the file NMLGnnnn.PUB.SYS, mm is the percentage of file
     space used, ee is the FSERR number if ee<>1, or indicates an
     error accessing the system disk cold load area if ee=1, and
     pppp is the newly opened NMLG file number.