SWITCHNMLOG

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index

SWITCHNMLOG

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

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.

Back to Main Index