DSAP Syntax
DSAP is a noninteractive, privileged program that runs online while the disk is operating. It can
generate reports for more than one disk volume during a single run.
The default output device is the home terminal, but you can specify other types of output devices,
such as a disk file or printer. When the output device is a terminal, the output width is 79 characters
(for most options), and output is not formatted into pages. When the output is to the spooler, output
width is 132 characters, and page length is 60. A header message prints at the top of each page
in the following format:
PAGE n DSAP--$volume ON \system--report-name--time
The syntax for the DSAP utility appears is:
[ \node.]DSAP [ / run-option [, run-option ] ... / ]
[ $volume-specification|HELP [ , options ] ...
node
is the name of a local or remote node (system) where the DSAP utility runs. If you want to run
DSAP on a remote node in a network, you must secure it for remote access on the remote node.
A remote password for
node
must exist for any user that is logged on to the local node where
DSAP RUN command is issued.
If
node
is not specified, DSAP runs on the local node where TACL is running (usually the node
where your terminal is connected).
run-option
is any option for the command interpreter RUN command. The two most common run-options
are:
IN filename
OUT listfile
The IN option specifies input files, and the OUT option specifies output files. These files usually
override the home terminal as the input or output device. An IN file is a text file that contains
the remainder of the command line, including parameters and options. For a complete list of
run options, see the description of the command interpreter RUN command in the TACL Reference
Manual. DSAP and DCOM ignores the IN option.
volume-specification
identifies the disk volumes to be analyzed. Any volume specified must reside on the node where
DSAP runs. DSAP creates a separate report for each volume specified. The reports are generated
in alphabetical order by volume name.
The
volume-specification
has the format:
$volume
for reports on a single volume.
($volume, $volume,...)
for reports on a list of volumes.
$* | *
for reports on all volumes.
If
volume-specification
matches more than one volume name, DSAP displays a list of
all the volumes it finds before producing the first report.
If you omit
volume-specification
, a brief description of DSAP and its options is displayed
(identical to the display shown if you specify HELP.
DSAP Syntax
91
