hpux man page for nettlconf

nettlconf(1M)															     nettlconf(1M)

NAME
       nettlconf - configure network tracing and logging command subsystem database

SYNOPSIS
       conlog] logportsize]
	      maxlogspace] logfilename] logoptfile]

       logclass]
	      fmtfunc]
	      optfunc]

       ssid

DESCRIPTION
       maintains  the  database  file which contains information required by the and commands (see nettl(1M), and netfmt(1M)).	This database con-
       tains system logging information along with a description of each subsystem that uses NetTL facility to log messages.

       can be used to update the network logging parameters or to add, update and delete subsystem descriptions.  If a	subsystem  already  exists
       with the same ssid, the values given are substituted for those in the database; otherwise a new entry is created.

       System administrators may use the command to customize the network logging parameters stored in the database such as console logging behav-
       ior, the system log file name, the maximum system log file size, and the amount of memory required by NetTL facility.

       is also called during system startup to change the database to reflect the values of any relevant environment variables in the file.

       Products use the command during product installation to configure subsystems into the NetTL facility.  The installation	will  execute  the
       command for each subsystem it installs in order to provide the information necessary for the subsystem to use the NetTL facility.

       Only users with appropriate privileges can invoke to modify the configuration file.

   Options
       The following option can be used to view the network logging parameters and all subsystem descriptions from the database.

       (abbrev: 	   display the contents of the database relevant to the network logging facility only.

       The following options can be used to update configuration information
			   about network logging.

       This indicates that subsequent options apply to updating network logging
			   information.   Changes  to  logging	information  will not take effect until has been stopped and restarted.  This is a
			   required field.

       (abbrev: 	   conlog is set to 1 if console logging is to be enabled when is started, 0 if not.  (Console logging is used	to  report
			   interesting events on the system console.)  This is an optional field.

			   NOTE: during system startup conlog will be changed to match the value of the NETTL_CONSOLE variable in the file.

       (abbrev: 	   logportsize determines the number of outstanding messages possible in the log queue.  The value is in multiples of 1024
			   bytes.  Valid range is 1 through 64.  The default is 8.  This is an optional field.

       (abbrev: 	   maxlogspace is the maximum logging file space to be allowed.  This is the combined size of the 2 ping-ponged log files.
			   Specify  the  size  in multiples of 1024 bytes.  Valid range is 1 through 10240.  Default is 1000.  This is an optional
			   field.

       (abbrev: 	   logfilename is the path and file name to be used as the system log file, without the ping-pong extension (.LOGx).   The
			   default system log file is This is an optional field.

       (abbrev: 	   logoptfile  is the path and file name to be used as the console log options file.  The information in this file will be
			   used to select logged events that will be reported to the system console.  The default console logging options file	is
			   This is an optional field.

       The following options are used to add or update a subsystem description to the database.

       Indicates that subsequent options apply to adding or updating a
			   subsystem entry.  This is an optional field.

       (abbrev: 	   ssid  (subsystem  ID number) is used as the key field in the database.  It uniquely identifies a subsystem to the NetTL
			   facility.  This is a required field.

       (abbrev: 	   ssname is the subsystem-name mnemonic.  This string is used to identify the subsystem on the command lines and also	in
			   the subsystem header displayed by the formatter (see nettl(1M), and netfmt(1M)).  This is a required field.

       (abbrev: 	   logclass  is  the  default  log class mask assigned to the subsystem at start-up of NetTL facility. This is an optional
			   field.

			   For multiple classes, the masks must be combined into a single decimal number.   For  example,  to  initially  log  and
			   events use as the logclass.	Default is an empty field in substitutes (disaster and error) for an empty class field.

			       Class	   Abbreviation
			   -----------------------------
			    informative 	1
			    warning		2
			    error		4
			    disaster		8

       (abbrev: 	   flags  the given subsystem as a kernel subsystem.  uses this information to control certain tracing and logging proper-
			   ties of the subsystem.  This is defaulted to non-kernel unless this option is specified.

       (abbrev: 	   flags the given subsystem as a streams based kernel subsystem.  uses this information to control  certain  tracing  and
			   logging  properties	of  the subsystem.  A subsystem is defaulted to non-kernel unless this option is used.	This is an
			   optional field.

       (abbrev: 	   sslib is the name of the shared library where the subsystem formatter resides.  This should be an  absolute	path  name
			   unless the library resides in Multiple subsystems can reference the same library.  This is a required field.

       (abbrev: 	   ssmsgcat  is the name of the subsystem formatter message catalog.  If the pathname and filename extension are excluded,
			   /usr/lib/nls/%L/%N.cat is used to locate ssmsgcat.  Otherwise, ssmsgcat must be formatted similarly to the  environment
			   variable (see environ(5)).  Multiple subsystems can refer to the same message catalog.  This is a required field.

       (abbrev: 	   fmtfunc  specifies  the function to call when formatting data from the given subsystem.  Multiple subsystems can refer-
			   ence the same formatting function.  Default is to form the function name from the subsystem ID as follows:

			   where N is the subsystem ID number.	If a null function is needed for this subsystem, specify

			   This is an optional field.

       (abbrev: 	   optfunc specifies the function used to process options in the filter configuration  file  (see  netfmt(1M)).   Multiple
			   subsystems  can  reference the same options processing function.  The default is an empty field in assumes a NULL func-
			   tion for an empty optfunc field.  This is an optional field.

       (abbrev: 	   ssgrpname is a group name associated with the subsystem.  It is typically the product name of the  subsystem.   Several
			   subsystems  can  be	grouped  together  so that a common banner is printed in the formatted header.	This is a required
			   field.

       The following option is used to remove a subsystem description from the database.

       (abbrev: 	   Deletes all information associated with the ssid (subsystem ID) from the database.

WARNINGS
       The utility is intended primarily for use by HP subsystems to configure themselves into the NetTL facility at  installation  time.   System
       administrators  may  wish  to  use  this command to alter the default logging class each subsystem starts up with, but no other information
       about the subsystem should be changed.

       The and commands read the file each time they are executed.  If the file becomes corrupted these commands cannot function.

       Some changes to the file do not take effect until and are stopped and restarted.

AUTHOR
       was developed by HP.

FILES
       subsystem configuration file maintained by

       configuration file controlling	     during system startup

SEE ALSO
       netfmt(1M), nettl(1M), nettlgen.conf(4), environ(5).

																     nettlconf(1M)