SNMP Configuration and Management Manual

SNMP Agent PTrace Facility

SNMP Configuration and Management Manual—424777-006

6-3

Running PTrace

Although the PTrace Reference Manual covers this subject in more detail, the

descriptions that follow should be enough 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 following options have special

significance for PTrace:

IN file-name

designates the initial source for 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

indicates 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 the OUT option and 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 [ /run-option-list ] [ ptrace-command ] ...