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