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