These options allow you to perform the following tasks:
o Abort a Defrag process currently running
o Create defragmentation scripts by file specification or volume
name
o Delete scripts from the database
o Modify scripts
o Monitor defragmentation of a volume
o Schedule scripts for operation
o Show scripts and volume information
1 – Script Actions Selection
The DECwindows interface includes a feature that allows you to
take action on scripts appearing in any script selection window.
Select a script name from the script list, then press mouse
button 3. A pop-up menu appears, listing the actions.
Figure 1 Script Actions Pop-Up Menu
2 – Aborting a Script
Use this option to abort a script that is currently executing.
2.1 – Procedure for Aborting a Script
Use the following procedure to abort an active Defrag script:
1. Select the Abort option of the File pull-down menu.
2. Select the scripts from the Script List.
Point to any one or more of the scripts listed, clicking on
each one you want to abort.
3. Finish the abort action. Select:
o OK to abort the selected scripts and exit the Abort Script
option
o Apply to abort the selected scripts and remain in the Abort
Script option
o Cancel to leave the Abort Script option without taking any
action
4. You can also abort a script by double-clicking on a single
script entry.
3 – Creating a Script
The DECwindows interface provides you with the ability to create
a script and examine all its settings before committing it to
the Disk File Optimizer database. You have the option
of creating scripts to defragment specified files or creating
scripts to defragment all files on a specified volume.
When you select the pull-down menu option to create a volume
script, you must specify a volume. By default, the DECwindows
interface lists all mounted disk volumes. Select the volume for
which you want to create the script.
After you select the volume, the DECwindows interface presents
the script creation dialog box.
You have two options for creating the script:
o Inheriting script information from another script
o Scheduling the script
3.1 – Procedure for Creating a Script
The following procedure lists steps for creating a script.
Use this procedure for creating either a file or disk volume
defragmentation script:
1. Select the Create Script option of the File pull-down menu.
2. Select to create a file or volume script.
IF you want to create a file script, select the name of the
files you want to target for defragmentation from the file
list, and select OK.
IF you select to create a volume script, choose the disk
volume you want to target for defragmentation from the volume
selection list, and select OK.
3. Choose to apply the script settings of another script, or
create all new settings.
IF you want to create all new script settings, continue with
the next step.
IF you want to apply the script settings of another script,
use the Options pull-down menu Inherit option to bring up a
Script List, then select the script with the settings you
want.
4. Fill in the fields of the script creation dialog box.
5. Choose to schedule the newly created script.
IF you want to schedule the script, use the Options pull-down
menu Schedule option, or the Schedule Script button to bring
up the Scheduler dialog box.
6. Finish script creation. Select:
o Apply to complete the script
o OK to complete the script and leave the Create Script
option
o Cancel to quit and not create a new script
Table 1 Script Creation Dialog Box Fields
Field Description
Script The script name.
Name
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,
because the hyphen is the DCL continuation
character.
The VMS DCL Concepts Manual contains more information
on naming conventions.
File List The File List option will show the active file list
associated with the script.
Log File The Log File option 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 option
selections:
o The Full option lists all files analyzed by
the defragmentation process and reports their
disposition during each phase of defragmentation.
o The Brief option lists only the statistics of each
phase, such as number of files analyzed and number
of files defragmented.
Dormant The Dormant Files option indicates files to be
Files considered dormant when final file placement decisions
are made. Dormant files are placed on the volume to
allow placing other files in optimum disk locations.
In general, they are placed further away from the ODS-
2 data structures than Frequent files and files not
classified in any manner.
If a file is indicated in both the DORMANT and
FREQUENT lists, it is considered dormant.
If a file is indicated in both the EXCLUDE and DORMANT
lists, it is excluded.
NOTE
<REFERENCE>(PLACEMENT_NOTE)
<REFERENCE>(WILDCARDS_ALLOWED)
Exclude The Exclude Files option specifies files to be
Files excluded from processing. The defragmentation process
ignores files matching the listed file specifications.
Any file indicated in the EXCLUDE list and in either
the FREQUENT or DORMANT lists is excluded from
processing.
<REFERENCE>(WILDCARDS_ALLOWED)
The defragmentation process always excludes system
files, open files, files excluded in an options file,
and files excluded using the Ignore option.
Frequent The Frequent Files option indicates files to be
Files considered frequently accessed when final file
placement decisions are made. Frequent files are
placed to optimize access speed.
If a file is indicated in both the FREQUENT and
DORMANT lists, it is considered dormant.
If a file is indicated in both the FREQUENT and
EXCLUDE lists, it is excluded.
NOTE
<REFERENCE>(PLACEMENT_NOTE)
<REFERENCE>(WILDCARDS_ALLOWED)
Options The Options File option provides an alternate method
File for associating files with the Dormant File, Exclude
File, or Frequent File options. If the list of files
for any of these options is large, you can create a
separate file that contains this information.
Each record of the options file consists of a file
name followed by one of these keywords:
o /EXCLUDE-File to be excluded
o /FREQUENT-File to be considered frequently accessed
o /DORMANT-File to be considered dormant
The following example shows the contents of an options
file called MYOPTFILE.OPT. This file specifies that
all files on the target device called FILE1.EXE are
frequent files, all files in the [ARCHIVE] directory
are to be excluded, and all files in the [OLDSTUFF]
directory and its subdirectories are dormant.
FILE1.EXE/FREQUENT
[ARCHIVE]*.*;*/EXCLUDE
[OLDSTUFF...]*.*;*/DORMANT
Prologue The Prologue File option identifies a DCL command file
File that Defrag executes just before the DEFRAGMENT FILE
operation starts.
Epilogue The Epilogue File option identifies a DCL command file
File that Defrag executes upon completion of the DEFRAGMENT
FILE operation.
Ignore The Ignore option requests that the defragmentation
process ignore certain types of files.
The following list explains the options:
o Selecting the Indexed button-Ignores all RMS
indexed files
o Turning off the Indexed button-May defragment RMS
indexed files
o Selecting the Placed button-Ignores all files with
explicit placement flags set in their headers
o Turning off the Placed button-May defragment files
with explicit placement flags
Files indicated by the Ignore option are added to the
EXCLUDE list.
The default value (Ignore option and Placed buttons
selected) indicates that files with explicit placement
control should be ignored, and that RMS indexed files
should be defragmented and placed in appropriate
locations on the volume.
Level The defragmentation process selects files for
defragmentation (from among those not excluded)
based on the Level option. Once a file is selected
as a candidate, the defragmentation process attempts
to fully defragment that file (make it 100 percent
contiguous). Specify the level number as an integer
ranging from one to five:
o Level 1-Any file that is not 100 percent
contiguous, or can be selected using levels two
through four, is a candidate for defragmentation.
o Level 2-Any file whose extents cannot be completely
mapped by the mapping window, or that can be
selected using levels three or four, is a candidate
for defragmentation.
The default window value is seven and can be set
for a given volume using the following command:
$ SET VOLUME {device-spec}/WINDOWS=[n]
o Level 3-Any file with retrieval pointers in more
than one file header, or that can be selected using
level four, is a candidate for defragmentation.
o Level 4-The defragmentation process for level 4
processing performs only free space consolidation.
This level is used in conjunction with the
Consolidate Freespace option.
o Level 5-This level requests a volume analysis only;
no defragmentation occurs. The statistical results
are available in the log file, which is required
when Level 5 is selected (see the Log option). If
level five is selected, the level 2 candidate file
specifications are listed in the full log file.
ConsolidateThe Consolidate Freespace qualifier tells the
Disk File Optimizer to use its free space
Freespace consolidation algorithm.
Hotfile The Hotfile option causes the defragmenter to query
the appropriate hotfile database and append the list
of hotfiles to the defragmenter's frequent file list.
Mail The Mail option requests that brief status and
termination messages regarding defragmentation
processes be mailed to the distribution list provided
in the DFG$MAIL_ADDRESS file.
OpCom The OpCom option requests that brief status and
termination messages regarding defragmentation
processes be sent to OPCOM.
Write The Write Check option requests that a read-after-
Check write check be performed on all defragmented or
placed files. This qualifier significantly extends
the execution time of a defragmentation process.
Schedule The Schedule Script option schedules the script for
Script operation.
Figure 2 Schedule Definition
Table 2 Schedule Definition Dialog Box Fields
Field Description
Script Identifies the name of the script to be scheduled.
Name:
PredecessorNames the script that will run before the current
script will be executed. The script must exist in
the database. A selection list is displayed when this
button is selected.
Interval: Specifies the delta time expressing the interval at
which the script will be executed.
Time Specifies the delta time expressing the maximum
Limit: elapsed time for a given defragmentation operation.
Node Limits the defragmentation to only those nodes listed.
List: A selection list is displayed when this button is
selected.
Continuous Causes the script to run continuously. When selected,
the defragmentation script used for the process must
be aborted or canceled when no longer needed.
Cancel Cancels the next scheduled execution of the script.
Start Starts execution of the script immediately.
Start Starts execution of the script after the specified
/After time.
4 – Deleting a Script
This option allows you to delete scripts from the database.
4.1 – Procedure for Deleting a Script
Use the following procedure to delete a script:
1. Select the Delete Script option of the File pull-down menu.
2. Select the scripts from the Script List.
Point to any one or more of the scripts listed, clicking on
each one you want to delete.
3. Finish the delete action. Select:
o OK to delete the selected script and exit the Delete Script
option
o Apply to delete the selected scripts and remain in the
Delete Script option
o Cancel to leave the Delete Script option without taking any
action
5 – Modifying a Script
This section describes how to modify existing scripts.
5.1 – Procedure for Modifying a Script
Use the following procedure to modify a script:
1. Select the Modify Script option of the File pull-down menu.
2. Select the script from the Script List.
Point to any one of the scripts listed, clicking on the one
you want to modify.
3. Select the OK option at the bottom of the Script List.
4. Modify any of the script fields you need to. The fields are
the same as those in the script creation dialog box.
5. Leave the script Modify dialog box. Select:
o OK to apply the modifications made and leave the dialog box
o Apply to apply the modification made and return to make
more modifications
o Cancel to quit and not retain any of the modifications
made
6 – Monitoring Allocated Space on a Disk Volume
This section describes how to monitor defragmentation on a disk
volume.
When selecting the Monitor option, Defrag software displays three
windows:
o A process statistics window showing process information for
the defragmentation process running on the named volume or
script.
o A process activities window showing the file defragmentation
activities on the volume.
o A monitor map window illustrating free space and allocated
space on the volume.
6.1 – Procedure for Monitoring Allocated Space
Use the following procedure to monitor the allocated space on a
disk volume:
1. Select the Monitor option of the File pull-down menu.
2. Select the means by which you want to monitor allocated space.
IF you want to identify the volume by a script, select the
Script option, then select the script name from the Script
List. IF you want to identify the volume by name, select the
Volume option, then select the volume name from the Volume
List.
3. To view the entire volume map, use the arrows and scroll bars
around the map on the Defragmentation Volume Map window.
4. To view more detailed information about the allocated space
shown on the Defragmentation Volume Map, press mouse button
1 and drag the cursor over the area of the map you want to
examine. A pop-up window identifies the files taking space on
that area of the volume.
Volume Map File Information shows the files occupying the space
shown in the volume map viewport.
Figure 3 Volume Map File Information
7 – Scheduling a Script
This section describes how to schedule a Defrag script. Script
Scheduling Actions describes the options for scheduling scripts.
Table 3 Script Scheduling Actions
Option Description
Script Name of script for scheduling action.
Name
Cancel Cancels the next scheduled execution of the specified
script. Normal scheduling resumes after the next
scheduled execution.
Disable This option disables the script from execution.
Enable This option enables a previously disabled script. Once
enabled, the script operates normally.
Start Starts execution of the script identified.
Start Starts execution of the script when the specified
/After time is reached. Enter the time in the field below the
option.
7.1 – Procedure for Managing Script Schedules
Use the following procedure to schedule scripts and manage script
schedules:
1. Select the Schedule Script option of the File pull-down menu.
2. Select the script you want for scheduling actions from the
Script list.
3. Take any of the actions on the script outlined in Script
Scheduling Actions.
4. Finish the scheduling action. Select:
o OK to apply the modifications and leave the dialog box.
o Apply to apply the scheduling options selected. You may
take action on another script by entering the name of the
script in the Script Name field.
o Cancel to quit and not take any scheduling actions on the
named script.
8 – Showing a Script
The Show dialog box provides three ways of sorting the scripts
you would like to show:
o Scripts that apply to specific nodes, either exclusively or
shared by other nodes
o Scripts that apply to specific disk volumes
o All scripts in the database
You also have the option of creating an output file for selected
scripts.
8.1 – Procedure for Showing Scripts
Use the following procedure to show scripts:
1. Select the Show option of the File pull-down menu, and then
select Script.
2. Choose if you want screen output.
IF you select the Output File option, enter the name of the
output file you want to create.
IF you do not select the output file option, your output is
visible only while using this option.
3. If you want to sort scripts by volume, proceed with Step 4,
otherwise, continue to show scripts by node.
Select to limit the scripts to show by clicking on the Limited
option.
IF you select the Limited option, you limit the candidate list
of scripts to those that apply ONLY to the selected node.
IF you do not select the Limited option, the list of scripts
includes all those that run on the node as well as other
nodes.
Select the script in the Node field, and the script name
becomes highlighted in the Scripts field.
Proceed with Step 5.
4. To show the scripts that apply to a volume, select the volume.
Scripts that apply to the volume are listed in the Scripts
field.
Select the script in the Volume field, and the script name
becomes highlighted in the Scripts field.
5. To show a script, double click on the script name in the
Scripts field. The contents of the script appear in the field
under the script name.
To show additional scripts, select their name. This feature
allows you to show more than one script at a time.
6. Finish the show script operation. Select:
o OK to produce the output file named in the Output File
field
o Apply to leave the Show Script dialog box and optionally
produce the output file named in the Output File field
o Cancel to quit and not produce any further output
9 – Showing the State of a Volume
This option allows you to review the current state of disk
volumes to determine if defragmentation is needed.
Table 4 Show Volume Option and Field Descriptions
Field Description
Free List The Free List option is used when showing the
fragmentation state of the volume. It lists the
location and size of all the free space extents on
the volume.
Histogram The Histogram option 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 free space extents (holes) against
the size of these free space extents. It provides
information about how many free space extents are on
the volume and their sizes.
Statistics The Statistics option is used when showing the volume
fragmentation state. It provides a summary of the file
and free space fragmentation for the volume.
File List The File List option 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.
Use the field to specify the files for which you want
to show the window mapping.
Location The Location option shows the extents (fragments)
associated with all files specified in the field
next to this option. If no files are specified, the
Location option appends location information to all
files listed with File List option. The supplied file-
spec may contain wildcards in place of the directory,
file name, extension, or version fields.
Output The Output File option may be used when showing the
File 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.
9.1 – Procedure for Showing Volumes
Use the following procedure to show volume information:
1. Select the Show option of the File pull-down menu, and then
select Volume.
The Show Volume options dialog box appears
2. Select any of the disk volumes from list at the top of the
Show Volume options dialog box.
3. Select any of the options for showing volume information. Show
Volume Option and Field Descriptions describes the options.
4. Finish the show volume operation. Select:
o OK to show the volume report and optionally create the
output file you named in the Output File field. The Show
Volume options dialog box disappears.
o Apply to show the volume report and optionally create the
output file you named in the Output File field. The Show
Volume options dialog box remains.
o Cancel to leave the Show Volume option.
10 – Options Menu
This pull-down menu option allows you to set and show these
Disk File Optimizer process parameters:
o I/O limit
o Process limit
o CPU usage
11 – Setting Parameters
This option allows you to set the defragmentation process
parameters for the defragmentation processes on the nodes in
your system. These parameters define how much of your computing
resources you want to dedicate to the defragmentation process.
Set Parameters Dialog Box describes the fields and buttons of the
Set Parameters dialog box.
Table 5 Set Parameters Dialog Box
Field Description
CPU: Enter into this field the percentage of CPU usage for
any one defragmentation process. The CPU percent is
the percent of a single CPU.
IO: Enter into this field the maximum direct I/O rate (per
second) of any one defragmentation process.
MAX PROC: Enter into this field the maximum number of
defragmentation processes per node.
Include All Nodes button to select all nodes on the system.
in list:
Only those in DB to select only nodes which have
process parameter settings.
Node list This list presents all nodes in the VMScluster system
from which you select nodes to change Defrag process
parameters.
11.1 – Procedure for Setting Parameters
Use the following procedure to set Defrag PLUS process
parameters:
1. Select the Options pull-down menu option Parameters, then
select Set.
2. Select the node from the node list.
3. Enter the process parameters:
o CPU
o IO
o MAX PROC
4. Select the node on which the Defrag process to be changed
runs.
IF you are setting process parameters for a node not
previously addressed, use the All Nodes option to include
nodes on the list.
IF you are setting process parameters for a node in the
database, you can use either option to include nodes on the
list.
5. Exit the Set Parameters option by selecting the Cancel button.
11.2 – Procedure for Removing Nodes
Removing a node from the database has the effect of unrestricting
defragmentation processes with the process parameters. Use the
following procedure to remove a node:
1. Select the Options pull-down menu option Parameters, then
select Set.
2. Set the list to include only those nodes in the database by
selecting the Only those in DB option.
3. Select the node which is to be removed from the database.
4. Exit the Set Parameters option by selecting the Cancel button.
12 – Showing Defrag Process Parameters
This option allows you to show the defragmentation process
parameters in effect on all nodes in the VMScluster system. You
also have the capability to produce and output file reporting
this information.
12.1 – Procedure for Showing Parameters
Use the following procedure to show Defrag process parameters:
1. Select the Options pull-down menu option Parameters, then
select Show.
2. Select to produce an output file.
IF you do not want an output file, proceed with Step 3.
IF you want an output file, select the Output File option, and
enter the file name.
3. Finish the Show Parameters option. Select:
o OK to leave the Show Parameters dialog box, and optionally
produce the output file.
o Apply to produce and output file. The dialog box remains so
you can produce additional output files.
o Cancel to leave the Show Parameters option.