Page 1 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™...
Page 2: Document History
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.
Page 3: Table Of Contents
What’s in This Guide? Who Should Use This Guide? Where Else Can You Find Information? Your Comments Invited 1. Introduction to Guardian System Operations Common Guardian Operations Tasks Working With a Daily Check List Your System Might Be Protected Automating Routine Monitoring Tasks Example Check List Part I.
Page 4 Reexecuting a Previous Command 2-16 Changing or Correcting a Previous Command 2-17 3. Managing Files With TACL Introduction to Files in Guardian Types of Disk Files Disk File Names Listing Files and Their Information Listing Subvolume Contents (FILES Command) Searching For Files With Related Names (FILENAMES Command)
Page 5 4-11 5. Defining Function Keys and Writing Macros Defining and Using Your Function Keys Creating a Library File for Your Function Keys Loading Your Function Key Definitions Displaying Your Function Key Definitions Using Your Function Keys Guardian User’s Guide —425266-001...
Page 6 Who Uses FUP? Entering FUP Commands Entering FUP Commands Through TACL Entering FUP Commands Interactively Through FUP Entering FUP Commands From a Command File Using DEFINEs in FUP Commands Getting Help From FUP Using the Break Key Guardian User’s Guide —425266-001...
Page 7 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) Checking Disk Status Guardian User’s Guide —425266-001...
Page 8 Bypassing Label Protection in BLP Mode 10-8 TAPE DEFINE Attributes 10-9 Common Labeled Tape Activities 10-10 Checking the Status of Tape Drives 10-10 Setting a Default Tape Drive 10-12 Taking Down and Bringing Up a Tape Drive 10-13 Guardian User’s Guide —425266-001...
Page 9 Using Run Options in a Restore Command 11-13 Using Labeled Tapes With Backup and Restore 11-19 Using a TAPE DEFINE With Backup 11-20 Using a TAPE DEFINE With Restore 11-22 Duplicating Backup Tapes With Backcopy 11-23 Running Backcopy 11-23 Backcopy Examples 11-25 Guardian User’s Guide —425266-001...
Page 10 Using Peruse With TFORM 13-7 Generating Your Spooler Job 13-7 Finding a Key Phrase in Your Spooler Job 13-7 Altering Job Attributes 13-8 Printing Part of a Job 13-8 Using Peruse With TAL 13-9 Compiling Your Job 13-9 Guardian User’s Guide —425266-001 viii...
Page 11 How Does Draining Work? 14-11 Starting a Drained Spooler 14-12 Warmstarting a Drained Spooler 14-12 Coldstarting a Drained Spooler 14-13 Guidelines 14-16 Stopping the Spooler 14-17 Controlling Print Devices 14-19 Controlling Jobs 14-20 Job States 14-23 Controlling Locations 14-24 Guardian User’s Guide —425266-001...
Page 12 15-12 Modifying Print Device Attributes 15-13 Deleting a Print Device 15-14 Deleting a Device From a Running Spooler 15-14 Print Device Attributes 15-15 Managing Locations 15-17 Adding a Location and Connecting It to a Device 15-17 Guardian User’s Guide —425266-001...
Page 13 15-17 Modifying Location Attributes 15-18 Deleting a Location 15-19 Rebuilding the Spooler Control Files 15-19 Part V. Security Features and Other Guardian Utilities 16. Managing Users and Security Your Responsibility to System Users 16-2 Keeping Current 16-2 Monitoring the System Frequently...
Page 14 Error Examples 17-6 Displaying Operator Messages With a Printing Distributor 17-7 Starting a Printing Distributor 17-7 Stopping a Printing Distributor 17-7 Interpreting Operator Messages 17-8 Directing Messages to a Disk File 17-10 Printing Operator Messages 17-11 Guardian User’s Guide —425266-001...
Page 15 Checking the Status of Systems in a Network 19-15 Checking ServerNet LAN Subsystem Status 19-16 Checking ATP6100 Line Status 19-19 Checking Line Handler Status 19-20 Checking NonStop™ TM/MP Status 19-21 Checking the Status of Pathway 19-25 Guardian User’s Guide —425266-001 xiii...
Page 16 Sample Header Page 12-7 Figure 12-4. Spooler Routing Structure 12-9 Figure 16-1. Passing of Access IDs 16-16 Figure 16-2. Effect of Adopting the Owner ID of a Program File 16-17 Figure 16-3. Employee Record Format 16-17 Guardian User’s Guide —425266-001...
Page 17 Table 14-4. Spoolcom Commands for Displaying Spooler Component Status 14-8 Table 14-5. Collector Process States 14-10 Table 14-6. Print Process States 14-10 Table 14-7. Common Printer and Spooler Problems 14-36 Table 15-1. Spooler Naming Conventions 15-2 Guardian User’s Guide —425266-001...
Page 18 Common Terminal and Workstation Problems 16-32 Table 17-1. Distributor Processes and Message Destinations 17-4 Table 19-1. Tools to Use for System Monitoring 19-2 Table 19-2. SCF Object States 19-6 Table 19-3. TMF States 19-22 Table A-1. Problem Solving Worksheet Guardian User’s Guide —425266-001...
Page 19: Manual Information
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.
Page 20 What’s New in This Guide New and Changed Information The G06.05 edition of this guide (previously known as the Guardian 90 Operating System User’s Guide) contained these changes: Information was added from the former Guardian System Operations Guide, adding several new sections to this guide and expanding on existing sections.
Page 21: About This Guide
About This Guide This guide provides introductory information and task-oriented instructions for using the Compaq Tandem Advanced Command Language (TACL) and various Guardian environment utilities. The utilities and procedures described in this guide include many of the more common operations tasks that users will need to perform on a system running the Compaq NonStop™...
Page 22: Who Should Use This Guide
Who Should Use This Guide? This guide provides introductory information for beginning users of NonStop™ Kernel systems, and detailed procedures for common Guardian-based tasks that are useful to both new and experienced users. This guide addresses the needs of general system users – users who log on to a NonStop™...
Page 23: Where Else Can You Find Information
Introduction to Tandem NonStop A general introduction to NonStop™ Kernel Systems systems and online transaction processing (OLTP) Guardian Disk and Tape Utilities Command syntax and error messages for Backup, Reference Manual Restore, Backcopy, DSAP, DCOM, and Tapecom File Utility Program (FUP) Reference...
Page 24 About This Guide Your Comments Invited Guardian User’s Guide —425266-001 xxii...
Page 25 Hardware procedures are not discussed in this guide, except for an introduction to some common hardware monitoring. Most NonStop™ Kernel system users will use Guardian at some point, and this guide contains procedures that apply to most users. But most of the procedures in this guide are usually carried out by the most common Guardian users: system operators.
Page 26: Common Guardian Operations Tasks
ID are also included in this guide. System operators have many areas of responsibility and perform many tasks. There are certain fundamentals to know in the Guardian environment that will help you carry out the most basic operator tasks, including:...
Page 27: Table 1-1. Daily Tasks Check List
Introduction to Guardian System Operations Working With a Daily Check List Working With a Daily Check List Regardless of which shift you work, you need to regularly check certain areas of your hardware and software environment. A good method for ensuring that certain areas of your operations environment are checked is to develop a check list for yourself and other operators to follow.
Page 28: Automating Routine Monitoring Tasks
Introduction to Guardian System Operations Automating Routine Monitoring Tasks Automating Routine Monitoring Tasks Automating routine tasks and procedures helps save you time and reduces the possibility of errors. Most of the tasks in Table 1-1 can be automated using command files and TACL macros or routines.
Page 29 Compaq NonStop™ Kernel operating system: Section 2, Getting Started With TACL Section 3, Managing Files With TACL Section 4, Starting and Controlling Processes With TACL Section 5, Defining Function Keys and Writing Macros Section 6, Creating and Using DEFINEs Guardian User’s Guide —425266-001...
Page 30 Part I. Using the Compaq Tandem Advanced Command Language (TACL) Guardian User’s Guide —425266-001...
Page 31: Keys
Getting Started With TACL The Compaq Tandem Advanced Command Language (TACL) program, the command interpreter for the Guardian environment, is the primary interface between you and the Compaq NonStop™ Kernel operating system. The TACL program lets you designate special function keys and create macros: Assign an alias, or alternate name, to a TACL command or an application.
Page 32: Using Tacl As A Command Interpreter
1. End each command line (except the last line) with an ampersand (&). The TACL program redisplays its prompt with the same line number and an ampersand at the beginning of the continuation line. 2. Continue entering your command after this ampersand on the continuation line. Guardian User’s Guide —425266-001 2 -2...
Page 33: Logging On With Tacl
Note. Some systems do not require a password for users. Other systems might not allow the full logon feature or user IDs in a LOGON command. If you are uncertain about your system, ask your group or system manager. Guardian User’s Guide —425266-001 2 -3...
Page 34: Full Logon
You can also use the full logon feature with your user ID: TACL 1> LOGON 6,66,ABT Logon Mistakes If you make a mistake entering your user name, user ID, or password, the TACL program displays this message: *ERROR* Invalid user name or password Guardian User’s Guide —425266-001 2 -4...
Page 35: A Successful Logon
When SUPPORT.ALICE logs on, SUPPORT.STEIN is automatically logged off. The user ID and current defaults are changed to those of SUPPORT.ALICE. However, the TACL program retains the currently defined variables for STEIN (such as the macros and function-key definitions, if set). Guardian User’s Guide —425266-001 2 -5...
Page 36: Getting Started With Tacl (Continued)
Table 2-1. Sample Remote Passwords System \ABT System \FERN System \HERST \ABT AB \ABT AB \ABT AB \FERN FE \FERN FE \FERN FE \HERST HE \HERST HE \HERST HE Guardian User’s Guide —425266-001 2 -6...
Page 37: Establishing Remote Passwords
If you don’t know the CPU numbers for the remote system, start the primary process: 19> \HERST.TACL / NAME / TACL 1> Then, after you are logged on, determine the CPU numbers for the remote system and issue a BACKUPCPU command: 3> BACKUPCPU 4 Guardian User’s Guide —425266-001 2 -7...
Page 38: Changing Your Password
(one that is not displayed on your screen) and that you verify your old password before you can change it. If you have problems running Password, check with your group or system manager for your system’s requirements. Guardian User’s Guide —425266-001 2 -8...
Page 39: Logging On With Safeguard
Note. Systems running Safeguard software can be configured several different ways. The examples in this section represent a standard configuration. If you are uncertain about your system, see the Safeguard User’s Guide or ask your group or system manager. Guardian User’s Guide —425266-001 2 -9...
Page 40: Blind Password Logon
Changing Your Password When Already Logged In If the Password program is available on your system, you can use it to change your password after a successful Safeguard logon. See Changing Your Password on page 2-8. Guardian User’s Guide —425266-001 2- 10...
Page 41: Changing An Expired Password
This example shows how to use the LOGON program to log on to the remote system named \SFO. 4> RUN \SFO.LOGON SAFEGUARD 1> When you receive the Safeguard logon prompt, you log on normally. Guardian User’s Guide —425266-001 2- 11...
Page 42: Getting Tacl Help
Where you typed the helpkey, TACL was expecting / Or a legal processid or cpu,pin Or a legal system name Or a number or an arithmetic expression (Its value must be between 0 and 15 inclusive) Or * Or , Or end Guardian User’s Guide —425266-001 2- 12...
Page 43: Displaying User Information
TACL program uses the current defaults for the omitted parts of the file name. Saved volume Names of your saved default disk volume and subvolume. These are the defaults that are in effect each time you log on. Guardian User’s Guide —425266-001 2- 13...
Page 44: Displaying Information About Other Users
To list all users in the specified group, enter the group name followed by a period (.) and an asterisk (*): 14> USERS PAYROLL.* To list all users in your own group, enter an asterisk (*): 15> USERS * Guardian User’s Guide —425266-001 2- 14...
Page 45: Using Your Command History
To display any specific number of commands, enter a number in the command: > HISTORY 4 In this example, your previous four commands are displayed: 17> HISTORY 4 14> USERS PAYROLL.* 15> USERS * 16> HISTORY 17> HISTORY 4 Guardian User’s Guide —425266-001 2- 15...
Page 46: Redisplaying A Selected Previous Command
20> ! US 20> USERS * To reexecute the last command you entered, enter ! without a number or text string. Guardian User’s Guide —425266-001 2- 16...
Page 47: Changing Or Correcting A Previous Command
You can add more changes at this point, or if the command is correct, press Return again, and the TACL program executes the command. Guardian User’s Guide —425266-001 2- 17...
Page 48 The TACL program, however, interprets the I in INFO as the I command and inserts the string NFO after the L. At this point, rather than try to execute or edit the command, you can enter two forward slashes (//) followed by Return. Guardian User’s Guide —425266-001 2- 18...
Page 49 (#INFORMAT is set to TACL). 15> [ RUN $APPS.EMPLOYEE.LISTPGM / IN $DISK88.EMPLOYEE.NAMES, 15> OUT $S.#LAZR, NOWAIT / ] To change and reexecute this command to send the output to the spooler location #HOLD: Guardian User’s Guide —425266-001 2- 19...
Page 50 4. The TACL program again displays each line for you to confirm your change. 5. Make additional changes, as needed. Press Return after each line. After the last line, the TACL program executes the changed command. Guardian User’s Guide —425266-001 2- 20...
Page 51: Managing Files With Tacl
Managing Files With TACL Use the TACL program to perform basic file management tasks with your disk files: Topic Page Introduction to Files in Guardian Listing Files and Their Information Renaming Files Deleting Files Changing Your Default Values 3-10 Selected TACL commands are described in this section. For syntax and reference information about all TACL commands and programs, see the TACL Reference Manual.
Page 52: Introduction To Files In Guardian
Introduction to Files in Guardian Introduction to Files in Guardian On a Compaq NonStop™ Kernel system, a file on the Guardian operating system can Disk files, which can contain data, code, or text Nondisk devices, such as terminals, printers, or tape drives Processes (programs that are running) You always refer to a file by its file name.
Page 53: Disk File Names
Default Values on page 3-10). However, TACL does not supply the subvolume name by default in some situations that were allowed in previous releases. That is, if a volume name is immediately followed by Guardian User’s Guide —425266-001 3 -3...
Page 54 TACL program does not recognize it as a valid file name and does not supply the subvolume name. For example, VOL1.MYFILE is not a valid file name, but VOL1.SUBVOL.MYFILE and SUBVOL.MYFILE are valid. Guardian User’s Guide —425266-001 3 -4...
Page 55: Listing Files And Their Information
You can use more than one wild card in the same command. For example, to list all files that reside in any subvolume that has a three-character name beginning with KH on all volumes beginning with $MT: 6> FILES $MT*.KH? Guardian User’s Guide —425266-001 3 -5...
Page 56: Searching For Files With Related Names (Filenames Command)
Getting File Information (FILEINFO Command) To list information about a file, include the file name in a FILEINFO command: 10> FILEINFO \MEL.$GERT.STEIN.BOOKS \MEL.$GERT.STEIN Code Last Modification Owner RWEP PExt SExt BOOKS 101 10961 07OCT1998 14:27 8,23 NUUU Guardian User’s Guide —425266-001 3 -6...
Page 57 SECT and ending with the number 2: 14> FILEINFO ALICE.SECT?2 $GERT.ALICE Code EOF Last Modification Owner RWEP PExt SExt SECT12 2456 10JAN1999 08:14:46 8,23 GOGO SECT22 5617 10JAN1999 15:23:37 8,23 NUUU Guardian User’s Guide —425266-001 3 -7...
Page 58: Renaming Files
To delete the file named SECT12 from the subvolume BOOKA on volume $GERT: 16> PURGE $GERT.BOOKA.SECT12 $GERT.BOOKA.SECT12 Purged To show how to delete SECT12 using the CONFIRM option: 16> PURGE /CONFIRM/ $GERT.BOOKA.SECT12 PURGE $GERT.BOOKA.SECT12 (y/[n])? Y $GERT.BOOKA.SECT12 Purged Guardian User’s Guide —425266-001 3 -8...
Page 59: Purging Files Using File-Name Templates
17> PURGE /CONFIRM/ SECT* PURGE $STEIN.BOOK.SECT01 (y/[n])? N PURGE $STEIN.BOOK.SECT02 (y/[n])? Y $STEIN.BOOK.SECT02 Purged PURGE $STEIN.BOOK.SECT03 (y/[n])? N You can also delete files with the File Utility Program (FUP). See Deleting Files page 7-17. Guardian User’s Guide —425266-001 3 -9...
Page 60: Changing Your Default Values
$VOL1.MYFILE. Changing Your Current Default System, Volume, or Subvolume (VOLUME Command) To change the current default subvolume from $GERT.STEIN (on your home system) to the subvolume RHALL on \LONE.$WELL: 1> VOLUME \LONE.$WELL.RHALL Guardian User’s Guide —425266-001 3- 10...
Page 61: Changing Your Current Default Node (System Command)
Changing your current default node (system) name lets you omit the node name from the name of a file on a remote system. To set the current default node name to \LONE: 7> SYSTEM \LONE Guardian User’s Guide —425266-001 3- 11...
Page 62: Changing Your Tacl Prompt (Setprompt Command)
To have your TACL prompt automatically customized each time you log on, store a SETPROMPT command in a TACLCSTM file as described in Section 5, Defining Function Keys and Writing Macros. Guardian User’s Guide —425266-001 3- 12...
Page 63: Changing Your Saved Defaults (Default Program)
The security specifier RWEP is a four-character string. Each position in the string sets the security restriction for one of four disk-file operations: who can read the file who can write to the file who can execute the file who can purge the file Guardian User’s Guide —425266-001 3- 13...
Page 64 A security string can also include a hyphen (–), which means that only the local super ID (a user logged on with user ID 255,255) can access the file. However, you cannot include this character in your default security string; you can set it only with the FUP SECURE command. Guardian User’s Guide —425266-001 3- 14...
Page 65: Starting And Controlling Processes With Tacl
Restarting a TACL Process Running Compaq NonStop™ Kernel Utilities 4-10 Solving Common System Process Problems 4-11 Selected TACL commands are described in this section. For information about all TACL commands and programs, see the TACL Reference Manual. Guardian User’s Guide —425266-001 4 -1...
Page 66: Getting Information About Processes
Pri PFR %WT Userid Program file Hometerm $JT12 4,85 8,001 $SYSTEM.SYS02.TACL $JT1.#J01 $JT12 5,84 R 000 8,001 $SYSTEM.SYS02.TACL $JT1.#J01 9,151 140 8,001 $SYSTEM.SYSTEM.SUBVOLS $JT1.#J012 2. Display information about the process 9,151. > STATUS 9,151 Guardian User’s Guide —425266-001 4 -2...
Page 67: Displaying Named Process Information (Ppd Command)
Use the PPD command if you know the name of a process and want to find out its CPU and process identification number (PIN) (and the CPU and PIN of its backup, if one exists), or if you want to find out what process created a named process. Guardian User’s Guide —425266-001 4 -3...
Page 68 The null user ID (0,0) indicates that no one is logged onto this TACL process. Examples 1. Send a listing of all running processes to your subvolume CURRENT and your file PROCESS. > PPD / OUT CURRENT.PROCESS / Guardian User’s Guide —425266-001 4 -4...
Page 69: Starting And Controlling A Process
You can enter a RUN command either explicitly or implicitly: Guardian User’s Guide —425266-001 4 -5...
Page 70: Running A Process At A High Pin
Use the Break key to interrupt a process and return to the TACL program. When you press Break, most processes yield control of the terminal to the TACL program and continue to run in background mode. If a background process requires input from or Guardian User’s Guide —425266-001 4 -6...
Page 71: Pausing A Process
For example, to stop the process that has CPU and PIN 2,99: 13> STOP 2,99 To stop the default process (the last process you started), use the STOP command without specifying a process. Guardian User’s Guide —425266-001 4 -7...
Page 72: Using A Command (Obey) File
$WELL.RHALL Userid: 6,66 Username: SUPPORT.STEIN Security: "NUNU" COMMENT List all files in $GERT.STEIN FILES $GERT.STEIN $GERT.STEIN BELL BOOK CANDLE PATIENCE SARAH COMMENT Set my TACL prompt to my current volume SETPROMPT VOLUME $GERT 15> Guardian User’s Guide —425266-001 4 -8...
Page 73: Restarting A Tacl Process
16> TACL / IN $STEIN, OUT $STEIN, NAME $Z103, CPU 4, NOWAIT/ 5 Including the NOWAIT option immediately restores the TACL prompt at the terminal where you enter this command. For more information about the RUN command and the TACL program, see the TACL Reference Manual. Guardian User’s Guide —425266-001 4 -9...
Page 74: Running Compaq Nonstop™ Kernel Utilities
Every utility uses a different character for a command prompt. For example, Peruse uses an underscore (_) and FUP uses a hyphen (—). To exit a utility, enter EXIT at the utility’s prompt. Guardian User’s Guide —425266-001 4- 10...
Page 75: Solving Common System Process Problems
Notify your DEBUG. management. A process is Users complain of A process is looping. Notify your performing slowly. slow response time or management. “hung” terminals. A process is Use the TACL suspended. ACTIVATE command. Guardian User’s Guide —425266-001 4- 11...
Page 76 Starting and Controlling Processes With TACL Solving Common System Process Problems Guardian User’s Guide —425266-001 4- 12...
Page 77: Defining Function Keys And Writing Macros
The amount you must remember or look up the command syntax Topic Page Defining and Using Your Function Keys Writing TACL Macros Customizing Your TACL Environment 5-12 For more information on these topics, see the TACL Reference Manual and the TACL Programming Guide. Guardian User’s Guide —425266-001 5 -1...
Page 78: Defining And Using Your Function Keys
F16) or shifted function keys (SF1 through SF16). type Type of definition: ALIAS or MACRO. Other types of function-key definitions are described in the TACL Reference Manual. command TACL command that you want this function key to execute. Guardian User’s Guide —425266-001 5 -2...
Page 79 If the command included in an alias definition accepts command arguments, you can enter values for these arguments when you use the function key, as described in Passing a Value to an Alias Definition on page 5-7. Guardian User’s Guide —425266-001 5 -3...
Page 80 You must also include any required punctuation. For example, you can define the STATUS command using the %*% argument: ?SECTION F1 MACRO STATUS %*% To enter a STATUS *, TERM command using a key with this definition, enter: 15> *, TERM and press F1. Guardian User’s Guide —425266-001 5 -4...
Page 81 12> * TERM Then press F8 (no value is passed to the third argument, %3%). This macro definition is further described in Passing a Value to a Macro Definition on page 5-7. Guardian User’s Guide —425266-001 5 -5...
Page 82: Loading Your Function Key Definitions
If the command defined for a function key accepts command arguments, you can pass a value to the command, and the TACL program uses this value as a command argument. This is true for both alias and macro definitions. Guardian User’s Guide —425266-001 5 -6...
Page 83 (For details, see the syntax of the STATUS command in the TACL Reference Manual.) To use this key definition to obtain the status of all processes running in CPU 4 with a priority of 150 or lower: Guardian User’s Guide —425266-001 5 -7...
Page 84 For each function key you used, the TACL program displays the name of the key followed by any function arguments you entered before you pressed the key. The TACL Help key (F16) does not appear in the HISTORY display. Guardian User’s Guide —425266-001 5 -8...
Page 85: Writing Tacl Macros
In the first example, the letter P is used as an alias for PERUSE. In the second example, the letters FN invoke the FILENAMES command with one dummy argument. ?SECTION P ALIAS PERUSE ?SECTION FN MACRO FILENAMES %*% Guardian User’s Guide —425266-001 5 -9...
Page 86 LOAD command or the #LOAD built-in function (like how you load your function-key library file): 10> LOAD / KEEP 1 / MYMACS Loaded from $GERT.STEIN.MYMACS: P FN ED H F W T INFO Guardian User’s Guide —425266-001 5- 10...
Page 87: Using A File Starting With A ?Tacl Directive
You can store only one macro definition in a file that starts with the ?TACL MACRO directive. Instead, use the ?SECTION directive to define macros in files that you plan to load. Guardian User’s Guide —425266-001 5- 11...
Page 88: Customizing Your Tacl Environment
To load any function-key definitions you changed while logged on, issue the LOAD command to load the new definitions or log off and log on again. See the TACL Reference Manual for more information about the TACLCSTM file. Guardian User’s Guide —425266-001 5- 12...
Page 89: Creating And Using Defines
Using DEFINEs with FUP, labeled tapes, and Backup and Restore is described in Section 7, Using FUP for Basic File Management, Section 10, Using Labeled Tapes, Section 11, Backing Up and Restoring Disk Information, respectively. Guardian User’s Guide —425266-001 6 -1...
Page 90: Using A Define
Uppercase and lowercase letters in a DEFINE name are equivalent. Note. Compaq reserves all DEFINE names beginning with an equal sign and underscore (=_). Do not use DEFINE names that begin with this two-character string. Guardian User’s Guide —425266-001 6 -2...
Page 91: Define Templates
Attributes of a file on a labeled tape, such as block size and density The CATALOG, DEFAULTS , MAP, SPOOL, and TAPE classes are described below. The SEARCH class is described in the Guardian Programmer’s Guide and the Guardian Procedure Calls Reference Manual; SORT and SUBSORT classes are described in the TACL Reference Manual and the FastSort Manual.
Page 92 When you create a MAP DEFINE, you give it the name you want to use as a substitute for an actual file name. You can use a MAP DEFINE wherever a file name can be used. Guardian User’s Guide —425266-001 6 -4...
Page 93 5> ADD DEFINE =TAPE^JOB, CLASS TAPE, LABELS ANSI, FILEID INVENTRY 6> INFO DEFINE =TAPE^JOB, DETAIL Define Name =TAPE^JOB CLASS TAPE LABELS ANSI FILEID INVENTRY For more TAPE DEFINE examples, see Section 10, Using Labeled Tapes. Guardian User’s Guide —425266-001 6 -5...
Page 94: Enabling And Disabling Defines
If you start a new process and propagate your DEFINEs to this process, a change made to the original DEFINE in your TACL process does not affect the new process. Conversely, a change in a DEFINE in the new process does not affect your TACL process. Guardian User’s Guide —425266-001 6 -6...
Page 95: Define Attributes
USE IN (if you use the tape file for input). An optional attribute has no initial value and does not require a value. OWNER and DENSITY are optional attributes for a TAPE DEFINE. Guardian User’s Guide —425266-001 6 -7...
Page 96: Working Attribute Set
The attribute consistency checks that apply to TAPE DEFINEs are listed in the TACL Reference Manual. If a consistency check fails, a message identifies the check number; only one inconsistency is reported for each check. Guardian User’s Guide —425266-001 6 -8...
Page 97: Tacl Define Commands
Enabling and Disabling DEFINEs on page 6-6. Task 2: Create the DEFINE In the ADD DEFINE command, you specify a name and class for the DEFINE, as well as any other attributes you want to define. Guardian User’s Guide —425266-001 6 -9...
Page 98: Task 3: Use The Created Define
EMPLOYEE NAMES After two copies are printed, the job remains on the print queue. You can print additional copies, if needed, or you can delete the job from the queue with the Peruse DEL command. Guardian User’s Guide —425266-001 6- 10...
Page 99: Part Ii. Managing Files Using The File Utility Program (Fup)
This part of the guide contains information about using FUP to create and manage files on your Compaq NonStop™ Kernel system: Section 7, Using FUP for Basic File Management Section 8, Using FUP for Advanced File Management Guardian User’s Guide —425266-001...
Page 100 Part II. Managing Files Using the File Utility Program (FUP) Guardian User’s Guide —425266-001...
Page 101: Using Fup For Basic File Management
(FUP) Management Programming Manual for details. Before you use FUP to create or manage disk files, you should be familiar with the Compaq NonStop™ Kernel operating system concept of a file for the Guardian operating system as described in Section 3, Managing Files With TACL.
Page 102: Entering Fup Commands
You can also stop a FUP process by pressing the CTRL-Y keys. CTRL-Y marks the end of a file (EOF). When FUP reads CTRL-Y from its input file (in this case, your terminal), it stops execution. Guardian User’s Guide —425266-001 7 -2...
Page 103: Entering Fup Commands From A Command File
-- FUP Commands for Obtaining a List of -- All Subvolumes in $DISK1, $DISK2, and $DISK3 -- Last Modified 1/17/99 13:24 SUBVOLS $DISK1 -- Contains manufacturing files SUBVOLS $DISK2 -- Contains administrative files SUBVOLS $DISK3 -- Contains all other files Guardian User’s Guide —425266-001 7 -3...
Page 104 -SUBVOLS / OUT INFO2 / $DISK2 After these three commands are executed, the names of the subvolumes in $DISK1 are listed in the file INFO1, and the names of the subvolumes in $DISK2 are listed in INFO2. Guardian User’s Guide —425266-001 7 -4...
Page 105: Using Defines In Fup Commands
3> INFO DEFINE =MYSPOOLER, DETAIL Define name =MYSPOOLER CLASS SPOOL $X5.#LASER SELPRI If you direct FUP command output to =MYSPOOLER, the output is spooled at the destination $X5.#LASER, and the spooler job has priority 6. Guardian User’s Guide —425266-001 7 -5...
Page 106 In the next example, the RECLEN attribute of the TAPE DEFINE sets the input record length for the COPY operation to 200 bytes: 1> ADD DEFINE =INFILE, CLASS TAPE, LABELS ANSI,VOLUME 89RST, USE OUT, RECLEN 200 2> FUP COPY =INFILE, $DATA.RECDS Guardian User’s Guide —425266-001 7 -6...
Page 107: Getting Help From Fup
To stop a background FUP process, enter the TACL STOP command. For example, if the last process you started is FUP, which is running in the background, you can stop it by entering: 2> STOP Guardian User’s Guide —425266-001 7 -7...
Page 108: Changing System And Volume Defaults
For example, the changes made by the commands in the last two examples can be made at one time by entering: -VOLUME $DISK99.MAYFLY To restore the initial default system, volume, and subvolume values, enter VOLUME alone: -VOLUME Guardian User’s Guide —425266-001 7 -8...
Page 109: Getting Information About Subvolumes And Files
To get a list of the files in every subvolume on a disk volume, enter the FILES command and an asterisk (*) as the subvolume name. For example, this command lists all the subvolumes on the $SYSTEM disk: -FILES $SYSTEM.* Guardian User’s Guide —425266-001 7 -9...
Page 110: Getting Information About Single Files
Safeguard software. For more information about the Safeguard subsystem, see the Safeguard User’s Guide. TYPE, REC, and BLOCK show information about structured files. For details, see the description of the FUP INFO command in the File Utility Program (FUP) Reference Manual. Guardian User’s Guide —425266-001 7- 10...
Page 111: Getting Information About File Sets
To get information about all the files in any volume that contains five characters and starts with MANU, enter: -INFO $MANU?.*.* To get information about all the files in the subvolume $MYVOL that start with FILE followed by any two characters, enter: -INFO $MANUF.MYVOL.FILE?? Guardian User’s Guide —425266-001 7- 11...
Page 112 FUP then displays information about only those files in each file-set list that are owned by the specified user. For a complete description of file set and file-set list, see the FUP command syntax summary in the File Utility Program (FUP) Reference Manual. Guardian User’s Guide —425266-001 7- 12...
Page 113: Performing Common File Operations
An asterisk (*) in place of one or more file names if you want the names of the new files to be the same as the old files. For example, if you have these files: -FILES $ALPHA.SOUP $ALPHA.SOUP -FILES $COUNT.DOWN $COUNT.DOWN BLASTOFF Guardian User’s Guide —425266-001 7- 13...
Page 114 1. Duplicate the file BIGFILE on system \WEST to NEWFILE on system \EAST and use the RESTARTABLE option with RSFILE as the restart file, enter: -DUP \WEST.$DISK2.ACCTS.BIGFILE, & -\EAST.$DISK4.ACCTS.NEWFILE, RESTARTABLE RSFILE Guardian User’s Guide —425266-001 7- 14...
Page 115: Renaming Files
Also, you cannot change the volume names of files with the RENAME command. If you include a system or volume name in the file set or file-set list to be renamed, the same system or volume name must appear in the destination. Guardian User’s Guide —425266-001 7- 15...
Page 116: Changing File Security
-GIVE FORTLIB.*, RESRCH.JACK If you want to regain ownership of a file, the new owner or a user logged on as the super ID must use the FUP GIVE command to give the file to you. Guardian User’s Guide —425266-001 7- 16...
Page 117: Deleting Files
Purging Several Files With or Without Prompting You can specify more than one file or a file set in a PURGE command. When you specify several files, separate the elements with commas. For example, after you enter Guardian User’s Guide —425266-001 7- 17...
Page 118 Return: If you choose YES, FUP purges the entire subvolume with no more prompting. If you choose NONE, the PURGE command ends without purging the subvolume. The FUP prompt reappears. Guardian User’s Guide —425266-001 7- 18...
Page 119 If you want to prevent a file from being purged before a specific date, use the ALTER command with the NOPURGEUNTIL option to alter the file’s expiration date. For example, this command prevents the file FILE1992 from being purged before January 1, 2000. -ALTER FILE1992, NOPURGEUNTIL 1JAN2000,8:00:00 Guardian User’s Guide —425266-001 7- 19...
Page 120 EOF 4338 (0.9% USED) EXTENTS ALLOCATED: 1 FILE1992 cannot be purged before 8:00 a.m. on January 1, 2000, except by a user with super ID 255,255 or unless you alter the expiration date again. Guardian User’s Guide —425266-001 7- 20...
Page 121: Using Your Fup Command History
INFO command, enter: -! INFO ? Command The ? command allows you to display (but not execute) a specific FUP command. For example, to display the last command that referenced the system \WEST, enter: -? \WEST Guardian User’s Guide —425266-001 7- 21...
Page 122: Solving Common File Problems
A file or files are left Miscommunication, user Use the FUP LISTOPENS command open when the system forgetfulness, or faulty or to identify the user in question; notify is shut down. incomplete system your management. shutdown procedures. Guardian User’s Guide —425266-001 7- 22...
Page 123: Using Fup For Advanced File Management
FUP consults its table of file-creation parameters and, if the current values result in a legal file, creates a file whose attributes are based on these values. 4. Restore one or more file-creation parameters to their original values with the FUP RESET command. Guardian User’s Guide —425266-001 8 -1...
Page 124: Figure 8-1. Steps For Creating A File With Fup
Use the FUP SHOW command to display the current values of the file-creation parameters. You can override the current value by setting a value for a parameter in your FUP CREATE command. Guardian User’s Guide —425266-001 8 -2...
Page 125: Table 8-1. Parameters Of The Fup Set Command
Size of internal buffer for unstructured files (DP2 files only) AUDITCOMPRES Mode of auditing by TMF (DP2 files only) VERIFIEDWRITES Mode for disc writes (DP2 files only) SERIALWRITES Selection of serial or parallel mirror writes (DP2 files only) Guardian User’s Guide —425266-001 8 -3...
Page 126: Creating Files Using Ddl
DP2 file attributes, see the File Utility Program (FUP) Reference Manual.) If you enter the CREATE command at this point, you create an unstructured file whose primary and secondary extent sizes are one page each: -CREATE FILE1 CREATED - $MANUF.FREDFILE.FILE1 Guardian User’s Guide —425266-001 8 -4...
Page 127: Restoring Default File-Creation Parameters
After you create a file (and before you create another), you might want to restore certain file-creation parameters to their default values. To do this, enter the RESET command followed by the parameter or parameters to reset. Guardian User’s Guide —425266-001 8 -5...
Page 128: File-Creation Examples
Unstructured files are arrays of bytes. They are normally used to store object programs or text created with a text editing program such as TEDIT. If you create a file that has the logon default file-creation attributes, the new file is an unstructured file. Guardian User’s Guide —425266-001 8 -6...
Page 129 -SET BLOCK 2048 --Set the data-block length. -SHOW --Show the current parameter values. TYPE E EXT ( 4 PAGES, 4 PAGES ) REC 80 BLOCK 2048 MAXEXTENTS 16 -CREATE ENSEQ --Create the file. CREATED - $USERS.JOHN.ENSEQ Guardian User’s Guide —425266-001 8 -7...
Page 130: Figure 8-2. Structure Of An Entry-Sequenced File
All physical records are the same length. Records are stored by record number. Record numbers give the position of a record relative to the first record in the file. Records are retrieved randomly using record numbers. Guardian User’s Guide —425266-001 8 -8...
Page 131: Figure 8-3. Structure Of A Relative File
In a key-sequenced file, records are stored by the values of their primary keys. A primary key is a field within a record that uniquely identifies the record. Figure 8-4 shows a possible format for a record in a key-sequenced file. Guardian User’s Guide —425266-001 8 -9...
Page 132: Figure 8-4. Key-Sequenced File Format
-- length for key-sequenced files. SET IBLOCK 2048 -- You can also specify the size of -- index blocks. SHOW -- Display current parameter values. CREATE KEYSEQ -- Create the file. 21 > FUP /IN FILE1/ Guardian User’s Guide —425266-001 8- 10...
Page 133: Possible Record Format: Key-Sequenced File With Alternate
Besides having a primary key, a key-sequenced file can have one or more alternate keys. Figure 8-6. Possible Record Format: Key-Sequenced File With Alternate Keys Byte Offset [32] [40] [42] [46] [54] partno descr price avail^qty vendor Primary Alternate Alternate Alternate Key "AQ" Key "LO" Key "VN" .CDD Guardian User’s Guide —425266-001 8- 11...
Page 134 To create a file in key-sequenced partitioned format, enter the following FUP commands in a file. Then run FUP, specifying the command file as the input file with the IN option. This example shows the commands in FILE3. Guardian User’s Guide —425266-001 8- 12...
Page 135: Figure 8-7. Structure Of A Partitioned File
SET PART ( 1, $VOL2, 64, 8, "HA" ) SET PART ( 2, $VOL3, 64, 8, "QU" ) -- Show the current parameter SHOW CREATE PART -- Create the file. 21 > FUP /IN FILE3/ Guardian User’s Guide —425266-001 8- 13...
Page 136 -SET LIKE $CLEAN.BERKELEY.AIR -SHOW TYPE K EXT ( 5 PAGES, 5 PAGES ) REC 80 BLOCK 2048 IBLOCK 2048 KEYLEN 9 KEYOFF 0 DCOMPRESS, ICOMPRESS MAXEXTENTS 16 -CREATE $CLEAN.SANJOSE.AIR CREATED - $CLEAN.SANJOSE.AIR Guardian User’s Guide —425266-001 8- 14...
Page 137: Maintaining Your Disk Files
The LOAD command has these advantages: Loading files does not affect alternate-key values. Because data is written a block at a time, LOAD is faster than COPY. Guardian User’s Guide —425266-001 8- 15...
Page 138: Purging Data From Files
To rename or move a file that has an alternate key: Use the FUP RENAME or DUPLICATE command to rename or move the file or files. Guardian User’s Guide —425266-001 8- 16...
Page 139: Copying Files To A Backup Volume
-DUP $VOL1.*.*, $BACKUP.*.*, PARTONLY, SAVEALL This command creates a backup copy of each file on $VOL1 on $BACKUP. Each backup file has the same file name and subvolume name as its original file. The Guardian User’s Guide —425266-001 8- 17...
Page 140: Adding Alternate Keys To Files
-CREATE ALTFILE -LOADALTFILE 0, PRIFILE Here, the new record and key lengths must be 62 bytes (2 for the key specifier, plus 20 for the longest alternate key, plus 40 for the primary key). Guardian User’s Guide —425266-001 8- 18...
Page 141: Modifying Partitioned Files
The DUP command with the PARTONLY option copies the secondary partition $VOL2.SVOL.PARTFILE to $NEW.SVOL.PARTFILE. The ALTER command changes the file label of the primary partition ($VOL1.SVOL.PARTFILE) to indicate that the first secondary partition resides in the file $NEW.SVOL.PARTFILE. Guardian User’s Guide —425266-001 8- 19...
Page 142 $VOL2, enter: -VOLUME $VOL1.PARTFILE -ALTER PART, PART ( 1, $VOL2, 120, 12 ) -RENAME $VOL2.PART, $VOL2.TEMP, PARTONLY -SET LIKE $VOL2.TEMP -SET EXT ( 120, 12 ) -CREATE $VOL2.PART -DUP $VOL2.TEMP, $VOL2.PART, OLD, PARTONLY -PURGE $VOL2.TEMP Guardian User’s Guide —425266-001 8- 20...
Page 143 $VOL1.SVOL.RELFILE to show that it is the primary partition of a partitioned file with a secondary partition in the volume $VOL2. This command adds a third partition on the volume $VOL3: -CREATE $VOL3.RELFILE -ALTER RELFILE, PART ( 2, $VOL3, 100, 10 ) Guardian User’s Guide —425266-001 8- 21...
Page 144: Reorganizing Key-Sequenced Files
The RATE option controls the amount of processor time the reload operation uses. A value less than 100 prevents the reload operation from monopolizing the processor and its resources. For more information about FUP RELOAD and its other options, see the File Utility Program (FUP) Reference Manual. Guardian User’s Guide —425266-001 8- 22...
Page 145: Part Iii. Managing Disk And Tape Processes
This part of the guide contains information about tape activities, including labeled tape processing, and using Backup and Restore to copy files between disk and tape: Section 9, Performing Routine Disk Operations Section 10, Using Labeled Tapes Section 11, Backing Up and Restoring Disk Information Guardian User’s Guide —425266-001...
Page 146 Part III. Managing Disk and Tape Processes Guardian User’s Guide —425266-001...
Page 147: Performing Routine Disk Operations
STARTED or STOPPED. ALIAS Defines a command or text abbreviation. ALLOCATE Allocates (reserves) file space for one or more objects. Each object must be an explicitly (using the ADD command) or implicitly defined object. Guardian User’s Guide —425266-001 9 -1...
Page 148: Table 9-1. Scf Command Summary
Breaks a connection between two objects. DUMP Copies information from one location to another to diagnose a problem. Displays the settings of various SCF session parameters, sometimes called environmental parameters. EXIT Terminates an SCF session. Guardian User’s Guide —425266-001 9 -2...
Page 149 REPEAT Causes the remainder of the command line to be repeated for a specific number of iterations or until the Break key is pressed. Guardian User’s Guide —425266-001 9 -3...
Page 150 (Does not support DISK or TAPE devices in G-series releases) Displays the version level of SCF, SCP, or the current subsystem. VOLUME Sets default volume and subvolume names for all file-name expansion. Reexecutes a command line. Displays a specific command line. Guardian User’s Guide —425266-001 9 -4...
Page 151: Checking Disk Status
Primary Backup *STARTED STARTED *STARTED STARTED 0,267 1,266 This display shows that all paths to this mirrored volume are currently up. To list the devices on your default system, enter: > SCF STATUS $SYSTEM Guardian User’s Guide —425266-001 9 -5...
Page 152: Bringing Up A Disk Or Path
-B (for backup path); -M (for mirror path); or -MB (for mirror backup path). Bringing Up a Disk or Path From a STOPPED State, Substate HARDDOWN 1. Make sure you are logged on as a super-group user (255,n). 2. Reset the disk: -> RESET DISK $disk Guardian User’s Guide —425266-001 9 -6...
Page 153: Taking Down A Disk Or Path
1. Make sure you are logged on as a super-group user (255,n). 2. Take the disk down: > SCF STOP DISK $AMBER, FORCED FORCED means that SCF continues even if there are open files on the disk. Guardian User’s Guide —425266-001 9 -7...
Page 154: Taking Down A Path To A Mirrored Disk
> SCF STATUS DISK $DATA A listing similar to this is displayed on your home terminal: STORAGE - Status DISK \SHARK.$DATA LDev Primary Backup Mirror MirrorBackup Primary Backup STARTED STARTED STOPPED STOPPED 3,260 2,265 Guardian User’s Guide —425266-001 9 -8...
Page 155: Altering The Current Path To A Dual-Ported Disk
SCF STOP DISK is valid only for physically demountable mirrored disks, and it is rejected if either disk of the mirrored disk is already down. 5. Determine whether any unspared bad sectors exist on the disk: -> INFO DISK $disk, BAD Guardian User’s Guide —425266-001 9 -9...
Page 156 1. Make sure you are logged on as a super-group user (255,n). 2. Enter: -> INFO DISK $DATA00, BAD -> CONTROL DISK $DATA00-P, SPARE 173, 2, 6 -> STOP DISK! $DATA00-P A warning message and verification request is displayed. Respond yes by entering: -> Y Guardian User’s Guide —425266-001 9- 10...
Page 157: Bringing Up The Down Half Of A Mirrored Disk
The mirrored disk $DATA01 is physically demountable and an SCF STATUS DISK command shows both $DATA01-M and $DATA01-MB to be down. Guardian User’s Guide —425266-001 9- 11...
Page 158: Finding And Sparing Bad Tracks And Sectors
If there are no bad sectors, there is no need to continue with this procedure. 2. Make sure you are logged on as a super-group user (255,n). 3. Stop all other processing on the disk. Guardian User’s Guide —425266-001 9- 12...
Page 159 4. Make sure there is not already an SCF CONTROL DISK, SPARE operation in progress. 5. Unconditionally spare the sector that has logical sector address %H0000795C: > SCF -> CONTROL DISK $DATA01, SPARE %H795C Guardian User’s Guide —425266-001 9- 13...
Page 160: Managing Disk Space Usage
The format of the resulting display and details about this command are described in the SCF Reference Manual for the Storage Subsystem. Example To display disk free-space information for the disk $AMBER, enter: > SCF STATUS DISK $AMBER, DETAIL Guardian User’s Guide —425266-001 9- 14...
Page 161: Analyzing Disk Space Usage With The Disk Space Analysis Program (Dsap)
If you enter DSAP at a TACL prompt without any parameters, DSAP displays help information, including run options, report options, and examples. To use DSAP to quickly check the free space on a disk, enter: > DSAP $disk, SHORT Guardian User’s Guide —425266-001 9- 15...
Page 162: Report Formats
> DSAP /OUT $S.#print, files. NOWAIT/ $disk , DETAIL, SEPARATE See the Guardian Disk and Tape Utilities Reference Manual for the complete syntax, considerations, and examples of DSAP reports, and for error messages generated by DSAP. Report Formats When DSAP displays a report at a terminal, the report has an output width of 79 columns and is not formatted into pages.
Page 163 Generating a Summary Report of Specific Subvolumes To run a DSAP report on the subvolumes owned by the user SALES.BONNIE (user ID 8,1) on the disk $DATA1, enter: > DSAP $DATA1, BYSUBVOL, USER 8,1 Guardian User’s Guide —425266-001 9- 17...
Page 164 0 deallocatable extent pages in 0 files (0.0%). No SQL views. Generating a Summary Report of Subvolumes To generate a report for ACCTS.JUDY on $DISK2, enter: 11> DSAP $DISK2, USER ACCTS.JUDY, BYSUBVOL 11> DSAP $DISK2, USER 8,76, BYSUBVOL Guardian User’s Guide —425266-001 9- 18...
Page 165 To generate a report for USERS.FRED (user ID 8,100) on $DISK2, and to send the report to the spooler location $S.#LP, enter: 12> DSAP /OUT $S.#LP/ $DISK2, USER USERS.FRED, DETAIL 12> DSAP /OUT $S.#LP/ $DISK2, USER 8,100, DETAIL Guardian User’s Guide —425266-001 9- 19...
Page 166: Listing And Purging Old Disk Files
1. Determine whether old files exist on the disk. a. Log on as a super-group user (255,n). b. List all the subvolumes on a disk: > FUP SUBVOLS Guardian User’s Guide —425266-001 9- 20...
Page 167 24 unused pages in 7 files (0.0%). 0 deallocatable extent pages in 0 files (0.0%). No SQL views. Subvol Summary Report Subvolume Name Total Unused Dealloc Large Min Age Files Pages Pages Pages File Mod,Opn BONN 365,365 MEMOS 365,365 Guardian User’s Guide —425266-001 9- 21...
Page 168 > PURGE BONN.MISC 4. Purge the subvolume BONN: > FUP PURGE BONN.* FUP responds with: DO YOU WISH TO PURGE THE ENTIRE SUBVOLUME $DATA1.BONN ( Y[ES], N[ONE], S[ELECT], F[ILES] )? Enter Y to complete this operation. Guardian User’s Guide —425266-001 9- 22...
Page 169: Monitoring And Altering Swap Files
The NonStop™ Kernel swaps to the kernel-managed swap files as needed. As a process’s need for swap space grows, KMSF increases the reservation. Additional swap space might be given from a different swap file than that used for the original Guardian User’s Guide —425266-001 9- 23...
Page 170: How Kernel-Managed Swap Files Affect You
Otherwise, data is swapped to whatever kernel-managed swap file or files are available for the processor in which the process is running. Only super-group users (255,n) can resize, add, or delete kernel-managed swap files. Guardian User’s Guide —425266-001 9- 24...
Page 171: Using Nskcom To Monitor And Alter Swap Files
NSKCOM to configure and manage swap files if you need to make any changes. Monitoring Swap Files To monitor kernel-managed swap files, you can use NSKCOM to review the status of the swap files and the swap file statistics for each processor. 1. Run NSKCOM. > NSKCOM Guardian User’s Guide —425266-001 9- 25...
Page 172 CPU 1 CPU Pages: Total 4096 Reserved 68 Available 4028 Peak CPU Pages ever reserved 80 Threshold 3481 CPU pages 3. Display statistics for each processor, using the STATUS KMSF command. > NSK- STATUS KMSF Guardian User’s Guide —425266-001 9- 26...
Page 173 This actual current usage can be at most equal to the number of Reserved CPU Pages at any given time. For more information about NSKCOM, see the Kernel-Managed Swap Facility (KMSF) Manual. Guardian User’s Guide —425266-001 9- 27...
Page 174: Solving Common Disk Problems
Users report access problems, Escalate the problem. (Database down or both disks in an application goes down, recovery or disk repair might be a mirrored pair are and event messages can be required.) down. generated. Guardian User’s Guide —425266-001 9- 28...
Page 175: Using Labeled Tapes
For more information about using MEDIACOM, see the DSM/Tape Catalog Operator Interface (MEDIACOM) Manual. MEDIACOM replaces the TAPECOM utility. If you have not yet switched from TAPECOM and need more information about it, see the Guardian Disk and Tape Utilities Reference Manual. Guardian User’s Guide —425266-001...
Page 176: How Labeled-Tape Processing Works
MEDIACOM command has a HELP option that lists full syntax and options. For example, when you enter MC> HELP STATUS TAPEDRIVE MEDIACOM returns: STATUS TAPEDRIVE [ \node.] $tape ] [ , BRIEF | DETAIL ] Guardian User’s Guide —425266-001 10- 2...
Page 177: Table 10-1. Mediacom Commands
Removes a file catalog once it is empty DROP VOLCAT Removes a volume catalog once it is empty Displays the current session default values EXIT Ends the session; returns control to the command interpreter Guardian User’s Guide —425266-001 10- 3...
Page 178 Defines session default for whether a tape is left online after a command finishes VOLCAT Defines a session default name for a volume catalog VOLUME Defines session default for a node, volume, or subvolume name of a disk file ID Guardian User’s Guide —425266-001 10- 4...
Page 179: Tape Processing Modes
The system unloads any mounted labeled tape. b. The operator mounts the tape to be used. c. The operator must ensure that the correct tape is mounted since the system does not check the tape. Guardian User’s Guide —425266-001 10- 5...
Page 180: Using Labeled Tapes In Lp Mode
The comment you included in the DEFINE MOUNTMSG attribute 4. You, or an operator, should mount the tape TV0005. The system uses automatic volume recognition to identify the tape so your application can continue processing. Guardian User’s Guide —425266-001 10- 6...
Page 181: Using Unlabeled Tapes In Nl Mode
If your application allows time for you or an operator to mount a tape, mount the tape on the specific tape drive ($TAPE2) when your application requests it. Your application can then continue processing. Guardian User’s Guide —425266-001 10- 7...
Page 182: Bypassing Label Protection In Blp Mode
For BLP mode, specify LABELS BYPASS and the name of the tape drive for DEVICE. This example shows a TAPE DEFINE named =BYPASS-JOB for BLP mode: 30> ADD DEFINE =BYPASS-JOB, CLASS TAPE, DEVICE $DR2, & 30> &MOUNTMSG "HIGH-PRIORITY! Call when finished" Guardian User’s Guide —425266-001 10- 8...
Page 183: Tape Define Attributes
Type of tape; for labeled tapes, the label processing mode OWNER Owner ID in the VOL1 label for IBM labeled tapes only MOUNTMSG Mount message to be displayed with the system mount message or tape drive use request Guardian User’s Guide —425266-001 10- 9...
Page 184: Common Labeled Tape Activities
---------- ------ ---- ------ ----- ---- ------------ $TAPE1 INUSE TT0046 ASSIGNED ANSI \SKY.$BURT $TAPE2 INUSE TT0047 ASSIGNED ANSI \SKY.$SID The fields in this display are explained in the DSM/Tape Catalog Operator Interface (MEDIACOM) Manual. Guardian User’s Guide —425266-001 10 -10...
Page 185 Table 19-2, SCF Object States, on page 19-6 for more information about the possible states of tape drives and other devices. For complete information about SCF, see the SCF Reference Manual for G-Series Releases. Guardian User’s Guide —425266-001 10 -11...
Page 186: Setting A Default Tape Drive
The effect of the TAPEDRIVE command is valid only for the current session of MEDIACOM. Example 1. To make $TAPE1 the default drive with MEDIACOM, enter: MC> TAPEDRIVE $TAPE1 Guardian User’s Guide —425266-001 10 -12...
Page 187: Taking Down And Bringing Up A Tape Drive
1. Log on as a super-group user (255,n). 2. Start the tape drive from a stopped state: > SCF START TAPE $tape Example 1. Log on as a super-group user (255,n). 2. Enter: > SCF START TAPE $TAPE1 Guardian User’s Guide —425266-001 10 -13...
Page 188: Handling Labeled Tape Messages And Requests
To direct labeled-tape messages to a console other than the operator console with MEDIACOM, log on as a super-group user (255,n) and enter at that terminal: > MEDIACOM ALTER CONSOLE, DEVICE terminal-name Guardian User’s Guide —425266-001 10 -14...
Page 189: Responding To Messages And Requests
All labeled-tape messages that have a sequence number require some action from you. Sequence numbers are used in the MEDIACOM ACCEPT TAPEMOUNT and REJECT TAPEMOUNT commands. Labeled-tape messages are described in the Operator Messages Manual. Guardian User’s Guide —425266-001 10 -15...
Page 190 If the $ZSVR process terminates because of a fatal internal error: 1. Make a copy of the SAVEABEND file using the FUP DUP command. Guardian User’s Guide —425266-001 10 -16...
Page 191 If the tape you mount matches the tape requested, this informational message appears: $ZSVR: STATUS 1504 - vid TAPE OPENED ON $tape-device If the system does not accept the tape, you get an error message. Guardian User’s Guide —425266-001 10 -17...
Page 192 WITH RING | NO RING WITH RING indicates that the tape should be write-enabled; NO RING indicates that the tape should be write-protected. Guardian User’s Guide —425266-001 10 -18...
Page 193 REJECT TAPEMOUNT command. When you get a request to use a particular tape drive, you must accept or reject the request. The job making such a request cannot open the drive without your permission. Guardian User’s Guide —425266-001 10 -19...
Page 194 You also use the ACCEPT TAPEMOUNT command when a mounted tape cannot be read. If it is appropriate to use such a tape, the ACCEPT TAPEMOUNT command gives permission to use that tape as an unlabeled tape. Guardian User’s Guide —425266-001 10 -20...
Page 195 $ZSVR: seq UNKNOWN TAPE ON $tape, ACCEPT OR MOUNT CORRECT TAPE TO PROCEED is the 4-digit message sequence number that identifies this request. $tape is the tape drive on which the unrecognized tape is mounted. Guardian User’s Guide —425266-001 10 -21...
Page 196: Creating And Modifying Labeled Tapes
MC> ADD TAPELABEL, vid | ( vid , vid1, vid2 ) , LABELS IBM , TAPEDRIVE $tapedrive-name The system opens the tape drive in BLP (bypass label processing) mode and displays: $TAPE: not ready: 4. Mount the tape on the selected tape drive. Guardian User’s Guide —425266-001 10 -22...
Page 197 1600 bits per inch (bpi): MC> ADD TAPELABEL ABC123, TAPEDRIVE $TAPE, NOUNLOAD, DENSITY 1600 $TAPE: not ready: (Mount the tape and ready the drive; press Return.) Guardian User’s Guide —425266-001 10 -23...
Page 198: Displaying Tape Label Information
ANSI format. IBM tapes can have two HDR1 records; the second one is the one to use. NONSTANDARD LABELED TAPE: Followed by the first 80 bytes of the first record. Guardian User’s Guide —425266-001 10 -24...
Page 199: Relabeling A Tape And Removing A Tape Label
STATUS 2503 - VOLUME old-vid NEW LABEL new-vid The relabeling operation changes the volume serial identification number of standard labeled tapes. Examples: Relabeling Standard Labeled Tapes To relabel an ANSI-format standard labeled tape, enter: MC> ADD TAPELABEL, NEWNAME ABC123,CDE123,TAPEDRIVE $TAPE Guardian User’s Guide —425266-001 10 -25...
Page 200: Setting Whether Tapes Are Unloaded After Labeling
Clearing NOUNLOAD can be useful when you are labeling many tapes. To display the current NOUNLOAD state by using MEDIACOM: MC> ENV To set NOUNLOAD with MEDIACOM: MC> UNLOAD OFF To clear NOUNLOAD with MEDIACOM: MC> UNLOAD ON Guardian User’s Guide —425266-001 10 -26...
Page 201 TAPELABEL command and its options LABELS IBM, NEWNAME, and SCRATCH, and the INFO TAPELABELS command. The UNLOAD ON command affects only the current MEDIACOM process and is active until you change it with the UNLOAD command, OFF option. Guardian User’s Guide —425266-001 10 -27...
Page 202: Premounting And Scratching Labeled Tapes
If the tape volume is not expired, and that volume was specifically requested by a user, check with the user. The wrong tape might have been requested, or you might have to scratch that tape with the MEDIACOM ADD TAPELABEL command, SCRATCH option. Guardian User’s Guide —425266-001 10 -28...
Page 203: Scratching A Labeled Tape
MC> ADD TAPELABEL (V11233, V11244, V20055), SCRATCH When the ADD TAPELABEL, SCRATCH operation successfully ends, MEDIACOM responds with a message such as: TAPE VOLUME V11233 SCRATCHED TAPE VOLUME V11244 SCRATCHED TAPE VOLUME V20055 SCRATCHED Guardian User’s Guide —425266-001 10 -29...
Page 204: Compressing A Tape Dump File
$DATA.DUMPS.CPU1, enter: > COPYDUMP $TAPE2, $DATA.DUMPS.CPU1 Compressing a Disk Dump File To compress the disk dump file $BAS10.DUMPS.CPU3 into the disk file $BAS10.CDUMPS.CPU3, enter: > COPYDUMP $BAS10.DUMPS.CPU3, $BAS10.CDUMPS.CPU3 Guardian User’s Guide —425266-001 10 -30...
Page 205: Solving Common Tape Subsystem Problems
The DEFINE you specified The specified DEFINE Correct the DEFINE name could not be found, resulting in name does not exist. used in syntax or supply a error 198. DEFINE of the given name. Guardian User’s Guide —425266-001 10 -31...
Page 206 A tape fails to respond to a A tape with an Use a different tape. BACKUP command. inappropriate label type was mounted in error. Guardian User’s Guide —425266-001 10 -32...
Page 207: Backing Up And Restoring Disk Information
Using Labeled Tapes With Backup and Restore 11-19 Duplicating Backup Tapes With Backcopy 11-23 For more information, including the complete syntax, guidelines, and more examples of using Backup, Restore, and Backcopy, see the Guardian Disk and Tape Utilities Reference Manual. Guardian User’s Guide —425266-001 11- 1...
Page 208: Why Use Backup And Restore
(255,255) can use this mode. Backcopy cannot duplicate backup tapes created in volume mode. This guide discusses file mode operations. For information about volume mode operations, see the Guardian Disk and Tape Utilities Reference Manual. Guardian User’s Guide —425266-001 11- 2...
Page 209: Backing Up Your Files
To cancel the Backup operation, enter CTRL-Y at the “Not ready?” prompt; you will exit the Backup program and return to the TACL program. Guardian User’s Guide —425266-001 11- 3...
Page 210: Specifying A File-Set List For Backup
These characters cannot be used in a system name or for the volume identifier ($) or field separator (.). Also, some Backup command options do not allow these characters; see the Guardian Disk and Tape Utilities Reference Manual. Examples of file sets are: $MYVOL.EXTRA.INFO...
Page 211: Using A Qualified File-Set List
(A simple file-set list does not include a qualifier.) You can specify a qualifier only once for each file-set list. For a detailed description of file-set qualifiers, see the Guardian Disk and Tape Utilities Reference Manual.
Page 212: Using Run Options In A Backup Command
528 characters for a command that continues beyond one command line. For example, this command starts a Backup process that uses the parameters in the IN command file FRED.FLIST and sends its listing to the OUT file BRECD. With the Guardian User’s Guide —425266-001 11- 6...
Page 213: Table 11-2. Backup Command Options
The Backup command accepts one or more command options. Some of the common options, such as DENSITY, NOT, LISTALL, and PARTIAL, are described here. All options are described in the Guardian Disk and Tape Utilities Reference Manual. Table 11-2. Backup Command Options (page 1 of 2)
Page 214 Gives new volume and subvolume names for files on tape VOLUMEMODE Performs volume-mode back up (restricted to super ID 255,255) Guardian User’s Guide —425266-001 11- 8...
Page 215 In the above example, two attempts to copy files resulted in errors. The error number in parentheses identifies a file-system error. For example, error 48 is a security violation; the user did not have read access to that file. Guardian User’s Guide —425266-001 11- 9...
Page 216 To omit some files from the backup, specify them with the NOT option. For example, this command backs up all files in subvolume $CAFFE.MED except MITSLAG and MOKA: 5> VOLUME $CAFFE.MED 6> BACKUP $TAPE1, * , NOT (MITSLAG, MOKA) Guardian User’s Guide —425266-001 11 -10...
Page 217 Each time you back up files, use the PARTIAL option to specify the date and time of the previous backup. This lets you maintain current backup copies of all your files without copying files that are already backed up. Guardian User’s Guide —425266-001 11 -11...
Page 218: Restoring Your Files
One or more file-set lists specifying the files you want to restore. command-option Restore command option. See Table 11-3 on page 11-14. This example shows a Restore command: 10> RESTORE /OUT LIST, NOWAIT/ $TAPE1, & (*, $DATA.USER.*), LISTALL Guardian User’s Guide —425266-001 11 -12...
Page 219: Using Run Options In A Restore Command
528 characters for a command that continues beyond one command line. Using Restore Command Options Restore accepts one or more command options. Some of the common options are described here. All options are described in the Guardian Disk and Tape Utilities Reference Manual. Guardian User’s Guide —425266-001...
Page 220: Table 11-3. Restore Command Options
Lets users specify between 20 and 100 lines per page to be displayed on a utility listing (default value is 60) PART Renames secondary partitions of partitioned files PARTOF Restores only those partitions whose primary partitions reside on a specific volume Guardian User’s Guide —425266-001 11 -14...
Page 221 10> RESTORE /OUT LIST/ $TAPE1, *.*.*, LISTONLY, NOUNLOAD Restore sends the listing to the file LIST. The NOUNLOAD option keeps your tape online and ready to begin a restore operation after the listing is finished. Guardian User’s Guide —425266-001 11 -15...
Page 222 LINZER and PETIT4 Keeps any files currently on disk that have the same name as tape files specified in the Restore command file-set list Gives you ownership of the restored files Guardian User’s Guide —425266-001 11 -16...
Page 223 If you use the MAP NAMES or VOL option and your backup tape has two (or more) files with the same file name, only the last file with the same name is restored. For example, consider this file-set list: ($TOLSTOY.NOVELS.BIG1, $PROUST.RTP.BIG1) Guardian User’s Guide —425266-001 11 -17...
Page 224 Because files are stored on tape in alphabetical order, the data in $PROUST.RTP.BIG1 is first restored to $GIANT.NOVELS.BIG1 but then is purged and overwritten with the data in $TOLSTOY.NOVELS.BIG1. After the restore finishes, $GIANT.NOVELS.BIG1 contains only the data from the $TOLSTOY.NOVELS.BIG1 tape file. Guardian User’s Guide —425266-001 11 -18...
Page 225: Using Labeled Tapes With Backup And Restore
Six-byte tape volume ID for the backup tape, or SCRATCH to indicate that any scratch tape is acceptable for the backup tape For more information about DEFINEs and labeled tapes, see Section 6, Creating and Using DEFINEs, and Section 10, Using Labeled Tapes. Guardian User’s Guide —425266-001 11 -19...
Page 226: Using A Tape Define With Backup
Backup operation can be mounted, in order, on any available drive. The system checks the DEFINE attributes with the mounted tape. The Backup operation starts after the correct tape is mounted (in this case, a labeled backup tape with volume ID TP022). Guardian User’s Guide —425266-001 11 -20...
Page 227 5Feb1998 9:33 CUCU DIST 5364 10Feb1998 17:05 CUCU INTERN1 75234 12Dec1998 20:21 CUCU TRFTEST 7502 10Feb1998 17:25 CUCU Tape volumes used: TP022, TP023 Summary Information Files dumped = 8 Files not dumped = 0 Guardian User’s Guide —425266-001 11 -21...
Page 228: Using A Tape Define With Restore
4. Mount the first tape in the set (with volume ID TP022) on tape drive $TAPE0. The Restore operation begins. When the restoration of TP022 is finished, Restore prompts for the second tape, if necessary. The second tape must also be mounted on $TAPE0. Guardian User’s Guide —425266-001 11 -22...
Page 229: Duplicating Backup Tapes With Backcopy
You enter a Backcopy command at the TACL prompt or from a command file: BACKCOPY [ / run-options / ] source-tape, dest-tape, *.*.* [ , command-option ] [ , command-option ]... run-options One or more run options. See the RUN command in the TACL Reference Manual. Guardian User’s Guide —425266-001 11 -23...
Page 230: Table 11-5. Backcopy Command Options
The individual reels are not interchangeable; only the whole duplicate tape set is interchangeable with the original set. Guardian User’s Guide —425266-001 11 -24...
Page 231: Backcopy Examples
This Backcopy command makes one copy of an unlabeled tape on $TAPE1. The destination tape is labeled because the TAPE DEFINE defines it. 12> ADD DEFINE =Output, CLASS TAPE, LABELS BACKUP, & 12> &VOLUME SCRATCH 13> BACKCOPY $TAPE1, =Output, *.*.* Guardian User’s Guide —425266-001 11 -25...
Page 232 Backing Up and Restoring Disk Information Backcopy Examples Guardian User’s Guide —425266-001 11 -26...
Page 233 Peruse and Spoolcom to manage spooler jobs and the spooler, respectively: Section 12, Introduction to the Spooler Section 13, Managing Your Spooler Jobs Using Peruse Section 14, Performing Routine Spooler Operations Using Spoolcom Section 15, Managing the Spooler Using Spoolcom Guardian User’s Guide —425266-001...
Page 234 Part IV. Using the Spooler and Its Utilities Guardian User’s Guide —425266-001...
Page 235 Peruse, which lets all users view and control their own print jobs Topic Page Why Use the Spooler? 12-2 Spooler Components 12-2 Spooler Jobs and Job Attributes 12-4 Printer Attributes 12-6 Routing Structure 12-8 Printing To the Spooler 12-10 Guardian User’s Guide —425266-001 12- 1...
Page 236: Why Use The Spooler
Spoolcom Utility that lets a system operator create, initialize, and get status for spooler components, set job attributes, and start a printer that is offline. See Section 14, Performing Routine Spooler Operations Using Spoolcom. Guardian User’s Guide —425266-001 12- 2...
Page 237: Figure 12-1. How Spooler Components Interact
4. The print process reads the job from disk and writes the job to the printer. Peruse obtains the job information from the supervisor or lets you examine data on the disk. Spoolcom permits system operators to modify the status of spooler components. .CDD Guardian User’s Guide —425266-001 12- 3...
Page 238: Spooler Jobs And Job Attributes
You can put a job on hold at any time. If the job is in READY or PRINT, it is placed on hold immediately. If it is in OPEN, it is placed on hold after the job is completely spooled. Guardian User’s Guide —425266-001 12- 4...
Page 239: Figure 12-2. Life Cycle Of A Spooler Job
Delete: If the hold-after-printing flag is not set, the job is deleted after it finishes printing. You can also delete a job from the spooler using a specific request. If the job is printing when you make that request, the job immediately stops printing and is deleted. .CDD Guardian User’s Guide —425266-001 12- 5...
Page 240: Printer Attributes
For each printer, the spooler maintains a queue, which is a list of the jobs to be printed on the printer. The job at the head of the queue is the next job to be printed. Guardian User’s Guide —425266-001 12- 6...
Page 241: Figure 12-3. Sample Header Page
EEEEEEEEEEE EEEEEEEEEEE TTTTTTTTTTT 3333333333 TTTTTTTTTTT 333333333333 ########### ########### HHHHHHHHHHH 3333 HHHHHHHHHHH 3333 ########### ########### 333333333333 333333333 TTTTTTTTTTT 3333333333 TTTTTTTTTTT 333333333333 HHHHHHHHHHH 3333 HHHHHHHHHHH 3333 333333333333 333333333 Date: 03 June 99, 14:01:07 JOB: 1919 FORM: Guardian User’s Guide —425266-001 12- 7...
Page 242: Routing Structure
TFORM output to $S.#DEFAULT: 10> TFORM / IN DAYREPRT, OUT $S / 11> TFORM / IN DAYREPRT, OUT $S.#DEFAULT / Ask your system manager which physical printer or printers are associated with #DEFAULT on your system. Guardian User’s Guide —425266-001 12- 8...
Page 243: Implicit Route Creation
Jobs routed to #Y print on both LP3 and LP4. Jobs routed to #Z stay in the spooling system indefinitely. They can be printed by changing the location. Connections are established or changed by the system operator. .CDD Guardian User’s Guide —425266-001 12- 9...
Page 244: Printing To The Spooler
This is a valid TFORM command that does not specify the location: 12> TFORM /IN MYFILE, OUT $S/ In this case, the job is sent to #DEFAULT and is printed on one of the printers associated with the #DEFAULT group name. Guardian User’s Guide —425266-001 12 -10...
Page 245: Sending Output To A Spool Define
First, ensure that DEFINEs are enabled for your TACL process (that is, the DEFMODE setting is ON): 10> SHOW DEFMODE Defmode If the DEFMODE is set to OFF, enter a SET DEFMODE ON command. Guardian User’s Guide —425266-001 12 -11...
Page 246 PERUSE - T9101D10 - (08JUN92) SYSTEM \WEST Copyright Tandem Computers Incorporated 1978, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1991, 1992 BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT READY 63 #LLP JANUARY PAYROLL Guardian User’s Guide —425266-001 12 -12...
Page 247 TACL program to delete it when you log off), you can delete it as shown below: 22> DELETE DEFINE =PAY-RUN 2. Enter an INFO DEFINE command for =PAY-RUN. The TACL program displays this message: 23> INFO DEFINE =PAY-RUN, DETAIL Define Name =PAY-RUN DEFINE does not exist"" Guardian User’s Guide —425266-001 12 -13...
Page 248 Introduction to the Spooler Sending Output to a SPOOL DEFINE Guardian User’s Guide —425266-001 12 -14...
Page 249 13-2 Entering Peruse Commands 13-3 Peruse Commands 13-6 Using Peruse With TFORM 13-7 Using Peruse With TAL 13-9 Using Peruse With Files 13-12 For more information about Peruse, see the Spooler Utilities Reference Manual. Guardian User’s Guide —425266-001 13- 1...
Page 250: Managing Your Spooler Jobs Using Peruse
HOLD The hold-before-printing flag is on. PRINT The job is currently printing. PAGES Number of pages in each job. OPEN jobs are being collected, so the number of pages is not known. Guardian User’s Guide —425266-001 13- 2...
Page 251: Entering Peruse Commands
If you know the job number, you can also enter these commands at the TACL prompt. A semicolon (;) must precede each Peruse command, as shown above. The spaces before and after the semicolons are optional. 10> PERUSE ; J 123 ; DEL Guardian User’s Guide —425266-001 13- 3...
Page 252: Declaring The Current Job
BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT OPEN #DEFAULT REPORTS J 1435 READY 30 #HOLD JANUARY _JOB JOBFILE _JOB BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT FILE $DISK2.SUBVOL.JOBFILE OPEN #DEFAULT REPORTS J 1435 READY 30 #HOLD JANUARY Guardian User’s Guide —425266-001 13- 4...
Page 253: Displaying A Job
If Peruse is listing lines from a job, pressing Break stops the listing and redisplays the Peruse prompt (_). If the STATUS command is executing, pressing Break stops its execution and redisplays the Peruse prompt (_). Guardian User’s Guide —425266-001 13- 5...
Page 254: Peruse Commands
Sets the first column to be displayed by LIST STATUS Monitors and displays the status of spooled jobs UNLINK Separates a spooler job from a spooler batch job VOLUME Sets the default volume and subvolume Guardian User’s Guide —425266-001 13- 6...
Page 255: Using Peruse With Tform
Because all TFORM errors begin with the string *** ERRORS, use the FIND command to locate this string, and then use the LIST command to display the error: _FIND /*** ERRORS/ *** ERRORS, PAGE 1 *** _LIST * \outlength 80 LINE 1 - COMMAND ERROR Guardian User’s Guide —425266-001 13- 7...
Page 256: Altering Job Attributes
#HT09 MEMO OPEN #LP3 MEMO The LIST command creates job 560 and leaves job 534 unchanged. The C option preserves form-control information for job 560, such as overprinting of lines for boldface and underscores. Guardian User’s Guide —425266-001 13- 8...
Page 257: Using Peruse With Tal
To redisplay the Peruse prompt at this point, press Break: _STATUS BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT J 135 OPEN #HOLD TAL USER (BEEP) BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT JC135 READY 130 #HOLD TAL USER (BREAK key) Guardian User’s Guide —425266-001 13- 9...
Page 258: Finding Tal Errors
PERUSE - T9101D10 - (08JUN92) SYSTEM \WEST Copyright Tandem Computers Incorporated 1978, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1990, 1991 BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT READY 130 #HOLD TAL USER Guardian User’s Guide —425266-001 13 -10...
Page 259 To print this job, use the LOC command to send it to a location associated with an actual printer. When your job prints, Peruse displays the status as PRINT: _LOC #LP; JOB BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT PRINT 130 TAL USER _EXIT Guardian User’s Guide —425266-001 13 -11...
Page 260: Using Peruse With Files
To copy a spooler job generated by the COBOL85 compiler to a spooler job file: 1. Generate the spooler job with the COBOL85 compiler and send the job to a holding location to prevent the job from printing: 9> COBOL85 / IN SRCFILE, OUT $S.#HOLD / COBJECT Guardian User’s Guide —425266-001 13 -12...
Page 261: Copying A Spooler Job To An Edit File
SYSTEM \WEST Copyright Tandem Computers Incorporated 1978, 1982, 1983, 1984, 1985, 1986, 1987, 1988, 1989, 1990, 1991 BATCH STATE PAGES COPIES PRI HOLD LOCATION REPORT READY 2 #LAZR LETTER READY 16 #HOLD USERS COBOL Guardian User’s Guide —425266-001 13 -13...
Page 262: Copying A Spooler Job File To The Spooler
$S.#LAZR. The original REPORTL file remains unchanged in your subvolume. _JOB REPORTL _LIST /OUT $S.#LAZR/ ALL You can also enter the above commands from the TACL prompt: 10> PERUSE ; JOB REPORTL ; LIST /OUT $S.#LAZR/ ALL Guardian User’s Guide —425266-001 13 -14...
Page 263: Performing Routine Spooler Operations Using Spoolcom
Displaying the Status of Spooler Components 14-8 Monitoring Spooler Processes 14-9 Draining the Spooler 14-11 Starting a Drained Spooler 14-12 Stopping the Spooler 14-17 Controlling Print Devices 14-19 Controlling Jobs 14-20 Controlling Locations 14-24 Solving Common Spooler Problems 14-26 Guardian User’s Guide —425266-001 14- 1...
Page 264: Entering Spoolcom Commands
2. Enter a Spoolcom command at the prompt. After executing the command (or displaying an error message if the command is invalid), Spoolcom redisplays its prompt and waits for another command. 3. To terminate Spoolcom, enter the EXIT command or CTRL-Y. Guardian User’s Guide —425266-001 14- 2...
Page 265: Entering Commands From A Command File
Subcommand that places the job in the hold state (to rename a job report, you must first put the job on hold) REPORT Subcommand that specifies the report name TAL COMPILE for the job START Subcommand that places the job back in the printer queue Guardian User’s Guide —425266-001 14- 3...
Page 266: Spoolcom Command Summary
Designates a special control job in the spooler as a font job, containing printing instructions for programmable printers like vertical form control (VFC) commands. Also displays status of spooler jobs associated with specific fonts. Guardian User’s Guide —425266-001 14- 4...
Page 267 Obtains a spooler memory dump while it is running. MGRACCESS Enables or disables manager access for the spooler. START Starts the spooler collectors and print processes. STATUS Displays the status of the spooler subsystem. Guardian User’s Guide —425266-001 14- 5...
Page 268: Listing Printers And Checking Their Status
A file-system error occurred on the device while a job was printing. File- system error messages are listed in the Operator Messages Manual and are described more fully in the Guardian Procedure Errors and Messages Manual. Guardian User’s Guide —425266-001...
Page 269: Restarting A Printer
FORM: OWNER PAGES WAIT FORM 008,013 00:02:32+ 008,013 00:03:39+ _EXIT A plus sign (+) following an estimated printing time indicates that the printer must come back online before the print time has any meaning. Guardian User’s Guide —425266-001 14- 7...
Page 270: Displaying The Status Of Spooler Components
For example, to find the location assigned to printer #HT4 and the jobs in its queue: 15> SPOOLCOM LOC #HT4 LOCATION FLAGS DEVICE FONT #HT4.DEFAULT $HT4 LOCATION DEVICE COPY PAGE #HT4.DEFAULT $HT4 PRINT 1 #HT4.DEFAULT $HT4 #HT4.DEFAULT $HT4 Guardian User’s Guide —425266-001 14- 8...
Page 271: Monitoring Spooler Processes
This example shows that the three collector processes, $S, $S1, and $S2, are active and none is approaching a full state. If the %FULL column shows any collector process approaching 90 percent capacity, you should delete jobs from the collector in question. Guardian User’s Guide —425266-001 14- 9...
Page 272: Monitoring Spooler Print Processes
When the supervisor determines that a print process is not responding correctly, it places the print process into the procerror state, and you receive an error message. See the Operator Messages Manual for information on spooler print process error messages. Guardian User’s Guide —425266-001 14 -10...
Page 273: Draining The Spooler
Because there is no supervisor with which Spoolcom can communicate, you cannot obtain information about a dormant spooler. Guardian User’s Guide —425266-001 14 -11...
Page 274: Starting A Drained Spooler
Spoolcom). 4. Start the spooler: > SPOOLCOM SPOOLER, START Note. If you are warmstarting the spooler after migrating from one system version to another, see the migration considerations in the Spooler Utilities Reference Manual. Guardian User’s Guide —425266-001 14 -12...
Page 275: Coldstarting A Drained Spooler
4. Create the data files in which collectors store jobs: > FUP CREATE data-filename [ , create-param ]... Create one data file for each collector. See Guidelines on page 14-16 for information on determining the extent size of the data file. Guardian User’s Guide —425266-001 14 -13...
Page 276 14-1. 10. Specify locations and connect locations to devices: ) LOC [ #group].dest , DEV [ $device ] The Spoolcom LOC command is described in Table 14-1. 11. Start the spooler: ) SPOOLER, START Guardian User’s Guide —425266-001 14 -14...
Page 277 COMMENT -- The spooler is now in the cold state; the COMMENT supervisor is running. The next command runs COMMENT SPOOLCOM, specifying a spooler "configuration COMMENT file" to initialize the spooler: SPOOLCOM / IN $SYSTEM.SPLUTIL.SPLCONF / COMMENT -- Start the spooler: SPOOLER, START Guardian User’s Guide —425266-001 14 -15...
Page 278: Guidelines
When you configure the collector (Step 6 of the coldstart procedure), use the collector attribute: UNIT unit-size to specify the amount of space allocated for each unit needed by the collector. A unit is a 512-word block. unit-size multiplied by 1024 is the number of bytes Guardian User’s Guide —425266-001 14 -16...
Page 279: Stopping The Spooler
If a SPOOLER, DRAIN operation does not succeed (that is, spooler activity does not stop), you must stop the collectors, print processes, and spooler supervisor with the TACL STOP command. Guardian User’s Guide —425266-001 14 -17...
Page 280 The collectors are $S, $S1, and $S2. The print processes are $FPLP, $SPL2, $SPLP, and $SPLX. To stop, warmstart, and check the status of the spooler: 1. Exit Spoolcom: ) EXIT 2. Stop the supervisor: > STOP $SPLS Guardian User’s Guide —425266-001 14 -18...
Page 281: Controlling Print Devices
Listing Printers and Checking Their Status on page 14-6 for more information about using the Spoolcom DEV command. To start a print device, enter: ) DEV $device, START This command causes an offline device to become online. Guardian User’s Guide —425266-001 14 -19...
Page 282: Controlling Jobs
) JOB job-number, HOLD To remove a job from the hold state, enter: ) JOB job-number, START To make a job print after or ahead of other jobs, enter: ) JOB job-number, SELPRI selection-priority Guardian User’s Guide —425266-001 14 -20...
Page 283 MGRACCESS ON after warmstarting the spooler. To determine whether manager access is enabled, enter: > SPOOLCOM SPOOLER, STATUS DETAIL To enable manager access, enter: > SPOOLCOM SPOOLER, MGRACCESS ON To disable manager access, enter: > SPOOLCOM SPOOLER, MGRACCESS OFF Guardian User’s Guide —425266-001 14 -21...
Page 284 1. Determine all the locations that are associated with the down device: ) DEV \SAGE.$C, XREF A listing similar to this is displayed on your terminal: DEVICE LOCATION PRINT PROCESS \SAGE.$C #BIRD6.DEFAULT $SPLX \SAGE.$C #EBIRD.DEFAULT $SPLX \SAGE.$C #EBIRD1.DEFAULT $SPLX \SAGE.$C #TAF3.DEFAULT $SPLX Guardian User’s Guide —425266-001 14 -22...
Page 285: Job States
Hold (HLD) The job has been placed on hold in order to prevent it from printing or in order to change its attributes. Print (PRT) The job is being printed. Guardian User’s Guide —425266-001 14 -23...
Page 286: Controlling Locations
LOCATION #group.dest of the location whose status is being displayed. FLAGS Displays a B if broadcast is on. DEVICE Device associated with that location, if any. FONT Defines a special-control job in the spooler. Guardian User’s Guide —425266-001 14 -24...
Page 287 To break the connection between the location #BIRDB.DEFAULT and any device with which it is associated, enter: ) LOC #BIRDB.DEFAULT, DEV Deleting a Location For the location #BIRD1.DEFAULT: 1. Delete any current jobs from #BIRD1.DEFAULT. 2. Delete the location: ) LOC #BIRD1.DEFAULT, DELETE Guardian User’s Guide —425266-001 14 -25...
Page 288: Solving Common Spooler Problems
Check for error messages that might indicate what happened to the spooler process. b. Use the TACL PPD command to check whether any collectors or print processes are still running: > PPD $collector > PPD $print-process Guardian User’s Guide —425266-001 14 -26...
Page 289 To use the procedure described above to free a hung spooler: 1. Check the status of the supervisor: > SPOOLCOM This startup banner tells you that the supervisor is still running. SPOOLCOM - T9101D20 - (08JUN93) SYSTEM \AMBER Guardian User’s Guide —425266-001 14 -27...
Page 290: Freeing A Hung Spooler: Jobs Do Not Print
Drain the device: ) DEV $device-name, DRAIN c. Restart the device: ) DEV $device-name, START 4. Check the device: ) DEV $device-name If problems continue to occur, escalate this matter to your operations management. Guardian User’s Guide —425266-001 14 -28...
Page 291: Clearing A Print Process Error State
A listing such as this is sent to your home terminal: SPOOL SUPERVISOR: $SPLS JOBS : 1770 OPEN JOBS SUPERVISOR OPENERS : 10 DEVICE QUEUE NODES : 423 RECEIVE QUEUE ENTRIES JOBS CURRENTLY PRINTING 2. Check the print processes: ) PRINT Guardian User’s Guide —425266-001 14 -29...
Page 292: Clearing A Nonprintable Job
This procedure can help you to determine the owner of the job in question and to place the problem job on hold. To clear a nonprintable job: 1. Check the physical status of the printer. Guardian User’s Guide —425266-001 14 -30...
Page 293 ) DEV $LASER1 A listing such as this is sent to your home terminal: DEVICE STATE FLAGS PROC FORM $LASER1 DEV ERROR 100 $SPLX 3. Determine the current print job: ) DEV $LASER1, STATUS DETAIL Guardian User’s Guide —425266-001 14 -31...
Page 294 The USERS program displays information such as this: GROUP . USER I.D. # SECURITY DEFAULT VOLUMEID SALES . BONNIE 008,001 NUNU $DATA1.BONNIEF 5. Reenter Spoolcom and place the job on hold: > SPOOLCOM ) Job 88, HOLD Guardian User’s Guide —425266-001 14 -32...
Page 295: Clearing A Paper Jam
DEV, SKIP subcommand. Example: Logically Cleaing a Paper Jam 1. Check the physical status of the printer $LASER1. 2. Check the logical status of the printer: > SPOOLCOM ) DEV $LASER1 Guardian User’s Guide —425266-001 14 -33...
Page 296: Recovering From An Invalid (Job -1) State
If the Job -1 condition has been cleared, you can start the device: ) DEV $device, START If the Job -1 condition persists, drain and warmstart the spooler. Example: Restoring an Invalid Device 1. Check the device status. ) DEV Guardian User’s Guide —425266-001 14 -34...
Page 297: Diagnosing Unusual Problems
To perform a memory dump of the supervisor’s memory, enter: > SPOOLCOM ) SPOOLER, DUMP filename where filename is the name of a disk file the spooler creates for the purpose of this operation. Guardian User’s Guide —425266-001 14 -35...
Page 298: Problem-Solving Summary
Reenter syntax correctly. entered. The spooler subsystem is Drain the spooler and perform a hung. warmstart. If jobs still cannot be printed, notify your management; a memory dump of the supervisor process might be needed. Guardian User’s Guide —425266-001 14 -36...
Page 299 The job command fails to take Check with your management: a effect (jobs hang). memory dump of the supervisor process might be needed. Guardian User’s Guide —425266-001 14 -37...
Page 300 Performing Routine Spooler Operations Using Problem-Solving Summary Spoolcom Guardian User’s Guide —425266-001 14 -38...
Page 301 These tasks are usually handled by operations management personnel. You should be familiar with general Compaq NonStop™ Kernel system operations, spooler operations, and the spooler operations terms and concepts defined in Section 14, Performing Routine Spooler Operations Using Spoolcom. Guardian User’s Guide —425266-001 15- 1...
Page 302: Managing The Spooler Using Spoolcom
The default name is $SYSTEM.SYSTEM.PSPOOL. Replace the file if you name want to run your own print process. Supervisor The name is $process and has up to four alphanumeric characters. The process name first character is a letter. The default name is $SPLS. Guardian User’s Guide —425266-001 15- 2...
Page 303: Managing Collector Processes
) COLLECT $collector-name, START Example This example is based on these collector attributes: The data file name is $SPOOL.SPOOLER.S2DATA. The backup CPU is processor 2. The processor that is to run this collector is CPU 3. Guardian User’s Guide —425266-001 15- 3...
Page 304: Displaying Collector Attributes
(default is 4). You should set the unit size of a collector once and not change it. See the Spooler Utilities Reference Manual. Displaying Collector Attributes To display your collector’s current attributes, enter: ) COLLECT $collector-name, STATUS DETAIL Guardian User’s Guide —425266-001 15- 4...
Page 305: Modifying Collector Attributes
To modify a collector attribute by changing the backup processor from CPU 2 to CPU 5: > SPOOLCOM ) COLLECT $S2, DRAIN ) COLLECT $S2, BACKUP 5 ) COLLECT $S2, START Deleting a Collector 1. Drain the collector: ) COLLECT $collector-name, DRAIN Guardian User’s Guide —425266-001 15- 5...
Page 306: Managing Print Processes
SPOOLCOM PRINT, STATUS command. To add a print process to an existing spooler, then associate a device with it: 1. Specify the print process parameters: > SPOOLCOM ) PRINT $process-name, FILE $SYSTEM.SYSTEM.name, CPU n Guardian User’s Guide —425266-001 15- 6...
Page 307: Displaying The Current Attributes Of A Print Process
A listing such as this is displayed on your home terminal: PRINT PROCESS: $SPLA STATE: ACTIVE LAST ERROR: NONE DEBUG: OFF INDEPENDENT: NO PROGRAM FILE: $SYSTEM.SYSTEM.PSPOOL CPU: 3 BACKUP: 2 PRIORITY: 128 PARM: 0 Guardian User’s Guide —425266-001 15- 7...
Page 308: Modifying Print Process Attributes
) DEV $LP1, DRAIN 4. Check the status of $LP1 to confirm it is offline: ) DEV $LP1 A listing such as this is displayed on your home terminal: DEVICE STATE FLAGS PROC FORM $LP1 OFFLINE $SPLA Guardian User’s Guide —425266-001 15- 8...
Page 309: Deleting A Print Process From The Spooler
Be sure to connect another print process to the devices before you start them again. Example To check the locations associated with print process $SPLB, drain the device connected to it, and delete $SPLB from the spooler: Guardian User’s Guide —425266-001 15- 9...
Page 310: Print Process Attributes
The processor that runs the print process; by default the same processor as the supervisor. DEBUG [ OFF ] Sets the Debug mode of the print process (default is Debug OFF). Print processes should never run in Debug mode on a production spooler. Guardian User’s Guide —425266-001 15 -10...
Page 311: Managing Print Devices
$device can be a virtual device, a process, a file, or the name of a device that is configured onto your system. (Use SCF LISTDEV to find out the names of all the devices configured onto your system.) $print-process is the name of the print process that controls the device. Guardian User’s Guide —425266-001 15 -11...
Page 312: Displaying Current Print Device Attributes
Displaying Current Print Device Attributes To display the current attributes of a print device, enter: ) DEV $device-name, STATUS DETAIL Example To display the current attributes of the device named $LP, enter: ) DEV $LP, STATUS DETAIL Guardian User’s Guide —425266-001 15 -12...
Page 313: Modifying Print Device Attributes
) DEV $PRINT, DRAIN ) DEV $PRINT, FORM LETTERH ) DEV $PRINT, START Now, only jobs that specify form LETTERH will print on this device; all other jobs sent to this device remain in the device queue. Guardian User’s Guide —425266-001 15 -13...
Page 314: Deleting A Print Device
To delete the printer named $LP1 from a running spooler by first draining it and then disconnecting it from its location, enter: ) DEV $LP1, DRAIN ) LOC #LP1.LP1, DEV ) DEV $LP1, DELETE Guardian User’s Guide —425266-001 15 -14...
Page 315: Print Device Attributes
This attribute is most commonly used when the device is loaded with special paper or ribbon. The default name is a blank form name. Guardian User’s Guide —425266-001 15 -15...
Page 316 STARTFF OFF, the default value, and STARTFF OFF ! cause these print processes to suppress a form feed at the start of each job. STARTFF has no meaning for PSPOOLB. Guardian User’s Guide —425266-001 15 -16...
Page 317: Managing Locations
) LOC #PRIN.CHAR, DEV $PRINT Displaying a Location’s Current Attributes To display the current attributes of a given location, enter: ) LOC #loc, STATUS DETAIL For more information about location attributes, see Table 15-6 on page 15-18. Guardian User’s Guide —425266-001 15 -17...
Page 318: Modifying Location Attributes
If you specify only the destination, the command refers to every group that has that destination in it. Example To modify location attributes by breaking the connection between the location #BIRD6 and any devices connected to that location, enter: ) LOC #BIRD6, DEV Guardian User’s Guide —425266-001 15 -18...
Page 319: Deleting A Location
These values should be the same as those specified in your coldstart command file for the maximum number of: Jobs that the spooler handles at any one time (num-of-jobs) Destinations and groups the routing structure contains (num-of-locations) Guardian User’s Guide —425266-001 15 -19...
Page 320 150 is the maximum number of devices for this spooler. 10 is the number of collectors and print processes for this spooler. > SPOOLCOM SPOOLER, DRAIN > SPOOL /IN $MKT.SPL.SPL, NAME $SPLS/ R,995,995,150,10,10 > SPOOLCOM SPOOLER, START Guardian User’s Guide —425266-001 15 -20...
Page 321: Part V. Security Features And Other Guardian Utilities
Part V. Security Features and Other Guardian Utilities This part of the guide contains information about the security features available through FUP and TACL, and instructions for using the Guardian utilities DSAP, Error, and VPROC: Section 16, Managing Users and Security...
Page 322 Part V. Security Features and Other Guardian Utilities Guardian User’s Guide —425266-001...
Page 323: Managing Users And Security
This section describes routine tasks to assist users of the Guardian environment. It also describes the security features of the Guardian environment as they apply to general (or application) users –...
Page 324: Your Responsibility To System Users
Managing Users and Security Your Responsibility to System Users Your Responsibility to System Users When overseeing Guardian operations on a NonStop™ Kernel system, you have certain responsibilities to the system users to ensure they have as few problems as possible: Keeping Current Depending on your company’s policies, when you arrive at work you might be expected...
Page 325 SALES.BONNIE (8,1) HAS BEEN ADDED TO THE USERID FILE. This command creates a new group named SALES, with the group ID 8, and also adds a new user named BONNIE, with user ID 1. Guardian User’s Guide —425266-001 16- 3...
Page 326: Changing Logon Defaults
For more information, see the Safeguard User’s Guide. If users report that they have forgotten their passwords, your operations manager or security administrator can help restore these users’ access to the system. Guardian User’s Guide —425266-001 16- 4...
Page 327: Deleting Users From The System
If they cannot perform this task, their managers might ask you to help clean up the subvolumes and files: 1. Run a Disk Space Analysis Program (DSAP) report on each user’s subvolumes on a specified disk volume: > DSAP $disk, BYSUBVOL USER group-number,user-number Guardian User’s Guide —425266-001 16- 5...
Page 328 Usage on page 9-14. Complete syntax, considerations, and examples for the DSAP program are in the Guardian Disk and Tape Utilities Reference Manual. For more information about FUP commands and considerations relating to their use, see the File Utility Program (FUP) Reference Manual.
Page 329: Determining Group And User Name And Number
USERS displays the same information shown in the previous example. Getting Information For All Users in a Group To get information for all users in the SALES group (group ID 8), enter either: > USERS SALES.* Guardian User’s Guide —425266-001 16- 7...
Page 330: Interfaces For The Security Features
$DATA1.HONCHO See the TACL Reference Manual for more information about the USERS program. Interfaces for the Security Features Compaq provides several user interfaces for the Guardian security features: The TACL program TACL commands and programs provide user and logon security.
Page 331: Table 16-2. Fup Disk-File Security Features
Revokes the license for a privileged program, or resets the security attributes of a file (user ID must be 255,255) FUP SECURE Changes the Guardian security attributes for a file For a detailed description of these commands, see the File Utility Program (FUP) Reference Manual. Guardian User’s Guide —425266-001...
Page 332: System Users
All user names and user IDs are kept in a system file. During a logon procedure, the system checks this file to ensure that the user name in the LOGON command is valid and that the correct password, if required, is supplied. Guardian User’s Guide —425266-001 16 -10...
Page 333: Capabilities Of System Users
Add new users to the system in any group Delete users from the system Debug and stop any user’s processes Debug privileged programs Log on as any user in any group without knowing that user’s password Guardian User’s Guide —425266-001 16 -11...
Page 334: Adding New Users
The TACL program displays its prompt, which is a number and a greater-than sign (>). ADMIN.JANE can now enter TACL commands or run an application program. For more information about logging on to the system and passwords, see Section 2, Getting Started With TACL. Guardian User’s Guide —425266-001 16 -12...
Page 335: Disk-File Security
Any local or remote user Local owner only Local member of the owner’s group Any local user Local refers to access within a single system; remote refers to access between systems (or nodes) in a network. Guardian User’s Guide —425266-001 16 -13...
Page 336: Accessing Disk Files
U, C, N group manager Member of owner’s G, A C, N group Any user For example, if a file owned by ADMIN.BILL is secured by the FUP SECURE command as follows: -SECURE BILLFILE, "AGNU" Guardian User’s Guide —425266-001 16 -14...
Page 337: Process Security
The process access ID is used to determine if file access is allowed. The process access ID is also used to determine whether certain security-restricted operations can be performed if the requester is neither the creator of the process nor the super ID. Guardian User’s Guide —425266-001 16 -15...
Page 338: Adopting The Owner Id Of A Program File
For more information about security- restricted operations, see the Guardian Procedure Calls Reference Manual. When a process is created, the operating system passes the appropriate process access ID to the descendant process.
Page 339: Controlled Access With Program File Id Adoption
ID of the program file (1,112), which becomes its process access ID. (If the query program were to create another process, that process would inherit 1,112 as both its creator access ID and its process access ID.) Guardian User’s Guide —425266-001 16 -17...
Page 340: Licensing Programs
This means that no users except super ID users (not even the programmer who replaced the program) are allowed to execute the program. When PRIVPROG is debugged and ready for use, the super ID can license it so that others in the group can run it. Guardian User’s Guide —425266-001 16 -18...
Page 341: Network Security
10> LOGON ADMIN.BILL 15> REMOTEPASSWORD \WEST, SHAZAM The allow-access password for ADMIN.BILL for \WEST from all other systems is SHAZAM. At system \EAST, these commands are entered: 10> LOGON ADMIN.BILL 11> REMOTEPASSWORD \WEST, SHAZAM Guardian User’s Guide —425266-001 16 -19...
Page 342 To remove all of the user’s remote passwords: 10> REMOTEPASSWORD Request-access passwords and allow-access passwords can be specified at any time. Remote access is permitted as soon as both remote passwords are defined (provided they match). Guardian User’s Guide —425266-001 16 -20...
Page 343: Accessing Processes On A Remote System
OOOO (local owner only) as well as other files that are only accessible locally. This remote session can be terminated with the TACL EXIT or LOGOFF command, or with CTRL-Y. If ADMIN.BILL terminates the TACL process (identified by process ID Guardian User’s Guide —425266-001 16 -21...
Page 344: Establishing A Global Remote Password
Only the users who know the local password can log on as NET.ACCESS. While logged on as NET.ACCESS, these users can access remote files. For example, this command lets users access remote files secured for access by NET.ACCESS. 1> LOGON NET.ACCESS, local-password Guardian User’s Guide —425266-001 16 -22...
Page 345: Establishing Subnetworks
(The remote super ID can then access files secured N, C, or U.) A remote super ID cannot log on as a local super ID user because the password for the local super ID is unknown. Guardian User’s Guide —425266-001 16 -23...
Page 346: Solving System Access Problems
This subsection applies only to users who have TACL access. Depending on your system configuration, some users might use other means for system access. Check with your system manager if you have questions about user access. Guardian User’s Guide —425266-001 16 -24...
Page 347: Figure 16-5. Flow Chart: Access Problem Troubleshooting Procedure
With Process User Step 5 Start New TACL Step 6 Is TACL Resume Check, Abort OK Now? & Restart Line Is TACL OK Now? Start New TACL Is TACL Escalate Resume OK Now? .CDD Guardian User’s Guide —425266-001 16 -25...
Page 348: Task 1: Check The Status Of The User's Tacl Process
R indicates that the process is on the ready list. The wait state (%WT) The group and user ID numbers of the person using the process (Userid) The name of the program file (Program file) The home terminal of the process (Hometerm) Guardian User’s Guide —425266-001 16 -26...
Page 349: Task 2: Check For Hardware Problems
To stop the TACL process that the user SALES.BONNIE is running on her terminal $JT1.#J01: > STATUS *, TERM $JT1.#J01 Process Pri PFR %WT Userid Program file Hometerm $TH02 4,100 8,001 $SYSTEM.SYS00.TACL $JT1.#J01 $TH02 B 5,100 8,001 $SYSTEM.SYS00.TACL $JT1.#J01 9,168 8,001 $SYSTEM.SYSTEM.TEDIT $JT1.#J01 > STOP $TH02 Guardian User’s Guide —425266-001 16 -27...
Page 350: Task 4: Stop Other User Processes
> STATUS *, TERM $JT1.#J01 Process Pri PFR %WT Userid Program file Hometerm $TH02 4,100 8,001 $SYSTEM.SYS00.TACL $JT1.#J01 $TH02 B 5,100 8,001 $SYSTEM.SYS00.TACL $JT1.#J01 9,168 8,001 $SYSTEM.SYSTEM.TEDIT $JT1.#J01 > STOP 9,168 The specified process is stopped. Guardian User’s Guide —425266-001 16 -28...
Page 351: Task 5: Start A New Tacl Process
Example To start a new TACL process for the user SALES.BONNIE on the terminal $JT1.#J01, enter: > TACL /IN $JT1.#J01, OUT $JT1.#J01, NAME $TH02, NOWAIT, PRI 150,& CPU 4/5 > STATUS *, TERM $JT1.#J01 Guardian User’s Guide —425266-001 16 -29...
Page 352: Task 6: Check, Stop, And Restart Terminal Communication Lines
ASSUME command. Aborting a line will usually affect other users connected to subunits associated with the line, so it is not usually done unless all subunits (subdevices) on a particular line are being affected by a problem. 3. Restart the line and subdevice. -> START Guardian User’s Guide —425266-001 16 -30...
Page 353 3. Restart the subunit (subdevice). -> START 4. Check the status of the subunit (subdevice). -> STATUS When the line is functional, the status shows that the state of the line is STARTED. 5. Exit SCF. -> EXIT Guardian User’s Guide —425266-001 16 -31...
Page 354: Common Terminal And Workstation Problems
The communication line Check line status with SCF, stop the might be overloaded or line, and restart it if indicated. If the line error rate is high. problems persist, escalate the problem according to local procedure. Guardian User’s Guide —425266-001 16 -32...
Page 355 Displaying Error Messages With Error 17-6 Displaying Operator Messages With a Printing Distributor 17-7 Interpreting Operator Messages 17-8 Directing Messages to a Disk File 17-10 Printing Operator Messages 17-11 Monitoring Messages With the TSM EMS Event Viewer 17-12 Guardian User’s Guide —425266-001 17- 1...
Page 356: Monitoring Event Messages
EMS distributor that sends operator messages to printers, devices, distributor processes, or files. Compatibility Allows downward compatibility with a previous operator process. The distributor ($Z0) compatibility distributor sends operator messages to a console device during system load. Guardian User’s Guide —425266-001 17- 2...
Page 357: Operator Message Monitoring Tools
Handling System (OSI/MHS) operator messages as they are sent to disk files, terminals, or printers: 96-10-03 15:09:51 \NET.$FTI1 TANDEM.MHS.G01 000023 $ZL1 MR.\NET.MRGRP1 $RL11: OSI resource problem with device \NET.$LAPX.#Z0004BW on call APS_ASSOC_CONNECTREQ returned with -1001, 140 Guardian User’s Guide —425266-001 17- 3...
Page 358: How Operator Messages Are Created
The $Z0 compatibility distributor can be configured only in EMS mode. It formats event messages from the event log file into operator messages and distributes them to the local operator console. Guardian User’s Guide —425266-001 17- 4...
Page 359: Figure 17-1. Operator Messages And The Ems Environment
Another Node Consumer Printing Compatibility Distributor Distributor Distributor Filter Filter Event viewing application* Console Device File Terminal Printer * Such as the TSM Event Viewer on G-series systems or ViewPoint on D-series systems .CDD Guardian User’s Guide —425266-001 17- 5...
Page 360: Displaying Error Messages With Error
Displaying Error Messages With Error Displaying Error Messages With Error When you are using the TACL program or a Guardian utility, you can receive file- system error numbers at your terminal. You can use the Error program to display an explanation of the error number.
Page 361: Displaying Operator Messages With A Printing Distributor
EMSDIST process, enter: > STATUS *, TERM 3. Search for the EMSDIST process in the left-hand column of the STATUS display. Then enter the STOP command: > STOP $process-name Guardian User’s Guide —425266-001 17- 7...
Page 362: Interpreting Operator Messages
MHS is the subsystem name and 000023 is the event number. 2. Turn to the appropriate section in the Operator Messages Manual (in this example, it is the section describing MHS messages). Guardian User’s Guide —425266-001 17- 8...
Page 363 Printing Distributor Message Format For event messages sent to printers, log files, and terminals used by the printing distributor, the message’s subsystem ID and event number appear in this format: owner-name.subsystem-name.version event-number For example: TANDEM.TMF.G06 000041 Guardian User’s Guide —425266-001 17- 9...
Page 364: Directing Messages To A Disk File
EMSDIST options TIME and STOP. For an example of using these options, see Printing Operator Messages on page 17-11. See the EMS Manual for complete information about EMS, its options, and for instructions on how to use them. Guardian User’s Guide —425266-001 17 -10...
Page 365: Printing Operator Messages
The person or process that runs EMSDIST must have read access to the log files that EMSDIST accesses. Super-group privileges are required if the collector creates its own log files with the protection string COOO, which is the system default file security. See the EMS Manual for further information. Guardian User’s Guide —425266-001 17 -11...
Page 366: Monitoring Messages With The Tsm Ems Event Viewer
Compaq NonStop™ Himalaya S-series server. TSM client software resides on PC-compatible workstations running the Windows NT 4.0 operating system. You can also use TSM to perform many of the Guardian tasks described in this guide. For information on using TSM, see the TSM Online User’s Guide.
Page 367: Using The Event Viewer
You can specify how you want to view the selected events. You can view events by log time or in summary form, then select specific events for detailed viewing. You can also display all events related to a selected one. Guardian User’s Guide —425266-001 17 -13...
Page 368 Monitoring Event Messages Using the Event Viewer Guardian User’s Guide —425266-001 17 -14...
Page 369: Displaying Version And System Information
There can be many files for a product in different locations on a system; you want the one that is actively used. Product files are located in both the Guardian and Open System Services (OSS) environments. VPROC can be run from both environments, so the procedure you need to perform depends upon the environment you are using and where the product files are located.
Page 370: Task 2: Select Files For Vproc Processing
Files in the OSS file system can have only the file codes listed previously, so you need not select OSS product files based on their file code. To determine the file code of a file in the Guardian file system, use the FILEINFO command from a TACL prompt, as described in Section 3, Managing Files With TACL.
Page 371: Task 3: Run Vproc
By specifying a full Guardian VPROC command at the TACL prompt in the Guardian environment By specifying a full Guardian VPROC command as an operand to the OSS gtacl command in the OSS environment By specifying a full OSS vproc command in the OSS environment...
Page 372 You cannot express remote Guardian file-set values in OSS pathname syntax. Note. VPROC retrieves information only for one file-set value or pathname value per command line; additional characters are ignored. These examples show two ways to display information about FUP in the Guardian environment. Using Guardian file-name syntax: 6>...
Page 373 VPROC can be run directly in the OSS environment by using the OSS gtacl command or indirectly by using the OSS vproc command. Both methods are described in the vproc(1) reference page either online or in the Open System Services Shell and Utilities Reference Manual. Guardian User’s Guide —425266-001 18- 5...
Page 374 After the VPROC prompt (>), you can enter a Guardian file-set value or an OSS pathname value for a file in the Guardian or OSS file system. The OSS pathname must be absolute if VPROC is started from the Guardian environment, and VPROC accepts the wild-card asterisk (*) in OSS pathnames only if used from the OSS shell.
Page 375: Task 4: Interpret Vproc Output
Indicates the date and time the ELF file was created in GMT (UTC). GMT Binder timestamp: Indicates whether the file can be executed. This information appears Native Mode: only for files with file code 700. The possible values are: Not runnable file runnable file Guardian User’s Guide —425266-001 18- 7...
Page 376 ERROR - NO SUCH VOLUME: [ filename | pathname ] Cause. Either the Guardian volume that you specified does not exist or you made a typographical error when entering the volume-name portion of the file name or pathname value.
Page 377: Displaying System Information
Indicates the number of the system you requested information on System number: (available only for the local system). Indicates the version of the Compaq NonStop™ Kernel operating Software system that is running on the system. release ID: Guardian User’s Guide —425266-001 18- 9...
Page 378 Displaying Version and System Information Task 2: Interpret SYSINFO Output Guardian User’s Guide —425266-001 18 -10...
Page 379 Checking the Status of Peripherals 19-8 Checking the Status of Processors 19-14 Checking the Status of Network Components 19-15 Checking the Status of Pathway 19-25 Checking the Size of Database Files 19-27 Automating System Monitoring 19-28 Guardian User’s Guide —425266-001 19- 1...
Page 380: Monitoring Hardware Components
Disk Space Analysis Program (DSAP) Files on your system File Utility Program (FUP) Kernel-managed swap files NSKCOM Local area networks Pathway transaction processing system PATHCOM Processes running on your system TACL PPD and STATUS commands Processors ViewSys Guardian User’s Guide —425266-001 19- 2...
Page 381: Other Useful Tools
PC-compatible workstation. TSM combines many of the system maintenance functions provided on D-series releases by the Syshealth toolkit, the Compaq Tandem Maintenance and Diagnostic Subsystem (TMDS), and the Remote Maintenance Interface (RMI) product. For more information, see the TSM Configuration Guide. Guardian User’s Guide —425266-001 19- 3...
Page 382: Listing The Devices On Your System
Type The device type and subtype RSize The record size the device is configured for The priority level of the I/O process Program The fully qualified name of the program file for the process Guardian User’s Guide —425266-001 19- 4...
Page 383: Example
The format of the STATUS display is shown below. subsystem STATUS object-type object-name Name State PPID BPID attr1 attr2 attr3 … object-name1 state nn,nnn nn,nnn val1 val2 val3 … object-name2 state nn,nnn nn,nnn val1 val2 val3 … Guardian User’s Guide —425266-001 19- 5...
Page 384: Table 19-2. Scf Object States
The object is logically accessible to user processes. STARTING The object is being initialized and is in transition to the STARTED state. STOPPED CONFIG- The object is configured improperly. ERROR DOWN The object is no longer logically accessible to user processes. Guardian User’s Guide —425266-001 19- 6...
Page 385 Examples Following are some examples of the SCF STATUS command: -> STATUS LINE $LAM3 -> STATUS WS $LAM3.#WS1 -> STATUS WS $LAM3.* -> STATUS WINDOW $LAM3.#WS1.* -> STATUS WINDOW $LAM3.*, SEL STOPPED Guardian User’s Guide —425266-001 19- 7...
Page 386: Checking The Status Of Peripherals
Series Releases for complete information about SCF, its commands and options, and device types and subtypes. To list all the disks on your system, enter this command at your TACL prompt: > SCF STATUS DISK $* Guardian User’s Guide —425266-001 19- 8...
Page 387 To display the summary status of the disk $DATA00, enter: -> STATUS $DATA01 34-> STATUS $DATA01 STORAGE - Status DISK \SHARK.$DATA01 LDev Primary Backup Mirror MirrorBackup Primary Backup *STARTED STARTED *STARTED STARTED 0,267 1,266 Guardian User’s Guide —425266-001 19- 9...
Page 388 Usage Information: Capacity (MB)..2000.09 Free Space (MB)..290.76 (14.53%) Free Extents..16 Largest Free Extent (MB). 172.42 Hardware Information: Path Location Power Physical Status (group,module,slot) PRIMARY (1,1,3) DUAL PRESENT MIRROR (1,1,4) DUAL PRESENT Guardian User’s Guide —425266-001 19 -10...
Page 389: Checking Tape Drive Status
To check the status of all tape drives on your system with SCF, enter: > SCF STATUS TAPE $* A listing similar to this is sent to your home terminal: STORAGE - Status TAPE $* LDev State SubState Primary Backup DeviceStatus STOPPED DOWN 0,274 STOPPED DOWN 0,273 Guardian User’s Guide —425266-001 19 -11...
Page 390: Checking Printer And Collector Status
$SPLP \AMBER.$S2 WAITING $SPLX “WAITING” in the STATE column indicates that the printer is available to print users’ jobs. See Section 14, Performing Routine Spooler Operations Using Spoolcom, for more information about using Spoolcom. Guardian User’s Guide —425266-001 19 -12...
Page 391 FORM $LASER WAITING $SPLP This display shows that the printer $LASER is up and available to print users’ jobs. See Section 14, Performing Routine Spooler Operations Using Spoolcom, for more information about using Spoolcom. Guardian User’s Guide —425266-001 19 -13...
Page 392: Checking The Status Of Processors
July 2, 1993 11:06:54.07 CPU BUSY 0---1---2---3---4---5---6---7---8---9---100% BUSY cpu 00 cpu 01 cpu 02 cpu 03 cpu 04 cpu 05 cpu 06 cpu 07 cpu 08 To exit from the ViewSys utility, press F16. Guardian User’s Guide —425266-001 19 -14...
Page 393: Checking The Status Of Network Components
1071 Interpreting the CPUS Display on page 19-16 for an explanation of the elements in the previous display. See the SCF Reference Manual for G-Series Releases for complete information about SCF and its commands. Guardian User’s Guide —425266-001 19 -15...
Page 394: Checking Servernet Lan Subsystem Status
The ServerNet LAN Systems Access (SLSA) subsystem supports parallel local-area network (LAN) I/O, allowing S-series servers to communicate across a ServerNet System Area Network (SAN) and access Ethernet devices through various LAN protocols. The SLSA subsystem contains the following SCF objects: Processes Monitors Guardian User’s Guide —425266-001 19 -16...
Page 395 A listing similar to this is sent to your home terminal: ->STATUS LIF $ZZLAN.LAN0 SLSA Status LIF Name State Access State $ZZLAN.LAN0 STARTED To check the status of a PIF, enter: > SCF STATUS PIF pif-name Guardian User’s Guide —425266-001 19 -17...
Page 396 > SCF STATUS LIF $ZZLAN.LAN0 , DETAIL ->STATUS LIF $ZZLAN.LAN0 , DETAIL SLSA Detailed Status LIF \SYS.$ZZLAN.LAN0 Access State..... UP CPUs with Data Path..( 0 ) Potential Access CPUs..( 0, 1 ) State....STARTED Trace Filename... Trace Status..... Guardian User’s Guide —425266-001 19 -18...
Page 397: Checking Atp6100 Line Status
Next, assume the subdevice name of the user’s terminal (the subdevice name is the same as the second component of the user’s terminal name, for example, #J01). -> ASSUME SU #subdevice Check the status of the line and subdevice: -> STATUS LINE Guardian User’s Guide —425266-001 19 -19...
Page 398: Checking Line Handler Status
Name State PPID BPID ConMgr-LDEV $LHCS6S STARTED 1, 20 2,25 Line handlers are commonly named $LH. This listing shows that the Expand line handlers on the system being monitored are up and functioning normally. Guardian User’s Guide —425266-001 19 -20...
Page 399: Checking Nonstop™ Tm/Mp Status
TMF subsystem, and as a system operator, you might check TMF status in your routine system monitoring. To monitor the basic components of the TMF subsystem using TMFCOM, enter: > TMFCOM ~ STATUS TMF Guardian User’s Guide —425266-001 19 -21...
Page 400: Table 19-3. Tmf States
DELETE TMF command was executed. Configuring New Audit Trails The TMF subsystem has not yet been started with this configuration. Stopped The TMF subsystem is stopped. Guardian User’s Guide —425266-001 19 -22...
Page 401 TMF subsystem, see the NonStop TM/MP: Getting Started with TM View. Examples To check the status of the TMF subsystem on your node, enter: > TMFCOM After TMFCOM displays its banner, enter: ~ STATUS TMF Guardian User’s Guide —425266-001 19 -23...
Page 402 TMFCOM responds with a display similar to: Audit Recovery Volume Trail Mode State --------------------------------------------------- $DATA1 Online Started $DATA2 Online Started $DATA3 Online Recovering $DATA4 Archive Recovering $DATA5 AUX01 Online Started $DATA6 AUX01 Online Started $DATA6 AUX01 Archive Recovering Guardian User’s Guide —425266-001 19 -24...
Page 403: Checking The Status Of Pathway
IO: the request is waiting for an I/O operation to finish. LOCK: the request is waiting for an object that has been locked by another requester. PROG-DONE: the request is waiting for a RUN PROGRAM to finish. Guardian User’s Guide —425266-001 19 -25...
Page 404: Examples
To check the status of the PATHMON process for your application, enter: = STATUS PATHMON PATHCOM responds with a display such as: PATHMON -- STATE=RUNNING CPUS 6:1 PATHCTL (OPEN) $GROG.VIEWPT.PATHCTL LOG1 SE (OPEN) LOG2 (CLOSED) REQNUM FILE PAID WAIT PATHCOM $Y622 8,001 $Y898 Guardian User’s Guide —425266-001 19 -26...
Page 405: Checking The Size Of Database Files
OWNER 8,255 SECURITY (RWEP): NUNU DATA MODIF: 12 Jul 1994, 14:04 CREATION DATE: 12 Jan 1994, 14:04 LAST OPEN: 12 Jul 1994, 14:04 EOF 567022 (88.2% USED) FILE LABEL: 775 (31.6% USED) EXTENTS ALLOCATED: 10 Guardian User’s Guide —425266-001 19 -27...
Page 406: Automating System Monitoring
This subsection contains an example of a command file you can use or adapt to check many of the system elements discussed throughout this section. The TACL Programming Guide also contains an example that you can use or adapt to automate system monitoring. Guardian User’s Guide —425266-001 19 -28...
Page 407 STORAGE - Status DISK \SHARK.$DATA04 LDev Primary Backup Mirror MirrorBackup Primary Backup *STARTED STARTED *STARTED STARTED 0,270 1,263 STORAGE - Status DISK \SHARK.$SYSTEM LDev Primary Backup Mirror MirrorBackup Primary Backup *STARTED STARTED STOPPED STOPPED 0,256 1,256 Guardian User’s Guide —425266-001 19 -29...
Page 408 SLSA Status LIF Name State Access State $ZZLAN.LAN0 STARTED $ZZLAN.LAN3 STARTED DOWN COMMENT THIS CHECKS ALL PIFS SCF STATUS PIF $* SLSA Status PIF Name State $ZZLAN.E4SA0.0.A STARTED $ZZLAN.E4SA0.0.B STARTED $ZZLAN.E4SA0.1.A STOPPED $ZZLAN.E4SA0.1.B STARTED Guardian User’s Guide —425266-001 19 -30...
Page 409 LOG2 (CLOSED) REQNUM FILE PAID WAIT PATHCOM $Y593 8,001 $UBIQ 30,1 $ZTTA $ZTTB $ZTAA $ZTAB $ZCMA $ZCMB The above listings show that all elements of the system being monitored are up and running normally. Guardian User’s Guide —425266-001 19 -31...
Page 410 Monitoring Hardware Components Automating System Monitoring Guardian User’s Guide —425266-001 19 -32...
Page 411: Learning The Cause Of A Problem: A Systematic Approach
Guide and the Measure Reference Manual. The PEEK program is used to gather statistical information about processor activity, system storage pools, paging activity, message information, send instructions, and interrupt conditions. For more information, see the PEEK Reference Manual. Guardian User’s Guide —425266-001 A- 1...
Page 412: A Problem-Solving Process
The results might not tell you exactly what is occurring, but they will narrow down the number of possible causes. Table A-1. Problem Solving Worksheet Problem Facts Possible Causes What? Where? When? Magnitude? Guardian User’s Guide —425266-001 A- 2...
Page 413: Task 1: Get The Facts And Log The Problem
How critical is the situation? What events led to the problem? Has anything changed recently that might have caused the problem? What event messages have occurred? What is the current configuration of the hardware and software products affected? Guardian User’s Guide —425266-001 A- 3...
Page 414: Task 2: Find And Eliminate The Cause Of The Problem
Possible causes of the hung terminal problem in the above example could be: A terminal hardware problem A stopped or suspended TACL process System security, which locks a user out after three unsuccessful logon attempts Guardian User’s Guide —425266-001 A- 4...
Page 415: Task 3: Escalate The Problem
Do I have the necessary knowledge? Do I have the skill? Do I have the time? What other people need to become involved, if any? Who needs to be informed about the problem’s status? Guardian User’s Guide —425266-001 A- 5...
Page 416: Task 4: Focus On Prevention
Could automation tools be used to detect and respond to preliminary symptoms of a problem such as this? Can anything be done now to minimize the damage that would result from a reoccurrence of this problem? Can the problem resolution process be improved in any way? Guardian User’s Guide —425266-001 A- 6...
Page 417 ATP6100 subsystem. ATP6100 provides the means for an application program to use asynchronous point-to-point terminals, printers, and other devices connected through the WAN concentrator. A communications access process and download module that provides software for asynchronous point-to-point terminal support. Guardian User’s Guide —425266-001 Glossary -1...
Page 418 TACL. Using command files is a method of automating operations tasks. communications subsystem. The combination of data communications hardware and software processes that function together as an integrated unit to provide services and access to wide and local area networks. Guardian User’s Guide —425266-001 Glossary -2...
Page 419 A logical or physical entity that can be specifically and uniquely identified and with which a processor can communicate. Examples of devices are printers, disks (volumes), disk drives, tape drives, controllers, processors, and terminals Guardian User’s Guide —425266-001 Glossary -3...
Page 420 Event Management Service (EMS). The processes, procedures, and utilities used to report and log events; to forward, print, and distribute event messages to applications; and to filter, retrieve, and obtain information from event messages. Guardian User’s Guide —425266-001 Glossary -4...
Page 421 “S.” These servers implement the ServerNet architecture and run the NonStop™ Kernel operating system. IBM format. A standard tape-label format supported on NonStop™ Kernel systems. Other formats include BACKUP and TMF. See also ANSI format. Guardian User’s Guide —425266-001 Glossary -5...
Page 422 Kernel-Managed Swap Facility (KMSF). labeled tape processing. The general term used for an operations environment that uses labeled tapes, as opposed to unlabeled tapes, for backups of data and other operations tasks and activities. Guardian User’s Guide —425266-001 Glossary -6...
Page 423 DSM/TC. Refer to the DSM/Tape Catalog Operator Interface (MEDIACOM) Manual for complete documentation on this utility. mirrored volume. See volume. network. Two or more computer systems (nodes) connected so that they can exchange information and share resources. Guardian User’s Guide —425266-001 Glossary -7...
Page 424 SCF object belongs; for example, a specific disk has the object type DISK and a specific terminal may have the object type SU. An SCF subsystem has a set of object types for the objects it manages. Guardian User’s Guide —425266-001 Glossary -8...
Page 425 (OM model). A model for managing NonStop™ Kernel systems that categorizes operations management functions into the following disciplines: production management, problem management, change management, configuration management, security management, and performance management. Guardian User’s Guide —425266-001 Glossary -9...
Page 426 NonStop™ TS/MP and the optional Pathway/TS software. Pathway Open Environment Toolkit (POET). A set of programs and utilities that assist in the creation and running of client/server applications for NonStop™ Kernel systems. Guardian User’s Guide —425266-001 Glossary -10...
Page 427 Pathway/TS Pathway/TS. A Compaq product that provides tools for developing and interpreting screen programs to support OLTP applications in the Guardian operating environment. PEEK. A utility program that reports statistical information concerning processor activity for system storage pools, paging activity, send instructions, and interrupt conditions.
Page 428 (OM model). sensitive command. A Subsystem Control Facility (SCF) command that can be issued only by a user with super-group access, by the owner of the subsystem, or by a member of the Guardian User’s Guide —425266-001 Glossary -12...
Page 429 The owner of a subsystem is the user who started that subsystem (or any user whose application ID is the same as the server ID— the result of a PROGID option that requires super-group access). Contrast with nonsensitive command. Guardian User’s Guide —425266-001 Glossary -13...
Page 430 Himalaya S-series server. A service connection can be used only to communicate with the server when the NonStop™ Kernel operating system is running. A service connection provides a comprehensive service and maintenance picture of the server and is used to perform most service management tasks. Guardian User’s Guide —425266-001 Glossary -14...
Page 431 For G-series systems, you can use SCF online to configure, control, and display information about configured objects within SCF subsystems. SCF has been enhanced to perform many of the functions performed on D-series systems by DSC/COUP and PUP. Guardian User’s Guide —425266-001 Glossary -15...
Page 432 Tandem Advanced Command Language (TACL). Tandem Advanced Command Language (TACL). A powerful, extended command interpreter for the Guardian environment that enables users to perform work on NonStop™ Kernel systems, such as defining aliases, macros, and function keys. TACL also functions as a programming language.
Page 433 The operating system does not include any application program interface. Tandem NonStop™ Series (TNS). NonStop™ Kernel computers that support the Guardian environment and that are based on complex instruction-set computing (CISC) technology. The term TNS can refer to the instruction set, the architecture, or the processors.
Page 434 Pathway server processes. TIM. See Total Information Manager. TMF. See TNS/R. TMFCOM. The NonStop™ TM/MP command interpreter. TNS. See Tandem NonStop™ Series (TNS). TNSC. See Global Customer Support Center (GCSC). TNS/R. See Tandem NonStop™ Series/RISC (TNS/R). Guardian User’s Guide —425266-001 Glossary -18...
Page 435 (TSM) package that runs on a NonStop™ Himalaya S-series server. When the NonStop™ Kernel operating system is running, the TSM software on the workstation communicates with the server through the TSM server software. See TSM client software. Guardian User’s Guide —425266-001 Glossary -19...
Page 436 $ZSVR. $ZSVR checks to see whether the requested tape is mounted, and if it is not, $ZSVR sends an operator message to alert operations staff to mount that tape. Guardian User’s Guide —425266-001 Glossary -20...
Page 437 NonStop process pair Communications Access Process Backup processor 2-13 (CAP) 19-19, Glossary-1 in TACL WHO display 2-13 line 19-19 Backup program 11-1/11-11 Attributes of spooler components ALTFILE option 11-7 collectors 15-5 ARCHIVEFORMAT option 11-7 devices 15-15 Guardian User’s Guide —425266-001 Index- 1...
Page 438 CLASS MAP using a TAPE DEFINE 11-20 CLASS SPOOL using labeled tapes 11-19 CLASS TAPE using RUN options 11-6 Cold start, spooler using wild-card characters 11-4 compared to warm start 14-12 VERIFYREEL option 11-8 Guardian User’s Guide —425266-001 Index- 2...
Page 439 TACL command used with Spoolcom 14-3 CREATE command in FUP 8-1, 8-19 used with TACL OBEY command Creating files Command history in TACL 2-15/2-20 with DDL Command interpreter (TACL) with FUP 8-1/8-14 Command line length Guardian User’s Guide —425266-001 Index- 3...
Page 440 Defaults, logon, changing 16-3 in Spoolcom 14-7, 14-8 DEFINE command in TACL DEV subcommands (SPOOLCOM) DEFINEs CLEAR 14-4 altering (example) 12-13 DELETE 14-4 attributes DEVRESET 15-15 consistency checks DEVTYPE 15-15 default settings DRAIN 14-4, 14-6, 15-8 Guardian User’s Guide —425266-001 Index- 4...
Page 441 15-15 Dual-ported controller Glossary-3 defined 12-2 Dump file, COPYDUMP program 10-30 deleting from spooler 15-14 DUPLICATE command in FUP 8-15, 8-16/8-18 displaying attribute settings 15-12 Duplicating Backup tapes with exclusive 14-10, 15-15 Backcopy 11-23/11-24 Guardian User’s Guide —425266-001 Index- 5...
Page 442 16-3 locations 14-24 analyzing disk space 9-16 managing spooler locations 15-19 checking file size 19-27 MEDIACOM STATUS TAPEDRIVE command 19-12 checking printer status with SPOOLCOM 14-6 obtaining tape status 10-12 Guardian User’s Guide —425266-001 Index- 6...
Page 443 File code, disk stoping user process 16-28 displayed by FUP INFO command 7-10 stopping and restarting spooler subsystem 14-18 displayed by TACL FILEINFO command stopping and starting tape drives 10-13 File identifier stopping TACL process 16-27 Guardian User’s Guide —425266-001 Index- 7...
Page 444 14-13 BUILDKEYRECORDS command 8-20 FILEINFO command in TACL commands FILENAMES command in TACL ALTER 8-19, 8-21 FILES command COPY 8-15 in FUP CREATE 8-1/8-14, 14-13 in Peruse 13-6 DUPLICATE 7-13/7-15, 8-17 Guardian User’s Guide —425266-001 Index- 8...
Page 445 14-3 Full logon feature in TACL in TACL command Function key with spooler locations 12-10 defined as a macro in TACL 5-2/5-5 INFO command in FUP 7-10/7-12 defined as an alias in TACL 5-3/5-5 Guardian User’s Guide —425266-001 Index- 9...
Page 446 (NL mode) 10-5, 10-8 form name 12-6 standard label processing (LP header message 12-6 mode) 10-6 state 12-6 using with Backcopy 11-23 selection algorithm 12-6 using with Backup and Restore 11-19/11-22 Guardian User’s Guide —425266-001 Index -10...
Page 447 14-14, LP mode (tape processing) Glossary-18 15-12, 15-18 rerouting jobs 15-14 subcommands Macro function key definitions 5-4/5-6 BROADCAST 15-18 Macros, TACL DELETE 14-5, 14-24, 15-14, 15-19 defining function keys 5-2/5-6 Guardian User’s Guide —425266-001 Index -11...
Page 448 EMS messages 17-12 OBEY command in TACL labeled-tape messages 10-14 OBEY file operator messages 17-1 See Command file processes 16-2 Object Monitoring Facility (OMF) 19-3, system status 16-2 OPEN command in Peruse 13-6 Monitors 19-16 Guardian User’s Guide —425266-001 Index -12...
Page 449 PATHMON, processes 19-25 Primary controller path Glossary-3 Pathway Primary processor commands 19-25 in TACL command processes 19-25 in TACL WHO display 2-13 transaction processing applications Primary volume Glossary-4, Glossary-20 PRINT command in Spoolcom 14-8 Guardian User’s Guide —425266-001 Index -13...
Page 450 Processes 19-16 defined 12-2 Processor Glossary-12 determining devices controlled by 15-8 Product files dormant state of 14-10 finding in the Guardian FASTP 14-16, 15-6 environment 18-1 independent 14-10 Product version information 18-7, 18-9 procerror state of 14-10 Prompt, setting with TACL SETPROMPT...
Page 451 KEEP option 11-14, 11-16 RUN command (TACL) options LISTALL option 11-14, 11-15 with Backup 11-6 LISTONLY option 11-14, 11-15 with Error 17-6 MAP NAMES option 11-17 with HIGHPIN option MAPNAMES option 11-14 with TACL Guardian User’s Guide —425266-001 Index -15...
Page 452 19-8 SHOW DEFINE command in TACL examples 19-7 Single-port device Glossary-1 19-17 SJFILES command in Peruse 13-6 LINE 19-19, 19-20 Software release ID 19-17 information 18-9 19-17 SORT DEFINE TAPE 19-11 Sparing sectors 9-12 Guardian User’s Guide —425266-001 Index -16...
Page 453 14-4 DELETE 14-5, 14-21 DELETE 14-4, 15-14 entering 15-19 DEVRESET 15-15 function 14-5 DEVTYPE 15-15 HOLD 14-5, 14-20, 14-31 DRAIN 14-4, 14-6, 14-28, 14-31, reentering 14-31 14-34, 15-8, 15-14 SELPRI 14-20, 14-22 ENDFF 15-15 Guardian User’s Guide —425266-001 Index -17...
Page 454 START 14-5, 14-12, 14-14, 15-3, Peruse program 12-2, 13-1/13-14 15-20 print processes 12-2 STATUS 14-5, 14-21 printers 12-6 START 14-5 problems, solving 14-26 STATUS 14-5 related documentation 14-14 summary 12-1, 14-4, 14-5 routing structure 12-2, 12-8/12-9 Guardian User’s Guide —425266-001 Index -18...
Page 455 Subnetworks 16-23 stopping a process 16-27, 16-28 SUBSORT DEFINE System Area Network (SAN) 19-16 Subsystem Control Facility (SCF) SYSTEM command Subsystem messages 17-3 in FUP Subsystems, monitoring 16-2 in TACL SUBVOLS command in FUP Guardian User’s Guide —425266-001 Index -19...
Page 456 Peruse with 13-9 displaying definitions finding errors in a listing 13-10 loading definitions Tandem Advanced Command Language (TACL) macro definition commands using function keys BACKUPCPU HELP key (F16) 2-12 EXIT macros 2-17 loading 5-10 Guardian User’s Guide —425266-001 Index -20...
Page 457 See Transaction Management Facility ACCEPT command 10-7 (TMF) REJECT command 10-7 TMFCOM, using 19-21/19-24 Tape, labeled automatic volume recognition Transaction Management Facility (TMF) (AVR) 10-2 states of subsystem 19-22 DEFINE attributes (table) 10-9 STATUS command 19-21, 19-22 Guardian User’s Guide —425266-001 Index -21...
Page 458 Working attribute set for DEFINEs See System users Workstation problems, solving 16-32 USERS program in TACL 2-14 USERS program (TACL) 14-31, 16-7 Users, system ZZRSTART restart file 7-14 capabilities of 16-11 classes of 16-10 getting information about 2-14 Guardian User’s Guide —425266-001 Index -22...
Page 459 TACL commands in TACL FILEINFO command in USERS program (example) 2-17 in VPROC command 18-3, 18-4 ** (two asterisks) in DEFINE templates + (plus sign) in Peruse DEV display 14-7 - (hyphen) as FUP prompt Guardian User’s Guide —425266-001 Index -23...
Page 460 Index Special Characters Guardian User’s Guide —425266-001 Index -24...

HP Guardian User Manual

1 Introduction to Guardian System Operations

2 Getting Started with TACL

3 Managing Files with TACL

4 Starting and Controlling Processes with TACL

5 Defining Function Keys and Writing Macros

6 Creating and Using Defines

Part II. Managing Files Using the File Utility Program (FUP)

7 Using FUP for Basic File Management

8 Using FUP for Advanced File Management

Part III. Managing Disk and Tape Processes

9 Performing Routine Disk Operations

10 Using Labeled Tapes

11 Backing up and Restoring Disk Information

12 Introduction to the Spooler

13 Managing Your Spooler Jobs Using Peruse

14 Performing Routine Spooler Operations Using Spoolcom

Quick Links

Related Manuals for HP Guardian

Summary of Contents for HP Guardian