User Manual

NonStop AutoTMF Software Commands
HP NonStop AutoTMF Software User’s Guide—429952-014
6-82
TRACE
filename | MYTERM
name of the trace file. If MYTERM is specified, the trace output is sent to the home
terminal of the CI that issued the TRACE command.
The trace file is opened when the process is started. The file must be a process or
an entry-sequenced file with a record length of at least 132 bytes. If the file does
not exist, the file is created.
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”.