Home

Disk File Optimizer for OpenVMS Guide to Operations

1. In the Script Define dialog box for a volume index file you can Select a disk Select whether to notify you by log file console message or mail message or by all three Select whether to report brief or full log files Select whether to inherit the properties of another script The DECwindows Interface for Defrag Plus 6 9 The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 1 Define Dialog Box Fields Field Description Script A name for the script Name If you give a duplicate script name Disk File Optimizer issues the duplicate script name error message and does not enter the new script into the database no defragmentation takes place A script name can be up to 64 characters in length and can contain any of the following characters e Any alphanumeric character e Underscoee e Hyphen Dollar sign Observe the following rules when naming a script e Use any combination of uppercase and lowercase letters e Do not begin script names using the dollar sign however you can include the dollar sign within the script name The dollar sign is reserved for special use by Compaq Computer Corporation e Donot end a script name with a hyphen because the hyphen is the DCL continuation character e f you dont enter a script name the defragmentation process will assign a default script name DF G SCRIPTxxx where x is a hexidecimal character between 0 and F This defaul
2. DEFRAGMENT FILE SYSSLOGIN LOGIN COM 2 EXCLUDE OLD This command defragments the user s LOGIN COM file and excludes all files with a OLD extension DEFRAGMENT FILE INHERIT OTHER FILE SCRIPT NOAFTER This commands creates a file script identical to the OTHER FILE SCRIPT and allows the Disk File Optimizer to name it DF G XXX DEFRAGMENT FILE SYSSSYSTEM 000000 RDB INHERIT X SCRIPT Y This command creates a script called Y Other script characteristics such as log file are inherited from script X Using Defrag PLUS 4 31 DEFRAGMENT HELP DEFRAGMENT HELP The HELP subcommand invokes VMS Help for the Disk File Optimizer utility Format DEFRAGMENT HELP Parameters None Description The HELP subcommand invokes VMS HELP for the Disk File Optimizer HELP only provides information on the version of the Disk File Optimizer installed on your system Defrag or Defrag PLUS You can also access HELP for the Disk File Optimizer directly from DCL by entering one of these commands HELP DEFRAGMENT or DEFRAGMENT HELP Restrictions None Qualifiers None Examples The following examples show the various ways you can access HELP for the Disk File Optimizer utility 1 DEFRAGMENT HELP This command invokes HELP for the Disk File Optimizer utility directly from DCL 2 HELP DEFRAGMENT This command invokes HELP for the Disk File Optimizer utility directly from DCL 3 DFO HELP This command
3. 0000 cect ete ee DEFRAGMENT ABORT DEFRAGMENT ATTACH DEFRAGMENT CANCEL DEFRAGMENT DISABLE DEFRAGMENT ENABLE DEFRAGMENT EXIT DEFRAGMENT FILE DEFRAGMENT HELP DEFRAGMENT MODIFY DEFRAGMENT MONITOR wise cache eine ele eae ee Wee yk ewe ees DEFRAGMENT OFFLINE VOLUME i ss asic ainean cece eee eee DEFRAGMENT REMOVE DEFRAGMENT SET DEFRAGMENT SHOW DEFRAGMENT SPAWN DEFRAGMENT START DEFRAGMENT VOLUME 4 1 4 1 4 1 4 2 4 2 4 2 4 2 4 3 4 3 4 4 4 4 4 4 4 4 4 5 4 5 4 6 4 6 4 6 4 7 4 7 4 8 4 8 4 9 4 9 4 10 4 10 4 11 4 11 4 12 4 13 4 14 4 16 4 18 4 19 4 20 4 21 4 22 4 32 4 33 4 42 4 48 4 54 4 56 4 58 4 63 4 65 4 66 5 The DECwindows Interface for Defrag 5 1 Introduction siae eee eee ea de Bead REP Enn 5 2 FIleMenlcs zur in ody pu aia RM RR Rae art em ae baie M Erde 5 3 Optimize M enu s a imis bere qoe e Siete hee we oboe Ue LER e e ei aes 5 3 1 Optimize Volume ss igs naha h rh 5 3 1 1 Define the Optimize Parameters 000 cece eee 5 3 1 2 Restrict Special Files llle 5 3 1 3 Schedule Optimization lees 5 3 2 Optimize Selected Files cee 5 3 3 Optimize Volume Index File 2 eee 5 3 4 Abort an Optimize Process ilie 5 4 Monitor a Vol me scu tea de heard Pad gad de ee RR E ex ER end 5 4 1 Defragmentation Process Statistics Window s 5 4 2 Full Volume Window esee en 5 4 3 Pa
4. DEFRAGMENT ATTACH Format Parameters Description Restrictions Qualifiers The ATTACH subcommand transfers control from the current process which then hibernates to the specified process DEFRAGMENT ATTACH process name IDENTIFICATION pid process name The process name specifies the name of a process to which control transfers The process must already exist be part of your current job and share the same input stream as your current process However the process cannot be your current process or a subprocess created with the NOWAIT qualifier Process names can contain from 1 to 15 alphanumeric characters If a connection to the specified process cannot be made an error message is displayed The ATTACH command allows you to connect your input stream to another process You can use the ATTACH command to change control from one subprocess to another subprocess or to the parent process When you enter the ATTACH command the parent or source process is put into hibernation and your input stream is connected to the specified destination process You can use the ATTACH command to connect to a subprocess that is part of a current job left hibernating as a result of the DCL SPAWN WAIT command or another ATTACH command as long as the connection is valid No connection can be made to the current process to a process that is not part of the current job or to a process that does not exist If any of these connections
5. Files Processed Dormant Count Exclude Count Frequent Count Dormant Files Placed Frequent Files Placed Free Space Extent Count Free Space Extent countdown Current File Table 6 6 Defragmentation Process Statistics Window Description Field Description Process Id The defragmentation process ID number Process The defragmentation process name Date The current date and time Script Name The name of the script being monitored The 6 30 The DECwindows Interface for Defrag Plus field applies to the Defrag PLUS variant only continued on next page The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume Table 6 6 Cont Defragmentation Process Statistics Window Description Field Description Operating On The node on which the defragmentation process is operating Current Status The status of the defragmentation process Phase The current defragmentation process phase Elapsed Time The elapsed time since the start of the defragmentation process Buffered I O The buffered I O count and rate of the Count defragmentation process and Rate Direct I O The direct I O count and rate of the Count defragmentation process and Rate CPU Utilization Time and Usage The CPU utilization time and usage of the defragmentation process Page Fault Count and Rate The page fault
6. QUALIFIERS DEFRAGMENT SET parameter valuef N ODE a nodel DEFRAGMENT SHOW Script namef volume namef QUALIFIERS DEFRAGMENT SPAWN command Defrag PLUS Both Both Defrag PLUS Defrag PLUS Both Both 1 4 Overview of the Disk File Optimizer Allows the user to modify an existing script This command supersedes use of the INHERIT qualifier for modifying scripts Invokes the defragmentation monitor which monitors an ongoing defragmentation process For Defrag the input parameter must be a volume name For Defrag PLUS the input parameter can be either a script or a volume name depending on the setting of the VOLUME qualifier Defragments INDE XF SYS on the specified volume according to the selected command line qualifiers Removes the specified script from the scheduling and parameter database Sets the specified parameters CPU LIMIT IO LIMIT PROCESS LIMIT tothe values specified Shows the contents of the scheduling and parameter database Defrag PLUS or the fragmentation state of the supplied volumes Creates a subprocess and either transfers control to the subprocess or executes a DCL command from within the subprocess continued on next page Table 1 2 Cont Overview of the Disk File Optimizer 1 2 Product Description Disk File Optimizer Command Summary Command Variant Description DEFRAGMENT START Defrag PLUS Starts th
7. 0 0 ee 6 7 1 1 The Set Process Limits Procedure 00 cece eees 6 7 1 2 Procedure for Removing Nodes 00 eee 6 7 2 Showing Defragmentation Process Limits Procedure PPPPPP NON OOMD 6 44 6 46 6 46 Programmer s Guide 7 Callable Interface 7 1 Introduction i i ee RR eee eee eee eee ee es 7 1 7 2 Using the Callable Interface 0 0 0 2 es 7 1 7 2 1 Including Files for DFG DEFRAGMENT and DFG RELEASE MEMORY 000 nen 7 1 7 2 2 Linking Files with DFG DEFRAGMENT and DFG RELEASE MEMORY 0 00 en 7 1 7 3 DFG DEFRAGMENT Routine lle 7 2 DFG DEFRAGMENT uie Rm REL e ee eee bale ee Ga 7 3 7 4 DFG RELEASE MEMORY Routine llle 7 38 DFG RELEASE MEMORY 0000 n 7 39 A Answers to Frequently Asked Questions B Disk File Optimizer Logicals and Files B 1 Files Added to System by the Disk File Optimizer B 1 B 2 Logical n rrr B 2 C DEFRAGMENT SHOW Command Report C 1 Introd ctlon 4 44 4 4 44 eet Re dead e a ra od Riz P RR E C 1 C 2 Output from the SHOW Command cee eee ee ees C 2 C 3 Examples of the Output from the SHOW Command C 4 C 3 1 System Volume cu ce y cabo ete pues dex Y nate wate C 5 C 3 2 User Volume With System Log Files 0 00 eee C 8 C 3 3 User VOllUETIG a ood draco ce ed lm Da bd mee wee ded C 13 C 4 Calculation of Fragmentation Index
8. 1 File evaluation Determines which files should be defragmented and which files are dormant frequent excluded and so on Scripts that are not named SCRIPT and that are not part of a linked set of scripts are removed from the database when they complete Overview of the Disk File Optimizer 1 7 Overview of the Disk File Optimizer 1 2 Product Description 2 File defragmentation phase one defragment those files that can be easily defragmented 3 File defragmentation phase two defragment files using a best fit algorithm For example defragment a file with 30 extents to 5 extents 4 File defragmentation phase three defragment those files that could not be defragmented in phase one or phase two 5 Frequent file placement arrange those files in the frequent list and hot file database together between INDEXF SYS and LBN 0 6 Dormant file placement arrange those files in the dormant list together between the high LBN and INDEXF SYS 7 Free space consolidation Consolidates free space If all files have not been defragmented in this first pass because free space was not available the phases are repeated again as needed 1 3 Basic File and File System Concepts A file is a body of data The file system uses some of the body of data strictly to manipulate the file file metadata The rest of the data comprises the information the user stores in the file In the OpenVMS File Control Program FCP the
9. DSDSCRF1 File script AD is ENABLED LEVEL SL device AD Explanation Defrag show output line User Action None DSDSCRF2 File script AD is DISABLED LEVEL SL device AD Explanation Defrag show output line User Action None DSDSCRO1 Offline script AD is ENABLED LEVEL SL device AD Explanation Defrag show output line User Action None DSDSCRO2 Offline script AD is DISABLED LEVEL ISL device AD Explanation Defrag show output line User Action None DUPDEFRAGER duplicate concurrent defragmentation processes for device AD Explanation The defragmentation process detected a currently running defragmentation process on the target device Concurrent defragmentation processes on the same target device are not allowed thus this process exits This ensures that two defragmentation processes do not attempt to defragment the same disk at the same time User Action Ensure that no two defragmentation processes attempt to defragment the same device at the same time DUPSCHED duplicate concurrent scheduler on node AD Explanation The scheduler detected another currently running scheduler on the current node Concurrent schedulers on the same node are not allowed User Action Ensure that no two schedulers execute on the same node at the same time F 10 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages DUPSCRPT duplicate script name AD Explanation An attempt was
10. Hab of Files with a given r nbor of oxtonte Each cormesponco bo BO Filos lure Freespace Histugram Freespaps Size LENE Lidadd To 4235 BiSL To ggz BBi0G To P2626 42184 To E4T4 3763 To S654 l 7344 To z64s5 12064 Ta 1231 4045 To 5628 7308 To 73 The DECwindows Interface for Defrag 5 29 The DECwindows Interface for Defrag 5 5 Report on the State of a Volume Figure 5 20 Report Volume Volume Space Histogram Yolunc Froe epace Histogram 5 30 The DECwindows Interface for Defrag 6 The DECwindows Interface for Defrag Plus In addition to the DCL command line interface the Disk File Optimizer DFO software includes a DECwindows interface This interface gives a visual reference for tasks built into the DFO software 6 1 Introduction The DFO DECwindows interface allows you to initiate control and stop defragmentation operations To start the DE Cwindows interface enter this command DEFRAGMENT INTERFACE DECWINDOWS The Disk File Optimizer initial window appears Figure 6 1 shows the initial window Figure 6 1 Initial Window Disk File Optimizer for Openy Ms va ile Optimize Script Monitor Report Options ion Version Welcome to Disk File Optimizer Please make a menu selection to continue The DECwindows Interface for Defrag Plus 6 1 The DECwindows Interface for Defrag Plus 6 1 Introduction The interface allows you to perform the following actions e File
11. Intended Audience The Disk File Optimizer for OpenVMS Guide to Operations is intended for the system administrator This guide also contains information that may be of interest to programmers who wish to use the callable interface Structure of This Guide The following list presents the structure of this document Chapter 1 provides an overview of file fragmentation performance degradation due to file fragmentation and how the Disk File Optimizer can correct these situations Chapter 2 provides information on getting started with the Disk File Optimizer Part System Administrator s Guide provides information that the system administrator needs to operate the Disk File Optimizer software Chapter 3 explains how to use the Defrag variant of the Disk File Optimizer software Chapter 4 explains how to use the Defrag PLUS variant of the Disk File Optimizer software Chapter 5 describes how to use the Disk File Optimizer DECwindows interface to initiate control and end defragmentation operations Part Il Programmer s Guide contains information the programmer needs to use the callable interface Chapter 7 describes the callable interface Appendix A contains frequently asked questions Appendix B provides a list of files and logicals created during a Disk File Optimizer software installation Appendix C describes the report you receive from the SHOW command Appendix D shows an example of a brief log file x
12. 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 BRIEF default NOBRIEF Using Defrag PLUS 4 23 DEFRAGMENT FILE The BRIEF qualifier is used only with the LOG qualifier The BRIEF qualifier requests a brief log of all actions taken by the defragmentation process This log includes beginning and ending file status information The BRIEF and FULL qualifiers are mutually exclusive and NOBRIEF produces the same result as FULL The BRIEF qualifier is the default CONSOLIDATE FREESPACE NOCONSOLIDATE FREESPACE default The CONSOLIDATE FREESPACE qualifier tells the Disk File Optimizer to use its free space consolidation algorithm DORMANT file spec NODORMANT default The DORMANT qualifier indicates files to be considered dormant when final file placement decisions are made In order for the file to be placed dormant it must be the fil
13. return length address Not used must be zero The script name can be as follows A valid ASCII script name In this case the specified script is aborted e An unsigned longword that has been assigned the value DFGS K ALL SCRIPTS The buffer length field of the item descriptor must be four In this case DFGS DEFRAGMENT queues abort requests for all currently executing scripts 7 14 Callable Interface DFG DEFRAGMENT DFG K_AFTER DFG K AFTER indicates the time after which the scheduler is to start the requested operation The uses of the buffer length buffer address and return length address fields for the DFG K AFTER item code are as follows e buffer length L ength of the time specification string in bytes The buffer must be long enough to hold an absolute date time specification as described in the VMS Concepts Manual e buffer address Address of a character string buffer containing the absolute date time specification return length address Not used must be zero DFG K CANCEL DFG DEFRAGMENT queues a cancel request for the specified script DFG K CANCEL skips the next execution of the script The uses of the buffer length buffer address and return length address fields for the DFG K CANCEL item code are as follows buffer length Length of the script name in bytes The maximum size of a script name is 64 bytes e buffer address Address of the script name buffer return length address
14. 1 3 3 Cathedral Window In extreme cases of fragmentation the file system can generate a special type of mapping window called a cathedral window Basically if the number of extents exceeds the window size AND the user requests a file be mapped completely on OPEN then the file system generates a cathedral window The cathedral window maps the extents of an entire file regardless of the size number of headers number of mapping pointers or size of the ACL for the file It does not generate a window turn 1 4 Determining File Fragmentation The following methods can help you determine whether a particular volume or file is fragmented e Enter the following command DEFRAGMENT SHOW volume name VOLUME e Enter a DCL DUMP command e Use the VMS Monitor utility e Use VAX Performance Advisor VPA software e Use DEC Performance Solution DE Cps software 1 4 1 DEFRAGMENT SHOW volume VOLUME Command The DEFRAGMENT SHOW volume VOLUME command can be used to display the fragmentation state of a given volume Several options provide different levels of detail By default the SHOW subcommand provides a summary number called a fragmentation index that gives a rough idea of the fragmentation level for the volume Along with the fragmentation index is a brief list of statistics about file and free space fragmentation that support the fragmentation index value For additional information about using the SHOW subcommand see Chapter 3 or Chap
15. Explanation An attempt by the scheduler to abort the defragmentation process failed Associated messages provide more detail It could simply be that the defragmentation process has completed or is suspended User Action Refer to associated messages to determine a course of action NOLOOKUP error performing lookup on INDEXF SYS Explanation Attempt to find the FID of INDEXF SYS failed User Action Refer to associated messages to determine if additional action is necessary NOMEINTERFACE monitor interface not established Explanation This error occurs if the defragmentation process cannot establish the monitor interface In this case the error appears in the defragmentation process log file The error can also occur when executing the monitor function if the monitor interface is not yet established The error can also appear in the scheduler log file if the interface is not established User Action If you are trying to run the monitor try the command again as the defragmentation process may not yet have created the interface If the error occurs in the defragmentation process or scheduler log files determine a course of action based on any associated messages If the error is due to insufficient ENQUE limit increase the ENQUE limit of the user process running monitor or the scheduler process whichever is appropriate Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages NONODE AD not found
16. buffer length DFG S DFG FLAGS e buffer address Address of the buffer holding the DFG_ FLAGS There is only one DFG K SHOW SCRIPT DFG FLAGS descriptor per script DFG K SHOW SCRIPT DORMANT DFG DEFRAGMENT returns a file specification The file specification indicates a file or files if wildcard characters are present that will be classified dormant by the defragmentation process This file specification was originally part of the DFG K CLASSIFY DORM item descriptor Callable Interface 7 29 DFG DEFRAGMENT 7 30 Callable Interface Wildcard characters and logicals are not resolved for this file specification Since the DFG K_SHOW_SCRIPT_DORMANT item descriptor describes only one file specification DFG DEFRAGMENT returns multiple DFG K_SHOW_ SCRIPT_DORMANT item descriptors if there are multiple dormant file specifications If there are no dormant files associated with this script DFG DEFRAGMENT does not return a DFG K_SHOW_SCRIPT_DORMANT item descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the file specification in bytes buffer address Address of the file specification DFG K SHOW SCRIPT ENABLE DFG DEFRAGMENT returns a word indicating whether the script is currently enabled or disabled as follows e DFG K ENABLE Script is enabled e DFG K_DISABLE Script is disabled The uses of the buffer length and
17. 100 indicates a badly fragmented disk Approximately 9 2 out of 80 0 possible is due to file fragmentation 2 Approximately 4 4 out of 20 0 possible is due to freespace fragmentation 3 Freespace Summary Total free space 148076 blocks Percentage free 7 rounded 4 Total free extents 22 5 aximum free extent 30312 blocks LBN 1799744 inimum free extent 4 blocks LBN 1022776 Average free extent 6730 blocks 6 edian free extent 1556 blocks File Fragmentation Summary umber of files with some allocation 8398 Total file extents on the disk 8947 Average number of file extents per file 1 065373 7 edian number of file extents per file 1 Most Fragmented File SYSTEM FILES SPIELN ACCOUNTNG DAT 7 110 extents Example C 2 System Volume File Fragmentation Histogram File Fragmentation Histogram Extent Count 9 To 110 5 7 2 6 3 5 6 4 12 3 28 2 158 il Ckckckckckckckckck ck ckckckckckckck ck ck ckckckckck ck kk kk k kk kkkkkkkk 8184 Number of files with a given number of extents Each corresponds to 200 files DEFRAGMENT SHOW Command Report C 5 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command Example C 3 System Volume Volume Free Space Histogram Volume Freespace Histogram Freespace Size LBNs 30312 26724 21764 16536 15784 15744 7048 4044 3808 3672 1556 584 308 48 40 32 3X boob op o OO ORO ORO 36 006 Oe OH OO I
18. SYSSSHARE DFGSDEFRAGMENTSHR SHARE SYSSMESSAGE DFGSMESSAGE SHARE Assuming the options file name is LINK OPTIONS FILE OPT the following command line links MYPROG which calls DFG DEFRAGMENT and DFG RELEASE MEMORY LINK MYPROG OBJ OTHERS OBJ LINK OPTIONS FILE OPT OPTIONS Callable Interface 7 1 Callable Interface 7 3 DFGSDEFRAGMENT Routine 7 3 DFG DEFRAGMENT Routine This section describes the DFG DEFRAGMENT routine 7 2 Callable Interface DFG DEFRAGMENT DFG DEFRAGMENT Format Description Returns Arguments The DFG DEFRAGMENT routine updates the scheduling database with information from the supplied arguments After updating the database DFG DEFRAGMENT returns a completion status in RO The actual defragmentation operation does not occur until initiated by a scheduler process running on the target nodes DFGSDEFRAGMENT dfg list sch list DFG DEFRAGMENT updates the scheduling database with information provided by the dfg list and sch list parameters Depending on the specific item descriptors this information generates one of the following commands e DEFRAGMENT Defragments a file a group of files or a volume e ABORT Aborts a defragmentation process e CANCEL Cancels the next scheduled defragmentation process e DISABLE Disables a scheduled defragmentation operation e ENABLE Enables a disabled defragmentation operation e REMOVE Removes a defragmentation operation from the sche
19. e DFG K ABORT ISSUED An abort command has been issued but the defragmentation process has not yet terminated e DFG K ENGINE ABORTED The defragmentation process has aborted e DFG K ENGINE TERMINATED The defragmentation process terminated on its own The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length Must be two buffer address Address of the word containing the value of the abort status The DFG K SHOW SCRIPT Q STATUS item descriptor may occur once per queue entry DFG K SHOW SCRIPT SCRIPT DFG DEFRAGMENT returns the script name associated with this data This item descriptor is the first one in the item list returned by DFG DEFRAGMENT There is one DFG K SHOW SCRIPT SCRIPT item descriptor for each script shown The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length Length of the script name string in bytes e buffer address Address of the script name string The DFG K SHOW SCRIPT SCRIPT item code descri ptor may occur only once per script shown DFG K SHOW SCRIPT SUCCESSOR DFG DEFRAGMENT returns the name of the script that is the successor to this script If no successor exists DFG DEFRAGMENT does not return the DFG K SHOW SCRIPT SUCCESSOR item code The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer le
20. e buffer address Address of the target file name DFG K SHOW SCRIPT FREQUENT DFG DEFRAGMENT returns a file specification The file specification indicates a file that will be dassified frequent by the defragmentation process This file specification was originally part of the DFG K CLASSIFY FREQ item descriptor Wildcard characters and logicals are not resolved for this file specification Since the DFG K SHOW SCRIPT FREQUENT item descriptor describes only one file specification DFG DEFRAGMENT returns multiple DFG K SHOW SCRIPT FREQUENT item descriptors if there are multiple frequent file specifications If there are no frequent files associated with this script DFG DEFRAGMENT does not return a DFG K SHOW SCRIPT FREQUENT item descri ptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the file specification in bytes e buffer address Address of the file specification DFG K SHOW SCRIPT INTERVAL DFG DEFRAGMENT returns a VMS delta time specification indicating the repeat interval for scripts that operate on a repeating schedule If no interval was specified DFG DEFRAGMENT does not return this descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length Length of the delta time string buffer address Address of the delta time string The DFG K_SHOW_SCRIPT_INTERVAL
21. exit the DE Cwindows interface e Optimize create a script to optimize a volume selected files or a disks volume index file e Script create modify remove show schedule and abort scripts for files or volumes e Monitor monitor the defragmentation process by selecting a script or volume to monitor e Report review the current state of a volume to determine if defragmentation is needed e Options set or show the Disk File Optimizer process parameters 6 2 File Menu The File menu serves only one purpose It allows you to exit this instance of Disk File Optimizer application To do so click on the File menu for the Exit option Click on Exit to close and exit this application Figure 6 2 shows the File pull down menu Figure 6 2 File Menu Disk File aptimizer for Gpen MS V2 Optimize Script Monitor Report Options Exit amp tri e Welcome to Disk File Optimizer Please make a menu selection to continue 6 3 Optimize Menu The Optimize menu has options for e Optimizing specific targets a volume file or an index file e aborting the optimize process Note that while you use the Optimize option you will create a script to optimize the target This step is the same as creating a script from the Scripts menu Use the following procedure to optimize a volume or a file 1 Pull down the Optimize menu see Figure 6 3 6 2 The DECwindows Interface for Defrag Plus The DECwindows
22. lille ee C 16 D Brief Log File Example E Full Log File Example F Defragmentation Messages F 1 General Message Information 0 00000 ee F 1 F 1 1 Linked Messages cere edu ee RAP ee RR vated F 1 F 1 2 Recovery Procedures 0 0000 ees F 2 F 1 3 Recovering from Command Entry Errors iles F 2 F 1 4 Reporting System Software or Hardware Errors F 2 F2 Disk File Optimizer Messages llleeee enn F 2 vii Index Examples 1 3 A 1 A 2 C 1 C 2 C 3 C 4 C 5 Figures viii 1 1 1 2 1 3 3 1 3 2 3 3 3 4 4 1 4 2 4 3 4 4 5 1 5 2 Viewing Retrieval Pointers Using the Dump Utility Defrag PLUS Method 0 c eee ee Defrag or Defrag PLUS Method suussaan ces System Volume aa o siu eee eee hh System Volume File Fragmentation Histogram System Volume Volume Free Space Histogram User Volume With System Log Files 0 00000 ees User Volume With System Log Files File Fragmentation FUISEOOR ANN s 2 4 trieste aha Pace Aan inaa a aa des tet a ona dats User Volume With System Log Files Volume Free Space ELISEOGE AN 202 hare retine acter ete ate mieten Cates fee Ta e User VolUErie 4 uuum eee ba tee dae kde ne ee te E User Volume File Fragmentation Histogram User Volume Volume Free Space Histogram 000 Brief Log Fils cu ex Rs IR Eee a eee hha hee a aad Full Eo9 Flle xiu e
23. 1 DUA2 NODE PRNOID LUNTIC MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA3 SCRIPT DEFRAG 1S DUA3 INTERVAL 1 00 00 AFTER 06 00 FULL PRIORITY DEFAULT 1 MINIMUM 0 LOG DFGSDATABASE DEFRAG 1 DUA3 NODE LUNTIC PRNOID MAIL NOOPCOM NOTIFICATION Xr Note Scripts were not created for the following volumes because e The paging volumes 1 DUA58 1 DUA59 and 1 DUA60 have only one file the paging file The paging file is always open so DFO will not defragment any files on the volumes e The individual RAID set volumes 1 DUA52 and 1 DUA53 have one large file which is not fragmented We created the script to defragment the RAID set DPAT1 e The individual shadow set members 1 DUAO and 1 DUA1 are defragmented with the script for DSAO 2 12 Getting Started Getting Started 2 8 Creating Scheduling Scripts for a Standalone System 2 8 Creating Scheduling Scripts for a Standalone System In this example the standalone system consists of an Alpha system and three volumes The three volumes are shown below Device Device Error Volume Name Status Count Label 1 DKA0 SPIELN Mounted 0 ALPHA071 1 DKA100 SPIELN Mounted 0 USER1 1 DKB0 SPIELN Online 0 BUILD Because no one is using the system at night schedule the scripts to run at 9 p m The following shows the LOAD_DB COM for this system DEFRAGMENT VOLUME 1 DKA0 SCRIPT DEFRAG_ 1 DKA0 INTERV
24. 5 8 5 3 Restrict File of Dialog Box Fields 0 0 0 0 c eee 5 9 5 4 Schedule Definition Dialog Box Fields 0000 eee 5 13 5 5 Defragmentation Process Statistics Window Description 5 18 5 6 Defragmentation Volume Map Window Description 5 21 5 7 Report Volume Option and Field Descriptions 5 28 6 1 Define Dialog Box Fields 0 0 00 cece 6 10 6 2 Translations of Operations to DCL Command LEVEL x 6 12 6 3 Restrict File of Dialog Box Fields 0 00 00 cece eens 6 14 6 4 Schedule Definition Dialog Box FieldS 00000 00s 6 18 6 5 Script Scheduling Actions 0 0000 eee ee 6 26 6 6 Defragmentation Process Statistics Window Description 6 30 6 7 Defragmentation Volume Map Window Description 6 33 6 8 Report Volume Option and Field Descriptions llle 6 41 6 9 Set Parameters Dialog BOX lseee ess 6 45 7 1 Arguments and Values for DFG DEFRAGMENT sss 7 4 B 1 Logical Names s onse haere ihe eot te T ene ta te bad og ea cre B 2 F 1 Severity IndiCatOrs vns mmm ELI der pp ee te eee F 1 Preface Purpose of This Guide The Disk File Optimizer for OpenVMS Guide to Operations provides information on the Disk File Optimizer software This guide also contains information about the DCL command graphic user interfaces and the callable interface and list of the messages generated by the software
25. 6 11 Logical blocks 1 8 Logicals DFG DATABASE B 2 DFG DISK B 2 DFG MAIL_ADDRESS B 2 DFG MESSAGE B 2 DFG SCRIPT B 2 DFG STATE B 3 DFG STATUS B 3 list of B 2 LOG qualifier 3 18 3 29 3 40 4 27 4 38 4 5 4 71 LOSTEXTHDR error 4 11 LSTBADVOL F 17 LVLOUTRNG F 17 Mail distribution file See also Logicals DFG MAIL ADDRESS MDNOTFOUND F 17 Messages general information F 1 list of F 2 MISSING LOGICAL F 17 MISSNGVAL F 18 MODIFIED F 18 Modifying scheduling scripts 2 8 6 20 Modifying scheduling scripts defragmentation jobs 2 7 MONBRKNDB F 18 MONINVCOL F 18 MONINVROW F 18 Monitoring optimization 5 15 5 18 scripts 6 28 Monitor utility 1 12 MONNOVOL F 18 MONPRIV F 18 MONRDERR F 18 MONUNEXP F 19 MONWRERR F 19 MOREINFO F 19 MOVFILINFO1 F 19 MOVFILQIOERR F 19 MOVFILSTSERR F 19 MULTSUCC F 19 N NOABOJ F 19 NOABOS F 20 NODEIGNOR F 20 NODELFIL F 20 NODE qualifier 4 56 Nodes designating for defragmentation 4 3 NOERASE ON DELETE improving I O performance 2 3 NOFILE F 20 NOHIGHWATER MARKING improving I O performance 2 2 NOINHER F 20 NOKILL F 20 NOLOOKUP F 20 NOMEINTERFACE F 20 NONODE F 21 NONOTIFY F 21 NOPRED F 21 NOPRIV F 21 NOQENTRY F 21 NOREMSCH F 21 NOREMSCR F 22 NOSCHED F 22 NOSCRIPT F 22 NOSCRNAM F 22 NOSHODAT F 22 NOSPECFILE F 22 NOTACCVIO F 22 NOTBADDATA F 22 NOTCLOSERR F 22 NOTDISK F 22 NOTERM F 23 NOTEXEC
26. BRIEF default NOBRIEF The BRIEF qualifier can be used only when the LOG qualifier is used The BRIEF qualifier requests a brief log of all actions taken by the defragmentation process This log includes beginning and ending file status information The BRIEF and FULL qualifiers are mutually exclusive and NOBRIEF produces the same result as FULL The BRIEF qualifier is the default CONSOLIDATE_FREESPACE NOCONSOLIDATE_FREESPACE default The CONSOLIDATE_FREESPACE qualifier tells the Disk File Optimizer to use its free space consolidation algorithm CPU_LIMIT n NOCPU_LIMIT The CPU LIMIT qualifier specifies the percent of CPU resouces that may be used for any one defragmentation process If this percentage is exceeded the priority for the process drops to the minimum as specified by the PRIORITY qualifier or defaults to three DORMANT file spec NODORMANT default The DORMANT qualifier indicates files to be considered dormant when final file placement decisions are made In order for the file to be placed dormant it must be the file specified in the command line Dormant files are placed at the high end of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influenc
27. F 23 NOTEXTEND F 23 NOTFILWRERR F 23 NOTFOUND F 23 NOTLOCDEV F 23 NOTMOUNT F 23 NOTODSDEV F 23 NOTRAN F 23 NOTSTOPPED F 24 NOTVOLSET F 24 NOVOLUME F 24 NULLENGINE F 24 ODNOTFOUND F 24 OPENIN F 24 OPENMAILERR F 24 OPENOUT F 24 OPTBADLIN F 24 Error Messages cont d OPTBADVOL F 25 OPTFILERR F 25 OPTHASFNF F 25 OPTINVQUAL F 25 OPTMULCLA F 25 OPTNOTCLA F 25 OPTRMSERR F 25 PARSEFAIL F 25 PRCOUTRNG F 26 PREDNOTUSRNAME F 26 PREPOSTDONE F 26 PREPOSTERR F 26 PREPOSTSTART F 26 PROCABORTED F 26 PROCESS DEV F 26 PROCESS ID F 26 PROCESS START F 26 PROCESS STOP F 27 PROCESS TIME F 27 QUEDALL F 27 QUEDNONAM F 27 QUEDSUCC F 27 RDERR F 27 REMFAIL1 F 27 REMFAIL2 F 27 REMOVED F 27 REMOVENOTDONE F 27 REMOVSEEN F 28 RESAREA F 28 RMDBACCERR F 28 RMSERR F 28 RSVDNAM F 28 SCHEDERR F 28 SCHEXIT F 28 SCHINITERR F 28 SCHNOTEXC F 29 SCHSTART F 29 SCRDIS F 29 SCRENA F 29 SDNOTFOUND F 29 SEARCHLOOP F 29 SENDMAILERR F 29 SETD F 29 SETFAIL F 29 SETN F 30 SETNODFAIL F 30 SETSUCC F 30 SHDWSETERR F 30 SHODATMIS F 30 SHOSCRFAIL F 30 SHOVOLPRIV F 30 SRNOTFOUND F 30 STAFAIL F 30 STARTED F 31 STARTNOTDONE F 31 STARTSEEN F 31 SYSSRVERR F 31 Error Messages cont d TIMEINV F 31 TRUNCSCR F 31 UNRECOVERR F 31 USERABORT F 31 USER ERR F 31 USRKILLENG F 31 VIRMEMERR F 32 VNOTFOUND F 32 VOLDIFF F 32 VOLFAIL1 F 32 VOLFAIL2 F 32 VOLSETERR F 32 VO
28. LOG brief only DEFRAGMENT OFFLINE VOLUME volume name MAIL NOTIFICATION NODE OPCOM_NOTIFICATION PROLOGUE SCRIPT Parameters volume name The volume name is the name of the volume containing the INDEXF SYS file to be defragmented Description The OFFLINE VOLUME subcommand defragments INDE XF SYS on the specified volume according to the selected command line qualifiers By definition INDEXF SYS has a minimum of four extents The extents consist of the following 1 Bootstrap block and home block 2 Backup home block 3 Backup index file header 4 Index file bitmap and file headers The minimum number of extents INDE XF SYS can have after defragmentation is five Before defragmenting the INDEXF SYS file do the following 1 Defragment and consolidate free space on the disk volume Consolidating free space on the disk volume gives DFO a place to create a new defragmented INDEXF SYS file 2 Check the free space summary to ensure there is enough free space on the disk volume to create a defragmented INDEXF SYS Use the following command to check the free space summary DEFRAGMENT SHOW disk volume VOL 4 48 Using Defrag PLUS Restrictions DEFRAGMENT OFFLINE_VOLUME An example of the free space summary report is shown below Freespace Summary Total free space 211072 blocks Percentage free 10 rounded Total free extents 23 Maximum free extent 53316 blocks LBN 671852 Minimum free extent 4 bl
29. Manual for more information on specifying times For linked scripts the time limit of the first script applies to the whole set Time limits specified with successor scripts apply to these scripts only If the time limit is set unreasonably low the defragmentation process may not accomplish useful defragmentation WRITE_CHECK NOWRITE_CHECK default The WRITE CHECK qualifier requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process Examples The following examples show different ways to defragment a file or group of files and how to use the common qualifiers 1 DEFRAGMENT FILE C This command defragments all files with a C extension in the user s current default directory To determine the device and directory in which the files are located issue the SHOW DEFAULT command 2 DFO DEFRAGMENT FILE C This command defragments all files with a C extension on the user s current default device The only difference between this command and the previous example is that this command is entered from within the Disk File Optimizer utility instead of from the DCL prompt 4 30 Using Defrag PLUS DEFRAGMENT FILE DEFRAGMENT FILE SYSS SYSDEVICE 000000 C This command is the same as the previous one except that the RMS default string is now explicitly identified as SY S SY SDEVICE 000000 C
30. NOAFTER FILES OBJ DEFRAGMENT SHOW c DEFRAGMENT REMOVE c The same commands entered from within the Disk File Optimizer utility would look like this DEFRAGMENT DFO DEFRAGMENT FILE C FULL LOG defrag c log SCRIPT c AFTER 22 00 DFO MODIFY c NOAFTER FILES OBJ DFO SHOW c DFO REMOVE c Using Defrag PLUS 4 1 Using Defrag PLUS 4 2 General Guidelines 4 2 2 Wildcard Use The file spec field allows wildcard characters You may specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume 4 2 3 Graphic User Interface The Disk File Optimizer graphic user interface GUI is available by entering the following command at the DCL prompt DEFRAGEMENT INTERFACE DECWINDOWS You can explicitly select the character cell interface by entering this command at the DCL prompt DEFRAGEMENT INTERFACE CHARACTER CELL 4 2 4 Online Help If you need a reminder of the Disk File Optimizer command syntax while working on the system you can access online help at the DCL prompt or from within the Disk File Optimizer utility To access online help enter the following at the DCL prompt HELP DEFRAGMENT or DEFRAGMENT HELP To access online help from within the Disk File Optimizer utility enter the following command DFO
31. Not used must be zero The script name can be as follows A valid ASCII script name In this case the specified script is canceled An unsigned longword that has been assigned the value DFGS K ALL SCRIPTS The buffer length field of the item descriptor must be four In this case DFG DEFRAGMENT queues cancel requests for all scripts Callable Interface 7 15 DFG DEFRAGMENT DFG K_DISABLE 7 16 Callable Interface DFG DEFRAGMENT disables the specified script Once disabled the script cannot execute until enabled using the DFG K_ ENABLE item code The uses of the buffer length buffer address and return length address fields for the DFG K DISABLE item code are as follows e buffer length Length of the script name in bytes The maximum size of a script name is 64 bytes e buffer address Address of the script name buffer return length address Not used must be zero The script name can be A valid ASCII script name In this case the specified script is disabled An unsigned longword that has been assigned the value DFGS K ALL SCRIPTS The buffer length field of the item descriptor must be four In this case DFG DEFRAGMENT queues disable requests for all scripts DFG DEFRAGMENT DFG K_ENABLE DFG DEFRAGMENT enables the specified script Once enabled the script operates normally The uses of the buffer length buffer address and return length address fields for the DFG K ENABLE item code are as
32. PROCESS TIME Time AD Explanation Gives time for associated messages User Action None QUEDALL AD request for all scripts has been successfully queued Explanation Any of the queued commands where ALL was specified were successful User Action None QUEDNONAM AD request for unnamed script has been successfully queued Explanation A defragmentation request was successfully processed the user did not supply a script name User Action None QUEDSUCC AD request for script AD has been successfully queued Explanation A defragmentation process was successfully queued and had a user specified script name User Action None RDERR error reading AD Explanation An attempt to read a file failed User Action Refer to associated messages to determine if additional action is necessary REMFAIL1 failed to remove AD from the database Explanation This is a summary message indicating the specified script was not removed Associated messages indicate the reason the remove operation failed User Action Refer to associated messages to determine a course of action REMFAIL2 noscript was removed from the database Explanation This is a summary message indicating that no script was removed from the scheduling database when the user had specified the ALL qualifier User Action Refer to associated messages to determine a course of action REMOVED Remove queued for script AD Explanation The specified script ha
33. Scheduler processes are only required on the nodes that execute defragmentation processes This scheme does not inhibit command processing in any way DEFRAGMENT commands can be entered and processed from any node in the cluster Another option is to use all nodes in the cluster This is the default for Disk File Optimizer software By using the DEFRAGMENT SET command to set the PROCESS LIMIT parameter you can limit the number of concurrent defragmentation processes on a node by node basis Thus some nodes may execute any number of concurrent defragmentation processes while others may execute a limited number of concurrent defragmentation processes If the target volume for defragmentation is not available clusterwide use the NODE qualifier Specify the name of the node from which the volume is accessible Note If you enter a DEFRAGMENT command for a device that is currently unavailable or unavailable from the issuing node the Disk File Optimizer software issues a warning message indicating the device is unsuitable for defragmentation and asks if you wish to continue to input the command f this command will not take effect until after the device is available enter Y in response to this message and the command is entered into the database If you enter N in response to this message the command is not entered into the database When the scheduler starts the script the device must be mounted or the command will fail 4 3 Scr
34. This command defragments all files with a C extension on the current default device and directory The only difference between this command and the previous example is that this command is entered from within the Disk File Optimizer utility instead of from the DCL prompt DEFRAGMENT FILE SYS LOGIN LOGIN COM 2 EXCLUDE OLD This command defragments the LOGIN COM file and excludes all files with a OLD extension DEFRAGMENT HELP DEFRAGMENT HELP The HELP subcommand invokes VMS Help for the Disk File Optimizer utility Format DEFRAGMENT HELP Parameters None Description The HELP subcommand invokes VMS HELP for the Disk File Optimizer HELP only provides information on the version of the Disk File Optimizer installed on your system Defrag or Defrag PLUS You can also access HELP for the Disk File Optimizer directly from the DCL propmt by typing one of these commands HELP DEFRAGMENT or DEFRAGMENT HELP Restrictions None Qualifiers None Examples The following examples show the various ways you can access HELP for the Disk File Optimizer utility 1 DEFRAGMENT HELP This command invokes HELP for the Disk File Optimizer utility directly from the DCL prompt 2 HELP DEFRAGMENT This command invokes HELP for the Disk File Optimizer utility directly from the DCL prompt 3 DFO gt HELP This command invokes HELP from within the Disk File Optimizer utility Using Defrag 3 21 DEFRAGME
35. Using Defrag PLUS 4 25 DEFRAGMENT FILE e PLACED lIgnores all files with explicit placement flags set in their headers e NOPLACED May defragment files with explicit placement flags Files indicated by the I GNORE qualifier are added to the EXCLUDE list The default value IGNORE PLACED 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 INHERIT script name NOINHERIT default The purpose of the INHERIT qualifier is to make script creation easier By inheriting most of the command data from a previously entered script and modifying only a few items such as volume name a completely new script can be created The INHERIT qualifier creates a database entry for a new script in the following way e Copies all fields from the specified script to the new script e Overwrites any qualifier or parameter values in the new script with those specified on the command line Names the new script as appropriate The user may specify a script name using the SCRI PT cript name qualifier Otherwise the defragmentation software creates a unique script name You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXduster system use a percent sign 96 to match a single character in the script name specification INTERVAL delta time NOINTERVAL
36. and File Fragmentation Summary plus more information that you can scroll down Refer to Figure 5 18 e IF you select the Histogram option you will see that portion of the Fragmentation Report that shows the File Fragmentation Histogram for the number of files with a given number of extents and the Volume Free Space Historgram which shows the free space size in LBNs Refer to Figure 5 19 and Figure 5 20 5 Finish the Report Volume Defragmentation operation by selecting OK to show the volume report and optionally create the output file you named in the Output File field The dialog box disappears e Apply to show the volume report and optionally create the output file you named in the Output File field The dialog box remains e Cancel to leave the Report option 5 26 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 5 Report on the State of a Volume Figure 5 17 The Report Volume Selection Dialog Box DISKSARPG2 1H2 DISKBUSERI Location Apply Cancel Help The DECwindows Interface for Defrag 5 27 The DECwindows Interface for Defrag 5 5 Report on the State of a Volume Table 5 7 Report Volume Option and Field Descriptions Field Description Free List The Free List option is used to show 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 to sh
37. follows e buffer length Length of the script name in bytes The maximum size of a script name is 64 bytes e buffer address Address of the script name buffer return length address Not used must be zero The script name can be A valid ASCII script name In this case the specified script is enabled An unsigned longword that has been assigned the value DFGS K ALL SCRIPTS The buffer length field of the item descriptor must be four In this case DFG DEFRAGMENT queues enable requests for all scripts DFG K INHERIT The DFG K INHERIT item descriptor specifies the name of a script that is to be inherited as well as a longword bit mask INHERIT MASK that indicates which fields in the script may be inherited The INHERIT MASK structure has the following bit definitions e DFG V INHERIT AFTER When set to 1 the start time of an inherit script can be copied to the new script When reset to 0 the start time cannot be copied e DFG V INHERIT DORMANT When set to 1 the dormant file list of an inherit script can be copied to the new script When reset to 0 the dormant file list cannot be copied e DFG V INHERIT EXCLUDE When set to 1 the exclude file list of an inherit script can be copied to the new script When reset to 0 the exclude file list cannot be copied e DFG V INHERIT FILE When set to 1 the file or list of files to be defragmented can be copied from an inherit script to the new scrip
38. seven and can be set for a given volume using SET VOLUME device spec WINDOWS n e LEVELS3 Any file with retrieval pointers in more than one file header is a candidate for defragmentation LEVEL 4 The defragmentation process for level four processing performs only free space consolidation This level is used with the CONSOLIDATE_FREESPACE qualifier e 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 qualifier If level 5 is selected the LEVEL 2 candidate file specifications are listed in the full log file 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 status 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 MAIL NOTIFICATION NOMAIL NOTIFICATION default Using Defrag PLUS 4 27 DEFRAGMENT FILE The MAIL_NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be mailed to the distribution list provided in the fi
39. 04 APR 2001 12 57 11 38 Volume name _ 1 DKA0 Media name DKX00 Cluster factor 4 Number of blocks 4110480 Begin file evaluation phase 04 APR 2001 12 57 11 91 Candidates for defragmentation based on the defragmentation level Begin free space consolidation 04 APR 2001 12 57 14 86 There are 436 consolidation areas IN USE DISKSAXP62 1H2 VMSSCOMMON SYSLIB LIB MLB 2 1 extent OPEN DISKSAXP62 1H2 AMEND DECWSSM LOG 5 End free space consolidation 04 APR 2001 13 12 08 95 continued on next page Brief Log File Example D 1 Brief Log File Example Example D 1 Cont Brief Log File Completion data for volume Time 04 APR 2001 13 12 09 05 Statistics Total number of files evaluated 0 Total number of candidates found 0 Total number of files defragmented 0 Total number of files partly defragmented 0 Total number of files placed frequent 0 Total number of files placed dormant 0 Accounting information Buffered I O count 6354 Direct I O count 50932 Page faults 260 Peak working set 5072 Charged CPU time 00 00 46 78 Elapsed time 0 00 14 57 69 Defragmentation process normal completion Process ID 2100013D Device _S1SDKAO Time 04 APR 2001 13 12 09 68 D 2 Brief Log File Example E Full Log File Example Example E 1 shows an example of a full log file Example E 1 Full Log File Disk File Optimizer for OpenVMS DFG V2 6 Time Process ID Node Run time parameters Defragmentatio
40. 10_L TXT 4 1107 extents 10_MS TXT 1 34 extents DFO_TEST_10 DFO_TEST DFO_TEST_10 DFO_TEST DFO_TEST_10 DFO_TEST DFO_TEST_10 DFO_TEST DFO_TEST_10 DFO_TEST 10_L TXT 1 3321 extents End file evaluation phase Statisti Numb Numb CS er of files evaluated er of candidates for defragmentation 668 Does not include dormant and frequent files 04 APR 2001 14 45 06 04 886 Number of frequent files in list 108 Number of frequent file candidates 59 Number of dormant files in list 110 Number of dormant file candidates 60 Candidates evaluated by category Indexed files 0 Files with fixed placement 0 Contiguous files 99 Less than or equal to window turn 0 Less than or equal to one header 443 Greater than one header 225 Begin file defragmentation phase one 04 APR 2001 14 45 06 68 Files processed during defragmentation phase one Symbols preceding a file name indicate the following Blank file has been preprocessed for defragmentation d file has been defragmented 7 file has been partly defragmented D file has been placed for dormant access Dd file has been defragmented and placed dormant D file has been placed dormant and been partly defragmented D file could not be placed dormant F file has been placed for frequent access Fd file has been defragmented and placed frequent F file has been placed frequent and been partly defragmented F file could no
41. 6 28 naming conventions 4 4 removing 6 21 scheduling 6 24 showing 6 22 SDNOTFOUND F 29 SEARCHLOOP F 29 SENDMAILERR F 29 SETD F 29 SETFAIL F 29 SETN F 30 SETNODFAIL F 30 SETSUCC F 30 SHDWSETERR F 30 SHODATMIS F 30 SHOSCRFAIL F 30 SHOVOLPRIV F 30 SRNOTFOUND F 30 STAFAIL F 30 STARTED F 31 Starting DECwindows interface 5 1 6 1 STARTNOTDONE F 31 STARTSEEN F 31 SYSSRVERR F 31 T TIMEINV F 31 Truncating directories how to A 5 TRUNCSCR F 31 U UNRECOVERR F 31 USERABORT F 31 User interface 1 2 USER ERR F 31 USRKILLENG F 31 V VIRMEMERR F 32 Virtual blocks 1 8 VMSduster System common scheduling database 2 4 considerations 2 3 locally mounted volumes 2 4 processes per node 2 4 VNOTFOUND F 32 VOLDIFF F 32 VOLFAIL1 F 32 VOLFAIL2 F 32 VOLSETERR F 32 Volume report 6 36 Volume index file defragment 5 14 VOLUMELOCKERR F 32 VOLUMENOTDONE F 32 Volume report 5 24 Volume to be defragmented See DFG K OFFLINE item descriptor See DFG K VOLUME item descriptor VOLUNLOCKERR F 33 VPA database 3 3 4 8 VPAEND F 33 VPATIME F 33 W Wildcards 3 5 4 2 Window turn definition of 1 11 WRTERR F 33 X XINHERIT F 33 Index 9
42. 6 44 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 7 Options Menu 6 7 1 Setting Process Limits This option allows you to set the defragmentation process limits for the defragmentation processes on the nodes in your system and allows you to remove unwanted nodes from the database These process limits define how much of your computing resources you want to dedicate to the defragmentation process Figure 6 28 shows the dialog box for setting defragmentation process limits Figure 6 28 Set Process Dialog Box Disk File Optimizer Set Proge MAX PROC nclude in list all Nodas 22 Only those in DE Table 6 9 describes the fields and buttons of the Set Parameters dialog box Table 6 9 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 resources 10 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 continued on next page The DECwindows Interface for Defrag Plus 6 45 The DECwindows Interface for Defrag Plus 6 7 Options Menu Table 6 9 Cont Set Parameters Dialog Box Field Description Include in list Use the All Nodes button to select all nodes on the VM Scluster
43. 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 BRIEF default NOBRIEF The BRIEF qualifier may only be used when the LOG qualifier is also present The BRIEF qualifier requests a brief log of all actions taken by the defragmentation process This log includes beginning and ending volume status information The BRIEF and FULL qualifiers are mutually exclusive and NOBRIEF produces the same result as FULL The BRIEF qualifier is the default CONSOLIDATE_FREESPACE NOCONSOLIDATE_FREESPACE default The CONSOLIDATE_FREESPACE qualifier tel
44. ATTACH command to transfer control of the terminal to another process in the subprocess tree induding the parent process the Defragment Utility If the DFO SPAWN command is invoked with a DCL command specified as the command parameter that command is executed in the subprocess and control returns immediately to the parent process f the command parameter is not specified then control is passed to the created DCL subprocess until it is deleted or until an ATTACH command is issued to transfer control to another process None None The following examples show how to SPAWN processes from within the Disk File Optimizer utility 1 DEFRAGMENT DFO SPAWN The SPAWN command creates a subprocess and transfers terminal control to the created subprocess Since no particular command was entered in this example SPAWN sends control to DCL 3 34 Using Defrag DEFRAGMENT SPAWN DFO gt SPAWN SHOW DEFAULT DISK 1 JONES DFO The SPAWN command creates a subprocess and executes the DCL command SHOW DEFAULT in the created subprocess Control then returns to the Disk File Optimizer parent process Using Defrag 3 35 DEFRAGMENT VOLUME DEFRAGMENT VOLUME The VOLUME subcommand defragments the volume given as a parameter on the command line according to the defragment command line qualifiers Format BRIEF CONSOLIDATE_FREESPACE CPU_LIMIT DORMANT EPILOGUE EXCLUDE FREQUENT FULL HOTFILE_DATABASE
45. Calculation of Fragmentation Index C 4 Calculation of Fragmentation Index The fragmentation index is a value that DFO assigns to a volume The fragment index is made up of two components e 80 of the index is file fragmentation e 20 of the index is free space fragmentation To explain how the index for free space fragmentation is calculated you must understand how move area extents are calculated The following diagram has three move area extents These are areas between files that cannot be moved In this example let each dash represent a block You can see that the 2 free spaces of 7 blocks each 14 blocks can fit in the extent 2 However right now the free space is in 2 extents Using the algorithm below you will find that this diagram has 2 extents on the disk and the best it can dois 1 Therefore the free space index is 2 1 2 4 extent 1 lt gt extent 2 eee 5 gt where the upper line is allocated space the lower line is free space indicates a file that cannot be moved The following types of files cannot be moved Reserved system file File is set NOMOVE File is a directory Indexed file and indexed files cannot be moved Placed file and placed files cannot be moved Files excluded by the user Oc Ci 4 Co F5 FEF C 16 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 4 Calculation of Fragmentation Index The following algorithm explains how the file
46. Create Script Script Name Define Restrict Schedule Optimize lt gt volume l lt gt selected Files md TS P write check Relative Volume Number o amp gt volume Index File Operations i Defragment Files Moderately fragmented Files only E volume analysis only E CONUENIT 3 consolidate Free space Notify by I Log File Li Console Message CJ Mail Message In the Script Define dialog box for a volume you can Select a volume name Select to enable or disable write check Select the relative volume number of a volume set Select whether to defragment files and what kind of files to defragment Select whether to consolidate freespace or not Select whether or not to do a volume analysis Select whether to notify you by log file console message mail message or by all three Select whether to report brief or full log files Select whether to inherit the properties of another script The DECwindows Interface for Defrag Plus 6 7 The DECwindows Interface for Defrag Plus 6 4 Script Menu Figure 6 6 shows the script define dialog box for a file Figure 6 6 Script Define Dialog Box for a File isk File Optimizer Create Script Eo Optimize Selected Fil Script Name Define Restrict Schedule Optimize lt gt volume iles ite check Relative Volume Number Jo lt gt selec
47. DFG 2 6 2001 Compaq Computer Corporation Volume script DEFRAG 1 DKB0 is ENABLED LEVEL 2 device S1 DKBO 1 Defragmentation process PID 2260153D is executing on NODE LUNTIC 2 Scheduler queue contains the following operations DEFRAGMENT VOLUME S1SDKBO on 04 Apr 2001 17 00 00 00 Consolidate freespace Script repeat interval 1 00 00 00 00 Minimum Priority 3 Default Priority 4 Script may operate on the following nodes LUNTIC Log file DISKSUSER1 DFGSDATABASE DEFRAG_ 1SDKB0 LOG FULL No prologue file specified No epilogue file specified Mail notification is ON OPCOM notification is OFF Special file handling Exclude all specifically placed files 1 This line shows the device being defragmented 1 DK BO 2 This line shows the process ID PID 2260153D and the node LUNATIC Example A 2 Defrag or Defrag PLUS Method SHOW SYSTEM OUTPUT X X SEARCH X X DFG 226000AA DFGSLUNTIC LEF 4 3550 2260153E DFGSALPHA071 LEF 5 142 00 12 75 924 271 1 00 00 22 137 1482 0 00 0 00 1 This line shows that the scheduler is running 2 This line shows that a defragmentation process is running on DF G ALPHAO71 You can monitor the progress of a defragmentation job using the following command DEFRAGMENT MONITOR script name or volume name Refer to the MONITOR command in Chapter 3 or Chapter 4 for more information A 2 Answers to Frequently Asked Questions Answers to Frequently Asked Questions Can I defragment a RAID a
48. DFG FLAGS FROM DFG FLAGS VALUE INHERITED FROM DFG K INHERIT SCRIPT VALUE INHERITED FROM DFG K INHERIT SCRIPT e DFG M_FULL Provides full 1 or brief 0 error logging e DFG M HONOR Honors the placement of files with placement control information These files become part of the exclude file list e DFGS M INDEXED 1 defragments and places RMS indexed files 0 exdudes RMS indexed files e DFGS M ISSUE OPCOM 1 turns on OPCOM notification 0 turns off OPCOM notification e DFGS M LEVEL This three bit field can have any one of the following values DFG K LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels DFG K _ LEVEL 2 through DFG K LEVEL 4 is a candidate for defragmentation DFG K LEVEL 2 Any file with extents that cannot be completely mapped by the mapping window or that can be selected using levels DFG K LEVEL 3 or DFG K LEVEL 4 is a candidate for defragmentation The default window value is 7 and can be set for a given volume using SET VOLUME device spec WINDOWS n DFG K LEVEL 3 Any file with retrieval pointers in more than one file header or that can be selected using DFG K LEVEL 4is a candidate for defragmentation DFG K LEVEL 4 This level is reserved for future use It is functionally equivalent to DFG K LEVEL 3 DFG K LEVEL 5 This level requests a volume analysis only no defragmentation occurs The statistical results are avail
49. Defragments INDEXF SYS on the specified volume according to the selected command line qualifiers Removes the specified script or node name from the scheduling and parameter database Sets the specified parameters CPU LIMIT IO LIMIT PROCESS LIMIT to the values specified Shows the contents of the scheduling and parameter database or the fragmentation state of the supplied volumes Creates a subprocess and either transfers control to the subprocess or executes a DCL command from within the subprocess Starts the specified script at the time specified by the AFTER qualifier By default the script starts immediately Defragments a selected volumes The DEFRAGMENT VOLUME command creates and enters a script into the scheduling database This script defragments the specified volume By default the script is immediately eligible for execution 4 6 1 Defrag PLUS Commands This section provides detailed information about each command for the Defrag PLUS variant of the Disk File Optimizer software Using Defrag PLUS 4 13 DEFRAGMENT ABORT DEFRAGMENT ABORT The ABORT subcommand terminates the execution of the script or scripts specified in the command line Format DEFRAGMENT ABORT soipiname Lee IALL Parameters script name The script name parameter is the name of the script to be aborted You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the
50. F 23 NOTEXTEND F 23 NOTFILWRERR F 23 NOTFOUND F 23 NOTLOCDEV F 23 NOTMOUNT F 23 NOTODSDEV F 23 NOTRAN F 23 NOTSTOPPED F 24 NOTVOLSET F 24 NOVOLUME F 24 NULLENGINE F 24 O ODNOTFOUND F 24 OPENIN F 24 OPENMAILERR F 24 OPENOUT F 24 Operational overview See Disk File Optimizer OPTBADLIN F 24 OPTBADVOL F 25 OPTFILERR F 25 OPTHASFNF F 25 Optimize monitoring 5 15 process statistics 5 18 restrict special files 5 8 Index 7 Optimize cont d schedule 5 12 Optimize files 5 13 Optimize menu 5 3 6 5 Optimize Menu DECwindows interface 6 2 Optimize parameters define 5 3 Optimize volume 5 3 Optimize volume index file 5 14 OPTINVQUAL F 25 OPTIONS qualifier 3 18 3 40 4 28 4 39 4 72 OPTMULCLA F 25 OPTNOTCLA F 25 OPTRMSERR F 25 Organizing Organizing Volumes Efficiently 2 1 P PROCESS TIME F 27 PROLOGUE qualifier 1 6 3 19 3 29 3 41 4 29 4 40 4 51 4 73 5 13 6 19 Q QUEDALL F 27 QUEDNONAM F 27 QUEDSUCC F 27 R PARSEFAIL F 25 Postprocessing files See DFG DEFRAGMENT routine DFG K_ POST PROCESS item descriptor PRCOUTRNG F 26 PREDECESSOR qualifier See Script how to link PREDNOTUSRNAME F 26 PREPOSTDONE F 26 PREPOSTERR F 26 PREPOSTSTART F 26 Preprocessing files See DFG DEFRAGMENT routine DFG K_ PRE PROCESS item descriptor PROCABORTED F 26 Processes per node VMScluster System 2 4 Process limits See DEFRAGMENT commands SET See DEFRAGMEN
51. Free Block are again self explanatory 4 Click on a directory green or an open file red for the Volume Map File Information dialog see Figure 5 11 It has details concerning the selected entity with respect to its volume 5 Click on OK to dose that dialog Note Click on Apply in the Graphic Full volume Map dialog to find out if the selected volume is being defragmented currently The DECwindows Interface for Defrag 5 25 The DECwindows Interface for Defrag 5 5 Report on the State of a Volume 5 5 2 Text Format Use the following procedure for a text display of the selected volume s 1 Click on the Text suboption of the Report Volume Fragmentation menu See Figure 5 15 for the Report Select Volume dialog Use the following procedure to show volume information 1 Select the Report pull down menu See Figure 5 15 2 Click on the Volume fragmentation option of the Report pull down menu for the report type list Graph Text report Click on Text to select it You will see the Report Select Volume dialog See Figure 5 17 and to Table 5 7 3 Select a volume from the list in the Show Volume options dialog box Select any of the options for showing volume information Table 5 7 describes the options e IF you keep the Statistics option default and double dick on the volume or dick on OK you will see a scrollable page of a Fragmentation Report showing fragmentation index Freespace Summary
52. HELP 4 2 5 Quickness and Effectiveness of Defragmentation How quickly and effectively the defragmentation process defragments a volume depends on a number of variables such as e The amount of free space on the volume If all other variables are constant a volume with little free space takes longer to defragment than a volume with a lot of free space e The number of users accessing files on the volume Because the defragmentation process does not impact a user s ability to read and write files it cannot defragment a file that is being accessed Thus a large number of user file accesses on the target volume can negatively impact the effectiveness of the defragmentation process e User set CPU or I O limits In general the more restrictive the limits the longer it takes to defragment a given volume 4 2 Using Defrag PLUS Using Defrag PLUS 4 2 General Guidelines 4 2 6 Cluster Management By default all DEFRAGMENT subcommands have systemwide or clusterwide scope For example an ABORT subcommand entered on one node of a cluster effects all nodes Where appropriate you may limit the scope of a command by using the NODE qualifier By specifying the node name you limit defragmentation process creation to the specified node Thus the actual defragmentation work occurs on the dedicated node leaving the other nodes in the cluster available for their usual workload With this scheme only one scheduler process is required
53. K SHOW SCRIPT PREDECESSOR DFG DEFRAGMENT returns the name of the predecessor to this script If no predecessor exists DF G DEFRAGMENT does not return a DFG K SHOW SCRIPT PREDECESSOR item descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length L ength of the predecessor s script name e buffer address Address of the predecessor s script name The DFG K SHOW SCRIPT PREDECESSOR item descri ptor may occur only once per script shown DFG K SHOW SCRIPT Q ACTION DFG DEFRAGMENT returns a word indicating what action is pending for this script The following symbolic constants are defined e DFG K ABORT An abort operation is scheduled for this script e DFG K_CANCEL A cancel operation is scheduled for this script e DFG K REMOVE A remove operation is scheduled for this script e DFG K SCRIPT This script is scheduled to execute e DFG K SHOW SCRIPT Q CANCEL The script is currently canceled The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length Must be two e buffer address Address of the two byte buffer containing the Q ACTION code Callable Interface 7 33 DFG DEFRAGMENT 7 34 Callable Interface The DFG K SHOW SCRIPT Q ACTION item descriptor occurs once for every pending action Thus it may appear several times for a single script The pending actions are
54. LEVEL 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 qualifier If level 5 is selected the LEVEL 2 candidate file specifications are listed in the full log file 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 status 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 OPCOM_NOTIFICATION default NOOPCOM_NOTIFICATION The OPCOM_NOTIFICATION qualifier sends brief status and termination messages regarding defragmentation processes to OPCOM OPTIONS file spec NOOPTIONS default 3 18 Using Defrag The OPTIONS qualifier provides an alternate method for associating files with the DORMANT EXCLUDE or FREQUENT qualifiers If the list of files for any of these qualifiers is long you can create a separate file that contains this information Each record in the options file consists of a file name followed by one of the following keywords e EXCLUDE File to be excluded e FREQUENT File to
55. Scripts DEFRAG 1 is restricted to execute on NODE 1 in the VAXcluster system Finally because no time limit was given in this command the defragmentation process will execute until it completes 4 3 3 4 Copying Scripts The INHERIT qualifier is used to copy a set of script characteristics Using the INHERIT qualifier you can create new scripts based on existing scripts When using the INHERIT qualifier a script s characteristics such as start time AF TER excluded files EXCLUDE and so forth are derived from a combination of the script given as a value to the INHERIT qualifier and any additional command line qualifiers To prohibit a script from inheriting a given characteristic negate the associated command line qualifier by providing a new value For example to prohibit a script from inheriting the starting time of the inherited script specify NOAFTER or AFTER time spec The following example shows how to create a new script DEFRAG 2 based on an existing script DEFRAG 1 DEFRAGMENT VOLUME DISKSTWO SCRIPT DEFRAG 2 INHERIT DEFRAG 1 LOG DEFRAG 2 L0G Note The Disk File Optimizer software will not allow two scripts to defragment the same volume at the same time The DEFRAG 2 script will inherit all DEFRAG 1 characteristics except the target volume script name and log file 4 3 3 5 Modifying Scripts Once you create a script and store it in the database you can use it over and over again
56. Use the Only those in DB button 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 defragmentation process parameters 6 7 1 1 The Set Process Limits Procedure Use the following procedure to set Defrag PLUS process limits 1 2 4 Select the Options pull down menu then select Set Process Limits Select the node on which the defragmentation 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 Enter the process parameters CPU e 10 MAX PROC Exit the Set Process Limits option by selecting the Cancel button 6 7 1 2 Procedure for Removing Nodes Before removing nodes no scripts must have this node in it Use the following procedure to remove a node from the scheduling and parameter database 1 2 3 4 5 Select the Options pull down menu option then select Set Process Limits Set the list to indude only those nodes in the database by selecting the Only those in DB option Select the node which is to be removed from the database Select Remove button Exit the Set Process Limits option by selecting the Cancel button 6 7 2 Showing Defragmentation Proces
57. VOLUME OUTPUT OUTPUT TXT In this example information associated with MY VOLUME is displayed Output is directed to a file called OUTPUT TXT DEFRAGMENT SHOW DISKSONE 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 SY SSOUTPUT device 4 62 Using Defrag PLUS DEFRAGMENT SPAWN DEFRAGMENT SPAWN Format Parameters Description Restrictions Qualifiers Examples The Disk File Optimizer SPAWN subcommand creates a subprocess and executes a DCL command in the subprocess or transfers terminal control to the subprocess if no command is supplied DEFRAGMENT SPAWN command command This is a DCL command string of less than 132 characters that is to be executed in the context of the created subprocess After the command is executed the subprocess terminates and control returns to the parent process A command is optional If no command is supplied control passes to DCL The Disk File Optimizer SPAWN command creates a subprocess of your current process Use the DCL LOGOUT command to terminate the subprocess and return to the parent process You can also use the DCL ATTACH command to transfer control of the terminal to another process in the subprocess tree including the parent process If the Disk File Optimizer SPAWN command is invoked with a DCL
58. Xr DEFRAGMENT VOLUME 2SDKA100 SCRIPT DEFRAG 28DKA100 INTERVAL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 2 DKA100 NODE LUNTIC MAIL NOOPCOM NOTIFICATION oe 1o0 01 50 Nm The following describes each line in the above example 1 The defragment volume command with the volume to defragment 2 DKA100 2 The script name DEFRAG 2 DKA100 3 The interval between the start of script EVERY DAY 4 Thetime to start the script 21 00 5 The type of log to generate FULL 6 Thename of the log file DFG DATABASE DEFRAG 2 DK A100 7 The name of the node to start the script on LUNTIC 8 Thetype of notification MAIL and not OPCOM Getting Started 2 5 Getting Started 2 6 Creating Scheduling Scripts The following shows the command to create a script for a volume that is defragmented every third night on any available node DEFRAGMENT VOLUME 1 DUA2 SCRIPT DEFRAG 1 DUA2 INTERVAL 3 00 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA2 The following shows the command to create a script to defragment INDEXF SYS The script does not have a schedule You start it with the DEFRAGMENT START command after you have dismounted the volume DEFRAGMENT OFFLINE VOLUME 1 DUA2 SCRIPT DEFRAG OFFLINE 1 DUA3 NOAFTER The easiest way to create scheduling scripts is with a DCL command procedure This way if anything changes you can edit the command procedure and reload the scheduling database Al
59. address Not used must be zero DFG K VOLUME If you would use the DEFRAGMENT VOLUME command rather than the DEFRAGMENT FILE command for this defragmentation process use this item code to identify the volume to be defragmented You must supply either this item code or the DFG K FILE item code The uses of the buffer length buffer address and return length address fields for the DFG K VOLUME item code are as follows buffer length Length of the volume name string which has a maximum size of 255 bytes buffer address Address of the buffer containing the volume name string return length address Not used must be zero sch list VMS Usage item list 3 type longword unsigned access read only mechanism by reference The sch list argument is the address of a list of item descriptors each of which describes one scheduler specific option for this command The list of item descriptors is terminated by a longword of zero The sch list argument is not required however you must provide an argument placeholder if it is not used Specify a longword of zero or the address of a longword containing zero as an argument placeholder Note An error occurs if both the dfg list and sch list arguments are zero or are pointers to NULL item lists Figure 7 1 shows a single item list 3 descriptor Callable Interface 7 13 DFG DEFRAGMENT If the dfg list argument is not supplied the item descriptors that mak
60. all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume The defragmentation process always exdudes files marked NOMOVE open files files excluded in an options file and files excluded using the Ignore option Files in Hotfile Database This option causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s frequent file list continued on next page 6 14 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 3 Cont Restrict File of Dialog Box Fields Field Description Dormant The Dormant Files option indicates files to be considered dormant Files when final file placement decisions are made You may enter the file name or use the file list button to bring up a list of files to chose from 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer d
61. alphanumeric character e Underscoe e Hyphen Using Defrag PLUS 4 73 DEFRAGMENT VOLUME e Dollar sign Observe the following rules when naming a script e Useany combination of uppercase and lowercase letters e Do not begin script names using the dollar sign however you can include the dollar sign within the script name The dollar sign is reserved for special use by Compaq Computer Corporation e Do not end a script name with a hyphen since the hyphen is the DCL continuation character If you do not supply a script name using the SCRIPT qualifier the defragmentation software generates a unique script name This internally generated name has the format DF G SCRIPTX X where X is a hexadecimal number that keeps the script names unique Names beginning with DF G are reserved for use by the defragmentation software TIME LIMIT delta time NOTIME LIMIT default The TIME LIMIT qualifier specifies the maximum elapsed time allowed for a given defragmentation operation If the time limit is exceeded the defragmentation process is aborted Specify time as a delta time Refer to the OpenVMS User s Manual for more information on specifying times For linked scripts the time limit of the first script applies to the whole set Time limits specified with successor scripts apply to these scripts only If the time limit is set unreasonably low the defragmentation process may not accomplish useful defragmentatio
62. 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 Figure 6 17 is an example of the volume map file information Figure 6 17 Volume Map File Information Volume Information amp ALLOCATED LEN 2018250 3300 Blocks LEN 2018250 DFO TEST T DFO TEST 1 ML LEN 2018673 DFO TEST 1IDFO TEST 1 L TS The DECwindows Interface for Defrag Plus 6 29 The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume 6 5 1 Defragmentation Process Statistics Window The Defragmentation Process Statistics Window shows the process information and statistics on how files and space on the volume are allocated during defragmentation Figure 6 18 shows the Defragmentation Process Statistics window and Table 6 6 describes the data field information Figure 6 18 Defragmentation Process Statistics Window Process Id 32800247 Process prG DFO TEST Date Ri rEB 1997 13 32 53 71 i Script Nama DEFRAG 1 SDKB300 i Operating On SPIELN i Phase rile evaluation i Elapsed Time 0 0000 47 25 Current Status ENORMA amp L Buffered 1a Direct oO Count Hosa Count 6474 CPU Utilization Page Fault Time nno 00 00 11 59 Count Rate 29 second Rate Usage Rate second nnd Files Evaluated 521 Candidate Count 521 Placed Files b ndexed Files b Files Partly Defragmented o Files Defragmented
63. associating files with the DORMANT EXCLUDE or F REQUENT qualifiers If the list of files for any of these qualifiers is long you can create a separate file for this information Each record in the options file consists of a file name followed by one of the following keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e 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 FILEl EXE FREQUENT ARCHIVE EXCLUDE OLDSTUFF DORMANT Files indicated by the EXCLUDE qualifier and by either the DORMANT or FREQUENT qualifier are excluded Files indicated by the DORMANT qualifier and by the FREQUENT qualifier are considered dormant This rule is applied equally across all files specified in the OPTI ONS file and on the command line 4 72 Using Defrag PLUS DEFRAGMENT VOLUME PREDECESSOR script name NOPREDECESSOR default The PREDECESSOR qualifier links scripts These scripts execute in sequence one successfully completes before the next one begins The predecessor script name must exist in the scheduling database or an error status message is returned You can use wi
64. be sent to OPCOM OPTIONS file spec NOOPTIONS default 3 40 Using Defrag The OPTIONS qualifier provides an alternate method for associating files with the DORMANT EXCLUDE or FREQUENT qualifiers If the list of files for any of these qualifiers is long you can create a separate file that contains this information Each record in the options file consists of a file name followed by one of the following keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e 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 FILE L 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 FILEl EXE FREQUENT ARCHIVE EXCLUDE OLDSTUFF DORMANT DEFRAGMENT VOLUME Files indicated by the EXCLUDE qualifier and by either the DORMANT or FREQUENT qualifier are excluded Files indicated by the DORMANT and FREQUENT qualifiers are considered dormant This rule is applied equally across all files specified in the OPTIONS file on the command line PRIORITY DEFAULT n MINIMUM n NOPRIORITY default The PRIORITY qualifier specifies priorities for the defragment process The minimum priority setting is used when the defragmentation process excee
65. be considered frequently accessed DEFRAGMENT FILE e 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 FILE L 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 Files indicated by the EXCLUDE qualifier and by either the DORMANT or FREQUENT qualifier are excluded Files indicated by the DORMANT and FREQUENT qualifiers are considered dormant This rule is applied equally across all files specified in the OPTIONS file as well as those associated with these qualifiers on the command line PRIORITY DEFAULT n MINIMUMzn NOPRIORITY default The PRIORITY qualifier specifies priorities for the defragment process The minimum priority setting is used when the defragmentation process exceeds the value specified by either CPU LIMIT or IO LIMIT PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures RVN n RVN 0 default When you have a bound volume set use the RVN qualifier to identify the relative volume number RVN
66. buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length Must be two buffer address Address of a two byte buffer containing a value of DFG K ENABLE or DFG K DISABLE There is only one DFG K SHOW SCRIPT ENABLE item descriptor per script DFG K SHOW SCRIPT EXCLUDE DFG DEFRAGMENT returns a file specification The file specification indicates a file that will be excluded by the defragmentation process This file specification was originally part of the DFG K EXCLUDE item descriptor Wildcard characters and logicals are not resolved for this file specification Since the DFG K SHOW SCRIPT EXCLUDE item descriptor describes only one file specification DFG DEFRAGMENT returns multiple DFG K SHOW SCRIPT EXCLUDE item descriptors if there are multiple exclude file specifications If no excluded files are associated with this script DFG DEFRAGMENT does not return a DFG K SHOW SCRIPT EXCLUDE item descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the file specification in bytes e buffer address Address of the file specification DFG K SHOW SCRIPT FILE DFG DEFRAGMENT DFG DEFRAGMENT returns the name of the target file or files for this script The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the target filename in bytes
67. continue to show scripts by node 6 22 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu To limit the scripts display to those belonging to the selected node leave the Limited option selected this is the default 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 wish to use the Limited option click on the option box to deselect it The candidate list of scripts will then include every script that runs on all nodes Select a script in the Node box and note that the script name gets highlighted in the Scripts box Proceed with Step 6 5 To show the scripts that apply to a volume select the volume Scripts that apply to the volume are listed in the Scripts box Selec a script that applies to a Volume and note the script name gets highlighted in the Scripts box 6 Tosee a script double click on the script name in the Scripts field or press Return or click on the Apply button The contents of the script appear in the area below the script name This feature allows you to see more than one script at a time To see additional scripts select their names 7 Finish the show script operation by dicking on e OK to produce the output file named in the Output File field e Apply to leave the Show Script dialog box and optionally produce the output file named in the Output File f
68. descriptor for the inherit script name string and the longword INHERIT_MASK The script name provided indicates the script from which DFG DEFRAGMENT inherits all characteristics except those supplied with other item descriptors in this item list return length address Not used must be zero DFG K INTERVAL Specifies the interval the scheduler is to use for repetitive executions of this script The interval is specified using a delta time specification as described in the VM S Concepts Manual The uses of the buffer length buffer address and return length address fields for the DFG K INTERVAL item code are as follows buffer length Length of the delta time specification in bytes buffer address Address of a buffer containing the delta time specification return length address Not used must be zero DFG K MODIFY The DFG K MODIFY item descriptor specifies a script that is to be modified and a longword bit mask INHERIT ENABLE MASK that indicates which fields in the script can be modified Other DFG DEFRAGMENT item codes must be used to identify the specific modifications For example to change the time a script is scheduled to execute the DFG V INHERIT AFTER bit must be set to 1 and the DFG K AFTER item code supplies to value to change to TheINHERIT ENABLE MASK structure has the following bit definiti ons e DFG V INHERIT AFTER When set to 1 the start time of the script can be modified When reset
69. e Shut down a process that opens a file before defragmentation and start it up after defragmentation 1 2 5 3 Operational Summary The Defrag process provides a very flexible combination of scheduling and operational characteristics For example defragmentation operations can occur one time only can execute on a periodic schedule can be limited to certain nodes in a duster or can execute on any node in the cluster You can control the CPU and I O resources the defragmentation processes use on a node by node basis The dashed line in Figure 1 1 indicates a potential node boundary The actions above the line and those below the line can occur on different nodes in a cluster 1 The database and database interface are actually shared among the nodes in a cluster 1 6 Overview of the Disk File Optimizer Overview of the Disk File Optimizer 1 2 Product Description 1 2 6 Scheduling Defrag PLUS This section explains how the scheduling and database functions for the Defrag PLUS variant of the software work 1 2 6 4 Scheduling Database and Database Interface The scheduling database stores DCL command lines These stored command lines are called scripts Almost every script is available for execution at any time Along with the script information the database stores scheduling information in a time ordered queue The scheduler uses this information to determine when to start a given script Starting the script initiates the defragmentation
70. extents in those files and the state of the free space on the volume The file and free space fragmentation summary provides more detail on the fragmentation index Refer to Appendix C for more information on this report Other options available show file and free space histograms list all free space holes list all files with more than a given number of extents and provide locations for specified files 3 6 Using Defrag 3 5 Defrag Command Set Using Defrag 3 5 Defrag Command Set The Defrag command set allows the system manager to perform file and volume defragmentation tasks Table 3 1 describes the commands available for Defrag Table 3 1 Defrag Command Summary Command Description DEFRAGMENT ABORT volume namef QUALIFIERS DEFRAGMENT ATTACH 4process name QUALIFIERS DEFRAGMENT EXIT DEFRAGMENT FILE file name IQUALIFIERS DEFRAGMENT HELP command DEFRAGMENT MONITOR volume name QUALIFIERS DEFRAGMENT OFFLINE VOLUME volume namef QUALIFIERS DEFRAGMENT SHOW volume name QUALIFIERS DEFRAGMENT SPAWN command DEFRAGMENT VOLUME volume_namef QUALIFIERS Aborts the defragmentation process associated with the specified volume Before exiting the defragmentation process performs an orderly shutdown of all outstanding activities Transfers control from the current process which goes into hibernation to the specified pro
71. f Current Status fENORMAL rile evaluation i Elapsed Time 0 DO OD 47 25 uffered 1 7 Direct Lo CPU Utilization Page Fault Count Bosa t Count E474 Time nno 00 00 11 59 i Count Rate 29 second Rate Usage Rate Dysecand ana iles Evaluated 521 Dormant Count andidate Count 521 Exclude Count laced Files b Frequent Count ndexed Files b iles Partly Defragmented o Dormant Files Placed iles Defragmented Frequent Files Placed iles Processed Free Space Extent Count Free Space Extent countdown urrent File Table 5 5 Defragmentation Process Statistics Window Description Field Description Process Id The defragmentation process D number Process The defragmentation process name Date The current date and time continued on next page 5 18 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 4 Monitor a Volume Table 5 5 Cont Defragmentation Process Statistics Window Description Field Description Script Name The name of the script being monitored The field applies to the Defrag PLUS variant only Operating On The node on which the defragmentation process is operating Current Status The status of the defragmentation process Phase The current defragmentation process phase Elapsed Time The elapsed time since the start of the defragmentation process Buffered I O The
72. files This list is automatically added to the FREQUENT files list For more information about using VPA or DECps software to augment the frequent files list see Chapter 3 or Chapter 4 1 5 File Defragmentation and VMS Backup In the past BACKUP RESTORE was the only Compaq approved method to defragment a volume Now the Disk File Optimizer allows you to defragment a volume while that volume remains on line and accessible to other users without operator intervention Note The Disk File Optimizer does not replace the need to use the Backup utility to protect your data A fully defragmented disk significantly improves performance in the same way that using BACKUP and then RESTORE improves performance Contiguous files require less time to access Since the free space on the volume has also been consolidated the time required to create new files is also decreased Overview of the Disk File Optimizer 1 13 2 Getting Started 2 1 Introduction This chapter is for the new user of Disk File Optimizer DF O software It includes 1 Minimizing file fragmentation when initializing volumes Improving I O performance Licensing DFO Creating scripts Scheduling defragmentation jobs Au FW N Creating scheduling scripts 2 2 Organizing Volumes Efficiently You can keep file fragmentation to a minimum by using certain qualifiers with the volume INITIALIZE command To maximize performance by keeping head movement on a vo
73. final file placement decisions are made In order for the file to be placed frequent it must be the file specified in the command line Frequent files are placed toward the center of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described See Section 4 3 for more information FULL NOFULL default The FULL qualifier requests a full log of all actions taken by the defragmentation process The FULL qualifier has no meaning if the LOG qualifier is absent The FULL and BRIEF qualifiers are mutually exclusive and NOFULL provides the same functionality as BRIEF HOTFILE_DATABASE NOHOTFILE_DATABASE default The HOTFILE_DATABASE qualifier causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the FRE QUENT file list IGNORE keyword IGNORE PLACED default NOIGNORE The IGNORE qualifier requests that the defragmentation process ignore certain types of files as specified by the following keywords e INDEXED Ignores all RMS indexed files e NOINDEXED May defragment RMS indexed files
74. for Defrag 5 5 The DECwindows Interface for Defrag 5 3 Optimize Menu Figure 5 6 Define Dialog Box for a Volume Index File isk File Optimizer aptimize volume Index File Define Schedule Optimize lt gt Volume gt Selected Files lt gt Volume Index File Volume Notify by C1 Log File i console Message CP Eriet Log Table 5 1 Define Dialog Box Fields Field Description Volume Defragments the volume named in the volume field This has the same effect as using the DEFRAGMENT VOLUME DCL command Selected Files Defragments the file or files named in the files field This has the same effect as using the DEFRAGMENT FILE DCL command Volume Index Files Defragments the IN DEXF SY S of the disk named in the disk field This has the same effect as using the DEFRAGMENT OFFLINE VOLUME DCL command Volume The Volume button only appears when the Volume or Volume Index File buttons are depressed Enter the volume name or use the Volume button to bring up a list of volumes or disks continued on next page 5 6 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Table 5 1 Cont Define Dialog Box Fields Field Description Files The Files button only appears when the Selected Files button is depressed Push the File button file to bring up a list of files Writ
75. for Defrag Plus The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Table 6 8 Report Volume Option and Field Descriptions Field Description Free List The Free List option is used to show 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 to show 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 to show 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 to show 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 WINDOWS 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
76. from the current process which goes into hibernation to the specified process Cancels the next scheduled execution of the specified script Normal scheduling resumes after the next scheduled execution Disables the specified script A script does not execute while it is disabled The script remains disabled until it is enabled with the ENABLE subcommand Enables a previously disabled script Once enabled a script operates normally Exits the user from the Disk File Optimizer utility and returns to the system prompt Defragments a selected file or files Invokes VMS HELP utility for the Disk File Optimizer software Modifies an existing script Invokes the defragmentation monitor which monitors an ongoing defragmentation process The input parameter can be either a script or a volume name depending on the setting of the VOLUME qualifier continued on next page Using Defrag PLUS 4 6 Disk File Optimizer Command Set Table 4 2 Cont Defrag PLUS Command Summary Command Description DEFRAGMENT OFFLINE_VOLUME volume namef QUALIFIERS DEFRAGMENT REMOVE amp cript name node namef QUALIFIERS DEFRAGMENT SET parameter valuef N ODE a nodel DEFRAGMENT SHOW script namer volume namef QUALIFIERS DEFRAGMENT SPAWN command DEFRAGMENT START cript namef QUALIFIERS DEFRAGMENT VOLUME volume_namef QUALIFIERS
77. guarantee file placement but makes every effort to place files as described FULL See Section 4 3 for more information NOFULL default The FULL qualifier requests a full log of all actions taken by the defragmentation process The FULL qualifier has no meaning if the LOG qualifier is absent The FULL and BRIEF qualifiers are mutually exclusive and NOFULL provides the same functionality as BRIEF HOTFILE_DATABASE NOHOTFILE_DATABASE default The HOTFILE_DATABASE qualifier causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s FREQUENT file list IGNORE keyword IGNORE PLACED default NOIGNORE 4 36 Using Defrag PLUS DEFRAGMENT MODIFY The IGNORE qualifier requests that the defragmentation process ignore certain types of files as specified by the following keywords e INDEXED Ignores all RMS indexed files e NOINDEXED May defragment RMS indexed files e PLACED lIgnores all files with explicit placement flags set in their headers e NOPLACED May defragment files with explicit placement flags Files indicated by the I GNORE qualifier are added to the EXCLUDE list The default value IGNORE PLACED 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 INTERVAL delta time NOINTERVAL defa
78. in configuration Explanation A node name that was associated with a script was not present in the configuration This error can also occur during scheduler initialization if both the SYSGEN parameter SCSNODE and the logical SYS NODE are undefined on the node where the scheduler is running In the case of the scheduler the node name reported in the message will be blank User Action If the error occurs in the scheduler log file define either the logical name SY S NODE or the SYSGEN parameter SCSNODE and restart the scheduler If the error occurs when entering a command ensure you have spelled the node name correctly and that the node exists on the local system NONOTIFY mail notification of defragmentation process completion failed Explanation An attempt to send mail to the mail distribution list specified in DFG MAIL ADDRESS has failed User Action Verify that the logical DFG MAIL ADDRESS is defined Refer to associated messages to determine if additional action is necessary NOPRED predecessor script AD not found Explanation The script specified in the PREDE CESSOR qualifier could not be found in the SCRIPTS relation User Action Check spelling of the script name used with the PREDECESSOR qualifier Use the name of a script that has already been defined with the VOLUME subcommand for the PREDECESSOR qualifier NOPRIV insufficient privileges you need BYPASS CMKRNL DETACH EXQUOTA NETMBX SHARE SYSGBL SYSLCK SYSPRV TM
79. item descriptor can occur only once per script DFG K SHOW SCRIPT LOG DFG DEFRAGMENT returns the file specification of the log file used for this script If the file specification contains logical names they are not resolved If no log file was specified with the script DFG DEFRAGMENT does not return this item descri ptor Callable Interface 7 31 DFG DEFRAGMENT 7 32 Callable Interface The uses of the buffer length and buffer address fields of the ITEM_LIST_2 descriptor are as follows buffer length L ength of the log file string e buffer address Address of the log file string The DFG K SHOW SCRIPT LOG item descriptor can occur only once per script DFG K SHOW SCRIPT NODE DFG DEFRAGMENT returns a node name on which a defragmentation process associated with this script can execute If DFG DEFRAGMENT does not return a DF G K_ SHOW_SCRIPT_NODE item descriptor the script may execute on any local node Since the DFG K SHOW SCRIPT NODE descriptor describes only one node DFG DEFRAGMENT returns multiple DFG K SHOW SCRIPT NODE descriptors if execution of the script can occur on more than one node The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length L ength of the node name string in bytes e buffer address Address of the node name string DFG K SHOW SCRIPT OPTIONS DFG DEFRAGMENT returns the file specification of the options file if any asso
80. less results in no useful defragmentation work The uses of the buffer length buffer address and return length address fields for the DFG K TIME LIMIT item code are as follows e buffer length L ength of the delta time specification string in bytes buffer address Address of a character string buffer containing a delta time specification This buffer must be large enough to contain a VMS delta time string as described in the VMS Concepts Manual return length address Not used must be zero 7 36 Callable Interface Return Values DFG ABOSEEN DFG DBUPDATERR DFG EMPDFGSCH DFG INTERR DFG INVDFGLST DFG INVDSLST DFG INVITEMCOMB DFG INVSCHLST DFG MISSING LOGICAL DFG NOPRIV DFG REMOVSEEN DFG SCRDIS DFG SCRENA DFG STARTSEEN DFG DEFRAGMENT An ABORT command issued for this script had not yet completed when another ABORT command for the same script was issued The command did not complete successfully Both the sch_list and the dfg_list parameters to DFG DEFRAGMENT were not present or referenced NULL item lists DFG DEFRAGMENT internal error The dfg list passed to DFG DEFRAGMENT was invalid because of one of the following e A call toDFG DEFRAGMENT using an sch list argument containing items that indicate the dfg list should be empty for example a sch list argument containing the DFG K _ SHOW SCRIPT item code may not be used in a call that has a dfg list argument e Somet
81. name NOEPILOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures EXCLUDE file spec NOEXCLUDE default The EXCLUDE qualifier specifies files to be 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 Using Defrag PLUS 4 35 DEFRAGMENT MODIFY Note The defragmentation process always excludes system files open files files excluded in an options file OPTIONS qualifier and files excluded using the IGNORE qualifier FILES file spec The FILES qualifier modifies the list of files to be defragmented FREQUENT file specf NOFREQUENT default The FREQUENT qualifier indicates files to be considered frequently accessed when final file placement decisions are made Frequent files are placed toward the center of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not
82. 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 LOCATION file spec NOLOCATION The LOCATION qualifier shows 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 OUTPUT file spec OUTPUT SYS OUTPUT default The OUTPUT qualifier may be used when showing the volume fragmentation state It directs the output of the SHOW subcommand to a file By default output is directed to SYS OUTPUT If output is directed to a filename without extension the file is given a default extension of lis STATISTICS default NOSTATISTICS The STATISTICS qualifier shows the volume fragmentation state It provides a summary of the file and free space fragmentation for the volume Refer to Appendix C for more information on this report 3 32 Using Defrag Examples DEFRAGME
83. of the defragmentation process once every minute until Callable Interface 7 23 DFG DEFRAGMENT This limit is no longer exceeded The defragmentation process priority is at the SYSGEN parameter DEFPRI minus 1 Momentary violations of this limit are ignored Depending on whether the DFG K NODE item descriptor is part of this item list the CPU limit can affect all nodes or only those listed as part of the DFG K NODE item descriptor Further if DFG K NODE is not present the value provided with DFG K _ SET CPU is assigned to every node in the scheduling database and becomes the default value for subsequent nodes not already in the database DFG K SET CPU can be the first item descriptor in an item list that optionally contains other DFG K SET XXXX item descriptors and an optional DFG K NODE descriptor The uses of the buffer length buffer address and return length address fields for the DFG K SET CPU item code are as follows buffer length Must be four buffer address Address of a longword buffer containing the unsigned maximum integral CPU percentage for defragment operations A value of zero imposes no limit return length address Not used must be zero DFG K SET IO 7 24 Callable Interface The DFG K_SET_IO item code sets the maximum direct I O rate per second available to a defragmentation process If a defragmentation process exceeds this limit the scheduler decrements the process priority
84. of the defragmentation process once every minute until e This limit is no longer exceeded e The defragmentation process priority is at the SY SGEN parameter DEFPRI minus 1 Momentary violations of this limit are ignored Depending on whether the DFG K NODE item descriptor is part of this item list the I O limit may affect all nodes or only those listed as part of the DFG K NODE item descriptor Further if DFG K NODE is not present the value provided with DFG K SET IO is assigned to every node in the scheduling database and becomes the default value for subsequent nodes not already in the database DFG K SET IO may be the first item descriptor in an item list that optionally contains other DFG K SET XXXX item descriptors and an optional DFG K NODE descriptor DFG DEFRAGMENT The uses of the buffer length buffer address and return length address fields for the DFG K SET IO item code are as follows buffer length Must be four e buffer address Address of a longword buffer containing the unsigned maximum I O rate for defragment operations If zero is specified no limit is imposed return length address Not used must be zero DFG K SET PROCESSES The DFG K SET PROCESSES item code limits the number of defragmentation processes that the scheduler starts on a given node If the number of defragmentation processes is greater than or equal to the process limit the scheduler does not start additional defragmen
85. on the volume is larger than INDEXF SYS To check the largest free space and extents of INDEXF SYS execute the following command DEFRAGMENT SHOW disk VOLUME LOCATION 000000 INDEXF SYS NOTFILWRERR error writing to temporary notification file Explanation The notification message could not be written User Action Refer to associated messages to determine a course of action NOTFOUND No AD were found AD Explanation No script or volume was found for an operation in DECwindows interface User Action Refer to associated messages to determine a course of action NOTLOCDEV AD is not local to AD Explanation The user has specified a target device that is not local to the node that is trying to run the defragmentation process User Action Nonlocal devices such as DFS mounted devices cannot be defragmented NOTMOUNT error mounting AD Explanation An attempt to mount a device for offline defragmentation failed User Action Refer to associated messages to determine if additional action is necessary NOTODSDEV AD is not an ODS 2 mounted device Explanation The user has specified a device for defragmentation that is not a mounted ODS 2 format volume User Action Specify an ODS 2 format volume NOTRAN error translating AD Explanation There was an error translating the supplied logical name User Action Define the indicated logical using the EXECUTIVE MODE and SYSTEM qualifiers Defragmentation Mess
86. option e Apply to abort the selected scripts and remain in the Abort Script option e Cancel to leave the Abort Script option without taking any action Figure 6 15 shows a list of scripts in the Abort dialog box Figure 6 15 The Abort Dialog Box amp Abort Optimization Select Script 3 DEFRAG 1 DKAQ DEFRAG 81 DK 300 EFRAG_ 1 DRKE0 EFRA amp G PISDKB200 x ee eel Pee The DECwindows Interface for Defrag Plus 6 27 The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume 6 5 Monitor a Script or Volume The Monitor menu allows you to select a script or volume for monitoring the defragmentation process You can view how the space is allocated on the full volume or on a partial volume in a sliding window Figure 6 16 Monitor Menu Disk File aptimizer for Gpen MS V2 File Optimize Script Monitor Report Options ope Volume Full volume Welcome to Disk File Optimizer Please make a menu selection to continua When selecting the Monitor option DFO displays two windows e A process statistics window showing process information for the defragmentation process Refer to Figure 6 18 and Table 6 6 A monitor map window showing free space and allocated space on the volume Refer to Figure 6 19 and Figure 6 20 This procedure describes how to monitor allocated space on a disk volume 1 Select the Monitor pull down menu 2 Select the means by which you want to monitor allocated space Se
87. process associated with that script 1 2 6 2 Scheduler The scheduler runs as a detached process A separate scheduler process is required for each node that executes the defragmentation process Thus if all defragmentation is done from NODE1 only one scheduler is required and it must execute on NODE 1 Conversely if the defragmentation work is spread across multiple nodes in a cluster multiple scheduler processes are required one on each node that executes the defragmentation process The scheduler process spends most of its time in the LEF state It comes out of the LEF state if any of the following events occur e A command is entered that requires scheduler functions e An existing defragmentation process completes A scheduled event occurs If a script is scheduled to execute and it may execute on the same node as the scheduler the scheduler initiates the defragmentation process 1 2 6 3 Defragmentation Process The defragmentation process is an independent detached process started by the scheduler It is dedicated to defragmenting the target volume or files The defragmentation process Provides the interface to the monitor e Aborts itself e Throttles itself e Executes preprocessing and postprocessing files e Time limits itself e Defragments files e Consolidates free space e Arranges files according to access patterns After initialization the defragmentation process performs its tasks in the following phases
88. returned in the order in which they will be executed DFG K SHOW SCRIPT Q REMAINING DFG DEFRAGMENT returns a VMS delta time string indicating how much time is left for the current execution of a script that was given a time limit with the DFG K TIME LIMIT descriptor If DFG DEFRAGMENT does not return a DFG K SHOW SCRIPT Q REMAINING item descriptor no time limit is imposed on the script The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length Length of the delta time specification in bytes e buffer address Address of the delta time specification DFG K SHOW SCRIPT Q START TIME DFG DEFRAGMENT returns a VMS absolute time indicating when the script will begin 1 minute intervals if the script is scheduled to begin in the future or it may indicate when the script started The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the time specification in bytes buffer address Address of the time specification TheDFG K SHOW SCRIPT Q START TIME item descriptor can occur only once per script DFG DEFRAGMENT DFG K_SHOW SCRIPT_Q STATUS DFG DEFRAGMENT returns a word indicating the current abort status of the defragmentation process associated with the script The following values may be returned e DFG K_ABORT_NOT_ISSUED An abort operation is pending but has not yet been issued
89. sure to install the scheduling database on a volume common to all DFO licensed nodes in the cluster A common volume must be mounted with the CLUSTER qualifier The default is to place the scheduling database on the system volume This will work only if this volume is accessible to all nodes If you have already installed DFO and need to move the scheduling database to a more appropriate volume us the following steps 1 Stop the schedulers on all nodes in the cluster using the following command on each node SYSSSTARTUP DFGSSTOP_SCHEDULER 2 Create a directory on an appropriate volume 3 Copy the files from the old directory to the new directory and delete the old files 4 Edit SYS STARTUP DFG STARTUP COM and change the DF G DATABASE and DFG MAIL ADDRESS logicals to point to the new directory CALL DEFINE LOGICAL DFGSDATABASE new volume new directory CALL DEFINE LOGICAL DFGS MAIL ADDRESS new volume new directory DFGS MAIL DIS 5 Restart the schedulers using the following command on each node of the duster SYSSSTARTUP DFGSSTART_SCHEDULER 2 5 3 Locally Mounted Volumes For locally mounted volumes you must consider license requirements and scheduling script creation To defragment volumes that are locally mounted you must have a DFO license for that node Also when creating a scheduling script for that volume you must specified the node that the volume is mounted on The following is a example of specifying
90. the call to show a script This function has an item list interface with the structure shown in Figure 7 5 Figure 7 5 Function Item List Interface 4 4 4 4 Item Code Buffer Length Buffer Address 4 Return Length Address 4 VMS Usage cond value type item_list_3 t access read only mechanism by reference Buffer Length Must be zero Item Code Indicates the code that was used when DFG UPDATE DATABASE allocated memory Disk File Optimizer software allocates memory only on DFG K_SHOW_ SCRIPT item codes Buffer Length Address Address of the longword that was written by DFG DEFRAGMENT when the memory was allocated It contains the size of the buffer in bytes Callable Interface 7 39 A Answers to Frequently Asked Questions This appendix contains frequently asked questions about the Disk File Optimizer DFO If the system crashes will DFO corrupt files No DFO uses only published OpenVMS interfaces to the file system to accomplish its tasks Data integrity is guaranteed by these interfaces Further the file optimizer never modifies nor accesses user data If an on going defragmentation operation is interrupted by a system crash the volume may be left in a non optimal state that is files may not be as defragmented as they could be and they may not be placed
91. the low end This is shown in Example C 3 Average number of file extents per file the 1 065 number is excellent In conclusion this volume is in great shape except it is very full DEFRAGMENT SHOW Command Report C 7 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command C 3 2 User Volume With System Log Files Example C 4 shows an output from the SHOW command for a user volume with system log files on it Example C 4 User Volume With System Log Files DEFRAGMENT SHOW 3SDUA1 VOLUME HISTOGRAM Disk File Optimizer for OpenVMS DFG 2 6 2001 Compaq Computer Corporation Fragmentation Report DISKSUSER DISK 04 APR 2001 11 42 51 80 The fragmentation index is 83 4 1 1 20 9 is excellent 21 40 9 is good 41 60 9 is fair 61 80 9 is poor 81 100 indicates a badly fragmented disk Approximately 63 4 out of 80 0 possible is due to file fragmentation 2 Approximately 20 0 out of 20 0 possible is due to freespace fragmentation 3 Freespace Summary Total free space 104613 blocks Percentage free 4 rounded 4 Total free extents 303 5 aximum free extent 13980 blocks LBN 2057343 inimum free extent 3 blocks LBN 541440 Average free extent 345 blocks 6 edian free extent 27 blocks File Fragmentation Summary umber of files with some allocation 11145 Total file extents on the disk 21649 Average number of file extents per file 1 942485 7 edian number of file extents per f
92. the same files This logical is set to 10 000 blocks by default You can change it by editing SY SSSTARTUP DFG STARTUP COM and then executing the command procedure 3 3 Wildcard Character Use The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume 3 4 Examples Using Defrag This section provides some general examples of what you can do with the Defrag software Additional examples are shown for each command in Section 3 5 Using Defrag 3 5 Using Defrag 3 4 Examples Using Defrag 3 4 1 Creating Log Files Log files are created using the LOG qualifier There are two types of log files e Brief Full Brief log files provide an abbreviated description of events that occur during a defragmentation operation Brief log files are the default log file type Full log files provide an extended version of events that occur during defragmentation operations Full log files are obtained by specifying FULL Examples of brief and full log files can be found in Appendix D and Appendix E respectively The command shown in the following example creates a full log file DEFRAGMENT VOLUME DISKSONE LEVEL 2 LOG DISKSONE_ANA LOG FULL In log files the symbols preceding a file
93. to 0 the existing start time is removed from the script e DFG V INHERIT DORMANT When set to 1 the dormant file list of the script can be modified When reset to 0 the dormant file list is removed from the script e DFG V INHERIT EXCLUDE When set to 1 the exclude file list of the script can be modified When reset to 0 the exclude file list is removed from the script Callable Interface 7 19 DFG DEFRAGMENT e DFG V INHERIT FILE When set to 1 the file or list of files to be defragmented can be modified When reset to 0 the file list is removed e DFG V INHERIT FREQUENT When set to 1 the frequent file list of the script can be modified When reset to 0 the frequent file list is removed from the script e DFG V INHERIT INTERVAL When set to 1 the interval of the script can be modified When reset to 0 the interval is removed from the script e DFG V INHERIT LOG When set to 1 the log file specification of the script can be modified When reset to 0 the log file specification is removed from the script e DFG V INHERIT NODE When set to 1 the node list associated with the script can be modified When reset to 0 the node list is removed from the script e DFG V INHERIT OPTIONS When set to 1 the options file specification of the script can be modified When reset to 0 the options file specification is removed from the script e DFG V INHERIT POST PROC When set t
94. tool software including associated documentation is the property of and contains confidential technology of Compaq Computer Corporation Service customer is hereby licensed to use the software only for activities directly relating to the delivery of and only during the term of the applicable services delivered by Compaq or its authorized service provider Customer may not modify or reverse engineer remove or transfer the software or make the software or any resultant diagnosis or system management data available to other parties without Compaaq s or its authorized service provider s consent Upon termination of the services customer will at Compaq s or its service provider s option destroy or return the software and assodated documentation in its possessi on Printed in the United States of America This document was prepared using VAX DOCUMENT Version 2 1 PTAC Cras Fae oak ee ea ee a te a eae ste ae ts x te aes 1 Overview of the Disk File Optimizer 1 1 1 2 1 2 1 1 2 2 Introd ctlon dues mee ee RI eb EH d x P Ee ecd EE EE x Product Description ass isi m ERR mix ees Operational Goals Features ccc cee eee User Interface Programming Interface Operational Overview Defragmentation Process Prologue and EpilogueFiles Operational Summary Scheduling Defrag PLUS Contents Scheduling Database and Database Interface Scheduler Defragme
95. where they would have been placed had the file optimizer completed However when the system is brought back up files on that volume are accessible and will not have suffered any integrity problems Does DFO change the modification date on the file No No dates in the file header are changed How do I create a scheduling script Refer to Section 2 6 2 for information on how to create scheduling scripts Will DFO run on my database disk Rdb for example Yes f the database is open DFO does not defragment the database file If the database is closed DFO treats the database file as any other file How do I check if the scheduler is running Use the following command to check if the scheduler is running on a node SHOW SYSTEM OUTPUT X X SEARCH X X DFG If the scheduler is running you will see DF G node name as shown below 218002A8 DFGSLUNTIC LEF 6 4091 0 00 01 03 21 1263 1781 How can tell if a defragmentation process is running If you are using Defrag PLUS you can use the command shown in Example A 1 to see if the defragmentation process is running If you are using Defrag or Defrag PLUS you can use the command shown in Example A 2 to see if a defragmentation process is running How do I monitor the progress of a defragmentation process Answers to Frequently Asked Questions A 1 Answers to Frequently Asked Questions Example A 1 Defrag PLUS Method DEFRAGMENT SHOW NAME RUNNING Disk File Optimizer for OpenVMS
96. 0 0 possible is due to file fragmentation Approximately 4 6 out of 20 0 possible is due to freespace fragmentation Freespace Summary Total free space 211072 blocks 2 Percentage free 10 rounded 3 Total free extents 23 4 aximum free extent 53316 blocks LBN 671852 5 inimum free extent 4 blocks LBN 730360 6 Average free extent 9177 blocks 7 edian free extent 584 blocks 8 File Fragmentation Summary umber of files with some allocation 5880 9 Total file extents on the disk 6366 10 Average number of file extents per file 1 082653 11 edian number of file extents per file 1 12 Most Fragmented File 13 VMSSCOMMON SYSEXE SYSSQUEUE_MANAGER QMANSJOURNAL 1 171 extents C 2 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 2 Output from the SHOW Command The following explains the report above 1 The fragmentation index is the relative index of the fragmentation state of the volume The index is made up of file fragmentation 80 and free space fragmentation 20 The value of 17 2 is an excellent fragmentation index The file fragmentation portion is a number based on how fragmented the files are If all files were contiguous this number would be 0 0 The freespace fragmentation is a number based on how fragmented the free space is If all free space could be consolidated into one area this number would be 0 0 As files are deleted or moved the free space becomes fragmented Refer to S
97. 000 CALL DEFINE LOGICAL DFGSWSQUOTA 2048 4 3 5 4 Defining the Transfer Size Logical The logical DFG TRANSFERSIZE helps you tune the Disk File Optimizer The definition of this logical allows you to change the amount of data that is transferred at one time On a volume that has files with large extents you could wait up to 20 minutes while the system transfers these large extents before you could access the file By defining this logical you could access this file in less than a minute This logical changes the impact that the Disk File Optimizer has on applications that are simultaneously accessing the same files This logical is set to 10 000 blocks by default You can change it by editing SY SSSTARTUP DFG STARTUP COM and then executing the command procedure 4 10 Using Defrag PLUS Using Defrag PLUS 4 4 Scheduling Defragmentation Operations 4 4 Scheduling Defragmentation Operations Defrag PLUS allows you to execute named scripts once every day at a specified time on a particular date or according to any periodic interval You cannot however define a single script to run Monday at 4 00 Tuesday at 7 00 and Friday at 9 00 To do this you would either have to modify the script daily or create three scripts Consider the following suggestions when determining the best time to run the defragmentation process e Schedule defragmentation during periods of low user activity This step ensures the defragmentation pro
98. 100 DEFRAG 28DR B300 DEFRAC AMENDS FILES DEFRAG BACKUP 1 DK B200 DEFRAG BACKUP 18DK B500 DEFRAG DORMANT 13DK B200 Selection Select a script from the script list selection box 4 Select either the Apply or the OK button to bring up the Modify Script dialog box 5 From this point on follow the same procedure as if you were creating a script These procedures are described in the Section 6 4 1 1 Section 6 4 1 2 and Section 6 4 1 3 6 20 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 3 Remove a Script This option allows you to remove scripts from the database Use the following procedure to remove a Script 1 Select the Remove Script option of the Script pull down menu Figure 6 11 The Remove Script Dialog Box DEFRAG 1 DK AD DEFRAG 1 DK A1D0 2 Select the scripts from the Script List see Figure 6 11 Point to and dick on the script names in the list to mark that you wish to remove them 3 To complete the remove dick on e OK to remove the selected script s and exit the Remove Script option e Cancel to leave the Remove Script option without taking any action e Apply to remove the selected script s and remain in the Remove Script option The DECwindows Interface for Defrag Plus 6 21 The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 4 Show a Script The Show dialog box provides three ways of sorting th
99. 12 DFG K PREDECESSOR item descriptor 7 21 DFG K PRE PROCESS item descriptor 7 12 DFG K REMOVE item descriptor 7 22 DFG K SCH FLAGS item descriptor 7 22 DFG K SCRIPT item descriptor 7 23 DFG K SET CPU item descriptor 7 23 DFG K SET IO item descriptor 7 24 DFG K SET PROCESSES item descriptor 7 25 DFG K SHOW CPU item descriptor 7 25 DFG K SHOW IO item descriptor 7 26 DFG K SHOW PROCESSES item descriptor 7 27 DFG K SHOW SCRIPT item descriptor 7 28 DFG K START item descriptor 7 36 DFG K TIME LIMIT item descriptor 7 36 DFG K VOLUME item descriptor 7 13 include files 7 1 item descriptor fields 7 5 linking with 7 1 return values 7 37 DFG K SHOW SCRIPT freeing memory 7 39 DFG RELEASE_ MEMORY description 7 39 DFG RELEASE MEMORY routine 7 39 compiling programs with 7 1 include files 7 1 linking with 7 1 DFGNOSTART F 9 DFGSTART F 9 DFGTMO F 9 dfg_list item codes 7 6 DIOOUTRNG F 9 Directories keeping fragmentation toa minimum 2 1 truncating A 5 DIRVERERR F 9 DISABLED F 9 DISFAIL1 F 9 DISFAIL2 F 10 Disk File Optimizer features 1 2 operational overview 1 5 product description 1 1 DISKFULL F 10 Dormant files 7 6 DSDCMDO F 10 DSDSCRF1 F 10 DSDSCRF2 F 10 DSDSCRO1 F 10 DSDSCRO2 F 10 Dump utility 1 12 DUPDEFRAGER F 10 DUPSCHED F 10 DUPSCRPT F 11 E EMPDFG F 11 EMPDFGSCH F 11 ENABLED F 11 ENAFAIL1 F 11 ENAFAIL2 F 11 ENGLIMEXC F 11 ENGMAXTIM F 11 ENQL
100. 12 HIGHPRIO F 12 IDXCHANG F 12 IDXFILEFULL F 13 IDXOPT F 13 IEDBDATA F 13 IELOGNAM1 F 13 IESCHFILNODTYP F 13 IESCHFUNC F 13 IESCHIMPOSS F 13 IESE1 F 13 IESRCINCONSIS F 13 IEVERNOD1 F 13 IMEDALL F 13 IMEDSUCC F 14 INHERCONT F 14 INHERINTCONT F 14 INHERINTPRED F 14 INHERPRED F 14 INTCONT F 14 INTERNALERR F 14 INTERR F 14 INTERR2 F 14 INTPRED F 15 INVDEV F 15 INVDEVCONT F 15 INVDEVNAM F 15 INVDFGLST F 15 INVDSLST F 15 INVFILNAM F 15 INVITEMCOMB F 16 INVITM F 16 INVITMLST F 16 INVITMUKN F 16 INVLMFLIC F 16 INVLOGNAM F 16 INVSCHLST F 16 INVSCRNAM F 16 INVSTARTCMD F 17 INVSTRDSC F 17 INVSTRDSCNBR F 17 L5NOLOG F 17 LIMEXC F 17 LSTBADVOL F 17 LVLOUTRNG F 17 MDNOTFOUND F 17 MISSING LOGICAL F 17 MISSNGVAL F 18 Index 4 Error Messages cont d MODIFIED F 18 MONBRKNDB F 18 MONINVCOL F 18 MONINVROW F 18 MONNOVOL F 18 MONPRIV F 18 MONRDERR F 18 MONUNEXP F 19 MONWRERR F 19 MOREINFO F 19 MOVFILINFOI1 F 19 MOVFILQIOERR F 19 MOVFILSTSERR F 19 MULTSUCC F 19 NOABOJ F 19 NOABOS F 20 NODEIGNOR F 20 NODELFIL F 20 NOFILE F 20 NOINHER F 20 NOKILL F 20 NOLOOKUP F 20 NOMEINTERFACE F 20 NONODE F 21 NONOTIFY F 21 NOPRED F 21 NOPRIV F 21 NOQENTRY F 21 NOREMSCH F 21 NOREMSCR F 22 NOSCHED F 22 NOSCRIPT F 22 NOSCRNAM F 22 NOSHODAT F 22 NOSPECFILE F 22 NOTACCVIO F 22 NOTBADDATA F 22 NOTCLOSERR F 22 NOTDISK F 22 NOTERM F 23 NOTEXEC
101. 19 Defragmentation Full Volume Map Window sees 6 33 6 20 Defragmentation Partial Volume Map Window 6 35 6 21 Report Menu wa siama teine deg ae edi ae hag Pa Re eke we eed 6 36 6 22 Report Graphics Full Volume Map 0 0000 ese 6 37 6 23 The Report Volume Selection Dialog Box 00000 6 40 6 24 Report Volume Statistics 0 000 6 42 6 25 Report Volume File Fragmentation Histogram 6 42 6 26 Report Volume Volume Space Histogram 000 0 eee 6 43 6 27 Options Menu 1 2 nn 6 44 6 28 Set Process Dialog BOX 1 2 cee 6 45 6 29 The Show Process Limits Dialog Box 0000 eee 6 47 7 1 ITEM LIST 3 Descriptor o aret oe poer dda RERO 7 5 7 2 Creating a DFG K_XXXX Item with Descriptor List 7 7 7 3 Flags and Inherit Enables siisii iui aia iaeia a at ani a a a i 7 9 7 4 Show Script Data Buffer u cesce sisine ecir ie a a e n a 7 29 7 5 Function Item List Interface llle 7 39 Tables 1 1 FEAU ppp Or TTITTTTET 1 2 1 2 Disk File Optimizer Command Summary 0 0000 1 3 2 1 Script Scheduling Polides ssai iie iesi a a aon a aa iaaii 2 9 3 1 Defrag Command Summary lees 3 7 4 1 Sample Time Interval iz sais ai 0000 cece 4 8 4 2 Defrag PLUS Command Summary 000000 ees 4 12 5 1 Define Dialog Box Fields 0 0 0 cece ees 5 6 5 2 Translations of Operations to DCL Command LEVEL x
102. 2 The following list summarizes the keystrokes that manipulate the monitor displays e Ctrl C Ctrl Y or Ctrl Z exit the monitor e Ctrl W refreshes the screen and erases the message display e N or Next Screen switches to the next display e Por Previous Screen switches to previous display e R or Remove removes the message display e Ctrl T scrolls through the broadcast messages Using Defrag 3 25 DEFRAGMENT MONITOR Restrictions None Qualifiers CONTINUOUS default NOCONTINUOUS The CONTINUOUS qualifier provides a continuous monitor display The NOCONTINUOUS provides a snapshot display and then exits to the DCL prompt Examples The following example shows how to invoke the monitor 1 DEFRAGMENT MONITOR DISKSONE NOCONTINUOUS In this example the defragmentation process executing against DISK ONE is monitored Since the NOCONTINUOUS qualifier was specified the monitor function samples the defragmentation process statistics and the free space on DISK ONE one time before exiting to the DCL prompt 3 26 Using Defrag DEFRAGMENT OFFLINE_VOLUME DEFRAGMENT OFFLINE_VOLUME The OFFLINE VOLUME subcommand defragments the INDE XF SYS file on the specified offline volume according to the defragment command line qualifiers Format EPILOGUE LOG brief only DEFRAGMENT OFFLINE VOLUME volume name OPCOM NOTIFICATION PROLOGUE WAIT Param
103. 4 APR 2001 11 100 0 0 0 100 04 APR 2001 11 51 blocks 96 blocks 6 741 blocks 868650 1755 blocks 5283 blocks 34431 blocks 1282092 643566 blocks 750 867897 blocks 04 APR 2001 11 04 APR 2001 11 phase one the following 52 44 90 06 57 49 06 57 76 20 27 04 20 27 09 continued on next page Full Log File Example Example E 1 Cont Full Log File Blank file has d file has file has D file has Dd file has D file has D file F file has Fd file has Px file has F file oved file has EMPTY FAIL 5 IN USE new disk OPEN file was OMOVE file may UNAVL file was d DISKSJ d DISKSJ d DISKSJ End file defragmentation phase one Statis Nu Nu Nu Nu Nu Begin free space consolidation tics mber mber mber mber mber been preprocessed for defragmentation been defragmented been partly defragmented been placed for dormant access been defragmented and placed dormant been placed dormant and been partly defragmented could not be placed dormant been placed for frequent access been defragmented and placed frequent been placed frequent and been partly defragmented could not be placed frequent been moved number of extents unchanged file was empty no action taken file s fragmentation cannot be reduced space for file was in use no action taken open no action taken not be moved no action taken unavail
104. 5 is selected the LEVEL 22 candidate file specifications are listed in the full log file LOG z 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 Using Defrag PLUS 4 71 DEFRAGMENT VOLUME 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 NODEz 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 OPCOM NOTIFICATION default NOOPCOM NOTIFICATION The OPCOM NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM OPTIONS f file spec NOOPTIONS default The OPTIONS qualifier provides an alternate method for
105. ADDATA invalid data found in AD Explanation This is an internal error It occurs if one of the internal user notification routines is called with invalid data User Action Submit an SPR NOTCLOSERR error dosing temporary notification file Explanation An error occurred while dosing the temporary notification file User Action Refer to associated messages to determine a course of action NOTDISK this device is not a disk recheck the device name Explanation The device for which you requested defragmenting is not a disk User Action Check the device name and try the command again F 22 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages NOTERM Terminal type unsupported for monitor use a supported type Explanation The terminal type is not supported for monitoring functions User Action Set the terminal type to a supported type such as VT 100 NOTEXEC script AD not executing Explanation An attempt was made to abort a script that was not executing User Action None NOTEXTEND error extending the scratch file needed for defragmenting INDEXF SYS Explanation The temporary scratch file needed to defragment INDEXF SYS could not be created Its creation would have caused a multi header entry or there was not enough space on the volume User Action Before defragmenting INDEXF SYS be sure to defragment the volume and consolidate free space Also make sure that the largest free space
106. AGMENT MODIFY script name PROLOGUE DFGSDATABASE ABORT SUN MON COM A 4 Answers to Frequently Asked Questions Answers to Frequently Asked Questions command procedure to abort the execution of a script on Sunday and Monday The command procedure must be executed as a PROLOGUE file from a script get today 1 today f cvtime TODAY WEEKDAY if today is Sunday or Monday then abort the script if today eqs Sunday or today eqs Monday then script name f trnln DFGSSCRIPT defragment abort script name endif 8 How can I truncate directories Some users have directories with large allocated unused blocks after files have been deleted This results in the need to truncate these directories DFO does not provide this feature because it is already available using the OpenVMS DCL command SET FILE TRUNCATE file_name DIR The following shows an example using the SET FILE TRUNCATE command to truncate a directory by deleting the unused blocks DIRECTORY SIZE ALL DIR SIZE ALL SLICK MAIL DIR Directory DSA422 SLICK MAIL DIR 1 115 140 SET FILE TRUNCATE SLICK MAIL DIR DIR SIZE ALL SLICK MAIL DIR Directory DSA422 SLICK MAIL DIR 1 115 116 Total of 1 file 115 116 blocks Notice in the above example that the directory is 140 blocks in size but the end of file is at block 115 The directory is then truncated to 116 blocks with the SET FILE TRUNCATE comm
107. AL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 1 DKA0 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DKA100 SCRIPT DEFRAG 1 DKA100 INTERVAL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 1 DKA100 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DKB0 SCRIPT DEFRAG 1SDKBO0 INTERVAL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 1 DKB0 MAIL NOOPCOM NOTIFICATION Xr Xr X Getting Started 2 13 System Administrator s Guide This part of the manual contains information that the system admininstrator needs to install and operate the Disk File Optimizer software to keep the system running smoothly 3 Using Defrag 3 1 Introduction This chapter explains how to use the Defrag variant of the Disk File Optimizer to defragment files and disks It contains the following sections e General guidelines for using the Defrag software Examples illustrating how to use the Defrag software The Defrag command set e Defrag command reference material in a format similar to that of the OpenVMS DCL Dictionary Manual 3 2 Defrag Capabilities The Defrag variant of the Disk File Optimizer software provides capabilities to defragment files and volumes but not for scheduling and storing information about the defragmentation operations To schedule defragmentation operations you can create a batch file to define defragmentation operations or you can use a scheduling p
108. ALL and SYSPRV are required to show volume fragmentation Explanation The user has insufficient privileges to show the fragmentation state of a volume User Action Set the READALL and SYSPRV privileges or the BY PASS privilege and try the command again SRNOTFOUND No scripts were found to be running Explanation No scripts were found to be running User Action Only scripts that are running can be monitored or aborted Start a script STAFAIL failed to start AD Explanation DFG DEFRAGMENT returned a failure status for a START subcommand This is a summary message and probably does not indicate any real error Most likely the script was already started Associated messages provide more detail User Action Refer to associated messages to determine a course of action Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages STARTED Start queued for script AD Explanation The specified script has been started User Action None STARTNOTDONE start command unsuccessful Explanation A START subcommand was unsuccessful This is a summary message This message may or may not indicate an error Associated messages provide more detail User Action Refer to associated messages to determine a course of action STARTSEEN start command for AD already issued Explanation A START subcommand had been issued for this script but it had not yet completed when another START subcommand for the same scrip
109. ATION DEFRAGMENT VOLUME 1 DUA14 SCRIPT DEFRAG 1 DUA14 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA14 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA63 SCRIPT DEFRAG 1 DUA63 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA63 MAIL NOOPCOM NOTIFICATION The volume that is locally mounted on LUNTIC is 1 DKA130 The disk is not used that much so it is scheduled once a week The following shows part of LOAD DB COM that would create a script for this volume Getting Started 2 11 Getting Started 2 7 Example Scheduling Scripts for a VMScluster DEFRAGMENT VOLUME S 1 DKA130 SCRIPT DEFRAG_ 1 DKA130 INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DKA130 NODE LUNTIC MAIL NOOPCOM NOTIFICATION The last group of volumes are the disks used for the software builds each night 1 DUA2 and 1 DUA3 The goals are to Start the scripts at 6 a m to avoid the nightly software builds Lower the priority of the defragmentation process to minimize user impact or optimize system resources Run the defragmentation process on the Alpha system and the fastest VAX system The following shows part of LOAD DB COM that would create scripts for these volumes Xr DEFRAGMENT VOLUME 1 DUA2 SCRIPT DEFRAG 1SDUA2 INTERVAL 1 00 00 AFTER 06 00 FULL PRIORITY DEFAULT 1 MINIMUM 0 LOG DFGSDATABASE DEFRAG
110. Action None Defragmentation Messages F 31 Defragmentation Messages F 2 Disk File Optimizer Messages F 32 VIRMEMERR device is a member of a constituent set specify the set name Explanation The user attempted to defragment a virtual member of a disk Set such as a stripeset member User Action Defragment the entire set by specifying the set name on the DEFRAGMENT command line VNOTFOUND No volumes were found being defragmented Explanation No volumes were found being defragmented User Action Only volumes those being defragmented can be monitored Start a defragmentation process on this volume VOLDIFF AD indicates a different device than previously parsed file specifications Explanation This error occurs if the FILE command contains file specifications that reference different devices The FILE subcommand requires all files to indicate the same device User Action Modify the appropriate file specifications so that all of them reference the same disk device VOLFAIL1 volume command failed script AD was not entered into the database Explanation The specified script was not entered into the database Some portion of command validation failed The exact nature of the error is provided in associated messages User Action Refer to associated messages to determine a course of action VOLFAIL2 volume command failed unnamed script was not entered into the database Explanation The command was not entered into
111. CLOSEIN F 5 CLOSEOUT F 5 Cluster definition of 1 8 Cluster size keeping fragmentation toa minimum 2 1 CMDUNKNOWN F 5 Commands See DEFRAGMENT commands common scheduling database VMScluster System 2 4 Index CONNECTERR F 5 CONSFAIL F 5 COPYERR F 5 CPUOUTRNG F 5 CPU percentage See DEFRAGMENT commands SET See DEFRAGMENT commands SHOW See DFG K_SET_CPU item code See DFG K_SHOW_CPU item code CREATED F 5 CREATEERR F 5 Creating scheduling scripts 2 5 6 5 Creating scheduling scripts defragmentation jobs 2 5 2 7 6 5 CREPRCFAIL F 5 CRESECFAIL F 6 D Database interface 1 7 re creating 4 7 saving contents 4 7 DATA_CHECK improving I O performance 2 3 DBACCCONSTR F 6 DBACCDUP F 6 DBACCERR F 6 DBACCERR2 F 6 DBACCW F 6 DBACCW2 F 6 DBACTRANS F 6 DBBUSY F 7 DBCANTREAD F 7 DBCANTWRITE F 7 DBCLEAR F 7 DBCLEARED F 7 DBCOMMIT F 7 DBCREATE F 7 DBCREATED F 7 DBINCOMPAT F 8 DBINVXLNAM F 8 DBNOREC F 8 Index 1 DBNOTRANS F 8 DBROLLBACK F 8 DBUPDATERR F 8 DEACCESSERR F 9 DECps database 3 3 4 8 DE Cwindows file menu 5 2 6 2 initial window 5 1 6 1 monitor menu 5 15 optimize menu 5 3 6 2 aborting optimize processes 5 14 optimize files 5 13 optimize volume 5 3 define optimize parameters 5 3 restrict special files 5 8 schedule 5 12 optimize volume index file 5 14 script menu 6 5 starting 5 1 6 1 Define optimize parameters 5 3 Defrag commands 3 8
112. Cjriles in Hotfile Database i Dormant Files i Frequent Files Exclude or t In Options File Place Files You can exclude files such as Files placed by the User e RMS Indexed Files e Excluded Files You can also exclude the following types of Place Files Files in the hotfile database e Dormant files Frequent files The DECwindows Interface for Defrag Plus 6 13 The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 3 Restrict File of Dialog Box Fields Field Description Script Name Identifies the name of the script Files Placed by User Select this button if you wish to ignore explicitly placed files This has the same effect at the IGNORE PLACED DCL qualifier RMS Indexed Files Select this button if you wish to ignore RMS indexed files Excluded Files The Exclude Files option specifies files to be excluded from processing You may enter a file name in the file field or use the file list button to bring up a list of files to select from 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 The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for
113. DFGS DEFRAGMENT queues remove requests for all scripts DFG K SCH FLAGS 7 22 Callable Interface The scheduler flags control the scheduler mode continuous or scheduled and command type DEFRAGMENT FILE or DEFRAGMENT VOLUME of this script When the DFG K _ SCH_FLAGS item descriptor is created the buffer associated with it must be DFG S SCH FLAGS x 2 bytes in size The first half of the buffer specifies the flag values desired if any The second half is zero unless the script is inheriting characteristics from another script that is the DFG K INHERIT item descriptor is part of this list If a DFG K INHERIT item descriptor is part of this item list then the second half of the flags buffer becomes an inherit enable mask where each set bit corresponds to a flag whose value should be inherited from the DFG K INHERIT script To inherit a flag value from the specified DF G K_INHERIT script set the mask in the second half of the SCH FLAGS buffer corresponding to the field you want to inherit To inherit the continuous flag from DFG DEFRAGMENT the DF G K_INHERIT script assign the second longword of the SCH_FLAGS the value of DFG M_CONTINUOUS Figure 7 3 illustrates this concept The following mask bits are defined e DFG M_CONTINUOUS When set 1 the script runs in continuous mode After completing one defragment job the scheduler begins a new one immediately with the same script When reset 0 the script does not ru
114. DFO gt EXIT This command exits the user from the Disk File Optimizer utility and returns the user to the DCL prompt Using Defrag 3 13 DEFRAGMENT FILE DEFRAGMENT FILE The FILE command defragments the files specified on the command line according to the DEFRAGMENT command line Use this command to defragment a small number of files To defragment a large number of files use the DEFRAGMENT VOLUME command BRIEF CONSOLIDATE_FREESPACE CPU_LIMIT DORMANT EPILOGUE EXCLUDE FREQUENT FULL HOTFILE_DATABASE IGNORE lO LIMIT LEVEL LOG OPCOM_NOTFICATION OPTIONS PRIORITY PROLOGUE RVN TIME LIMIT IWAIT WRITE CHECK The file spec parameter identifies the files to be defragmented You may use Format DEFRAGMENT FILE file spec Parameters file spec wildcards for the file specification Description The DEFRAGMENT FILE command defragments the specified files according to the selected command line qualifiers When you specify a file name without the the device and or directory the defragmentation software operates on files in the current directory on the current device You must explicitly specify the device and directory name for files not in the default directory The defragmentation process begins immediately Restrictions e The LOG qualifier is required with LEVEL 5 BRIEF and FULL cannot be used concurrently 3 14 Using Defrag Qualifiers DEFRAGMENT FILE
115. Disk File Optimizer for OpenVMS Guide to Operations Order Number AA PGYHK TE This manual contains updated information about the Disk File Optimizer for OpenVMS software Software Version Version 2 6 Compaq Computer Corporation Houston Texas May 2001 Compaq Computer Corporation 2001 All rights reserved Compaq the Compaq logo VAX and VMS Registered in U S Patent and trademark Office OpenVMS and Tru64 are trademarks of Compaq Information Technologies Group L P in the United States and other countries Motif and UNIX are trademarks of The Open Group in the United States and other countries All other product names mentioned herein may be trademarks of their respective companies Confidential computer software Valid license from Compaq required for possession use or copying Consistent with FAR 12 211 and 12 212 Commercial Computer Software Computer Software Documentation and Technical Data for Commercial Items are licensed to the U S government under vendor s standard commercial license Compaq shall not be liable for technical or editorial errors or omissions contained herein The information in this document is provided as is without warranty of any kind and is subject to change without notice The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products Nothing herein should be construed as constituting an additional warranty Compaq service
116. E NODE In this example MYNODE is removed from the database Using Defrag PLUS 4 55 DEFRAGMENT SET DEFRAGMENT SET Format Parameters Description Restrictions Qualifiers The SET subcommand defines or changes the value of the defragmentation process limits DEFRAGMENT SET parameter valuef 3 NODE keywords e CPU LIMIT specifies the percent of CPU usage for any one defragmentation process The CPU percent is the percent of a single CPU e O LIMIT specifies the maximum direct I O rate per second of any one defragmentation process e PROCESS LIMIT specifies the maximum number of defragmentation processes per node The CPU and I O limits levels when exceeded cause the scheduler to decrement the process priority level of the defragmentation process once every minute until e The limits are no longer exceeded The defragmentation process priority is at the SYSGEN parameter DEFPRI minus 1 Defragmentation processes have a base priority equal to the SYSGEN parameter DEFPRI or the current priority of the scheduler whichever is greater If there are more than the specified number of defragmentation processes running on any of the given nodes when the PROCESS LIMIT is set the excess processes are allowed to continue However new processes are not started until the number of executing defragmentation processes drops below the PROCESS LIMIT value Enter values for CPU LIMIT as integers ran
117. E subcommand defragments the specified volume according to the selected command line qualifiers This command may be permanently added to the scheduling and parameter database as a script If no script name is specified using the SCRIPT qualifier the defragmentation software generates a unique script name of the form DF G SCRIPTX X where X is a hexadecimal number This number is chosen to keep all script names unique Names beginning with DFG are reserved for use by the defragmentation software Once the defragmentation command line is entered in the database it is eligible for execution according to its scheduling parameters If no scheduling information is provided the script begins executing immediately and executes only once 4 66 Using Defrag PLUS DEFRAGMENT VOLUME By default script definitions remain in the scheduling database until their associated defragmentation process completes However a script is permanently added to the scheduling database if it is named as a predecessor by another script or if any of the following qualifiers are present on the DEFRAGMENT VOLUME command line Restrictions Qualifiers SCRIPT cript name INTERVAL delta ti me PREDECESSOR 6cript name A script that has the CONTINUOUS qualifier may not be named as the predecessor of another script If you specify the INTERVAL qualifier the PREDECESSOR qualifier is not allowed If LEVELS is selected the LOG qualifier is required D
118. E subcommand makes the specified script ineligible for execution The script remains disabled until reactivated using the ENABLE subcommand Disabling a predecessor script automatically disables any scripts that are successors Disabling an already disabled script has no effect however an informational message is issued Restrictions The script name parameter is not allowed if the ALL qualifier is used Qualifiers ALL NOALL default The ALL qualifier disables all scripts in the scheduling and parameter database Examples The following example shows how to disable a script 1 DEFRAGMENT DISABLE MY SCRIPT In this example MY SCRIPT is disabled Using Defrag PLUS 4 19 DEFRAGMENT ENABLE DEFRAGMENT ENABLE The ENABLE subcommand reactivates scripts that have been disabled Format DEFRAGMENT ENABLE script name ALL Parameters script name The script name specifies the name of the scripts to be enabled You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification Description The ENABLE subcommand makes the specified script eligible for execution The specified script remains enabled until disabled by the DISABLE subcommand Enabling an already enabled script has no effect however an informational message is issued The ENABLE subcommand reacti
119. ED Ignores all RMS indexed files e NOINDEXED May defragment RMS indexed files e PLACED lIgnores all files with explicit placement flags set in their headers e NOPLACED May defragment files with explicit placement flags Files indicated by the I GNORE qualifier are added to the EXCLUDE list The default value IGNORE PLACED 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 lO LIMIT n NOIO LIMIT The IO LIMIT qualifier specifies the maximum direct I O rate per second of any one defragmentation process If the I O rate is exceeded the priority for the process drops to the minimum priority as specified by the PRIORITY qualifier or defaults to three LEVEL n LEVEL 2 default The defragmentation process selects files for defragmentation from among those not excluded based on the LEVEL qualifier 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 e LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels two and three is a candidate for defragmentation e LEVEL 2 default Any file whose extents cannot be completely mapped by the mapping window or that can be selected using level three is a ca
120. EFRAG 4 DIA1 NODE NROSIS MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA140 SCRIPT DEFRAG 1 DUA140 INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA140 NODE LUNTIC MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA54 X X Xr Xr 2 10 Getting Started Getting Started 2 7 Example Scheduling Scripts for a VMScluster SCRIPT DEFRAG 1 DUA54 INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA54 NODE NROSIS SENILE PRNOID MAIL NOOPCOM NOTIFICATION The next group is the user volumes One of the user volumes is a RAID set These volumes are mounted on all nodes in the cluster so defragmentation is not restricted The following shows part of LOAD DB COM that would create scripts for these volumes DEFRAGMENT VOLUME DPA1 SCRIPT DEFRAG DPA1 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG DPA1 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1SDUA11 SCRIPT DEFRAG 1 DUA11 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA11 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA12 SCRIPT DEFRAG 1 DUA12 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA12 MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA13 SCRIPT DEFRAG 1 DUA13 INTERVAL 1 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA13 MAIL NOOPCOM NOTIFIC
121. ELM 10 WSDEFAULT 512 WSEXTENT 16000 WSQUOTA 2048 3 2 6 2 SYSGEN Process Quotas The SYSGEN PQL_Mxxx process quotas are defined in SYSGEN You can change these dynamic PQL_Mxxx parameters in SYSGEN For more information on SYSGEN process quota values refer to the SYSGEN Generation Utility This list shows the POL M xxx parameters that affect the defragmentation processes PQL MASTLM PQL MBIOLM PQL MBYTLM PQL MDIOLM PQL MENQLM PQL MFILLM PQL MJTQUOTA PQL MPGFLQUOTA PQL MPRCLM PQL MTQELM PQL MWSDEFAULT PQL MWSEXTENT PQL MWSQUOTA 3 2 6 3 DFO Logical Process Quotas DFO provides logicals that allow you to define the process quotas for the defragmentation process These logicals are defined in SY SSSTARTUP DFG STARTUP COM When you install DFO these logicals are commented out By uncommenting the affected line and executing DFG STARTUP COM you can affect the quotas for the defragmentation processes For example if a disk containing a large database routinely encounters the insufficient virtual memory error INSVIRMEM during defragmentation increase the page file quota PGFLQUOTA to a value larger than the DFO default of 50 000 DEFINE SYSTEM EXECUTIVE MODE DFGSPGFLQUOTA 120000 3 4 Using Defrag Using Defrag 3 2 Defrag Capabilities These rules apply to setting process quota values e You cannot decrease a quota value below the system PQL minimum as defined by SYSGEN e You may decrease a DFO quota
122. F G DEFRAGMENT returned a failure status for a SET command User Action Refer to associated messages to determine a course of action Defragmentation Messages F 29 Defragmentation Messages F 2 Disk File Optimizer Messages F 30 SETNODFAIL a SET subcommand failed for node AD Explanation A DEFRAGMENT SET CPU I O or PROCESS command failed for the indicated node User Action Refer to associated messages to determine a course of action SETN Set parameters modified on AD Explanation Parameters have been modified on the given node User Action None SETSUCC specified parameters successfully set Explanation The database was successfully updated with the new CPU _ LIMIT IO LIMIT and PROCESS LIMIT values User Action None SHDWSETERR device is a member of a shadow set specify the shadow set name Explanation The user attempted to defragment a member of a shadow set Attempting to defragment members of a shadow set is not supported User Action Defragment the entire shadow set by specifying the shadow set name DUSXXX on the DEFRAGMENT command line SHODATMIS AD missing from show data Explanation This is an internal error User Action Submit an SPR SHOSCRFAIL a show script command failed Explanation A SHOW SCRIPT command did not complete successfully Associated messages provide more detail User Action Refer to associated messages to determine a course of action SHOVOLPRIV BYPASS or READ
123. Figure 7 2 return length address Not used must be zero DFG K LOG The defragment process uses the specified file for logging purposes All pertinent data determined by the DFG M FULL flag is written to this file which is opened for exdusive write The uses of the buffer length buffer address and return length address fields for the DFG K LOG item code are as follows e buffer length L ength of the LOG file specification string which has a maximum size of 255 bytes Callable Interface 7 11 DFG DEFRAGMENT buffer address Address of the buffer containing the file specification string for the LOG option The file specification string may not contain wildcard characters return length address Not used must be zero DFG K OFFLINE The uses of the buffer length buffer address and return length address fields for the DFG K OFFLINE item code are as follows buffer length Length of the volume name string which has a maximum size of 255 bytes buffer address Address of the buffer containing the volume name string return length address Not used must be zero DFG K OPTIONS The options file contains information about files that are dassified as frequent dormant or excluded The uses of the buffer length buffer address and return length address fields for the DFG K OPTIONS item code are as follows buffer length Length of the OPTIONS file specification string which has a m
124. IGNORE DEFRAGMENT VOLUME volume name IO_LIMIT LEVEL ILOG OPCOM_NOTFICATION OPTIONS PRIORITY PROLOGUE RVN TIME LIMIT WAIT IWRITE_CHECK Parameters volume name The volume name parameter is the name of the volume to be defragmented Description The VOLUME subcommand defragments the specified volume according to the selected command line qualifiers The defragmentation process begins executing immediately and executes only once Restrictions e The LOG qualifier is required if LEVEL is selected e BRIEF and FULL cannot be used concurrently Qualifiers BRIEF default NOBRIEF 3 36 Using Defrag DEFRAGMENT VOLUME The BRIEF qualifier has meaning only when the LOG qualifier is also present The BRIEF qualifier requests a brief log of all actions taken by the defragmentation process This log includes beginning and ending volume status information The BRIEF and FULL qualifiers are mutually exclusive and NOBRIEF produces the same result as FULL The BRIEF qualifier is the default CONSOLIDATE FREESPACE default NOCONSOLIDATE FREESPACE The CONSOLIDATE FREESPACE qualifier tells the Disk File Optimizer to use its free space consolidation algorithm CPU LIMITzn NOCPU LIMIT The CPU LIMIT qualifier specifies the percent of CPU resources to be used for any one defragmentation process If this percentage is exceeded the priority for the process drops to the minimum as speci
125. IPT default Examples 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 Any alphanumeric character e Underscoe e Hyphen e Dollar sign Observe the following rules when naming a script e You may use any combination of uppercase and lowercase letters e 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 Compaq Computer Corporation e You should not end a script name with a hyphen since the hyphen is the DCL continuation character The following examples illustrate how to use the OFFLINE VOLUME subcommand and its qualifiers 1 DEFRAGMENT OFFLINE VOLUME 1 DKB100 AY Wn it 17 AU HUY Ur XY XY Int 1 2 3 4 4 52 Using Defrag PLUS SCRIPT DEFRAG_OFFLINE_USER1 NOAFTER DISMOUNT CLUSTER 1 DKB100 OUNT OVER ID 1 DKB100 ANALYZE DISK_STRUCTURE 1 DKB100 DISMOUNT 1 DKB100 DEFRAGMENT START DEFRAG_OFFLINE_USER1 OUNT OVER ID 1SDKB100 ANALYZE DISK STRUCTURE 1SDKB100 DISMOUNT 1 DKB100 OUNT CLUSTER 1 DKB100 USER his example the f
126. If a defragmentation process fails successor scripts are not automatically started Use the START subcommand to start these successor scripts Restrictions None Qualifiers AFTER time NOAFTER default The AFTER qualifier keeps the script from starting 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 Examples The following example shows how to start a script 1 DEFRAGMENT START MY SCRIPT AFTER 16 30 In this example MY SCRIPT is started The AFTER qualifier stipulates that MY SCRIPT should start after 16 30 of the day this command is submitted If the script is periodic the period is unchanged Using Defrag PLUS 4 65 DEFRAGMENT VOLUME DEFRAGMENT VOLUME Format Parameters Description The DEFRAGMENT VOLUME subcommand defragments the volume named on the command line according to the defragment command line qualifiers AFTER BRIEF CONSOLIDATE_FREESPACE CONTINUOUS DORMANT EPILOGUE EXCLUDE FREQUENT FULL HOTFILE_DATABASE IGNORE INHERIT INTERVAL LEVEL ILOG MAIL_NOTIFICATION NODE OPCOM_NOTFICATION OPTIONS PREDECESSOR PRIORITY PROLOGUE RVN SCRIPT TIME LIMIT AWRITE CHECK DEFRAGMENT VOLUME volume name volume name The volume name parameter is the name of the volume to be defragmented The VOLUM
127. Interface for Defrag Plus 6 3 Optimize Menu Figure 6 3 Optimize Menu Disk Fila Optimizer for rpamv MS va Monitor Report Gptions Selected Files Volume dex File welcome to Disk File Optimizer Please make a menu selection ta continue 2 Select the target you wish to optimize e avolume e selected files e avolume index file The Create Script to optimize a Volume appears as in Table 6 1 3 To specify a script name type the script name in the script field box If you don t enter a script name this instance of the Disk File Optimizer application will assign a default script name for you that resembles DF G SCRIPT xxx where x is any hexidecimal character between 0 through F This default script will be deleted upon successful completion of the defragmentation process e Click on Reset to restore the content of all fields to their defaults Click on Inherit to browse a script list and select the script you wish to inherit properties from 4 Choose a Volume Selected Files or Volume Index File f you choose the Volume option enter a specific Volume name on the Volume insert line or dick on the volume list button to get a list of volumes to select from Refer to Figure 6 5 e If you choose the Selected Files option enter a specific file name on the file insert line or dick on the file list button for a list of files to select from Refer to Figure 6 6 e f you choose the Volume Index File opti
128. LM ES ES EO 3 S 3 LO S S BO 3 S BO NNUS Rose Ge es EUN QNO UAE M Ud Cop x Number of freespace extents of a given size Each corresponds to 1 freespace extent C 6 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command The following are numbers to note 1 7 Fragmentation index the 13 6 is an excellent number considering all of the non movable files on a system disk Non movable files are those installed files those files marked NOMOVE and those files that are open File fragmentation the 9 2 number is caused by files like the most fragmented file with 110 extents You cannot tell by this report but this file is open and DFO cannot defragment it Freespace fragmentation the 4 4 number is not bad for the system volume Notice that the total free extents are 22 These 22 extents are caused by all of the non movable files on the system volume Percentage free the 7 free space is low With only 7 free space the volume will tend to fragment faster and defragmentation will take longer It is time to clean up files or add another volume Total free extents the 22 free extents is a fairly good number This small number makes the free space fragmentation number small also Average free and median free extents the 6730 average and 1556 median shows the free space extents are not clustered around 6730 They are spread out and tend to be more extents around
129. LUMELOCKERR F 32 VOLUMENOTDONE F 32 VOLUNLOCKERR F 33 VPAEND F 33 VPATIME F 33 WRTERR F 33 XINHERIT F 33 Error notification B 2 Exduded files See DFG DEFRAGMENT routine DFG K_ EXCLUDE item descriptor See DFG DEFRAGMENT routine DFG K_ OPTIONS item descriptor See EXCLUDE qualifier See IGNORE qualifier See OPTIONS qualifier EXCLUDE qualifier 3 16 3 38 4 24 4 35 4 69 Extent definition of 1 11 EXTHDRERR F 12 F File concepts 1 8 File header 1 10 FileMenu 5 2 DECwindows interface 6 2 File metadata 1 8 File placement 3 3 4 8 dormant files 7 6 FILES qualifier 4 36 Flags See DFG DEFRAGMENT routine DFG K DFG FLAGS item descriptor See DFG DEFRAGMENT routine DFG K_ SCH FLAGS item descriptor Fragmentation CLUSTER SIZE 2 1 DIRECTORIES n 2 1 HEADERS n 2 2 INDEX MIDDLE 2 2 Fragmentation index calculation of C 16 Index 5 Fragmented files allocating 1 9 discovering 1 12 example of 1 8 FREEVMERR F 12 Frequent files See DFG DEFRAGMENT routine DFG K CLASSIFY FREQ item descriptor See FREQUENT qualifier FREQUENT qualifier 3 16 3 38 4 25 4 36 4 69 G GETDVIERR F 12 GETVMERR F 12 GLBSECMAPERR F 12 H Headers keeping fragmentation to a minimum 2 2 Help online 3 2 4 2 HIGHPRIO F 12 O performance DATA CHECK 2 3 improving 2 2 NOERASE ON DELETE 2 3 NOHIGHWATER MARKING 2 2 I O rate See DEFRAGMENT commands SET See DEFRAGMENT commands SH
130. NDOW 2n plus one is used This value lists all files that require at least one window turn to completely map FREE LIST NOFREE LIST default The FREE LIST qualifier is used to show the fragmentation state of the volume It lists the location and size of all of the freespace extents on the volume Using Defrag PLUS 4 59 DEFRAGMENT SHOW HISTOGRAM NOHISTOGRAM default The HISTOGRAM qualifier is used to show 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 LOCATION f file spec NOLOCATION The LOCATION qualifier is used to show 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 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
131. 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 OPCOM NOTIFICATION default NOOPCOM NOTIFICATION 4 38 Using Defrag PLUS DEFRAGMENT MODIFY The OPCOM_NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM OPTIONS file spec NOOPTIONS default The OPTIONS qualifier provides an alternate method for associating files with the DORMANT EXCLUDE or FREQUENT qualifiers If the list of files for any of these qualifiers is long you can create a separate file for this information Each record in the options file consists of a file name followed by one of the following keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e DORMANT File to be considered dormant The following example shows the contents of an options file called MY OPTFILE 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 FILEl EXE FREQUENT ARCHIVE EXCLUDE OLDSTUFF DORMANT Files indicated by the EXCLUDE qualifier and by either the DORMANT or FREQUENT qua
132. NT MONITOR DEFRAGMENT MONITOR The MONITOR subcommand displays the progress of ongoing defragmentation processes Format DEFRAGMENT MONITOR volume name CONTINUOUS Parameters volume name The volume name parameter identifies the volume whose defragmentation process you want monitored Description The MONITOR subcommand provides current process statistics for the defragmentation process and information about the volume being defragmented This information in three display windows the process statistics display the process activities display and the free space display The process statistics display shows the following defragmentation process information Figure 3 1 Figure 3 1 Process Statistics Display File Edit Commands Options Print Help Defragmentation Process Statigtigg Process ID 32800255 Process DFGSAXP62 1H2 21 EEE 1997 14 385 33 66 Operating on SPIELH Current status SNORMAL Buffered I O CFU Utilization Count EERE Time RTT EAE Rate PERE Eicon Usage Direct I D Page Fault Count Count Rate Bieter Rate 0 second Phase Free space consolidation Elapsed time o 00 03 43 1 Press CTRL C CTRL Y CTRL Z to exit Press CTRL to refresh the screen Fress H or P for NEXT or PREV screen e The defragmentation process ID e The defragmentation process name 3 22 Using Defrag DEFRAGMENT MONITOR e The current date and time e The
133. NT SHOW The following examples illustrates the SHOW subcommand and its qualifiers DEFRAGMENT SHOW MY VOLUME OUTPUT OUTPUT TXT In this example information associated with MY VOLUME is displayed Output is directed to a file called OUTPUT TXT Note If output is directed to a filename without extension the file is given a default extension of lis DEFRAGMENT SHOW DISKSONE HISTOGRAM In this example the volume fragmentation report includes the summary statistics STATISTICS is default and histograms for both file fragmentation and free space fragmentation The report is sent to the SYSS OUTPUT device Using Defrag 3 33 DEFRAGMENT SPAWN DEFRAGMENT SPAWN Format Parameters Description Restrictions Qualifiers Examples The SPAWN subcommand creates a subprocess and executes a DCL command in the subprocess or transfers terminal control to the subprocess if no command is supplied DEFRAGMENT SPAWN command command This is a DCL command string of less than 132 characters that is to be executed in the context of the created subprocess When the command completes the subprocess terminates and control returns to the parent process A command is optional If no command is supplied control passes to DCL The SPAWN subcommand creates a subprocess of your current process You should use the DCL LOGOUT command to terminate the subprocess and return to the parent process You can also use the DCL
134. NT qualifier are excluded Files indicated by the DORMANT qualifier and by the FREQUENT qualifier are considered dormant This rule is applied equally across all files specified in the OPTIONS file as well as those associated with these qualifiers on the command line PREDECESSOR2z script name NOPREDECESSOR default 4 28 Using Defrag PLUS DEFRAGMENT FILE The PREDECESSOR qualifier links scripts These scripts execute in sequence one successfully completes before the next one begins The predecessor script name must exist in the scheduling database or an error status message is returned You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification PRIORITY DEFAULT n MINIMUM n NOPRIORITY default The PRIORITY qualifier specifies priorities for the defragment process The minimum priority setting is used when the defragmentation process exceeds the value specified by either CPU LIMIT or IO LIMIT PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures RVN n RVN 0 default When you have a bound volume set use this qualifier to identify a disk from the volume set or a
135. OCKERR F 12 EPILOGUE qualifier 1 6 3 15 3 28 3 37 4 24 4 35 4 50 4 68 5 13 6 19 Error Messages ABOFAIL1 F 2 ABOFAIL2 F 3 ABO F 3 ABORTNOTDONE F 3 ABOS F 3 ABOSEEN F 3 ACCESSERR F 3 ACLERR F 3 ASSIGNERR F 3 BADPRI F 3 BITMAPCONERR F 4 BITMAPOPENERR F 4 BITMAPREADERR F 4 CACHEFLUSHERR F 4 CANCELED F 4 CANCELNOTDONE F 4 Error Messages cont d CANFAIL1 F 4 CANFAIL2 F 4 CHECKSUMERR F 4 CLOSEIN F 5 CLOSEOUT F 5 CMDUNKNOWN F 5 CONNECTERR F 5 CONSFAIL F 5 COPYERR F 5 CPUOUTRNG F 5 CREATED F 5 CREATEERR F 5 CREPRCFAIL F 5 CRESECFAIL F 6 DBACCCONSTR F 6 DBACCDUP F 6 DBACCERR F 6 DBACCERR2 F 6 DBACCW F 6 DBACCW2 F 6 DBACTRANS F 6 DBBUSY F 7 DBCANTREAD F 7 DBCANTWRITE F 7 DBCLEAR F 7 DBCLEARED F 7 DBCOMMIT F 7 DBCREATE F 7 DBCREATED F 7 DBINCOMPAT F 8 DBINVXLNAM F 8 DBNOREC F 8 DBNOTRANS F 8 DBROLLBACK F 8 DBUPDATERR F 8 DEACCESSERR F 9 DELERR F 9 DFGNOSTART F 9 DFGSTART F 9 DFGTMO F 9 DIOOUTRNG F 9 DIRVERERR F 9 DISABLED F 9 DISFAIL1 F 9 DISFAIL2 F 10 DISKFULL F 10 DSDCMDO F 10 DSDSCRF1 F 10 DSDSCRF2 F 10 DSDSCRO1 F 10 DSDSCRO2 F 10 DUPDEFRAGER F 10 DUPSCHED F 10 DUPSCRPT F 11 EMPDFG F 11 EMPDFGSCH F 11 ENABLED F 11 Index 3 Error Messages cont d ENAFAIL1 F 11 ENAFAIL2 F 11 ENGLIMEXC F 11 ENGMAXTIM F 11 ENQLOCKERR F 12 EXTHDRERR F 12 FREEVMERR F 12 GETDVIERR F 12 GETVMERR F 12 GLBSECMAPERR F
136. OW See DFG DEFRAGMENT routine DFG K_ SET IO item descriptor See DFG DEFRAGMENT routine DFG K_ SHOW 1O item descriptor IDXCHANG F 12 IDXFILEFULL F 13 IDXOPT F 13 IEDBDATA F 13 IELOGNAM F 13 IESCHFILNODTYP F 13 IESCHFUNC F 13 IESCHIMPOSS F 13 IESE1 F 13 IESRCINCONSIS F 13 IEVERNOD F 13 IGNORE qualifier 3 17 3 39 4 25 4 37 4 70 IMEDALL F 13 IMEDSUCC F 14 Index placement keeping fragmentation to a minimum 2 2 Index 6 INHERCONT F 14 INHERINTCONT F 14 INHERINTPRED F 14 INHERIT qualifier See Script how to copy INHERPRED F 14 Initializing a volume CLUSTER SIZE 2 1 DIRECTORIES n 2 1 HEADERS n 2 2 NDEX 2MIDDLE 2 2 Installation files created B 1 logical names B 2 INTCONT F 14 Interface See Callable interface See Database interface See DCL interface See User interface INTERNALERR F 14 INTERR F 14 INTERR2 F 14 INTPRED F 15 INVDEV F 15 INVDEVCONT F 15 INVDEVNAM F 15 INVDFGLST F 15 INVDSLST F 15 INVFILNAM F 15 INVITEMCOMB F 16 INVITM F 16 INVITMLST F 16 INVITMUKN F 16 INVLMFLIC F 16 INVLOGNAM F 16 INVSCHLST F 16 INVSCRNAM F 16 INVSTARTCMD F 17 INVSTRDSC F 17 INVSTRDSCNBR F 17 L L5NOLOG F 17 Licensing considerations 2 3 LIMEXC F 17 Locally mounted volumes VMScluster System 2 4 Log file See also DFG DEFRAGMENT routine DFG K LOG item descriptor See also Scheduler example of brief D 1 example of full E 1 how to create 3 6 4 4 5 7
137. Output File option is used to show the volume fragmentation state or to show information from the scheduling database It directs the output of the SHOW subcommand to a file 5 28 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 5 Report on the State of a Volume Figure 5 18 Report Volume Statistics Disk File Optimizer Report volume Fragmentation DH Fragmentation Report EMHRD S HAY LEST 14 08 42 76 The Fragientation index is 24 5 i 20 9 ie excellent 9i 40 3 is good di 53 3 is fair Bi 89 9 is poor 31 G00 indicates a badly fragmenbed diek Approuinately 4 5 Gout of BO 0 pose lble je dus to file fragmentation Approximately 20 0 put of 2 0 p sible is d to freespace fragmentation Freespace Somnergz Tote free space iOd2 32 blocks Perceontaap Frees zb irpundzd Tots Free extents EBA Kaxinum free extenti 14208 blocke LEN 3565652 Hinimum free extenty d bloke LEN 2372003 Average free extenty i629 blocks Hedisn free extent 32 blocks File Fragmentation Surnmasut Murder of Files tuith sons allocation b42 Tote File extents on the dlekt 7303 Average number of File extente per file 1 034916 Hedian nurher oF file extents pes Pile 1 Hoot Froanentes Filet TYNES COND SYSEXEISYSS0UEUE_MAHIGER OMAWEIOIRYPL EL 49 extentel File Fragmentation Histapgren File Fragmentation Histapran I o 2I OH od ee pom or dum BARRERIGER AAKA IRE OE RACER GERE RERO TTT
138. PMBX and WORLD Explanation The user has insufficient privileges to run DEFRAGMENT User Action Se the BYPASS CMKRNL DETACH EXQUOTA NETMBX SHARE SYSGBL SYSLCK SYSPRV TMPMBX and WORLD privileges and try the command again NOQENTRY no queue entry for script AD Explanation A queue entry was not found for a script that was to be canceled disabled or enabled The database did not have a record that matched the user supplied script name for one of these commands User Action Check the spelling of the script name Use only names that have previously been defined with the VOLUME subcommand NOREMSCH AD not removed scheduler or defragmentation process running Explanation The specified node cannot be removed from the database because a scheduler or some number of defragmentation processes are currently running on that node User Action f you wish to delete the node from the database you must wait for any defragmentation processes to complete or ABORT them and stop the scheduler if running on that node using the GSY S MANAGER DF G STOP _ SCHEDULER COM command file Defragmentation Messages F 21 Defragmentation Messages F 2 Disk File Optimizer Messages NOREMSCR AD not removed referenced by script AD Explanation The specified node cannot be removed from the database because at least one script references this node name User Action If you wish to delete the node from the database you must modify or delete al
139. RCH RMS routines User Action Refer to the specified line in the options file Also check associated messages for more information PARSEFAIL error parsing AD Explanation The RMS PARSE service failed for the specified file User Action Refer to associated messages to determine a course of action Defragmentation Messages F 25 Defragmentation Messages F 2 Disk File Optimizer Messages PRCOUTRNG SL is an invalid process limit specify positive values Explanation The process limit was negative User Action Specify only positive values for the PROCESS LIMIT keyword parameter to the SET subcommand PREDNOTUSRNAME the predecessor for script AD is not a user provided name Explanation The predecessor for a script was not a user provided name This message can occur during the SHOW subcommand when the COMMAND LINE qualifier is present Because script names beginning with DF G are reserved for the DEFRAGMENT software they are never listed when the COMMAND LINE qualifier is used This warning message indicates the script whose predecessor was not listed User Action If the output of the SHOW subcommand was directed to a file edit the file and name the script to be used as a predecessor using the SCRIPT qualifier Then modify the script listed in this message so the PREDECESSOR qualifier indicates the script name used PREPOSTDONE AD subprocess complete Explanation Messages containing text destined for the log file U
140. S Restrictions Qualifiers DEFRAGMENT SHOW The SHOW subcommand also can display data contained in the scheduling database Depending on additional qualifiers the output consists of the SET parameters and script information Further the output can be directed to a file and can be displayed in two formats e f showing a script or volume do not use the ALL qualifier e If showing a volume then you must use the VOLUME qualifier ALL NOALL default The ALL qualifier is used to show 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 COMMAND LINE NOCOMMAND LINE default The COMMAND LINE qualifier is used to show 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 ICOMMAND LINE OUTPUT fileext DEVICEz device spec device spec The DEVICE qualifier selects only the named scripts on the specified devices FILE_LIST min_extents FILE_LIST VOL_MAP_WINDOW 1 default The FILE_LIST qualifier is used to show 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 fvolumeYWI
141. SHOW Command The following are numbers to note 1 Fragmentation index the 1 5 indicates this volume is in excellent condition Notice that the fragmentation is not a 0 0 However 1 5 is excellent Example C 8 shows that all of the files except one has one extent INDEXF SYS has four extents This is the minimum that INDEXF SYS can have File fragmentation the 0 8 is an excellent number Freespace fragmentation the 0 7 is an excellent number Not shown in this report the free space could not be completely defragmented because of cached directories that appear to DFO as open Percentage free the 56 free space is an excellent number With this much free space newly created files will be less apt to be fragmented and the defragmentation process will take less time Total free extents the 10 free extents is a good number Notice how the freespace fragmentation of 0 7 is reflective of this number Average free and median free extents the 474480 average and 18 median shows the free space extents are not clustered around 474480 They are spread out and tend to be more extents around the low end This is shown in Example C 9 The histogram also shows there are three large free space extents Average number of file extents per file the 1 00 number reflects what you see in the file fragmentation index In conclusion this volume is in great shape DEFRAGMENT SHOW Command Report C 15 DEFRAGMENT SHOW Command Report C 4
142. SHOW_SCRIPT 7 28 Callable Interface The DFG K_SHOW_SCRIPT item code requests that DFG DEFRAGMENT return information about the script associated with the DFG K SCRIPT item descriptor which must be part of the item list containing the DFG K_SHOW_ SCRIPT item code The information is returned in a buffer allocated by DFG DEFRAGMENT The address and length of the buffer allocated are returned in longword buffers provided by the caller DFG K_SHOW_SCRIPT may be the first item descriptor in an item list that optionally contains other DFG K SHOW XXXX item descriptors and a DFG K NODE descriptor The uses of the buffer length buffer address and return length address fields for the DFG K SHOW SCRIPT item code are as follows buffer length Must be four which is the length of the buffer that holds the address of the data block allocated by DFG DEFRAGMENT e buffer address Address of a longword buffer that DFG DEFRAGMENT fills with the address of the buffer it allocates to hold the script data return length address Address of a longword that DFG DEFRAGMENT fills with the number of bytes it allocated for the script data The buffer created by DFG DEFRAGMENT consists of two parts The first part is a contiguous list of VMS ITEM LIST 2 descriptors terminated by a longword of zero These descriptors are identical to the ITEM LIST 3 descriptors as shown in Figure 7 1 except they do not have a return length address field The seco
143. SJIM DFO_TEST_2 DFO_TEST_2_L TXT 10 1 extent End file defragmentation phase two Statistics Number Number Number Number Number of files processed of files defragmented of files partly defragmented of frequent files placed of dormant files placed 04 APR 2001 18 33 36 08 433 368 65 0 0 Begin file defragmentation phase three 04 APR 2001 18 33 36 34 Files processed during defragmentation phase three d DISKSJIM DFO_TEST_5 DFO_TEST_5_L TXT 3 1 extent d DISKSJIM 000000 L TXT 1 1 extent FAIL DISKSJIM DFO_TEST_3 DFO_TEST_3_L TXT 3 2 extents d DISKSJIM DFO_TEST_5 DFO_TEST_5_L TXT 10 1 extent d DISKSJIM DFO_TEST_5 DFO_TEST_5_L TXT 9 1 extent End file defragmentation phase three 04 APR 2001 10 37 05 78 Statistics Number of files processed 65 Number of files defragmented 62 Number of files partly defragmented 0 Number of frequent files placed 0 Number of dormant files placed 0 continued on next page Full Log File Example E 3 Full Log File Example Example E 1 Cont Full Log File Begin frequent file placement Files processed during frequent file placement 04 APR 2001 10 37 06 10 Fd DISKSJIM DFO_TEST_10 DFO_TEST_10_L TXT 3 1 extent Fd DISKSJIM DFO_TEST_10 DFO_TEST_10_L TXT 2 1 extent F DISKSJIM DFO_TEST_10 DFO_TEST_10_L TXT 9 1 extent Fd DISKSJIM DFO_TEST_10 DFO_TEST_10_L TXT 8 1 extent End frequent f
144. T FREE_LIST HISTOGRAM LOCATION NAMES NODE OUTPUT PARAMETERS RUNNING ISTATISTICS NOLUME DEFRAGMENT SHOW scriptname volume name script name volume name The parameter for the SHOW subcommand is either a script name or a volume name Names 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 VAXcluster 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 A list of names can be provided but the list cannot contain both script and volume names Information displayed as a result of showing the volume fragmentation state includes A list of files with a user selected minimum level of fragmentation e A histogram of the file fragmentation and freespace fragmentation state of the volume A list of all freespace extents on the volume e Summary statistics on both file fragmentation and freespace fragmentation e The location of user selected files All information in the volume fragmentation analysis is optional By default only the summary statistics are provided 4 58 Using Defrag PLU
145. T commands SHOW See DFG K SET PROCESSES item code See DFG K SHOW PROCESSES item descriptor Process parameters setting 6 44 6 45 showing 6 44 6 46 Process quotas DFO logicals 3 4 4 10 hard coded 3 3 4 9 SYSGEN PQL Mxxx 3 4 4 9 PROCESS DEV F 26 PROCESS ID F 26 PROCESS START F 26 PROCESS STOP F 27 Index 8 RDERR F 27 Recovery procedures 4 11 F 2 See also Installation REMFAIL1 F 27 REMFAIL2 F 27 REMOVED F 27 REMOVENOTDONE F 27 REMOVSEEN F 28 Report state of volume 6 36 Reporting problems F 2 RESAREA F 28 Restrict special files 5 8 RMDBACCERR F 28 RMSERR F 28 RSVDNAM F 28 S SCHEDERR F 28 Scheduler 1 7 log files B 2 Schedule the optimize 5 12 Scheduling creating scripts 2 5 gathering initial information 2 5 scripts 6 24 Scheduling database 1 7 Scheduling defragmentation jobs gathering initial information 2 5 Scheduling scripts creating scheduling scripts 2 7 6 5 6 17 for a standalone system 2 13 for VMSduster 2 9 modifying 2 7 2 8 the right script interval 2 7 SCHEXIT F 28 SCHINITERR F 28 SCHNOTEXC F 29 SCHSTART F 29 sch list item codes 7 14 SCRDIS F 29 SCRENA F 29 Script interval defragmentation jobs 2 7 SCRIPT qualifier 4 4 Scripts aborting 6 27 availability 1 7 cancel on day of week A 3 A 4 copying 4 6 6 3 6 6 6 9 creating 4 4 6 5 definition of 1 7 4 3 displaying 6 22 example 4 5 linking 4 6 modifying 4 6 6 20 monitoring
146. THIRD STRING CXO 3151A The DFG K CLASSIFY FREQ item descriptor lists files to be considered frequently accessed when final file placement decisions are made Frequent files are placed to optimize access speed If a fileis indicated in both the frequent and dormant lists it is considered dormant If a file is indicated in both the frequent and exdude lists it is excluded Note The amount of free space on the volume the number of files currently being accessed and other factors influence file Callable Interface 7 7 DFG DEFRAGMENT placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume The uses of the buffer length buffer address and return length address fields for the DF G K_CLASSIFY_FREQ item code are as follows e buffer length The length in bytes of a list of string descriptors pointed to by the buffer address This value must be a multiple of eight buffer address Address of a list of string descriptors Refer to Figure 7 2 return length address Not used must be zero DFG K_DFG_FLAGS 7 8 Callable I
147. The HEADERS n qualifier is important for I O performance INDEXF SYS contains the file headers for all files on the volume By default when the volume is initialized it contains space for 16 file headers When more than 16 files are created on the volume it extends creating another extent When the new extent fills up it extends again This extending fragments INDEXF SYS and can cause poor I O performance By preallocating enough space for INDEXF SYS you can keep INDEXF SYS from extending One way to estimate the number of headers is by looking at existing disks that are the same type If you are placing frequent or hot files using the HEADERS n qualifier could affect volume access Frequent or hotfile placement is optimized by having INDEXF SYS in the middle of the volume By default or by specifying INDEX MIDDLE the fourth extent of INDEXF SYS is placed in the middle of the volume If enough space is not preallocated for all of the file headers on the volume INDE XF SYS is extended and the new extent could be placed anywhere on the volume 2 2 4 INDEX MIDDLE The INDEX MIDDLE qualifier is important if you are placing frequent files when defragmenting the volume Frequent file placement is optimized by having INDEXF SYS in the middle of the volume 2 3 Improving I O Performance You may be able to improve I O performance by moving some files and setting the characteristics of your volumes The following sections describe how you migh
148. The Disk File Optimizer software is an OpenVMS utility designed to reduce file fragmentation on a storage device while that device remains on line to other users The utility does not prevent users from accessing their files while it is running If a user tries to access a file while it is being defragmented the defragmentation process releases the file to the user and moves on to other files that require defragmentation The file defragmentation utility is compatible with any Files 11 structure level 2 ODS 2 formatted device including single volumes bound volume sets stripe sets and shadow sets The file defragmentation utility is also compatible with ODS 5 formatted device on OpenVMS Alpha 7 2 1 and above Two variants of the Disk File Optimizer software are available e Defrag provides basic capabilities to defragment files and volumes e Defrag PLUS provides all the capabilities of Defrag plus scheduling and database options 1 2 1 Operational Goals The Disk File Optimizer has three fundamental operational goals These goals in order of importance are to 1 Maintain absolute data integrity 2 Awoid negative impact on normal user operations 3 Reduce file fragmentation on the target volume Overview of the Disk File Optimizer 1 1 Overview of the Disk File Optimizer 1 2 Product Description 1 2 2 Features Table 1 1 lists the features of the Disk File Optimizer Table 1 1 Features Feature Description Safe defragment
149. The purpose of the INHERIT qualifier is to make script creation easier By inheriting most of the command data from a previously entered script and modifying only a few items such as volume name a completely new script can be created The INHERIT qualifier creates a database entry for a new script in the following way Copies all fields from the specified script to the new script e Overwrites any qualifier or parameter values in the new script with those specified on the command line Names the new script as appropriate The user may specify a script name using the SCRI PT cript name qualifier Otherwise the defragmentation software creates a unique script name You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXduster system use a percent sign 96 to match a single character in the script name specification INTERVAL delta time NOINTERVAL default The NOINTERVAL qualifier executes a script at regularly scheduled intervals The INTERVAL qualifier specifies the minimum time between 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 the default value of 24 hours is used 4 70 Using Defrag PLUS DEFRAGMENT VOLUME If you specify the AFTER qualifier with the INTERVAL qualifier the first defragmentati
150. UA14 BRNDMG ounted 1 DUA52 BRNDMG ounted 1 DUA53 BRNDMG ounted 1 DUA54 BRNDMG ounted 1 DUA55 BRNDMG ounted 1 DUA58 BRNDMG ounted 1 DUA59 BRNDMG ounted 1 DUA60 BRNDMG ounted 1 DUA63 BRNDMG ounted 1 DUA110 DMNTIA ounted S1 DUA140 DMNTIA ounted S4SDIA1 NROSIS1 ounted ShadowSetMember ShadowSetMember Error Count os c2 c 5cCco 5oc 5 C2 5 1 oC2D CO CcoOCcoCcocncococgouo0nccccd 0 Volume Label VAXVMS062 remote access GROUP PSYCHO member of DSAQ member of DSAQ CMS BUILD USER1 USER2 USER3 USER4 ROUP0000001 ROUP0000002 AX PRODUCTS OGFILES RNOID PAGE UNTIC PAGE ENILE PAGE HYSICAL LPVMS062 LP_PRODUCTS PENVMS062 Q pw mp rUcr r gGo Table 2 1 shows the policy and reason for creating scripts for different volume attributes Table 2 1 Script Scheduling Policies Volume Attributes Policy Reason Volume receives Minimal writes days Volume use is minimal days Volume receives constant writes Volume is very busy Defragment every 7 Defragment every 7 Defragment every day Defragment during periods of low use Fewer writes mean less defragmentation Fewer writes mean less defragmentation Constant writes and deletes cause more fragmentation Many users mean many files will not be defragmented continued on next page Getting Started 2 9 Getting Started 2 7 Example Scheduling Scripts for a VMSc
151. User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program L5NOLOG log file not specified but defragmentation level is 5 Explanation Occurs if LEVEL is specified without the LOG qualifier Defragmentation statistics are unavailable without the LOG qualifier thus it is required when LEVEL is specified User Action Specify LOG ocfile when using the LEVEL 5 qualifier LIMEXC AD limit exceeded Explanation A user specified CPU LIMIT IO LIMIT or PROCESS LIMIT has been exceeded User Action If the limit is correctly set no action is required If the limit is incorrect set a new limit using the SET subcommand LSTBADVOL incorrect device name AD specified on file list Explanation A device name was specified with a file on the frequent dormant or exdude lists that does not match the target device name User Action Correct the device name or remove it altogether LVLOUTRNG SL is an invalid defragmentation level use 1 5 Explanation The defragmentation level specified by the user on the command line was not a number from 1 to 5 inclusive User Action Specify a valid defragmentation level MDNOTFOUND No mounted disk volumes were found Explanation No mounted disk volumes were found for Optimize Volume function User Action Only mounted disk volumes can be defragmented using this command Mount the volume before trying to def
152. VAXcluster system use a percent sign to match a single character in the script name specification Description The ABORT subcommand terminates execution of the defragmentation process es associated with the scripts specified on the command line The process is terminated in an orderly fashion The defragmentation process completes current functions executes housekeeping functions and then exits leaving the volume fully usable and accessible If the specified script is not executing a message indicating that the script is not executing is returned to the user Restrictions e You cannot use the script name parameter with the ALL qualifier Qualifiers AFTER time NOAFTER default The AFTER qualifier aborts the script 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 ALL NOALL default The ALL qualifier aborts all currently executing scripts across the system This qualifier is equivalent to using an asterisk for the script name parameter 4 14 Using Defrag PLUS Examples DEFRAGMENT ABORT The following are examples of the ABORT command DEFRAGMENT ABORT MY SCRIPT AFTER 16 30 This command aborts MY SCRIPT after 16 30 on the day this command is submitted DEFRAGMENT ABORT ALL This command immediately aborts all currently executing scrip
153. You may want to create a script that defines the important defragmentation commands and run it periodically against a different set of files Defrag PLUS provides a MODIFY command that lets you modify an existing script The following example shows how to modify a script DEFRAGMENT MODIFY DEFRAG 2 FREQUENT EXE C NOLOG In this example DEFRAG 2 is modified so that it has a list of frequent files and no longer produces a log file For additional examples of modifying scripts see Section 4 3 3 6 4 3 3 6 Linking and Modifying Linked Scripts Use the PREDECESSOR qualifier to link two or more scripts so they execute one after another A script identified as a predecessor script must first complete executing before its successor script can begin executing The following is an example of a linked script DEFRAGMENT VOLUME DISKSTWO SCRIPT DEFRAG 2 _ PREDECESSOR DEFRAG 1 LOG DEFRAG 2 L0G In this case DEFRAG 1 must complete execution before DEFRAG 2 can begin executing If you entered another command and specified SCRIPT DEFRAG 3 PREDECESSOR DEF RAG 2 then the scripts would execute in order DEFRAG 1 DEFRAG 2 DEFRAG 3 4 6 Using Defrag PLUS Using Defrag PLUS 4 3 Scripts Modifying scripts that are part of a linked set of scripts sometimes involves modifying the linked set For example assume two sets of linked scripts A B C and D E F The following examples and descriptions illustrate how these links can be modif
154. abase contents Defrag PLUS only Show volume fragmentation Once the operator sets a defragmentation schedule in Defrag PLUS no further operator intervention is required Schedules can be set for any periodic interval some volumes or files may be defragmented weekly others biweekly and so forth 1 2 Overview of the Disk File Optimizer Overview of the Disk File Optimizer 1 2 Product Description Table 1 2 Disk File Optimizer Command Summary Command Variant Description DEFRAGMENT ABORT Both Aborts the defragmentation process associated with Script namef the specified volume Defrag or script Defrag volume namef PLUS Before exiting the defragmentation process QUALIFIERS performs an orderly shutdown of all outstanding activities DEFRAGMENT ATTACH Both Transfers control from the current process which process name QUALIFIERS DEFRAGMENT CANCEL Script namef QUALIFIERS DEFRAGMENT DISABLE Script namef QUALIFIERS DEFRAGMENT ENABLE Script namef QUALIFIERS DEFRAGMENT EXIT DEFRAGMENT FILE ffile_namel QUALIFIERS DEFRAGMENT HELP command Defrag PLUS Defrag PLUS Defrag PLUS Both Both Both goes into hibernation to the specified process Cancels the next scheduled execution of the specified script Normal scheduling resumes thereafter Disables the specified script A script does not execute while it is disa
155. able no action taken IM DFO TEST 3 DFO TEST 3 L TXT 3 1 extent M 000000 DFO TEST 4 L TXT 1 1 extent IM DFO TEST 3 DFO TEST 3 L TXT 2 1 extent of files processed of files defragmented of files partly defragmented of frequent files placed of dormant files placed 04 APR 2001 11 20 47 38 C0 C 53 0 04 APR 2001 11 20 47 63 There are 9 consolidation areas Beginning D D D D D D D D D Eo EXk DET pxp EXER EXP pP DET EXIT Or OG C C2 Ore Oro End free space consolidation Completion data for volume ime Statis Total Total Total Total Total Total consolidat DISKSJI ISKSJIM ISKSJIM KSJIM KSJIM ISKSJIM ISKSJIM KSJI DISKSJI Beginning consolidat is So ft Me du ee eu ANNNnNNNN tics number number number number number number of of of of of of 0000 0000 0000 0000 0000 0000 0000 0000 0000 ion pass on area un BN 1282092 643566 blocks 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST 00 DFO TEST X X X L D D DI D D D T RaT f c x D DI 51 e BO LPS wo OTD Ol s EO UU C4 DU DU mU DO DO UO ion pass on area 0 LBN 750 867897 blocks 04 APR 2001 11 37 43 10 04 APR 2001 11 37 43 19 files evaluated 886 candidates found 668 files defragmented 549 files partly defragmented 65 fi
156. able in the log file which is required when DFG K LEVEL 5is specified DFG M_LOG Generates a log file See the DFG K LOG item descriptor to specify a log file Callable Interface 7 9 DFG DEFRAGMENT DFG M LOW PRIORITY Specifies the minimum priority for the defragmentation process DFG M NOTIFY Noctifies users listed in the DFG MAIL ADDRESS mail distribution list of defragmentation process completion DFG M RVN TO DEFRAGC Identifies a specific RVN of a bound volume set to defragment DFG M USE VPA 1 Use the hotfiles database 0 Do not use the hotfiles database DFG M WRITE CHECK Performs a read after write check of all files moved Note Every DFG M XXXX bit mask value has a corresponding DFG V XXXX bit field definition The uses of the buffer length buffer address and return length address fields for the DFG K DFG FLAGS item code are as follows buffer length The length of the DFG FLAGS buffer This value must be DFG S DFG FLAGS x 2 buffer address Address of the DFG FLAGS buffer return length address N ot used must be zero DFG K EXCLUDE Files associated with the DFG K EXCLUDE item descriptor are excluded from processing Any file associated with DFG K EXCLUDE and with either the DFG K CLASSIFY DORM or DFG K CLASSIFY FREQ item descriptor is excluded from processing The file spec field allows wildcard characters You can specify wildcard characters in place o
157. ace for Defrag 5 1 The DECwindows Interface for Defrag 5 2 File Menu 5 2 File Menu The File menu serves only one purpose It allows you to exit this windows interface application To do so click on the File topic and bring down the Exit box Click on Exit to leave this application Figure 5 2 shows the File pull down menu Figure 5 2 File Menu Disk File Optimizer for Open MS v2 3 File Optimize Monitor Report xit ctrl E Welcome to Disk File Optimizer Please make a menu selection to continue 5 2 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu 5 3 Optimize Menu The Optimize menu permits you to optimize a volume file volume index file or abort the optimize process Figure 5 3 shows the optimize menu Figure 5 3 Optimize Menu File Optimize Monitor Report Selected Files Volume Index Fila Abart Welcome to Disk Fila Optimizer Please make a menu selection to continue 5 3 1 Optimize Volume The Optimize Volume menu selection permits you to optimize a volume Use the following procedure to optimize a volume T 2 3 4 5 6 Pull down the Optimize menu Select Volume Define the optimize parameters using the procedures in Section 5 3 1 1 Restrict special files by pressing the restrict button and using the procedure in Section 5 3 1 2 Schedule the optimize process using the procedure in Section 5 3 1 3 Start the optimize proc
158. ages F 23 Defragmentation Messages F 2 Disk File Optimizer Messages NOTSTOPPED defragmentation process D XL was not stopped Explanation An attempt to stop a defragmentation process failed Associated messages provide more detail The most likely cause of this message is that the defragmentation process is no longer running User Action None NOTVOLSET Volume is not member of a bound volume set Explanation Volume is not a member of a bound volume set User Action Specify a volume which is member of a bound volume set NOVOLUME no volume name specified for VOLUME subcommand Explanation DFG DATABASE received a dfg list item list that did not contain a volume name item descriptor User Action If this error occurs with Compaq supplied software submit an SPR Otherwise correct the calling program NULLENGINE a defragmentation process cannot be started for script AD Explanation An attempt to start a defragmentation process failed Associated messages provide more detail User Action Refer to associated messages to determine a course of action ODNOTFOUND No offline disk volumes were found Explanation No offline disk volumes were found for Optimize Volume Index file function User Action Only offline disk volumes can be defragmented using this command dismount the volume before trying to defragment the index file OPENIN error opening AD as input Explanation The specified file could not be opened fo
159. ally searching the extent cache for available free space and using the free space as it is available If the extent cache dwindles it is refilled from the bit map stored on each disk In addition blocks that are returned because of file deletion or file truncation are returned to the extent cache 3 The default number of blocks in a cluster is three for volumes of 50 000 blocks or more or one for volumes having less than 50 000 blocks 1 8 Overview of the Disk File Optimizer Overview of the Disk File Optimizer 1 3 Basic File and File System Concepts Figure 1 2 File Fragmentation Example PORTION OF DEVICE LBN RANGE LBN 0 LBN 1 LBN 2 LBN 3 LBN 4 LBN 5 LBN 6 LBN 7 LBN 8 MAPPING PERFORMED BY FILE SYSTEM VBN 1 VBN2 VBN3 VBN4 VBN5 VBN6 FILE VBN RANGE CXO 3147A Consider a newly initialized disk that has 12 contiguous clusters available for allocation Users A B and C each allocates and writes a three cluster file User A allocates clusters 1 3 by default because that is what resides in the extent cache User B allocates clusters 4 6 and user C allocates clusters 7 9 This is shown in the first part of Figure 1 3 User B then deletes the file and the clusters are returned to the extent cache Thus the extent cache now indicates that clusters 1 3 and 7 9 are allocated as shown in the second part of Figure 1 3 Now suppose another user user D allocates a six cluster file Because the default file allocation algorit
160. aluated 4 Exclude count 0 Candidate count 4 Frequent count 0 Total placed files n Total indexed files 1 File Defragmentation Files partly defragmented 0 Files defragmented Files proceszed File Placement Free Space Consolidation Dormant files placed 0 Extent count i amp Frequent files placed 0 Countdown Current File RACER rye ae gt 5 UC HIF CHESS MIK MY 1 Press CTRL C CTRL Y CTRL Z to exit Press CTRL H to refresh the screen Fress H or P for NEXT or PREV screen To access the process activities display enter N or press the Next Screen key The process activities display shows the following process related information Figure 4 2 e Name of current defragmentation phase Using Defrag PLUS 4 43 DEFRAGMENT MONITOR Number of files evaluated Number of candidate files for defragmentation Number of dormant files Total number of placed files Number of excluded files Total number of indexed files Number of frequent files For the file defragmentation phase Number of files partly defragmented Number of files defragmented Number of files processed For the file placement phase Number of dormant files placed Number of frequent files placed For the free space consolidation phase Number of extents to be consolidated into free space Number of extents left to be consolidated into free space Current file being evaluated To access the free space display enter N or pre
161. ame file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume The defragmentation process always excludes files marked NOMOVE open files files excluded in an options file and files excluded using the Ignore option Files in Hotfile Database This option causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s frequent file list Dormant Files The Dormant Files option indicates files to be considered dormant when final file placement decisions are made You may enter the file name or use the file list button to bring up a list of files to chose from 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 dassified in any manner If a fileis indicated in both the DORMANT and FREQUENT lists it is considered dormant If a fileis indicated in both the EXCLUDE and DORMANT lists it is excluded Note The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described The file spec field allows wildcard characters Yo
162. ample time Both VPA and DECps allow you to modify the hotfile collection process If you have VPA installed use the ADVISE COLLECT command and NO HOTFILE _ QUEUE value qualifier If you have DECps installed use the ADVISE COLLECT SET command and the NO HOTFILE QUEUE value qualifier See the VPA or DECps documentation for additional details 3 2 6 Defining Quotas for the Defragmentation Process The process quotas are values applied to the defragmentation process and then disappear when the process is complete For more information on process quota values refer to the VMS Authorize Utility Manual You can define the process quotas for defragmentation processes When the defragmentation process starts up it selects the maximum value from the following three sources e Hard coded values e SYSGEN process quotas PQL Mxxx e DFO logical process quotas By changing the SYSGEN process quotas or DFO logical process quotas you can define the process quotas for the defragmentation processes The following sections describes these values and describes how to change them 3 2 6 1 Hard coded values You cannot change the hard coded values for the defragmentation processes but the following shows the hard coded values e ASTLIM 100 e BIOLM 18 e BYTLM 61440 e DIOLM 18 e ENQLM 500 Using Defrag 3 3 Using Defrag 3 2 Defrag Capabilities FILLM 50 J TQUOTA uses system default PGFLQUOTA 50000 PRCLM 8 TQ
163. and Answers to Frequently Asked Questions A 5 B Disk File Optimizer Logicals and Files B 1 Files Added to System by the Disk File Optimizer The following files are permanently added to the system when you install the Defrag PLUS variant Files marked with an asterisk are not added if you install the Defrag variant DFG DATABASE directory typically SYS COM MON 000000 DF G DATABASE DIR DF G DATABASE DF G DB DAT DFG DATABASE DF G FILE DAT DFG DATABASE DF G GENERAL DAT DFG DATABASE DF G MAIL DIS DFG DATABASE DF G NODE DAT DFG DATABASE DF G QUEUE DAT DFG DATABASE DF G SCRIPT DAT DFG DATABASE DF G VOLUME DAT SYS COMMON SY S STARTUP DF G STARTU P COM SYS COMMON SYSS STARTUP DF G START SCHEDULER COM SYS COMMON SYSEXE DFG CREATE DATABASE EXE SYS COMMON SY SE XE DF G DCL E XE SYS COM MON SY SE XE JDFG ENGINE_MAIN EXE SYS COM MON SY SE XE DFG I NIT DATABASE EXE SYS COM MON SY SE XE JDFG SCHEDULER EXE SYS COMMON SYSEXE DFG STOP SCHEDULER EXE SYS COMMON SYSEXE DF G REFORMAT DB RMS EXE SYS COMMON SYSEXE DFG REFORMAT DB EXE SYS COMMON SYSHLP JDEF RAGMENT HLB SYS COMMON SYSHLP DF Gxxx RELEASE_NOTES SYS COMMON SYSLIB DF GSDEFRAGMENTSHR EXE SYS COMMON SYSLIB DF GSRELATIONSHR EXE SYS COMMON SYSLIB DF G RM SSHR EXE SYS COMMON SYSLIB DF G UTILITYSHR E XE Disk File Optimizer Logicals and Files B 1 Disk File Optimizer Logicals and Files B 1 Files Added to System by the D
164. are attempted an error message is displayed You can also use the ATTACH command with the DCL SPAWN WAIT command to return to a parent process without terminating the subprocess running the Disk File Optimizer The ATTACH command cannot be used if your terminal has an associated mailbox e You cannot use the process name parameter with the IDENTIFICATION qualifier e You must supply either a process name or a PID for this command IDENTIFICATION pid IDENTIFICATION lets you specify the process identification PI D of the process to which terminal control will be transferred Leading zeros can be omitted Using Defrag 3 11 DEFRAGMENT ATTACH Examples 3 12 Using Defrag The following are examples of the ATTACH command DEFRAGMENT ATTACH JONES 2 This ATTACH command transfers the terminal s control to the subprocess named J ONES 2 DEFRAGMENT ATTACH IDENTIFICATION 2A401A1B This ATTACH command switches control from the current process to the process whose PID is 2A401A1B DEFRAGMENT EXIT DEFRAGMENT EXIT The EXIT subcommand exits the Disk File Optimizer utility and returns the system prompt to the user Format DEFRAGMENT EXIT Parameters None Description The EXIT subcommand exits the user from the Disk File Optimizer utility EXIT shuts everything down in an orderly sequence Restrictions None Qualifiers None Examples The following is an example of the EXIT command 1
165. artial Volume Map Window zr zl B Disk File Optimizer Monitor Defragmentation V D um ile Optimi g alu Start LEN b Phase Completed ME oraino of Window Allocated Space L Free Space L of Window fees Free Blocks 68625 Blocks Grid p f Indexed Placed Nomove The DECwindows Interface for Defrag 5 23 The DECwindows Interface for Defrag 5 5 Report on the State of a Volume 5 5 Report on the State of a Volume The report menu allows you to review the current state of disk volumes to determine if defragmentation is needed Click on the Volume Fragmentation option of the Report menu for the two options it supports See Figure 5 15 You can opt for a graphic or a text report of the state of the volumes Figure 5 15 Report Menu sk File Optimizer for Open MS t2 4 File Optimize Monitor Welcome to Disk File Optimizer Please make a menu selection to continue 5 5 1 Graphics Format Use the following procedure for a graphics display of the selected volume s 1 Click on the Graph suboption of the Report Volume F ragmentation menu See Figure 5 15 The Report Select Volume dialog appears See Figure 5 17 and Table 5 7 2 Note that the first entry in the list is marked selected by default You can select any other volume for the respective report To select another volume move mouse pointer to it and click 3 Click on Ok A graphical report of th
166. asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification Description The CANCEL subcommand causes the scheduler to skip the next scheduled execution of the script specified in the command line Normal scheduling resumes afterward Restrictions e The script name parameter is not allowed if the ALL qualifier is used Qualifiers ALL NOALL default The ALL qualifier cancels the next scheduled execution of all scripts in the scheduling and parameter database Examples The following is an example of the CANCEL command 1 DEFRAGMENT CANCEL MY SCRIPT YOUR SCRIPT In this example the next scheduled execution of MY SCRIPT and YOUR SCRIPT are canceled Afterwards both scripts resume their normal schedule 4 18 Using Defrag PLUS DEFRAGMENT DISABLE DEFRAGMENT DISABLE The DISABLE subcommand makes the specified script ineligible for execution Currently executing scripts are not affected Use the ABORT subcommand to stop currently executing scripts Format DEFRAGMENT DISABLE scrip name Y ALL Parameters script name The script name parameter specifies the scripts to be disabled You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification Description The DISABL
167. ation A logical name translation failed because the logical name was invalid Associated messages provide more detail User Action Refer to associated messages to determine a course of action INVSCHLST invalid scheduler item list Explanation The scheduler list passed to DFG DEFRAGMENT was invalid User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVSCRNAM AD is an invalid script name Explanation The user tried to name a script using characters that are not supported for script names User Action Reenter the script name using valid characters F 16 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages INVSTARTCMD script AD already has a queue entry Explanation The user entered a START subcommand for a script that was already started User Action None INVSTRDSCNBR invalid string descriptor in item SL of item list Explanation An invalid string descriptor was pointed to from an item list passed to DFG DEFRAGMENT The item number of the item descriptor containing the offending string descriptor is supplied by this message User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVSTRDSC invalid string descriptor Explanation An invalid string descriptor was pointed to from an item list passed to DF G DEFRAGMENT
168. ation Built in safety measures to protect user data Works on line Defragmentation can occur at the same time a device is user accessible Open files are not defragmented and defragmentation operations are transparent to users Unattended operation Defragmentation can occur without operator intervention VM Scluster Works with any supported VM Scluster configuration compatibility Automatic scheduling A full range of scheduling options are available in Defrag PLUS including daily weekly and continuous operating modes Defrag does not provide scheduling capabilities but can be used with DECscheduler if desired Defragmentation levels A full range of defragmentation levels is available from a volume analysis to a full defragmentation operation 1 2 3 User Interface Users interact with the file defragmentation utility using the DCL commands listed in Table 1 2 or the graphic user interface For details on using the Defrag variant of the software see Chapter 3 For details on using the Defrag PLUS variant of the software see Chapter 4 For details on using the DE Cwindows interface see Chapter 5 The Disk File Optimizer interfaces allow users to perform the following operations Start defragmentation operations e Stop defragmentation operations e Schedule defragmentation operations Defrag PLUS only e Monitor defragmentation operations e Control CPU and I O resources consumed by the defragmentation process e Show dat
169. ave a bound volume set use this qualifier to identify a disk from the volume set or all disks in the volume set The default of zero tells the Disk File Optimizer to defragment all disks in the bound volume set Specify a relative volume number RVN to defragment a specific disk that belongs to a bound volume set SCRIPT script name NOSCRIPT default The SCRIPT qualifier assigns a new name to a script If a duplicate scri pt 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 e Any alphanumeric character e Underscoe Hyphen e Dollar sign Observe the following rules when naming a script e Use any combination of uppercase and lowercase letters e Do not begin script names using the dollar sign However you can include the dollar sign within the script name The dollar sign is reserved for special use by Compaq Computer Corporation Donot end a script name with a hyphen since the hyphen is the DCL continuation character The OpenVMS User s Manual contains more information on naming conventions 4 40 Using Defrag PLUS Examples DEFRAGMENT MODIFY TIME_LIMIT delta time NOTIME_LIMIT default The TIME LIMIT qualifier specifies the maximum elapsed time allowed for a given
170. aximum size of 255 bytes e buffer address Address of the buffer containing the file specification string for the OPTIONS file The file specification string may not contain wildcard characters return length address Not used must be zero DFG K POST PROCESS The postprocessing file contains DCL commands that are processed after the defragmentation process completes The uses of the buffer length buffer address and return length address fields for the DFG K POST PROCESS item code are as follows e buffer length L ength of the POST PROCESS file specification string which has a maximum size of 255 bytes e buffer address Address of the buffer containing the file specification string for the POST PROCESS file The file specification string may not contain wildcard characters return length address Not used must be zero DFG K PRE PROCESS 7 12 Callable Interface DFG DEFRAGMENT The preprocessing file contains DCL commands that are processed before the defragmentation process begins The uses of the buffer length buffer address and return length address fields for the DFG K PRE PROCESS item code are as follows buffer length Length of the PRE PROCESS file specification string which has a maximum size of 255 bytes e buffer address Address of the buffer containing the file specification string for the PRE_PROCESS file The file specification string may not contain wildcard characters return length
171. ay take action on another script by entering the name of the script in the Script Name field The DECwindows Interface for Defrag Plus 6 25 The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 5 Script Scheduling Actions Option Description Script Name Name of script for scheduling action Cancel Cancels the next scheduled execution of the specified script Normal scheduling resumes thereafter 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 After Starts execution of the script when the specified time is reached Enter the time in the field below the option 6 26 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 6 Abort a Script Use this option to stop a script that is currently executing Use the following procedure to abort an active defragmentation script 1 Select the Script pull down menu 2 Select the Abort option 3 Select the script to abort from the Script List box Use caution because a double click on a script entry will abort that script Point to any one or more of the scripts listed clicking once on each one you want to abort 4 Finish the abort action by selecting e OK to abort the selected scripts and exit the Abort Script
172. because of one of the following e A call to DFG DEFRAGMENT using a scheduler list that indicates the defragmentation list should be empty For example DFG K SHOW SCRIPT must not have a defragmentation item list Something was wrong with the semantics of the defragmentation item list or a particular item descriptor was formatted improperly User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVDSLST invalid defragmentation and scheduler item lists Explanation Both the scheduler list and the defragmentation list passed to DFG DEFRAGMENT were invalid User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVFILNAM AD is an invalid file specification Explanation An invalid file name was given for either the log file or the options file Associated messages describe why the file name is invalid User Action Based on the associated messages specify a valid file name Defragmentation Messages F 15 Defragmentation Messages F 2 Disk File Optimizer Messages INVITEMCOMB invalid combination of DFG K_INTERVAL and DFG K _ PREDECESSOR Explanation The DF G K_INTERVAL item descriptor is not allowed with the DFG K_PREDECESSOR item descriptor in a call to DFG DEFRAGMENT User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwi
173. ble Interface 7 1 Introduction This chapter describes the Disk File Optimizer callable interface It contains three major sections e An introduction to using the callable interface e Details about the DFG DEFRAGMENT and DFG RELEASE_MEMORY routines and their arguments Examples showing how to use the callable interface from various programming environments 7 2 Using the Callable Interface The callable interface enables you to initiate defragmentation operations from within a program It is also the interface Defrag PLUS uses to interact with the scheduling database There is also a call that releases memory consumed as a result of showing the contents of defragmentation process scripts The callable interface is available only if you install it with Defrag PLUS software The Defrag variant does not support the callable interface 7 2 1 Including Files for DFG DEFRAGMENT and DFG RELEASE MEMORY To compile programs that call the DFG DEFRAGMENT and DFG RELEASE MEMORY routines you need to include the appropriate SY S LIBRARY DF G DEF xxx symbol library where xxx stands for the default file extension of various programming languages For example if you were using the C programming language you would include SY S LIBRARY DF G DEF H 7 2 2 Linking Files with DFG DEFRAGMENT and DFGSRELEASE MEMORY When you link a program that calls DFG DEFRAGMENT or DFG RELEASE MEMORY you must specify a link options file containing the following
174. bled The script remains disabled until it is enabled with the ENABLE command Enables a previously disabled script Once enabled a script operates normally as scheduled Returns the user from the Disk File Optimizer utility to the OpenVMS format Allows the user to defragment a selected file or files Different qualifiers are available for Defrag and Defrag PLUS If you have installed Defrag the DEFRAGMENT FILE command creates a detached process that defragments the target file or files This process executes immediately if files are available If you have installed Defrag PLUS the DEFRAGMENT FILE command creates and enters a script into the scheduling database This script defragments the file or files specified on the command line By default the script is immediately eligible for execution and once complete is removed from the scheduling database Invokes the standard VMS HELP utility for the appropriate version of the Disk File Optimizer software on your system continued on next page Overview of the Disk File Optimizer 1 3 Overview of the Disk File Optimizer 1 2 Product Description Table 1 2 Cont Disk File Optimizer Command Summary Command Variant Description DEFRAGMENT MODIFY Script name QUALIFIERS DEFRAGMENT MONITOR Script name volume name QUALIFIERS DEFRAGMENT OFFLINE VOLUME volume namef QUALIFIERS DEFRAGMENT REMOVE Script namef
175. buffered I O count and rate of the Count defragmentation process and Rate Direct I O The direct I O count and rate of the Count defragmentation process and Rate CPU Utilization Time and Usage The CPU utilization time and usage of the defragmentation process Page Fault Count and Rate The page fault count and rate of the defragmentation process Files Evaluated Number of files evaluated Dormant Count Number of dormant files Candidate Count Number of candidate files for defragmentation continued on next page The DECwindows Interface for Defrag 5 19 The DECwindows Interface for Defrag 5 4 Monitor a Volume Table 5 5 Cont Defragmentation Process Statistics Window Description Field Description Exclude Count Number of excluded files Placed Files Number of placed files Frequent Count Number of frequent files Indexed Files Number of indexed files Files Partly Defragmented Number of files partly defragmented Dormant Files Placed Number of dormant files placed Files Defragmented Number of files defragmented Frequent Files Placed Number of frequent files placed Files Processed Number of files processed Free Space Extent Count Number of extents to be consolidated into free space Free Space Extent Countdown Number of extents left to be consolidated int
176. ce for Defrag Plus 6 4 Script Menu Table 6 1 Cont Define Dialog Box Fields Field Description Console Message The console message option requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM This has the same effect as the OPCOM _ NOTIFICATION DCL qualifier Mail Message 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 This has the same effect as the MAIL DCL qualifier Table 6 2 Translations of Operations to DCL Command LEVEL x Volume Analysis Defragment Files Sliding Bar Consolidate Free Space Only LEVEL Selected LEFT 1 Selected MIDDLE 2 Selected RIGHT 3 Not Selected Selected 4 Not Selected Not Selected Selected 5 6 12 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 1 2 Restrict Special Files Dialog Box The Restrict Special Files dialog box allows you to include or exclude any special files during the defragmentation process Figure 6 8 shows the Restrict Special Files dialog box for a volume and Table 6 3 describes the information fields Figure 6 8 Resirict Special File Dialog Box Script Name Restrict i Schedule Exclude Files Files Placed by User 7 RMS Indexed Files 17 excluded Files Place Files
177. ce information from AD Explanation The defragmentation process received failure status from the GETDVI system service Associated messages provide more detail User Action Refer to associated messages to determine a course of action GETVMERR unable to allocate dynamic memory Explanation The defragmentation process received failure status from the LIBS GET VM system service Associated messages provide more detail User Action If the error is due to insufficient system dynamic memory system resources are insufficient to defragment the volume If this is not the case submit an SPR GLBSECMAPERR unable to map global section Explanation The defragmentation process could not map the system wide global section created by the scheduler This error is very unlikely but could be caused if the scheduler exits after creating the global section and the defragmentation process but before the defragmentation process has a chance to map the global section It will also occur if the user tries to run the DFG ENGINE MAIN program directly User Action None HIGHPRIO AD priority specified as greater than UL Explanation This error is issued when the user tries to specify a too high priority for a script User Action Correct the value and resubmit script IDXCHANG Index file changed during read will retry Explanation While reading the index file the number of file extents it describes changed This can occur if a user create
178. ced in appropriate locations on the volume IO LIMIT n NOIO LIMIT The IO LIMIT qualifier specifies the maximum direct I O rate per second of any one defragmentation process If the I O rate is exceeded the priority for the process drops to the minimum priority as specified by the PRIORITY qualifier or defaults to three LEVEL n LEVEL 2 default The defragmentation process selects files for defragmentation from among those not excluded based on the LEVEL qualifier 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 e LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels two and three is a candidate for defragmentation e LEVEL 2 default Using Defrag 3 17 DEFRAGMENT FILE Any file whose extents cannot be completely mapped by the mapping window or that can be selected using level three is a candidate for defragmentation The default window value is seven and can be set for a given volume using SET VOLUME device spec WINDOWS n e LEVEL 3 Any file with retrieval pointers in more than one file header is a candidate for defragmentation e LEVEL 4 The defragmentation process for level four processing performs only free space consolidation This level is used with the CONSOLIDATE FREESPACE qualifier e
179. cess Exits the user from the Disk File Optimizer utility and returns to the system prompt Defragments a selected file or files Invokes VMS HELP utility for the Disk File Optimizer software Invokes the defragmentation monitor which monitors an ongoing defragmentation process The input parameter must be a volume name Defragments INDEXF SYS on the specified volume according to the selected command line qualifiers Shows the fragmentation state of the specified volumes Creates a subprocess and either transfers control to the subprocess or executes a DCL command from within the subprocess Defragments a selected volume or volumes The DEFRAGMENT VOLUME command creates a detached process that defragments the target volume This process executes immediately Using Defrag 3 7 Using Defrag 3 5 Defrag Command Set 3 5 1 The Defrag Commands This section provides detailed information about each command for the Defrag variant of the Disk File Optimizer software 3 8 Using Defrag DEFRAGMENT ABORT DEFRAGMENT ABORT The ABORT subcommand terminates the defragmentation process on the volume specified in the command line Format DEFRAGMENT ABORT volume name ALL Parameters volume name The volume name parameter identifies the volume or volumes on which the defragmentation process is to be aborted The volume name specification accepts the standard wildcard characters If you use an asterisk
180. cess can defragment all candidate files If a user opens a file while the defragmentation process is running the process stops Use VPA or DECps software to find periods of low use activity e Schedule the defragmentation process periodically to maintain volumes in a defragmented state This also makes the defragmentation process more effective e Schedule defragmentation before and after user activity that may significantly contribute to fragmentation such as end of month processing 4 5 Error Recovery Procedures Appendix F lists all the messages that the Disk File Optimizer generates The messages are in alphabetical order and contain a description and suggested user action However if a system failure occurs while defragmentation is in process the following procedure ensures any lost extension file headers are cleared up 1 Enter the MOUNT REBUILD command This is the default action after a system failure 2 Enter the ANALYZE DISK STRUCTURE command If you receive the LOSTEXTHDR message use the REPAIR qualifier to eliminate the problem The LOSTEXTHDR error indicates that an extension file header is not in the extension file header chain of any file The file header is rewritten with a deleted header and the blocks allocated to the file header are marked free Note The LOSTEXTHDR error does not affect file access If a linked script is executing when a system failure occurs you must start the successors to that
181. ciated with this script If no options file is associated with this script DFG DEFRAGMENT does not return a DFG K SHOW SCRIPT OPTIONS item descri ptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows buffer length L ength of the options file name string in bytes e buffer address Address of the options file name string DFG K SHOW SCRIPT POST PROC DFG DEFRAGMENT returns the file specification of the postprocessing file if any associated with this script If no postprocessing file is associated with this script DFG DEFRAGMENT does not return a DFG K SHOW SCRIPT POST PROC item descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the postprocessing file name string in bytes buffer address Address of the postprocessing file name string DFG DEFRAGMENT DFG K_SHOW_SCRIPT_PRE_PROC DFG DEFRAGMENT returns the file specification of the preprocessing file if any associated with this script If no preprocessing file is associated with this script DFG DEFRAGMENT does not return a DFG K_SHOW_ SCRIPT_PRE_PROC item descriptor The uses of the buffer length and buffer address fields of the ITEM_LIST_2 descriptor are as follows e buffer length L ength of the preprocessing file name string in bytes e buffer address Address of the preprocessing file name string DFG
182. command specified as the command parameter that command is executed in the subprocess and control returns immediately to the parent process f the command parameter is not specified then control is passed to the created DCL subprocess until it is deleted or until an ATTACH command is issued to transfer control to another process None None The following are examples of the SPAWN command 1 DEFRAGMENT DFO SPAWN The SPAWN command creates a subprocess and transfers terminal control to the created subprocess Using Defrag PLUS 4 63 DEFRAGMENT SPAWN DFO gt SPAWN SHOW DEFAULT DISK 1 JONES DFO The SPAWN command creates a subprocess and executes the DCL command SHOW DEFAULT in the created subprocess Control then returns to the Disk File Optimizer parent process 4 64 Using Defrag PLUS DEFRAGMENT START DEFRAGMENT START The START subcommand starts the specified script Format DEFRAGMENT START scriptname AFTER Parameters script name The script name parameter is the name of the script s to be started You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification Description The START subcommand starts any script not currently executing You may use it to start scripts halted due to unusual system events such as system failures
183. count and rate of the defragmentation process Files Evaluated Number of files evaluated Dormant Count Number of dormant files Candidate Count Number of candidate files for defragmentation Exclude Count Number of excluded files continued on next page The DECwindows Interface for Defrag Plus 6 31 The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume Table 6 6 Cont Defragmentation Process Statistics Window Description Field Description Placed Files Number of placed files Frequent Count Number of frequent files Indexed Files Number of indexed files Files Partly Defragmented Number of files partly defragmented Dormant Files Placed Number of dormant files placed Files Defragmented Number of files defragmented Frequent Files Placed Number of frequent files placed Files Processed Number of files processed Free Space Extent Count Number of extents to be consolidated into free space Free Space Extent Countdown Number of extents left to be consolidated into free space Current File Current file being evaluated 6 32 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume 6 5 2 Full Volume Window The defragmentation full volume map window allows you to see how the storage space and free space on the fu
184. d e For a bound volume set this utility only works on the ROOT volume e For disk volumes in a shadow set single member or otherwise the following restrictions apply e Do not specify the virtual unit name to defragment for example DSAnnnn e Specify only one physical device name for example 1 DU Annnn e Use the following procedure to defragment INDEXF SYS in a shadow set 1 Dismount both members of the shadow set Using Defrag PLUS 4 49 DEFRAGMENT OFFLINE_VOLUME Qualifiers 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 SSYSTEM F WRITLCK write lock error Defragment the INDEXF SYS on the disk volume Mount the disk volume into the shadow set Add the disk volume that was not defragmented into the shadow set Mounting this disk volume causes a full copy operation 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 ANALY ZE DI SK RE PAIR Delete disk 000000 DF G DEFRAG INDEXF DAT 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 informatio
185. d on the full volume or on a partial volume in a sliding window When selecting the Monitor option DFO displays two windows e A process statistics window showing process information for the defragmentation process Refer to Figure 5 12 and Table 5 5 A monitor map window showing free space and allocated space on the volume Refer to Figure 5 13 and Figure 5 14 This procedure describes how to monitor allocated space on a disk volume 1 Select the Monitor pull down menu 2 Select the means by which you want to monitor allocated space Select the Volume or Full Volume option of the Monitor pull down menu Refer to Figure 5 10 e IF you want to identify the volume by name select the Volume option then select the volume name from the Volume List To view different parts of the entire volume map use the arrows and scroll bars around the map on the defragmentation volume map window If you chose to monitor the Volume a Defragmentation Process Statistic Window and a Defragmentation Partial Volume Map Window will appear Refer to Figure 5 12 Figure 5 14 and Table 5 6 e IF you want to view the full volume select the Full Volume option then select the volume name from the Volume List If you chose to monitor the Full Volume a Defragmentation Process Statistic Window and a Defragmentation Full Volume Map Window will appear Refer to Figure 5 12 Figure 5 13 and Table 5 5 The DECwindows Interface for Defrag 5 15 The DECwindows Inte
186. d to complete before they are removed When a script that has a predecessor or a successor is removed all forward and backward links are updated to reflect the removal For example assume that A is the predecessor of B B is the predecessor of C and B is removed After B is removed A becomes the predecessor of C Restrictions e If the ALL qualifier is used then the script name parameter cannot be used e Ifthe node is a script it cannot be removed e f the node has a scheduler or defragmentation process running it cannot be removed Qualifiers AFTER time NOAFTER default The AFTER qualifier does not delete the script until after the specified time Specify time as a VMS absolute time or combination absolute and delta time Refer to the OpenVMS User s Manual for more information on how to specify time 4 54 Using Defrag PLUS DEFRAGMENT REMOVE ALL NOALL default The ALL qualifier indicates that all scripts are to be removed from the scheduling and parameter database If ALL is used the script name parameter is not allowed NODE The NODE qualifier removes the specified node name from the scheduling and parameter database Examples The following example shows how to remove a script after a specified time 1 DEFRAGMENT REMOVE MY SCRIPT AFTER 16 30 In this example MY SCRIPT is removed from the database It is removed after 16 30 on the day this command is entered 2 DEFRAGMENT REMOVE MYNOD
187. d using the IGNORE qualifier FREQUENT file specf NOFREQUENT default FULL The FREQUENT qualifier indicates files to be considered frequently accessed when final file placement decisions are made Frequent files are placed toward the center of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described NOFULL default The FULL qualifier requests a full log of all actions taken by the defragmentation process The FULL qualifier must be used with the LOG qualifier The FULL and BRIEF qualifiers are mutually exclusive and NOFULL provides the same functionality as BRIEF HOTFILE_DATABASE NOHOTFILE_DATABASE default The HOTFILE_DATABASE qualifier causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s FRE QUENT file list IGNORE keyword IGNORE PLACED default NOIGNORE 3 38 Using Defrag DEFRAGMENT VOLUME The IGNORE qualifier requests that the defragmentation process ignore certain types of files as specified by the following keywords e INDEX
188. 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 24 hours 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 LEVEL n LEVEL 1 default 4 26 Using Defrag PLUS DEFRAGMENT FILE The defragmentation process selects files for defragmentation from among those not excluded based on the LEVEL qualifier 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 e LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels two and three is a candidate for defragmentation e LEVEL 2 default Any file whose extents cannot be completely mapped by the mapping window or that can be selected using level three is a candidate for defragmentation The default window value is
189. defragmentation operation If the time limit is exceeded the defragmentation process is aborted Specify time as a delta time Refer to the OpenVMS User s Manual for more information on specifying times For linked scripts the time limit of the first script applies to the whole set Time limits specified with successor scripts apply to these scripts only If the time limit is set unreasonably low the defragmentation process may not accomplish useful defragmentation VOLUME volume name NOVOLUME default Identifies the volume where the files reside WRITE_CHECK NOWRITE_CHECK default The WRITE_CHECK qualifier requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process The following examples show how to modify an existing scripts using the common qualifiers 1 DEFRAGMENT MODIFY C SCRIPT A This command changes the name of script C to A 2 DEFRAGMENT MODIFY MAIL NOTIFICATION This command turns on mail notification for all scripts in the database 3 DEFRAGMENT MODIFY myscript LOG new log NOPREDECESSOR This command causes subsequent executions of myscript to generate a log file called NEW LOG LOG located in the user s default directory The NOPREDECESSOR qualifier disassociates myscript from its predecessor However any script for which myscript is a predecessor remains dependent upon the
190. defragmentation process finishes before returning control to the user The following example illustrates how to use the OFFLINE VOLUME subcommand and its qualifiers DISMOUNT CLUSTER 1 DKB100 MOUNT OVER ID 1SDKB100 ANALYZE DISK STRUCTURE 1 DKB100 DISMOUNT 1 DKB100 DEFRAGMENT OFFLINE VOLUME 1 DKB100 LOG OFFLINE DKB100 LO0G V T L OUNT OVER ID 1 DKB100 ANALYZE DISK STRUCTURE 1SDKB100 DISMOUNT 1 DKB100 OUNT CLUSTER 1 DKB100 USER1 EJ In this example the following is performed Using Defrag 3 29 DEFRAGMENT OFFLINE_VOLUME 3 30 Using Defrag w OW Ss Dismount volume from the cluster Mount volume privately to analyze disk structure Check volume for readability and validity of Files 11 structure information Dismount volume to defragment INDE XF SYS Defragment INDEXF SYS on volume Mount volume privately to analyze disk structure Check volume for readability and validity of Files 11 structure information Dismount volume Mount volume into the cluster DEFRAGMENT SHOW DEFRAGMENT SHOW Format Parameters Description Restrictions Qualifiers The SHOW subcommand displays information about the fragmentation state of the given volume FILE_LIST FREE_LIST HISTOGRAM LOCATION OUTPUT ISTATISTICS DEFRAGMENT SHOW volume name volume name The parameter for the SHOW subcommand is a volume name The SHOW comma
191. ds the value specified by either CPU LIMIT or IO LIMIT PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures RVN n RVN O default When you have a bound volume set use this qualifier to identify a disk from the volume set or all disks in the volume set The default of zero tells the Disk File Optimizer to defragment all disks in the bound volume set Specify a relative volume number RVN to defragment a specific disk that belongs to a bound volume set TIME_LIMIT delta time NOTIME_LIMIT default The TIME LIMIT qualifier specifies the maximum elapsed time allowed for a given defragmentation operation If the time limit is exceeded the defragmentation process is aborted Specify time as a delta time Refer to the OpenVMS User s Manual for more information on specifying times If the time limit is set unreasonably low the defragmentation process may not accomplish useful defragmentation WAIT default NOWAIT The WAIT qualifier causes the input device to wait until the defragmentation process finishes before returning control to the user Using Defrag 3 41 DEFRAGMENT VOLUME WRITE_CHECK NOWRITE_CHECK default Examples 3 42 Using Defrag The WRITE CHECK qualifier requests that a read after write check be p
192. duling database e SET Sets defragmentation process parameters e SHOW Shows information about the defragmentation process e START Starts a defragmentation process VMS Usage cond value type longword unsigned access write only mechanism by value Longword condition value returned in RO The condition values that DFG DEFRAGMENT returns are listed under CONDITION VALUES RETURNED Table 7 1 lists the arguments and values for the callable interface Detailed information for each entry in the table follows Callable Interface 7 3 DFG DEFRAGMENT Table 7 1 Arguments and Values for DFG DEFRAGMENT Argument Item Descriptor Fields Item Codes dfg list buffer length DFG K CLASSIFY DORM item code DFG K CLASSIFY FREQ buffer address DFG K DFG FLAGS return length address DFG K EXCLUDE DFG K FILE DFG K LOG DFG K OFFLINE DFG K OPTIONS DFG K POST PROCESS DFG K PRE PROCESS DFG K VOLUME sch list buffer length DFG K ABORT item code DFG K AFTER buffer address DFG K CANCEL return length address DFG K DISABLE DFG K ENABLE DFG K INHERIT DFG K INTERVAL DFG K MODIFY DFG K NODE DFG K PREDECESSOR DFG K REMOVE DFG K SCH FLAGS DFG K SCRIPT DFG K SET CPU DFG K SET IO DFG K SET PROCESSES DFG K SHOW CPU DFG K SHOW lO DFG K SHOW PROCESSES DFG K SHOW SCRIPT DFG K START DFG K TIME LIMIT dfg list VMS Usage item list 3 type longword unsigned access read only mechanism by reference The dfg list argum
193. dure use the following commands to make the change in the scheduling database DEFRAGMENT REMOVE QLOAD DB You must wait 30 seconds or so between these commands to allow DFO to delete the scripts from the database You may also effect this interval change to 1 DUA2 using the following command DEFRAGMENT MODIFY DEFRAG 1 DUA2 INTERVAL 2 00 00 2 8 Getting Started Getting Started 2 7 Example Scheduling Scripts for a VMScluster 2 7 Example Scheduling Scripts for a VMScluster The first example creates scheduling scripts for a VMScluster consisting of 4 CPUs and 20 volumes The CPUs are an Alpha system and 3 VAX systems The Alpha system has its own system volume 2 of the VAX systems share one system volume and the other VAX system has its own system volume The 24 volumes consist of the following volumes System volumes one shadowed Volumes where layered products are installed A volume for log files Volumes for user files one is a RAID set from StorageWorks RAID Software A locally mounted volume Volumes for code management system CMS files and software builds The volumes are shown below Device Device Name Status DSAO ounted DPAO LUNTIC Online DPAI LUNTIC ounted 1 DKA130 LUNTIC ounted 1 DUAO0 BRNDMG S1S DUAI1 BRNDMG 1 DUA2 BRNDMG ounted 1 DUA3 BRNDMG ounted 1 DUA11 BRNDMG ounted 1 DUA12 BRNDMG ounted 1 DUA13 BRNDMG ounted 1 D
194. e submit an SPR DBCLEARED database deared Explanation A database has been cleared User Action None DBCLEAR dearing database Explanation A database is being cleared User Action None DBCOMMIT database updates committed Explanation U pdates for a given transaction have been committed to the database User Action None DBCREATED database created Explanation A database has been created User Action None DBCREATE creating database Explanation A database is being created User Action None Defragmentation Messages F 7 Defragmentation Messages F 2 Disk File Optimizer Messages DBINCOMPAT Database is incompatible with current software please convert Explanation The scheduling database format is incompatible with the scheduler user database interface This error can occur if database created with a previous version of the disk file optimizer was not converted to the new version during installation User Action Create a new version of the database using the following procedure from a privileged account Ensure DFG DATABASE is defined SYSTEM SYS MANAGER DFG STOP_SCHEDULER from all nodes e DEFINE PROCESS DFG DATABASE SYS SCRATCH e RUN SYS SYSTEM DFG CREATE DATABASE e RUN SYS SYSTEM DFG INIT DATABASE e DEASSIGN PROCESS DF G DATABASE e DEFINE DFG OLD DB DFG DATABASE e DEFINE DFG NEW DB SYS SCRATCH e RUN SYS SYSTEM DFG REFORMAT_ DB e COPY SYS SCRATCH DFG DATABASE DFG DATABASE
195. e Check The Write Check option requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process This has the same effect as the AWRITE CHECK DCL qualifier Relative Volume Number Allows you to select the relative volume number of a volume set This has the same effect as the RVN 2 DCL qualifier Operations You may elec to defragment specific files consolidate disk space or do an analysis check only File defragmentation and space consolidation can be done together Defragment Files Allows you to select which files to defragment Use the three position sliding bar e LEFT Files that are not 100 contiguous e MIDDLE Files whose extent cannot be completely mapped RIGHT Files with retrieval points in more than one file header Consolidated Freespace Consolidate the free space on the volume Volume analysis only Requests a volume analysis only no defragmentation occurs The results are available in the log file The operations has the same effect as the LEVEL 2x DCL qualifiers as shown in Table 5 2 LogFile TheLog 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 e The Brief option lists only the statistics of each phase such as number of f
196. e DELETE SYSS SCRATCH DFG DATABASE e PURGE DFG DATABASE DF G DATABASE optional DBINVXLNAM invalid translated name Explanation This is an internal error User Action Submit an SPR DBNOREC norecord found in relation AD operation AD Explanation A database record could not be found This error can occur if the database is corrupt the disk file optimizer software is in error or the Rdb software is in error User Action Submit an SPR DBNOTRANS operation invalid database transaction not established Explanation A database operation cannot be performed because a suitable transaction has not been established User Action Submit an SPR that provides all associated messages and describes the actions leading to this error Also report which defragment component signaled the error DBROLLBACK database updates rolled back Explanation All updates to the database have been rolled back User Action None DBUPDATERR database update failed Explanation This is a summary message indicating that database updates were unsuccessful Associated messages provide more detail User Action Refer to associated messages to determine a course of action F 8 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages DEACCESSERR deaccess error on file AD Explanation The specified file could not be deaccessed by the defragmentation process using the O DEACCESS QIO Associated messages prov
197. e file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described EPILOGUE file name NOEPILOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Using Defrag 3 15 DEFRAGMENT FILE Refer to Appendix B for logicals that are available to these command procedures EXCLUDE file spec NOEXCLUDE default The EXCLUDE qualifier specifies files to be 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 Note The defragmentation process always excludes system files open files files excluded in an options file OPTIONS qualifier and files excluded using the IGNORE qualifier FREQUENT file spec NOFREQUENT default FULL The FREQUENT qualifier indicates files to be considered frequently accessed when final file placement decisions are made In order for the file to be placed frequent it must be the file specified in the command line Frequent files are placed toward the center of the volume 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 The a
198. e from the following selections e Select one or more file names e Select to enable or disable write check e Select the relative volume number of a volume set e Select whether to defragment files and what kind of files to defragment e Select whether to consolidate freespace or not e Select whether or not to do a volume analysis e Select whether to notify you by log file or console message Select whether to report brief or full log files 5 4 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Figure 5 5 shows the script define dialog box for a file Figure 5 5 Define Dialog Box for a File Disk File Optimizer Optimize Selected Files Restrict Schedule Optimize lt gt Volume gt Selected Files C write check Relative volume Number gt lt gt Volume Index File Operations 3 Defragment Files All fragmented files Slowest Dee T S 17 Consolidate Free Space 7 volume analysis only Notify by t1 Log File 3 console Message CS Brint Log lt gt full log In the Define dialog box for a volume index file you can choose from the following selections Select a disk e Select whether to notify you by log file or console message Select whether to report brief or full log files Figure 5 6 shows the define dialog box for a volume index file The DECwindows Interface
199. e scheduler could not create the detached defragmentation process Associated messages provide more detail User Action Refer to associated messages to determine a course of action Defragmentation Messages F 5 Defragmentation Messages F 2 Disk File Optimizer Messages CRESECFAIL error creating global section Explanation The global section used for communications could not be created by the scheduler for reasons given in associated error messages This error is caused by a failure status from the CRMPSC system service which could indicate insufficient system wide global section resources User Action Refer to associated messages to determine a course of action DBACCCONSTR constraint violation in relation AD operation AD Explanation A constraint in the database was violated The most common reason is an attempt to enter a duplicate record Associated messages provide more detail User Action Refer to associated messages to determine a course of action DBACCDUP duplicate record in relation AD operation AD Explanation An attempt was made to enter a duplicate record in the database Associated messages provide more detail User Action Refer to associated messages to determine a course of action DBACCERR2 database access error AD transaction Explanation The database could not be accessed The cause of this problem may be an undefined logical corrupt database DFG software error or RMS software error A
200. e script being monitored e The node on which the defragmentation process is operating e The status of the defragmentation process e The buffered I O count and rate of the defragmentation process e The CPU utilization time and usage of the defragmentation process e The direct I O count and rate of the defragmentation process e The page fault count and rate of the defragmentation process e The current defragmentation process phase The elapsed time since the start of the defragmentation process The process information marked with an asterisk in the preceding list appears highlighted on the process display whenever it changes 4 42 Using Defrag PLUS DEFRAGMENT MONITOR Figure 4 1 Process Statistics Display File Edit Commands Options Print Defragmentation Process StabigBEigg Process ID 32800255 Process DFGSAKP62 1H2 Z21 EEE 1997 14 36 33 66 Operating on SPIELH Current status SHORMAL Buffered I 0 CPU Utilization Count BE Time Rate PERE cients Usage Direct 1 0 Page Fault Count WEBEP Count 240 Rate ME nd Rate 0 5econd Ehase Free space consolidation Elapsed time 00 03 43 1 Press CTRL C CTRL Y CTRL Z to exit Fress CTRL V to refresh the screen Press N or P for NEXT or PREV screen Figure 4 2 Process Activities Display File Edit Commands Options Print Defragmentation Process Activities File Evaluation Dormant eount amp Files ev
201. e scripts you would like to show e Scripts that apply to specific nodes either exclusively or shared by other nodes Scripts that apply to specific disk volumes e All scripts in the database You also have the option of creating an output file for selected scripts Use the following procedure to show scripts 1 Select the Show Scripts option of the Script menu Figure 6 12 Show Script Dialog Box C Output File Nodes i Limited Scripts ILDUCE A SPIELN B COMMA NO DEFRAG_ 1 DKAG DEFRAG 1 DKA100 DEFRAG 1 DKA200 DEFRAG 1 DKB0 DEFRAG_ 1 0KB200 DEFRAG_ 1 DKB300 DEFRAG_ 1 DKB400 DEFRAG_31 DKB500 volumes DEFRAG_ 2 DKA700 DEFRAG 2 DKB100 DISKBAXP62 1H2 B DEFRAG szsDkE3oD DISKBUSERT DEFRAG_AMENDS_FILES 1 DKA300 DEFRAG BACKUP 18 DKB200 18DKAd00 DEFRAG BACKUP 18DRBBO0 1 DKA600 EE DEFRAG DORMANT 1 DEB200 1 DKE0 1 DEFRAG_DORMANT_ 1 DKB500 1 DKE200 DOR DIR ILDUCE Sl DKE3O0 DOR DIR SPIELN 1 DKE400 FILE 1 DKE5D0 E FILE PLACMENT EXCLUDE 2 Click twice on a script name in the Scripts box to select it 3 Choose the kind of output you wish for the selected script IF you keep the Output File option enter the name of the output file you want to create IF you do not select the output file option the script file is visible only while using this option 4 f you want to show scripts sorted by volume proceed with Step 4 otherwise
202. e specified in the command line Dormant files are placed at the high end of the volume 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 The amount of free space on the volume the number of files cur rently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described EPILOGUE file name NOEPI LOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures EXCLUDE file spec NOEXCLUDE default 4 24 Using Defrag PLUS The EXCLUDE qualifier specifies files to be 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 DEFRAGMENT FILE Note The defragmentation process always excludes system files open files files excluded in an options file OPTIONS qualifier and files excluded using the IGNORE qualifier FREQUENT file specf NOFREQUENT default The FREQUENT qualifier indicates files to be considered frequently accessed when
203. e specified script at the time specified by Script namef JUALIFIERS the AFTER qualifier By default the script starts immediately DEFRAGMENT VOLUME Both Allows the user to defragment a selected volume volume_namef QUALIFIERS or volumes Different qualifiers are available for Defrag and Defrag PLUS If you have installed Defrag the DEFRAGMENT VOLUME command creates a detached process that defragments the target volume This process executes immediately If you have installed Defrag PLUS the DEFRAGMENT VOLUME command creates and enters a script into the scheduling database This script defragments the volume associated with the volume parameter By default the script is immediately eligible for execution and once complete is removed from the scheduling database 1 2 4 Programming Interface The Disk File Optimizer software also provides the opportunity for programmers to call for defragmentation operations to occur directly from their application programs For detailed information about the callable interface see Chapter 7 1 2 5 Operational Overview This section presents an operational overview of the file defragmentation process implemented by the Disk File Optimizer software 1 2 5 1 Defragmentation Process Figure 1 1 illustrates the general organization of the Disk File Optimizer software The numbers on the illustration correspond to the numbers in the following list 1 T
204. e state of the selected volume s appears on screen See Figure 5 16 Click on Cancel to close this dialog 5 24 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 5 Report on the State of a Volume Figure 5 16 Report Graphics Full VolumeMap Pa a m N N Mix of All ted End LEN llocated Space i Free Space a bo 204864 and Free Space of Window jocks Grid 45 Blocks j Free Blocks 133836 i Indexed Placed Nomove This dialog is nothing but a color coded display of how the volume is shared by its files and directories While Start LBN and Volume are self explanatory the following may require explanation e The colors green cyan blue magenta and red represent directories indexed files placed files nomove files and open files respectively Three gray levels mark different extents Darkest gray allocated space Lightest gray free space and medium gray mix of allocated and free space e Blocks grid End LBN of Window and
205. e types on the volume map in different colors if you have used these file categories in the defragmentation process The following list shows the color categories for the various files types Directories GREEN Dormant Files YELLOW Exclude Files ORANGE Frequent Files BLUE General Files BLACK The DECwindows Interface for Defrag Plus 6 35 The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume 6 6 Report on the State of a Volume The report menu allows you to review the current state of the volumes to determine if defragmentation is needed Click on the Report menu for the two options it supports See Figure 6 21 You can opt for a graphic or a text report of the state of the volumes Figure 6 21 Report Menu sk File Optimizer for OpenVMS t2 4 File Optimize Script Monitor Text Ctri t Welcome to Disk File Optimizer Please make a menu selection to continue 6 6 1 Graphics Format Use the following procedure for a graphics display of the selected volume s 1 Click on the Graph suboption of the Report Volume F ragmentation menu See Figure 6 21 The Report Select Volume dialog appears See Figure 5 17 and Table 6 8 2 Note that the first entry in the list is marked selected by default You can select any other volume for the respective report To select another volume move mouse pointer to it and click 3 Click on OK A graphical report of the state of the selected volume s appears i
206. e up the sch list have a required order Otherwise there is no required order for the item descriptors in the sch list If the dfg list argument is not supplied the first descriptor in the sch list must have one of the following item codes DFG K ABORT DFG K CANCEL e DFG K DISABLE DFG K ENABLE DFG K REMOVE DFG K SET XXX DFG K SHOW XXX e DFG K START Most of these item codes are incompatible with each other For example it is invalid to have an item list containing a DFG K DISABLE item descriptor and a DFGS K ENABLE item descriptor The exceptions are the DFG K SET XXX and DFG K SHOW XXX item codes It is valid to have an item list containing any combination of SET item descriptors or an item list containing any combination of SHOW item descriptors A combination of SET and SHOW item descriptors is not allowed Each item code is related directly to an associated DCL command For example DFG K ABORT has the same effect as the DCL command DEFRAGMENT ABORT cript name sch list Item Codes DFG K ABORT DFG DEFRAGMENT queues an abort request for the specified script The script is aborted when the scheduler processes the abort request The uses of the buffer length buffer address and return length address fields for the DF G K_ABORT item code are as follows buffer length Length of the script name in bytes The maximum size of a script name is 64 bytes e buffer address Address of the script name buffer
207. ection C 4 for an explanation of how the fragmentation index is calculated The total free space value in 512 byte blocks on the volume This is the amount of free space that you see in response to the DCL command SHOW DEVICE The percentage of free space compared to the total size of the volume The 10 free space on this volume means it needs to be cleaned up or some files moved off With only 10 free space the volume will tend to fragment faster and defragmentation will take longer The total free extents is the number of areas the free space is fragmented into The ideal number would be one However this number usually cannot be achieved because of files that cannot be moved These files create areas on the volume If no files are small enough to fit the volume is left with some free space The maximum free extent is the number of blocks in the biggest free space area The ideal situation would be for this number to be the same as total free space The minimum free extent is the number of blocks in the smallest free space area The average free extent is the average number of blocks of free space extents The median free extent is the median number of blocks of the free space extent DFO calculates the median by taking the size of all free extents sorting them and then selecting the size of free extent in the middle The number of files on the volume with some allocation Files with zero allocation are not counted in this numb
208. ed by specifying FULL 4 4 Using Defrag PLUS Using Defrag PLUS 4 3 Scripts Examples of brief and full log files can be found in Appendix D and Appendix E respectively The command shown in the following example creates a full log file DEFRAGMENT VOLUME DISKSONE LEVEL 2 LOG DISKSONE_ANA LOG FULL In log files the symbols preceding a file name indicate the following Blank file has been preprocessed for defragmentation d file has been defragmented i file has been partly defragmented D file has been placed for dormant access Dd file has been defragmented and placed dormant D file has been placed dormant and been partly defragmented F file has been placed for frequent access Fd file has been defragmented and placed frequent F file has been placed frequent and been partly defragmented oved file has been moved number of extents unchanged EMPTY file was empty no action taken FAIL file s fragmentation cannot be reduced IN USE new disk space for file was in use no action taken OPEN file was open no action taken OMOVE file may not be moved no action taken UNAVL file was unavailable no action taken 4 3 3 2 Showing the State of a Disk The defragmentation software can show the current fragmentation state of a volume The SHOW subcommand provides a variety of report options which show the level of fragmentation on a given volume For example to view the default information in the volume
209. ed disk 1 Pull down the Optimize menu 2 Select Volume Index File 3 Define the optimize parameters using the procedures in Section 5 3 1 1 4 Restrict special files by pressing the restrict button and using the procedure in Section 5 3 1 2 5 Schedule the optimize process using the procedure in Section 5 3 1 3 6 Start the optimize process by pressing the OK or Apply button 5 3 4 Abort an Optimize Process Use this option to abort an optimize process that is currently executing Use the following procedure to abort an active optimize process 1 Select the Optimize pull down menu 2 Select the Abort option 3 Select the volume to abort from the Volume List box Use caution because a double click on a entry will abort that optimize process Point to any one or more of the volumes listed clicking once on each one you want to abort 4 Finish the abort action by selecting e OK to abort the selected volumes and exit the Abort option e Apply to abort the selected volumes and remain in the Abort option e Cancel to leave the Abort option without taking any action Figure 5 9 shows a list of volumes in the Abort dialog box 5 14 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Figure 5 9 The Abort Dialog Box DISKSAXP62 1LH2 5 4 Monitor a Volume The Monitor menu allows you to monitor the defragmentation process by selecting a volume You can view how the space is allocate
210. ed disk Approximately 0 8 out of 80 0 possible is due to file fragmentation 2 Approximately 0 7 out of 20 0 possible is due to freespace fragmentation 3 Freespace Summary Total free space 4744809 blocks Percentage free 56 rounded 4 Total free extents 10 5 aximum free extent 2522745 blocks LBN 1666278 inimum free extent 9 blocks LBN 2655 Average free extent 474480 blocks 6 edian free extent 18 blocks File Fragmentation Summary umber of files with some allocation 17835 Total file extents on the disk 17838 Average number of file extents per file 1 000168 7 edian number of file extents per file 1 Most Fragmented File 000000 INDEXF SY8 1 4 extents Example C 8 User Volume File Fragmentation Histogram File Fragmentation Histogram Extent Count 4 1 1 kckckckckckck ck ck ck ckck kk ck kc k kk k kk kk kkkkkkkk kkk 17834 POMPA Number of files with a given number of extents Each corresponds to 500 files DEFRAGMENT SHOW Command Report C 13 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command Example C 9 User Volume Volume Free Space Histogram Volume Freespace Histogram Freespace Size LBNs 2522745 1743984 477981 36 18 9 Number of freespace extents of a given size Each corresponds to 1 freespace extent C 14 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the
211. ed time This has the same effect as the DCL qualifier AFTER Wait for Start Command Keeps the specified script from executing until started by the Schedule Scripts option in the Script pulldown menu This has the same effect as the DCL qualifier NOAFTER Priority This is the priority that the OpenVMS scheduler uses for the defragment volume operation The default priority is set at 4 The minimum priority is set at 3 This has the same effect as the DCL qualifier PRIORITY XDEFAULT n MINIMUM 2 Time Limit Specifies the delta time allowed for a given defragmentation operation This has the same effect as the DCL qualifier TIME LIMIT Don t Reschedule The DFO schedule will not reschedule this script At This Interval Specifies the delta time of the interval at which the script will be executed This has the same effect as the DCL qualifier INTERVAL Continuously Causes the script to run continuously When selected the defragmentation script used for the process must be aborted or canceled when no longer needed This has the same effect as the DCL qualifier CONTINOUSLY To Follow Script Names the script that will run before the current script is executed The script must exist in the database Enter a script name or click on the script list button for the list of scripts to choose from This has the same effect as the DCL qualifier PREDECESSOR Schedule on Nodes Lim
212. ee file placement but makes every effort to place files as described See Section 4 3 for more information FULL NOFULL default The FULL qualifier requests a full log of all actions taken by the defragmentation process The FULL qualifier has no meaning if the LOG qualifier is absent The FULL and BRIEF qualifiers are mutually exclusive and NOFULL provides the same functionality as BRIEF HOTFILE_DATABASE NOHOTFILE_DATABASE default The HOTFILE_DATABASE qualifier causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s FRE QUENT file list IGNORE keyword IGNORE PLACED default NOIGNORE Using Defrag PLUS 4 69 DEFRAGMENT VOLUME The IGNORE qualifier requests that the defragmentation process ignore certain types of files as specified by the following keywords e INDEXED Ignores all RMS indexed files e NOINDEXED May defragment RMS indexed files e PLACED lIgnores all files with explicit placement flags set in their headers e NOPLACED May defragment files with explicit placement flags Files indicated by the GNORE qualifier are added to the EXCLUDE list The default value IGNORE PLACED 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 INHERIT script name NOINHERIT default
213. efrag 3 27 DEFRAGMENT OFFLINE_VOLUME 3 Analyze the disk volume to make sure it has no problems ANALYZE DISK disk_name If the disk needs to be repaired use the following command to repair it ANALYZE DISK REPAIR disk_name After defragmenting the INDEXF SYS file perform another ANALY ZE DISK REPAIR Restrictions Qualifiers 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 For a bound volume set this utility only works on the ROOT volume For disk volumes in a shadow set single member or otherwise the following restrictions apply e Do not specify the virtual unit name to defragment for example DSAnnnn e Specify only one physical device name for example 1 DU Annnn e 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 Defragment the INDEXF SYS on the disk volume Mount the disk volume into the shadow set Add the disk volume that was not defragmented into the shadow set Mounting this disk volume causes a full copy operation e f you experience a power failure duri
214. ent is the address of a list of item descriptors each of which describes one defragmentation specific option for this command The list of item descriptors is terminated by a longword of zero 7 4 Callable Interface DFG DEFRAGMENT The dfg_list argument is not required however you must provide an argument placeholder if it is not used Specify a longword of zero or the address of a longword containing zero as an argument placeholder Note An error occurs if both the dfg_list and sch_list arguments are zero or are pointers to NULL item lists The item descriptors that make up the dfg_list have a required order The first descriptor in the list must have either the DFG K_FILE or DFG K_VOLUME item code Subsequent item descriptors have no required order Figure 7 1 shows a single item_list_3 descriptor Figure 7 1 ITEM_LIST_3 Descriptor ITEM CODE BUFFER LENGTH BUFFER ADDRESS RETURN LENGTH ADDRESS CXO 3150A DFG DEFRAGMENT Item Descriptor Fields buffer length A word containing a user supplied integer specifying the length in bytes of the buffer or data associated with the buffer address field The length of the buffer needed depends upon the item code specified in the item code field of the item descriptor If the value of buffer length is too small DFG DEFRAGMENT truncates any returned data item code A word containing a user supplied symbolic code specifying the item of information that the user is supp
215. entage free the 4 free space is very low With only 4 free space the volume will tend to fragment faster and defragmentation will take longer Total free extents the 303 free extents is a large number This large number makes the free space fragmentation large also Average free and median free extents the 345 average and 27 median shows the free space extents are not clustered around 345 They are spread out and tend to be more extents around the low end This is shown in the Example C 6 Average number of file extents per file the 1 942 number reflects what you see in the file fragmentation index In conclusion this volume is defragmented as well as it can be given the type of files on this volume The fragmentation index of this volume could be improved if the open files could be closed and defragmented Also the free space could be improved by removing some files C 12 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command C 3 3 User Volume Example C 7 shows an output from the SHOW command for a user volume Example C 7 User Volume DEFRAGMENT SHOW DISKSUSR5 VOLUME HISTOGRAM Disk File Optimizer for OpenVMS DFG 2 6 2001 Compaq Computer Corporation Fragmentation Report DISKSUSR5 04 APR 2001 14 56 54 02 The fragmentation index is 1 5 1 1 20 9 is excellent 21 40 9 is good 41 60 9 is fair 61 80 9 is poor 81 100 indicates a badly fragment
216. entation phase e Number of files evaluated Number of candidate files for defragmentation Number of dormant files e Total number of placed files e Number of excluded files Using Defrag 3 23 DEFRAGMENT MONITOR Total number of indexed files Number of frequent files e For the file defragmentation phase Number of files partly defragmented Number of files defragmented Number of files processed e For the file placement phase Number of dormant files placed Number of frequent files placed e For the free space consolidation phase Number of extents to be consolidated into free space Number of extents left to be consolidated into free space e Current file being evaluated To access the free space display enter N or press the Next Screen key The free space display shows the following device related information Figure 3 3 Figure 3 3 Free Space Display File Edit Commands Options Print Help Free Space Distribution Ma p 00 fy LBH 6 2055240 1110420 S8ASDEAD Cluster size 4 e The duster size of the device e The maximum LBN on the device The following information also on the device display is highlighted whenever it changes e An approximate free space distribution map 3 24 Using Defrag DEFRAGMENT MONITOR The name of the device being defragmented The number of free blocks on the device The free space map repre
217. entially The uses of the buffer length buffer address and return length address fields for the DFG K PREDECESSOR item code are as follows e buffer length L ength of the predecessor script name string in bytes The maximum size of a script name string is 64 bytes Callable Interface 7 21 DFG DEFRAGMENT e buffer address Address of a buffer containing the script name string return length address Not used must be zero DFG K_REMOVE DFG REMOVE deletes the specified script from the database If the script is currently executing it is allowed to complete before it is deleted If the specified script is not in the scheduling database DFG DEFRAGMENT returns an error status indicating the script could not be found If DFG K REMOVE is present it must be the first item descriptor in the item list The uses of the buffer length buffer address and return length address fields for the DFG K REMOVE item code are as follows e buffer length L ength of the script name string in bytes The maximum size of a script name string is 64 bytes e buffer address Address of a buffer containing the script name string return length address Not used must be zero The script name can be A valid ASCII script name In this case the specified script is removed An unsigned longword that has been assigned the value DFGS K ALL SCRIPTS The buffer length field of the item descriptor must be four In this case
218. er The total file extents on the volume The average number of files extents per file is the total file extents on the disk divided by the number of files with some allocation The lower this number the less fragmented the volume The median number of file extents per file is the median number of file extents on the volume DFO calculates the median by taking the number of extents for each file sorting them and then selecting the number in the middle The most fragmented file name and the number of extents it contains DEFRAGMENT SHOW Command Report C 3 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command C 3 Examples of the Output from the SHOW Command This section has three example outputs of the SHOW command after each volume has been defragmented The examples are on the following volumes System volume User volume with system log files on it User volume C 4 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command C 3 1 System Volume Example C 1 shows an output from the SHOW command for a system volume Example C 1 System Volume DEFRAGMENT SHOW 1 DKB0 VOLUME HISTOGRAM Disk File Optimizer for OpenVMS DFG 2 6 2001 Compaq Computer Corporation Fragmentation Report DISKSALPHA071 04 APR 2001 11 16 42 10 The fragmentation index is 13 6 1 1 20 9 is excellent 21 40 9 is good 41 60 9 is fair 61 80 9 is poor 81
219. erformed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process The following example shows how to defragment a volume DEFRAGMENT VOLUME DISKSUSER 1 This command defragments DISK USER 1 using default qualifiers The defragmentation process executes once 4 Using Defrag PLUS 4 1 Introduction This chapter explains how to use the Defrag PLUS variant of the Disk File Optimizer software It contains these major sections e General guidelines for using the Defrag PLUS software e Information about storing defragmentation operation information in database scripts e Information about scheduling defragmentation operations e Defrag PLUS command reference material in a format similar to that of the OpenVMS DCL Dictionary Manual 4 2 General Guidelines Defrag PLUS provides all the functions of Defrag plus the ability to e Store sets of defragmentation operations e Schedule defragmentation operations 4 2 1 DCL Interface Disk File Optimizer commands are available from the DCL prompt or from within the Disk File Optimizer utility When you enter a command from within the Disk File Optimizer you do not enter the word DEFRAGMENT first except for the DEFRAGMENT FILE and DEFRAGMENT VOLUME commands Examples of some defragmentation commands entered at the DCL prompt are DEFRAGMENT FILE C FULL LOG defrag_c log SCRIPT c AFTER 22 00 DEFRAGMENT MODIFY c
220. ermine when and how a script operates For more information about the specific qualifiers for these commands see Section 4 6 the DEFRAGMENT SHOW or DEFRAGMENT DISABLE commands 4 3 2 Script Naming Conventions When you create a script use the SCRIPT qualifier to assign a script name of up to 64 characters that is meaningful to you Observe the following rules when naming a script e You may use any combination of uppercase and lowercase letters a through Z e You may use any number 0 through 9 e You may use the underscore e You can include the dollar sign within the script name but not as the first character Compaq Computer Corporation reserves the dollar sign for special use e You may use a hyphen in the script name but do not end a script name with a hyphen because the hyphen is the DCL continuation character 4 3 3 Examples of Creating and Using Scripts This section indudes examples of analyzing volumes creating log files and using the scheduling and defragmentation qualifiers to defragment volumes 4 3 3 1 Creating Log Files Log files are created using the LOG qualifier There are two types of log files e Brief Full Brief log files provide an abbreviated description of events that occur during a defragmentation operation Brief log files are the default log file type Full log files provide an extended version of events that occur during defragmentation operations Full log files are obtain
221. ese logicals are commented out By uncommenting the affected line and executing DFG STARTUP COM you can affect the quotas for the defragmentation processes For example if a disk containing a large database routinely encounters the insufficient virtual memory error INSVIRMEM during defragmentation increase the page file quota PGFLQUOTA to a value larger than the DFO default of 50 000 DEFINE SYSTEM EXECUTIVE MODE DFGSPGFLQUOTA 120000 These rules apply to setting process quota values e You cannot decrease a quota value below the system PQL minimum as defined by SYSGEN e You may decrease a DFO quota value to the associated PQL_Mxxx minimum value but this is not recommended The right way to change these logicals is to edit the file SYS STARTUP DFG STARTUP COM An example of changing the page file quota is shown below To use these logicals increase the associated value uncomment the desired line and execute this file CALL DEFINE LOGICAL DFGSASTL 100 CALL DEFINE LOGICAL DFGSBIOL 18 CALL DEFINE LOGICAL DFGSBYTL 61440 CALL DEFINE LOGICAL DFGSDIOL 18 CALL DEFINE LOGICAL DFGSENQL 500 CALL DEFINE LOGICAL DFGSFILL 50 CALL DEFINE LOGICAL DFGSJTQUOTA uses system default CALL DEFINE LOGICAL DFGSPGFLQUOTA 20000 CALL DEFINE LOGICAL DFGSPRCL 8 CALL DEFINE LOGICAL DFGSTQEL 10 CALL DEFINE LOGICAL DFGSWSDEFAULT 512 CALL DEFINE LOGICAL DFGSWSEXTENT 6
222. ess by pressing the OK or Apply button 5 3 1 1 Define the Optimize Parameters Before you can optimize a volume or file you have to define the optimize parameters using Define dialog box In the Define dialog box for a volume you can choose from the following selections Select a volume name Select to enable or disable write check Select the relative volume number of a volume set Select whether to defragment files and what kind of files to defragment Select whether to consolidate freespace or not The DECwindows Interface for Defrag 5 3 The DECwindows Interface for Defrag 5 3 Optimize Menu e Select whether or not to do a volume analysis e Select whether to notify you by log file or console message Select whether to report brief or full log files Figure 5 4 shows the define dialog box for a volume Refer to Table 5 1 for a description of the information fields Figure 5 4 Define Dialog Box for a Volume Define Restrict Schedule Optimize lt gt Volume volume gt Selected Files C write check Relative volume Number o lt gt Volume Index File Operations 3 Defragment Files Moderately Fragmented files only TENENTE Seer 3 Consolidate Free Space f Volume analysis only Notify by Log File 3 console Message gt Brint Log lt gt Full los In the Define dialog box for a file you can choos
223. etermine a course of action VPAEND SL hotfile records added to the FREQUENT list Explanation This message indicates the VPA database query has completed It also indicates the total number of hotfile records found that were related to the target device User Action None VPATIME hotfiles database access elapsed time AD Explanation This message indicates the time that elapsed during the VPA query User Action None WRTERR error writing AD Explanation An attempt to WRITE a file failed User Action Refer to associated messages to determine if additional action is necessary XINHERIT DEFRAGMENT AD script AD can t inherit from DEFRAGMENT IAD script AD Explanation This error is issued when the user tries to make a DEFRAGMENT FILE script inherit from a DEFRAGMENT VOLUME script or vice versa User Action Resubmit your script information with corrected data Defragmentation Messages F 33 A ABOFAIL1 F 2 ABOFAIL2 F 3 ABO F 3 Aborting defragmentation processes 5 14 optimization processes 5 14 scripts 6 27 ABORTNOTDONE F 3 ABOS F 3 ABOSEEN F 3 ACCESSERR F 3 ACLERR F 3 ASSIGNERR F 3 Automatic hotfile recognition 3 3 4 8 5 10 6 14 BADPRI F 3 BITMAPCONERR F 4 BITMAPOPENERR F 4 BITMAPREADERR F 4 C CACHEFLUSHERR F 4 Callable interface 7 1 definition 7 1 CANCELED F 4 CANCELNOTDONE F 4 CANFAIL1 F 4 CANFAIL2 F 4 Cathedral window 1 12 CHECKSUMERR F 4
224. etermine whether the header data is valid Since the size of the file header is fixed files with a great deal of mapping or access control information require more than one header A file in this condition is called a multiheader file and is described by multiple file headers that are chained together Multiheader files are typically large and fragmented and they may span multiple volumes on a volume set 1 10 Overview of the Disk File Optimizer Overview of the Disk File Optimizer 1 3 Basic File and File System Concepts Of the various areas in the file header the map area is especially important from a file fragmentation standpoint This area shows how many pieces compose a file It also shows the size of the pieces The pieces themselves are contiguous and are called extents A retrieval pointer which in general contains a starting LBN and a size field describes each extent The Dump utility can display the extents of a file as shown in Example 1 1 Example 1 1 Viewing Retrieval Pointers Using the Dump Utility DUMP HEADER BLOCKS COUNT 0 FILE EXT Map area Retrieval pointers Count 42 LBN 1009767 Count 1347 LBN 1009851 Count 30 LBN 1011201 Count 33 LBN 1011237 This example shows that FILE EXT is fragmented into four extents each described by a separate retrieval pointer The first extent begins on LBN 1009767 and ends on LBN 1009808 a total of 42 LBNs Thus the location of the file s contents can be determined from t
225. eters volume name The volume name is the name of the volume containing the INDEXF SYS file to be defragmented Description The OFFLINE VOLUME subcommand defragments INDE XF SYS on the specified volume according to the selected command line qualifiers By definition INDEXF SYS has a minimum of four extents The extents consist of the following 1 Bootstrap block and home block 2 Backup home block 3 Backup index file header 4 Index file bitmap and file headers The minimum number of extents INDE XF SYS can have after defragmentation is five Before defragmenting the INDE XF SYS file do the following 1 Defragment and consolidate free space on the disk volume Consolidating free space on the disk volume gives DFO a place to create a new defragmented INDEXF SYS file 2 Check the free space summary to ensure there is enough free space on the disk volume to create a defragmented INDEXF SYS Use the following command to check the free space summary DEFRAGMENT SHOW disk volume VOL An example of the free space summary report is shown below Freespace Summary Total free space 211072 blocks Percentage free 10 rounded Total free extents 23 Maximum free extent 53316 blocks LBN 671852 Minimum free extent 4 blocks LBN 730360 Average free extent 9177 blocks Median free extent 584 blocks If you defragment the INDEXF SYS file without adequate free extent the defragmentation of INDEXF SYS could fail Using D
226. execution of myscript 4 DEFRAGMENT MODIFY C SCRIPT D This command changes the name of each script that ends in C to end in D For instance DAILYC becomes DAILYCD Using Defrag PLUS 4 41 DEFRAGMENT MONITOR DEFRAGMENT MONITOR The MONITOR subcommand displays the the progress of an ongoing defragmentation processes on a terminal Format DEFRAGMENT MONITOR 1 script name volume name ae NOLUME Parameters script name volume name The parameter for the MONITOR subcommand is either a script name or a volume name for Defrag PLUS You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign 96 to match a single character in the script name specification If a volume name is supplied then you must use the VOLUME qualifier to tell Defrag PLUS the parameter is a volume name rather than a script name Description The MONITOR subcommand provides current process statistics for the defragmentation process and information about the volume being defragmented The monitor displays this information on three window displays the process statistics display the process activities display and the free space display The process statistics display shows the following defragmentation process information Figure 4 1 e The defragmentation process I D e The defragmentation process name e The current date and time The name of th
227. f the directory name file name file type or file version number field The default file spec for all wildcard operations is DI SK 000000 Specifying TMP selects all TMP files on the entire volume 7 10 Callable Interface DFG DEFRAGMENT Note The file defragmentation utility automatically excludes system SY S files open files files excluded in an options file DF G K _ OPTIONS item code and files excluded using the DF G V __ HONOR and DFG V_INDEXED bits of the DFG K_DFG_FLAGS item code The uses of the buffer length buffer address and return length address fields for the DFG K_EXCLUDE item code are as follows e buffer length The length in bytes of a list of string descriptors pointed to by the buffer address This value must be a multiple of eight buffer address Address of a list of string descriptors Refer to Figure 7 2 return length address Not used must be zero DFG K FILE The DEFRAGMENT FILE command identifies the files to defragment on a specific volume You must supply either this item code or the DFG K VOLUME item code The uses of the buffer length buffer address and return length address fields for the DFG K FILE item code are as follows buffer length Contains the length in bytes of a list of string descriptors pointed to by the buffer address This value must be a multiple of eight buffer address Adaress of a list of string descriptors Refer to
228. fied by the PRIORITY qualifier or defaults to three DORMANT file spec NODORMANT default The DORMANT qualifier indicates files to be considered dormant when final file placement decisions are made Dormant files are placed at the high end of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described EPILOGUE file name NOEPILOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures EXCLUDE file spec NOEXCLUDE default Using Defrag 3 37 DEFRAGMENT VOLUME The EXCLUDE qualifier specifies files to be 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 Note The defragmentation process always excludes system files open files files excluded in an options file OPTIONS qualifier and files exclude
229. file metadata is stored in the file header directory entries and in memory data structures The user data area is composed of virtual blocks of 512 bytes The virtual blocks that make up the user data area of a file are always contiguous and are numbered from 1 to n where n is the number of virtual blocks in the file These numbers are called virtual block numbers VBNs One of the primary functions of the FCP is to map these virtual blocks to their corresponding logical blocks on a volume Like virtual blocks logical blocks are 512 bytes Unlike virtual blocks logical blocks are numbered from 0 to n 1 and the numbers are called logical block numbers LBNs The logical blocks that make up a file do not have to be contiguous As more and more files are manipulated on a volume there are fewer available contiguous logical blocks Free space may be fragmented into many small areas Eventually the FCP creates or extends a file so that portions of it reside on different parts of the disk This is file fragmentation a simple example of which is shown in Figure 1 2 In general the effects of file fragmentation are not appreciable until the allocated space on a volume reaches 70 to 80 percent of the available space The FCP allocates and extends files in units called clusters Each cluster contains one or more logical blocks The number of logical blocks in a cluster is called the volume duster factor The FCP allocates disk blocks by sequenti
230. file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume In Options The Options File option provides an alternate method for File associating files with the Dormant File Exclude File or Frequent File options You may enter the file name or use the file list button to bring up a list of files to chose from If the list of files for any of these options is long you can create a separate file for this information Each record of the options file consists of a file name followed by one of these keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e 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 6 16 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 1 3 Schedule a Script Dialog Box The Schedule Definition dialog box allows you choose many different script or defragmentation schedule parameters Figure 6 9 shows the Schedule Definiti
231. for the volume name specification Defrag aborts all defragmentation processes on the VAXcluster system If you use a percent sign to match a particular character in the volume name specification Defrag aborts the defragmentation processes on the volumes in the VAXcluster system with names meeting the specification For example to abort defragmentation processes on all DUA drives in the VAXcluster system use DUA for the volume name specification Description The ABORT subcommand terminates execution of the defragmentation process es associated with the volumes specified on the command line The process is terminated in an orderly fashion The defragmentation process completes current functions executes housekeeping functions and then exits leaving the volume fully usable and accessible Restrictions e The volume name parameter is not allowed if the ALL qualifier is used Qualifiers ALL NOALL The ALL qualifier aborts all defragmentation processes on the system This is equivalent to using an asterisk for the volume name specification Examples The following are examples of the ABORT command 1 DEFRAGMENT ABORT DISKSUSER1 This command aborts the defragmentation process currently executing on volume DISK USERI1 Using Defrag 3 9 DEFRAGMENT ABORT 2 DEFRAGMENT ABORT ALL This command aborts all defragmentation processes on all volumes in the VAXcluster system 3 10 Using Defrag DEFRAGMENT ATTACH
232. fore running the optimize process e Execute an epilogue command file after running the optimize process Figure 5 8 shows the Schedule Definition dialog box and Table 5 4 describes the dialog box information fields Figure 5 8 Schedule Definition Define Restrict Schedule Schedule ime Limit See 4 Do Not Wait For Completion Time Limit oo lt gt wait For Completion Detault Priority CPU Limit i 5 a Limit Minimum Priority 2 Epilogue File post processing 5 12 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Table 5 4 Schedule Definition Dialog Box Fields Field Description Do Not Wait For Completion This option allows the interface to be free while the optimization process completes Selecting the Wait For Completion keeps the interface under the defragmentation process until it completes This has the same effect as the WAIT DCL qualifier CPU Limit Enter into this filed the percentage of CPU usage for any one optimization process The CPU percent is the percent of a single CPU resources This has the same effect as the CPU LIMIT qualifier I O Limit Enter int this field the maximum direct I O rate per second of any one optimize process This has the same effect as the IO LIMIT qualifier Time Limit Specifies the delta time allowed for a given defragmentation operation This
233. fragmentation report enter the following command DEFRAGMENT SHOW DISKSONE VOLUME This command generates a fragmentation index free space summary and file fragmentation summary The fragmentation index is an estimate of the level of fragmentation on the specified volume Its value is derived from the number of files on the volume their sizes the number of extents in those files and the state of the free space on the volume The file and free space fragmentation summary provide more detail on the fragmentation index Refer to Refer to Appendix C for more information on this report Other options available show file and free space histograms list all free space holes list all files with more than a given number of extents and provide locations for specified files 4 3 3 3 Creating a Named Periodic Script The following command is an example of a defragmentation operation Qualifier values can be changed to meet your needs DEFRAGMENT VOLUME DISKSONE SCRIPT DEFRAG_1 LEVEL 2 LOG DEFRAG 1 L0G INTERVAL 7 0 NODE NODE 1 This command assigns a name of DEFRAG 1tothis script Candidate files are selected on the basis of whether they meet LEVEL 2 file qualifications A log file will be written to DEFRAG 1 LOG Additionally because no start time was indicated script DEFRAG 1 begins executing immediately and will execute at the same time every seventh day NTERVAL 7 0 thereafter Using Defrag PLUS 4 5 Using Defrag PLUS 4 3
234. g Defrag PLUS 4 67 DEFRAGMENT VOLUME CONSOLIDATE_FREESPACE default NOCONSOLIDATE_FREESPACE The CONSOLIDATE_FREESPACE qualifier tells the Disk File Optimizer to use its free space consolidation algorithm CONTINUOUS NOCONTINUOUS default The CONTINUOUS qualifier causes the script to execute repeatedly After each successful defragmentation operation the script becomes eligible for execution again As long as any PROCESS LIMITs see the SET subcommand are not violated the script executes repeatedly If all PROCESS LIMITs have been reached the script is queued until an outstanding defragmentation process completes then the script is allowed to execute By default the defragmentation process associated with a script may execute on any appropriately licensed node in a cluster Thus successive defragmentation processes do not necessarily execute on the same node DORMANT file spec NODO RMANT default The DORMANT qualifier indicates files to be considered dormant when final file placement decisions are made Dormant files are placed at the high end of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does no
235. g error please submit an SPR Explanation This is an internal error User Action Submit an SPR CONNECTERR CONNECT error on log file AD Explanation The RMS CONNECT service failed for the log file occurs in the defragmentation process Associated messages provide the root cause User Action Refer to associated messages to determine a course of action CONSFAIL free space consolidation failed for AD Explanation Free space consolidation failed for the given disk User Action None unless indicated by other messages COPYERR error copying information between INDEXF SYS and DFG DEFRAG INDEXF DAT Explanation Attempt to copy information between the INDE XF SYS file and the 000000 DF G DEFRAG INDEXF DAT failed User Action Remount the volume and run analyze disk repair You may also wish to delete the scratch file CPUOUTRNG SL is an invalid CPU percentage use 0 100 Explanation User specified a CPU percent utilization limit that was not within the 0 100 range User Action Specify valid CPU percentages from 0 to 100 inclusive CREATED AD created Explanation The specified script has been created User Action NONE CREATEERR error creating AD Explanation The CREATE RMS service failed for the specified file Associated messages provide the root cause User Action Refer to associated messages to determine a course of action CREPRCFAIL error creating detached defragmentation process Explanation Th
236. gical allows you to change the amount of data that is transferred at one time On a volume that has files with large extents you could wait up to 20 minutes while the system transfers these large extents before you could access the file By defining this logical you could access this file in less than a minute This logical changes the impact that the Disk File Optimizer has on applications that are simultaneously accessing the same files This logical is set to 10 000 blocks by default You can change it by editing SYS STARTUP DFG STARTUP COM and then executing the command procedure Disk File Optimizer Logicals and Files B 3 C DEFRAGMENT SHOW Command Report C 1 Introduction This appendix describes the report you receive from a SHOW command of a volume for the Disk File Optimizer DFO This appendix describes the meaning of each line in the report DEFRAGMENT SHOW Command Report C 1 DEFRAGMENT SHOW Command Report C 2 Output from the SHOW Command C 2 Output from the SHOW Command The following shows the output of the SHOW command with explanation notes DEFRAGMENT SHOW DISKSALPHA070 VOLUME Disk File Optimizer for OpenVMS DFG 2 6 2001 Compaq Computer Corporation Fragmentation Report DISKSALPHA070 04 APR 2001 16 14 10 93 The fragmentation index is 17 2 1 1 20 9 is excellent 21 40 9 is good 41 60 9 is fair 61 80 9 is poor 81 100 indicates a badly fragmented disk Approximately 12 6 out of 8
237. ging from 0 to 100 inclusive Enter values for O LIMIT and PROCESS LIMIT as integers 70 A value of zero for any of these parameters imposes no limit e None NODE node namef NONODE default 4 56 Using Defrag PLUS Examples DEFRAGMENT SET The NODE qualifier limits the scope of the SET subcommand By default a given parameter is set identically on all nodes in the scheduling database To limit parameters to fewer nodes specify the node names with the NODE qualifier The following examples show how to set limits using the SET subcommand and its qualifiers DEFRAGMENT SET PROCESS LIMIT 3 IO LIMIT 14 NODE NODE 1 In this example the maximum number of defragmentation processes that can occur on NODE 1is 3 Further a restriction of 14 direct I Os per second is placed on each of these 3 defragmentation processes DEFRAGMENT SET CPU LIMIT 50 In this example the maximum CPU resources allocated to any defragmentation process is set to 50 percent on all nodes in the system If a defragmentation process exceeds this limit its priority is decremented each minute approximately until it reaches the SYSGEN parameter DEFPRI minus 1 Using Defrag PLUS 4 57 DEFRAGMENT SHOW DEFRAGMENT SHOW Format Parameters Description The SHOW subcommand displays information about the fragmentation state of the given volume and information from the scheduling database ALL COMMAND LINE DEVICE FILE_LIS
238. gment software Explanation The script name chosen is reserved for the exclusive use of the defragmentati on software User Action Choose a different script name and re enter the command SCHEDERR scheduler cannot complete scheduling tasks Explanation This is a summary message indicating that the scheduler did not complete all its scheduling tasks User Action Refer to associated messages to determine a course of action SCHEXIT scheduler exited at user request Explanation The scheduler exited normally This occurs if the user executes the DFG STOP SCHEDULER COM procedure runs the SYS SYSTEM DFG STOP SCHEDULER EXE image or executes the DFG SHUTDOWN COM procedure User Action None SCHINITERR Scheduler initialization failed on AD Explanation The initialization portion of the DFO scheduler has failed Additional messages provide the nature of the failure User Action Take action based on the accompanying messages then restart the scheduler Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages SCHNOTEXC No scheduler available to process this command Explanation A command was issued that will not execute because an appropriate scheduler process is not running If the command was directed at any node no scheduler is running on the cluster If the command was directed at particular nodes none of those nodes have running schedulers User Action Start a scheduler on an appropriate
239. has the same effect as the TIME_LIMIT DCL qualifier Priority This is the priority that the OpenVMS scheduler uses for the defragment volume operation The default priority is set at 4 The minimum priority is set at 3 This has the same effect as the PRIORITY XDEFAULT n MINIMUM 2n DCL qualifier Prologue File Epilogue File The Prologue File option identifies a DCL command file that DFO executes just before the defragmentation operation starts This has the same effect as the PROLOGUE DCL qualifier The Epilogue File option identifies a DCL command file that DFO executes upon completion of the defragmentation operation This has the same effect as the EPILOGUE DCL qualifier 5 3 2 Optimize Selected Files The Optimize Selected Files menu selection permits you to optimize a particular file or files 1 Pull down the Optimize menu 2 Select Selected Files 3 Define the optimize parameters using the procedures in Section 5 3 1 1 4 Restrict special files by pressing the restrict button and using the procedure in Section 5 3 1 2 Schedule the optimize process using the procedure in Section 5 3 1 3 ul 6 Start the optimize process by pressing the OK or Apply button The DECwindows Interface for Defrag 5 13 The DECwindows Interface for Defrag 5 3 Optimize Menu 5 3 3 Optimize Volume Index File The Optimize Volume Index File selection permits you to defragment the INDEXF SYS file from a select
240. he keystrokes that manipulate the monitor displays e Ctrl C Ctrl Y or Ctrl Z exit the monitor e Ctrl W refreshes the screen and erases the message display e Nor Next Screen switches to the next display e Por Previous Screen switches to previous display Using Defrag PLUS 4 45 DEFRAGMENT MONITOR Figure 4 4 Process Statistics Display with Message Display File Edit Commands Options Print Defragmentation Process Activities File Evaluation Dormant ecount Files evaluated 4 Exclude count Candidate count 4 Frequent count Total placed files n Total indexed files 1 File Defragmentation Files partly defragmented 0 Files defragmented Files proceszed File Placement Free Space Consolidation Dormant files placed 0 Extent count i5 Frequent files placed 0 Countdown 54 727346 DFGDCL CPU 00 02 42 15 PR 23306 ID 35965 MEM 202 37T 47 DFGDCL CPUz00 02 43 1 PF 33306 IOz35588 MEM 302 127243 DFGDCL CPU S00 102 43 18 PR 33306 I0 35 91 MEM 302 37T 48 DFGDCL CPU 00 02 43 1 PP 33306 ID 35294 MEM 302 e R or Remove removes the message display e Ctrl T scrolls through the broadcast messages Restrictions e If avolume name is entered as a parameter the VOLUME qualifier must be used Qualifiers CONTINUOUS default NOCONTINUOUS The CONTINUOUS qualifier invokes a continuous monitor display Entering Ctrl C Ctrl Y or Ctrl Z terminates this dis
241. he retrieval pointers found in the file header 1 3 2 Extent Mapping Windows Whether multiple extents cause a performance problem depends upon a number of variables one of which is the extent mapping window for the given file The extent mapping window is an in memory structure that contains the same information as the on disk retrieval pointers for a file The size of the window determines the number of retrieval pointers that can be mapped concurrently The default window size is seven meaning seven extents can be mapped at the same time You can use the following methods to set the window size e The DCL command INITIALIZE device name WINDOWS n e The DCL command MOUNT device name WINDOWS e TheFABS B RTV field at file open time e TheFDL attributes FILE WINDOW SIZE e The system parameter ACP WINDOW if the disk is mounted SYSTEM If all the retrieval pointers to a file cannot fit into the mapping window the FCP may need to read additional retrieval pointers from disk to map a different portion of the file This operation is called a window turn A window turn requires one extra I O and can therefore affect performance By default the four extents of FILE EXT shown in Example 1 1 can be mapped into memory at the same time No additional I O operation is required to find the location of any of the four extents Overview of the Disk File Optimizer 1 11 Overview of the Disk File Optimizer 1 3 Basic File and File System Concepts
242. he user enters the DEFRAGMENT FILE or DEFRAGMENT VOLUME command At this point if you are running the Defrag variant of the software go directly to Step 5 The database interface stores the command information in the database notifies the schedulers if appropriate and returns the user to the operating system A separate autonomous scheduling process reads the stored information using the database interface and determines when the volume or file should be defragmented At the appropriate time the scheduler starts a defragmentation process that is dedicated to defragmenting the target volume or file Overview of the Disk File Optimizer 1 5 Overview of the Disk File Optimizer 1 2 Product Description Figure 1 1 Command Operation DEFRAGMENT VOLUME DUA1 USER INTERFACE DATABASE INTERFACE SCHEDULING DATABASE SCHEDULER DEFRAGMENTATION PROCESS CXO 3146A 5 The defragmentation process defragments the target volume or file For the example shown in Figure 1 1 the target volume is DUAL 1 2 5 2 Prologue and Epilogue Files Under some circumstances you want to perform some special processing before and after files undergo the defragmentation process Using the PROLOGUE and EPILOGUE qualifiers with DCL command files you can e Check the status of the disk to ensure defragmentation is needed e Take a snapshot of files or disks before and after the defragmentation process to monitor results
243. he user supplied buffer f DFG K NODE is present The process limit for each node supplied in the DFG K NODE item descriptor f DFG K NODE is not present The default process limit applied to all nodes that do not have an explicit process limit A DFG K NODE item descriptor may be associated with the DFG K SHOW PROCESSES item descriptor DFG K NODE can indicate any positive number of node names If multiple node names are requested DF G DEFRAGMENT returns the process limit for each node in the same order as the node names provided If the user buffer is too small for all data the data is truncated and DFG DEFRAGMENT returns an appropriate status DFG K SHOW PROCESSES may be the first item descriptor in an item list that optionally contains other DFG K SHOW XXXX item descriptors and a DFG K NODE descriptor The uses of the buffer length buffer address and return length address fields for the DFG K SHOW PROCESSES item code are as follows buffer length Size of the user supplied buffer in bytes This buffer must be at least number of nodes x 4 bytes and an integral multiple of four e buffer address Address of the user supplied buffer into which DFG DEFRAGMENT writes the maximum processes information return length address Address of a longword buffer into which DFG DEFRAGMENT writes the number of bytes returned in the buffer pointed to by the buffer address Callable Interface DFG DEFRAGMENT DFG K_
244. hing was wrong with the semantics of the dfg list or a particular item descriptor was formatted improperly Both the sch list and the dfg list parameters are invalid The DFG K INTERVAL item descriptor is not allowed with the DFG K PREDECESSOR item descriptor in a call to DFG DEFRAGMENT The scheduler list passed to DFG DEFRAGMENT is invalid A required logical name is not defined The user had insufficient privileges to run the file defragmentation utility A REMOVE subcommand issued for this script had not yet completed when another REMOVE subcommand for the same script was issued Attempt to disable a script that was already disabled Attempt to enable a script that was already enabled A START command issued for this script had not yet completed when another START command for the same script was issued Callable Interface 7 37 Callable Interface 7 4 DFGSRELEASE MEMORY Routine 7 4 DFG RELEASE MEMORY Routine This section describes the DFG RELEASE MEMORY routine 7 38 Callable Interface DFG RELEASE_MEMORY DFG RELEASE MEMORY Format Description Returns Arguments The DFG RELEASE MEMORY routine allows you to free memory allocated to you in response to a DFG DEFRAGMENT call to show a script refer to the DFG K SHOW SCRIPT argument to the DFG DEFRAGMENT call This call returns the address and length of the buffer created DFGSRELEASE MEMORY item list DFG RELEASE MEMORY frees memory allocated to satisfy
245. hm is to sequentially search the extent cache and use free space as it is available user D receives clusters 4 6 and 10 12 Blocks 7 9 are already allocated This is shown in the last part of Figure 1 3 Overview of the Disk File Optimizer 1 9 Overview of the Disk File Optimizer 1 3 Basic File and File System Concepts Figure 1 3 Allocating Fragmented Files 1 2 3 4 5 6 7 8 9 10 11 12 1 2 3 4 5 6 7 8 9 10 11 12 1 2 3 4 5 6 7 8 9 10 11 12 CXO 3148A 1 3 1 File Header Information A file header which is physically separate from the file it describes describes each file on a Files 11 volume All file headers are contained in the INDEXF SYS file located in the Master File Directory MFD The file header contains all the information necessary to access the file The FCP RMS the Dump utility and the Backup utility use the file header The defragmentation process uses the file header to determine the state of the file before and after defragmentation The file header contains the following areas Header area Header validation information file ID ownership and protection codes and offsets to the other areas e Ident area Primarily accounting information e Map area List of retrieval pointers used to perform the VBN to LBN mapping e Access control list area Primarily information about who can access this file e Reserved area Not used by the FCP It is available for use by user programs e Checksum Helps d
246. i Appendix E shows an example of a full log file Appendix F lists and describes the error messages generated by the Disk File Optimizer software Related Documents OpenVMS License Managenent Utility Manual OpenVMS Performance Managenent OpenVMS DCL Dictionary OpenVMS System Manager s Manual OpenVMS System Management Utilities Reference Manual Guide to OpenVMS File Applications OpenVMS Record Management Utilities Reference Manual VAX Performance Advisor VPA Documentation Kit Order numbers for these documents can be obtained from your Compaq sales representative Conventions The following conventions are used in this manual Convention Meaning parameter In command formats braces indicate required parameters Do not enter the braces when you enter the parameter in a command parameter In command formats square brackets indicate optional parameters Do not enter the brackets when you enter the optional parameters In interactive procedures square brackets denote default responses italic text In examples and messages italic text represents input that is unique for each system boldface text Boldface text is used for emphasis Ctrl x Control key sequence indicates that you hold down the Ctrl key while you press another character key for example Ctrl W or Ctrl C In examples a vertical ellipsis represents the omission of data that the system displays in response to a command or data
247. ide more detail User Action Refer to associated messages to determine a course of action DELERR cannot delete AD notification message Explanation An attempt to spawn a subprocess to delete the mail message sent as a result of the MAIL_NOTIFICATION qualifier failed This error occurs in the scheduler code User Action Refer to associated messages to determine a course of action DFGNOSTART defragmentation process failed to start Explanation This message occurs when a defragmentation process cannot be started Associated messages indicate why This message does not occur with Defrag PLUS User Action Refer to associated messages to determine a course of action DFGSTART started defragmentation process PID XL Explanation This message indicates that a defragmentation process has been started This message does not occur with Defrag PLUS User Action None DFGTMO defragmentation process timed out on startup Explanation The defragmentation process did not map the global section created by the scheduler within a timeout period User Action Ensure a copy of DFG ENGINE_MAIN exists in SYS SYSTEM and try the command again If the error persists submit an SPR DIOOUTRNG SL is an invalid direct I O limit use positive values Explanation The user specified a negative number for a direct I O limit User Action Specify positive values for the lO LIMIT keyword parameter DIRVERERR directory file AD is not DIR 1 Explanat
248. ied DEFRAGMENT MODIFY B PREDECESSOR D When the predecessor field of a script that is part of a linked set of scripts is modified that script is first removed from any linked set of scripts After it is removed the script is placed in the new linked set as indicated by the PREDECESSOR qualifier Thus B is removed from its linked set of A B C and made the successor of D Two linked sets of scripts are now present A C and D B E F To remove a script from a linked set of scripts specify the NOPREDECESSOR qualifier as shown in this example DEFRAGMENT MODIFY B NOPREDECESSOR This command removes B from its linked set of scripts From the previous example the linked scripts are now A C and D E F Script B is no longer part of a linked set of scripts and operates according to its own scheduling characteristics The following example places script B back in its original position DEFRAGMENT MODIFY B PREDECESSOR A After executing this command there are again two sets of linked scripts A B C and D E F 4 3 3 7 Saving Database Contents The entire or selected contents of the database may be saved in a command file The following command saves the entire database in a file called MY_DB_ CONTENTS COM DEFRAGMENT SHOW ALL PARAMETERS COMMAND_LINE OUTPUT MY_DB_CONTENTS COM MY_DB_CONTENTS COM now contains a list of valid defragment command lines that describes all the scripts and I O process and CPU limits f
249. ield e Cancel to quit and not produce any further output The DECwindows Interface for Defrag Plus 6 23 The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 5 Schedule a Script This section describes how to schedule a defragmentation script Use the following procedure to schedule scripts and manage script schedules 1 Select the Script pull down menu 2 Select the Schedule Script option of the Script pull down menu for the script list box See Figure 6 13 Figure 6 13 Script List Dialog Box Select Scripts to Schedule OMM AND DEFRAG 1 DK Ad EFRAC 1 DK A100 EFRAC 1 DK A300 EFRAG SIDR BO EFRAG 15DE B200 DEFRAG _ 1 DK B300 JADE B00 ies 3 Select all the scripts you want for scheduling actions from the Script list and dick on either the OK or the Apply button This will bring up the Schedule Scripts dialog box Refer to Figure 6 14 6 24 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu Figure 6 14 Schedule Script Disk File Optimiser Schadule Script t CANCEL i DISABLE C ENABLE C START O START AFTER mmm 4 Take any of the actions on the script outlined in Table 6 5 5 To finish the scheduling action click on OK button to apply the modifications and leave the dialog box Cancel button to quit and not take any scheduling actions on the named script Apply button to apply the scheduling options selected You m
250. ile 1 Most Fragmented File SYSEXE SYSSQUEUE_MANAGER QMANSJOURNAL 1 8179 extents C 8 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command Example C 5 User Volume With System Log Files File Fragmentation Histogram File Fragmentation Histogram Extent Count 23 To 8179 3 7 7 6 31 5 77 4 152 3 F 315 2 658 1 KKEKKKKKKKKK kk kk kk e Sk KE ke kk kk e v e e k KR kk e k kx kx kk ko kx kx kk 9902 Number of files with a given number of extents Each corresponds to 200 files DEFRAGMENT SHOW Command Report C 9 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command Example C 6 User Volume With System Log Files Volume Free Space Histogram Volume E fO Space Histogram Freespace Size LBNs 171 1 65 2 62 1 59 401 56 1 53 2 44 1 41 2 38 ee 2 35 2 32 1 26 3 23 1 20 1 17 1 14 3 11 4 08 1 05 2 02 41 99 4 96 3 90 1 87 1 84 3 81 1 78 2 75 1 72 3 69 2 66 3 63 2 60 1 57 KKKKKK 6 54 FEE a 51 1 48 PER S 45 KKKKK 5 42 2 39 kkkkk 8 36 KKKKKKK 7 33 KKKK 4 30 KKKKKKK 7 27 kkkkkk 8 24 KKKKKKKKEKKK 11 21 KKKKKKKKK 9 18 kkkkkkkk k k 11 15 ockckckckck kk kc kk kk kA 15 12 kkkxkx
251. ile placement 04 APR 2001 10 52 44 66 Statistics Number of files processed 100 Number of files defragmented 0 Number of files partly defragmented 0 Number of frequent files placed 100 Number of dormant files placed 0 Begin dormant file placment 04 APR 2001 10 Files processed during dormant file placement Dd DISKSJIM DFO TEST 1 DFO TEST 1 L TXT 10 1 extent Dd DISKSJIM DFO TEST 1 DFO TEST 1 L TXT 3 1 extent Dd DISKSJIM DFO TEST 1 DFO TEST 1 L TXT 6 1 extent Dd DISKSJIM DFO TEST 1 DFO TEST 1 L TXT 9 1 extent End dormant file placment Statistics Number of files processed Number of files defragmented Number of files partly defragmented Number of frequent files placed Number of dormant files placed Begin free space consolidation There are 9 consolidation areas Beginning consolidation pass on area 8 LB Beginning consolidation pass on area 7 LB Beginning consolidation pass on area 6 LB Beginning consolidation pass on area 5 LB Beginning consolidation pass on area 4 LB Beginning consolidation pass on area 3 LB Beginning consolidation pass on area 2 LB Beginning consolidation pass on area 1 LB Beginning consolidation pass on area 0 LB End free space consolidation Begin file defragmentation phase one Files processed during defragmentation Symbols preceding a file name indicate E 4 Full Log File Example V 971163 V 1015065 V 880302 V 870408 9891 blocks V 885588 0
252. iles analyzed and number of files defragmented e The Full option lists all files analyzed by the defragmentation process and reports their disposition during each phase of defragmentation This has the same effect as the LOGHog_file and FULL or BRIEF DCL qualifier continued on next page The DECwindows Interface for Defrag 5 7 The DECwindows Interface for Defrag 5 3 Optimize Menu Table 5 1 Cont Define Dialog Box Fields Field Description Console Message The console message option requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM This has the same effect as the OPCOM _ NOTIFICATION DCL qualifier Table 5 2 Translations of Operations to DCL Command LEVEL x Volume Analysis Defragment Files Sliding Bar Consolidate Free Space Only LEVEL Selected LEFT 1 Selected MIDDLE 2 Selected RIGHT 3 Not Selected Selected 4 Not Selected Not Selected Selected 5 5 3 1 2 Restrict Special Files The Restrict Special Files dialog box allows you to include or exclude any special files during the defragmentation process You can exclude files such as Files placed by the User e RMS Indexed Files e Excluded Files You can also exclude the following types of Placed Files e Files in the hotfile database e Dormant files Frequent files Figure 5 7 shows the Restrict Special Files dialog box for a volume and Table 5 3 describes the information fie
253. imit for each node supplied in the DFG K NODE item descriptor If DFGS K NODE is not present The default I O limit applied to all nodes that do not have an explicit I O limit A DFG K NODE item descriptor may be associated with the DFG K SHOW IO item descriptor DFG K NODE can indicate any positive number of node names If multiple node names are requested DF G DEFRAGMENT returns the I O rate for each node in the same order as the node names provided If the user buffer is too small for all data the data is truncated and DF G DEFRAGMENT returns an appropriate status DFG K SHOW lO may be the first item descriptor in an item list that optionally contains other DFG K SHOW XXXX item descriptors and a DFG K NODE descriptor DFG DEFRAGMENT The uses of the buffer length buffer address and return length address fields for the DFG K_SHOW_IO item code are as follows buffer length Size of the user supplied buffer in bytes This buffer must be at least number of nodes x 4 bytes and an integral multiple of four e buffer address Address of the user supplied buffer into which DFG DEFRAGMENT writes the current maximum 1 0 data return length address Address of a longword buffer into which DFG DEFRAGMENT writes the number of bytes returned in the buffer pointed to by the buffer address DFG K SHOW PROCESSES When the DFG K SHOW PROCESSES item descriptor is encountered DFG DEFRAGMENT returns the following data in t
254. invokes HELP from within the Disk File Optimizer utility 4 32 Using Defrag PLUS DEFRAGMENT MODIFY DEFRAGMENT MODIFY Format Parameters Description The MODIFY subcommand allows you to change the qualifiers associated with a particular script DEFRAGMENT MODIFY script name script name AFTER BRIEF CONSOLIDATE FREESPACE CONTINUOUS DORMANT EPILOGUE EXCLUDE FILES FREQUENT FULL HOTFILE_DATABASE IGNORE INTERVAL LEVEL ILOG MAIL_NOTIFICATION NODE OPCOM_NOTFICATION OPTIONS PREDECESSOR PRIORITY PROLOGUE RVN SCRIPT TIME LIMIT NOLUME WRITE_CHECK The script name parameter identifies the script to modify You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification The MODIFY subcommand modifies specified portions of an existing script This is easier than using the INHERIT subcommand to do similar things Using Defrag PLUS 4 33 DEFRAGMENT MODIFY Restrictions e A script that has the CONTINUOUS qualifier may not be named as the predecessor of another script e f you specify the ANTERVAL qualifier the PREDECESSOR qualifier is not allowed If LEVEL is selected the LOG qualifier is required e Donot use BRIEF and FULL concurrently e Do not use CONTINUOUS and INTERVAL for a script Qualifiers
255. ion A file with the directory flag set in its file header is not version 1 or does not have the extension DIR User Action Rename or delete the file DISABLED AD disabled Explanation The script has been disabled User Action NONE or enable the script DISFAIL1 failed to disable AD Explanation This is a summary message indicating DFG DEFRAGMENT returned a failure status for a DISABLE command This failure is related to a specific script supplied in the message Associated messages provide the cause of the failure User Action Refer to associated messages to determine a course of action Defragmentation Messages F 9 Defragmentation Messages F 2 Disk File Optimizer Messages DISFAIL2 noscript was disabled Explanation This is a summary message indicating the specified script was not disabled Associated messages indicate the reason the disable operation failed User Action Refer to associated messages to determine a course of action DISKFULL disk AD too full for defragmentation Explanation This error occurs when the defragmentation process finds that a disk is too full for defragmentation The process experiencing the error will terminate if a single volume or a stripe set was defragmented or continue with the next volume in the volume set User Action None DSDCMDO DEFRAGMENT OFFLINE_VOLUME AD Explanation Displays DEFRAG command line when showing scripts with the COMMAND qualifier User Action None
256. ion Refer to associated messages to determine a course of action CANFAIL1 failed to cancel AD Explanation DFG DEFRAGMENT returned a failure status when it attempted to cancel the specified script This message is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course of action CANFAIL2 no script was canceled Explanation DFG DEFRAGMENT returned a failure status when it attempted to cancel all scripts in the scheduling database This message is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course of action CHECKSUMERR Error when copying map pointers for INDEXF SYS Explanation An error occurred when mapping the new INDEXF SYS header pointers User Action Submit an SPR F 4 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages CLOSEIN error closing AD as input Explanation An RMS error was encountered when trying to close an input file such as the options file Associated messages provide more detail User Action Refer to associated messages to determine a course of action CLOSEOUT error closing AD as output Explanation An RMS error was encountered when trying to close an output file Associated messages provide more detail User Action Refer to associated messages to determine a course of action CMDUNKNOWN unknown command parsin
257. ipts Defragmentation commands are stored in the scheduling database as scri pts When a script is entered into the scheduling database a permanent record of that script is created This provides a great deal of flexibility and allows commands to be issued and executed from any node within a cluster You can create scripts that e Run immediately after a specified time or at defined intervals Remain in the database for future use e Delete after running once Using Defrag PLUS 4 3 Using Defrag PLUS 4 3 Scripts 4 3 1 Creating and Using Scripts Creating permanent scripts that run periodically eliminates the need for operator intervention and prevents the build up of fragmented files on the disk Usually once you set up a Script to run on a routine schedule no further intervention is required Refer tothe DEFRAGMENT START command in Section 4 6 to restart scripts after a system or node failure To create a script and schedule defragmentation operations use the DEFRAGMENT FILE or DEFRAGMENT VOLUME command If you need to defragment a file or a small group of files use the DEFRAGMENT FILE command If you need to defragment a large group of files a volume or several volumes use the DEFRAGMENT VOLUME command for example DEFRAGMENT VOLUME volume name QUALIFIERS Where volume name is the name of the target device QUALIFIERS defines the desired script characteristics The scheduling and defragmentation qualifiers det
258. isk File Optimizer e SYS COMMON SYSMGR DF G DEINSTAL COM e SYS COMMON SYSMGR DFG SHUTDOWN COM e SYS COMMON SYSMGR DFG STOP SCHEDULER COM e SYS COMMON SY SMSG DF G M ESSAGE EXE e SYS COMMON SYSTEST DF G I VP COM If you install the GUI interface the following additional files are created e SYS COMMON DECW DEFAULTS USER DFG DW DAT e SYS COMMON DECW DEFAULTS USER DFG DW UID e SYS COMMON SYSEXE DF G DW E XE e SYS COMMON SYSHLP DF G DW HLB If you install the callable interface the following additional files are created e SYS COMMON SYSLIB DF G DEF FOR e SYS COMMON SYSLI B DF G DE F H e SYS COMMON SYSLIB DF GSDEF MAR e SYS COMMON SYSLIB DF G DEF PAS e SYS COMMON SYSLIB DF G DE F R32 1 1 4 1 B 2 Logical Names Logical names for the Disk File Optimizer begin with the prefix DFG Table B 1 describes each logical name Table B 1 Logical Names Logical Installation Name Variant Purpose DF G DATABASE Defrag PLUS Equates to the device dir specification where the database resides Also located in this directory are the scheduler log files which have a name of DFG _ xxxx LOG where xxxx is the name of the node on which the scheduler is running DF G DISK All Provided to the EPILOGUE and PROLOGUE command files It translates to the name of the disk on which DFO currently operates DFG MAIL_ADDRESS Defrag PLUS Equates to a file name containing a mail distribution list of those who should receive no
259. its the defragmentation to only those nodes listed Enter a node or nodes or click on the node list button for a list of nodes to choose from This has the same effect as the DCL qualifier NODEz continued on next page 6 18 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 4 Cont Schedule Definition Dialog Box Fields Field Description Epilogue The Epilogue File option identifies a DCL command file that DFO File executes upon completion of the defragmentation operation This has the same effect as the EPILOGUE DCL qualifier Prologue The Prologue File option identifies a DCL command file that DFO File executes just before the defragmentation operation starts This has the same effect as the PROLOGUE DCL qualifier The DECwindows Interface for Defrag Plus 6 19 The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 2 Modify a Script This section describes how to modify existing scripts Use the following procedure to modify a script 1 Pull down the Script menu 2 Select the Modify Script option and a Script List selection box appears See Figure 6 10 Figure 6 10 The Modify Script Dialog Box DFO Select Script to Modify DEFRAG 1fDK AO DEFRAG 15DK A100 DEFRAG 15DK A300 DEFRAG 1 DK B DEFRAG 15DK B200 DEFRAG 1 5DK B300 DEFRAG 18DKB4U0 DEFRAG S15DKBSO0 DEFRAG 28DK ATQO DEFRAG S25DKBO DEFRAG 328DK B
260. kxkkxkkkkkkkkkkkkkkkkkkkxkxk 28 9 KKKEKKKKKKKKKKKK 15 6 kckck ck kk kk kk kkkkkkkkkkkkkkkk 27 3 KKK KKK ck ko kk ck ke k kk e kx k e e kx k e kx kx x kx kx kx kx kk 35 continued on next page C 10 DEFRAGMENT SHOW Command Report DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command Example C 6 Cont User Volume With System Log Files Volume Free Space Histogram Number of freespace extents of a given size Each corresponds to 1 freespace extent DEFRAGMENT SHOW Command Report C 11 DEFRAGMENT SHOW Command Report C 3 Examples of the Output from the SHOW Command The following are numbers to note 1 Fragmentation index the 83 4 indicates this volume is badly fragmented But this is to be expected with this volume with large open fragmented log files and very little free space File fragmentation the 63 4 number appears to be bad but for this volume it cannot be improved Not shown by this report the volume has large open fragmented files These log files were moved to this volume to get them off the system disk For instance the most fragmented file has 8179 extends This file is also open and very large not shown by this report These factors make it impossible to get the fragmentation index down Freespace fragmentation the 20 0 number cannot be larger Notice the 303 total free extents These numbers are caused by these log files as explained for file fragmentation Perc
261. l scripts that reference this node name NOSCHED scheduling operations may not have completed Explanation One or more scheduling operations may not have completed This is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course of action NOSCRIPT script name AD is not defined in the database Explanation The named script is not defined in the database User Action Check the spelling of the script name and try the command again NOSCRNAM script name AD not found Explanation A script name specified by the user was not in the scheduling database User Action Check the spelling of the script name and try the command again NOSHODAT error retrieving show data from the scheduling database Explanation There was an error retrieving show data from the scheduling database User Action Refer to associated messages to determine a course of action NOSPECFILE AD file not found for script AD Explanation This error occurs when the scheduler tries to open an options prologue or epilogue file and the file cannot be found User Action Provide the needed file or remove the filename from the script definition or command line NOTACCVIO cannot access notification data in AD Explanation This is an internal error It occurs if one of the internal user notification routines is called with an inaccessible parameter User Action Submit an SPR NOTB
262. lanation A CONNECT RMS service was unsuccessful for the BITMAP SYS file of the target device The RMS error is provided in a subsequent message User Action Determine a course of action based on the RMS error reported BITMAPOPENERR OPEN error on file AD 000000 BI TMAP SYS Explanation A OPEN RMS system service could not be performed on the BITMAP SYS file of the target device The RMS error is provided in a subsequent message User Action Determine a course of action based on the RMS error reported BITMAPREADERR READ error on file AD 000000 BI TMAP SYS Explanation A READ RMS system service failed for the BITMAP SYS file of the target device The RMS error is provided in a subsequent message User Action Determine a course of action based on the RMS error reported CACHEFLUSHERR unable to flush extent cache for device AD Explanation An 0 ACPCONTROL extent cache flush QIO returned a failure status to the defragmentation process The root cause is induded in associated messages User Action Refer to associated messages to determine a course of action CANCELED Cancel queued for script AD Explanation The script has been canceled and will skip its next scheduled execution User Action NONE CANCELNOTDONE cancel unsuccessful Explanation A CANCEL subcommand was unsuccessful This is a summary message This message may or may not indicate an error Associated messages provide more detail User Act
263. ldcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification PRIORITY DEFAULT n MINIMUM n NOPRIORITY default The PRIORITY qualifier specifies priorities for the defragment process The minimum priority setting is used when the defragmentation process exceeds the value specified by either CPU LIMIT or IO LIMIT PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures RVN n RVN 0 default When you have a bound volume set use this qualifier to identify a disk from the volume set or all disks in the volume set The default of zero tells the Disk File Optimizer to defragment all disks in the bound volume set Specify a relative volume number RVN to defragment a specific disk that belongs to a bound volume set 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 an 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 e Any
264. lds 5 8 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Figure 5 7 Resirict Special File Dialog Box Restrict Schedule Exclude Files J Files Placed by User RMS Indexed Files C excluded Files Place Files Files in Hotfile Database L narmant Files L Frequent Files Place Files d P g Table 5 3 Restrict File of Dialog Box Fields Field Description Files Placed by User Select this button if you wish to ignore explicitly placed files This has the same effect at the IGNORE PLACED DCL qualifier RMS Indexed Files Select this button if you wish to ignore RMS indexed files continued on next page The DECwindows Interface for Defrag 5 9 The DECwindows Interface for Defrag 5 3 Optimize Menu Table 5 3 Cont Restrict File of Dialog Box Fields Field Description Excluded Files The Exclude Files option specifies files to be excluded from processing You may enter a file name in the file field or use the file list button to bring up a list of files to select from 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 The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file n
265. le DFG MAIL ADDRESS NODEz 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 OPCOM NOTIFICATION default NOOPCOM NOTIFICATION The OPCOM NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM OPTIONS file spec NOOPTIONS default The OPTIONS qualifier provides an alternate method for associating files with the DORMANT EXCLUDE or FREQUENT qualifiers If the list of files for any of these qualifiers is long you can create a separate file for this information Each record in the options file consists of a file name followed by one of the following keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e 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 FILE L 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 FILEl EXE FREQUENT ARCHIVE EXCLUDE OLDSTUFF DORMANT Files indicated by the EXCLUDE qualifier and by either the DORMANT or FREQUE
266. lect the Script Volume or Full Volume option of the Monitor pull down menu Refer to Figure 6 16 e 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 choose to monitor the volume by a script a Defragmentation Process Statistic Window and a Defragmentation Full Volume Map Window will appear Refer to Figure 6 18 Figure 6 19 and Table 6 6 e IF you want to identify the volume by name select the Volume or Full Volume option then select the volume name from the Volume List The volume options allows you to view different parts of the entire volume map use the arrows and scroll bars around the map on the defragmentation volume map window If you choose to monitor the Volume a Defragmentation Process Statistic Window and a Defragmentation Partial Volume Map Window will appear Refer to Figure 6 18 Figure 6 20 and Table 6 7 6 28 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume To view the full volume select the Full Volume option then select the volume name from the Volume List If you choose to monitor the Full Volume a Defragmentation Process Statistic Window and a Defragmentation Full Volume Map Window will appear Refer to Figure 6 18 Figure 6 19 and Table 6 6 3 To view more detailed information about the allocated space shown on the Defragmentation Volume M ap press mouse button 1
267. les placed frequent 100 files placed dormant 100 Accounting information continued on next page Full Log File Example E 5 Full Log File Example Example E 1 Cont Full Log File Buffered I O count Direct I O count Page faults Peak working set Charged CPU time Elapsed time Defragmentation process normal completion Process ID 20E0059A Device 1 DKBO0 Time 04 APR 2001 11 37 43 71 E 6 Full Log File Example 186560 3902971 5638 30032 01 10 27 54 Q0 20 53 33 93 f Defragmentation Messages F 1 General Message Information Most messages displayed by the VMS operating system contain a facility code a severity indicator an identification field and the actual text of the message They have the following format SFACILITY L IDENT text Where FACILITY indicates which VMS facility or layered produc is reporting the message L indicates how severe an error is being reported Table F 1 describes the severity indicators that may appear in this field IDENT is a mnemonic code that uniquely identifies the error within the reported facility text is the text of the message Table F 1 Severity Indicators Code Meaning S Success T hese messages indicate that the command is successful In some cases the command processing continues after issuing a success message In other cases the message indicates that the command processing is complete I nformation These messages pro
268. lifier are excluded Files indicated by the DORMANT qualifier and by the FREQUENT qualifier are considered dormant This rule is applied equally across all files specified in the OPTIONS file as well as those associated with these qualifiers on the command line PREDECESSOR script name NOPREDECESSOR default The PREDECESSOR qualifier identifies the name of the script that precedes the execution of this script in a linked set of scripts These scripts execute in sequence one successfully completes before the next one begins The predecessor script name must exist in the scheduling database or an error status message is returned You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification PRIORITY DEFAULT n MINIMUM n NOPRIORITY default Using Defrag PLUS 4 39 DEFRAGMENT MODIFY The PRIORITY qualifier specifies priorities for the defragment process The minimum priority setting is used when the defragmentation process exceeds the value specified by either CPU LIMIT or IO LIMIT PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures RVN n RVN 0 default When you h
269. lists it is exduded Note The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described 7 6 Callable Interface The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume The uses of the buffer length buffer address and return length address fields for the DFG K_CLASSIFY_DORM item code are as follows buffer length Contains the length in bytes of a list of string descriptors pointed to by the buffer address This value must be a multiple of eight DFG DEFRAGMENT buffer address Address of a list of string descriptors Refer to Figure 7 2 return length address Not used must be zero Figure 7 2 illustrates the data structures used with the DFG K CLASSIFY DORM DFG K CLASSIFY FREQ DFG K EXCLUDE DFG K FILE and DFG K NODE item codes Figure 7 2 Creating a DFG K XXXX Item with Descriptor List ITEM DESCRIPTOR ITEM CODE BUFFER SIZE 24 BUFFER ADDRESS RETURN LENGTH ADDRESS STRING DESCRIPTORS DFG K CLASSIFY FREQ STRING BUFFERS SECOND STRING
270. ll disks in the volume set The default of zero tells the Disk File Optimizer to defragment all disks in the bound volume set Specify a relative volume number RVN to defragment a specific disk that belongs to a bound volume set 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 e Any alphanumeric character e Underscoe e Hyphen e Dollar sign Using Defrag PLUS 4 29 DEFRAGMENT FILE Observe the following rules when naming a script e You may use any combination of uppercase and lowercase letters e DO not begin script names using the dollar sign However you can include the dollar sign within the script name The dollar sign is reserved for special use by Compaq Computer Corporation e Do not end a script name with a hyphen since the hyphen is the DCL continuation character TIME_LIMIT delta time NOTIME_LIMIT default The TIME_LIMIT qualifier specifies the maximum elapsed time allowed for a given defragmentation operation If the time limit is exceeded the defragmentation process is aborted Specify time as a delta time Refer to the OpenVMS User s
271. ll volume are allocated Figure 6 19 shows the full volume map window and Table 6 7 describes the window contents and how it functions Figure 6 19 Defragmentation Full Volume Map Window Disk File Optimizer Full Volume Map Start LEN of Window bp Phase File Placement Dormant volume DPA100 Allocated Space E Free Space Mix of Allocated End LEN 200000 and Free Spate of Window Blocks Grid 44 Blocks Free Blocks 66630 Current File DFO TEST 1 DFO TEST 1 LTXT 3 IEEE Indexed Placed Nomove Sx Exclude Dormant REND Table 6 7 Defragmentation Volume Map Window Description Field Description Start LBN of Window The starting LBN at the upper left corner of the viewport Phase The aurrent phase of the defragmentatio
272. ls the Disk File Optimizer to use its free space consolidation algorithm CONTINUOUS NOCONTINUOUS default 4 34 Using Defrag PLUS DEFRAGMENT MODIFY The CONTINUOUS qualifier causes the script to execute repeatedly After each successful defragmentation operation the script becomes eligible for execution again As long as any PROCESS LIMITs see the SET subcommand are not violated the script executes repeatedly If all PROCESS LIMITs have been reached the script is queued until an outstanding defragmentation process completes then the script is allowed to execute By default the defragmentation process associated with a script may execute on any appropriately licensed node in a cluster Thus successive defragmentation processes do not necessarily execute on the same node DORMANT file spec NODORMANT default The DORMANT qualifier indicates files to be considered dormant when final file placement decisions are made Dormant files are placed at the high end of the volume 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described EPILOGUE file
273. lume to a minimum the following files must be clustered around the center of the disk e INDEXF SYS controlled by volume INITIALIZE qualifiers e Frequent or hotfiles FREQUENT and HOTFILE DATABASE e 000000 dir INITIALIZE qualifiers The following sections describes these qualifiers and their effect 2 2 1 CLUSTER_SIZE n Retaining log files on a volume initialized with a large 100 or so cluster size can keep fragmentation to a minimum System error and other log files are always extending and creating large fragmented files Also keeping these normally open log files off the system volume allows the Disk File Optimizer software to consolidate free space more efficiently The trade off is more unused space in the last cluster of files 2 2 2 DIRECTORIES n The DIRECTORIES qualifier is important if you are placing frequent files when defragmenting the volume Frequent files are placed around the center of the volume The 000000 DIR is also placed around the center of the volume by specifying INDEX MIDDLE when initializing the volume However if more than 16 files and top level directories are created in the 000000 directory the directory will extend and possibly be allocated on another part of the volume You can keep the 000000 DIR from being moved by specifying the approximate number of files that will be in this directory Getting Started 2 1 Getting Started 2 2 Organizing Volumes Efficiently 2 2 3 HEADERS n
274. luster Table 2 1 Cont Script Scheduling Policies Volume Attributes Policy Reason Volume is mounted to all Do not restrict which No restrictions mean more efficient nodes node can defragment the processing volume Volume is mounted Restrict Only that node can see the volume locally defragmentation process to the node to which it is mounted If defragmentation cannot be scheduled when few users are on the system the priority of the process may be changed to take advantage of system resources as they are available For example the scheduling scripts for the system volumes and layered software products volumes Both of these types of volumes have a minimum amount of writes to them The following shows which nodes boot off of which volume e LUNTIC boots off of 1 DU A110 e PRNOID and SENILE boot off of DSAO shadow set e NROSIS boots off of 4 DIA1 The following shows part of LOAD_DB COM that would create scripts for these volumes X DEFRAGMENT VOLUME DSA0 SCRIPT DEFRAG DSAO INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG DSA0 NODE PRNOID SENILE MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA110 SCRIPT DEFRAG 1 DUA110 INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA110 NODE LUNTIC MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 4 DIA1 SCRIPT DEFRAG 4 DIA1 INTERVAL 7 00 00 AFTER 17 00 FULL LOG DFGSDATABASE D
275. lying to or receiving from DFG DEFRAGMENT These symbolic names are described in the DFG DEF XXX files located in SYS LIBRARY Note No item code may occur more than once in either the dfg list or sch list item list Callable Interface 7 5 DFG DEFRAGMENT buffer address A longword containing the user supplied address of the buffer which contains the information being passed to DFG DEFRAGMENT or the address of a buffer into which DFG DEFRAGMENT writes information The use of this field depends upon the item code specified in the item descriptor return length address If used the return length address is a longword containing the user supplied address of a longword in which DFG DEFRAGMENT writes the length in bytes of the information it returned For most DFG DEFRAGMENT item codes this field is not used and must be zero dfg list Item Codes DFG K CLASSIFY DORM Files associated with the DFG K CLASSIFY DORM item descriptor are considered dormant when final file placement decisions are made Dormant files are placed on the volume to allow placing other files in more optimum disk locations In general they are placed further away from the ODS 2 data structures than files associated with the DFG K CLASSIFY FREQ item descriptor and files not classified in any manner If a fileis indicated in both the dormant and frequent lists it is considered dormant If a file is indicated in both the exclude and dormant
276. made to define two scripts with the same name User Action Reissue the command using a unique script name for the SCRIPT qualifier EMPDFGSCH empty defragmentation and scheduling item lists Explanation Both the scheduler list and the defragmentation list were empty User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program EMPDFG empty defragmentation item list Explanation The defragmentation list was empty for a script definition call to DFG DEFRAGMENT User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program ENABLED AD enabled Explanation The script has been enabled User Action NONE ENAFAIL1 failed to enable AD Explanation This is a summary message indicating the specified script was not enabled Associated messages indicate the reason the enable operation failed User Action Refer to associated messages to determine a course of action ENAFAIL2 no script was enabled Explanation This is a summary message indicating that no script could be enabled the user specified ALL on the command line Associated messages indicate the reason the enable operation s failed User Action Refer to associated messages to determine a course of action ENGLIMEXC process limit exceeded increase process limit to run Explanation Starting another defragmentation process o
277. make a menu selection ra continue 6 4 1 Create Scripts Use the following procedure to create a script for a volume or file 1 2 3 Pull down the Script menu Select the create script option and designate the target you wish to create a script for a Volume Selected Files or a Volume Index File Note Note that you must define a script using the Script Define buttons in the respective dialog box see Section 6 4 1 1 To specify a script name type the script name in the script field box If you don t enter a script name this instance of the Disk File Optimizer application will assign a default script name for you that resembles DF G SCRIPT xxx The DECwindows Interface for Defrag Plus 6 5 The DECwindows Interface for Defrag Plus 6 4 Script Menu where x is any hexidecimal character between 0 through F This default script will be deleted upon successful completion of the defragmentation process e Click on Reset to restore the content of all fields to their defaults e Click on Inherit to browse a script list and select the script you wish to inherit properties from 4 Choose a Volume Selected Files or Volume Index File e f you choose the Volume option enter a specific Volume name on the Volume insert line or click on the volume list button to get a list of volumes to select from Refer to Figure 6 5 e f you choose the Selected Files option enter a specific file name on the file inse
278. mand in Chapter 3 or Chapter 4 for information on how to defragment INDEXF SYS Can you defragment INDE XF SYS on a system boot volume No You have to dismount the disk before you can defragment INDEXF SYS How long should I expect a defragmentation operation to take The time for a defragmentation operation to run depends on the following factors e How fragmented the volume is How much free space is available e How busy the volume is with file creation and deletion Many volumes can be defragmented in less than an hour Some volumes can take more than 24 hours The more the volume is fragmented the more work Disk File Optimizer has to do If this the first time the volume is defragmented the defragmentation operation could take a long time If the defragment processes are scheduled regularly they will take less time How can I automatically cancel a script from happening on Sunday night when I do backups The following prolog file can be used to cancel the execution of a script on Sunday or modified to cancel the execution on any day of the week The prolog file gets the script name from DFO so the same prolog file can be called from multiple scripts that need to be canceled on Sunday You can place the file Answers to Frequently Asked Questions A 3 Answers to Frequently Asked Questions CANCEL_SUNDAY COM into DF GSDATABASE CANCEL_SUNDAY COM and then modify scripts so that they call the command procedure using the following c
279. mand to complete ABOS Aborted AD Explanation The DFO process associated with the given script was stopped User Action NONE ACCESSERR access error on file AD Explanation A QIO IO ACCESS function could not be performed on the given file for reasons detailed in associated messages This message occurs only in the log file or the MAIL NOTIFICATION messages User Action Refer to associated messages to determine a course of action ACLERR BUGCHECK Map pointer copy would run into ACLs Explanation The copy made of INDEXF SYS would run into ACLs User Action Clean up disk and restart program ASSIGNERR channel assign error for device AD Explanation A channel could not be assigned for the indicated device Associated messages provide more detail User Action Refer to associated messages to determine a course of action BADPRI Minimum and default priority switched MIN SL DEF SL Explanation The minimum priority of the DFO process was higher than the default priority The defragmentation software will modify the MINIMUM priority to the lowest value and the DEFAULT priority to the highest value Correct operation of the automatic throttling feature of DFO requires that the default priority be equal to or greater than the minimum priority User Action None Defragmentation Messages F 3 Defragmentation Messages F 2 Disk File Optimizer Messages BITMAPCONERR CONNECT error on file AD 000000 BI TMAP SYS Exp
280. 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 File The Output File option is used to show the volume fragmentation state or to show information from the scheduling database It directs the output of the SHOW subcommand to a file The DECwindows Interface for Defrag Plus 6 41 The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Figure 6 24 Report Volume Statistics Disk File Optimizer Report volume Fragmentation DH Fragmentation Report EMHRD S HAY LEST 14 08 42 76 The Fragientation index is 24 5 i 20 9 ie excellent 9i 40 3 is good di 53 3 is fair Bi 89 9 is poor Bl G00 indicates a badly fragmenbed diek Approuinately 4 5 Gout of BO 0 pozslble je dus to file fragmentation Approximately 20 0 put of 2 0 p sible is d to freespace fragmentation Freespace Somnergz Tote free space iOd2 32 blocks Perceontaap Frees zb irpundzd Tots Free extents EBA Kaxinum free extenti 14208 blocke LEN 3565652 Hinimum free extenty d bloke LEN 2372003 Average free extenty i629 blocks Hedisn free extent 32 blocks File Fragmentation Surnmasut Murder of File
281. mber is chosen 4 22 Using Defrag PLUS Restrictions Qualifiers DEFRAGMENT FILE to keep all script names unique Names beginning with DF G are reserved for use by the defragmentation software Once the defragmentation command line is entered in the database it is eligible for execution according to its scheduling parameters If no scheduling informati on is provided the script begins executing immediately and executes only once By default script definitions remain in the scheduling database until their associated defragmentation process completes However a script is permanently added to the scheduling database if it is named as a predecessor by another script or if any of the following qualifiers are present on the DEFRAGMENT FILE command line e SCRIPT Script name e INTERVAL delta time e PREDECESSOR 6cript name e A script that has the CONTINUOUS qualifier may not be named as the predecessor of another script e f you specify the INTERVAL qualifier the PREDECESSOR qualifier is not allowed e If LEVEL 5 is selected the LOG qualifier is required e Donot use BRIEF and FULL concurrently 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
282. mber of blocks in each grid on the view port Current File The current file the defragmentation process is working on This entry is only on the full volume map 6 34 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume 6 5 3 Partial Volume Window The partial volume map window provides a closeup detailed view of how the storage space is allocated on a smaller segment of the whole volume Table 6 7 describes the window contents and how it functions Figure 6 20 Defragmentation Partial Volume Map Window H StartLEN pe Phase Defragmentation Phase Two Phase Two Volans orao d of Window End LEN 1 Allocated Space Free Space of Window Free Blocks Blocks Grid E i Indexed Placed Nomove OoOo Exclude Dormant Fix When a Defragmentation Full or Partial Volume Map Window is displayed on the screen the File Type color bar at the bottom of the dialog helps you identify the different file types on the volume map The file type color bar shows the different fil
283. more information on this report 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 The following are examples of 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 Note If output is directed to a filename without extension the file is given a default extension of lis Using Defrag PLUS 4 61 DEFRAGMENT SHOW 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 If output is directed to a filename without extension the fileis given a default extension of lis DEFRAGMENT SHOW MY
284. mount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described NOFULL default The FULL qualifier requests a full log of all actions taken by the defragmentation process The FULL qualifier must be used with the LOG qualifier The FULL and BRIEF qualifiers are mutually exclusive and NOFULL provides the same functionality as BRIEF HOTFILE_DATABASE NOHOTFILE_DATABASE default 3 16 Using Defrag DEFRAGMENT FILE The HOTFILE_DATABASE qualifier causes the defragmenter to query the appropriate hotfile database and append the list of hotfiles to the defragmenter s FREQUENT file list IGNORE keyword IGNORE PLACED default NOIGNORE The IGNORE qualifier requests that the defragmentation process ignore certain types of files as specified by the following keywords e INDEXED Ignores all RMS indexed files e NOINDEXED May defragment RMS indexed files e PLACED Ignores all files with explicit placement flags set in their headers e NOPLACED May defragment files with explicit placement flags Files indicated by the GNORE qualifier are added to the EXCLUDE list The default value IGNORE PLACED indicates that files with explicit placement control should be ignored and that RMS indexed files should be defragmented and pla
285. n ANRITE CHECK NOWRITE CHECK default The WRITE CHECK qualifier requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process Examples The following are examples of the DEFRAGMENT VOLUME command 1 DEFRAGMENT VOLUME DISKSUSER 1 This command defragments DISK USER 1 using default qualifiers The defragmentation process executes only once In a VAXduster system the defragment operation begins on a node selected at random from among those nodes in the scheduling database having fewer executing processes than the limit imposed by the SET PROCESS LIMIT value subcommand If all 4 74 Using Defrag PLUS DEFRAGMENT VOLUME nodes are busy with a maximum number of defragment processes the script does not execute until one of the outstanding defragmentation operations concludes After the defragmentation process stops the script is removed from the scheduling database DEFRAGMENT VOLUME DISKSONE SCRIPT MY_SCRIPT IGNORE INDEXED PLACED INTERVAL 2 00 00 FREQUENT EXE LOG MYLOG LOG FULL DORMANT ARCHIVE NODE N1 N2 This command does the following e Defragments DISK ONE e Names the script MY SCRIPT e Instructs the defragmentation process to ignore all RMS indexed files and files with explicit placement control information in their headers These files are added to the EXCLUDE list e In
286. n a defragmented state This also makes the defragmentation process more effecti ve e Schedule defragmentation before and after user activity that may significantly contribute to fragmentation such as end of month processing 3 2 Using Defrag Using Defrag 3 2 Defrag Capabilities 3 2 4 2 Using DECscheduler You can use the DECscheduler product with Defrag to schedule defragmentation operations There are no special requirements for doing this For information about DE Cscheduler see DECscheduler document 3 2 5 Using Hot files Information The Disk File Optimizer allows you to automatically use hotfile records from the VPA or DECps database to identify frequently accessed files The defragmentation process automatically determines which if either of these products is installed on your system and queries the appropriate database To augment the frequent files list using the hotfiles records from one of these products use the HOTFILE DATABASE qualifier with the DEFRAGMENT FILE or DEFRAGMENT VOLUME command If you use the HOTFILE DATABASE qualifier the defragmentation process queries the appropriate database for hotfile records relating to the target volume The files listed in the hotfile records are automatically added to the FREQUENT file list The standard defragmentation process samples hotfile data using the previous 24 hour period that is 24 hours before you enter the DEFRAGMENT FILE or DEFRAGMENT VOLUME command as a s
287. n 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 EPILOGUE file name NOEPILOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures INTERVAL delta time NOINTERVAL default 4 50 Using Defrag PLUS DEFRAGMENT OFFLINE_VOLUME 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 spedify a time with the INTERVAL qualifier a default value of 1 day is used This value causes the associated script to run e
288. n in continuous mode e DFG M FILE COMMAND When set 1 identifies the command as a DEFRAGMENT FILE command When reset 0 identifies the command as a DEFRAGMENT VOLUME command e DFG M SPARE SCH Reserved for future use by Compaq Computer Corporation Should be zero The uses of the buffer length buffer address and return length address fields for the DFG K SCH FLAGS item code are as follows buffer length Must be DFG S SCH FLAGS x 2 buffer address Address of the SCH FLAGS buffer return length address Not used must be zero DFG K SCRIPT The DFG K SCRIPT item code allows you to name the created script If the script name is in the database DFG DEFRAGMENT issues a duplicate script name error message and does not enter the new script into the database The uses of the buffer length buffer address and return length address fields for the DFG K SCRIPT item code are as follows buffer length L ength of the script name string in bytes The maximum size of a script name string is 64 bytes e buffer address Address of a buffer containing the script name string return length address Not used must be zero DFG K SET CPU The DFG K SET CPU item code sets the maximum percentage of a single CPU that is available to a defragmentation process This percentage must be a number from O to 100 inclusive If a defragmentation process exceeds this limit the scheduler decrements the process priority
289. n level Defragment placed files Defragment indexed files Log file report otify user by mail otify user by opcom Default priority inimum priority Query hotfile database RVN to defragment Consolidate freespace Perform write check Defragmentation process start Process ID 20E0059A Device 1 DKBO0 Time 04 APR 2001 14 44 09 24 Volume name S1SDKBO Media name DKX00 Cluster factor 3 Number of blocks 2050860 Begin file evaluation phase Files specified for dormant placement 04 APR 2001 14 44 08 70 20E0059A SPIELN 04 APR 2001 14 44 12 71 DISKSJIM DFO TEST 1 DFO TEST 1 S TXT 42 DISKSJIM DFO TEST 1 DFO TEST 1 S TXT 4 DISKS JIM DFO TEST 1 DFO TEST 1 MS TXT 41 DISKSJIM DFO TEST 1 DFO TEST 1 S TXT 41 DISKSJIM DFO TEST 1 DFO TEST 1 MS TXT 3 Files specified for frequent placement DISKS JIM DFO TEST 10 DFO TEST 10 MS TXT 15 DISKSJIM DFO TEST 10 DFO TEST 10 S TXT 7 DISKSJIM DFO TEST 10 DFO TEST 10 S TXT 15 DISKSJIM DFO TEST 10 DFO TEST 10 MS TXT 2 DISKSJIM DFO TEST 10 DFO TEST 10 S TXT 2 continued on next page Full Log File Example E 1 Full Log File Example Example E 1 Cont Full Log File Candidates for defragmentation based on the defragmentation level DISKSJIM DISKSJIM DISKSJIM DISKSJIM DISKSJIM 10_MS TXT 2 34 extents 10_MS TXT 6 34 extents
290. n process Volume The name of the volume that is being defragmented Allocated Space Shows the color of allocated space on the disk volume continued on next page The DECwindows Interface for Defrag Plus 6 33 The DECwindows Interface for Defrag Plus 6 5 Monitor a Script or Volume Table 6 7 Cont Defragmentation Volume Map Window Description Field Description Free Space Shows the color of free space on the disk volume Mix of Allocated and Free Space Shows the color of space that is partially allocated and free space This entry is only on the full volume map File Locator The file locator button on the Full or Partial Volume Map windows is normally selected by default resulting in the file locator pop up menu appearing If you deselect the file locator button the pop up menu will go away The File Locator pop up window displays the following list of file types Directories Dormant Exclude Frequent General Select the General file category whenever you want to enter a specific file By selecting the General category and then pressing the OK button you will get a General File Locator pop up window where you can enter the specific file name you want to locate Push the OK button to highlight the space allocated to that file End LBN of Window The ending LBN at the lower right corner of the viewport Free Blocks The number of free blocks on the disk volume Blocks Grid The nu
291. n the dialog See Figure 6 22 Click on Cancel to close this image dialog 6 36 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Figure 6 22 Report Graphics Full Volume Map Start LEN of window p volume 1 pka300 i Pa Pa H Allocated Space i Free Spare EE NE Mix of Allocated End LEN and Free Space of Window Blocks Grid 45 Blocks i Free Blocks Indexed Placed Nomove Cancel The DECwindows Interface for Defrag Plus 6 37 The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume This dialog is nothing but a color coded window of how the volume is shared by its files and directories The first line in this dialog shows the Start LBN and Volume id both of which are self explanatory The following may require explanation The multicolored grid below the first line is actually a map of the volume s contents Three gray levels mark different exten
292. n this node would exceed the user defined maximum number of defragmentation processes for this node User Action If the limit is acceptable no action is required Otherwise change the limit using the SET subcommand ENGMAXTIM time limit exceeded defragmentation process stopped Explanation A defragmentation process was terminated because its time limit was exceeded This is a limit imposed by the user with the TIME _ LIMIT qualifier User Action None or change the time limit Defragmentation Messages F 11 Defragmentation Messages F 2 Disk File Optimizer Messages ENQLOCKERR error while attempting to queue a process lock for device AD Explanation The defragmentation process received an unexpected failure status from the ENQ system service while trying to get an exclusive lock on the target device Associated messages provide more detail This error does not occur for concurrent defragmentation processes User Action Refer to associated messages to determine a course of action EXTHDRERR unable to access extent header s for file AD Explanation The defragmentation process could not access the given file s extent header s through the lO ACCESS QIO User Action Refer to associated messages to determine a course of action FREEVMERR unable to free dynamic memory Explanation The defragmentation process called the LIB FREE VM service incorrectly User Action Submit an SPR GETDVIERR error in getting devi
293. nal error string F 14 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages INTPRED invalid qualifier combination remove INTERVAL or PREDECESSOR Explanation This error occurs when PREDECESSOR and INTERVAL are both specified User Action Remove one of them INVDEVCONT device not suitable for defragmentation do you wish to continue Y N Explanation The user specified a device for a defragment operation that is currently unavailable or unsuitable for defragmentation However since the device may become available by the time the defragmentation operation begins the user is allowed the option of continuing or aborting the command User Action If the device specified is correct but is currently off line or for some other reason is unsuitable for defragmentation enter Y in response to the prompt Otherwise enter N or press Return to abort the command INVDEVNAM AD is an invalid device name Explanation The supplied device name was invalid User Action Specify a valid device name INVDEV device unsuitable for defragmentation Explanation Target device not suitable for defragmentation User Action Ensure that the target device for defragmentation is an ODS 2 volume or stripe set or volume set Further it must be a local device available from the issuing node INVDFGLST invalid defragmentation item list Explanation The defragmentation list passed to DFG DEFRAGMENT was invalid
294. name indicate the following Blank file has been preprocessed for defragmentation d file has been defragmented file has been partly defragmented D file has been placed for dormant access Dd file has been defragmented and placed dormant D file has been placed dormant and been partly defragmented F file has been placed for frequent access Fd file has been defragmented and placed frequent F file has been placed frequent and been partly defragmented oved file has been moved number of extents unchanged EMPTY file was empty no action taken FAIL file s fragmentation cannot be reduced IN USE new disk space for file was in use no action taken OPEN file was open no action taken OMOVE file may not be moved no action taken UNAVL file was unavailable no action taken 3 4 2 Showing the State of a Disk The defragmentation software can show the current fragmentation state of a volume The SHOW subcommand provides a variety of report options that show the level of fragmentation on a given volume For example to view the default information in the volume fragmentation report enter the following command DEFRAGMENT SHOW DISKSONE VOLUME This command generates a fragmentation index free space summary and file fragmentation summary The fragmentation index is an estimate of the level of fragmentation on the specified volume Its value is derived from the number of files on the volume their sizes the number of
295. nd displays information about the fragmentation state of the specified volume Information displayed as a result of showing the volume fragmentation state includes A list of files with a user selected minimum level of fragmentation A histogram of the file fragmentation and free space fragmentation state of the volume A list of all free space extents on the volume e Summary statistics on both file fragmentation and free space fragmentation e The location of user selected files All information in the volume fragmentation analysis is optional By default only the summary statistics are provided If the volume is mounted with the NOWRITE qualifier you cannot use the DEFRAGMENT SHOW command None FILE_LIST min_extents FILE_LIST VOL_MAP_WINDOW 1 default The FILE_LIST qualifier shows 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 plus one is used This value lists all files that require at least one window turn to completely map Using Defrag 3 31 DEFRAGMENT SHOW FREE_LIST NOFREE LIST default The FREE LIST qualifier shows the fragmentation state of the volume It lists the location and size of all of the free space extents on the volume HISTOGRAM NOHISTOGRAM default The HISTOGRAM qualifier shows the fragmentation state
296. nd part of the script data buffer consists of all the data indicated by the descriptors in the first part Figure 7 4 illustrates the format of the buffer allocated and written by DFG DEFRAGMENT The possible item codes associated with the ITEM LIST 2 descriptors returned by DFG DEFRAGMENT are DFG K SHOW SCRIPT AFTER DFG DEFRAGMENT returns the time that was specified with the DFG K AFTER item descriptor when the script was originally created The time is a VMS absolute time string If no DFG K AFTER item descriptor was originally supplied DFG DEFRAGMENT does not return this descriptor The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the time string supplied in the buffer pointed to by the buffer address field DFG DEFRAGMENT Figure 7 4 Show Script Data Buffer ITEM CODE BUFFER LENGTH BUFFER ADDRESS ITEM CODE BUFFER LENGTH BUFFER ADDRESS STORAGE FOR LAST ITEM STORAGE FOR FIRST ITEM CXO 3153A e buffer address Address of the time string buffer There is only one DFG K SHOW SCRIPT AFTER item descriptor per script DFG K SHOW SCRIPT DFG FLAGS DFG DEFRAGMENT returns the defragmentation process flags stored in the database for this script The flag fields are described under the DF G K_DFG FLAGS item descriptor The uses of the buffer length and buffer address fields of the ITEM_LIST_2 descriptor are as follows
297. ndidate for defragmentation The default window value is seven and can be set for a given volume using SET VOLUME device spec WINDOWS n e LEVEL 3 Any file with retrieval pointers in more than one file header is a candidate for defragmentation Using Defrag 3 39 DEFRAGMENT VOLUME e LEVEL 4 The defragmentation process for level four processing performs only free space consolidation This level is used with the CONSOLIDATE_FREESPACE qualifier e LEVEL 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 qualifier If level 5 is selected the LEVEL 22 candidate file specifications are listed in the full log file 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 status 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 OPCOM_NOTIFICATION default NOOPCOM_NOTIFICATION The OPCOM_NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes
298. ndow Description Field Description Start LBN of Window The starting LBN at the upper left corner of the viewport Phase The aurrent phase of the defragmentation process Volume The name of the volume that is being defragmented Allocated Space Shows the color of allocated space on the disk volume Free Space Shows the color of free space on the disk volume continued on next page The DECwindows Interface for Defrag 5 21 The DECwindows Interface for Defrag 5 4 Monitor a Volume Table 5 6 Cont Defragmentation Volume Map Window Description Field Description Mix of Allocated and Free Space Shows the color of space that is partially allocated and free space This entry is only on the full volume map End LBN of Window The ending LBN at the lower right corner of the viewport Free Blocks The number of free blocks on the disk volume Blocks Grid The number of blocks in each grid on the view port Current File The current file the defragmentation process is working on This entry is only on the full volume map 5 22 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 4 Monitor a Volume 5 4 3 Partial Volume Window The partial volume map window provides a closeup detailed view of how the storage space is allocated on a smaller segment of the whole volume Table 5 6 describes the window contents and how it functions Figure 5 14 Defragmentation P
299. ng the defragmentation of INDEXF SYS you may need to do the following Repair alternate index file header and index file bitmap by doing a ANALY ZE DI SK RE PAIR Delete disk 000000 DF G DEFRAG INDEXF DAT EPILOGUE file name NOEPILOGUE default 3 28 Using Defrag The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures Examples DEFRAGMENT OFFLINE_VOLUME LOG file spec NOLOG default The LOG qualifier causes the defragmentation process to create a file containing a list of all its operations 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 OPCOM_NOTIFICATION default NOOPCOM_NOTIFICATION The OPCOM_NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures WAIT default NOWAIT The WAIT qualifier causes the input device to wait until the
300. ngth Length of the successor script name in bytes e buffer address Address of the successor script name Callable Interface 7 35 DFG DEFRAGMENT DFG K SHOW SCRIPT TIME LIMIT DFG DEFRAGMENT returns a VMS delta time specification indicating the time limit imposed on this script if any If the DFG K_SHOW_SCRIPT_TIME_LIMIT item descriptor is absent no time limit is established for this script The uses of the buffer length and buffer address fields of the ITEM_LIST_2 descriptor are as follows buffer length L ength of the delta time specification in bytes e buffer address Address of the delta time specification DFG K SHOW SCRIPT VOLUME DFG DEFRAGMENT returns the name of the target volume for this script The uses of the buffer length and buffer address fields of the ITEM LIST 2 descriptor are as follows e buffer length L ength of the target volume name in bytes e buffer address Address of the target volume name DFG K START The DFG K START item descriptor starts the specified script The uses of the buffer length buffer address and return length address fields for the DFG K START item code are as follows buffer length L ength of the script name in bytes e buffer address Address of the script name string return length address Not used must be zero DFG K TIME LIMIT Indicates the duration of a given defragment operation Specifying unreasonably small values 15 20 minutes or
301. node on which the defragmentation process is operating e The status of the defragmentation process e The buffered I O count and rate of the defragmentation process e The CPU utilization time and usage of the defragmentation process e The direct I O count and rate of the defragmentation process e The page fault count and rate of the defragmentation process e The current defragmentation process phase The elapsed time since the start of the defragmentation process The process information marked with an asterisk in the preceding list appears highlighted on the process display whenever it changes To access the process activities display enter N or press the Next Screen key The process activities display shows the following process related information Figure 3 2 Figure 3 2 Process Activities Display commands Options Defragmentation Process Activities File Evaluation Dormant count Files evaluated 4 Exclude count Candidate count 4 Frequent count Total placed files 0 Total indexed files 1 File Defragmentation Files partly defragmented Files defragmented Files processed File Placement Free Space Consolidation Dormant files placed Extent count ig Frequent files placed Countdown Current File MESEBBEUGNT PEDES Pe heb ae ee sic Release meee Lb ee Press CTRL C CTRL CTRL Z to exit Press CTRL H to refresh the screen Fress H or P for NEXT or PREV screen e Name of current defragm
302. node using SYSS STARTUP DFG START SCHEDULER COM SCHSTART AD started on AD D Explanation A scheduler started This message appears at the beginning of every scheduler log User Action None SCRDIS script AD is already disabled Explanation An attempt was made to disable a script that was already disabled User Action None SCRENA script AD is already enabled Explanation An attempt was made to enable a script that was already enabled User Action None SDNOTFOUND No scripts were found in the database Explanation No scripts were found in the database User Action Create a script before viewing or modifying SEARCHLOOP loop in SEARCH same file returned twice Explanation RMS s SEARCH function did not return files in alphabetical order This may be caused by a corrupt directory file or by an alias that points to a deleted file User Action Investigate the directory structure of the disk SENDMAILERR mail notification failed Explanation This is a summary message that occurs when the scheduler does not send the mail notification message requested by the user with MAIL NOTIFICATION Associated messages provide more detail User Action Refer to associated messages to determine a course of action SETD Default set parameters modified for all nodes Explanation The default parameters for all nodes have been modified User Action None SETFAIL failed to set any specified parameters Explanation D
303. nstead of one node DEFRAGMENT MODIFY DEFRAG 2 DKA100 AFTER 17 00 NOMAIL NODE LUNTIC PRNOID SENILE 2 6 4 Creating Scheduling Scripts for Defrag If you have installed the Defrag variant you can create command procedures as scripts and schedule the procedure You can create a command procedure for each volume or a command procedure for each node The following is an example of command procedure that would defragment 2 DK A 100 X DEFRAGMENT VOLUME 2 DKA100 FULL LOG DFGSDATABASE DEFRAG 2 DKA100 NOOPCOM NOTIFICATION MAIL NOSELF SUB VOLUME 2SDKA100 DEFRAGMENTED NL SYSTEM exit 2 6 5 Checking for the Right Script Interval Now that you have created the scripts you need to monitor the script interval You may Periodically issue the DEFRGMENT SHOW command for each volume to ensure the fragmentation index is at an acceptable level AU 4 Create a program that that gathers fragmentation information and creates a graph of the fragmentation of each volume To check the fragmentation index of the volume use the following command DEFRAGMENT SHOW 1SDKB0 VOLUME Disk File Optimizer for OpenVMS DFG 2 6 2001 Compaq Computer Corporation Fragmentation Report DISKSALPHAO71 04 APR 2001 15 22 58 11 The fragmentation index is 14 2 1 20 9 is excellent 21 40 9 is good 41 60 9 is fair 61 80 9 is poor 81 100 indicates a badly fragmented disk Approximately 8 8 out of 80 0 p
304. ntation Partial Volume Map Window 5 23 5 15 Report M eni cog rok en ee Ge RC CD ae Pe RR a 5 24 5 16 Report Graphics Full VolumeMap s ense 5 25 5 17 The Report Volume Selection Dialog Box esses 5 27 5 18 Report Volume Statistics sessa iea aa oa a a a aa ee 5 29 5 19 Report Volume File Fragmentation Histogram 5 29 5 20 Report Volume Volume Space Histogram 00000 eee 5 30 6 1 Walsh CIT 6 1 6 2 FEM enU a a a a a D 6 2 6 3 OptimizeMenu iss isis g aeae ee 6 3 6 4 SIPE MENU aa eae hake ede Oe aad rE i e 6 5 6 5 Script Define Dialog Box for a Volume 000 ce eee 6 7 6 6 Script Define Dialog Box foraFile 0 000 c eee eee 6 8 6 7 Script Define Dialog Box for a Volume Index File 6 9 6 8 Restrict Special File Dialog BOX aoaaa aaa 6 13 6 9 Schedule Definition 2 00200022 e eee eee 6 17 6 10 The Modify Script Dialog Box 0 0 2 ee 6 20 6 11 The Remove Script Dialog BOX 0 00 c eee 6 21 6 12 Show Script Dialog BOX lees 6 22 6 13 Script List Dialog BOX ss trek pn re eR o ee eS a 6 24 6 14 Schedule Script 2 202 002 s2e eee cede eee eee eee ee eens 6 25 6 15 The Abort Dialog BOK eiai staia eae aeei tee 6 27 6 16 Monito Menu aasaga TE EE ELTE ROUES ID TT 6 28 6 17 Volume Map Filelnformation 0000000 eee eee 6 29 6 18 Defragmentation Process Statistics Window sess 6 30 6
305. ntation Process Basic File and File System Concepts 00000 cece eee File Header Information Extent Mapping Windows Cathedral Window Determining File Fragmentation DEFRAGMENT SHOW volumeYVOLUME Command DUMP Utility Monitor Utility Performance Products File Defragmentation and VMS Backup 00 0c cece 2 Getting Started 2 1 2 2 2 2 1 2 2 2 2 2 3 2 2 4 2 3 2 3 1 2 3 2 2 3 3 2 3 4 2 4 2 5 Introduction 00 eee Organizing Volumes Efficiently CLUSTER SIZEzn DIRECTORIESzn HEADERS n ANDEX MIDDLE Improving I O Performance Move Log Files to One Volume SET VOLUME NOHIGHWATER MARKING sees SET VOLUME DATA CHECKZzNOREAD NOWRITE SET VOLUME NOERASE ON DELETE Disk File Optimizer Licensing Considerations lille VMSduster System Considerations xi Logd od Pp og OONNNNODOOATAANMN H ob Lb oL oL boh b oL bob ob ol 2 5 1 2 5 2 2 5 3 2 6 2 6 1 2 6 2 2 6 3 2 6 4 2 6 5 2 6 6 2 7 2 8 Processes Per Node Common Scheduling Database 0 00000 Locally Mounted Volumes eese Creating Scheduling Scripts 2 20 00000 ee Gathering Initial Information 0 000000 00 e eee Creating Scheduling Scripts for Defrag PLUS Modif
306. nterface The defragment flags provide general information to the defragmentation process about this defragmentation operation When the DF G K_DFG_FLAGS item descriptor is created the buffer associated with it must be DFG S DFG FLAGS x 2 bytes in size The first half of the buffer specifies the flag values desired if any The second half is nonzero only if the script is inheriting characteristics from another script that is the DFG K INHERIT item descriptor is part of this list If a DFG K INHERIT item descriptor is part of this item list the second half of the flags buffer becomes an inherit enable mask where each set bit corresponds to a flag with a value that should be inherited from the DFG K INHERIT script To inherit a flag value from the specified DFG K INHERIT script set the mask in the second half of the DFG FLAGS buffer corresponding to the field you want to inherit For example to inherit the defragmentation level from the DFG K INHERIT script set the bits associated with DFG M LEVEL mask in the second longword Figure 7 3 illustrates this concept The following bit masks are defined for DFG_FLAGS e DFG M_CONSOLIDATE_FREESPACE 1 runs freespace consolidation algorithm 0 does not run freespace consolidation algorithm e DFGS M DEFAULT PRIORITY Spedifies the default priority for the defragmentation process DFG DEFRAGMENT Figure 7 3 Flags and Inherit Enable DFG FLAGS INHERIT ENABLE RESULT FROM
307. nternal memory allocation calculation error submit an SPR Explanation A consistency check found the global section allocated was not large enough to hold the necessary data This is an internal error User Action Submit an SPR IESRCINCONSIS internal error inconsistent source AD Explanation This error occurs when the source for one module is not compatible with the source for another module User Action Submit an SPR IEVERNOD internal error while verifying node Explanation This is an internal error User Action Submit an SPR IMEDALL all scripts have been AD Explanation Success message for any immediate command ENABLE DISABLE where ALL was specified User Action None Defragmentation Messages F 13 Defragmentation Messages F 2 Disk File Optimizer Messages IMEDSUCC script AD has been AD Explanation Success message for any immediate command ENABLE DISABLE where specific scripts were specified User Action None INHERCONT invalid qualifier combination remove INTERVAL or specify NOCONTINUOUS Explanation This error occurs when inheriting a script that contains the CONTINUOUS qualifier and the user has specified ANTERVAL User Action Remove the INTERVAL qualifier or specify NOCONTINUOUS on the command line INHERINTCONT invalid qualifier combination remove CONTINUOUS or specify NOINTERVAL Explanation This error occurs when inheriting a script that contains the INTERVAL q
308. o 1 the postprocessing file specification can be modified When reset to 0 the postprocessing file specification is removed e DFG V INHERIT PRE PROC When set to 1 the preprocessing file specification can be modified When reset to 0 the preprocessing file specification is removed e DFG V INHERIT PREDECESSOR When set to 1 the predecessor associated with the script can be modified When reset to 0 the predecessor is removed from the script Note Modifying the predecessor of a script changes the linked set of scripts For example if a set of linked scripts A B C exists and B is modified to have no predecessor then the link changes to B C e DFG V INHERIT SCRIPT When set to 1 the script name associated with the script can be modified When reset to 0 the script name is removed e DFG V INHERIT TIME LIMIT When set to 1 the time limit associated with the script can be modified When reset to 0 the time limit is removed from the script The uses of the buffer length buffer address and return length address fields for the DFG K MODIFY item code are as follows buffer length Must be 12 7 20 Callable Interface DFG DEFRAGMENT buffer address Address of a three longword structure containing a string descriptor for the inherit script name string and the longword INHERIT MASK The script name provided indicates the script from which DFG DEFRAGMENT inherits all characteristics e
309. o free space Current File Current file being evaluated 5 20 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 4 Monitor a Volume 5 4 2 Full Volume Window The defragmentation full volume map window allows you to see how the storage space and free space on the full volume are allocated Figure 5 13 show the full volume map window and Table 5 6 describes the window contents and how it functions Figure 5 13 Defragmentation Full Volume Map Window 3 Disk File Optimizer Full volume Map Start LEN of Window 8 Phase Free space consolidation volume DPA100 Mix of Allocated End LBN Bow all ted 5 F 5 a 200000 NEEE PAER E neonate and Free Space of window Blocks Grid 44 Blocks Free Blocks 66630 Current File DFO TEST 5 DFO TEST 5 L TKT 1 om Indexed Placed Nomove endi Table 5 6 Defragmentation Volume Map Wi
310. o not use BRIEF and FULL concurrently Do not use CONTINUOUS and INTERVAL for a script 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 BRIEF default NOBRIEF The BRIEF qualifier has meaning only when the LOG qualifier is also present The BRIEF qualifier requests a brief log of all actions taken by the defragmentation process This log includes beginning and ending volume status information The BRIEF and FULL qualifiers are mutually exclusive and NOBRIEF produces the same result as FULL The BRIEF qualifier is the default Usin
311. ocess is suspended it cannot immediately be aborted but should abort the next time it executes Defragmentation Messages F 19 Defragmentation Messages F 2 Disk File Optimizer Messages F 20 NOABOS AD was not stopped Explanation The DFO process associated with the given script was not stopped User Action Determine if a DFO process is actually running on the particular disk Also check the CPU state of the DFO process If the process is suspended it cannot immediately be aborted but should abort the next time it executes NODEIGNOR the NODE qualifier was ignored Explanation The NODE qualifier was specified with show script but no CPU I O or process parameter was selected Any node name is meaningless when applied to show script only This message is informational User Action None NODELFIL error deleting AD Explanation Attempt to delete the specified file failed User Action Depends on the file that could not be deleted and the associated messages NOFILE no file name specified for FILE subcommand Explanation No file name was specified in the File List User Action Specify the file name s to be defragmented NOINHER inherit script AD not found Explanation The script specified in the INHERIT qualifier could not be found in the SCRIPTS relation User Action Reissue the command using a defined script name for the INHERIT qualifier NOKILL failed attempt to stop a defragmentation process
312. ocks LBN 730360 Average free extent 9177 blocks Median free extent 584 blocks If you defragment the INDEXF SYS file without adequate free extent the defragmentation of INDEXF SYS could fail 3 Analyze the disk volume to make sure it has no problems ANALYZE DISK disk name f the disk needs to be repaired use the following command to repair it ANALYZE DISK REPAIR disk name After defragmenting the INDE XF SYS file perform another ANALYZE DISK REPAIR This command may be permanently added to the scheduling and parameter database as a script If no script name is specified using the SCRIPT qualifier the defragmentation software generates a unique script name Once the defragmentation command line is entered in the database it is eligible for execution according to its scheduling parameters If no scheduling information is provided the script begins executing immediately and executes only once By default script definitions remain in the scheduling database until their associated defragmentation process completes However a script is permanently added to the scheduling database if any of the following qualifiers are present on the DEFRAGMENT OFFLINE VOLUME command line SCRIPT cript name ANTERVAL delta time e 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 mounte
313. oes not guarantee file placement but makes every effort to place files as described The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume continued on next page The DECwindows Interface for Defrag Plus 6 15 The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 3 Cont Restrict File of Dialog Box Fields Field Description Frequent The Frequent Files option indicates files to be considered Files frequently accessed when final file placement decisions are made You may enter the file name or use the file list button to bring up a list of files to chose from Frequent files are placed to optimize access speed If a fileis 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name
314. of a specific disk from the set to be defragmented The default of zero tells the Disk File Optimizer to defragment all disks in the bound volume set TIME_LIMIT delta time NOTIME_LIMIT default The TIME LIMIT qualifier specifies the maximum elapsed time allowed for a given defragmentation operation If the time limit is exceeded the defragmentation process is aborted Specify time as a delta time Refer to the OpenVMS User s Manual for more information on specifying times If the time limit is set unreasonably low the defragmentation process may not accomplish useful defragmentation Using Defrag 3 19 DEFRAGMENT FILE WAIT default NOWAIT The WAIT qualifier causes the input device to wait until the defragmentation process finishes before returning control to the user WRITE_CHECK NOWRITE_CHECK default Examples 3 20 Using Defrag The WRITE CHECK qualifier requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process The following examples show different ways to defragment a file or group of files and illustrate how to use the common qualifiers DEFRAGMENT FILE C This command defragments all files with a C extension in the current default directory To determine the device and directory in which the files are located issue the SHOW DEFAULT command DFO DEFRAGMENT FILE C
315. of action OPTHASFNF file not found on line SL options file AD Explanation A file specified as EXCLUDE FREQUENT or DORMANT in the options file was not found User Action No action is necessary To eliminate this message however you should remove the line in the options file that is reported in this message Since the file given on this line is no longer on the target device this line has no effect OPTINVQUAL invalid qualifier on line SL options file AD Explanation A classification for a file was given that was not one of FREQUENT DORMANT EXCLUDE User Action Check spelling and ensure that only classifications of FREQUENT DORMANT or EXCLUDE are used for files listed in the options file OPTMULCLA multiple classifications on line SL options file AD Explanation A file was classified with multiple classifications that is file ext F REQ DORM This error prevents the defragmentation process from being started User Action Specify only one file classification per line in the options file OPTNOTCLA file not dassified on line SL options file AD Explanation A file was in the options file but was not classified as FREQUENT DORMANT or EXCLUDE User Action Make sure the file on the line specified in the options file has one of the above listed classifications OPTRMSERR RMS error on line SL options file AD Explanation An unanticipated error was returned from the PARSE or SEA
316. ollowing is performed Create script to defragment INDE XF SYS on volume Dismount volume from the cluster Mount volume privately to analyze disk structure Check volume for readability and validity of Files 11 structure information Dismount volume to defragment INDEXF SYS 10 DEFRAGMENT OFFLINE_VOLUME Start OFFLINE VOLUME script Mount volume privately to analyze disk structure Check volume for readability and validity of Files 11 structure information Dismount volume Mount volume into the cluster Using Defrag PLUS 4 53 DEFRAGMENT REMOVE DEFRAGMENT REMOVE The REMOVE subcommand deletes the specified script or node from the defragmentation scheduling and parameter database Format AFTER DEFRAGMENT REMOVE script namef node name p NODE Parameters script name The script name parameter specifies the script to remove from the defragmentation database You can use wildcards in the script name specification Use an asterisk to take action on all scripts on the VAXcluster system use a percent sign to match a single character in the script name specification This parameter is not allowed if the ALL qualifier is used node name The node name parameter specifies the node to remove from the defragmentation database Description The REMOVE subcommand deletes the specified script or node from the defragmentation database Scripts executing when the command is issued are allowe
317. ommand DEFRAGMENT MODIFY script name PROLOGUE DFGSDATABASE CANCEL SUNDAY COM The comments in the command procedure describe how to change the cancel day from Sunday to another day This script must be run on Saturday for it to cancel a Sunday run of the script command procedure to cancel the execution of a script on Sunday this script must be run on Saturday so it can be cancelled on Sunday The command procedure must be executed as a PROLOGUE file from a script get today today f cvtime TODAY WEEKDAY if today is not Saturday then get out to change the day change Saturday to day of week before the day that you want to cancel execution of the defragmentor if today nes Saturday then exit we want to cancel the next execution of DFGSSCRIPT get script name i script name fStrnin DFGSSCRIPT CANCEL the script so it will not execute tomorrow defragment cancel script name exit How can automatically keep a script from executing on Sunday and Monday The following prolog file can be used to keep a script from execution on Sunday and Monday The prolog file gets the script name from DFO so the same prolog file can be called from multiple scripts You can place the file ABORT SUN MON COM into DFG DATABASE ABORT SUN MON COM and then modify scripts so that they call the command procedure using the following command DEFR
318. on enter a specific disk name or names on the Disk insert line or click on the disk list button for a list of disks to select from Refer to Figure 6 7 5 Fill out the rest of the Define dialog box according to the field description information in Table 6 1 6 Click on the Restrict button in this dialog box and fill in the information fields according to the information in Section 6 4 1 2 7 Click on the Schedule button in this dialog box and fill in the schedule script information fields according to the procedure in Section 6 4 1 3 The DECwindows Interface for Defrag Plus 6 3 The DECwindows Interface for Defrag Plus 6 3 Optimize Menu 8 To complete the script creation process dick on OK to complete the script and close the dialog box dick on Cancel to dose this dialog box and return to the previous screen dick on Apply to save the script and keep the present dialog box open 6 4 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 Script Menu The Script menu allows you to create modify remove show schedule and abort scripts for files or volumes Figure 6 4 shows the Script pull down menu Figure 6 4 Script Menu Disk File Optimizer for Qpen Ms v2 3 File Optimize script Monitor Report Options Create Script Modify Script Remove Script Show Scripts Schedule Scripts welcome to Disk File Optimizer Please
319. on dialog box and Table 6 4 describes the dialog box information fields Figure 6 9 Schedule Definition Disk File Optimizer Create Scrip Script Mama Define Restrict schedule Schedule 4 start After This Time NOW Time Limit Wait far START Cammand o Default Prioriby All scheduling is s Enabled lt Disabled Minimum Priarity gt Don t reschedule Reschedule lt gt At This Interval rr fdddd nhanmiss cc lt gt continuously To Follow Script schedule on Nodes E Prologue File pre processing Epilogue File post processing iSelact Apply Cancel Reset Inherit Help The parameters in the dialog box are e Start after this time e Wait for start time Dont reschedule e Reschedule at this interval e Reschedule continuously e Reschedule to follow script Schedule on nodes Time limit e Execute a prologue command file before running the script The DECwindows Interface for Defrag Plus 6 17 The DECwindows Interface for Defrag Plus 6 4 Script Menu e Execute an epilogue command file after running the script Table 6 4 Schedule Definition Dialog Box Fields Field Description Script Name Identifies the name of the script to be scheduled Start After This Time Starts execution of the script after the specifi
320. on operation occurs at or after the time specified by the AFTER qualifier all subsequent operations execute at intervals set with the INTERVAL qualifier LEVEL n LEVEL 2 default The defragmentation process selects files for defragmentation from among those not excluded based on the LEVEL qualifier 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 e LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels two and three is a candidate for defragmentation e LEVEL 2 default Any file whose extents cannot be completely mapped by the mapping window or that can be selected using level three is a candidate for defragmentation The default window value is seven and can be set for a given volume using SET VOLUME device spec WINDOWS n e LEVELS3 Any file with retrieval pointers in more than one file header is a candidate for defragmentation e LEVEL 4 The defragmentation process for level four processing performs only free space consolidation This level is used with the CONSOLIDATE FREESPACE qualifier e LEVEL 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 qualifier If level
321. ossible is due to file fragmentation Approximately 5 4 out of 20 0 possible is due to freespace fragmentation Getting Started 2 7 Getting Started 2 6 Creating Scheduling Scripts Freespace Summary Total free space 146848 blocks Percentage free 7 rounded Total free extents 27 aximum free extent 30312 blocks LBN 1799744 inimum free extent 4 blocks LBN 125948 Average free extent 5438 blocks edian free extent 492 blocks File Fragmentation Summary umber of files with some allocation 8363 Total file extents on the disk 8887 Average number of file extents per file 1 062657 edian number of file extents per file 1 Most Fragmented File SYSTEM FILES SPIELN ACCOUNTNG DAT 7 85 extents Refer to Appendix C for information about the above report 2 6 6 Modifying Scheduling Scripts You can modify scripts by two methods If you have the LOAD DB COM command procedure you can for example change the defragmentation interval on 1 DUA2 as follows DEFRAGMENT VOLUME 2 DKA100 SCRIPT DEFRAG 2 DKA100 INTERVAL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 28DKA100 NODE LUNTIC MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA2 SCRIPT DEFRAG 1 DUA2 INTERVAL 2 00 00 changed 3 to 2 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA2 DEFRAGMENT OFFLINE VOLUME 1 DUA2 SCRIPT DEFRAG OFFLINE 1 DUA3 NOAFTER EXIT After changing to the command proce
322. ound in the database 4 3 3 8 Re creating the Database Section 4 3 3 7 describes how to save the contents of the database in a file called MY DB CONTENTS COM With this file you can re create the database using the following commands RUN SYSSSYSTEM DFGSCREATE DATABASE RUN SYSSSYSTEM DFGSINIT DATABASE QMY DB CONTENTS If you have a database and want to erase its contents enter the following command RUN SYSSSYSTEM DFGSINIT DATABASE QMY DB CONTENTS Caution Stop all scheduler processes before you initialize the database by executing SY S MANAGER DFG STOP SCHEDULER COM on all nodes that have running schedulers If you fail to stop the scheduler before Using Defrag PLUS 4 7 Using Defrag PLUS 4 3 Scripts running SYS SYSTEM DF G INIT_DATABASE EXE the scheduler will fail and report an inconsistent database message 4 3 4 Using Hotfiles Information The Disk File Optimizer allows you to automatically use hotfile records from the VPA or DECps database to identify frequently accessed files The defragmentation process automatically determines which of these products is installed on your system and queries the appropriate database To augment the frequent files list using the hotfiles records from one of these products use the HOTFILE DATABASE qualifier with the DEFRAGMENT FILE or DEFRAGMENT VOLUME command If you usethe HOTFILE DATABASE qualifier the defragmentation process first queries the appropriate da
323. ow 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 to show 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 to show 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 WINDOWS 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 File The
324. p T9 ho Tocha FO ea re ee WOONNNOATAHK REA no a WWWNMNNN HH E od AAO PPPPPPPPPPPPPPPPPPPPP O00 010C1 CI L wo 8 14 3 21 3 22 3 27 3 31 3 34 3 36 4 Using Defrag PLUS 4 1 4 2 4 2 1 4 2 2 4 2 3 4 2 4 4 2 5 4 2 6 Introduction General Guidelines DCL Interface Wildcard Use Graphic User Interface OnlineHelp Quickness and Effectiveness of Defragmentation Cluster Management Scripts oa aa i a alade aa 0 eee Creating and Using Scripts s c sias riersidi sidrai ar siani Script Naming Conventions 0 0 Examples of Creating and Using Scripts 005 Creating Log Files Showing the State of a Disk liess Creating a Named Copying Scripts Modifying Scripts Periodic Script sa aiiai a a a a a Linking and Modifying Linked Scripts Saving Database Contents sssaaa aaau Re creating the Database enn Using Hotfiles Information lle Defining Quotas for the Defragmentation Process Hard coded values SYSGEN Process QUOEGS 4 usse ea oe UR ree ee s DFO Logical Process Quotas 0 00 cece eee eee Defining the Transfer Size Logical 0000 eee Scheduling Defragmentation Operations 0 0000 eee eee eee Error Recovery Procedures Disk File Optimizer Command Set 0 0000 es Defrag PLUS Commands
325. planation A transaction is active User Action None F 6 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages DBBUSY accessing the defragmentation database please wait Explanation Informational message that indicates the DCL interface is waiting for the database access update to complete User Action None DBCANTREAD cannot read a needed record from relation AD Explanation The database could not be read The cause of this problem may be an undefined logical corrupt database DFG software error or Rdb software error This problem can also be caused if the RMU Monitor process RDMS MONITOR is not executing Associated messages provide more detail User Action Verify that all DFG logicals are defined and ensure that RDMS MONITOR is running If RDMS MONITOR is not running it can be started by invoking GBYS STARTUP RMONSTART COM Refer to associated messages to determine if additional action is necessary DBCANTWRITE cannot write or update a record in relation AD Explanation The database could not be updated The cause of this problem may be an undefined logical corrupt database DFG software error or Rdb software error This problem can also be caused if the RMU Monitor process RDMS MONITOR is not executing Associated messages provide more detail User Action Try the command again If the error persists re create the database If the error persists after re creating the databas
326. play Using NOCONTINUOUS provides a snapshot display and then returns to the DCL prompt VOLUME default NOVOLUME The VOLUME qualifier indicates that a volume name instead of a script name is present on the command line The VOLUME qualifier must be used when a volume name is provided as a parameter to the MONITOR subcommand 4 46 Using Defrag PLUS Examples DEFRAGMENT MONITOR The following are examples of invoking the monitor DEFRAGMENT MONITOR MY SCRIPT NOVOLUME In this example the monitor function displays ongoing run time statistics for the defragmentation process associated with MY SCRIPT It also displays an approximate free space map of the target volume The display continues until interrupted with a Ctrl C Ctrl Y or Ctrl Z because the CONTINUOUS qualifier is present by default DEFRAGMENT MONITOR DISKSONE NOCONTINUOUS In this example the defragmentation process executing against DISK ONE is monitored Since the NOCONTINUOUS qualifier was specified the monitor function samples the defragmentation process statistics and the free space on DISK ONE one time before exiting to the DCL prompt Using Defrag PLUS 4 47 DEFRAGMENT OFFLINE_VOLUME DEFRAGMENT OFFLINE_VOLUME 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 AFTER EPILOGUE INTERVAL
327. portion and free space portions are calculated files_larger_than_a_cluster 0 weighted_fragged_files 0 do for each file that is larger than a cluster begin files_larger_than_a_cluster files_larger_than_a_cluster 1 weighted_fragged_files weighted_fragged_files extents for this file MAX 0 extents_for_this_file window size end file portion 100 100 files larger than a cluster weighted fragged files 8 calculate each move area extent temp total freespace i 0 do for each move_area_extent entry or temp goes to zero i itl temp temp minimum move area extent i temp i represents the best we can do given the files we can not move freespace portion freespace_extents i 2 defragment_index file_portion freespace_portion DEFRAGMENT SHOW Command Report C 17 D Brief Log File Example Example D 1 shows an example of a brief log file Example D 1 Brief Log File Disk File Optimizer for OpenVMS DFG V2 6 Time 04 APR 2001 12 57 10 82 Process ID 2100013D Node SPIELN Run time parameters Defragmentation level 2 Defragment placed files o Defragment indexed files Yes Log file report Brief otify user by mail o otify user by opcom Yes Default priority 4 inimum priority 3 Query hotfile database o RVN to defragment 0 Consolidate freespace Yes Perform write check o Defragmentation process start Process ID 2100013D Device _ 1 DKA0 Time
328. portion of the line before you reenter the command Errors that occur while a command is executing may indicate that you have entered an invalid value for a parameter or qualifier In these cases you can use the DCL command HELP DEFRAGMENTATION or consult Chapter 3 Using Defrag or Chapter 4 Using Defrag PLUS to determine legal values before you reenter the command F 1 4 Reporting System Software or Hardware Errors When a message notifies you that a system software or hardware error has occurred action is required by the system operator or system manager The Introduction to VMS System Management Manual provides information on how to submit an SPR to Compaq when you encounter a software error F 2 Disk File Optimizer Messages This section lists and describes all messages generated by the Disk File Optimizer software They are listed in alphabetical order using the IDENT field of the message Many of the text portions of the following messages contain FAO formatting control sequences These sequences begin with an exclamation mark They indicate that variable data is supplied to this message They also indicate the type of variable data to expect such as string or numeric data For example the DISFAIL1 message contains the following text failed to disable AS According to the error description the failure is related to a specific script supplied in the message Thus the AS control sequence is replaced by the name of the scri
329. pt that could not be disabled Additional information about FAO control sequences can be found in the VAX VMS System Services Reference Manual ABOFAIL1 failed to abort AD Explanation DFG DEFRAGMENT returned a failure status when it attempted to abort the specified script This message is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course of action F 2 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages ABOFAIL2 noscript was aborted Explanation DFG DEFRAGMENT returned a failure status when it attempted to abort all scripts in the scheduling database This message is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course of action ABO Aborted defragger on AD Explanation The DFO process running on the given disk was stopped User Action NONE ABORTNOTDONE abort unsuccessful Explanation An ABORT subcommand was unsuccessful This is a summary message This message may or may not indicate an error Associated messages provide more detail User Action Refer to associated messages to determine a course of action ABOSEEN abort command already issued for AD Explanation An ABORT subcommand had been issued for this script but it had not yet completed when another ABORT subcommand for the same script was issued User Action Wait for the com
330. r input Associated messages indicate the reason User Action Refer to associated messages to determine a course of action OPENMAILERR cannot open mail file for MAIL NOTIFICATION Explanation The mail file cannot be opened by the scheduler when attempting to notify users by way of the MAIL NOTIFICATION qualifier Associated messages indicate the reason User Action Refer to associated messages to determine a course of action OPENOUT error opening AD as output Explanation The specified file could not be opened for output Associated messages indicate the reason User Action Refer to associated messages to determine a course of action OPTBADLIN AD Explanation Supplementary message to sundry OPT xxx messages prints the line that triggered the error message User Action Correct the offending line F 24 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages OPTBADVOL invalid device specified on line SL options file AD Explanation A volume was specified with a file name in the options file and the volume was not the target defragmentation volume User Action Correct the invalid line in the options file Specify no device name or specify the target device name OPTFILERR options file error Explanation The options file contained errors This is a summary message Associated messages provide more detail User Action Refer to associated messages to determine a course
331. ragment it MISSING LOGICAL the logical name AD is not defined Explanation A required logical name is not defined User Action Define the indicated logical name and try the command again Defragmentation Messages F 17 Defragmentation Messages F 2 Disk File Optimizer Messages MISSNGVAL AD qualifier requires a value in this context Explanation A qualifier needed a value such as a script name but the user did not provide one User Action Provide the value requested MODIFIED AD modified Explanation The specified script has been modified User Action None MONBRKNDB monitor unable to access database for script information Explanation This error occurs if the monitor cannot access the scheduling database The most likely causes of this error are the logical name DFG DEFRAGMENT is not defined the database does not exist User Action If this message persists and the other defragmentation software is working scheduler DCL interface defragmentation processes submit an SPR MONINVCOL too few columns in display please resize Explanation The display has too few columns to display meaningful information User Action If your terminal is a DECwindows DECterm resize the window as appropriate If your terminal is a VT100 style device submit an SPR MONINVROW too few rows in display please resize Explanation The display has too few rows to display meaningful information User Action If your terminal i
332. re 5 17 and to Table 5 7 Select a volume from the list in the Show Volume options dialog box Select any of the options for showing volume information Table 6 8 describes the options IF you keep the Statistics option default and double click on the volume or dick on OK you will see a scrollable page of a Fragmentation Report showing fragmentation index Freespace Summary and File Fragmentation Summary plus more information that you can scroll down Refer to Figure 5 18 IF you select the Histogram option you will see that portion of the Fragmentation Report that shows the File Fragmentation Histogram for the number of files with a given number of extents and the Volume Free Space Historgram which shows the free space size in LBNs Refer to Figure 5 19 and Figure 5 20 Finish the Report Volume Defragmentation operation by selecting OK to show the volume report and optionally create the output file you named in the Output File field The dialog box disappears Apply to show the volume report and optionally create the output file you named in the Output File field The dialog box remains Cancel to leave the Report option The DECwindows Interface for Defrag Plus 6 39 The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Figure 6 23 The Report Volume Selection Dialog Box DISKSARPG2 1H2 DISKBUSERI Location Apply Cancel Help 6 40 The DECwindows Interface
333. rface for Defrag 5 4 Monitor a Volume 3 To view more detailed information about the allocated space shown on the Defragmentation Volume M ap 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 Figure 5 11 is an example of the volume map file information Figure 5 10 Monitor Menu 2 File Optimize volume Full Volume Welcome to Disk File Optimizer Please make a menu selection ta continue 5 16 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 4 Monitor a Volume Figure 5 11 Volume Map File Information ALLOCATED LEN 2018250 3900 Blocks LEN 2078250 DFO TEST 1 DFO TEST 1 ML LEN 2018678 DFi3 TEST 1IDFO TEST 1 LT The DECwindows Interface for Defrag 5 17 The DECwindows Interface for Defrag 5 4 Monitor a Volume 5 4 1 Defragmentation Process Statistics Window The Defragmentation Process Statistics Window shows the process information and statistics on how files and space on the volume are allocated during defragmentation Figure 5 12 shows the Defragmentation Process Statistics window and Table 5 5 describes the data field information Figure 5 12 Defragmentation Process Statistics Window Disk File Optimizer Process Statistics rocess Id 32800247 Process prG DFO TEST Date Ri rEB 1997 13 32 83 71 i cript Name DEFRAG 1 SDKB300 i i SPIELN
334. rface that exists between the monitor process the scheduling process and the defragmentation process The process experiencing the error will continue though not all data may be available for the monitor display User Action None MOREINFO module AD Line SL Explanation Provides module name and source line of error User Action None MOVFILINFO1 Relative volume number UL Explanation This is issued to give more information to the maintainer about a movefile error either MOVFILQIOERR or MOVFILSTSERR User Action Submit an SPR MOVFILQIOERR QIO error on movefile for volume AD Explanation This is an internal error the movefile QIO was formatted incorrectly by the defragmentation process User Action Submit an SPR MOVFILSTSERR status error on movefile for volume AD Explanation The movefile QIO returned an error status to the defragmentation process Subsequent messages provide the specific error encountered User Action Refer to subsequent messages to determine a course of action MULTSUCC multiple successors not allowed Explanation The script named as predecessor already has a successor defined User Action Specify a different predecessor or none NOABO Defragger on AD was not stopped Explanation The DFO process running on the given disk was not stopped User Action Determine if a DFO process is actually running on the particular disk Also check the CPU state of the DFO process If the pr
335. rite or both Enabling data check causes extra I Os when accessing a file The default is not to have data check enable You can check it by using the following command SHOW DEVICE FULL volume name The header of the display will have the words data check on reads and or data check on writes You can disable the data check using the following command SET VOLUME DATA CHECK NOREAD NOWRITE volume name 2 3 4 SET VOLUME NOERASE ON DELETE Erase on delete writes a system specific pattern over the file when the file is deleted Enabling erase on delete causes extra I Os when deleting a file The default is not to have erase on delete enabled You can check it by using the following command SHOW DEVICE FULL volume name The footing of the display will have the words erase on delete You can disable the erase on delete using the following command SET VOLUME NOERASE ON DELETE volume name 2 4 Disk File Optimizer Licensing Considerations Disk File Optimizer is furnished only under a license and it supports the OpenVMS License Management Facility License units for the software are granted for use on one specified system based on the processor system dass The system dasses are Workgroup Departmental and Enterprise For more licensing information please refer to the Software Product Description 55 85 xx When using DFO on a standalone system the system must be licensed according to the dass of CPU of that system When u
336. rocess quotas PQL_Mxxx e DFO logical process quotas By changing the SYSGEN process quotas or DFO logical process quotas you can define the process quotas for the defragmentation processes The following sections describes these values and describes how to change them 4 8 Using Defrag PLUS Using Defrag PLUS 4 3 Scripts 4 3 5 1 Hard coded values You cannot change the hard coded values for the defragmentation processes but the following shows the hard coded values ASTLIM 100 BIOLM 18 BYTLM 61440 DIOLM 18 ENQLM 500 FILLM 50 J TQUOTA uses system default PGFLQUOTA 50000 PRCLM 8 TQELM 10 WSDEFAULT 512 WSEXTENT 16000 WSQUOTA 2048 4 3 5 2 SYSGEN Process Quotas The SYSGEN PQL M xxx process quotas are defined in SY SGEN You can change these dynamic PQL_Mxxx parameters in SYSGEN For more information on SY SGEN process quota values refer to the SYSGEN Generation Utility This list shows the POL M xxx parameters that affect the defragmentation processes PQL MASTLM PQL MBIOLM PQL MBYTLM PQL MDIOLM PQL MENQLM PQL MFILLM PQL MJTQUOTA PQL MPGFLQUOTA PQL MPRCLM PQL MTQELM PQL MWSDEFAULT PQL MWSEXTENT PQL MWSQUOTA Using Defrag PLUS 4 9 Using Defrag PLUS 4 3 Scripts 4 3 5 3 DFO Logical Process Quotas DFO provides logicals that allow you to define the process quotas for the defragmentation process These logicals are defined in SYS STARTUP DFG STARTUP COM When you install DFO th
337. roduct The Defrag PLUS variant of the software as described in Chapter 4 provides scheduling options and allows you to store defragmentation commands in a database 3 2 1 Interface Disk File Optimizer commands are available from the DCL interface or from within the Disk File Optimizer When you enter a command from within the Disk File Optimizer you do not enter the word DEFRAGMENT first except for the DEFRAGMENT FILE and DEFRAGMENT VOLUME commands Examples of defragmentation DCL commands DEFRAGMENT FILE C FULL LOG defrag c log DEFRAGMENT MONITOR DUAI DEFRAGMENT SHOW DUAI1 The same commands entered from within the DFO utility would look like this DEFRAGMENT DFO DEFRAGMENT FILE C FULL LOG defrag_c log DFO MONITOR DUAL DFO SHOW DUAL Using Defrag 3 1 Using Defrag 3 2 Defrag Capabilities 3 2 2 Online Help If you need a reminder of the Disk File Optimizer command syntax while working on the system you can access online help at the DCL prompt or from within the Disk File Optimizer utility To access online help enter the following commands at the DCL prompt HELP DEFRAGMENT or DEFRAGMENT HELP To access online help from within the Disk File Optimizer software enter the following command DFO gt HELP 3 2 3 Speed and Effectiveness of Defragmentation Operations How quickly and effectively the defragmentation process defragments a volume depends on a number of variables such a
338. rray Yes A controller created RAID array appears as a normal but possible very large logical volume and is defragmented as such The logical volumes presented by the StorageWorks RAID Software for OpenVMS or POLYCENTER Disk Striping from RAID 5 arrays or stripesets may also be defragmented When you create a script specify the RAID array Do not defragment individual members of the RAID array as they consist of one large file that is not fragmented and should not be moved Can defragment a shadow set Yes When you create a script specify the DSAx volume Do not defragment individual members of the shadow set How do know when it is time to defragment INDE XF SYS There are two indications that INDEXF SYS needs defragmenting e f you receive a file header full error you should defragment INDE XF SYS This error means that INDEXF SYS cannot extend any more without the file header extending into another header The file header cannot have more than one header e f INDEXF SYS has more than five extents it is a candidate for defragmentation By OpenVMS file system design INDEXF SYS has a minimum of four extents By DFO product design DFO will only defragment INDEXF SYS if it has more than five extents Use the following command to check the number of extents in INDEXF SYS DEFRAGMENT SHOW volume name VOLUME LOCATION 000000 INDEXF SYS How do I do an offline defragmentation of INDEXF SYS Refer to OFFLINE VOLUME com
339. rt line or click on the file list button for a list of files to select from Refer to Figure 6 6 e f you choose the Volume Index File option enter a specific disk name or names on the Disk insert line or click on the disk list button for a list of disks to select from Refer to Figure 6 7 5 Fill out the rest of the Define dialog box according to the field description information in Table 6 1 6 Click on the Restrict button in this dialog box and fill in the information fields according to the information in Section 6 4 1 2 7 Click on the Schedule button in this dialog box and fill in the schedule script information fields according to the procedure in Section 6 4 1 3 8 To complete the script creation process dick on OK to complete the script and close the dialog box e dick on Cancel to close this dialog box and return to the previous screen e dick on Apply to save the script and keep the present dialog box open 6 6 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu 6 4 1 1 Define a Script Before you can create a script or optimize a volume or file you have to define a script using one of the Script Define dialog boxes for Volume Selected Files or Volume Index File Figure 6 5 shows the script define dialog box for a volume Refer to Table 6 1 for a description of the information fields Figure 6 5 Script Define Dialog Box for a Volume isk File 2 ptimizer
340. rtial Volume Window lessen 5 5 Report on the State of a Volume lell ess 5 5 1 Graphics FORMAL paare dod oie eek en hehe ae Db ded boa ead 5 5 2 WOEXEFOrMAl diii G share tread DITITTTLI 6 The DECwindows Interface for Defrag Plus V 6 1 Introduction iii Rb eee eee eee be GREG 6 2 Pile Menu cem Dep ue We RIO Deque eR e pa 6 3 Optimize Mentur 95 eni eot c xod ew hone ean Rr iw ade Roe o RUE a 6 4 ScripE Menta uu koci iie i dace aia edhe Sete Depuis uie BUS RE PR RU Dog 6 4 1 Greate SA iIptS MOI 6 4 1 1 Define a SqipE eese a nak A nE aie a ae a aAA EEE MNAE RR 6 4 1 2 Restrict Special Files Dialog Box 6 4 1 3 Schedule a Script Dialog BOX 2 00 6 4 2 Modify a STIPE case e ye ER node hear UE EREREA E de REESE 6 4 3 Remove a Script ees 6 4 4 Show a Sepie 0 045 theslewie eee Oe selene eget eee eee 6 4 5 Schedulea Script 22 scee esse cee eee lee ee ete eee eee ls 6 4 6 Abot a Saqipi side ER D P RE ee eee EU RERG RE E RE RA 6 5 Monitor a Script or Volume emoi ea i a daa a aia aa aa ees 6 5 1 Defragmentation Process Statistics Window ss 6 5 2 Full Volume WIndOW i sing aaa a aa aa a ee Exe yee eee ee en 6 5 3 Partial Volume Window lees 6 6 Report on the State of a Volume 0 00 enn 6 6 1 Graphics Format csiccuieRll ARR RE 6 6 2 ule d m rc baie wih De ed aon ale ANE hee oe 6 7 Options Menu i dl kim eee ae ER REPRE ee de ER UE 6 7 1 Setting Process Limits
341. s e The amount of free space on the volume If all other variables are constant a volume with little free space takes longer to defragment than a volume with a lot of free space e The number of users accessing files on the volume Because the defragmentation process does not impact a user s ability to read and write files it cannot defragment a file that is being accessed Thus a large number of user file accesses on the target volume can negatively impact the effectiveness of the defragmentation process e User set CPU or I O limits In general the more restrictive the limits the longer it takes to defragment a given volume 3 2 4 Scheduling Defragmentation Operations Although Defrag does not provide actual scheduling capabilities you still need to consider the best time to run defragmentation operations on your system Use VAX Performance Analyzer VPA or DEC Performance Solution DECps software to find many of the parameters such as periods of low activity that will help determine the best times to schedule the defragmentation process 3 2 4 4 Scheduling Guidelines Use the following scheduling guidelines e Schedule defragmentation during periods of low user activity This step ensures the process can defragment all candidate files If a user opens a file while the defragmentation process is running the fragmented file cannot be defragmented e Schedule the defragmentation process periodically to maintain volumes i
342. s Limits Procedure This option allows you to show the defragmentation process limits in effect on all nodes in the VMSduster system You may also produce an output file to report this information Use the following procedure to show defragmentation process parameters 1 2 Select the Options pull down menu Select the Show Process Limits option and the Show Process Limits dialogue box appears Refer to Figure 6 29 6 46 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 7 Options Menu 3 Select to produce an output file IF you do not want an output file proceed with Step 4 IF you want an output file select the Output File option and enter the file name 4 Finish the Show Process Limits option by selecting OK to leave the Show Process Limits dialog box and optionally produce the output file e Apply to produce and output file The dialog box remains so you can produce additional output files e Cancel to leave the Show Process Limits option Figure 6 29 The Show Process Limits Dialog Box CPU limit I limit Process limit U CPU limit 100 IO limit 50 Process limit 51 The DECwindows Interface for Defrag Plus 6 47 Programmer s Guide This part contains information on how the Disk File Optimizer software is designed and how programmers can use the callable interface to build in defragmentation capabilities to an application program T Calla
343. s a DECwindows DECterm resize the window as appropriate If your terminal is a VT 100 style device submit an SPR MONNOVOL AD is nct currently being defragmented Explanation An attempt was made to monitor a script that is not executing User Action Monitor only executing defragmentation processes MONPRIV READALL WORLD and SYSLCK privileges are required for monitor Explanation The user has insufficient privileges to monitor a running defragmentation process User Action Set the READALL and WORLD privileges and try the command again MONRDERR error SL while reading the monitor interface Explanation This error occurs if a process cannot read data using the interface that exists between the monitor process the scheduling process and the defragmentation process The process experiencing the error will continue though not all data may be available for the monitor display User Action None F 18 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages MONUNEXP unexpected error from AD Explanation An error occurred in a call to the Screen Management facility SMG The SMG routine that returned the error is displayed A subsequent error message contains the SMG error code User Action Refer to the subsequent error message to determine a course of action MONWRERR error SL while writing the monitor interface Explanation This error occurs if a process cannot write data using the inte
344. s all TMP files on the entire volume In Options File The Options File option provides an alternate method for associating files with the Dormant File Exclude File or Frequent File options You may enter the file name or use the file list button to bring up a list of files to chose from If the list of files for any of these options is long you can create a separate file for this information Each record of the options file consists of a file name followed by one of these keywords e EXCLUDE File to be excluded e FREQUENT File to be considered frequently accessed e 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 The DECwindows Interface for Defrag 5 11 The DECwindows Interface for Defrag 5 3 Optimize Menu 5 3 1 3 Schedule Optimization The Schedule Definition dialog box allows you choose many different defragmentation schedule parameters The types of parameters that you ll find in the dialog box are e Wait for completion or not e CPU Limit e 1 0 Limit Time limit e Optimize process priority e Execute a prologue command file be
345. s been removed from the database User Action None REMOVENOTDONE remove unsuccessful Explanation A REMOVE subcommand was unsuccessful This is a summary message This message may or may not indicate an error Associated messages provide more detail User Action Refer to associated messages to determine a course of action Defragmentation Messages F 27 Defragmentation Messages F 2 Disk File Optimizer Messages F 28 REMOVSEEN remove command for AD already issued Explanation A REMOVE subcommand had been issued for this script but it had not yet completed when another REMOVE subcommand for the same script was issued User Action None RESAREA Map pointer copy would extend into a reserved area Explanation The copy of INDEXF SYS map pointers would run into a reserved area User Action Submit an SPR RMDBACCERR database access error relation AD operation AD Explanation The RMS database could not be accessed The cause of this problem may be an undefined logical corrupt database DFG software error or RMS software error Associated messages provide more detail User Action Verify that all DFG logicals are defined Refer to associated messages to determine if additional action is necessary RMSERR RMS operation AD failed file AD Explanation The specified RMS operation failed User Action Refer to associated messages to determine a course of action RSVDNAM Script name reserved for use by Defra
346. s dhe tote gr PUR eh ee Ged ee ee eek UR Command Operation s cassiere asirar na KENE ee File Fragmentation Example 0 000 cece eee eee eee Allocating Fragmented Files 0 00 0 c cece ees Process Statistics Display leen Process Activities Display lisse Free Space Display seseee ees Process Statistics Display with Message Display Process Statistics Display ien Process Activities Display lle Free Space Display ux ende eme eee eta kde een bales EE Process Statistics Display with Message Display Initial WINdOW uu ou ee xn leen eee eee Meade RUP ad Bo Pile Menu i deed tacts werde aote dom edi e beh aes e ee Bae Bee doe Optimize MENU s iiss deren Anu deme ed tdes teed eee Define Dialog Box for a Volume isseeee es Define Dialog BoxforaFile sseeee ee Define Dialog Box for a Volume Index File 0005 Restrict Special File Dialog Box 0 0 0 es Schedule Definition 22 ssepe eee ne ea epa The Abort Dialog BOX 2 2 ns Monitor Menu cd oper E kx ed ibe ge EE REX E EE Ee Volume Map File Information 00000000 cee Defragmentation Process Statistics Window Ls Defragmentation Full Volume Map Window seen 1 6 1 9 1 10 3 22 3 23 3 24 3 25 4 43 4 43 4 45 4 46 5 1 5 2 5 3 5 4 5 5 5 6 5 9 5 12 5 15 5 16 5 17 5 18 5 21 5 14 Defragme
347. s or extends a file while the index file is being read User Action None the software will retry the operation until a consistent copy is read F 12 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages IDXFILEFULL INDEXF SYS is completely full You must delete some files Explanation The index file or header is full The program needs at least one free file header User Action Delete unneeded file s IDXOPT Your index file is already optimal no further work needed Explanation The index file is already optimal No further work is needed User Action None The program has completed IEDBDATA logically inconsistent data in relation AD Explanation The database contains inconsistent data The root of the problem may be that the RMS database is corrupt that the DFG software has an error User Action Submit an SPR Indude a dump of the scheduling database contents if possible IELOGNAM internal error invalid supersede flag Explanation This is an internal error User Action Submit an SPR IESCHFILNODTYP relation AD illegal file or node type SL Explanation This is an internal scheduler error User Action Submit an SPR IESCHFUNC illegal function code SL in AD Explanation This is an internal scheduler error User Action Submit an SPR IESCHIMPOSS internal logic error in AD Explanation This is an internal scheduler error User Action Submit an SPR IESE1 i
348. s tuith sons allocation b42 Tote File extents on the dlekt 7303 Average number of File extente per file 1 034916 Hedian nurher oF file extents pes Pile 1 Hoot Froanentes Filet TYNES COND SYSEXEISYSS0UEUE_MAHIGER OMAWEIOIRYPL EL 49 extentel File Fragmentation Histapgren File Fragmentation Histapran I o 2I OH od ee pom or dum BARRERIGER AAKA IRE OE RACER GERE RERO TTT Hab of Files with a given r nbor of oxtonte Each cormesponco bo BO Filos lure Freespace Histugram Freespaps Size LENE Lidadd To 4235 BiSL To ggz BBi0G To P2626 42184 To E4T4 3763 To S654 l 7344 To z64s5 12064 Ta 1231 4045 To 5628 7308 To 73 6 42 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Figure 6 26 Report Volume Volume Space Histogram Yolunc Freoespacre Hiotesram Freetpaps Size LENS The DECwindows Interface for Defrag Plus 6 43 The DECwindows Interface for Defrag Plus 6 7 Options Menu 6 7 Options Menu This pull down menu option allows you to set and show these Disk File Optimizer process parameters e CPU usage e O limit e Process limit Figure 6 27 shows the Options pull down menu Figure 6 27 Options Menu File Optimize Script Monitor Report Set Process Limits Show Process Limits Welcome to Disk File Optimizer Please make a menu selection to continue
349. same effect as the RVN 2 DCL qualifier Operations You may elec to defragment specific files consolidate disk space or do an analysis check only File defragmentation and space consolidation can be done together Defragment Files Allows you to select which files to defragment Use the three position sliding bar e LEFT Files that are not 100 contiguous e MIDDLE Files whose extent cannot be completely mapped RIGHT Files with retrieval points in more than one file header Consolidated Freespace Consolidate the free space on the volume Volume analysis only Requests a volume analysis only no defragmentation occurs The results are available in the log file The operations has the same effect as the LEVEL 2x DCL qualifiers as shown in Table 6 2 LogFile TheLog 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 e The Brief option lists only the statistics of each phase such as number of files analyzed and number of files defragmented e The Full option lists all files analyzed by the defragmentation process and reports their disposition during each phase of defragmentation This has the same effect as the LOGHog_file and FULL or BRIEF DCL qualifier continued on next page The DECwindows Interface for Defrag Plus 6 11 The DECwindows Interfa
350. script is enabled or disabled and the target device for the script NODEz node name NONODE default The NODE qualifier selects only those scripts and node names that are specified on the command line 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 OUTPUT file spec OUTPUT SYS OUTPUT default The OUTPUT qualifier may be used to show the volume fragmentation state or to show information from the scheduling database It directs the output of the SHOW subcommand to a file By default output is directed to SYS OUTPUT PARAMETERS NOPARAMETERS default 4 60 Using Defrag PLUS Examples DEFRAGMENT SHOW The PARAMETERS qualifier is used to show 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 RUNNING The RUNNING qualifier shows scripts that are currently running STATISTICS default NOSTATISTICS The STATISTICS qualifier is used to show the volume fragmentation state It provides a summary of the file and free space fragmentation for the volume Refer to Appendix C for
351. script manually using the DEFRAGMENT START command Alternately if the linked set of scripts executes on a periodic schedule you can wait for the next period when all the scripts in the linked set execute automatically Using Defrag PLUS 4 11 Using Defrag PLUS 4 6 Disk File Optimizer Command Set 4 6 Disk File Optimizer Command Set The Defrag PLUS command set provides the system manager with a full range of scheduling and execution options for file and volume defragmentation Scripts can execute once or on a periodic schedule depending on the command qualifiers selected Table 4 2 briefly describes the Defrag PLUS commands Table 4 2 Defrag PLUS Command Summary Command Description DEFRAGMENT ABORT 4cript namef volume namel QUALIFIERS DEFRAGMENT ATTACH 4process name IQUALIFIERS DEFRAGMENT CANCEL cript name QUALIFIERS DEFRAGMENT DISABLE 4Script namef QUALIFIERS DEFRAGMENT ENABLE cript name QUALIFIERS DEFRAGMENT EXIT DEFRAGMENT FILE file name IQUALIFIERS DEFRAGMENT HELP command DEFRAGMENT MODIFY 4script name QUALIFIERS DEFRAGMENT MONITOR amp cript name volume name QU ALIF I ERS 4 12 Using Defrag PLUS Aborts the defragmentation process associated with the specified script Before exiting the defragmentation process performs an orderly shutdown of all outstanding activities Transfers control
352. se correct the calling program INVITMLST invalid combination of items in item list Explanation This message indicates the dfg list or sch list parameter to DFG DEFRAGMENT was logically invalid One of the lists contained item codes that were not compatible User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVITMUKN an item list contained an unknown item code Explanation This message indicates the dfg list or sch list parameter to DFGSDEFRAGMENT contained an item descriptor with an unknown item code It may also indicate a faulty item list 2 returned from DFG DEFRAGMENT as part of the SHOW subcommand User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVITM invalid item list item SL is in error Explanation This message indicates the dfg list or sch list parameter to DFG DEFRAGMENT was incorrectly formatted or logically invalid It provides the item number that was incorrect Associated messages indicate further errors User Action If the call to DFG DEFRAGMENT was from Compaq supplied software submit an SPR Otherwise correct the calling program INVLMFLIC insufficient license units to run DEFRAGMENT Explanation The DFG software is not licensed to run on this node User Action Install the DFG license INVLOGNAM AD isan invalid logical name Explan
353. sent The default CPU limit applied to all nodes that do not have an explicit CPU limit A DFG K_NODE item descriptor may be associated with the DFG K SHOW CPU item list DFG K NODE can indicate any positive number n gt 0 of node names If multiple node names are requested DF G DEFRAGMENT returns the CPU percentage in the same order as the node names provided If the user buffer is too small for all data the data is truncated and DFG DEFRAGMENT returns an appropriate status DFG K SHOW CPU may be the first item descriptor in an item list that optionally contains other DFG K SHOW XXXX item descriptors and a DFG K_NODE descriptor The uses of the buffer length buffer address and return length address fields for the DFG K SHOW CPU item code are as follows buffer length Size of the user supplied buffer in bytes The length of the buffer must be at least number of nodes x 4 bytes and must be an integral multiple of four e buffer address Address of the user supplied buffer into which DFG DEFRAGMENT writes the current maximum CPU percentage return length address Address of a longword buffer into which DFG DEFRAGMENT writes the number of bytes returned in the buffer pointed to by the buffer address DFG K SHOW IO 7 26 Callable Interface When the DFG K_SHOW_IO item descriptor is encountered DFG DEFRAGMENT returns the following data in the user supplied buffer If DFG K_NODE is present The direct I O l
354. sents how free space is organized on the volume being defragmented The Y axis indicates the percentage of free space in a given LBN range the X axis indicates the LBN range A fourth display of information the message display appears on the bottom of your screen whenever a broadcast message is received by the process executing the monitor The message display holds the last four broadcast messages such as mail notification received by the process To erase this display enter Ctrl W to remove this display entirely enter R or press the Remove key To scroll through the broadcast messages enter Ctrl T Figure 3 4 shows the process statistics display with the additional message display Figure 3 4 Process Statistics Display with Message Display le Edit Commands Options Print Defragmentation Process Activities File Evaluation Dormant count Files evaluated 4 Exclude count Candidate count 4 Frequent count Total placed files 0 Total indexed files 1 File Defragmentation Files partly defragmented Files defragmented a Files processed File Placement Free Space Consolidation Dormant files placed 0 Extent count i5 Frequent files placed o Countdown 54 PIIETA16 727346 DFGDCL CPU 00 02 42 15 PF 33306 ID0 35965 MEM 302 PICFTAI6 3T 47 DEGDCL CPU 00 102 43 1 PF 33306 IO 352 28 MEM 302 DIIDETAD6 2237243 DFGDCL CPUz00 02 42 1 PPFz33306 IOz35991 MEM 302 PICFTA16 37 48 DFGDCL CPU 00 02 43 1 PP 33306 IO 359 94 MEM 30
355. ser Action None PREPOSTERR could not execute AD file Explanation This error occurs when the DFO process cannot create a subprocess to execute the epilogue or prologue command file User Action Ensure the the epilogue and prologue files are available Check additional failure messages for more information PREPOSTSTART AD subprocess beginning Explanation Messages containing text destined for the log file User Action None PROCABORTED defragmentation process aborted Explanation The defragmentation process has aborted It could be that the total defragmentation time has been exceeded and the scheduler has stopped the defragmentation software Thus this message does not necessarily indicate failure User Action Refer to associated messages to determine a course of action PROCESS DEV Device AD Explanation Gives device that defragmentation process operates on User Action None PROCESS ID Process ID XL Explanation Gives process ID User Action None PROCESS START defragmentation process start Explanation This message is generated by the defragmentation process after it has completed initialization User Action None F 26 Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages PROCESS STOP defragmentation process normal completion Explanation This message is generated by the defragmentation process after the process has successfully completed User Action None
356. set for a given volume using SET VOLUME device spec WINDOWS n e LEVEL 3 Any file with retrieval pointers in more than one file header is a candidate for defragmentation e LEVEL 4 The defragmentation process for level four processing performs only free space consolidation This level is used with the CONSOLIDATE FREESPACE qualifier e LEVEL 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 qualifier If level 5 is selected the LEVEL 2 candidate file specifications are listed in the full log file 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 MAIL NOTIFICATION NOMAI L 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 NODEz node name
357. sing DFO in a cluster only one node in the duster must be licensed to run DFO That one node can then defragment all the disks that are accessible within that cluster For performance reasons many customers have DFO licensed on multiple nodes within the cluster This will speed up the defragment process for all the disks and spread the load among the processors 2 5 VMScluster System Considerations When creating scheduling scripts you may want to consider the impact of the following on your VM Scluster system e Processes per node e Common scheduling database e Locally mounted volumes The following sections describe these considerations Getting Started 2 3 Getting Started 2 5 VMScluster System Considerations 2 5 1 Processes Per Node When setting up the scheduling database you may want to limit the number of defragmentation processes on a node Unless specified a node can start an unlimited number of defragmentation processes To limit the number of defragmentation processes on a node use the DEFRAGMENT SET command DEFRAGMENT SET PROCESS_LIMIT 2 NODE node_name You can specify different process limits for each node by specifying the NODE qualifier If you do not specify the NODE qualifier all nodes in the database are affected by the command To check the process limit parameter for the nodes in the database use the DEFRAGMENT SHOW command DEFRAGMENT SHOW PARAMETERS 2 5 2 Common Scheduling Database Be
358. so if something should happen to the database you can create a new database and reload it The following example shows the above interactive examples put in one command procedure LOAD DB COM DEFRAGMENT VOLUME 2 DKA100 SCRIPT DEFRAG 28DKA100 INTERVAL 1 00 00 AFTER 21 00 FULL LOG DFGSDATABASE DEFRAG 2 DKA100 NODE LUNTIC MAIL NOOPCOM NOTIFICATION DEFRAGMENT VOLUME 1 DUA2 SCRIPT DEFRAG_S 1SDUA2 INTERVAL 3 00 00 AFTER 17 00 FULL LOG DFGSDATABASE DEFRAG 1 DUA2 DEFRAGMENT OFFLINE VOLUME 1 DUA2 SCRIPT DEFRAG OFFLINE 1 DUA3 NOAFTER EXIT X X After creating the LOAD DB COM command procedure you can load the scheduling database with the following command QLOAD DB If you need to change the procedure edit LOAD DB COM and make the changes then remove the old scripts and reload them using the following commands DEFRAGMENT REMOVE QLOAD DB You will have to wait 30 seconds or so between the above commands to allow DFO to delete the scripts from the database 2 6 Getting Started Getting Started 2 6 Creating Scheduling Scripts 2 6 3 Modifying Scheduling Scripts for DEFRAG Plus This sections shows you how to modify a script using the DEFRAGMENT MODIFY command Chapter 4 contains complete descriptions of each command Use the following command to modify the DEFRAG _ 2 DKA100 script to start at 17 00 disable mail and also run on any of three nodes i
359. ss the Next Screen key The free space display shows the following device related information Figure 4 3 4 44 Using Defrag PLUS DEFRAGMENT MONITOR Figure 4 3 Free Space Display Free Space Distribution Map oo LEN 6 2055240 1110420 818DEAD ee blocks 133 2 Cluster size 4 e An approximate free space distribution map e The name of the device being defragmented The number of free blocks on the device e The duster size of the device The maximum LBN on the device The device information marked with an asterisk in the preceding list appears highlighted on the device display whenever it changes The free space map represents how free space is organized on the volume being defragmented The Y axis indicates the percentage of free space in a given LBN range the X axis indicates the LBN range A fourth display of information the message display appears on the bottom of your screen whenever a broadcast message is received by the process executing the monitor The message display holds the last four broadcast messages such as mail notification received by the process To erase this display enter Ctrl AW to remove this display entirely enter R or press the Remove key To scroll through the broadcast messages enter Ctrl T Figure 4 4 shows the process statistics display with the additional message display The following list summarizes t
360. ssociated messages provide more detail User Action Verify that all DFG logicals are defined Refer to associated messages to determine if additional action is necessary DBACCERR database access error relation AD operation AD status SL Explanation The database could not be accessed The cause of this problem may be an undefined logical corrupt database DFG software error or RMS software error User Action Verify that all DFG logicals are defined Refer to associated messages to determine if additional action is necessary DBACCW2 database access warning AD transaction sqlcode SL Explanation The Rdb software returned a warning status to the scheduler The problem may be that the database is corrupt that the disk file optimizer software has is in error or that the Rdb software is in error User Action Try the operation again If the error persists re create the database If the error persists after re creating the database submit an SPR DBACCW database access warning relation AD operation AD sqlcode SL Explanation The Rdb software returned a warning status to the scheduler The problem may be that the database is corrupt that the disk file optimizer software is in error or that the Rdb software is in error User Action Try the operation again If the error persists re create the database If the error persists after re creating the database submit an SPR DBACTRANS database transaction active Ex
361. structs the scheduler to execute this script every two days e Instructs the defragmentation process that all EXE files on the entire volume should be considered frequently accessed when final file placement decisions are made e Requests a log file MYLOG LOG which is placed in the directory from which this command was entered Requests a FULL log file e Instructs the defragmentation process that all ARCHIVE files on the entire volume should be considered dormant rarely accessed when final file placement decisions are made Limits the nodes available for the defragmentation process to nodes N1 and N2 DEFRAGMENT VOLUME DISKSTWO INHERIT MY SCRIPT SCRIPT FIRST SCRIPT This command inherits the script defined in the previous example Thus it creates a new script that is the same as MY SCRIPT except for the following differences e Thescript nameis FIRST SCRIPT instead of MY SCRIPT e The target volume is DISK TWO instead of DISK ONE In this case MYLOG LOG is also inherited Thus one version of the log file contains data from MY SCRIPT and the other version contains data from FIRST SCRIPT To prevent log file inheritance specify the LOG qualifier DEFRAGMENT VOLUME DISKSONE SCRIPT SECOND_SCRIPT PREDECESSOR FIRST SCRIPT This commands links SECOND SCRIPT to FIRST SCRIPT using the PREDECESSOR qualifier SECOND SCRIPT does not execute until FIRST SCRIPT completes successfully SECOND SCRIPT uses default parame
362. t Parameters Description The DEFRAGMENT FILE command defragments the files specified on the command line according to the DEFRAGMENT command line qualifiers Use this command to defragment a small number of files To defragment a large number of files use the DEFRAGMENT VOLUME command AFTER BRIEF CONSOLIDATE_FREESPACE DORMANT EPILOGUE EXCLUDE FREQUENT FULL HOTFILE_DATABASE IGNORE INHERIT INTERVAL DEFRAGMENT FILE file spec LEVEL LOG MAIL_NOTIFICATION NODE OPCOM_NOTFICATION OPTIONS PREDECESSOR PRIORITY PROLOGUE RVN SCRIPT TIME LIMIT WRITE CHECK file spec The file spec parameter identifies the file or files to be defragmented You may use wildcards for the file specification The DEFRAGMENT FILE command defragments the specified file or files according to the selected command line qualifiers When you specify a file name without the device and or directory the defragmentation software operates on files in the current directory on the current device You must explicitly specify the device and directory name for files not in the default directory where the command is issued This command may be permanently added to the scheduling and parameter database as a script If no script name is specified using the SCRIPT qualifier the defragmentation software generates a unique script name of the form DFG SCRIPTX X where X is a hexadecimal number This nu
363. t When reset to 0 the file list cannot be copied e DFG V INHERIT FREQUENT When set to 1 the frequent file list of an inherit script can be copied to the new script When reset to 0 the frequent file list cannot be copied e DFG V_INHERIT_INTERVAL When set to 1 the interval of an inherit script can be copied to the new script When reset to 0 the interval cannot be copied Callable Interface 7 17 DFG DEFRAGMENT e DFG V INHERIT LOG When set to 1 the log file specification of an inherit script can be copied to the new script When reset to 0 the log file specification cannot be copied e DFG V_INHERIT_NODE When set to 1 the node list associated with the inherit script can be copied to the new script When reset to 0 the node list cannot be copied e DFG V_INHERIT_OPTIONS When set to 1 the options file specification of the inherit script can be copied to the new script When reset to 0 the options file specification cannot be copied e DFG V INHERIT POST PROC When set to 1 the postprocessing file specification of the inherit script can be copied to the new script When reset to 0 the postprocessing file specification cannot be copied e DFG V INHERIT PRE PROC When set to 1 the preprocessing file specification of the inherit script can be copied to the new script When reset to 0 the preprocessing file specification cannot be copied e DFG V INHERIT PREDECESSOR When se
364. t improve I O performance 2 3 1 Move Log Files to One Volume You can improve I O performance on your system volume by moving log files to a dedicated volume Usually the system volume has a small duster size which causes the log files to have many small fragments By initializing the dedicated volume with a large cluster size you can keep the number of extents down You are also taking some of the writes to the volume off the system volume By moving these large open fragmented files to another volume you will see an improvement in DFO It will not have to work around all of these large open fragmented files when consolidating free space 2 3 2 SET VOLUME NOHIGHWATER MARKING High water marking guarantees that users cannot read data that was not written by them Enabling high water marking causes extra I Os when accessing the volume If you do not need this level of security you can disable this feature File high water marking is enabled by default To check if a volume has high water marking enabled use the following command SHOW DEVICE FULL volume name The footing of the display will have the words file high water marking You can disable the high water marking using the following command SET VOLUME NOHIGHWATER MARKING volume name 2 2 Getting Started Getting Started 2 3 Improving I O Performance 2 3 3 SET VOLUME DATA_CHECK NOREAD NOWRITE The data check operation causes a read after read a read after w
365. t script name will be deleted upon successful completion of the defragmentation process Volume Defragments the volume named in the volume field This has the same effect as using the DEFRAGMENT VOLUME DCL command Selected Files Defragments the file or files named in the files field This has the same effect as using the DEFRAGMENT FILE DCL command Volume Index Files Defragments the INDE XF SY S of the disk named in the disk field This has the same effect as using the DEFRAGMENT OFFLINE VOLUME DCL command Volume The Volume button only appears when the Volume or Volume Index File buttons are depressed Enter the volume name or use the Volume button to bring up a list of volumes or disks continued on next page 6 10 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu Table 6 1 Cont Define Dialog Box Fields Field Description Files The Files button only appears when the Selected Files button is depressed Push theFile button file to bring up a list of files Write Check The Write Check option requests that a read after write check be performed on all defragmented or placed files This qualifier significantly extends the execution time of a defragmentation process This has the same effect as the AWRITE CHECK DCL qualifier Relative Volume Number Allows you to select the relative volume number of a volume set This has the
366. t was issued User Action None SYSSRVERR call to system service AD failed Explanation A system service call failed User Action Refer to associated messages to determine a course of action TIMEINV invalid time string AD from AD Explanation The syntax of the time string supplied in the message was invalid or out of range The offending routine is also listed in the message User Action Submit an SPR containing the information in this message TRUNCSCR AD is too long generated from AD and AD Explanation This error is issued when a script name is expanded through wildcard expansion beyond the maximum allowed User Action Use fewer wildcard or normal characters in script name UNRECOVERR unrecoverable error Explanation The defragmentation process encountered an unrecoverable error no further processing occurred User Action Refer to associated messages to determine a course of action USERABORT command aborted by user Explanation The user decided not to continue after encountering the INVDEVCONT message This is a summary message User Action None USER ERR user error Explanation The user made an error Associated messages provide more detail User Action Refer to associated messages to determine a course of action USRKILLENG an ABORT command terminated the defragmentation process Explanation Because of a user issued ABORT command a defragmentati on process terminated User
367. t be placed frequent oved file has been moved number of extents unchanged EMPTY file was empty no action taken FAIL file s fragmentation cannot be reduced IN USE new disk space for file was in use no action taken OPEN file was open no action taken OMOVE file may not be moved no action taken UNAVL file was unavailable no action taken E 2 Full Log File Example continued on next page Example E 1 Cont Full Log File Full Log File Example d DISKSJIM DFO_TEST_6 DFO_TEST_6_MS TXT 9 1 extent d DISKSJIM DFO_TEST_5 DFO_TEST_5_MS TXT 9 1 extent d DISKSJIM DFO_TEST_3 DFO_TEST_3_MS TXT 11 1 extent d DISKSJIM DFO_TEST_3 DFO_TEST_3_MS TXT 35 1 extent d DISKSJIM DFO_TEST_9 DFO_TEST_9_MS TXT 9 1 extent d DISKSJIM DFO TEST 4 DFO TEST 4 MS TXT 11 1 extent End file defragmentation phase one 04 APR 2001 14 47 30 23 Statistics Number of files processed 116 Number of files defragmented 116 Number of files partly defragmented 0 Number of frequent files placed 0 Number of dormant files placed 0 Begin file defragmentation phase two 04 APR 2001 14 47 30 53 Files processed during defragmentation phase two ui DISKSJIM DFO TEST 5 DFO TEST 5 L TXT 3 6 extents x DISKSJIM 000000 L TXT 1 6 extents my DISKSJIM DFO_TEST_3 DFO_TEST_3_L TXT 3 3 extents d DISKSJIM DFO_TEST_4 DFO_TEST_4_L TXT 3 1 extent d DISKSJIM DFO_TEST_7 DFO_TEST_7_L TXT 3 1 extent d DISK
368. t guarantee file placement but makes every effort to place files as described EPILOGUE file name NOEPILOGUE default The EPILOGUE qualifier identifies a DCL command file which DFO executes upon completion of the DEFRAGMENT operation Refer to Appendix B for logicals that are available to these command procedures EXCLUDE file spec NOEXCLUDE default 4 68 Using Defrag PLUS DEFRAGMENT VOLUME The EXCLUDE qualifier specifies files to be 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 Note The defragmentation process always excludes system files open files files excluded in an options file OPTIONS qualifier and files excluded using the I GNORE qualifier FREQUENT f file spec NOFREQUENT default The FREQUENT qualifier indicates files to be 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarant
369. t job or to a process that does not exist If any of these connections are attempted an error message is displayed You can also use the ATTACH command with the DCL SPAWN WAIT command to return to a parent process without terminating the subprocess running the Disk File Optimizer software The ATTACH command cannot be used if your terminal has an associated mailbox e You cannot use the process name parameter with the IDENTIFICATION qualifier e You must supply either a process name or a PID for this command IDENTIFICATION pid IDENTIFICATION lets you specify the process identification PI D of the process to which terminal control will be transferred Leading zeros can be omitted 4 16 Using Defrag PLUS Examples DEFRAGMENT ATTACH The following are examples of the ATTACH command DEFRAGMENT ATTACH JONES 2 This ATTACH command transfers the terminal s control to the subprocess named J ONES 2 DEFRAGMENT ATTACH IDENTIFICATION 2A401A1B This ATTACH command switches control from the current process to the process whose PID is 2A401A1B Using Defrag PLUS 4 17 DEFRAGMENT CANCEL DEFRAGMENT CANCEL The CANCEL subcommand skips the next scheduled execution of the scripts specified in the command line Format DEFRAGMENT CANCEL scriptname ALL Parameters script name The script name parameter is the name of the scripts to be canceled You can use wildcards in the script name specification Use an
370. t to 1 the predecessor associated with the inherit script can be copied to the new script When reset to 0 the predecessor cannot be copied Note Inheriting the predecessor of one script to another changes the linked set of scripts For example if a set of linked script A B C exists and a new script D is created by inheriting script C the link changes to A B D C e DFG V INHERIT TIME LIMIT When set to 1 the time limit associated with the inherit script can be copied to the new script When reset to 0 the time limit cannot be copied DFG DEFRAGMENT creates or modifies a database entry for this script using the following method e Copies all enabled fields from the script specified by the DFG K_INHERIT item code to the new script Fields are enabled by setting the corresponding bit in the INHERIT MASK bit mask e Overwrites any fields in this copy with those specified by other item descriptors in the item list Refer also to the DFG K _ DFG FLAGS and DFG K SCH FLAGS item codes Names the new script as appropriate The script name can be specified using the DFG K SCRIPT item descriptor or can be assigned by DFG DEFRAGMENT 7 18 Callable Interface DFG DEFRAGMENT The uses of the buffer length buffer address and return length address fields for the DFG K_INHERIT item code are as follows buffer length Must be 12 buffer address Address of a three longword structure containing a string
371. tabase for hotfile records relating to the target volume The files listed in the hotfile records are automatically added to the FREQUENT file list The time over which the hotfile data is sampled depends on the scheduling information on the DEFRAGMENT command line as described in Table 4 1 Table 4 1 Sample Time Interval Selected Scheduling Result None selected Sample data over the previous 24 hours INTERVAL X Sample data over the previous X time period PREDECESSOR X Search through the list of predecessors If a predecessor is found with an INTERVAL time use that time If no INTERVAL is found use the previous 24 hours Both VPA and DECps allow you to modify the hotfile collection process If you have VPA installed use the ADVISE COLLECT command and NO HOTFILE _ QUEUE value qualifier If you have DECps installed use the ADVISE COLLECT SET command and the NO HOTFILE QUEUE value qualifier See the VPA or DECps documentation for additional details 4 3 5 Defining Quotas for the Defragmentation Process The process quotas are values applied to the defragmentation process and then disappear when the process is complete For more information on process quota values refer to the VMS Authorize Utility Manual You can define the process quotas for defragmentation processes When the defragmentation process starts up it selects the maximum value from the following three sources e Hard coded values e SYSGEN p
372. tation processes The scheduler does not abort scripts to reduce the number of defragmentation processes Instead it stops creating new processes and allows normal process completion to reduce the number of concurrent defragmentation processes Depending on whether the DFG K NODE item descriptor is part of this item list the process limit may affect all nodes or only those listed as part of the DFG K NODE item descriptor Further if DFG K NODE is not present the value provided with DFG K SET PROCESSES is assigned to every node in the scheduling database and becomes the default value for subsequent nodes not already in the database The uses of the buffer length buffer address and return length address fields for the DFG K SET PROCESSES item code are as follows buffer length Must be four e buffer address Address of an unsigned longword buffer containing the maxi mum number of defragmentation processes allowed on each node of the VAXcluster DF G K NODE not present or on the given nodes DFG K NODE present Specifying a limit of zero imposes no limit return length address Not used must be zero DFG K SHOW CPU When the DFG K SHOW CPU item descriptor is encountered DFG DEFRAGMENT returns the following data in the user supplied buffer If DFGS K NODE is present The CPU limit for each node supplied in the DFG K NODE item descriptor Callable Interface 7 25 DFG DEFRAGMENT If DFG K_NODE is not pre
373. ted Files lt gt volume Index File Operations i Defragment Files All Fragmented files Slowest A ERREUR E consolidate Free space E volume analysis only Notify Ey Log File feet Li Console Message lt gt Brigt Los lt gt Fatis CJ Mail Message In the Script Define dialog box for a file you can Select a file name Select to enable or disable write check Select the relative volume number of a volume set Select whether to defragment files and what kind of files to defragment Select whether to consolidate freespace or not Select whether or not to do a volume analysis Select whether to notify you by log file console message mail message or by all three Select whether to report brief or full log files Select whether to inherit the properties of another script 6 8 The DECwindows Interface for Defrag Plus The DECwindows Interface for Defrag Plus 6 4 Script Menu Figure 6 7 shows the script define dialog box for a volume index file Figure 6 7 Script Define Dialog Box for a Volume Index File Disk File Optimizer Create Script ta Optimize Volume Index Fil Script Name Define schedule Optimize lt gt volume i lt gt selected Files lt gt volume Index File Noni By Log File Leet Li Console Message lt gt Eriet Los CJ Mail Message
374. ter 4 1 4 2 DUMP Utility The Dump utility shows how many extents compose a file and the starting LBN for those extents An example of using the Dump utility is given in Example 1 1 For more information see the VMS DCL Dictionary 1 4 3 Monitor Utility The Monitor utility displays various classes of information that show device I O rates file system cache statistics and FCP statistics The FCP class shows the window turn rate for the system The window turn rate is not broken down by device but a high window turn rate may indicate fragmentation Use information from the VPA or DECps software to reinforce this indication In addition use the Monitor utility to see statistics about the file system caches on your system For more information see the VMS Monitor Utility Manual 1 12 Overview of the Disk File Optimizer Overview of the Disk File Optimizer 1 4 Determining File Fragmentation 1 4 4 Performance Products DECps is a follow on to the VPA product Either product can help you analyze the performance of your system Using the DECps command ADVISE PERFORMANCE REPORT or the VPA equivalent VPA ADVISE REPORT you can obtain information about disk split I O rates which can indicate disk fragmentation You can use the USE HOTFILES DATABASE qualifier on the DEFRAGMENT FILE or DEFRAGMENT VOLUME command to direct the defragmentation process to query the appropriate database VPA or DECps for a list of hotfiles frequently accessed
375. ters Note that this example uses the DEFRAGMENT VOLUME command from within the Disk File Optimizer utility Using Defrag PLUS 4 75 DEFRAGMENT VOLUME 5 DEFRAGMENT VOLUME DISKSONE SCRIPT AFTER_SCRIPT AFTER 00 05 This command creates the script AFTER_SCRIPT and it will start executing in 5 minutes 4 76 Using Defrag PLUS 9 The DECwindows Interface for Defrag 5 1 Introduction In addition to the DCL command line interface the Disk File Optimizer DFO software indudes a DECwindows interface The DECwindows interface gives you a visual reference when performing tasks with the Disk File Optimizer software The Disk File Optimizer DECwindows interface allows you to initiate control and stop defragmentation operations To start the DE Cwindows interface enter this command DEFRAGMENT INTERFACE DECWINDOWS The Disk File Optimizer initial window appears Figure 5 1 shows the initial window Figure 5 1 Initial Window File Optimize Monitor Report Welcome to Disk File Optimizer Please make a menu selection to continue The interface allows you to perform the following actions e File exit the DE Cwindows interface e Optimize optimize a volume selected files or a disks volume index file e Monitor monitor the defragmentation process by selecting a volume to monitor e Report review the current state of a volume to determine if defragmentation is needed The DECwindows Interf
376. that a user enters filespeq In command formats a horizontal ellipsis indicates that the preceding items can be repeated one or more times References to Compaq Products The following Compaq products are mentioned in this manual xii Product Formal Product Name Disk File Optimizer Defrag Defrag PLUS VPA DECps OpenVMS DECwindows Disk File Optimizer refers to the Disk File Optimizer software Defrag refers to a variation of the Disk File Optimizer software that provides basic file and volume defragmentation capabilities Defrag PLUS refers to the variation of the Disk File Optimizer software that supports all of the features of Defrag plus scheduling and command storing capabilities VPA refers to the VAX Performance Advisor software DECps refers to the DEC Performance Solution software OpenVMS refers to the OpenVMS VAX and OpenVMS Alpha operating systems Software interface for video displays xiii 1 Overview of the Disk File Optimizer 1 1 Introduction This chapter introduces the Disk File Optimizer DFO software It contains the following major sections A brief introduction to the Disk File Optimizer software including a description of the two variants and the available interfaces e A discussion of basic file system concepts and file fragmentation e A brief description of suggested methods for determining file and volume fragmentation 1 2 Product Description
377. the database Some portion of command validation failed The exact nature of the error is provided in associated messages User Action Refer to associated messages to determine a course of action VOLSETERR device is a member of a volume set specify the volume set name Explanation The user attempted to defragment a member of a volume set Attempting to defragment members of a volume set is not supported User Action Defragment the entire volume set by specifying the volume set name on the DEFRAGMENT command line VOLUMELOCKERR volume lock error for device AD Explanation Error trying to allocation lock the volume This error may only occur in the defragmentation process code This prevents file structure changes for a short time while the defragmentation process reads a fresh copy of BITMAP SYS User Action Refer to associated messages to determine a course of action VOLUMENOTDONE volume command unsuccessful Explanation A VOLUME subcommand was unsuccessful This is a summary message This message may or may not indicate an error Associated messages provide more detail User Action Refer to associated messages to determine a course of action Defragmentation Messages Defragmentation Messages F 2 Disk File Optimizer Messages VOLUNLOCKERR volume unlock error for device AD Explanation The target device could not be allocation unlocked by the defragmentation process User Action Refer to associated messages to d
378. the node DEFRAGMENT VOLUME 1 DKA100 NODE LUNTIC SCRIPT DEFRAG 1 DKA100 In the above example the scheduler starts the defragmentation process on node LUNTIC 2 4 Getting Started Getting Started 2 6 Creating Scheduling Scripts 2 6 Creating Scheduling Scripts To schedule defragmentation jobs you have to create scheduling scripts for Defrag PLUS or command procedures for Defrag By creating scheduling scripts or command procedures you define which volumes to defragment and how often to defragment them The following examples deal with creating scheduling scripts for Defrag PLUS You can still use the same commands to create command procedures for Defrag 2 6 1 Gathering Initial Information Before creating your scheduling scripts you may want to record the following information The fragmentation index for each volume Use the following command for each volume DEFRAGMENT SHOW volume name VOLUME Appendix C describes how to read the report You can use this information as a starting point to monitor how often you may want to defragment a particular volume e Which volumes you want to defragment on which nodes 2 6 2 Creating Scheduling Scripts for Defrag PLUS This section gives you examples of how to create scheduling scripts Chapter 4 contains a complete description of each command The following shows the command to create a script for a locally mounted volume that is defragmented every night at 21 00
379. tification when defragmentation processes complete DFG MESSAGE All Equates to SYS MESSAGE DFG MESSAGE EXE which is the shareable image containing all the defragmentation specific messages This logical is used only if you install the callable interface DFG SCRIPT All Provided to the EPILOGUE and PROLOGUE command files It translates to the name of the script associated with the DFO process continued on next page B 2 Disk File Optimizer Logicals and Files Table B 1 Cont Logical Names Disk File Optimizer Logicals and Files B 2 Logical Names Logical Installation Name Variant Purpose DFG STATE All Provided to the EPILOGUE and PROLOGUE command files As appropriate to indicate the state of DFO to the command procedure it translates to either of these strings PROLOGUE EPILOGUE DFG STATUS All Provided to the EPILOGUE and PROLOGUE command files It translates to the current status of the DFO process For the EPILOGUE command file this status is the final status of the DFO process DFG ASTLM All These logicals affect the associated process quota of any DFG BIOLM DFO process running on the associated node DFG BYTLM DEG DIOLM Refer to Section 4 3 5 for more information DFG ENQLM DFG FILLM DFG J TQUOTA DFG PGFLQUOTA DFG PRCLM DFG TQELM DF G WSDEFAULT DF G WSEXTENT DFG WSQUOTA DFG TRANSFERSIZE All The logical DFG TRANSFERSIZE helps you tune the Disk File Optimizer The definition of this lo
380. to 3 42 ABORT 3 9 ATTACH 3 11 EXIT 3 13 FILE 3 14 HELP 3 21 MONITOR 3 22 OFFLINE_VOLUME 3 27 SHOW 3 31 SPAWN 3 34 VOLUME 3 36 Defragmentation accessing files during 1 1 4 2 advantages of 1 13 INDEXF SYS 5 14 process 1 7 scheduling 4 11 volume index file 5 14 when device is unavailable 4 3 Defragmentation jobs creating scheduling scripts 2 5 6 5 Defrag PLUS command set 3 7 4 12 Defrag PLUS commands 4 13 to 4 76 ABORT 4 14 ATTACH 4 16 CANCEL 4 18 DISABLE 4 19 ENABLE 4 20 EXIT 4 21 FILE 4 22 HELP 4 32 MODIFY 4 33 MONITOR 4 42 OFFLINE_VOLUME 4 48 REMOVE 4 54 SET 4 56 SHOW 4 58 Index 2 Defrag PLUS commands cont d SPAWN 4 63 START 4 65 VOLUME 4 66 DELERR F 9 DFG DEFRAGMENT routine 7 3 compiling programs with 7 1 description 7 3 DFG K ABORT item descriptor 7 14 DFG K AFTER item descriptor 7 15 DFG K CANCEL item descriptor 7 15 DFG K CLASSIFY DORM item descriptor 7 6 DFG K CLASSIFY FREQ item descriptor 7 7 DFG K DFG FLAGS item descriptor 7 8 DFG K DISABLE item descriptor 7 16 DFG K ENABLE item descriptor 7 17 DFG K EXCLUDE item descriptor 7 10 DFG K FILE item descriptor 7 11 DFG K INHERIT item descriptor 7 17 DFG K INTERVAL item descriptor 7 19 DFG K LOG item descriptor 7 11 DFG K MODIFY item descriptor 7 19 DFG K NODE item descriptor 7 21 DFG K OFFLINE item descriptor 7 12 DFG K OPTIONS item descriptor 7 12 DFG K POST PROCESS item descriptor 7
381. ts Darkest gray allocated space Lightest gray free space and medium gray mix of allocated and free space e Blocks grid End LBN of Window and Free Block are again self explanatory e The colored boxes that follow serve as the key to understanding the volume map The colors green cyan blue magenta and red represent directories indexed files placed files nomove files and open files respectively e Click on a directory green or an open file red for the Volume Map File Information dialog see Figure 6 17 It has details concerning the selected entity with respect to its volume e Click on OK to dose that dialog Note Click on Apply in the Graphic Full volume Map dialog to find out if the selected volume is being defragmented currently 6 38 The DECwindows Interface for Defrag Plus 6 6 2 Text Format The DECwindows Interface for Defrag Plus 6 6 Report on the State of a Volume Use the following procedure for a text display of the selected volume s 1 Click on the Text suboption of the Report Volume Fragmentation menu See Figure 6 21 for the Report Select Volume dialog Use the following procedure to show volume information 1 2 Select the Report pull down menu See Figure 6 21 Click on the Volume fragmentation option of the Report pull down menu for the report type list Graph Text report Click on Text to select it You will see the Report Select Volume dialog See Figu
382. ts in the entire system Using Defrag PLUS 4 15 DEFRAGMENT ATTACH DEFRAGMENT ATTACH Format Parameters Description Restrictions Qualifiers The ATTACH subcommand transfers control from the current process which then hibernates to the specified process DEFRAGMENT ATTACH process name IDENTIFICATION pid process name The process name specifies the name of a process to which control transfers The process must already exist be part of your current job and share the same input stream as your current process However the process cannot be your current process or a subprocess created with the NOWAIT qualifier Process names can contain from 1 to 15 alphanumeric characters If a connection to the specified process cannot be made an error message is displayed The ATTACH command allows you to connect your input stream to another process You may use the ATTACH command to change control from one subprocess to another subprocess or to the parent process When you enter the ATTACH command the parent or source process is put into hibernation and your input stream is connected to the specified destination process You may use the ATTACH command to connect to a subprocess that is part of a current job left hibernating as a result of the DCL SPAWN WAIT command or another ATTACH command as long as the connection is valid No connection can be made to the current process to a process that is not part of the curren
383. u can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP selects all TMP files on the entire volume continued on next page 5 10 The DECwindows Interface for Defrag The DECwindows Interface for Defrag 5 3 Optimize Menu Table 5 3 Cont Restrict File of Dialog Box Fields Field Description Frequent Files The Frequent Files option indicates files to be considered frequently accessed when final file placement decisions are made You may enter the file name or use the file list button to bring up a list of files to chose from 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 The amount of free space on the volume the number of files currently being accessed and other factors influence file placement The Disk File Optimizer does not guarantee file placement but makes every effort to place files as described The file spec field allows wildcard characters You can specify wildcard characters in place of the directory name file name file type or file version number field The default file spec for all wildcard operations is DISK 000000 Specifying TMP select
384. ualifier and the user has specified CONTINUOUS User Action Remove the CONTINUOUS qualifier or specify NOINTERVAL on the command line INHERINTPRED invalid qualifier combination remove PREDECESSOR or specify NOINTERVAL Explanation This error occurs when inheriting a script that contains the INTERVAL qualifier and the user has specified PREDECESSOR User Action Remove the PREDECESSOR qualifier or specify NOINTERVAL on the command line INHERPRED invalid qualifier combination remove INTERVAL or specify NOPREDECESSOR Explanation This error occurs when inheriting a script that contains the PREDECESSOR qualifier and the user has specified NTERVAL User Action Remove the INTERVAL qualifier or specify NOPREDECESSOR on the command line INTCONT invalid qualifier combination remove INTERVAL or CONTINUOUS Explanation This error occurs when INTERVAL and CONTINUOUS are both spcified User Action Remove one of them INTERNALERR internal software error number UL Explanation This is an internal error encountered in the defragmentation process code User Action Submit an SPR Indude the software error number INTERR2 internal error AD XL Explanation This is an internal error User Action Submit an SPR Include the error number and the associated string supplied in the error message INTERR internal error AD Explanation This is an internal error User Action Submit an SPR Indude the inter
385. ult 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 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 LEVEL n LEVEL 2 default The defragmentation process selects files for defragmentation from among those not excluded based on the LEVEL qualifier 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 e LEVEL 1 Any file that is not 100 percent contiguous or that can be selected using levels two and three is a candidate for defragmentation e LEVEL 2 default Using Defrag PLUS 4 37 DEFRAGMENT MODIFY Any file whose extents cannot be completely mapped by the mapping window or that can be selected using level three is a candidate for defragmentation The default window value is seven and can be
386. value to the associated PQL_Mxxx minimum value but this is not recommended The right way to change these logicals is to edit the file SYS STARTUP DFG STARTUP COM An example of changing the page file quota is shown below To use these logicals increase the associated value uncomment the desired line and execute this file CALL DEFINE LOGICAL DFGSASTL 100 CALL DEFINE LOGICAL DFGSBIOL 18 CALL DEFINE LOGICAL DFGSBYTL 61440 CALL DEFINE LOGICAL DFGSDIOL 18 CALL DEFINE LOGICAL DFGSENQL 500 CALL DEFINE LOGICAL DFGSFILL 50 CALL DEFINE LOGICAL DFGSJTQUOTA uses system default CALL DEFINE LOGICAL DFGSPGFLQUOTA 20000 CALL DEFINE LOGICAL DFGSPRCL 8 CALL DEFINE LOGICAL DFGSTQEL 10 CALL DEFINE LOGICAL DFGSWSDEFAULT 512 CALL DEFINE LOGICAL DFGSWSEXTENT 6000 CALL DEFINE LOGICAL DFGSWSQUOTA 2048 3 2 6 4 Defining the Transfer Size Logical The logical DFG TRANSFERSIZE helps you tune the Disk File Optimizer The definition of this logical allows you to change the amount of data that is transferred at one time On a volume that has files with large extents you could wait up to 20 minutes while the system transfers these large extents before you could access the file By defining this logical you could access this file in less than a minute This logical changes the impact that the Disk File Optimizer has on applications that are simultaneously accessing
387. vates disabled scripts including any successor predecessor dependencies within a linked list of scripts Restrictions The script name parameter is not allowed if the ALL qualifier is used Qualifiers ALL NOALL default The ALL qualifier enables all disabled scripts in the scheduling and parameter database Examples The following are examples of the ENABLE command 1 DEFRAGMENT ENABLE ALL In this example all previously deactivated scripts are enabled The enabled script executes according to its previously set schedule Enabled predecessor or successor scripts resume executing according to their link dependencies 2 DEFRAGMENT ENABLE MY SCRIPT In this example MY SCRIPT is enabled MY SCRIPT starts executing according to the parameters and qualifiers assigned to it 4 20 Using Defrag PLUS DEFRAGMENT EXIT DEFRAGMENT EXIT The EXIT subcommand exits from the Disk File Optimizer utility and returns the user to the system prompt Format DEFRAGMENT EXIT Parameters None Description The EXIT subcommand exits the user from the Disk File Optimizer utility EXIT shuts everything down in an orderly sequence Restrictions None Qualifiers None Examples The following ia an example of the EXIT command 1 DFO EXIT This command exits from the Disk File Optimizer utility and returns the user to the DCL prompt Using Defrag PLUS 4 21 DEFRAGMENT FILE DEFRAGMENT FILE Forma
388. very 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 LOG file spec NOLOG default The LOG qualifier causes the defragmentation process to create a file containing a list of all its operations 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 NODEz 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 OPCOM NOTIFICATION default NOOPCOM NOTIFICATION The OPCOM NOTIFICATION qualifier requests that brief status and termination messages regarding defragmentation processes be sent to OPCOM PROLOGUE file name NOPROLOGUE default The PROLOGUE qualifier identifies a DCL command file which DFO executes just before the Defragment operation starts Refer to Appendix B for logicals that are available to these command procedures Using Defrag PLUS 4 51 DEFRAGMENT OFFLINE_VOLUME SCRIPT script name NOSCR
389. vide information about unique events that occur during processing They do not indicate errors in processing Warning These messages indicate that some but not all of your request is error free You should verify the command or program output Error Error messages indicate that the output or program result is incorrect but the system may attempt to continue execution F atal F atal messages indicate that the system cannot continue execution F 1 1 Linked Messages Frequently more than one message occurs at a time A series of messages can help you determine the location of an error Linked messages usually display the return status of the different facilities called and provide a detailed explanation of the error Defragmentation Messages F 1 Defragmentation Messages F 1 General Message Information F 1 2 Recovery Procedures Error messages generally occur for the following reasons e A command is entered incorrectly or contains a spelling or syntax error or an incorrect file specification e A required resource is currently unavailable e A programming error is detected during the execution of an image e A system software or hardware problem exists F 1 3 Recovering from Command Entry Errors When an error occurs following interactive command entry you must reenter the command Messages from the command interpreter are usually followed by a display of the portion of the command line that is rejected Correct this
390. xcept those supplied with other item descriptors in this item list return length address Not used must be zero DFG K NODE When an item list contains the DFG K NODE item descriptor the command is limited to those nodes associated with DF G K _ NODE If the DFG K_NODE item descriptor is not present the command applies to all nodes accessible from the local system Figure 7 2 illustrates how to construct a DFG K_NODE item descriptor If DFG K SET XXX or DFG K SHOW XXX are present DFG K NODE can not be the first item descriptor in the item list The uses of the buffer length buffer address and return length address fields for the DFG K NODE item code are as follows e buffer length L ength in bytes of a list of string descriptors pointed to by the buffer address e buffer address Address of a list of string descriptors that describe the node name strings The script or set show data is limited to these nodes return length address Not used must be zero DFG K PREDECESSOR The DFG K PREDECESSOR item code specifies the script to precede this one in a linked execution Using the DFG K PREDECESSOR item code scripts can be chained together to execute sequentially The predecessor script name must exist in the defragment database or DF G DEFRAGMENT returns an appropriate error status Further any attempt to name a continuously executing script as a predecessor results in an error Linked scripts execute sequ
391. ying Scheduling Scripts for DEFRAG Plus 5 Creating Scheduling Scripts for Defrag 0 00000 Checking for the Right Script Interval 2 0 cee ees Modifying Scheduling Scripts llis Example Scheduling Scripts for a VMScluster 000 cee sss Creating Scheduling Scripts for a Standalone System 05 System Administrator s Guide 3 Using Defrag 3 1 3 2 32 3 2 2 Introducion Defrag Capabilities Interface Online Help Speed and Effectiveness of Defragmentation Operations Scheduling Defragmentation Operations 0 0 cee eens Scheduling Guidelines 0 0 00 eee Using DECschedu ler dessei eid x erates Gee ee doge Using Hot files Information lleeeee ese Defining Quotas for the Defragmentation Process Hard coded values SYSGEN Process QUOTAS Les DFO Logical Process Quotas 00 cece eee eee Defining the Transfer Size Logical 000 eee Wildcard Character Use Examples Using Defrag Creating Log Files Showing the State of a Defrag Command Set The Defrag Commands DEFRAGMENT ABORT DEFRAGMENT ATTACH DEFRAGMENT EXIT DEFRAGMENT FILE DEFRAGMENT HELP o ce arena N DEFRAGMENT MONITOR 0 cece ee ee n DEFRAGMENT OFFLINE VOLUME 0 cece eee eee DEFRAGMENT SHOW DEFRAGMENT SPAWN DEFRAGMENT VOLUME f

Disk File Optimizer for OpenVMS Guide to Operations

Contents

Download Pdf Manuals

Related Search

Related Contents