IPX/SPX Configuration and Management Manual

NonStop™ IPX/SPX PTrace Facility
IPX/SPX Configuration and Management Manual—425731-001
4-3
Running PTrace
Running PTrace
Although the PTrace Reference Manual covers this subject in more detail, the
descriptions that follow are enough information to get you started running PTrace.
Starting a Noninteractive PTrace Session
The syntax of the TACL or SCF RUN command for PTrace is
run-option-list
is one or more NonStop™ Kernel run options, as described in the TACL Reference
Manual. Although other run options are allowed, the options that have special
significance for PTrace are
IN file-name
designates the initial source for the PTrace command input for a session. If you
omit the IN option, the input source defaults to the input file for the TACL
process through which you started PTrace (usually a terminal).
NOWAIT
means that TACL or SCF does not wait while PTrace runs but returns a
command interpreter prompt after sending the startup message to PTrace. If you
omit this option, TACL or SCF pauses while PTrace runs.
OUT [ file-name ]
designates the initial destination for PTrace display output for the session. You
can use this formatted file for your problem diagnosis. If you omit the OUT
option, the output destination defaults to the output file of the TACL or SCF
process through which you started PTrace (usually a home terminal).
If you specify OUT but omit file-name, PTrace output is discarded. If you
specify an existing disk file, the file’s data is purged and new data is written to
the file. If the file does not exist, TACL creates an EDIT file with an extent size
of 4 pages for the primary extent and 16 pages for secondary extents (maximum
of 400 pages). You can have up to 16 secondary extents for a maximum file size
of 260 pages. If you will need a file larger than 260 pages, you must use a
previously created file. When the PTrace disk file reaches end-of-file (EOF),
PTrace stops.
ptrace-command
is a PTrace command that is to be executed immediately after PTrace is initiated
(such as SELECT). If you specify one or more PTrace commands in the RUN
command, PTrace executes the commands and then issues its prompt. If PTrace
encounters an error in a command, PTrace terminates immediately.
PTRACE [ /run-option-list ] [ ptrace-command ] ...