1 File_Options 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 2 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. 3 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. 2 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 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 (PLACEMENT_NOTE) (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. (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 (PLACEMENT_NOTE) (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. 2 Deleting_a_Script This option allows you to delete scripts from the database. 3 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 2 Modifying_a_Script This section describes how to modify existing scripts. 3 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 2 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. 3 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 2 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. 3 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. 2 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. 3 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 2 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. 3 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. 2 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 2 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. 3 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. 3 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. 2 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. 3 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.