OSI/AS SCF Reference Manual

OSI/AS Trace Facility
OSI/AS SCF Reference Manual—424121-001
3-7
Running PTrace
OUT [ filename ]
designates the initial destination for PTrace display output for the session. This
is the formatted file that you will be able to use for your problem diagnosis. If
the OUT option is omitted, the output destination defaults to the output file of
the TACL or SCF process through which PTrace is being initiated (usually a
terminal).
If the OUT option is specified and filename is omitted, PTrace output is
discarded. If an existing disk file is specified, its 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 will stop.
ptrace-command
is a PTrace command that is to be executed immediately after PTrace is initiated
(such as the SELECT command). If one or more PTrace commands are specified in
the RUN command, PTrace executes the commands and then issues its prompt. If
PTrace encounters an error in one of the commands, it terminates immediately.
In the following example, the TACL RUN command instructs PTrace to read its
commands from a file called PTRACE.FIRSTRUN and to write its display output to a
file called PTRACE.FIRSTOUT. TACL resumes control of the session while PTrace is
executing because of the NOWAIT option.
PTRACE/IN PTRACE.FIRSTRUN, OUT PTRACE.FIRSTOUT, NOWAIT/
In this next example, the TACL command line instructs PTrace to display the current
session parameter settings, specify trace file OSIASTR, count and display the number of
records in the file, and exit.
PTRACE; ENV; FROM OSIASTR; COUNT; EXIT
Starting an Interactive Session
To start PTrace interactively, type “PTRACE” at the TACL or SCF prompt. PTrace then
displays its product banner, followed by its prompt, the question mark (?). When you see
the prompt, you can type a PTrace command. When you are finished using PTrace, type
the EXIT command to return to TACL or SCF.
The following example shows the PTrace product banner, copyright line, and PTrace
prompt that appear after you enter PTRACE at the TACL command line:
PTRACE - Trace Formatter - T9385C20 - (16MAR90) - (031590)
Copyright Tandem Computers Incorporated 1986, 1987, 1988....
?