|
VMS Help DEFRAGMENT, OFFLINE_VOLUME *Conan The Librarian |
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 containing the
INDEXF.SYS file to be defragmented.
| 2 - Restrictions |
o This command is only valid on a disk device that is not
mounted. If the device is mounted, an error occurs and the
process will abort. This command cannot work on the system
disk because it is always mounted.
o For a bound volume set, this utility only works on the "ROOT"
volume.
o For disk volumes in a shadow set (single member or otherwise),
the following restrictions apply:
o Do not specify the virtual unit name to defragment (for
example: DSAnnnn:).
o Specify only one physical device name (for example:
$1$DUAnnnn:).
o Use the following procedure to defragment INDEXF.SYS in a
shadow set:
1. Dismount both members of the shadow set.
2. Mount one of the physical disk volumes with
/OVERRIDE=SHADOW and then dismount it before doing the
defragmentation. If you do not do this, you will receive
the following error:
%SYSTEM-F-WRITLCK, write lock error
3. Defragment the INDEXF.SYS on the disk volume.
4. Mount the disk volume into the shadow set.
5. Add the disk volume that was not defragmented into the
shadow set. Mounting this disk volume causes a full copy
operation.
o If you experience a power failure during the
defragmentation of INDEXF.SYS, you may need to do the
following:
- Repair alternate index file header and index file bitmap
by doing a ANALYZE/DISK/REPAIR.
- Delete disk:[000000]DFG$DEFRAG_INDEXF.DAT.
| 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 OpenVMS User's 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
operation.
Mounting or dismounting the disks cannot be done
through the Command file specified.
3.3 - /INTERVAL
/INTERVAL={delta-time}
/NOINTERVAL (default)
The /INTERVAL qualifier executes a script 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 OpenVMS
User's 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.
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
operation starts.
Mounting or dismounting the disks cannot be done
through the Command file specified.
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 may 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 HP.)
o You should not end a script name with a hyphen,
since the hyphen is the DCL continuation
character.
| 4 - Examples |
The following examples illustrate how to use the OFFLINE_VOLUME
subcommand and its qualifiers.
1.$ DEFRAGMENT OFFLINE_VOLUME $1$DKB100:-
/SCRIPT=DEFRAG_OFFLINE_USER1-
/NOAFTER
$ DISMOUNT/CLUSTER $1$DKB100:
$ MOUNT/OVER=ID $1$DKB100:
$ ANALYZE/DISK_STRUCTURE $1$DKB100:
$ DISMOUNT $1$DKB100:
$ DEFRAGMENT START DEFRAG_OFFLINE_USER1
$ MOUNT/OVER=ID $1$DKB100:
$ ANALYZE/DISK_STRUCTURE $1$DKB100:
$ DISMOUNT $1$DKB100:
$ MOUNT/CLUSTER $1$DKB100: USER1
In this example, the following is performed:
1. Create script to defragment INDEXF.SYS on volume
2. Dismount volume from the cluster
3. Mount volume privately to analyze disk structure
4. Check volume for readability and validity of Files-11
structure information
5. Dismount volume to defragment INDEXF.SYS
6. Start OFFLINE_VOLUME script
7. Mount volume privately to analyze disk structure
8. Check volume for readability and validity of Files-11
structure information
9. Dismount volume
10. Mount volume into the cluster
|
|