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, or it 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 VMScluster 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. If a list of names is provided, 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 it is a volume, then you must use the /VOLUME qualifier
3 – Qualifiers
3.1 /ALL
/ALL
/NOALL (default)
The /ALL qualifier is used when showing 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 when showing
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 those scripts
that match the script name provided on the command
line and that target any devices named with this
qualifier.
3.4 /FILE_LIST
/FILE_LIST=(min_extents)
/FILE_LIST=(VOL_MAP_WINDOW + 1) (default)
The /FILE_LIST qualifier is used when showing 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 when showing 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 when showing 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 when showing 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
that match the script name provided on the command
line and that match any of the node specifications
provided with this qualifier.
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 when showing
the volume fragmentation state or when showing
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 when showing
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
/NOSTATISTICS (default)
The /STATISTICS qualifier is used when showing 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 examples show how to SHOW limits using 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.
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.
4.
$ 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.