PAM Configuration and Management Manual

SCF for PAM
PAM Configuration and Management Manual—523349-003
3-62
TRACE LINE Command
TO file-spec
specifies the file to which trace information is to be written. The file might have
been previously created as an unstructured file with file code 830. An old file is
purged of data before the trace is initiated. If the file does not exist, a file is created
with an extent size based on the number of pages specified in the PAGES option.
WRAP
specifies that when the end-of-file (EOF) mark for the trace disk file is reached,
trace data wraps around to the beginning of the file and overwrites any data there.
Considerations
•
If TO file-spec is specified, a new trace is initiated unless file-spec is
invalid, the file cannot be opened, or tracing is already active for the I/O process. If
TO file-spec is omitted, the TRACE command applies to the trace currently in
progress, if any.
•
For a backup trace, the same traces must be selected as for the primary trace.
•
The attributes WRAP and NOCOLL cannot be specified together.
•
The line-trace facilities for both the primary and the backup line I/O processes are
independent. The primary and the backup traces can be active at the same time. If
a primary/backup process is switched (such as when the PRIMARY command is
issued), the original backup line I/O process becomes the new primary process
and vice versa. Any activated traces are maintained. However, the BACKUP
modifier must be used on all further TRACE commands to the original primary
process, and TRACE commands to the original backup process should no longer
have the BACKUP modifier.
Example
This example traces all the traceable items for the LINE $PAMA:
-> TRACE LINE $PAMA, SELECT ALL, TO $M2.SUBV.TRFIL1
OPENER Traces OPENERs
PORT Traces port events
SNATR Traces #SNATR MSAP interface events
LIF Traces the LIF
LIFDI Traces the LIF data in
LIFDO Traces the LIF data out