Disabling object manager tracing, Filtering traces, Trace levels – HP Integrity NonStop H-Series User Manual
Page 196: Filtering traces trace levels
Because host database managers interact with the TRACEHDB file only when one receives a
request, the trace file does not close until a host database manager receives a request.
Disabling Object Manager Tracing
To disable Object Manager tracing, purge TRACECHK and TRACEOM files in the ZDSMSCM
subvolume, then stop and start DSM/SCM.
Filtering Traces
You can filter what is traced to reduce the disk space consumed by a trace and to improve a trace
record’s readability. Without filtering, trace files can quickly take up exceedingly large amounts
of disk space when tracing DSM/SCM activities.
To filter traces, create a TRACEINI file in the ZDSMSCM subvolume. DSM/SCM executes tracing
as follows:
1.
When a DSM/SCM component starts up, it checks if tracing is enabled.
2.
If tracing is enabled, the component next searches for a TRACEINI file.
3.
If the file exists, the component searches the file for filtering instructions for that component.
If no file exists, tracing is not filtered for any components.
4.
If instructions exist, they are followed. If no instructions exist, the trace for that component is
not filtered.
Trace Levels
You can select from five levels of tracing detail for a DSM/SCM trace. Level 5 contains the most
detailed information. Level 1 contains only the high-level tasks (stages) being executed. Levels 2
through 4 successively increase the amount of detail. A higher trace level uses more disk space
and processor time but provides more detail.
For each trace level, you can do any of:
No trace information at this level is put in the trace file.
Disable
All trace information at this level is put in the trace file.
Enable
Trace all information at this level that matches a specified key string.
Selective
The basic format of a TRACEINI file contains these elements:
The name of the executable file being traced. For example, if you have enabled
trace for the Configuration Builder, it opens the TRACEINI file and searches for
[CBEXE].
[executable-name]
The indicator for tracing at each level. n is the level number. key-string is any
specific characters to be filtered for at the specified level. Values within double
Level-n { ON ["key-string"] |
OFF }
quotes ("") are case-sensitive. You can use the asterisk (*) as a wild card. The
default is ON, which enables tracing of all records at a level. For a list of search
strings, see
demonstrates how you can create a TRACEINI file to filter your tracing.
196
Special Troubleshooting and Recovery Procedures