|
|
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 change
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 change 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
|