Guardian User’s Guide Abstract This guide provides basic information about the programs and utilities that are used most often in the Guardian environment by general system or application users. It also provides more detailed procedures for system operations, management, and maintenance tasks useful to both beginning and experienced Compaq NonStop™ Kernel operating system users. Product Version N.A. Supported Releases This manual supports G06.05 and all subsequent G-series releases, and D48.00 and all subsequent D-series releases, until otherwise indicated in a new edition. Part Number Published 425266-001 August 2000 Document History Part Number Product Version Published 425266-001 N.A. August 2000 421957-001 N.A. June 1999 142477 N.A. December 1998 117897 N.A. July 1995 089808 N.A. January 1993 Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact your local sales representative. Document Disclaimer Information contained in a manual is subject to change without notice. Please check with your authorized representative to make sure you have the most recent information. Export Statement Export of the information contained in this manual may require authorization from the U.S. Department of Commerce. Examples Examples and sample programs are for illustration only and may not be suited for your particular purpose. The inclusion of examples and sample programs in the documentation does not warrant, guarantee, or make any representations regarding the use or the results of the use of any examples or sample programs in any documentation. You should verify the applicability of any example or sample program before placing the software into productive use. U.S. Government Customers FOR U.S. GOVERNMENT CUSTOMERS REGARDING THIS DOCUMENTATION AND THE ASSOCIATED SOFTWARE: These notices shall be marked on any reproduction of this data, in whole or in part. NOTICE: Notwithstanding any other lease or license that may pertain to, or accompany the delivery of, this computer software, the rights of the Government regarding its use, reproduction and disclosure are as set forth in Section 52.227-19 of the FARS Computer Software—Restricted Rights clause. RESTRICTED RIGHTS NOTICE: Use, duplication, or disclosure by the Government is subject to the restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013. RESTRICTED RIGHTS LEGEND: Use, duplication or disclosure by the Government is subject to restrictions as set forth in paragraph (b)(3)(B) of the rights in Technical Data and Computer Software clause in DAR 7-104.9(a). This computer software is submitted with “restricted rights.” Use, duplication or disclosure is subject to the restrictions as set forth in NASA FAR SUP 18-52 227-79 (April 1985) “Commercial Computer Software—Restricted Rights (April 1985).” If the contract contains the Clause at 18-52 227-74 “Rights in Data General” then the “Alternate III” clause applies. U.S. Government Users Restricted Rights — Use, duplication or disclosure restricted by GSA ADP Schedule Contract. Unpublished — All rights reserved under the Copyright Laws of the United States. Guardian User’s Guide Glossary Index Figures Tables What’s New in This Guide xvii Manual Information xvii New and Changed Information xvii About This Guide xix What’s in This Guide? xix Who Should Use This Guide? xx Where Else Can You Find Information? xxi Your Comments Invited xxi 1. Introduction to Guardian System Operations Common Guardian Operations Tasks 1-2 Working With a Daily Check List 1-3 Your System Might Be Protected 1-3 Automating Routine Monitoring Tasks 1-4 Example Check List 1-4 Part I. Using the Compaq Tandem Advanced Command Language (TACL) 2. Getting Started With TACL Using TACL as a Command Interpreter 2-2 Entering TACL Commands 2-2 Logging On With TACL 2-3 Blind Password Logon 2-4 Full Logon 2-4 Logon Mistakes 2-4 A Successful Logon 2-5 Compaq Computer Corporation—425266-001 i Contents 2. Getting Started With TACL (continued) 2. Getting Started With TACL (continued) Logging Off With TACL 2-6 Accessing Other Systems 2-6 Establishing Remote Passwords 2-7 Starting and Quitting a Remote TACL Process 2-7 Changing Your Password 2-8 Logging On With Safeguard 2-9 The Safeguard Logon Prompt 2-9 The TIME Command 2-9 The Safeguard LOGON Command 2-9 Blind Password Logon 2-10 Changing an Unexpired Password 2-10 Changing an Expired Password 2-11 Logging On to a Remote System 2-11 Getting TACL Help 2-12 Displaying User Information 2-13 Displaying Your Information 2-13 Displaying Information About Other Users 2-14 Using Your Command History 2-15 Listing Your Previous Commands 2-15 Redisplaying a Selected Previous Command 2-16 Reexecuting a Previous Command 2-16 Changing or Correcting a Previous Command 2-17 3. Managing Files With TACL Introduction to Files in Guardian 3-2 Types of Disk Files 3-2 Disk File Names 3-3 Listing Files and Their Information 3-5 Listing Subvolume Contents (FILES Command) 3-5 Searching For Files With Related Names (FILENAMES Command) 3-6 Getting File Information (FILEINFO Command) 3-6 Renaming Files 3-8 Guardian User’s Guide—425266-001 ii Contents 3. Managing Files With TACL (continued) 3. Managing Files With TACL (continued) Deleting Files 3-8 Purging Files Using Individual File Names 3-8 Purging Files Using File-Name Templates 3-9 Changing Your Default Values 3-10 File-Name Expansion 3-10 Changing Your Current Default System, Volume, or Subvolume (VOLUME Command) 3-10 Changing Your Current Default Node (SYSTEM Command) 3-11 Changing Your TACL Prompt (SETPROMPT Command) 3-12 Changing Your Saved Defaults (DEFAULT Program) 3-13 4. Starting and Controlling Processes With TACL Getting Information About Processes 4-2 Displaying Process Information (STATUS Command) 4-2 Displaying Named Process Information (PPD Command) 4-3 Starting and Controlling a Process 4-5 Running a Process at a High PIN 4-6 Your Default Process 4-6 Interrupting a Process 4-6 Pausing a Process 4-7 Stopping a Process 4-7 Using a Command (OBEY) File 4-8 Restarting a TACL Process 4-9 Running Compaq NonStop™ Kernel Utilities 4-10 Solving Common System Process Problems 4-11 5. Defining Function Keys and Writing Macros Defining and Using Your Function Keys 5-2 Creating a Library File for Your Function Keys 5-2 Loading Your Function Key Definitions 5-6 Displaying Your Function Key Definitions 5-6 Using Your Function Keys 5-6 Guardian User’s Guide—425266-001 iii Contents 5. Defining Function Keys and Writing Macros (continued) 5. Defining Function Keys and Writing Macros (continued) Writing TACL Macros 5-9 Using a Library File 5-9 Using a File Starting With a ?TACL Directive 5-11 Customizing Your TACL Environment 5-12 6. Creating and Using DEFINEs Using a DEFINE 6-2 DEFINE Names 6-2 DEFINE Templates 6-3 DEFINE Classes 6-3 Enabling and Disabling DEFINEs 6-6 DEFINE Attributes 6-7 Initial Attribute Settings 6-7 Working Attribute Set 6-8 Attribute Consistency Checks 6-8 TACL DEFINE Commands 6-9 Example of Creating and Using a DEFINE 6-9 Task 1: Ensure DEFINEs are Enabled 6-9 Task 2: Create the DEFINE 6-9 Task 3: Use the Created DEFINE 6-10 Part II. Managing Files Using the File Utility Program (FUP) 7. Using FUP for Basic File Management Who Uses FUP? 7-1 Entering FUP Commands 7-2 Entering FUP Commands Through TACL 7-2 Entering FUP Commands Interactively Through FUP 7-2 Entering FUP Commands From a Command File 7-3 Using DEFINEs in FUP Commands 7-5 Getting Help From FUP 7-7 Using the Break Key 7-7 Guardian User’s Guide—425266-001 iv Contents 7. Using FUP for Basic File Management (continued) 7. Using FUP for Basic File Management (continued) Changing System and Volume Defaults 7-8 Getting Information About Subvolumes and Files 7-9 Getting Information About Single Files 7-10 Getting Information About File Sets 7-11 Performing Common File Operations 7-13 Duplicating Files 7-13 Renaming Files 7-15 Changing File Security 7-16 Deleting Files 7-17 Using Your FUP Command History 7-21 Solving Common File Problems 7-22 8. Using FUP for Advanced File Management Creating Files 8-1 Creating Files Using DDL 8-4 Using the SET, SHOW, and CREATE Commands 8-4 Restoring Default File-Creation Parameters 8-5 File-Creation Examples 8-6 Maintaining Your Disk Files 8-15 Loading Data Into Files 8-15 Purging Data From Files 8-16 Renaming and Moving Files With Alternate Keys 8-16 Copying Files to a Backup Volume 8-17 Adding Alternate Keys to Files 8-18 Modifying Partitioned Files 8-19 Reorganizing Key-Sequenced Files 8-22 Part III. Managing Disk and Tape Processes 9. Performing Routine Disk Operations Using the Subsystem Control Facility (SCF) 9-1 Checking Disk Status 9-5 Guardian User’s Guide—425266-001 v Contents 9. Performing Routine Disk Operations (continued) 9. Performing Routine Disk Operations (continued) Bringing Up a Disk or Path 9-6 Bringing Up a Disk From STOPPED 9-6 Bringing Up a Path From STOPPED 9-6 Bringing Up a Disk or Path From a STOPPED State, Substate HARDDOWN 9-6 Taking Down a Disk or Path 9-7 Taking Down a Disk 9-7 Taking Down a Path To a Mirrored Disk 9-8 Altering the Current Path to a Dual-Ported Disk 9-9 Removing Half of a Mirrored Disk 9-9 Bringing Up the Down Half of a Mirrored Disk 9-11 Finding and Sparing Bad Tracks and Sectors 9-12 Managing Disk Space Usage 9-14 Analyzing Disk Space Usage With the Subsystem Control Facility (SCF) 9-14 Analyzing Disk Space Usage With the Disk Space Analysis Program (DSAP) 9-15 Listing and Purging Old Disk Files 9-20 Monitoring and Altering Swap Files 9-23 How Kernel-Managed Swap Space Works 9-23 How Kernel-Managed Swap Files Affect You 9-24 Using NSKCOM to Monitor and Alter Swap Files 9-25 Solving Common Disk Problems 9-28 10.