The DEFRAGMENT OFFLINE_VOLUME command defragments the INDEXF.SYS
file on the offline volume given as a parameter to the command
line according to the defragment command line qualifiers.
Format
DEFRAGMENT OFFLINE_VOLUME { volume-name } [ /QUALIFIERS ]
[ /QUALIFIERS ])
1 – Parameters
volume-name
The volume-name is the name of the volume that is to have the
INDEXF.SYS file defragmented.
2 – Restrictions
o This command is only valid on a disk device that is not
mounted. If the device is mounted an error will occur and
the process will abort.
o For a bound volume set, this utility only works on the "ROOT"
volume.
3 – Qualifiers
3.1 /AFTER
/AFTER={time}
/AFTER={current_time} (default)
/NOAFTER
The /AFTER qualifier keeps the script from executing
until after the specified time.
You can specify time as either an absolute time or
as a combination of absolute and delta times. For
complete information on specifying time values, see
the VMS DCL Concepts Manual.
The /AFTER qualifier has three states. It can be
specified with a valid time, it can be omitted from
the command line, or it can be negated (/NOAFTER). If
/AFTER is specified with a valid time, the script is
scheduled to execute after that time. If the /AFTER
qualifier is omitted, the defragmentation software
processes the command as if the /AFTER qualifier
were specified with the current time. If /NOAFTER
is specified, no starting time is associated with
the script being defined. The /NOAFTER qualifier
allows you to define a script without scheduling it
to execute. To subsequently start the script, use the
START subcommand.
3.2 /EPILOGUE
/EPILOGUE={file-name}
/NOEPILOGUE (default)
The /EPILOGUE qualifier identifies a DCL command file
which DFO executes upon completion of the DEFRAGMENT
VOLUME operation.
3.3 /INTERVAL
/INTERVAL={delta-time}
/NOINTERVAL (default)
Causes a script to execute at regularly scheduled
intervals. The /INTERVAL qualifier specifies the
minimum time between two consecutive executions of a
script.
Specify time as a delta time. Refer to the VMS DCL
Concepts Manual for more information on specifying
times. If you do not specify a time with the
/INTERVAL qualifier, a default value of 1 day is
used. This value causes the associated script to run
every 24 hours.
If you specify the /AFTER qualifier with the
/INTERVAL qualifier, the first defragmentation
operation occurs at or after the time specified
by the /AFTER qualifier; all subsequent operations
execute at intervals set according to the /INTERVAL
qualifier.
3.4 /LOG
/LOG={file-spec}
/NOLOG (default)
The /LOG qualifier causes the defragmentation process
to create a file containing a list of all its
operations. The information in the log file varies
with the presence of the /FULL or /BRIEF qualifiers.
The /FULL qualifier lists all files analyzed by the
defragmentation process and reports their disposition
during each phase of defragmentation. The /BRIEF
qualifier lists only the statistics of each phase,
such as number of files analyzed, and number of files
defragmented.
3.5 /MAIL_NOTIFICATION
/MAIL_NOTIFICATION
/NOMAIL_NOTIFICATION (default)
The /MAIL_NOTIFICATION qualifier requests that
brief status and termination messages regarding
defragmentation processes be mailed to the mail
distribution list provided in the file DFG$MAIL_
ADDRESS.
3.6 /NODE
/NODE=(node-name[,...])
/NONODE (default)
The /NODE qualifier limits the scope of the
DEFRAGMENT command to the node or set of nodes
specified by /NODE=(node-name). By default,
defragmentation processes may execute on any LMF
licensed node in the system.
3.7 /OPCOM_NOTIFICATION
/OPCOM_NOTIFICATION (default)
/NOOPCOM_NOTIFICATION
The /OPCOM_NOTIFICATION qualifier requests that
brief status and termination messages regarding
defragmentation processes be sent to OPCOM.
3.8 /PROLOGUE
/PROLOGUE={file-name}
/NOPROLOGUE (default)
The /PROLOGUE qualifier identifies a DCL command file
which DFO executes just before the DEFRAGMENT FILE
operation starts.
3.9 /SCRIPT
/SCRIPT={script-name}
/NOSCRIPT (default)
The /SCRIPT qualifier assigns a user-supplied name
to a script. If a duplicate script-name is selected,
defragmentation software issues a duplicate script
name error message and does not enter the new script
into the database-no defragmentation takes place.
A script name may be up to 64 characters in length
and may contain any of the following characters:
o Any alphanumeric character
o Underscore ( _ )
o Hyphen ( - )
o Dollar sign ( $ )
Observe the following rules when naming a script:
o You can use any combination of uppercase and
lowercase letters.
o You cannot begin script names using the dollar
sign, but you can include the dollar sign within
the script name. (The dollar sign is reserved for
special use by Digital Equipment Corporation.)
o You should not end a script name with a hyphen,
since the hyphen is the DCL continuation
character.
The VMS DCL Concepts Manual contains more information
on naming conventions.