HP Integrity NonStop H-Series - Manual (Page 154)

NonStop AutoTMF Software Commands
HP NonStop AutoTMF Software User’s Guide—429952-013
6-82
TRACE
The trace file can be an Edit file. Edit files provide for the most efficient tracing, but
an Edit trace file can be opened by only one process at a time.
trace-index
The runtime allows for 32 concurrent active traces. This value from 0 to 31 assigns
an index to the tracing operation. If the option is omitted, the runtime assumes
trace-index 0.
When a user is allocated a trace index, the user owns the entry until the trace expires
or is stopped. Only that user (or super) can stop the trace.
traced-entity
EXEC[UTION]
Trace the following information:
°
Enscribe calls such as KEYPOSITION, READ, WRITE intercepted by the
NonStop AutoTMF software runtime library.
°
The startup message.
°
PARAMS and ASSIGNs passed to the process.
°
DEFINEs active when the process started.
Each entry is timestamped and contains the name (or CPU, PIN) of the calling
process.
KEYS
In addition to EXECUTION information, trace key fields from read, write and
update operations. This option generates less output than DATA; key
information is sufficient to diagnose most program logic problems.
When activating a KEY or DATA trace with this command, the following
conditions and restrictions apply:
°
The trace file must be a disk file.
°
The process access id and creator access id of the tracing process must
be the same.
°
The trace file must be owned by the process access id of the tracing
process. The security on the trace file must be set to “ONOO”.
°
When a security violation occurs, tracing is turned off.
These rules guarantee that unauthorized users cannot gain access to data.
DATA
In addition to KEYS, trace entire data records sent to or returned from read,
write and update operations.