|
VMS Help DEFRAGMENT, SHOW *Conan The Librarian |
The SHOW subcommand displays information about the fragmentation
state of the given volume and information from the scheduling
database.
Format
DEFRAGMENT SHOW { script-name|volume-name } [ /QUALIFIERS ]
| 1 - Parameters |
script-name|volume-name
The parameter for the SHOW subcommand is either a script name
or a volume name. Names can be omitted if the /ALL qualifier
is used. If a script name is supplied or if the /PARAMETERS
qualifier is specified, the SHOW command queries the scheduling
database and displays this information. You can use wildcards in
the script-name specification. Use an asterisk (*) to take action
on all scripts on the VAXcluster system; use a percent sign (%)
to match a single character in the script-name specification.
If a volume name is supplied (/VOLUME required), the SHOW
command displays information about the fragmentation state of
the specified volume. A list of names can be provided, but the
list cannot contain both script and volume names.
| 2 - Restrictions |
o If showing a script or volume, do not use the /ALL qualifier
o If showing a volume, then you must use the /VOLUME qualifier
| 3 - Qualifiers |
3.1 - /ALL
/ALL
/NOALL (default)
The /ALL qualifier is used to show information from
the scheduling database. It displays information
about all scripts and parameters in the scheduling
database. If /ALL is used, the script-name parameter
is not allowed.
3.2 - /COMMAND_LINE
/COMMAND_LINE
/NOCOMMAND_LINE (default)
The /COMMAND_LINE qualifier is used to show
information from the scheduling database. It
formats the output of the SHOW subcommand as a valid
DEFRAGMENT command line. Thus, all the data in the
scheduling database can be extracted into a file (
/ALL/COMMAND_LINE/OUTPUT=file.ext).
3.3 - /DEVICE
/DEVICE=(device_spec[,device_spec])...
The /DEVICE qualifier selects only the named scripts
on the specified devices.
3.4 - /FILE_LIST
/FILE_LIST=(min_extents)
/FILE_LIST=(VOL_MAP_WINDOW + 1) (default)
The /FILE_LIST qualifier is used to show the
fragmentation state of a volume. It lists all files
on the volume that have min_extents or more extents
(fragments). By default, the number of file window
mapping pointers set for the volume (INITIALIZE
{volume}/WINDOW=n) plus one is used. This value lists
all files that require at least one window turn to
completely map.
3.5 - /FREE_LIST
/FREE_LIST
/NOFREE_LIST (default)
The /FREE_LIST qualifier is used to show the
fragmentation state of the volume. It lists the
location and size of all of the freespace extents
on the volume.
3.6 - /HISTOGRAM
/HISTOGRAM
/NOHISTOGRAM (default)
The /HISTOGRAM qualifier is used to show the
fragmentation state of a volume. It generates two
histograms. The first plots the number of files
against the number of extents per file and provides
information about how many files are fragmented and
how badly they are fragmented. The second histogram
plots the number of freespace extents (holes) against
the size of these freespace extents. It provides
information about how many freespace extents are on
the volume and their sizes.
3.7 - /LOCATION
/LOCATION=(file-spec[,...])
/NOLOCATION
The /LOCATION qualifier is used to show the
fragmentation state of the volume. It prints the
extents (fragments) associated with all specified
files. If no files are specified, the /LOCATION
qualifier appends location information to all files
listed with the /FILE_LIST qualifier. The supplied
file-spec may contain wildcards in place of the
directory, file name, extension, or version fields.
3.8 - /NAMES
/NAMES
The /NAMES qualifier lists only the first line of
the usual show output. The first line of the script
includes the name of the script, whether the script
is enabled or disabled, and the target device for the
script.
3.9 - /NODE
/NODE=(node-name[,...])
/NONODE (default)
The /NODE qualifier selects only those scripts and
node names that are specified on the command line.
When used with the /PARAMETERS qualifier, the /NODE
qualifier displays CPU_LIMIT, IO_LIMIT, and PROCESS_
LIMIT information for specified nodes only. If
the /NODE qualifier is not used, the /PARAMETERS
qualifier displays this information for all nodes in
the scheduling database.
3.10 - /OUTPUT
/OUTPUT={file-spec}
/OUTPUT=SYS$OUTPUT (default)
The /OUTPUT qualifier may be used to show the volume
fragmentation state or to show information from the
scheduling database. It directs the output of the
SHOW subcommand to a file. By default, output is
directed to SYS$OUTPUT.
3.11 - /PARAMETERS
/PARAMETERS
/NOPARAMETERS (default)
The /PARAMETERS qualifier is used to show information
from the scheduling database. It displays the CPU_
LIMIT, IO_LIMIT, and PROCESS_LIMIT settings for all
nodes in the scheduling database (unless specific
nodes are designated with the /NODE qualifier). By
default, these settings are not shown.
3.12 - /RUNNING
/RUNNING
The /RUNNING qualifier shows scripts that are
currently running.
3.13 - /STATISTICS
/STATISTICS (default)
/NOSTATISTICS
The /STATISTICS qualifier is used to show the volume
fragmentation state. It provides a summary of the
file and free space fragmentation for the volume.
3.14 - /VOLUME
/VOLUME
/NOVOLUME (default)
The /VOLUME qualifier must be used to show the
fragmentation state of a volume. It indicates that
any parameter supplied on the command line is a
volume name instead of a script name. The /VOLUME
qualifier is incompatible with any of the qualifiers
used to show database information except the /OUTPUT
qualifier.
| 4 - Examples |
The following are examples of the SHOW subcommand and its
qualifiers:
1.$ DEFRAGMENT SHOW/PARAMETERS
In this example, the current values of CPU_LIMIT, IO_LIMIT
and PROCESS_LIMIT for all nodes in the scheduling database are
shown.
2.$ DEFRAGMENT SHOW MY_SCRIPT/OUTPUT=OUTPUT.TXT
In this example, information associated with MY_SCRIPT is
displayed. No parameter information is displayed. Output is
directed to a file called OUTPUT.TXT.
NOTE
If output is directed to a filename without extension, the
file is given a default extension of .lis.
3. $ DEFRAGMENT SHOW MY_SCRIPT/COMMAND_LINE/PARAMETERS
In this example, information associated with MY_SCRIPT is
displayed. The current values of CPU_LIMIT, IO_LIMIT and
PROCESS_LIMIT for all nodes in the scheduling database are also
shown. The format for the information is a valid DEFRAGMENT
command line. Output is directed to the user's SYS$OUTPUT
device. If output is directed to a filename without extension,
the file is given a default extension of .lis.
4.$ DEFRAGMENT SHOW MY_VOLUME/OUTPUT=OUTPUT.TXT
In this example, information associated with MY_VOLUME is
displayed. Output is directed to a file called OUTPUT.TXT.
5.$ DEFRAGMENT SHOW DISK$ONE/VOLUME/HISTOGRAM
In this example, the volume fragmentation report includes the
summary statistics (/STATISTICS is default) and histograms for
both file fragmentation and freespace fragmentation. The report
is sent to the SYS$OUTPUT device.
|
|