CONTENTS Title Page Copyright Page Preface 1 Overview of the POLYCENTER File Optimizer 1.1 Introduction 1.2 Product Description 1.2.1 Operational Goals 1.2.2 Features 1.2.3 User Interface 1.2.4 Programming Interface 1.2.5 Operational Overview 1.2.5.1 Defragmentation Process 1.2.5.2 Prologue and Epilogue Files 1.2.5.3 Operation Summary 1.2.6 Operational Context for Defrag PLUS 1.2.6.1 Scheduling Database and Database Interface 1.2.6.2 Scheduler 1.2.6.3 Defragmentation Process 1.3 Basic File and File System Concepts 1.3.1 File Header Information 1.3.2 Extent Mapping Windows 1.3.3 Cathedral Window 1.4 Discovering File Fragmentation 1.4.1 DEFRAGMENT SHOW {volume}/VOLUME Command 1.4.2 DUMP Utility 1.4.3 Monitor Utility 1.4.4 Performance Products 1.5 File Defragmentation and VMS Backup System Administrator's Guide 2 Installing POLYCENTER File Optimizer Software 2.1 Introduction 2.2 Preparing to Install the POLYCENTER File Optimizer Software 2.2.1 Installation Variants 2.2.2 Hardware and Software Requirements 2.2.3 Minimum System Parameter Values 2.2.4 Process Account Quotas 2.2.5 VAXcluster System Considerations 2.2.6 Shutting Down the Previous Version of POLYCENTER File Optimizer Software 2.2.7 Execute SYS$SYSTEM:SETFILENOMOVE.COM 2.2.8 Registering the POLYCENTER File Optimizer Software License 2.2.8.1 License and Kit Names 2.2.8.2 Registering Your POLYCENTER File Optimizer License 2.3 Installing the POLYCENTER File Optimizer Software 2.3.1 Before You Begin-Questions and Answers 2.3.2 Installation Procedure 2.3.3 Error Recovery 2.4 After Installing the POLYCENTER File Optimizer 2.4.1 Running the IVP Separately 2.4.2 Editing the Systemwide Command Files 2.4.3 Making the POLYCENTER File Optimizer Work on a VAXcluster System 2.4.4 Resolving Database Differences 2.4.5 Deleting Old Copies of the Database Files 2.4.6 Verifying Account Requirements 2.4.7 Reporting Problems 3 Using Defrag 3.1 Introduction 3.2 Defrag Capabilities 3.2.1 Interface 3.2.2 Online Help 3.2.3 Speed and Effectiveness of Defragmentation Operations 3.2.4 Scheduling Defragmentation Operations 3.2.4.1 Scheduling Guidelines 3.2.4.2 Using DECScheduler 3.2.5 Using Hotfiles Information 3.2.6 Setting Quotas for a Particular Defragmentation Process 3.2.6.1 Process Quota Logicals 3.2.6.2 Defining the Process Logicals 3.3 Examples Using Defrag 3.3.1 Creating Log Files 3.3.2 Showing the State of Your Disk 3.4 Defrag Command Set 3.4.1 The Defrag Commands DEFRAGMENT ABORT DEFRAGMENT ATTACH DEFRAGMENT EXIT DEFRAGMENT FILE DEFRAGMENT HELP DEFRAGMENT MONITOR DEFRAGMENT OFFLINE_VOLUME DEFRAGMENT SHOW DEFRAGMENT SPAWN DEFRAGMENT VOLUME 4 Using Defrag PLUS 4.1 Introduction 4.2 General Guidelines 4.2.1 Interface 4.2.2 Graphic User Interface 4.2.3 Online Help 4.2.4 Quickness and Effectiveness of Defragmentation 4.2.5 Cluster Management 4.3 Scripts 4.3.1 Creating and Using Scripts 4.3.2 Script Naming Conventions 4.3.3 Examples of Creating and Using Scripts 4.3.3.1 Creating Log Files 4.3.3.2 Analyzing Your Disk 4.3.3.3 Creating a Named, Periodic Script 4.3.3.4 Copying Scripts 4.3.3.5 Modifying Scripts 4.3.3.6 Linking Scripts 4.3.3.7 Saving Database Contents 4.3.3.8 Re-Creating the Database 4.3.4 Using Hotfiles Information 4.3.5 Setting Quotas for a Particular Defragmentation Process 4.3.5.1 Process Quota Logicals 4.3.5.2 Defining the Process Logicals 4.4 Scheduling Defragmentation Operations 4.5 Error Recovery Procedures 4.6 POLYCENTER File Optimizer Command Set 4.6.1 Defrag PLUS Commands DEFRAGMENT ABORT DEFRAGMENT ATTACH DEFRAGMENT CANCEL DEFRAGMENT DISABLE DEFRAGMENT ENABLE DEFRAGMENT EXIT DEFRAGMENT FILE DEFRAGMENT HELP DEFRAGMENT MODIFY DEFRAGMENT MONITOR DEFRAGMENT OFFLINE_VOLUME DEFRAGMENT REMOVE DEFRAGMENT SET DEFRAGMENT SHOW DEFRAGMENT SPAWN DEFRAGMENT START DEFRAGMENT VOLUME 5 The DECwindows Interface 5.1 Starting the DECwindows Interface 5.2 DECwindows Interface for Defrag PLUS 5.2.1 Script Actions Selection 5.2.2 Aborting a Script 5.2.2.1 Screen Layout 5.2.2.2 Procedure for Aborting a Script 5.2.3 Creating a Script 5.2.3.1 Screen Layout 5.2.3.2 Procedure for Creating a Script 5.2.4 Deleting a Script 5.2.4.1 Screen Layout 5.2.4.2 Procedure for Deleting a Script 5.2.5 Modifying a Script 5.2.5.1 Screen Layout 5.2.5.2 Procedure for Modifying a Script 5.2.6 Monitoring Allocated Space on a Disk Volume 5.2.6.1 Screen Layouts 5.2.6.2 Procedure for Monitoring Allocated Space 5.2.7 Scheduling a Script 5.2.7.1 The Screen Layout Screen 5.2.7.2 Procedure for Managing Script Schedules 5.2.8 Showing a Script 5.2.8.1 Screen Layout 5.2.8.2 Procedure for Showing Scripts 5.2.9 Showing the State of a Volume 5.2.9.1 Screen Layout 5.2.9.2 Procedure for Showing Volumes 5.2.9.3 Sample Outputs 5.2.10 Options Menu 5.2.11 Setting Parameters 5.2.11.1 Screen Layout 5.2.11.2 Procedure for Setting Parameters 5.2.11.3 Procedure for Removing Nodes 5.2.12 Showing Defrag Process Parameters 5.2.12.1 Screen Layout 5.2.12.2 Procedure for Showing Parameters 5.3 DECwindows Interface for the Defrag Variant 5.3.1 Aborting a Defragmentation Process 5.3.1.1 Screen Layout 5.3.1.2 Procedure for Aborting a Process 5.3.2 Starting the Defragger 5.3.2.1 Screen Layout 5.3.2.2 Procedure for Starting the Defragger 5.3.3 Monitoring Defragmentation on a Volume 5.3.3.1 Screen Layouts 5.3.3.2 Procedure for Monitoring Defragmentation 5.3.4 Showing the State of a Volume 5.3.4.1 Screen Layout 5.3.4.2 Procedure for Showing Volumes Programmer's Guide 6 Callable Interface 6.1 Introduction 6.2 Using the Callable Interface 6.2.1 Including Files for DFG$DEFRAGMENT and DFG$RELEASE_MEMORY 6.2.2 Linking Files with DFG$DEFRAGMENT and DFG$RELEASE_MEMORY 6.3 DFG$DEFRAGMENT Routine DFG$DEFRAGMENT 6.4 DFG$RELEASE_MEMORY Routine DFG$RELEASE_MEMORY A POLYCENTER File Optimizer Logicals and Files A.1 Files Added to System by the POLYCENTER File Optimizer A.2 Logical Names B Sample POLYCENTER File Optimizer Installation B.1 Sample Installation B.1.1 Sample Installation for Defrag PLUS C Brief Log File Example D Full Log File Example E Defragmentation Messages E.1 General Message Information E.1.1 Linked Messages E.1.2 Recovery Procedures E.1.3 Recovering from Command Entry Errors E.1.4 Reporting System Software or Hardware Errors E.2 POLYCENTER File Optimizer Messages EXAMPLES 1-1 Viewing Retrieval Pointers Using the Dump Utility B-1 Sample Installation for Defrag PLUS C-1 Brief Log File D-1 Full Log File FIGURES 1-1 Command Operation 1-2 File Fragmentation Example 1-3 Allocating Fragmented Files 3-1 Process Statistics Display 3-2 Process Activities Display 3-3 Free Space Display 3-4 Process Statistics Display with Message Display 4-1 Process Statistics Display 4-2 Process Activities Display 4-3 Free Space Display 4-4 Process Statistics Display with Message Display 5-1 Initialization Window 5-2 Settings Options 5-3 Defrag PLUS Variant File Options 5-4 Script Actions Pop-Up Menu 5-5 The Abort Dialog Box 5-6 Creating a File Script 5-7 The Create Script Dialog Box 5-8 The Volume List 5-9 Difference Between File and Volume Scripts 5-10 Script Creation Options 5-11 Schedule Definition 5-12 The Delete Script Dialog Box 5-13 The Modify Script Dialog Box 5-14 Defragmentation Process Statistics Window 5-15 Defragmentation Volume Map Window 5-16 Volume Map File Information 5-17 Schedule Script 5-18 The Show Script Dialog Box 5-19 The Show Volume Selection Dialog Box 5-20 Show Volume: Statistics 5-21 Show Volume: Histogram 5-22 Show Volume: Free List 5-23 The Set and Show Parameters Options 5-24 The Set Parameters Dialog Box 5-25 The Show Parameters Dialog Box 5-26 Defrag Variant File Options 5-27 The Abort Process Dialog Box 5-28 Creating a File Process 5-29 Defragment File Dialog Box 5-30 The Volume List 5-31 Defragmentation Process Statistics Window 5-32 Defragmentation Volume Map Window 5-33 Volume Map File Information 5-34 The Show Volume Selection Dialog Box 6-1 ITEM_LIST_3 Descriptor 6-2 Creating a DFG$K_XXXX Item with Descriptor List 6-3 Flags and Inherit Enable 6-4 Show Script Data Buffer 6-5 Function Item List Interface TABLES 1-1 Features 1-2 POLYCENTER File Optimizer Command Summary 2-1 Differences Between Installation Variants 2-2 Disk Space Requirements 2-3 Minimum System Parameter Values 2-4 Process Account Quotas for the Installing Account 2-5 How to Register Your POLYCENTER File Optimizer License 2-6 How to Install the POLYCENTER File Optimizer Software 2-7 Converting Database Files 3-1 Defrag Command Summary 4-1 Sample Time Interval 4-2 Defrag PLUS Command Summary 5-1 Script Creation Dialog Box Fields 5-2 Schedule Definition Dialog Box Fields 5-3 Defragmentation Process Statistics Window Description 5-4 Defragmentation Volume Map Window Description 5-5 Script Scheduling Actions 5-6 Show Volume Option and Field Descriptions 5-7 Set Parameters Dialog Box 5-8 Script Creation Dialog Box Fields 5-9 Defragmentation Process Activities Window Description 5-10 Defragmentation Volume Map Window Description 5-11 Show Volume Option and Field Descriptions 6-1 Arguments and Values for DFG$DEFRAGMENT A-1 Logical Names E-1 Severity Indicators