HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
n
nettl(1M) nettl(1M)
into and out of the node) use either pduin pduout or 0x10000000 0x20000000
or the combination 0x30000000.
Not all subsystems support all trace kinds. No error is returned if a given subsystem does
not support a particular trace kind.
If a -traceon is issued on a subsystem that is already being traced, the tracing mask and
optional values are changed to those specified by the new command, but the new -file,
-size, and -tracemax options are ignored and a message is issued.
If -entity all is specified, all recognized subsystems are traced except X.25-specific
subsystems. To turn on tracing for X.25, use the command
nettl -traceon kind -e x.25_subsys -card dev_name
where the value of x.25_subsys is X25L2 or X25L3.
Data File Management
Data files created by the tracing and logging facility require special handling by the facility that the user
must be aware of. When files are created, they have the suffix .LOG00 or .TRC00 appended to them,
depending on whether they are log or trace files, respectively. This scheme is used to keep the files distinct
for cases where the user specifies the same name in both places. Also, the files implement a type of circular
buffer, with new data always going into the file appended with .LOG00 or .TRC00
. When a
logname.LOG00 or tracename.TRC00 file is full, each log or trace is renamed to the next higher number in
its sequence; that is, a file with sequence number
N is renamed as a file with sequence number
N+1 and a
new file named logname
.LOG00 or tracename.TRC00 is created. The number of files that can exist
simultaneously on the system can be specified by the
-n option.
Note: The file name prefix (logname or tracename) specified by the user must not exceed eight charac-
ters so that the file name plus suffix does not exceed fourteen characters. Longer names are trun-
cated. To see the actual name of the trace or log file, use the
nettl -status all
command.
Console Logging
Console logging is used to display significant log events on the system console. The values in the
/etc/nettlgen.conf
file determine if console logging is to be started and the entries in the
/var/adm/conslog.opts
file determine what log messages will be reported to the console. The
nettlconf command can be used to configure and maintain the information in the
/etc/nettlgen.conf
file (see nettlconf(1M)). If changes are made to these files, nettl must be
stopped and restarted for the new information to take effect.
All log messages written to the console as a result of this configuration information are in a special short
form. If more information is desired on the console, the
netfmt formatter can be used to direct output to
the console device. This may be most useful in an X windows environment.
Console logging may be disabled if conservation of system resources is valued more than notification of log
events.
EXTERNAL INFLUENCES
International Code Set Support
Single- and multibyte character code sets are supported in data; single-byte character code sets are sup-
ported in file names.
EXAMPLES
1. Initialize the tracing/logging facility:
nettl -start
(See note for the -start option.)
2. Display the status of the tracing/logging facility.
nettl -status all
3. Change log class to error and warning for all the subsystems. disaster logging is always on
for all subsystems.
nettl -log e w -e all
4. Turn on inbound and outbound PDU tracing for the transport and session
(OTS/9000) subsys-
tems and send binary trace messages to file
/var/adm/trace.TRC0
.
Section 1M−−552 − 5 − HP-UX Release 11i: December 2000
___
___