SNAX/HLS Diagnosis and Support Manual

Running the HLSTAP Program
Using SNAX/HLS Trace Analysis Program
104706 Tandem Computers Incorporated 2–3
Running the HLSTAP
Program
HLSTAP can be started using the command interpreter RUN command. HLSTAP
runs in either interactive mode or noninteractive mode.
In interactive mode, the HLSTAP IN file and OUT file are the same. By default,
this file is your terminal. HLSTAP also supports IN and OUT process files.
In noninteractive mode, the HLSTAP IN file and OUT file are different. The most
common use of noninteractive mode is to specify a file containing commands to
HLSTAP as the IN file and another file as the OUT file.
Assuming that the HLSTAP object file is accessible on the current search path, the
syntax of the command used to start HLSTAP is as follows:
HLSTAP [/ run-option-list /] [ command ] [; command ]...
run-option-list
is one or more of the standard run options described in the Tandem Advanced
Command Language (TACL) Reference Manual (Volume 1). Their syntax and
meanings are as follows:
IN file-name
specifies a file name designating a source for HLSTAP command input.
HLSTAP reads 132-byte records.
The default is the command interpreter’s input file.
OUT file-name
specifies a file name for output listings. HLSTAP writes output in up to
132-byte records.
The default is the command interpreter’s output file.
Other run options have the standard meanings. They include:
CPU cpu
PRI priority
NOWAIT
NAME process-name
SWAP file-name
TERM terminal-name
command
is an HLSTAP command to be executed once the HLSTAP process has started. If
commands are specified, HLSTAP suppresses the output of the banner and
terminates after the last command. In particular, the IN file is not used. If no
commands are specified, the banner line is printed and commands are read from
the IN file until the end-of-file indicator or the EXIT command is read.