Guardian User's Guide - NonStopTools

1 Guardian user s GuideAbstractThis 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 ReleasesThis manual supports and all subsequent G-series releases, and and all subsequent D-series releases, until otherwise indicated in a new edition. Part NumberPublished425266-001 August 2000 Ordering InformationFor manual ordering information: domestic customers, call 1-800-243-6886; international customers, contact your local sales DisclaimerInformation contained in a manual is subject to change without notice. Please check with your authorized representative to make sure you have the most recent StatementExport of the information contained in this manual may require authorization from the Department of and sample programs are for illustration only and may not be suited for your particular purpose.

2 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 Government CustomersFOR GOVERNMENT CUSTOMERS REGARDING THIS DOCUMENTATION AND THE ASSOCIATED SOFTWARE:These notices shall be marked on any reproduction of this data, in whole or in : 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 of the FARS Computer Software Restricted Rights 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 RIGHTS LEGEND.

3 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 (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 Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule All rights reserved under the Copyright Laws of the United History Part NumberProduct 1993 Compaq Computer Corporation 425266-001iGuardian user s GuideGlossaryIndexFiguresTa b l e sWhat s New in This GuidexviiManual InformationxviiNew and Changed InformationxviiAbout This GuidexixWhat s in This Guide ?

4 XixWho Should Use This Guide ?xxWhere Else Can You Find Information?xxiYour Comments Invitedxxi1. Introduction to Guardian System OperationsCommon Guardian Operations Tasks1-2 Working With a Daily Check List1-3 Your System Might Be Protected1-3 Automating Routine Monitoring Tasks1-4 Example Check List1-4 Part I. Using the Compaq Tandem Advanced Command Language (TACL)2. getting Started With TACLU sing TACL as a Command Interpreter2-2 Entering TACL Commands2-2 Logging On With TACL2-3 Blind Password Logon2-4 Full Logon2-4 Logon Mistakes2-4A Successful Logon2-5 ContentsGuardian user s Guide 425266-001ii2. getting Started With TACL (continued)2. getting Started With TACL(continued)Logging Off With TACL2-6 Accessing Other Systems2-6 Establishing Remote Passwords2-7 Starting and Quitting a Remote TACL Process2-7 Changing Your Password2-8 Logging On With Safeguard2-9 The Safeguard Logon Prompt2-9 The TIME Command2-9 The Safeguard LOGON Command2-9 Blind Password Logon2-10 Changing an Unexpired Password2-10 Changing an Expired Password2-11 Logging On to a Remote System2-11 getting TACL Help2-12 Displaying user Information2-13 Displaying Your Information2-13 Displaying Information About Other Users2-14 Using Your Command History2-15 Listing Your Previous Commands2-15 Redisplaying a Selected Previous Command2-16 Reexecuting a Previous Command2-16 Changing or Correcting a Previous Command2-173.

5 Managing Files With TACLI ntroduction to Files in Guardian3-2 Types of Disk Files3-2 Disk File Names3-3 Listing Files and Their Information3-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 Files3-8 ContentsGuardian user s Guide 425266-001iii3. Managing Files With TACL (continued)3. Managing Files With TACL(continued)Deleting Files3-8 Purging Files Using Individual File Names3-8 Purging Files Using File-Name Templates3-9 Changing Your Default Values3-10 File-Name Expansion3-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-134. Starting and Controlling Processes With TACLG etting Information About Processes4-2 Displaying Process Information (STATUS Command)4-2 Displaying Named Process Information (PPD Command)4-3 Starting and Controlling a Process4-5 Running a Process at a High PIN4-6 Your Default Process4-6 Interrupting a Process4-6 Pausing a Process4-7 Stopping a Process4-7 Using a Command (OBEY) File4-8 Restarting a TACL Process4-9 Running Compaq NonStop Kernel Utilities4-10 Solving Common System Process Problems4-115.

6 Defining Function Keys and Writing MacrosDefining and Using Your Function Keys5-2 Creating a Library File for Your Function Keys5-2 Loading Your Function Key Definitions5-6 Displaying Your Function Key Definitions5-6 Using Your Function Keys5-6 ContentsGuardian user s Guide 425266-001iv5. Defining Function Keys and WritingMacros (continued)5. Defining Function Keys and Writing Macros(continued)Writing TACL Macros5-9 Using a Library File5-9 Using a File Starting With a ?TACL Directive5-11 Customizing Your TACL Environment5-126. Creating and Using DEFINEsUsing a DEFINE6-2 DEFINE Names6-2 DEFINE Templates6-3 DEFINE Classes6-3 Enabling and Disabling DEFINEs6-6 DEFINE Attributes6-7 Initial Attribute Settings6-7 Working Attribute Set6-8 Attribute Consistency Checks6-8 TACL DEFINE Commands6-9 Example of Creating and Using a DEFINE6-9 Task 1: Ensure DEFINEs are Enabled6-9 Task 2: Create the DEFINE6-9 Task 3: Use the Created DEFINE6-10 Part II.

7 Managing Files Using the File Utility Program (FUP)7. Using FUP for Basic File ManagementWho Uses FUP?7-1 Entering FUP Commands7-2 Entering FUP Commands Through TACL7-2 Entering FUP Commands Interactively Through FUP7-2 Entering FUP Commands From a Command File7-3 Using DEFINEs in FUP Commands7-5 getting Help From FUP7-7 Using the Break Key7-7 ContentsGuardian user s Guide 425266-001v7. Using FUP for Basic FileManagement (continued)7. Using FUP for Basic File Management(continued)Changing System and Volume Defaults7-8 getting Information About Subvolumes and Files7-9 getting Information About Single Files 7-10 getting Information About File Sets7-11 Performing Common File Operations7-13 Duplicating Files7-13 Renaming Files7-15 Changing File Security7-16 Deleting Files7-17 Using Your FUP Command History7-21 Solving Common File Problems7-228. Using FUP for Advanced File ManagementCreating Files8-1 Creating Files Using DDL8-4 Using the SET, SHOW, and CREATE Commands8-4 Restoring Default File-Creation Parameters8-5 File-Creation Examples8-6 Maintaining Your Disk Files8-15 Loading Data Into Files8-15 Purging Data From Files8-16 Renaming and Moving Files With Alternate Keys8-16 Copying Files to a Backup Volume8-17 Adding Alternate Keys to Files8-18 Modifying Partitioned Files8-19 Reorganizing Key-Sequenced Files8-22 Part III.

8 Managing Disk and Tape Processes9. Performing Routine Disk OperationsUsing the Subsystem Control Facility (SCF)9-1 Checking Disk Status9-5 ContentsGuardian user s Guide 425266-001vi9. Performing Routine Disk Operations (continued)9. Performing Routine Disk Operations(continued)Bringing Up a Disk or Path9-6 Bringing Up a Disk From STOPPED9-6 Bringing Up a Path From STOPPED9-6 Bringing Up a Disk or Path From a STOPPED State, Substate HARDDOWN9-6 Taking Down a Disk or Path9-7 Taking Down a Disk9-7 Taking Down a Path To a Mirrored Disk9-8 Altering the Current Path to a Dual-Ported Disk9-9 Removing Half of a Mirrored Disk9-9 Bringing Up the Down Half of a Mirrored Disk9-11 Finding and Sparing Bad Tracks and Sectors9-12 Managing Disk Space Usage9-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 9-15 Listing and Purging Old Disk Files9-20 Monitoring and Altering Swap Files9-23 How Kernel-Managed Swap Space Works9-23 How Kernel-Managed Swap Files Affect You9-24 Using NSKCOM to Monitor and Alter Swap Files9-25 Solving Common Disk Problems9-2810. Using Labeled TapesHow Labeled-Tape Processing Works10-2 The MEDIACOM Interface10-2 Tape Processing Modes10-5 Using Labeled Tapes in LP Mode10-6 Using Unlabeled Tapes in NL Mode10-7 Bypassing Label Protection in BLP Mode10-8 TAPE DEFINE Attributes10-9 Common Labeled Tape Activities10-10 Checking the Status of Tape Drives10-10 Setting a Default Tape Drive10-12 Taking Down and Bringing Up a Tape Drive10-13 ContentsGuardian user s Guide 425266-001vii10. Using Labeled Tapes (continued)10. Using Labeled Tapes(continued)Handling Labeled Tape Messages and Requests10-14 Monitoring Labeled-Tape Messages10-14 Responding to Messages and Requests10-15 Creating and Modifying Labeled Tapes10-22 Labeling Tapes10-22 Displaying Tape Label Information10-24 Relabeling a Tape and Removing a Tape Label10-25 Setting Whether Tapes Are Unloaded After Labeling10-26 Premounting and Scratching Labeled Tapes10-28 Premounting Labeled Tapes10-28 Scratching a Labeled Tape10-29 Compressing a Tape Dump File10-30 Solving Common Tape Subsystem Problems10-3111.

10 Backing Up and Restoring Disk InformationWhy Use Backup and Restore?11-2 Supported Modes of Operation11-2 Backing Up Your Files11-3 Specifying a File-Set List for Backup11-4 Using a Qualified File-Set List11-5 Using Run Options in a Backup Command11-6 Restoring Your Files11-12 Using Run Options in a Restore Command11-13 Using Labeled Tapes With Backup and Restore11-19 Using a TAPE DEFINE With Backup11-20 Using a TAPE DEFINE With Restore11-22 Duplicating Backup Tapes With Backcopy11-23 Running Backcopy11-23 Backcopy Examples11-25 ContentsGuardian user s Guide 425266-001viii12. Introduction to the SpoolerPart IV. Using the Spooler and Its Utilities12. Introduction to the SpoolerWhy Use the Spooler?12-2 Spooler Components12-2 Spooler Jobs and Job Attributes12-4 Printer Attributes 12-6 Form Name12-6 Header Message12-6 State12-6 Selection Algorithm12-6 Routing Structure12-8 Broadcast and Nonbroadcast Groups12-8 Default Routing12-8 Implicit Route Creation12-9 Printing To the Spooler12-10 Sending Output to a Spooler Location12-10 Sending Output to a SPOOL DEFINE12-1113.