HP 3000 Manuals

NSCONTROL LOG [ NS3000/iX Operations & Maintenance Reference Manual ] MPE/iX 5.0 Documentation


NS3000/iX Operations & Maintenance Reference Manual

NSCONTROL LOG 

Enables or disables detailed event logging for the Network Services.

Syntax 

                         [{,ALL     }        ]
                   {ON } [{,RPM     } {,LOW} ]
     NSCONTROL LOG={OFF} [{,ENV     } {,HIGH}]
                         [{,DSDAD   }        ]
                         [{,VTSERVER}        ]
                         [{,DSSERVER}        ]

Parameters 

LOG                   Enables or disables NMS logging of Network Services
                      detailed events, configured as SUB0006, CLAS0004 in
                      the NMCONFIG.PUB.SYS configuration file.  Detailed
                      events are only used for troubleshooting and are
                      normally disabled.

                      ON                    Enables detailed logging of
                                            the specified Network Service
                                            modules.

                      OFF                   Disables detailed logging of
                                            the specified Network Service
                                            modules.

                      For each Network Services software module, two
                      levels of event logging are provided.  These are
                      HIGH, which logs all events, and LOW, the default,
                      which logs a subset of the events, as specified
                      below.

                      ALL                   LOW - Logs LOW events for all
                                            modules.

                                            HIGH - Logs HIGH events for
                                            all modules.

                      RPM                   LOW - Logs RPMCREATE and
                                            RPMKILL requests.

                                            HIGH - Same as LOW.

                      ENV                   LOW - Logs environment
                                            information from DSLINE and
                                            REMOTE HELLO commands.

                                            HIGH - Same as LOW, plus
                                            environment table locking and
                                            use counts.

                      DSDAD                 LOW - Logs creation and
                                            deletion of sockets, ports,
                                            and server processes.

                                            HIGH - Same as LOW, plus all
                                            received service requests and
                                            internal messages between
                                            DSDAD and server processes.

                      VTSERVER              LOW - Logs internal
                                            initialization messages
                                            between DSDAD and user
                                            processes.

                                            HIGH - Same as LOW, plus all
                                            received messages from other
                                            processes.

                      DSSERVER              LOW - Logs internal
                                            initialization messages
                                            between DSDAD and user
                                            processes.

                                            HIGH - Same as LOW, plus all
                                            received messages from other
                                            processes.

                                            Defaults:  ALL and LOW

Discussion 

One of the log classes defined for the Network Services is detailed event
logging, which records normal Network Services events.  When first
started and during normal operation, the Network Services detailed event
logging is disabled in order to avoid the overhead of frequent logging.
Typically, detailed event logging is only enabled to investigate a
specific action or series of events if required for troubleshooting.

When detailed event logging is enabled, the log messages destination is
determined by the configuration of NMMGR logging subsystem 6 class 4
(SUB0006, CLAS0004).  The log file is the recommended destination for
detailed logging.  Logging detailed events to the system console is not
recommended, since the log messages tend to clutter the console screen.

Example 

The example below logs the environment information from DSLINE and REMOTE
HELLO commands and the service requests received by the DSDAD process.
You might use this type of event logging to monitor usage of the Network
Services.  The destination for CLAS0004 of SUB0006 specified in the NMMGR
logging configuration should be to the NM log file, not the system
console.

:NSCONTROL LOG=ON,ENV,LOW;LOG=ON,DSDAD,HIGH



MPE/iX 5.0 Documentation