Guardian Disk and Tape Utilities Reference

DSAP measures disk space and has no effect on the system, so restricting its use is often unnecessary.
However, it might not be preferable in some environments to permit general access to some of the
reports generated by DSAP.
To set the appropriate level of access to DSAP and all other system utilities, see the security policy
standards established by your organization. For a complete discussion about securing information
on a NonStop system, see the Security Management Guide.
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.
DSAP Syntax 91