PTrace Reference Manual

Using PTrace
PTrace Reference Manual—526393-001
2-4
Changing the Output Destination
disk file, or an application process. For example, the following TACL RUN command
initiates PTrace and directs it to send its output to a disk file called PTRACE.DISPLAY:
4> PTRACE/OUT PTRACE.DISPLAY/
If you specify an application process as the OUT file, you must specify the same
process as the IN file. See the other considerations given in Setting the Initial Input
Source on page 2-3.
Changing the Output Destination
To change where PTrace directs its output during a session, use the OUT command,
described in Section 3, PTrace Commands. For example, the following command
directs PTrace to send its output to a file called PTRACE.DISPLAY.
?OUT TO PTRACE.DISPLAY
Recording Commands and Output in a File
To capture both the input commands and the corresponding output displays in a single
file, use the LOG command, described in Section 3, PTrace Commands.
Specifying a log file does not change either the input source or the output destination.
Instead, a copy of the commands and displays is sent to the specified file.
For example, the following LOG command creates a file called PTRACE.SESSION
that contains each input command followed by its corresponding output.
?LOG TO PTRACE.SESSION
Size of Output and Log Files
PTrace creates the files specified in the LOG and OUT commands with Primary and
Secondary extent sizes of 4 and 16 pages, respectively and a MAXEXTENTS value of
512. Once the file becomes full, the PTrace session is terminated.
Entering PTrace Commands
Entering commands in PTrace depends on what input source is specified.
•
If the input source is a terminal, PTrace waits for you to enter a command, followed
by a carriage return. No return is needed after pressing a function key to enter a
NEXT command.
•
If the input source is a disk file, PTrace reads the next record of the file.
•
If the input source is an application process, PTrace waits for the process to send
a request.
After the command has been received and processed, PTrace again displays its
prompt character for the next command.