manualshive.com logo in svg

HP Guardian, User Manual

Share
Download
HP Guardian User Manual Download Page 258

Managing Your Spooler Jobs Using Peruse

Guardian User’s Guide — 425266-001

13 -10

Finding TAL Errors

Finding TAL Errors

Instead of waiting for your TAL compilation to finish, you can use the FIND, PAGE, 
and LIST commands to search for errors. Because all TAL compilation errors begin 
with the string **** ERROR, you can use this string to search for errors in your 
program. For example:      

Continue using the FIND command to find any remaining errors; if you don’t specify a 
new string, FIND continues to search for the same string. Determine the page on which 
each error occurs with the PAGE command and then display the page, with the LIST 
command:         

Continue searching for the error string until there are no more occurrences of it in the 
program. For example:         

When you have found all the errors in the program and are through with this TAL 
listing, delete it with the DEL command and exit Peruse:         

Correct the errors in your source file and run TAL again. 

The following example shows a TAL compilation with the compiler listing sent to 
location $S.#HOLD:      

_FIND /**** ERROR/
**** ERROR 27 **** Illegal syntax

_FIND 
**** ERROR 54 **** Illegal reference parameter
_PAGE  
PAGE: 8      LINE: 12
_LIST *

_FIND
**** ERROR 72 **** Indirection must be supplied
_FIND

_DEL ; EXIT

11> TAL /IN PROG, OUT $S.#LOOK/ TALOBJ
12> PERUSE
PERUSE - T9101D10 - (08JUN92)    SYSTEM  \WEST
Copyright Tandem Computers Incorporated 1978, 1982, 1983, 1984, 1985, 1986,
1987, 1988, 1989, 1990, 1991 

  JOB  BATCH STATE PAGES COPIES PRI HOLD LOCATION     REPORT
  136        READY 130   1      4        #HOLD        TAL USER

Summary of Contents for Guardian

Page 1: ...des more detailed procedures for system operations management and maintenance tasks useful to both beginning and experienced Compaq NonStop Kernel operating system users Product Version N A Supported Releases This manual supports G06 05 and all subsequent G series releases and D48 00 and all subsequent D series releases until otherwise indicated in a new edition Part Number Published 425266 001 Au...

Page 2: ...hat may pertain to or accompany the delivery of this computer software the rights of the Government regarding its use reproduction and disclosure are as set forth in Section 52 227 19 of the FARS Computer Software Restricted Rights clause RESTRICTED RIGHTS NOTICE Use duplication or disclosure by the Government is subject to the restrictions as set forth in subparagraph c 1 ii of the Rights in Tech...

Page 3: ... Comments Invited xxi 1 Introduction to Guardian System Operations Common Guardian Operations Tasks 1 2 Working With a Daily Check List 1 3 Your System Might Be Protected 1 3 Automating Routine Monitoring Tasks 1 4 Example Check List 1 4 Part I Using the Compaq Tandem Advanced Command Language TACL 2 Getting Started With TACL Using TACL as a Command Interpreter 2 2 Entering TACL Commands 2 2 Loggi...

Page 4: ...2 11 Logging On to a Remote System 2 11 Getting TACL Help 2 12 Displaying User Information 2 13 Displaying Your Information 2 13 Displaying Information About Other Users 2 14 Using Your Command History 2 15 Listing Your Previous Commands 2 15 Redisplaying a Selected Previous Command 2 16 Reexecuting a Previous Command 2 16 Changing or Correcting a Previous Command 2 17 3 Managing Files With TACL I...

Page 5: ...lling Processes With TACL Getting Information About Processes 4 2 Displaying Process Information STATUS Command 4 2 Displaying Named Process Information PPD Command 4 3 Starting and Controlling a Process 4 5 Running a Process at a High PIN 4 6 Your Default Process 4 6 Interrupting a Process 4 6 Pausing a Process 4 7 Stopping a Process 4 7 Using a Command OBEY File 4 8 Restarting a TACL Process 4 9...

Page 6: ...E Attributes 6 7 Initial Attribute Settings 6 7 Working Attribute Set 6 8 Attribute Consistency Checks 6 8 TACL DEFINE Commands 6 9 Example of Creating and Using a DEFINE 6 9 Task 1 Ensure DEFINEs are Enabled 6 9 Task 2 Create the DEFINE 6 9 Task 3 Use the Created DEFINE 6 10 Part II Managing Files Using the File Utility Program FUP 7 Using FUP for Basic File Management Who Uses FUP 7 1 Entering F...

Page 7: ... 21 Solving Common File Problems 7 22 8 Using FUP for Advanced File Management Creating Files 8 1 Creating Files Using DDL 8 4 Using the SET SHOW and CREATE Commands 8 4 Restoring Default File Creation Parameters 8 5 File Creation Examples 8 6 Maintaining Your Disk Files 8 15 Loading Data Into Files 8 15 Purging Data From Files 8 16 Renaming and Moving Files With Alternate Keys 8 16 Copying Files ...

Page 8: ... 14 Analyzing Disk Space Usage With the Subsystem Control Facility SCF 9 14 Analyzing Disk Space Usage With the Disk Space Analysis Program DSAP 9 15 Listing and Purging Old Disk Files 9 20 Monitoring and Altering Swap Files 9 23 How Kernel Managed Swap Space Works 9 23 How Kernel Managed Swap Files Affect You 9 24 Using NSKCOM to Monitor and Alter Swap Files 9 25 Solving Common Disk Problems 9 28...

Page 9: ...28 Premounting Labeled Tapes 10 28 Scratching a Labeled Tape 10 29 Compressing a Tape Dump File 10 30 Solving Common Tape Subsystem Problems 10 31 11 Backing Up and Restoring Disk Information Why Use Backup and Restore 11 2 Supported Modes of Operation 11 2 Backing Up Your Files 11 3 Specifying a File Set List for Backup 11 4 Using a Qualified File Set List 11 5 Using Run Options in a Backup Comma...

Page 10: ...12 8 Default Routing 12 8 Implicit Route Creation 12 9 Printing To the Spooler 12 10 Sending Output to a Spooler Location 12 10 Sending Output to a SPOOL DEFINE 12 11 13 Managing Your Spooler Jobs Using Peruse Running Peruse 13 2 Spooler Jobs 13 2 Entering Peruse Commands 13 3 Declaring the Current Job 13 4 Displaying a Job 13 5 Using the Break Key 13 5 Peruse Commands 13 6 Using Peruse With TFORM...

Page 11: ... Spoolcom Process and Entering Commands Interactively 14 2 Entering Commands From a Command File 14 3 Spoolcom Commands 14 3 Spoolcom Command Summary 14 4 Listing Printers and Checking Their Status 14 6 Restarting a Printer 14 7 Displaying the Status of Spooler Components 14 8 Monitoring Spooler Processes 14 9 Monitoring the Spool Supervisor 14 9 Monitoring Spooler Collector Processes 14 9 Monitor...

Page 12: ...ts and Files 15 2 Managing Collector Processes 15 3 Adding a Collector to Your Spooler Subsystem 15 3 Displaying Collector Attributes 15 4 Modifying Collector Attributes 15 5 Deleting a Collector 15 5 Managing Print Processes 15 6 Adding a Print Process 15 6 Displaying the Current Attributes of a Print Process 15 7 Modifying Print Process Attributes 15 8 Deleting a Print Process From the Spooler 1...

Page 13: ...System Frequently 16 2 Adding Users to the System 16 2 Changing Logon Defaults 16 4 Deleting Users From the System 16 5 Task 1 Delete the User Account 16 5 Task 2 Clean Up the User s Disk Space 16 5 Determining Group and User Name and Number 16 7 Interfaces for the Security Features 16 8 System Users 16 10 Identifying System Users 16 10 Capabilities of System Users 16 11 Adding New Users 16 12 Dis...

Page 14: ... 3 Stop the User s TACL Process 16 27 Task 4 Stop Other User Processes 16 28 Task 5 Start a New TACL Process 16 29 Task 6 Check Stop and Restart Terminal Communication Lines 16 30 Common Terminal and Workstation Problems 16 32 17 Monitoring Event Messages Understanding Operator Messages 17 2 Operator Message Monitoring Tools 17 3 Operator Message Types 17 3 Operator Messages Format 17 3 How Operat...

Page 15: ... 9 Task 1 Run SYSINFO 18 9 Task 2 Interpret SYSINFO Output 18 9 19 Monitoring Hardware Components Tools for Monitoring System Status 19 2 Other Useful Tools 19 3 Listing the Devices on Your System 19 4 Example 19 5 Determining Device States 19 5 Checking the Status of Peripherals 19 8 Checking Disk Status 19 8 Checking Tape Drive Status 19 11 Checking Printer and Collector Status 19 12 Checking th...

Page 16: ...k 4 Focus on Prevention A 6 Glossary Index Figures Figure 8 1 Steps for Creating a File With FUP 8 2 Figure 8 2 Structure of an Entry Sequenced File 8 8 Figure 8 3 Structure of a Relative File 8 9 Figure 8 4 Key Sequenced File Format 8 10 Figure 8 5 Structure of a Key Sequenced File 8 11 Figure 8 6 Possible Record Format Key Sequenced File With Alternate Keys 8 11 Figure 8 7 Structure of a Partiti...

Page 17: ... 1 Table 9 2 Common Disk Problems 9 28 Table 10 1 MEDIACOM Commands 10 3 Table 10 2 TAPE DEFINE Attributes 10 9 Table 10 3 Common Tape Subsystem Problems 10 31 Table 11 1 File Set List Qualifiers 11 6 Table 11 2 Backup Command Options 11 7 Table 11 3 Restore Command Options 11 14 Table 11 4 TAPE DEFINE Attributes for Backup and Restore 11 19 Table 11 5 Backcopy Command Options 11 24 Table 12 1 SPO...

Page 18: ... Attributes 15 18 Table 16 1 TACL System Security Features 16 8 Table 16 2 FUP Disk File Security Features 16 9 Table 16 3 Types of File Access 16 13 Table 16 4 Levels of Disk File Security 16 13 Table 16 5 Allowed Disk File Access 16 14 Table 16 6 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 Monito...

Page 19: ...G06 05 and all subsequent G series releases and D48 00 and all subsequent D series releases until otherwise indicated in a new edition Document History New and Changed Information The G06 09 edition of this guide contains these changes The new Backup and Restore command options NOSQLDATA REMOTEIOSIZE and SQLTAPEPARTARRAY were added in Section 11 Backing Up and Restoring Disk Information File and p...

Page 20: ...he FUP SET command were added to Table 8 1 Parameters of the FUP SET Command on page 8 3 Y2K compliant examples were added and information field descriptions were updated for VPROC to Section 18 Displaying Version and System Information A description of using SYSINFO for displaying basic information about local and remote systems was added to Section 18 Displaying Version and System Information Th...

Page 21: ...rminal controlled by Safeguard and how to change a password Section 3 Managing Files With TACL Using the TACL program to manage disk files Section 4 Starting and Controlling Processes With TACL Using the TACL program to manage processes that you start Section 5 Defining Function Keys and Writing Macros How to define function keys and write simple TACL macros Section 6 Creating and Using DEFINEs Us...

Page 22: ...xplains how individual users can check the status of spooler components and change attributes of their spooler jobs Section 15 Managing the Spooler Using Spoolcom Using Spoolcom to manage all spooler collector processes print processes print devices and locations by adding and deleting them from the spooler and by displaying and modifying attributes associated with these processes Part V Security ...

Page 23: ...etailed response to your message is sent as soon as possible Be sure to include your name company name address and phone number in your message If your comments are specific to a particular manual also include the part number and title of the manual Many of the improvements you see in Compaq manuals are a result of suggestions from our customers Please take this opportunity to help us improve futu...

Page 24: ...About This Guide Guardian User s Guide 425266 001 xxii Your Comments Invited ...

Page 25: ...rences where to get more information for advanced usage Some of the tasks in this guide such as working with the print spooler and labeled tapes describe software procedures that work with Compaq NonStop Himalaya server hardware 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 som...

Page 26: ...l system including Task Section Routine system access Section 2 Getting Started With TACL Working with files Section 3 Managing Files With TACL Routine process operations Section 4 Starting and Controlling Processes With TACL Routine user customization Section 5 Defining Function Keys and Writing Macros Creating DEFINEs Section 6 Creating and Using DEFINEs Routine file management Section 7 Using F...

Page 27: ...ces when performing the tasks described in this guide such as receiving a security violation error code 48 However the Safeguard product is flexible and can be configured for different situations Consult the Security Management Guide or your security administrator or system manager if you have questions about your system or network Table 1 1 Daily Tasks Check List General Tasks Specific Tasks More...

Page 28: ... with the task descriptions Hardware operations manuals such as the Himalaya S Series Operations Guide contain specific examples for automating system startup operations Example Check List This example shows a form you might use to standardize your routine start of shift monitoring tasks Task Operator s name Date time Notes and questions Check phone messages Check faxes Check e mail Check shift lo...

Page 29: ...ins information about using TACL as the interface between you and your 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 ...

Page 30: ...Part I Using the Compaq Tandem Advanced Command Language TACL Guardian User s Guide 425266 001 ...

Page 31: ...application Define your function keys to execute TACL commands invoke macro and alias definitions and run applications Write programming routines to perform complex operations See Section 5 Defining Function Keys and Writing Macros for more information The TACL program can also be used as a programming language but this is not described in this guide See the TACL Reference Manual and the TACL Prog...

Page 32: ...onfigured the system to do so see Logging On With Safeguard on page 2 9 3 After you log on at your terminal you can enter TACL commands at your terminal keyboard As a command interpreter the TACL program lets you enter TACL commands run system utilities such as TEDIT or Peruse and run any application that you might need to do your job Entering TACL Commands You can enter interactive TACL commands ...

Page 33: ...PPORT STEIN is user number 66 in group number 6 her user number is 6 66 Each user can have a logon password a string of characters that you must enter to access the system You can select and change your own password on most systems see Changing Your Password on page 2 8 Using a logon password prevents anyone else from logging on as you If you do not use a password anyone can log on as you by simpl...

Page 34: ...owed Full Logon The full logon feature lets you enter your password at the same time you enter your user name or ID This is faster but your password is visible to anyone watching you For example using the same user name from the previous example with the password ABT all uppercase Stein logs on to the system using the full logon feature The password is typed after the user name and is separated fr...

Page 35: ...rocess has invoked two files for customizing your TACL environment TACLLOCL and TACLCSTM see Section 5 Defining Function Keys and Writing Macros Your first TACL command prompt which is a greater than sign preceded by a command line number You are now ready to enter TACL commands While logged on you or another user can log on without your having to log off The user ID currently logged on is automat...

Page 36: ...rm a network using Expand access to a file can be restricted to users on the local system where the file resides or access can be allowed for users on any system in the network Safeguard can secure a file so that only specific individuals either locally or on the network can access that file To access a file available only to local users you must be logged onto the local system To log onto a syste...

Page 37: ...m file name For example if your local system is part of a network that includes the system HERST you can start a TACL process on HERST by entering The TACL program returns the initial TACL prompt and you can log onto HERST A remote TACL process started this way does not have a backup process If you want the remote TACL process to run as a NonStop process pair instead enter The operating system ass...

Page 38: ...ontrol characters or other characters but must not contain Blanks or commas CTRL A Certain other control characters on some terminals check your terminal manual To change a logon password or to choose a password if you don t have one 1 Log on to your terminal 2 Change the password in this example to BASKET by entering The Password program responds with this message To delete your password enter a ...

Page 39: ...ACL on page 2 3 The Safeguard logon prompt accepts only two commands LOGON and TIME If you enter any other command Safeguard displays this message The TIME Command The TIME command displays the current date and time for example The Safeguard LOGON Command When a terminal is controlled by Safeguard you must use the Safeguard LOGON command to access your system To terminate the LOGON command during ...

Page 40: ... at the end of your password Safeguard prompts you for a new password 2 Enter your new password Safeguard prompts you to retype the new password to verify it 3 Retype your new password This example shows the new password but it is not displayed on your screen when you type it Safeguard passwords are case sensitive In this example each time SUPPORT STEIN logs on the letter B in the new password mus...

Page 41: ...stem To log on to a remote system your user ID must have been added to the remote system and you must have remote passwords established to allow network access See Establishing Remote Passwords on page 2 7 To access a remote system on your network you must use the Safeguard LOGON program 1 Log on to your local system 2 Log on to the remote system from your local terminal The Safeguard LOGON progra...

Page 42: ... you enter the command name correctly but make a mistake in a command option the TACL program lists the options that are legal for that command For example The F16 function key is the TACL HELP key If you enter the first part of a command plus a space and then press F16 without pressing Return the TACL program lists the possible options for that point in the command This example shows a list of op...

Page 43: ...lume GERT STEIN Userid 6 66 Username SUPPORT STEIN Security UUUU Home terminal Name of the terminal where you are logged on If you are logged on to a remote system the terminal name also includes the system name TACL process System and process name of your TACL process Primary CPU CPU number where your primary TACL process is running and the type of processor Backup CPU CPU number where your backu...

Page 44: ...isplays information about all members of group 6 To list all users in the specified group enter the group name followed by a period and an asterisk To list all users in your own group enter an asterisk Userid Your user ID group number user number Username Your user name group name user name Security Your default file security string Default process Process ID CPU number and process number of the l...

Page 45: ...this TACL session If you do not specify a number of commands to display the default is to display your previous ten commands To display the last ten commands you entered enter HISTORY Your previous ten commands are displayed If you do not specify a number in the command and have entered fewer than ten commands during this TACL session HISTORY displays all your commands beginning with number one To...

Page 46: ...gins with the string For example if you know you issued a PASSWORD command but can t remember the line number enter and enough characters to identify the command To list the last command you entered enter with no number or text string Reexecuting a Previous Command The exclamation point command recalls a specific command like the command does and immediately executes the command To see and immedia...

Page 47: ...nge Do not use the arrow keys to move the cursor Using the Editing Characters D I and R The FC command accepts three command editing characters D or d Deletes the character above the D I or i Inserts the text following the I into the command line that is text is inserted in front of the character above the I R or r Replaces characters in the command line beginning with the character above the R wi...

Page 48: ...r a replacement string under text without using the R command You can also insert text at the end of the line by typing it in without using the I command For example However if your proposed replacement or insertion text begins with the letters D I or R lowercase or uppercase FC considers that letter to be an editing command and you will not get the results you want The following example shows an ...

Page 49: ... number The TACL program does not display the ampersands and does not necessarily break the command where you originally broke it 3 Change the first line as you would change a single line command 4 Move the cursor with the space bar not the arrow keys until it wraps around and is under the second line 5 Change the second line as you would change a single line command In this example one command wa...

Page 50: ...The TACL program displays the second line with the same line number 3 Change the spooler location to HOLD just as you would change a single line command and press Return 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 29 FC R 30 RUN APPS EMPL...

Page 51: ...our disk files Selected TACL commands are described in this section For syntax and reference information about all TACL commands and programs see the TACL Reference Manual Topic Page Introduction to Files in Guardian 3 2 Listing Files and Their Information 3 5 Renaming Files 3 8 Deleting Files 3 8 Changing Your Default Values 3 10 ...

Page 52: ...t For most uses you should create the specific type of file that best suits your purpose Even if you do not create your own files you might work with various types of files and need to perform FUP operations on those files Enscribe the NonStop Kernel database record manager supports four disk file types Unstructured files Key sequenced files Entry sequenced files Relative files An unstructured fil...

Page 53: ...CREATE commands See the File Utility Program FUP Reference Manual and the TACL Reference Manual Subvolume Defaulting When you give a partial file name the TACL program fills in some of the missing parts using your current default values for node volume and subvolume see Changing Your Default Values on page 3 10 However TACL does not supply the subvolume name by default in some situations that were...

Page 54: ... 425266 001 3 4 Disk File Names a file identifier the 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 ...

Page 55: ...rs to match characters anywhere in a subvolume or volume name but not a node name Use the asterisk to match zero to eight characters Use the question mark to match a single character You cannot use wild cards to match the periods that separate the elements of a file name string system volume subvolume and file names Also if you use a wild card in the volume name you must include the dollar sign Fo...

Page 56: ...restore your TACL prompt press the Break key To list every file named HANGUP in every subvolume on every disk volume in the system To display all five letter file names in the current subvolume that begin with the letters SEC and end with the number 2 The TACL program displays file names from the current or default subvolume because a subvolume name was not included in the command Getting File Inf...

Page 57: ...licensed L or File Format 2 EOF Number of bytes in the file also end of file Last Modification Date and time the file was last modified Owner User ID of the file owner RWEP Read write execute and purge security assigned to the file is displayed for files protected by Safeguard security codes are explained in Section 7 Using FUP for Basic File Management for files that do not exist and for files un...

Page 58: ... the File Utility Program FUP See Renaming Files on page 7 15 Deleting Files If you have purge access to a file on a disk volume see Setting Your Default File Security on page 3 13 and the file is not currently open you can delete it from the system Simply enter PURGE followed by the name of the file to be deleted The PURGE command has CONFIRM and NOCONFIRM options that let you specify whether you...

Page 59: ...h SECT are purged Whether or not you specify a confirm option the TACL program confirms the file name template before purging all files that match the template If you specify the CONFIRM option the TACL program prompts for purge confirmation of each file before deleting it You can also delete files with the File Utility Program FUP See Deleting Files on page 7 17 17 PURGE SECT01 SECT02 SECT03 SECT...

Page 60: ...ults using the VOLUME and SYSTEM commands Check your current location using the WHO command Display your current defaults in your command prompt using the SETPROMPT command File Name Expansion When you specify a partial file name in a command the operating system uses your current default values to supply missing parts of the file name This adding of parts to file names is known as file name expan...

Page 61: ... VITA to GERT STEIN on your home system 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 2 WHO Home terminal STEIN TACL process MEL Z103 Primary CPU 4 VLX Backup CPU 5 VLX Default Segment File GERT 6539 Pages allocated 8 Pages Maximum 1...

Page 62: ...mmand prompt displayed on your screen By default your TACL prompt displays the current command number The SETPROMPT command tells the TACL program to include other elements such as the name of your current default subvolume or volume or both To add your current default subvolume to your TACL prompt To display your current volume in your TACL prompt To display your current volume and subvolume in t...

Page 63: ...ur Default File Security When you create a file the system assigns your saved default file security to the file unless you explicitly assign a different security setting Changing your default security does not alter the security assigned to previously created files The security specifier RWEP is a four character string Each position in the string sets the security restriction for one of four disk ...

Page 64: ...local system not over the network 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 O owner Only the owner of the file on the local system can access the file The owner is identified by...

Page 65: ...FORM process You can manage the processes on your system by using the TACL program Selected TACL commands are described in this section For information about all TACL commands and programs see the TACL Reference Manual Topic Page Getting Information About Processes 4 2 Starting and Controlling a Process 4 5 Using a Command OBEY File 4 8 Restarting a TACL Process 4 9 Running Compaq NonStop Kernel U...

Page 66: ...inal use an asterisk to indicate all processes and TERM to indicate the home terminal You can also specify a user and program by name For example the following STATUS command shows all processes owned by the user COOKS SAG that are running the program file SYSTEM SYSTEM TEDIT For a description of all STATUS command options see the TACL Reference Manual Examples 1 Display information about processe...

Page 67: ... the process Hometerm is the name of the terminal that is designated as the home terminal for the process which is where the process was started Displaying Named Process Information PPD Command The PPD command displays the names process IDs and ancestors the process creators of named processes currently in the destination control table DCT a table that contains information about processes Use the ...

Page 68: ...using the name of the ancestor Z048 Z048 is the TACL process on the terminal named OPCONS which on this system is the operator console 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 Note Because large numbers of processes might be running on your s...

Page 69: ...ommand options such as input and output files to be used by the program the processor where the process runs the name and execution priority of the process and the number of data pages to be used You can enter a RUN command either explicitly or implicitly Name Primary Backup Ancestor ZL00 0 3 Z001 1 51 0 69 BA1 ZSCB 1 113 0 70 ZSCA ZLOG 0 47 1 47 ZTAS ZELM 0 51 1 49 ZTAS ZL01 1 3 Name Primary Back...

Page 70: ...vices must run at low PINs you might want to run an application at a high PIN if there is a shortage of low PINs To run the application ACCOUNTS at a high PIN enter HIGHPIN ON specifies that the program will run at a high PIN if the HIGHPIN flag is set in the object file and library file if any and if a high PIN is available For more information about running a program at a high PIN from the TACL ...

Page 71: ...op the process When you press Break the TACL prompt appears but the FUP process continues to run concurrently with the TACL process as shown by the STATUS command When you enter PAUSE the TACL process is interrupted and the FUP prompt reappears After the FUP process stops the TACL program will redisplay its command prompt Stopping a Process Before you shut down your system you must stop all runnin...

Page 72: ...the screen This example invokes the NFO command file shown above You can abbreviate the OBEY command with an O The TACL program reads the NFO file executes the commands sequentially and displays this information COMMENT Execute a WHO Command WHO COMMENT List all files in GERT STEIN FILES GERT STEIN COMMENT Set my TACL prompt to my current volume SETPROMPT VOLUME 14 O GERT STEIN NFO COMMENT Execute...

Page 73: ...inal 1 Go to another terminal 2 Enter a command to restart the TACL process specifying As both the IN and OUT options the name of the terminal where you want the TACL process to run As the NAME option the name of the TACL process As the CPU option the CPU number of the processor to run the primary process After the final slash following the run options the CPU number of the processor to run the ba...

Page 74: ...m FUP enter Each program displays its startup screen which includes its program banner copyright message and prompt 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 24 PERUSE PERUSE T9101D10 08JUN92 SYSTEM WEST Copyright Tandem Computers Incorporated 1978 1982 1983 1984 1...

Page 75: ...iled Run the process in a different processor The user might be using a nonexistent program file User must use the correct program file Inadequate swap file space might exist Make more disk space available A security violation might have occurred Obtain security or alter security A process stops unexpectedly Users cannot access the process An application or system error occurs Restart the process ...

Page 76: ...Starting and Controlling Processes With TACL Guardian User s Guide 425266 001 4 12 Solving Common System Process Problems ...

Page 77: ... and macros you can reduce The length of commands you must type by defining a function key or creating a short macro name for a long command or a series of commands Problems caused by typing errors by reducing the typing you must do for common commands The amount you must remember or look up the command syntax For more information on these topics see the TACL Reference Manual and the TACL Programm...

Page 78: ...ubvolume using a text editor such as TEDIT Give the file a descriptive name such as MYKEYS For each function key you want to define enter SECTION TACL directive that indicates the beginning of a definition function key Name of the function key you are defining Unshifted function keys F1 through F16 or shifted function keys SF1 through SF16 type Type of definition ALIAS or MACRO Other types of func...

Page 79: ...own in the example below To include comments in an alias definition use braces or double equal signs you cannot use the COMMENT command because this definition can contain only one command These examples show alias key definitions for some frequently used commands SECTION F1 ALIAS FILES SECTION F2 ALIAS FILE Display information about my files INFO SECTION F3 ALIAS PERUSE Start PERUSE SECTION F4 AL...

Page 80: ... Info about processes at this terminal Include a dummy argument for each variable You can include a dummy argument for each variable in the command A dummy argument is a number surrounded by percent signs such as 1 2 and 3 Then before you press the function key type the actual values for each variable on the TACL command line The dummy arguments in this TFORM command are replaced by the real value...

Page 81: ...ment To pass arguments to the STATUS command when you invoke it enter the values in proper order including all required punctuation and then press F8 For example enter Then press F8 The second example uses a macro definition because it executes a command that includes two command arguments and all required punctuation It also contains two commands STATUS and COMMENT To execute the STATUS TERM comm...

Page 82: ...nd Comments inserted using the COMMENT command are displayed but comments inserted with or are not displayed Using Your Function Keys After you load your function key definitions into TACL memory you can press a defined function key to execute the associated command For example if you defined F1 as the FILES command pressing F1 lists the files in your current subvolume If the command defined for a...

Page 83: ...he spooler location substituted for 2 2 Press F7 This function key definition is equivalent to 3 Press F3 the key defined to run PERUSE You can see that your file is spooled to S PRINT2 Suppose you created this macro function key definition SECTION F8 MACRO STATUS 1 2 3 In this definition the comma following the first dummy argument is required by the STATUS command The first dummy argument repres...

Page 84: ... display the commands you entered and the function keys you pressed at each command line enter the HISTORY command 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 7 4 PRI 150 Process Pri PFR WT Userid Program file Hometerm Z43 4 23 150 ...

Page 85: ...les see the TACL Programming Guide Using a Library File Creating and loading a general purpose library file that contains macro definitions is similar to creating and loading a macro that defines your function keys However to invoke the macro you enter the macro name at the TACL prompt instead of pressing a function key A library file is an EDIT file file code 101 Create this file in your saved de...

Page 86: ...efinition invokes TFORM with two arguments The first argument is the input text file the second argument is the spooler location for the output For example to run TFORM on a file named INFILE and send the output to the location LAZER The MYINFO macro definition contains a sequence of commands When you invoke this definition TACL executes the STATUS WHO and FILES commands The H and MYINFO macro def...

Page 87: ...ring the TACL MACRO directive and the commands you want the macro to perform into an EDIT file file code 101 To create a macro that performs the WHO command To execute the macro enter Files that contain a TACL MACRO directive cannot be loaded into memory as library files are You can store only one macro definition in a file that starts with the TACL MACRO directive Instead use the SECTION directiv...

Page 88: ...nitions LOAD KEEP 1 MYMACS Load My Macro Definitions Your TACLCSTM file must begin with a TACL MACRO The LOAD commands in this example are the same as those you would use to load your library files every time you log on 3 Add comments as needed using the COMMENT command the double equal signs or braces 4 Add any other commands that you want to execute when you log on For example you can enter a SE...

Page 89: ...ing time Setting attributes for a spooler job with a SPOOL DEFINE is faster than setting the attributes with Peruse after the job is on the print queue Using a TAPE DEFINE lets you access labeled tapes if labeled tape processing is enabled for your system To use a DEFINE you should be familiar with the TACL program including its relationship to other processes running on your system See Section 4 ...

Page 90: ...ctions If you start a process and then create a DEFINE for this process the DEFINE has no effect on the process You must create the DEFINE before you start the process You can store the commands that create a DEFINE in a command file When you want to use the DEFINE you simply execute the command file You can also edit the command file if you want to change the DEFINE DEFINE Names A DEFINE name is ...

Page 91: ...EFINE names For example the DEFINE template CUST matches all DEFINE names that begin with CUST DEFINE Classes The primary attribute of a DEFINE is the CLASS attribute which identifies the DEFINE subtype 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 SUBSO...

Page 92: ...EFINE displayed with the TACL INFO DEFINE command The DEFAULTS DEFINE Is always propagated to a new process regardless of the DEFMODE setting Cannot be deleted or renamed but can be displayed and altered Is automatically modified by the TACL program to match its current volume setting and is set from the default volume in the startup message Attributes for the DEFAULTS DEFINE are VOLUME SWAP and C...

Page 93: ...reating and Using a DEFINE on page 6 9 TAPE DEFINE A TAPE DEFINE lets you access a file on a labeled tape This DEFINE associates labeled tape attributes such as LABELS VOLUME and DENSITY with a DEFINE name such as TAPE JOB You can use a TAPE DEFINE wherever a tape file name can be used For example to transfer a file from a labeled tape to a disk volume you first create a TAPE DEFINE that contains ...

Page 94: ...agated to this new process 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 DEFMODE ON Default DEFINEs are enabled The system uses existing DEFINEs in your current TACL process and propagates them to any ...

Page 95: ...l DEFINE attributes including SEARCH SORT and SUBSORT attributes are described in detail under the SET DEFINE command in the TACL Reference Manual Initial Attribute Settings A DEFINE attribute might have an initial setting depending on whether it is A default attribute has an initial default value For example the default value for CLASS is MAP A required attribute does not have an initial value Yo...

Page 96: ...thout an initial value If you set the CLASS attribute to TAPE the working attribute set becomes all the tape attributes but only the LABELS attribute has a value OMITTED Attribute Consistency Checks When you enter an ADD DEFINE ALTER DEFINE or SHOW DEFINE command the system performs an attribute consistency check on the DEFINE you specified The system verifies that values are set for all required ...

Page 97: ...and class for the DEFINE as well as any other attributes you want to define Table 6 1 TACL DEFINE Commands Command Function SET DEFINE Sets the values for one or more DEFINE attributes in the working attribute set SHOW DEFINE Displays a value associated with a specific DEFINE attribute all attribute values that are currently set or defaulted or all attributes in the working attribute set ADD DEFIN...

Page 98: ...on file set to the SPOOL DEFINE you just created This command also sends any FUP messages to the OUT file FUPMSGS and includes the NOWAIT option so FUP runs in the background 2 Use Peruse to see the spooler job attributes for the spooler job created by FUP This job has the attributes specified in your SPOOL DEFINE After two copies are printed the job remains on the print queue You can print additi...

Page 99: ...s 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 ...

Page 100: ...Part II Managing Files Using the File Utility Program FUP Guardian User s Guide 425266 001 ...

Page 101: ...on 16 Managing Users and Security You can enter FUP commands at the TACL prompt interactively through FUP itself or through a command file You can also programmatically execute some commands from an application These commands use Subsystem Programmatic Interface SPI buffers and procedures for the FUP commands and responses See the File Utility Program FUP Management Programming Manual for details ...

Page 102: ...ugh the TACL program you can enter only one command at a time A separate FUP process starts and completes for each command you enter Entering FUP Commands Interactively Through FUP After you start a FUP process you can enter commands at the FUP prompt To start an interactive FUP process enter FUP with no command name or other options at the TACL prompt FUP displays its program banner and prompt a ...

Page 103: ... To execute FUP commands in a command file specify the command file as the input file with the IN option when you start a FUP process For example these commands which are in a command file named ALLSUBS list the subvolumes in the disk volumes DISK1 DISK2 and DISK3 SUBVOLS DISK1 SUBVOLS DISK2 SUBVOLS DISK3 To execute these commands enter a FUP command specifying ALLSUBS as the input file Control of...

Page 104: ...t file with the OUT option For example if ALLSUBS is a command file and SUBINFO is a file you are using for the output you can enter To send output to a printer specify the name of the printer with the OUT option in your FUP command You can also include an output file with individual FUP commands The OUT file you specify in an individual FUP command overrides any OUT file you specified when you in...

Page 105: ...commands As the destination file in a COPY or BUILDKEYRECORDS command When you use a SPOOL DEFINE with a FUP command output from the command is spooled to the spooler location that is specified with the LOC attribute in the DEFINE If this location is a printer the FUP command output is queued and then printed Otherwise the output remains in the spooler where you can view redirect or delete it with...

Page 106: ...P command parameters must not conflict with the DEFINE attributes For example if you specify a RECIN value in a COPY command that sends output to a TAPE DEFINE that contains a RECLEN value the two record length values must agree or FUP returns an error These examples demonstrate the use of TAPE DEFINEs with the FUP COPY command to transfer data from disk to tape or vice versa Because no block or r...

Page 107: ... information such as the COPY FILES INFO LISTOPENS SHOW and SUBVOLS commands FUP redisplays its prompt and waits for a new command If FUP is executing any other command it returns control of the terminal to the TACL program and continues to execute the command in the background After the TACL program takes control of your terminal you can return control to FUP by entering the TACL PAUSE command To...

Page 108: ... when you start the FUP process To change the default values kept by FUP enter FUP SYSTEM and VOLUME commands For example to change the current default system enter SYSTEM followed by the name of the system To return to the initial default system enter SYSTEM without a system name You can change the default volume the default subvolume or both with the FUP VOLUME command To change only the default...

Page 109: ... enter the SUBVOLS command alone you receive a list of the subvolumes in your current default system and volume Use the FILES command to get a list of the files in a subvolume Enter the FILES command followed by the name of the subvolume In the FUP FILES command you must include the system name volume name or subvolume name only if it differs from the current default value For example this command...

Page 110: ...re reserved by Compaq for system codes For example code 100 is assigned to all TNS program object code files and code 101 is assigned to EDIT files EOF the current length of the file in bytes LAST MODIF the date and time when the file was last modified If the file was last modified on the day you enter the INFO command only the time is displayed OWNER the user ID of the owner of the file Each file...

Page 111: ...ame For a file set you can specify the name of the system volume and subvolume where each file resides just as you would for a single file If you omit any of these items FUP expands the file name or names using your current default values Wild Card Characters in File Sets You can include an asterisk or question mark in place of a volume name subvolume name or file identifier asterisk Matches zero ...

Page 112: ...es in both the current default subvolume and in the volume MANUF You can also use the INFO command to get information about files owned by a particular user on the system Enter the INFO command followed by a file set or a file set list a comma and a user name or user ID as in these examples FUP then displays information about only those files in each file set list that are owned by the specified u...

Page 113: ...an error message To overwrite an existing file with DUP you must include the PURGE option To duplicate more than one file with a single command enter DUP followed by a file set or file set list a comma and a destination To specify a destination 1 Include a system or volume name if either one differs from the current default value 2 For the subvolume name specify either of A single subvolume name f...

Page 114: ...ience problems use the RESTARTABLE option That way in case the duplicate operation fails before it is finished a subsequent RESTART command continues the duplicate operation from the point of failure rather than from the beginning saving system time and resources FUP saves the restart information in a disk restart file file code 855 You can name this restart file in your DUPLICATE command or you c...

Page 115: ...DUPLICATE command To rename a set of files specify a file set just as you would for the DUPLICATE command When you RENAME a file set however all the file names must remain the same only the subvolume name can change Enter RENAME followed by a file set or file set list to be renamed a comma and a destination For the destination you must specify A subvolume name different from the subvolume names in...

Page 116: ... of entering FUP codes you could enter the program values in the security string For example you could enter 4242 instead of NONO For more information about file security and security strings see the description of the FUP SECURE command in the File Utility Program FUP Reference Manual Giving Files to Other Users If you own a file you can use the FUP GIVE command to give ownership of the file to a...

Page 117: ...mpt reappears If you answer Y or y to the prompt FUP purges the file and lists the name of the purged file To purge a file without being prompted for permission add an exclamation point 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 Cauti...

Page 118: ...can choose to purge the subvolume with no more prompts YES to purge none of the files in the subvolume NONE to select the files to purge SELECT or to list the files in the subvolume FILES Type either the first letter of the word you choose or the entire word and then press Return If you choose YES FUP purges the entire subvolume with no more prompting If you choose NONE the PURGE command ends with...

Page 119: ...ng 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 PURGE IDEAS DO YOU WISH TO PURGE THE ENTIRE FILESET CORP IDEAS Y ES N ONE S ELECT F ILES S CORP IDEAS CODE EOF LAST MODIF OWNER RWEP TYPE REC BLOCK BAD 101 98732 11 15 8 44 AOGO PURGE Y CO...

Page 120: ...m on January 1 2000 except by a user with super ID 255 255 or unless you alter the expiration date again INFO FILE1992 DETAIL DISK2 ACCTS FILE1992 15 Dec 1992 11 48 ENSCRIBE TYPE U CODE 101 EXT 4 PAGES 16 PAGES MAXEXTENTS 16 BUFFERSIZE 4096 OWNER 8 76 SECURITY RWEP NUNU MODIF 15 Dec 1992 11 39 CREATION DATE 4 Dec 1992 10 39 LAST OPEN 15 Dec 1992 11 48 NOPURGEUNTIL 1 Jan 2000 8 00 EOF 4338 0 9 USED...

Page 121: ... If you do not enter a number FUP displays the last ten commands To display your last four FUP commands enter FC Command FC allows you to recall a command and then change it by deleting inserting or replacing characters It can save you keystrokes For example to use the STATISTICS option of the INFO command and you have already used the DETAIL option enter Command The command allows you to reexecut...

Page 122: ... is needed Escalate the problem Operations and database management can decide whether it is appropriate to move files partition files or create alternate key files or indexes Users or applications have problems accessing a certain file or files Failure to open an alternate key file error 4 Use the FUP commands ALTER or LOAD ALTFILE File is not in the directory or the record is not in the file erro...

Page 123: ...to file creation parameters with the FUP SET command FUP maintains a table of current file creation parameters The values of these parameters can determine the attributes of any file you create with FUP You can also override the current settings by specifying different values in your CREATE command 2 Check the values of file creation parameters with the FUP SHOW command to ensure that the values a...

Page 124: ...ou can override the current value by setting a value for a parameter in your FUP CREATE command Figure 8 1 Steps for Creating a File With FUP 001 CDT CDD SHOW SHOW RESET RESET CREATE CREATE MYFILE SET SET TYPE K SET EXT 5 2 SET REC 120 SET KEYLEN 9 MYFILE 4096 16 1 PAGE 1 PAGE U MAXEXTENTS KEYOFF KEYLEN IBLOCK BLOCK REC EXT TYPE 16 0 1024 1024 120 5 PAGES 2 PAGES K 9 SHOW TYPE K EXT 5 PAGES 2 PAGE...

Page 125: ...e key sequencing KEYLEN Primary key length KEYOFF Primary key offset NO NULL Null Value QUEUEFILE Queuefile attributes UNIQUE Unique key specifications PHYSVOL Volume location specifications ALTKEY Alternate key specifications ALTFILE File name of an alternate key file ALTCREATE Automatic creation of alternate key files PART Secondary partition specifications PARTONLY Creation of individual partit...

Page 126: ...to display the current values of the parameters If you enter the SHOW command just after you start FUP the initial default values are displayed The TYPE parameter determines the file type of a file The default TYPE value is U for Unstructured The EXT parameter determines the sizes of primary and secondary file extents the default extent sizes are 1 page each a page is a unit of 2048 bytes MAXEXTEN...

Page 127: ...ys and partitioned files Before you create a file enter a FUP SHOW command and check that the values of the file creation parameters are the ones you want Correct any parameters you want to change and then create the file 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 value...

Page 128: ... partitioned files and files that match the attributes of an existing file Each example shows the series of commands needed Creating an Unstructured File 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 unstructu...

Page 129: ...EQ whose primary extent and secondary extent sizes are four pages each and whose data block length is 2048 bytes enter SET EXT 10 2 You can specify extent sizes in pages bytes records and megabytes If you do not specify a unit FUP assumes that the unit is pages SET CODE 999 Set the file code used to identify the file SHOW Show the current parameter values TYPE U CODE 999 EXT 10 PAGES 2 PAGES MAXEX...

Page 130: ...cord relative to the first record in the file Records are retrieved randomly using record numbers Figure 8 2 Structure of an Entry Sequenced File 002 CDT CDD Entry Sequenced File Primary access is in the sequence in which records are stored in the file Example READ READS FIRST READ READS SECOND READ READS THIRD Latest Records are stored in the order in which they are presented to the system that i...

Page 131: ...format for a record in a key sequenced file SET TYPE R Set the file type to relative SET EXT 5 2 You can specify extent sizes in pages bytes records and megabytes If you do not give a unit FUP assumes pages SET REC 120 Set the record length to 120 bytes SHOW Show the current parameter values TYPE R EXT 5 PAGES 2 PAGES REC 120 BLOCK 4096 MAXEXTENTS 16 CREATE RELATIVE Create the file CREATED USERS J...

Page 132: ...red values SET TYPE K Set file type as key sequenced SET CODE 1000 You can optionally specify a file code to identify the file SET EXT 16 1 Set primary and secondary extent sizes for the application SET REC 150 Set record length and block size SET BLOCK 2048 SET COMPRESS If desired you can specify data and index compression SET KEYLEN 34 You must specify a primary key length for key sequenced file...

Page 133: ... 8 6 Possible Record Format Key Sequenced File With Alternate Keys 005 CDT CDD Key Sequenced File Primary access is by a value in the primary key field Example FIND KING Record Primary Key Key Sequenced File Records are stored in ascending order of primary key field value ADAMS BROWN COLLINS FISH JACKSON KING MASTERS OBRIEN RYAN WATSON ZANTE 006 CDT CDD Byte Offset 0 2 32 40 42 46 54 Alternate Key...

Page 134: ...econdary partition on VOL2 contains records whose primary key begins with HA and subsequent records up to but not including records whose primary keys begin with QU All other records that is those records whose primary keys begin with QU and all subsequent records will reside in the second secondary partition on VOL3 To create a file in key sequenced partitioned format enter the following FUP comm...

Page 135: ...ent sizes for the application SET REC 128 Set the record length SET KEYLEN 20 Specify the primary key length required for key sequenced files Specify the partitions their volumes primary and secondary extent sizes and the partial key values 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 007 CDT CDD VOL1 PARTFILE PART VOL1...

Page 136: ...d with the LIKE option FUP then sets its file creation characteristics to match those of the file you specify New files you create will have those attributes INFO CLEAN BERKELEY AIR DETAIL CLEAN BERKELEY AIR 10 Feb 1992 16 10 ENSCRIBE TYPE K EXT 5 PAGES 5 PAGES REC 80 BLOCK 2048 IBLOCK 2048 KEYLEN 9 KEYOFF 0 DCOMPRESS ICOMPRESS MAXEXTENTS 16 OWNER 8 44 SECURITY RWEP NUNU MODIF 25 Jan 1992 19 08 CR...

Page 137: ...changes to the file label use the FUP ALTER command Some examples in this section show file operations for which you must make file label changes with the FUP ALTER command The appropriate ALTER commands are included Loading Data Into Files You can move data between files using these FUP commands DUP to duplicate an entire file the original file and copy must be disk files COPY to move data one re...

Page 138: ...n of the LOAD command in the File Utility Program FUP Reference Manual for more information Purging Data From Files Use the PURGEDATA command to purge data from a file without deleting the file When you enter the PURGEDATA command the end of file EOF pointer is set to 0 and other file label values indicating the size of the file are reset to indicate that the file is empty PURGEDATA does not howev...

Page 139: ...o move them enter The ALTER command changes the name of the alternate key file in the file label of PRIFILE from VOL1 SVOL AFILE to NEW SVOL AFILE After you complete the DUP and RENAME operations you can purge the original file Copying Files to a Backup Volume Copying disk files to a backup disk volume gives you quick access to the file copies However you should use disk backups in addition to not...

Page 140: ...any other alternate keys into the alternate key file To allow for future growth of the file you can reserve empty space in index blocks by specifying a percentage of slack space with the LOADALTFILE ISLACK option However when you add a new alternate key the length of the key can be no longer than the longest key already in the alternate key file unless you Use the SET LIKE command to duplicate the...

Page 141: ...el for the primary key file FILEA so that it specifies FILEB as the alternate key file and contains the key specifier XY Finally the LOADALTFILE command loads the alternate key records into the alternate key file Note that an index block slack percentage of 0 is the default value Modifying Partitioned Files Changing partitioned files involves making changes to specific partitions then modifying th...

Page 142: ...te key records for the key specifier F2 VOL3 SVOL AFILE contains the alternate key records for the key specifier F3 To load the alternate key records for the key specifier F2 into the file VOL2 SVOL AFILE enter The CREATE command creates a temporary disk file to be used for output from the BUILDKEYRECORDS command Next BUILDKEYRECORDS generates alternate key records that are to be loaded into the n...

Page 143: ...ust ensure that the partition is not being written to if the preceding sequence of operations is to succeed File access modes are discussed in the ENSCRIBE Programmer s Guide Adding Partitions You can add partitions to relative and entry sequenced files that do not already have them but not to key sequenced files This example uses a nonpartitioned relative file named VOL1 SVOL RELFILE To add a par...

Page 144: ...ing a file improves the access time and use of space for a key sequenced file or SQL object that has undergone a large number of insertions deletions and updates To reload a file called PAYFILE enter 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 informati...

Page 145: ...t 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 ...

Page 146: ...Part III Managing Disk and Tape Processes Guardian User s Guide 425266 001 ...

Page 147: ... Half of a Mirrored Disk 9 9 Bringing Up the Down Half of a Mirrored Disk 9 11 Finding and Sparing Bad Tracks and Sectors 9 12 Managing Disk Space Usage 9 14 Monitoring and Altering Swap Files 9 23 Solving Common Disk Problems 9 28 Table 9 1 SCF Command Summary page 1 of 4 Command Function ABORT Does not support TAPE device in G series releases Stops the operation of an object without regard to th...

Page 148: ...mmand COMMENT Allows the specification of descriptive text in command files CONFIRM Enables or disables the display of positive responses from subsystems CONNECT Establishes a connection between two objects CONTROL Does not support TAPE device in G series releases Allows the user to issue certain disk specific commands such as rebuilding the free space table on magnetic disk COPY Copies an object ...

Page 149: ...object hierarchy NAMES Displays the names described by an object name template OBEY Causes commands to be read from a file in noninteractive mode OPEN Initiates communication with a specified SCP OUT Redirects SCF displays PAGESIZE Sets the terminal screen size and printer page size PARAM Changes adds and displays PARAM values passed to a process initiated by the SCF RUN command PAUSE Suspends SCF...

Page 150: ...iguration database STOPOPENS Does not support TAPE device in G series releases Prevents any additional opens to an object SUSPEND Restricts the use of the connections both to and from an object Application requests except close requests are rejected The SUSPEND command places the object into the SUSPENDED state SWITCH Does not support TAPE device in G series releases Causes the primary path to bec...

Page 151: ... STORAGE Status DISK SHARK DATA02 LDev Primary Backup Mirror MirrorBackup Primary Backup PID PID 62 STOPPED STOPPED STOPPED STOPPED 0 268 1 265 STORAGE Status DISK SHARK DATA09 LDev Primary Backup Mirror MirrorBackup Primary Backup PID PID 55 STOPPED STOPPED STOPPED STOPPED 3 265 2 260 STORAGE Status DISK SHARK DATA10 LDev Primary Backup Mirror MirrorBackup Primary Backup PID PID 54 STOPPED STOPPE...

Page 152: ...K disk Example To bring the disk DATA back up from a regular STOPPED state log on as a super group user 255 n and enter SCF START DISK DATA Bringing Up a Path From STOPPED Enter SCF START DISK disk P B M MB You must specify one of the following parameters for mirrored disks P for primary path B for backup path M for mirror path or MB for mirror backup path Bringing Up a Disk or Path From a STOPPED...

Page 153: ...tem has not been reconfigured A diagnostic program is to be run on the disk Taking Down a Disk 1 Make sure you are logged on as a super group user 255 n 2 Stop the disk SCF STOP DISK disk 3 Check the disk status to confirm it is down SCF STATUS DISK disk Example To make the disk AMBER inaccessible to user processes 1 Make sure you are logged on as a super group user 255 n 2 Take the disk down SCF ...

Page 154: ... path the following message is displayed 3 Check the path status to confirm it is down SCF STATUS DISK disk Example To make the primary path to the mirror disk DATA inaccessible 1 Make sure you are logged on as a super group user 255 n 2 Stop the path SCF STOP DISK DATA M 3 Check the path status to confirm it is down SCF STATUS DISK DATA A listing similar to this is displayed on your home terminal...

Page 155: ...red disk to use for backups or other purposes 1 Make sure you are logged on as a super group user 255 n 2 Bring the application to a quiet state to ensure the integrity of the files This does not require that application programs close their files but that the current transactions are completed normally 3 If the target disk is protected by the Transaction Management Facility TMF subsystem disable ...

Page 156: ...o the disk half STOP DISK disk M FORCED STOP DISK disk MB FORCED FORCED means that SCF continues even if there are open files on the disk A warning message and verification request is displayed 8 Enter Y to continue STOP DISK brings down the device on which the disk is mounted 9 Issue the SCF STATUS DISK command and check to verify that the STOP command put the specified disk in the STOPPED state ...

Page 157: ...tart the SCF program SCF 3 Check for bad sectors and checksum errors on disk INFO DISK disk BAD 4 If there are errors correct them 5 Perform the START DISK operation START DISK disk A warning message and verification request is displayed 6 Enter Y to continue The START DISK operation copies data from the up half to the down half while concurrent processing on the up half continues To check the sta...

Page 158: ...ormatted a fixed number of sectors are reserved at the end of each cylinder as spares This number varies depending on the type of disk These spare sectors are used only if defective sectors are found on the cylinder Sparing sectors is the process of assigning alternate sectors from the available spare sectors to be used in place of defective sectors removing associated unspared bad sector entries ...

Page 159: ...home terminal This listing shows sectors on this disk that the disk process has flagged as bad 2 Make sure you are logged on as a super group user 255 n 3 Stop all other processing on the disk 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 Caution Do no...

Page 160: ...as needed based on your analysis by either using DCOM to compress existing files and subvolumes or by purging old and unneeded files and subvolumes You can analyze disk space using either the Subsystem Control Facility SCF or the Disk Space Analysis Program DSAP Analyzing Disk Space Usage With the Subsystem Control Facility SCF The SCF STATUS DISK DETAIL command lists the number of free pages the ...

Page 161: ...r 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 STORAGE Detailed Status DISK SHARK AMBER Disk Path Information LDev Path PathStatus State SubState Primary Backup PID PID 63 PRIMARY ACTIVE STARTED 0 267 1 266 63 BACKUP INACTIVE STARTED 0 267 1 2...

Page 162: ...wever the report has an output width of 132 columns and a page length of 60 lines The spooler report also has a header at the top of each page which includes a page number The SEPARATE option in the example above makes the information for each user start on a new page Examples These examples show how to use DSAP to generate reports with information based on different specified criteria Generating ...

Page 163: ...y the user SALES BONNIE user ID 8 1 on the disk DATA1 enter DSAP DATA1 BYSUBVOL USER 8 1 Disk Space Analysis Program T9543D20 01JUN93 10 10 93 15 17 38 Tandem Computers Incorporated 1981 1983 1985 1993 Free Space Short Report Capacity Mb Free Extents Volume M Total Free Free Count Biggest DATA1 Y 1038 103 17 9 77 31 76 Summary of space use on DATA1 5 646 free pages in 319 extents 1 2 428 645 alloc...

Page 164: ...ncorporated 1981 1983 1985 1993 Summary of space use for SALES BONNIE on DATA1 234 allocated pages in 8 files in 19 extents 0 0 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 Num Files Pages Pages Pages File Mod Opn Exp BONNIEF 6 162 23 0 140 6 0 6 MEMOS 2 72 1 0 64 0 0 2 10 DSAP DISK2 ...

Page 165: ...14 35 20 Tandem Computers Incorporated 1981 1983 1985 1993 Summary of space use for ACCTS JUDY on DISK2 1 962 allocated pages in 111 files in 513 extents 0 9 255 unused pages in 72 files 0 1 0 deallocatable extent pages in 0 files 0 0 No SQL views PAGE 1 DSAP ACCTS JUDY Subvol Summary Report Subvolume Name Total Unused Dealloc Large Min Age Num Files Pages Pages Pages File Mod Opn Exp TEMPORARY FI...

Page 166: ...eeded Check with the managers of such users before you purge any 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 Disk Space Analysis Program T9543D20 01JUN93 3 2 94 14 35 20 Tandem Computers Incorporated 1981 1983 1985 1993 Summary of space use for USERS FRED on DISK2 138 allocated pages in 9 files in 34 ext...

Page 167: ... security if you are authorized to do so or you might need to contact your operations manager or database administrator 2 Purge the files or subvolumes you have determined are old To purge a single file within a given subvolume enter PURGE subvolume file To purge an entire subvolume enter FUP PURGE subvolume name Example 1 Generate a DSAP report that lists all the subvolumes on DATA1 owned by the ...

Page 168: ...e subvolume BONN VOLUME BONN FILEINFO A report such as this is displayed on your home terminal This report shows that no files have been changed since July 1991 3 Purge the file MISC PURGE BONN MISC 4 Purge the subvolume BONN FUP PURGE BONN FUP responds with Enter Y to complete this operation DATA1 BONN Code EOF Last Modification Owner RWEP PExt SExt LOG 101 2092 13 Jul 91 14 41 08 8 001 NUNU 6 6 ...

Page 169: ...hared run time libraries SRLs KMSF reduces the time required to resize a segment The KMSF implementation of segment resizing requires neither I O nor dispatches of other processes By centralizing swap files KMSF makes it easier to manage swap space for all processes on the system For more information see the Kernel Managed Swap Facility KMSF Manual How Kernel Managed Swap Space Works When a proces...

Page 170: ...the process from KMSF If there is a shortage of available physical memory the memory manager finds a page suitable for swapping such as a page belonging to an inactive process If the chosen page contains dynamic data rather than code or read only data its contents must be saved on disk The memory manager requests swap space from KMSF which finds and allocates swap space against the reservation How...

Page 171: ...tional swap files because the size and number of temporary files that were formerly used for swapping decline as usage of KMSF increases KMSF and Applications Under KMSF the memory needs of processes including the main stack globals heap space extended data segments and shared run time library SRL instance data are copied to a common swap file or files managed by the NonStop Kernel You do not need...

Page 172: ...isplays a swap file s total number of processor pages as well as the pages that are allocated and available as follows 3 Display statistics for each processor using the STATUS KMSF command NSK STATUS KMSF SYSTEM SYS66 35 NSKCOM NSKCOM T9050D42 BASE 01JULY96 Copyright c 1995 Tandem Computers Incorporated SYSTEM SYSTEM ZSYSCFG KMS SWAPFILE 0 SWAP0 SYSSWAP SWAP00 THRESHOLD 80 KMS SWAPFILE 1 DATA1 SYS...

Page 173: ...ages 60 for 23 Reservations Available pages 4100 KMSF statistics from CPU 1 Total swap space 560 MB Reserved CPU Pages 412 for 35 Reservations Available pages 4110 Historical data Reservations Creates 46 failures 0 Releases 28 failures 0 Resizes 16 failures 0 Actual use Allocates 0 failures 0 Frees 0 failures 0 NSK Total swap space Total number of megabytes MB that are currently allocated in kerne...

Page 174: ...ror 43 occurs unable to obtain disk space for file extent Use the DCOM program to consolidate disk space usage A disk is full Error 43 occurs Ask users to purge files An application might go down Identify large old and little used files with DSAP Back up such files or purge them if you have the authority See Listing and Purging Old Disk Files on page 9 20 An Object Monitoring Facility OMF warning ...

Page 175: ...nformation about a tape file such as the volume ID tape density and operator mount messages This section explains how to use the MEDIACOM program to perform routine operations relating to the tapes and tape drives on your system 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 fr...

Page 176: ... a message similar to this is displayed A job does not start until the system determines that the requested tape is mounted The MEDIACOM Interface Some MEDIACOM commands require that you log on as a super group user 255 n but in general MEDIACOM lets you Configure DSM TC Label and catalog new tapes Handle tape mount requests Retrieve information from DSM TC catalog entries Manage the use of uncata...

Page 177: ...sing also assigns tape drive name to ACS tape drive ALTER TAPEFILE Changes the tape file entry retention period or expiration date and the tape file entry status that represents a file in a multifile tape set ALTER TAPEMOUNT Requests a labeled tape be mounted other than the currently requested one ALTER TAPEVOLUME Changes the status of a tape in the volume catalog ALTER VOLCAT Changes operating sy...

Page 178: ...rieves attributes of a tape and any files written to it INFO VOLCAT Retrieves a volume catalog s logical and physical names owner and security level LABEL TAPEVOLUME Creates or changes a tape label for a cataloged tape OBEY Executes commands stored in a file OPEN SERVER Creates a MEDIACOM server dedicated to your session PAUSE Lets another process control the home terminal during the session POOL ...

Page 179: ...K for that drive If NLCHECK is on a super group user user ID 255 n must give permission for the open using a TAPECOM ACCEPT command for the tape drive If NLCHECK is off permission is not required Bypass Label Processing BLP Mode 1 An application generates a request at the operator console for a specific tape drive 2 The system processes the open according to the state of BLPCHECK for that drive If...

Page 180: ...DEFINE on the TACL command line you must enter the correct name of the TAPE DEFINE For example this application copies the disk file ACCOUNTS to a labeled tape using the DEFINE TAPE JOB The labeled tape server displays this mount message at the operator console This mount message includes The name of the labeled tape server process ZSVR and a message sequence number 0012 identifying the request Th...

Page 181: ... can check using the TAPECOM SHOW NLCHECK command If NLCHECK is on the labeled tape server ZSVR displays this drive request at the operator console This request includes The name of the labeled tape server process ZSVR and a message sequence number 0125 identifying the request The phrase REQUEST TO USE indicating that this is a request to use a tape drive The name of the requested tape drive TAPE2...

Page 182: ...nt If your application lets you specify the TAPE DEFINE on the TACL command line you must enter the correct name of the TAPE DEFINE 4 Mount an unlabeled tape depending on the value of NLCHECK as described in Using an Unlabeled Tape Without a TAPE DEFINE on page 10 7 Bypassing Label Protection in BLP Mode In BLP mode the system does not check the label of the tape mounted on the drive If you issue ...

Page 183: ...efore your application continues processing A TAPECOM REJECT command causes the open request to fail with file system error 194 TAPE DEFINE Attributes ZSVR 0341 REQUEST TO USE TD2 WITH NO LABEL PROTECTION HIGH PRIORITY Call when finished Table 10 2 TAPE DEFINE Attributes page 1 of 2 Attribute Function BLOCKLEN Data block size in bytes for a tape file DENSITY Tape density in bits per inch bpi DEVIC...

Page 184: ...ength for the tape file REELS Number of volumes reels or cartridges in a multivolume file RETENTION Retention period for the tape file SYSTEM Name of the system that controls the tape drive TAPEMODE Specifies the operating mode for a cartridge tape drive USE Specifies how the tape file is to be used as input or output VERSION Version within one generation VOLUME Six byte tape volume ID identifying...

Page 185: ...to store data See 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 MEDIACOM T6028D20 01JUN93 Copyright Tandem Computers Incorporated 1993 Drive Tape Tape Label Open Tape Drive Status Name Status Type Mode Process Name TAPE1 INUSE TT0046 ASSI...

Page 186: ...you want to specify as the default device The drive you specify remains in effect until you enter another TAPEDRIVE command or you end the MEDIACOM session Guidelines When writing to a tape that requires a certain recording density make sure that the specified drive supports that density MEDIACOM does not support 7 track tape drives The named device can be a network name because MEDIACOM operates ...

Page 187: ...s After taking a drive down you need to bring it back up before you can use it again Taking Down a Tape Drive 1 Log on as a super group user 255 n 2 Stop the tape drive SCF STOP TAPE tape Example 1 Log on as a super group user 255 n 2 Enter SCF STOP TAPE TAPE1 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...

Page 188: ...d the operator console When a job wants to open a standard labeled tape or a tape drive ZSVR sends the request to the operator console ZSVR also sends error messages and status messages to the operator console Tape processes read the labels on mounted tapes and send the information to ZSVR Tape processes also perform the actual reading and writing of tapes If a tape process encounters any problems...

Page 189: ...al log on as a super group user 255 n and enter MEDIACOM MC ALTER CONSOLE Following are some examples of labeled tape processing messages Responding to Messages and Requests Labeled tape operation messages fall into these categories ZSVR error and status messages Tape process error and warning messages Labeled tape and scratch tape mount requests Tape drive usage requests Operator attention reques...

Page 190: ...density selection set to a density incompatible with the data on the tape A tape is bad Tape process messages are displayed in the format tape is the tape device that is reporting the error number is the error number 0001 0499 are tape process error messages and 0901 0999 are tape process warning messages text describes the error situation containing any applicable volume serial numbers Example Ta...

Page 191: ... SYS23 ZZZSA001 SYSTEM SYS23 ZZZSAOO2 ZSERVER NAME ZSVR NOWAIT PRI 100 CPU 1 2 Responding to Tape Mount Requests Labeled tape messages are sent to the operator console and any other console that you have designated All labeled tape messages that have a sequence number require some action from you When you receive a request to mount a labeled tape or a scratch tape 1 Install or remove the write rin...

Page 192: ... assumed to be for an ANSI standard labeled tape vid is the volume serial number reel is a number from 1 through 255 that specifies the particular reel for a tape file that extends over multiple volumes density is either 1600 or 6250 bits per inch tape is the tape drive name in the system displayed if you specify device in the tape DEFINE or if the mount message is for a continuation volume of a m...

Page 193: ...BC 2 Remove the write ring from the tape reel 3 Mount the tape on TAPE 4 Ready the drive For an IBM format Scratch Tape Mount Request 1 Find an IBM standard labeled tape from the IBM scratch tape pool 2 Install a write ring on the tape 3 Mount the tape on TAPE 4 Ready the drive Responding to Tape Drive Usage Requests When you receive a tape drive usage tape mount request you first view the request...

Page 194: ...r assigned by ZSVR tname the name of the tape being requested in the message type the type of tape label or label processing mode ANSI IBM BLP and so on nodedev the name of the node where tname must be mounted or the name of the tape drive to use prot specifies whether to protect tname from being overwritten action specifies the action you must take for processing to continue such as ACCEPT OR REJ...

Page 195: ...ng to Operator Attention Requests When a tape process does not recognize a tape the ZSVR process sends a message to the operator console asking you to check the tape mounted on the drive The operation cannot continue until you either accept or reject the request in the message These requests are displayed in the format seq is the 4 digit message sequence number that identifies this request tape is...

Page 196: ...y information about a tape s label you can relabel a tape remove a tape s label and set whether labeled tapes are to be unloaded after being labeled or relabeled Labeling Tapes You can create ANSI standard labeled tapes using the MEDIACOM ADD TAPELABEL command The MEDIACOM ADD TAPELABEL command LABELS IBM option creates IBM MVS standard labeled tapes Label a tape in ANSI or IBM format 1 Manually w...

Page 197: ...messages such as The first message indicates that MEDIACOM has control of the drive and is waiting for the tape to be mounted The second message indicates that the labeling operation is complete To write the volume serial ID XYZ to an unlabeled tape mounted on TAPE1 adding a babel which includes the owner field SOFTWARE enter MC TAPEDRIVE TAPE1 MC ADD TAPELABEL LABELS IBM XYZ OWNER SOFTWARE To wri...

Page 198: ...beled tape To display tape label information 1 Log on as a super group user 255 n 2 Enter this MEDIACOM command MC INFO TAPELABELS TAPEDRIVE tape DETAIL 3 Mount the tape on the selected tape drive 4 Ready the drive and press Return 5 MEDIACOM displays one of these ANSI TAPE Followed by two to three 80 byte records The VOL1 record contains the volume serial number and the owner s user ID the HDR1 l...

Page 199: ...e TAPEDRIVE tape new tape name is the name you want to use in the relabel operation 4 Mount the tape on the selected tape drive 5 Ready the drive and press Return When the relabeling process is complete this message is displayed The relabeling operation changes the volume serial identification number of standard labeled tapes Examples Relabeling Standard Labeled Tapes To relabel an ANSI format sta...

Page 200: ... to unlabeled tapes enter MC DELETE TAPELABEL T11046 T03347 T00297 T00345 PROMPT OFF TAPEDRIVE TD006 Setting Whether Tapes Are Unloaded After Labeling You can set whether the system unloads a tape after it performs the labeling operation using the MEDIACOM commands ENV UNLOAD OFF and UNLOAD ON When you set NOUNLOAD on the system leaves the tape online at the load point after it completes a labelin...

Page 201: ...ult value when MEDIACOM is started The UNLOAD OFF condition applies to the following commands ADD 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 Tape Drive NO SESSION DEFAULT SET File Catalog SKY FILE_CATALOG_SKY Volu...

Page 202: ... solutions to some common problems include If you premount a tape and it is unloaded after being placed online look for the following error message For error code 151 either the tape is blank or the density of the data on the tape is lower than the density switch setting on the drive For error code 120 the density of the data on the tape is higher than the density switch set on the drive If the ta...

Page 203: ...ape library To create a scratch tape 1 Log on as a super group user 255 n 2 Enter this MEDIACOM command MC ADD TAPELABEL tape name tape name SCRATCH The ADD TAPELABEL command is not intended for tapes cataloged in a DSM TC system 3 Mount the tape that has the specified vid on the selected tape drive 4 Ready the drive and press Return Example In this example three tapes that contain unexpired files...

Page 204: ...t file specifies the destination of the COPYDUMP operation For dest file specify the name of a disk file If dest file does not exist it is created during the COPYDUMP operation If dest file exists it must be empty EOF 0 and have file code 9614 For a complete list and description of all COPYDUMP options see the TACL Reference Manual Examples Copying and Compressing a Tape Dump File If a tape dump f...

Page 205: ...ite enable ring has been installed on a tape An incorrect tape was mounted or a write enable ring was not installed Verify that it is the correct tape install a write enable ring and remount the tape A runaway tape was detected or an attempt was made to access a tape whose density is lower than the switch setting on the tape drive An error 151 results The system has tried to read a blank tape or a...

Page 206: ...e a different tape A tape label record is missing or incorrect An attempt was made to access a tape with an incorrect or missing label Use the MEDIACOM INFO TAPELABEL command correct the label or use a different tape A tape fails to respond to a BACKUP command A tape with an inappropriate label type was mounted in error Use a different tape Table 10 3 Common Tape Subsystem Problems page 2 of 2 Pro...

Page 207: ... Backcopy duplicates backup tapes 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 Topic Page Why Use Backup and Restore 11 2 Supported Modes of Operation 11 2 Backing Up Your Files 11 3 Restoring Your Files 11 12 Using Labeled Tapes With Backup and Restore 11 19 Duplicatin...

Page 208: ... to tape After the files are stored on the tape you can delete them from disk If the files are needed you can restore them from the tape Move files from one system to another system For systems that are not connected on a network you can back up files on one system and then restore them on another system Prevent accidental overwriting Labeled tapes can provide protection from accidental overwritin...

Page 209: ...on See Table 11 2 For example this Backup command contains only the required elements the keyword Backup the tape drive name and a qualified file set list and copies all files from the DATA USER subvolume to the tape on the tape drive TAPE1 Backup attempts to access the tape drive TAPE1 If the drive is available Backup takes control of the drive displays its program banner and prompts you for a ta...

Page 210: ...et list A file set is one or more related files in the format system volume subvolume file id If you omit the system volume or subvolume Backup uses the current default system volume or subvolume For example if you supply only a volume name followed by a file identifier Backup fills in the subvolume name You can include these wild card characters in the volume subvolume and filename asterisk Match...

Page 211: ... and enclose them in parentheses This example shows a file set list in a command that backs up all files in the current default subvolume and all the files in the volume MANUF Using a Qualified File Set List You can use a qualified file set list to specify criteria for including or excluding files or SQL objects in a file set A qualified file set list is a file set list that includes one of the qu...

Page 212: ...a file or device from which Backup reads the command parameters If your Backup command contains a long or complicated list of files and command parameters entering the command from an IN file can be easier than entering it interactively Instead of typing the parameters when you enter your Backup command type the parameters in a command file Then when you enter the Backup command specify this file ...

Page 213: ...e file label of a primary key file ARCHIVEFORMAT Specifies archive tape format tape version 3 AUDITED Backs up files that are audited by the Transaction Monitoring Facility TMF BLOCKSIZE Sets the size of tape records blocks written to tape DENSITY Sets the recording density DP1FORMAT Creates tape files in DP1 format DP2FORMAT Creates tape files in DP2 format DSLACK Specifies minimum slack space fo...

Page 214: ...Renames a secondary partition in a partitioned file PARTIAL Backs up only files modified since a specified date PARTONLY If ON lets parts of a file be backed up without backing up all of the files partitions based on selection criteria if OFF backs up an entire partitioned file REMOTEIOSIZE Specifies the maximum size of each data block transfered between systems SCRATCHVOL Selects an alternate dis...

Page 215: ...s if you use the LISTALL option The Backup listing is displayed at the OUT file you name in your Backup command if you omit the OUT option Backup uses your terminal Regardless of the listing device you specify messages including errors and instructions are also sent to the terminal where you entered the Backup command This example shows a listing generated by Backup without the LISTALL option Back...

Page 216: ...m the backup specify them with the NOT option For example this command backs up all files in subvolume CAFFE MED except MITSLAG and MOKA 4 BACKUP TAPE3 LISTALL BACKUP Program T9074D46 07SEP98 Copyright Tandem Computers Incorporated 1981 1998 Drives TAPE3 System LAUN11 Operating System G06 Tape Version 1 Backup options BLOCKSIZE 8 NO PARTONLY Backup time 11Feb1999 10 43 Page 1 Tape 1 Code EOF Last ...

Page 217: ...and the year with spaces separating them a comma and the time using a 24 hour clock For example this command backs up all files in the system that were modified after 6 p m on January 24 1999 If you regularly back up your files you can use the PARTIAL option to save tape space and backup time Each time you back up files use the PARTIAL option to specify the date and time of the previous backup Thi...

Page 218: ... the tape reel that you are using for the restore operation This write protects your tape if your tape is write enabled and another process attempts to write to your tape your data can be damaged or destroyed 2 Enter a Restore command at the TACL prompt run options One or more run options See the RUN command in the TACL Reference Manual tape drive Name of the tape drive you are using for the resto...

Page 219: ...on sends the Restore listing to a disk file or a spooler location such as a printer You can specify an existing disk file or a nonexistent file for the OUT file If you specify a nonexistent file Restore creates an entry sequenced file with that name For example this command sends the Restore listing to the file LIST2 in the current default subvolume The IN file option specifies a file or device fr...

Page 220: ...esides on the disk LISTALL Lists all files specified in the file set list including any files that cause errors LISTONLY Lists files on the tape without actually restoring any files MAP NAMES Changes destination disk file names MULTIDRIVE Allows up to four tape drives to be queued for unlabeled tape backup operations MYID Gives restored files to the user ID running Restore NOPROMPT Instructs Resto...

Page 221: ...es the latest version of each file that was on the first back up tape REMOTEIOSIZE Specifies the maximum size of each data block transfered between systems SCRATCHVOL Selects an alternate disk volume for temporary files that Restore creates during a file conversion DP1 or DP2 SQLCATALOGS Specifies whether SQL catalogs are to be restored SQLCOMPILE Specifies whether an SQL object program is automat...

Page 222: ...iles to Not Restore on page 11 16 Specifying Files to Not Restore Use the NOT option in a Restore command to specify files on the backup tape that you do not want to restore The example below does the following Restores all the files on tape that were backed up from volume PASTRY except the files in subvolumes LINZER and PETIT4 Keeps any files currently on disk that have the same name as tape file...

Page 223: ...ith the MAP NAMES option 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 10 VOLUME PASTRY 11 RESTORE TAPE1 NOT LINZER PETIT4 KEEP MYID RESTORE Program T9074D46 07SEP98 Copyright Tandem Computers Incorporated 1981 199...

Page 224: ...ANT NOVELS by entering 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 20 RESTORE TAPE TOLSTOY NOVELS BIG1 PROUST RTP BIG1 VOL GIANT NOVELS ...

Page 225: ...p and Restore Attribute Function DENSITY Tape density in bits per inch bpi DEVICE Name of the tape drive on which all tapes must be mounted EXPIRATION Expiration date for the tape file FILEID Tape file name 17 character string GEN Integer value in the range 0001 9999 that indicates the generation number LABELS Label processing mode BACKUP IBMBACKUP or OMITTED for Backup or BACKUP IBMBACKUP OMITTED...

Page 226: ... Backup command using the TAPE DEFINE named MYBACKUP Backup displays a mount request for this job at the operator console 4 You or the operator mount the requested tape Because the DEFINE named MYBACKUP does not include a DEVICE attribute the two tapes for this Backup operation can be mounted in order on any available drive The system checks the DEFINE attributes with the mounted tape The Backup o...

Page 227: ...BLOCKSIZE 8 NO IGNORE NO OPEN NO PARTONLY Backup time 12Feb1999 22 34 Page 1 Tape 1 Code EOF Last modif Owner RWEP Type Rec Bl First tape Tape 1 volume id TP022 drive TAPE DISK WEEK BUILD 101 46282 5Feb1998 21 11 1 3 CUCU COMMENTS 101 5512 10Feb1998 18 08 1 3 CUCU COPY 101 128858 27Jan1998 2 38 1 3 CUCU COVER 101 2540 28Jan1998 18 09 1 3 CUCU CPU1 Continued on next tape CPU1 Tape change Tape 2 vol...

Page 228: ...u created for your backup command In this example you add a mount message and a device name to the TAPE DEFINE MYBACKUP used in the previous Backup example 1 View the attributes of the existing Backup DEFINE using the INFO DEFINE command as illustrated below 2 Add a mount message and a device name to the TAPE DEFINE using the ALTER DEFINE command as illustrated below 3 Enter a Restore command usin...

Page 229: ...that are not connected on a network Archival of disk files After duplicating a backup tape you can keep a copy of its content archived in case you ever need to use its content again This is true not just for disaster recovery as described above but also in the event that you later need information from files you at one point thought you would no longer need on your system Running Backcopy When you...

Page 230: ...ach reel of tape is interchangeable with its corresponding copy during a Restore When you make a second copy with Backcopy the amount of information on each tape reel can vary between the copies You mount a new tape whenever a drive reaches the end of reel you do not necessarily change tape reels for both copies at the same time The individual reels are not interchangeable only the whole duplicate...

Page 231: ...pes is the archive tape format Making one copy of a labeled tape This Backcopy command makes one copy of a labeled tape with volume identification HD004 The ADD DEFINE command sets the attributes for this labeled tape The source tape is on tape drive TAPE1 Backcopy displays a message for you to mount the destination tape The destination tape is unlabeled because the TAPE DEFINE does not define it ...

Page 232: ...Backing Up and Restoring Disk Information Guardian User s Guide 425266 001 11 26 Backcopy Examples ...

Page 233: ... about the spooler subsystem and describes using 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 ...

Page 234: ...Part IV Using the Spooler and Its Utilities Guardian User s Guide 425266 001 ...

Page 235: ...of a job after it enters the spooler For example you can send a job to a holding location on the spooler print queue and then select a printer while the job is on the queue Lets you monitor and control the status of your jobs examine a spooler job before you print or delete it and change the printer for your output No programming is necessary send your output to the spooler simply by specifying a ...

Page 236: ... process Process that accepts output from applications and stores it on disk Each spooler must include at least one but no more than 15 collectors Print process Process that retrieves a spooler job stored on disk by a collector process and prints the job to an output device Each printer in the spooler has one print process associated with it however each print process can control several output de...

Page 237: ...ob 3 The supervisor informs the print process where the job can be found on the disk 4 The print process reads the job from disk and writes the job to the printer 5 Peruse obtains the job information from the supervisor or lets you examine data on the disk 6 Spoolcom permits system operators to modify the status of spooler components Spoolcom Supervisor Peruse Application Collector Print Process D...

Page 238: ...st be printed on a printer loaded with W 2 form paper If the job has a form name of W2 it will print only on a printer that has the same form name The form name W2 is assigned to the printer when the special paper is loaded Job Priority Determines when a job will print in relation to other jobs queued for the same printer The spooler maintains a queue for all printers Higher priority jobs are plac...

Page 239: ...deletes the job unless the hold after printing flag is set Figure 12 2 Life Cycle of a Spooler Job Attribute Definition Create You create a job when your application opens a collector process and writes to it for example TFORM IN filename OUT S device Open The application writes to the collector process which in turn writes the data to a disk file Ready The job is ready when the application closes...

Page 240: ...he trailer pages have printing over the page folds enabling jobs printed on accordion fold paper to be easily separated The two page header message always appears on the top page regardless of how the job is folded The actual header message depends on the print process controlling the printer The headers described above are produced by a NonStop Kernel print process If a printer is controlled by a...

Page 241: ...NNN AAAAAAAAAAA DDD DDD MMM MMM MMM III NNN NNN NNN AAAAAAAAAAA DDD DDD MMM M MMM III NNN NNNNNN AAA AAA DDD DDD MMM MMM III NNN NNNNN AAA AAA DDDDDDDDDDD MMM MMM III NNN NNNN AAA AAA DDDDDDDDDDD MMM MMM III NNN NNN AAA AAA DDDDDDDDDD MMM MMM III NNN NNN LLL EEEEEEEEEEE EEEEEEEEEEE LLL EEEEEEEEEEE EEEEEEEEEEE LLL EEE EEE LLL EEE EEE LLL EEEEEEE EEEEEEE LLL EEEEEEE EEEEEEE LLL EEE EEE LLL EEE EEE L...

Page 242: ...f the group is a broadcast group the job is routed to all of the destinations in the group and prints on all the printers associated with the group For example assume that the location name LP EAST is associated with a line printer on the east side of the machine room and LP WEST is associated with a line printer on the west side of the machine room If LP is a broadcast group a job routed to LP pr...

Page 243: ...tion so that you can use Peruse to examine your job before it is printed Figure 12 4 shows the association of spooler locations with actual printers Figure 12 4 Spooler Routing Structure 011 CDT CDD A printer can be connected to several locations but each location is connected to no more than one printer Jobs routed to X print on one of LP1 LP2 or LP3 Jobs routed to X B print on LP2 Jobs routed to...

Page 244: ...the output in a disk file When TFORM is finished the spooler puts the job in the READY state If a printer is associated with LP WEST the job is printed when the printer is available If a printer is not associated with the location the job remains on the print queue until you delete it or send it to another printer The command is still valid if you do not specify the entire location name If LP is a...

Page 245: ... from that process has the job attributes you specified in the SPOOL DEFINE For an introduction to DEFINEs see Section 6 Creating and Using DEFINEs This example shows how to use a SPOOL DEFINE to set the attributes of a spooler job First ensure that DEFINEs are enabled for your TACL process that is the DEFMODE setting is ON If the DEFMODE is set to OFF enter a SET DEFMODE ON command Table 12 1 SPO...

Page 246: ...o the SPOOL DEFINE you just created The spooler job created by PAYLIST has the attributes specified in the SPOOL DEFINE named PAY RUN 2 To see these spooler job attributes use Peruse 11 ADD DEFINE PAY RUN CLASS SPOOL COPIES 3 11 FORM PAYLST LOC S LLP 11 OWNER PAYROLL MANAGER SELPRI 7 11 REPORT January Payroll 12 INFO DEFINE PAY RUN DETAIL Define Name PAY RUN CLASS SPOOL LOC S LLP COPIES 3 FORM PAY...

Page 247: ...am the spooler job now has these new values Deleting a SPOOL DEFINE 1 If you no longer need the PAY RUN DEFINE and don t want to wait for the TACL program to delete it when you log off you can delete it as shown below 2 Enter an INFO DEFINE command for PAY RUN The TACL program displays this message 20 ALTER DEFINE PAY RUN LOC S LAZR COPIES 1 HOLDAFTER ON 21 INFO DEFINE PAY RUN DETAIL Define Name P...

Page 248: ...Introduction to the Spooler Guardian User s Guide 425266 001 12 14 Sending Output to a SPOOL DEFINE ...

Page 249: ...ation associated with a printer number of copies or report name Print or display specific pages or all of a spooled job Copy a spooler job from the spooler queue to a spooler job file file code 129 or an EDIT file file code 101 Copy a spooler job file to the spooler queue For more information about Peruse see the Spooler Utilities Reference Manual Topic Page Running Peruse 13 2 Entering Peruse Com...

Page 250: ...JOB Job number of each job as assigned by the spooler supervisor process If a spooler job file is the current job Peruse displays FILE under this header BATCH Spooler batch job number to which this spooler job is linked For single jobs no batch number is listed STATE Status of each job OPEN The job is still being collected by the spooler READY The spooler has finished collecting the job is queued ...

Page 251: ...current job Peruse displays the file name under LOCATION and REPORT REPORT Report name that is printed in the job header message You can generate the Peruse display described above at any time during a Peruse session by entering the JOB command at the Peruse prompt Entering Peruse Commands After displaying your jobs Peruse displays its prompt an underscore _ You can enter one Peruse command per co...

Page 252: ...current job Peruse identifies this job in subsequent displays with a J to the left of the job number In the following example job number 1435 is the current job You declare a spooler job file as the current job using the JOB command For example if you have a spooler job file named JOBFILE in your current subvolume enter a JOB command and the file name and a second JOB command to invoke the Peruse ...

Page 253: ...24 F14 16384 F3 8 F7 128 F11 2048 F15 32768 F4 16 F8 256 F12 4096 F16 65536 Using the Break Key You can use the Break key in Peruse as follows If Peruse is waiting for a command pressing Break wakes the TACL program and displays the TACL prompt If you enter the PAUSE command at the TACL prompt Peruse regains control of your terminal and displays its prompt If you enter the STOP command at the TACL...

Page 254: ... the current job HOLDAFTER Sets the hold after printing flag for the current job JOB Displays information about a spooler job or job file sets the current job LINK Links a spooler job with a spooler batch job LIST Copies pages from the current job to a process terminal printer or disk file LOC Changes the routing location of the current job NUMCOL Sets the number of columns displayed by LIST OPEN ...

Page 255: ...le if your spooler job contains only one occurrence of the string ANNUAL DUES first use the FIND command to locate the string and then use the PAGE command to display the page number Use the LIST command to print page 14 Finding TFORM Errors You can also use the FIND and LIST commands to locate TFORM errors in a spooler job Because all TFORM errors begin with the string ERRORS use the FIND command...

Page 256: ... number of copies to be printed change the location for a job or change the report name with the COPIES LOC and REPORT commands For example this command string increases the number of copies to 10 changes the location to HT09 and sets the report name to MEMO The JOB command shows that the changes have been made to the job Printing Part of a Job You can print selected pages of a spooler job with th...

Page 257: ... still running Monitoring the Job Status Use the STATUS command to monitor your job while it is open The STATUS command displays a constantly updated list of your jobs and notifies you with a beep when the compilation is finished To redisplay the Peruse prompt at this point press Break 1 TAL IN SRCFILE OUT S HOLD NOWAIT OBJFILE 2 PERUSE PERUSE T9101D10 08JUN92 SYSTEM WEST Copyright Tandem Computer...

Page 258: ...and Continue searching for the error string until there are no more occurrences of it in the program For example When you have found all the errors in the program and are through with this TAL listing delete it with the DEL command and exit Peruse Correct the errors in your source file and run TAL again The following example shows a TAL compilation with the compiler listing sent to location S HOLD...

Page 259: ...rinter When your job prints Peruse displays the status as PRINT _LIST LAST Object file name is VOL1 ADMIN PROG This object file will run on either a TNS or a TNS II system Number of errors 0 Number of warnings 0 Primary global storage 44 Secondary global storage 1120 Code size 1888 Data area size 40 pages Code area size 2 pages Maximum symbol table space available 24892 used 4064 Maximum extended ...

Page 260: ...LES LIST PURGE STATUS FIND NUMCOL SJFILES VOLUME JOB PAGE STARTCOL Peruse commands that cannot be used with spooler job files are COPIES DEL FORM HOLD HOLDAFTER LOC PRI and REPORT If you issue one of these commands for a spooler job file Peruse displays the following message COMMAND NOT SUPPORTED FOR SPOOLER JOB FILES To let you access spooler job files Peruse can run without the supervisor proces...

Page 261: ...o five bits each in the spooler job file 4 If you know that job 150 is your most recently spooled job you can also enter the above commands from your TACL prompt To copy two or more spooler jobs to the same spooler job file issue a LIST command for each spooler job but include the exclamation point for only the first LIST command The second and subsequent spooler jobs are appended to the spooler j...

Page 262: ...ob number you can enter the above commands from the TACL prompt Copying a Spooler Job File to the Spooler To copy a spooler job file from your current subvolume to a spooler job 1 Start Peruse and use the SJFILES command to display the spooler job files in your subvolume 2 Use the JOB command to make REPORTL the current job 3 Use the LIST command to copy REPORTL to the spooler queue location S LAZ...

Page 263: ...ystem and therefore are restricted to super group users user ID 255 n such as your system operator For information about these commands see the Spooler Utilities Reference Manual Topic Page Entering Spoolcom Commands 14 2 Listing Printers and Checking Their Status 14 6 Restarting a Printer 14 7 Displaying the Status of Spooler Components 14 8 Monitoring Spooler Processes 14 9 Draining the Spooler ...

Page 264: ... Spoolcom displays its program banner copyright message and the Spoolcom prompt which is a close parenthesis Fields in the Spoolcom banner are T9101D10 is the product number and version for Spoolcom 08JUN92 is the release date for this version of Spoolcom WEST is the system on which this Spoolcom process is running 2 Enter a Spoolcom command at the prompt After executing the command or displaying ...

Page 265: ...NT which tells Spoolcom to ignore the rest of the characters on that line Spoolcom Commands Spoolcom commands entered from a terminal or read from a command file cannot exceed 132 characters You can enter two or more Spoolcom commands on the same line if you separate them with semicolons For example this command displays the status of job number 322 then exits Spoolcom Spoolcom commands consist of...

Page 266: ...cifies attributes obtains status changes batch job states COLLECT Specifies attributes obtains status changes collector states DELETE Removes a specified collector from the spooler DRAIN Causes the collector to stop accepting new jobs START Causes a dormant collector to become active STATUS Shows current status of the collector processes COMMENT Designates a comment for Spoolcom to ignore often us...

Page 267: ...onnects a location to a device STATUS Shows current status of the spooler locations XREF Produces a cross reference list of locations devices and print processes ordered by location OPEN Specifies the spooler supervisor with which Spoolcom communicates PRINT Specifies attributes obtains status changes print process states DELETE Removes a print process from the spooler START Takes a print process ...

Page 268: ...a job Waiting The device is ready to print a job but no job is available to print on the device either because there are no jobs in the device queue or because none of the jobs in the queue have a form name that matches the form currently on the device Offline The device is not available for printing jobs The Spoolcom command DEV DRAIN causes the device to go offline after the current job finishes...

Page 269: ...e device status but the owner ID and the printing times for the queued jobs In this example the device state shows an error number for the printer LP1 indicating that this printer is offline A plus sign following an estimated printing time indicates that the printer must come back online before the print time has any meaning 18 SPOOLCOM DEV LP1 DEVICE STATE FLAGS PROC FORM LP1 DEV ERROR 100 T SPLP...

Page 270: ... a job number the name or number of a printer or a location name 1 Use Peruse to list your spooler jobs in the spooler system and the job location For example this display shows that your job is number 566 at location HT4 2 Exit Peruse and use the Spoolcom LOC command to display the status of the printer that is to print your job For example to find the location assigned to printer HT4 and the job...

Page 271: ...d Spooler on page 14 12 Monitoring Spooler Collector Processes Do not let the collector processes in your spooler subsystem become more than about 90 percent full To check the status of your spooler collector processes enter SPOOLCOM COLLECT A listing such as this is sent to your home terminal This example shows that the three collector processes S S1 and S2 are active and none is approaching a fu...

Page 272: ...inished the collector enters the dormant state You cannot change collector attributes while it is in the drain state Error The collector cannot function The Spoolcom COLLECT STATUS command tells you whether the collector is in an error state PRINT STATE FLAGS CPU PRI SPLA ACTIVE 3 2 128 SPLB ACTIVE 2 3 144 SPLC DORMANT 2 3 128 SPLD DORMANT 3 2 144 SPLX DORMANT 1 0 149 Table 14 6 Print Process Stat...

Page 273: ...drain state The collectors stop accepting new jobs and reject new opens with file system error 66 DEVICE DOWNED BY OPERATOR When all open jobs have finished spooling and all currently printing jobs have finished printing the collectors enter the dormant state Any attempt to route a job to a stopped collector is rejected with file system error 14 DEVICE DOES NOT EXIST The print processes finish pri...

Page 274: ...l file while in a warmstart the supervisor is given the name of an existing control file Before you coldstart your spooler you must purge all existing supervisor control files The coldstart process creates new control files Any jobs waiting in the current queue file are purged during a coldstart and users must respool these jobs after the coldstart finishes Warmstarting a Drained Spooler 1 Log on ...

Page 275: ...data file COMMENT THIS IS SYSTEM SPLUTIL WARMFILE COMMENT It restarts a previously existing spooler system COMMENT First create the supervisor process supplying the name of the COMMENT control file of the spooler system being warmstarted SPOOL IN MKT SPL SPL OUT 0 NAME SPLS PRI 147 CPU 0 1 COMMENT Add or modify any collectors and print processes to delete a print COMMENT process first delete the l...

Page 276: ...ollector name DATA data filename See Guidelines on page 14 16 for information on sizing the data file and for suggestions on the number of collectors you might need 8 Specify the names and attributes of the print processes PRINT print process Several PRINT subcommands are described in Table 14 1 9 Specify the names and attributes of the devices DEV device PROCESS print process Several DEV subcomma...

Page 277: ...KT SPL SPL6 PURGE MKT SPL SPL7 PURGE MKT SPL SPL8 PURGE MKT SPL SPL9 COMMENT Create a new collector data file FUP CREATE MKT SPL DATAFILE EXT 16384 0 COMMENT Create the spooler supervisor process COMMENT specifying all coldstart parameters SPOOL IN MKT SPL SPL OUT 0 NAME SPLS NOWAIT PRI 147 CPU 0 1 8191 4095 511 10 10 40 500 COMMENT supervisor control file MKT SPL SPL 0 9 COMMENT log file for mess...

Page 278: ...POOLCOM TO CONFIGURE THE COMMENT SYSTEM TO BE COLDSTARTED AND PASSES THIS COMMENT INFORMATION TO THE SUPERVISOR COMMENT YOUR SYSTEM COMMENT SPOOLER CONFIGURATION COMMENT 28 AUG 1993 COMMENT To configure one collector named S COLLECT S FILE SYSTEM SYSTEM CSPOOL COLLECT S DATA MKT SPL DATAFILE COLLECT S CPU 1 BACKUP 0 PRI 146 COMMENT To configure four print processes COMMENT one PSPOOL one PSPOOLB o...

Page 279: ...ation allocate the collector data file in one extent You specify the extent size when you create the collector data file Step 3 of the coldstart procedure For example if unit size is 4 the extent size is 16384 and you create the data file with the command FUP CREATE file name EXT 16384 0 If the size of spooled jobs varies greatly configure several collectors with different unit sizes For example c...

Page 280: ...s of the supervisor collectors and print processes SPOOLCOM COLLECT PRINT If the status displays show that any processes are stopped or if they continue to receive error messages see Solving Common Spooler Problems on page 14 26 Example Stopping and Restarting a Spooler Subsystem In this example The supervisor is SPLS The collectors are S S1 and S2 The print processes are FPLP SPL2 SPLP and SPLX T...

Page 281: ...ing 8 Check the status of the print processes PRINT If the print processes are in the active or dormant state they are back up and running If any processes remain stopped or continue to receive error messages see Solving Common Spooler Problems on page 14 26 Controlling Print Devices This subsection explains how to monitor start and stop the output devices associated with your spooler subsystem To...

Page 282: ... STATE column of this listing shows that the printer LASER is up and available to print users jobs Controlling Jobs To manage your spooler jobs you can use the Spoolcom JOB commands the same way you would use Peruse commands All users can perform these operations on their own jobs you must be a member of the super group to change any attributes of a job belonging to another user To monitor all cur...

Page 283: ...d to the device This routes each location to a different device LOC group dest DEV different device To delete a job enter JOB job number DELETE The Spoolcom JOB command includes other subcommands and qualifiers See the Spooler Utilities Reference Manual for a complete description of the JOB command You can enable or disable manager access for the spooler so that a group manager n 255 can list and ...

Page 284: ...ority enter JOB 37 HOLD JOB 37 SELPRI 7 To change the location of job 37 to TLOGOUT enter JOB 37 HOLD JOB 37 LOC TLOGOUT To reroute job 37 and any other jobs from a down device 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 JOB BATCH STA FLAGS OWNER TIME COPY PAGE REPORT LOCATION 22 RDY 4 30 1 08 09 1 1...

Page 285: ...he location of job 566 to HT5 and specify that two copies be printed Job States A job can be in any of these states SPOOL SUPERVISOR SPLS STATE ACTIVE MGRACCESS OFF LOG FILE 0 LAST ERROR NONE SPOOL SUPERVISOR SPLS STATE ACTIVE MGRACCESS ON LOG FILE 0 LAST ERROR NONE 17 SPOOLCOM JOB 566 HOLD LOC HT5 COPIES 2 START Open OPN The job has been added to the spooler It remains in this state until the col...

Page 286: ...C 3 Modify your spooler subsystem locations as needed To assign and connect a location to a print device LOC group dest DEV device name To break the connection between a location and any devices with which it is associated LOC group dest DEV To delete a location from the spooler LOC group dest DELETE Examples Controlling Locations Listing All Locations Associated With Your Spooler To list all the ...

Page 287: ...FAULT to the print device SAGE BOOK2 enter LOC BIRDB DEFAULT DEV SAGE BOOK2 Breaking the Connection Between a Location and Devices 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 DEL...

Page 288: ...nue with Step 2 If this error message is added the supervisor is no longer running because of file system error 14 DEVICE DOES NOT EXIST a 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 Freeing a Hung Spooler Cannot Get Jobs In or Out 14...

Page 289: ...l the collectors are If FULL is close to 100 there might not be room for new jobs Delete or print some jobs With regular observation you can monitor the collector and take preventive steps to keep it below full capacity If a collector is in the error state the octal number that follows the error in the ERROR column of the listing indicates the error condition The error number and its explanation a...

Page 290: ...POOLCOM If the supervisor isn t running check whether any collectors or print processes are still running with the TACL PPD command and stop any running spooler processes with the TACL STOP command Then warmstart the spooler 2 Check the print processes PRINT If the state of any print process is ERROR num the explanation for that error condition appears on the operator console See Clearing a Print ...

Page 291: ... the configuration and then start the print process PRINT print process PRINT print process START 2 Check the status of the print process to make sure that it restarted properly PRINT 3 Check the status of the devices to make sure that they are back up and running DEV Example 1 Check the status of the spooler supervisor SPLS on the system KONA SPOOLCOM The supervisor SPLS is running For additional...

Page 292: ... such as this is sent to your home terminal This DEV listing shows that all devices are now in a normal state Clearing a Nonprintable Job If a device error 100 error occurs a user might have sent data to the spooler subsystem that a printer device is unable to handle 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 nonprintab...

Page 293: ...e USERS program see the TACL Reference Manual 5 Reenter Spoolcom and place the job on hold SPOOLCOM JOB job number HOLD 6 Drain the printer DEV printer DRAIN 7 Start the printer DEV printer START 8 Notify the user that the job is on hold and that it contains data the printer cannot handle Example To clear a job that the printer named LASER1 is unable to print 1 Check the physical status of the pri...

Page 294: ...program displays information such as this 5 Reenter Spoolcom and place the job on hold SPOOLCOM Job 88 HOLD DEVICE LASER1 STATE DEVICE ERROR LAST ERROR 004144 EXCLUSIVE OFF FIFO OFF HEADER ON TRUNCATION OFF DRAINING NO PRINTING JOB 88 PARM 1 177777 PROCESS SPLX RETRY 5 TIMEOUT 360 SPEED 100 WIDTH 1 FORM RESTART OFF DEVRESET OFF DEVTYPE STARTFF OFF ENDFF OFF CHARMAP NONE PREXLATE OFF LUTOFVALUE CRF...

Page 295: ...ferent printers vary but many display an error light or number that can assist you in finding the jam 3 Check the logical status of the printer SPOOLCOM DEV printer DEV error 100 appears in the case of a paper jam 4 Suspend the printer DEV printer SUSPEND 5 Check the status of the printer DEV printer The STATE column should report SUSP 6 Physically fix the paper jam 7 Restart the printer from the ...

Page 296: ...6 Restart the printer from the selected page number of the job you suspended DEV LASER1 SKIP 4 DEV LASER1 START Recovering From an Invalid Job 1 State If you find an invalid Job 1 state in the STATE column of a DEV status listing 1 Drain the device to take it offline SPOOLCOM DEV device DRAIN 2 Check the device status DEV device If the Job 1 condition has been cleared you can start the device DEV ...

Page 297: ...ang The supervisor sends error messages continuously Problems such as the above are unusual but they might occur in large installations where development is performed You perform the dump operation while the spooler is running you need not drain the spooler or stop any spooler processes before performing this operation To recover from unusual problems such as those listed above you might need to d...

Page 298: ...restart the printer and notify the user who owns the job A possible problem exists with a printer s toner or ribbon Check toner and ribbon and correct as needed Spooler response time is inexplicably slow System users report that their jobs are not being printed Numerous unusual operator messages might occur Check with your management a memory dump of the supervisor process might be needed The spoo...

Page 299: ... state has occurred with a given device Drain the device and restart it If problems persist drain and warmstart the spooler A user sent a file to a dummy or nonexistent location or put it on hold Reroute the job to an existing printer or take the job out of the hold state FORM attributes of the job and the device do not match Reroute the job or change the FORM attributes The spooler supervisor pro...

Page 300: ...Performing Routine Spooler Operations Using Spoolcom Guardian User s Guide 425266 001 14 38 Problem Solving Summary ...

Page 301: ...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 Topic Page Naming Spooler Components and Files 15 2 Managing Collector Processes 15 3 Managing Print Processes 15 6 Managing Print De...

Page 302: ...ric character to the end of the file name There is no default name For example MKT SPL SPLn Data files The file name has eight alphanumeric characters There is one file for each collector and no default name For example MKT SPL SPLDATA Device name The name is device and has up to six alphanumeric characters The first character is a letter There is no default name For example SLOW Location name The...

Page 303: ... with its name and attributes If you want the collector to be part of your configuration every time you system load the spooler add it to the spooler configuration file 1 Define the collector SPOOLCOM COLLECT collector name DATA data filename collector attribute Collector attribute subcommands are described in Table 15 2 on page 15 4 2 If the spooler is in the warm state or cold state when you add...

Page 304: ...a backup CPU cpu The processor that runs the collector The default is for the collector to run on the same processor as the supervisor DATA data filename The name of the disk file where the collector stores jobs You must specify this file name there is no default name The data file must be created before the collector is started If you try to start a collector without a data file the collector abn...

Page 305: ...ld not change the unit size of an existing collector If a different unit size is required delete the old collector and start a new one Do not change the data file where the collector stores jobs jobs can be lost 3 Restart the modified collector COLLECT collector name START Example To modify a collector attribute by changing the backup processor from CPU 2 to CPU 5 SPOOLCOM COLLECT S2 DRAIN COLLECT...

Page 306: ...or your spooler enter the 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 Table 15 3 Compaq Provided Print Processes Process Description FASTP Combines PSPOOL and PSPOOLB features and provides performance improvements for many types of printer...

Page 307: ...ss then readies the new print process to run jobs SPOOLCOM PRINT XP FILE SYSTEM SYSTEM PSPOOL CPU 3 To add a PSPOOLB print process called PPPS to an existing spooler on processor 2 PRINT PPPS FILE SYSTEM SYSTEM PSPOOLB CPU 2 To add a FASTP print process called XLNT to an existing spooler on processor 4 PRINT XLNT FILE SYSTEM SYSTEM FASTP CPU 4 Displaying the Current Attributes of a Print Process T...

Page 308: ...ge 15 10 Example To modify an attribute of the print process named SPLA by changing the backup processor from 2 to 4 1 Enter PRINT SPLA XREF A listing such as this is displayed on your home terminal 2 Check to see if all devices are offline not busy or waiting DEV LP1 DEV LP2 A listing such as this is displayed on your home terminal 3 Drain the waiting device LP1 DEV LP1 DRAIN 4 Check the status o...

Page 309: ...ice EXCLUSIVE OFF so that the print process will close the device when no more jobs are waiting to be printed DEV device name EXCLUSIVE OFF 3 For each device drain the device DEV device name DRAIN 4 Delete the print process PRINT print process DELETE The print process should become dormant approximately two minutes after the process prints its last job If the print process does not become dormant ...

Page 310: ... a default value PRINT PROCESS DEVICE LOCATION SPLB LP1 FAST DEFAULT DEVICE STATE FLAGS PROC FORM LP1 OFFLINE SPLB Table 15 4 Print Process Attributes and PRINT Subcommands page 1 of 2 SPOOLCOM PRINT Attributes and Subcommands Description and Default Value BACKUP backup cpu The processor that runs the print process backup This attribute is used for user written independent print processes only An ...

Page 311: ...ram file for this print process by default assumes this is an independent process PARM parameter A print process parameter passed by the supervisor to the print process in the startup message Its meaning is defined by a user written print process and it can be used only with user written print processes PRI process priority The execution priority of the print process default is 145 Topic Page Addi...

Page 312: ...his one must not exceed the maximum configured at the time of spooler coldstart and the number of locations cannot exceed that maximum Example To add a device named LP3 to the spooler and cause all jobs printed on that device to have a standard header page enter SPOOLCOM DEV LP3 PROCESS XP HEADER ON LOC LINE DEFAULT DEV LP3 DEV LP3 START Displaying Current Print Device Attributes To display the cu...

Page 313: ...on page 15 15 3 Put the device back online DEV device START Example To change the form name assigned to the device named PRINT enter 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 DEVICE LP STATE BUSY LAST ERROR 004014 EXCLUSIVE OFF FIFO OFF HEADER ON TRUNCATION O...

Page 314: ...OOLCOM DEV device DRAIN This causes the device to go offline after the job currently printing is finished 2 Empty the device queue by doing one of a Break the existing connection between the device and its location LOC group dest DEV or a See if there are any jobs at the location LOC group dest STATUS b If there are no jobs currently in the location delete the location LOC group dest DELETE c If t...

Page 315: ...eed at the end of a job ENDFF OFF the default value causes PSPOOL or FASTP to suppress a form feed at the end of a job EXCLUSIVE ON OFF Specifies the ownership mode of the device with respect to the spooler EXCLUSIVE or EXCLUSIVE ON specifies that the print process should not close the device when the printer is not printing a job The print process keeps the device open all the time preventing any...

Page 316: ...es with the print process The range is 32768 through 32767 The default is 0 which specifies default values for parameters PARM applies to a PSPOOLB or FASTP print process it has no meaning for PSPOOL For details see the Spooler Utilities Reference Manual PROCESS process name Specifies the print process that controls the device You must specify a print process there is no default process RESTART OF...

Page 317: ...oc STATUS DETAIL For more information about location attributes see Table 15 6 on page 15 18 TIMEOUT number of retries Specifies the number of times the spooler retries a failed write to the device The default value is 360 times TRUNC ON OFF Tells the standard print process whether to truncate or wrap around lines longer than the device width The default value is TRUNC OFF which means that the end...

Page 318: ...ation enter LOC BIRD6 DEV LOCATION BIRD6 DEFAULT BROADCAST OFF DEVICE CAT C FONT NAME Table 15 6 Location Attributes SPOOLCOM LOC Attributes and Subcommands Description and Default Value BROADCAST ON OFF BROADCAST or BROADCAST ON causes a job routed to group to be printed on all devices connected to group BROADCAST OFF the default value causes jobs routed to group to be printed on the one device c...

Page 319: ...ntrol Files A spooler is characterized by its control files which contain the names and attributes of the processes locations and devices that make up the system If a spooler was improperly drained or suffered an abnormal shutdown you must rebuild the spooler control files 1 Warmstart the spooler see Warmstarting a Drained Spooler on page 14 12 2 Enter the SPOOLCOM JOB command JOB If you find a Jo...

Page 320: ...on if you want to increase the values of any coldstart parameters num of jobs and so forth in a warmstart If you do not use this option you must coldstart the spooler to increase the values of any parameters You cannot decrease the values of any parameters See the Spooler Utilities Reference Manual for more information about SPOOL c Add delete or modify spooler components as needed 4 Enter SPOOLCO...

Page 321: ...rt 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 Section 17 Monitoring Event Messages Section 18 Displaying Version and System Information ...

Page 322: ...Part V Security Features and Other Guardian Utilities Guardian User s Guide 425266 001 ...

Page 323: ...remote system to run an application program such as electronic mail or a text editor This section contains the following information for supporting your NonStop Kernel system users Topic Page Your Responsibility to System Users 16 2 Adding Users to the System 16 2 Deleting Users From the System 16 5 Determining Group and User Name and Number 16 7 Interfaces for the Security Features 16 8 System Us...

Page 324: ...tion 1 Introduction to Guardian System Operations contains a complete check list of tasks operators should perform at the beginning of each shift The above list represents areas that are of particular importance when supporting system users Monitoring the System Frequently All system operations tasks help the users of your system in some way With this in mind the importance of monitoring your syst...

Page 325: ...per ID user id is an integer in the range 0 255 that uniquely identifies a user within a group 255 is reserved as the user id for group managers and the super ID 3 Assign a password and default volume and subvolume for the new user LOGON group name user name Password RETURN PASSWORD password DEFAULT volume subvolume security code If you do not specify any in this step the logon defaults for users ...

Page 326: ...ty Program FUP Reference Manual about file security settings About Passwords Rules regarding the correct number of characters required for passwords can vary from system to system Check with your operations manager if you have questions about rules regarding passwords that might be specific to your system A password must not include blanks commas or null characters Passwords are case sensitive tha...

Page 327: ...er You can include options of the TACL RUN command in the DELUSER program syntax See the TACL Reference Manual for details on using the RUN command Example In this example the group manager of the SALES group or a super group user 255 n can delete the user SALES BONNIE and other members of that group To delete the user SALES BONNIE enter DELUSER SALES BONNIE This message is displayed SALES BONNIE ...

Page 328: ...rence Manual For more information about FUP commands and considerations relating to their use see the File Utility Program FUP Reference Manual Example 1 Run a DSAP report on the subvolumes and files owned by SALES BONNIE user 8 1 on SAGE DATA1 DSAP DATA1 BYSUBVOL USER 8 1 A report similar to this is returned to your home terminal This report shows that SALES BONNIE has eight files in two subvolum...

Page 329: ... know a user s group name only To learn the user s name ID number and default volume and subvolume enter USERS group name Examples Getting User Information Getting User Name and Information for a User ID To learn the user name and other information associated with the user ID 8 1 enter USERS 8 1 USERS displays information such as Getting User ID and Information for a User Name To learn the user ID...

Page 330: ...Safeguard software provides additional security features for systems and distributed networks Instructions for logging on at a terminal controlled by Safeguard software are included in Section 2 Getting Started With TACL For more information about the Safeguard subsystem see the Safeguard User s Guide GROUP USER I D SECURITY DEFAULT VOLUMEID SALES BONNIE 008 001 NUNU DATA1 BONNIEF SALES PAT 008 00...

Page 331: ...or the current TACL process Table 16 2 FUP Disk File Security Features Command Function FUP GIVE Changes the owner of a file FUP INFO Displays the characteristics of a file FUP LICENSE Lets nonprivileged users execute a privileged program user ID must be 255 255 FUP REVOKE Revokes the license for a privileged program or resets the security attributes of a file user ID must be 255 255 FUP SECURE Ch...

Page 332: ...roup System operators Perform various system functions such as managing system files disks and other devices The user is ID 255 n where n is an integer from 1 to 254 Super ID users Can access files processes and devices for the entire system with no restrictions The user ID is 255 255 Identifying System Users Each system user has a unique user name and user ID in the form group name user name wher...

Page 333: ... their users Set remote passwords Log off the system Group Manager Perform all functions of a General User Add new users to the group Delete users from the group Log on as any user in the group without knowing that user s password the manager also has access to the user s files System Operator Perform all functions of a General User Monitor processor use Reload processor modules Set the current da...

Page 334: ...oup For example the ADMIN MANAGER user can now use the ADDUSER program to add these users to the group As many as 256 groups with a maximum of 256 users in each group can be created for each system 3 The new user can log on with the TACL LOGON command to access the system If ADMIN JOAN has a password which was supplied by the super ID user or group manager the user enters this password at the Pass...

Page 335: ...rite execute and purge RWEP You set file security with the FUP SECURE command You set your default security attributes with the TACL DEFAULT command or TACL VOLUME command DEFAULT sets the logon or saved attributes while VOLUME temporarily sets the attributes Table 16 3 Types of File Access Access Definition Read Lets a file be read or copied and lets a command file be executed using the TACL OBEY...

Page 336: ...ether the opener is the owner of the file a member of the owner s group or a member of another group Location Whether the opener is local or remote with respect to the file When you attempt to access a file your security level is checked against the file s security level for the requested access mode RWEP as defined in Table 16 4 Table 16 5 shows the permissions required for users to access files ...

Page 337: ...uired This subsection describes the security features that protect and restrict access to running processes such as process and creator access IDs and describes their use in the security system Also described are procedures for licensing programs and for adopting the user ID of a program file owner as that program s process access ID Process and Creator Access IDs Two identifications are associate...

Page 338: ...g the Owner ID of a Program File Program file owner ID adoption allows the owner of a program file or the super ID to specify that the process access ID of any process created by running that program file is to be the same as the owner ID of the program file rather than the process access ID of the creating process This option allows the owner of the program file to control the files that the new ...

Page 339: ... controlled form of file access is allowed using a query program that has been written to return only nonsensitive information The program file is owned by user 1 112 and is secured so that any local user can execute the process OOAO Additionally program file ID adoption has been specified use owner ID as process access ID As shown in Figure 16 4 user 8 10 process access ID of 8 10 executes the qu...

Page 340: ... access or read write access the file becomes unlicensed For example a privileged program called PRIVPROG exists in a software development group PRIVPROG is owned and licensed by the super ID so that all members of the group can execute it A programmer in the group has developed a revision to the PRIVPROG program and wants to replace the object program with the revision Provided that the super ID ...

Page 341: ...cess files on a remote system only if the user s user name and user ID are also known to remote system For example if ADMIN BILL who is on system WEST wants to access a file on remote system EAST the remote system must also have a user identified as ADMIN BILL with a user ID of 6 14 A super group user user ID 255 255 or a group manager at system EAST must add ADMIN BILL with the TACL ADDUSER progr...

Page 342: ... matching remote passwords are established on both systems a user does not need to specify the remote password to gain access to the remote system Furthermore the super IDs at the various nodes in a network can set up the appropriate allow access and request access passwords for all users so that the users themselves need not be concerned with REMOTEPASSWORD commands When the appropriate passwords...

Page 343: ...a local process unless the stop mode of the local process is 0 which allows anyone to stop it A remote process cannot put a local process into a debug state Using a Remote TACL Process to Gain Local Access Openers of a file are either local or remote with respect to the file A local user is logged on to the system on which the file resides A remote user is logged on to a different system in the sa...

Page 344: ... to have access to all systems However it is convenient to allow network access for certain users without forcing them to type or even know all of the required REMOTEPASSWORD commands In this case a global remote password can be established for these users At each system a user named NET ACCESS is established and these commands are issued The REMOTEPASSWORD command is issued for each system on the...

Page 345: ...ser can access any file On a network the capabilities of the super ID can be local global or somewhere in between local and global Making the Super ID a Local Super ID Only To make the super ID exclusively a local super ID user do not issue REMOTEPASSWORD commands for the super ID at any node Making the Super ID a Global Super ID To make the super ID a global super ID issue REMOTEPASSWORD commands...

Page 346: ...nd their solutions 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 Task 1 Check the Status of the User s TACL Process 16 26 Task 2 Check for Hardware Problems 16 27 Task 3 Stop the User s TACL Process 16 27 Task 4 Stop Other Use...

Page 347: ... Step 1 Is TACL OK Step 2 Is Hardware OK Step 3 Stop Other Processes Fix Check With User Is TACL OK Now Resume Step 4 Stop TACL Process If It Appears OK If Not OK If OK But Still No TACL Yes No Step 5 Start New TACL 016 CDT CDD Is TACL OK Now Resume Is TACL OK Now Is TACL OK Now Resume Escalate Step 6 Check Abort Restart Line Start New TACL Yes No No Yes No Yes ...

Page 348: ...see the TACL Reference Manual Example To check the status of the TACL process running on the terminal JT1 J01 enter STATUS TERM JT1 J01 Information such as this is displayed This status report example shows a normally functioning TACL process and includes The process name if it is named Process Whether the process is a backup or primary process B if a backup process The processor and process numbe...

Page 349: ...TACL process STATUS TERM terminal name 3 Note the TACL process name and the numbers of the primary and backup CPUs the TACL process is using You will need these numbers later when you start a new TACL process 4 Stop the TACL process by using the TACL STOP command STOP TACL process name See the TACL Reference Manual for complete syntax considerations and examples of the STOP command Example To stop...

Page 350: ...ally to ensure there are no problems or if there is a certain order in which they must be stopped 1 Stop a named process by using the TACL STOP command STOP process name Repeat this command for each named process you need to stop 2 Stop an unnamed process by using the TACL STOP command STOP cpu pin Repeat this command for each unnamed process you want to stop b Stop all running processes except th...

Page 351: ...ly included in a system configuration file that assigns names to TACL processes when the system is loaded the next and subsequent times 2 Check the status of the new TACL process STATUS TERM terminal name The system displays whether the new TACL process has started on the user s terminal 3 Check with the user to make certain their access to the TACL command interpreter has resumed If access is res...

Page 352: ...U subdevice subdevice is the subdevice name and is the same as the second component of the user s terminal name for example J01 e Check the status of the line and subdevice STATUS The STATE display appears indicating whether the terminal communication line is started or stopped If the STATUS command reports STARTED the terminal communication line is working You should follow your local procedure f...

Page 353: ... If the STATUS command reports STOPPED the terminal communication line is not working follow your local procedure for problem reporting and escalation See the SCF Reference Manual for G Series Releases for complete syntax considerations and examples of all SCF commands See Section 19 Monitoring Hardware Components for information on checking for LAN problems Example 1 Check the status of the termi...

Page 354: ...place the modem in question Communication lines might be faulty Attempt to restart line Escalate as needed A controller problem might exist Check for error messages A TACL problem might exist Restart the TACL process A user process has failed Stop and restart the process A terminal emulator software configuration problem might exist Check manufacturer s documentation or escalate the problem accord...

Page 355: ...ommend that operations staff monitor messages every fifteen to twenty minutes throughout the day Frequent monitoring of messages can help you detect potential problems at an early point and lets you take preventive or corrective measures Topic Page Understanding Operator Messages 17 2 Displaying Error Messages With Error 17 6 Displaying Operator Messages With a Printing Distributor 17 7 Interpreti...

Page 356: ...llector Event Management Service EMS process that accepts event messages from subsystems and logs them in an event log Event log File or set of files maintained by EMS to store event messages generated by various subsystems Distributor process EMS process that distributes event messages from event logs to requesting management applications another collector on this or another node or printers devi...

Page 357: ...e the Operator Messages Manual Operator Messages Format Operator messages are preceded by a header that contains Subsystem ID Event number Time the message was generated Name of the system that sent the message Process ID or processor number of the process that issued the message Only portions of the subsystem ID and the event number are shown as header information in this guide This example shows...

Page 358: ...our system The distributor processes then send messages to various destinations 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 Table 17 1 Distributor Processes and Message Destinations This Distributor Process Sends These Messages to These Destinations Co...

Page 359: ...detail Figure 17 1 Operator Messages and the EMS Environment 017 CDT CDD Event Messages EMS Collector 0 Event Log Terminal Log File Printing Distributor Filter Forwarding Distributor Filter Send to Another Node Consumer Distributor Filter Customer Subsystem Tandem Subsystem Compatibility Distributor Console Device Printer Event viewing application Such as the TSM Event Viewer on G series systems o...

Page 360: ...escriptions press the Break key and enter STOP Error Examples This example shows a FUP DUPLICATE command that generates file system error 11 FUP displays file system error 11 and stops the FUP process ID is 15 47 For an explanation of this error enter Error a space and the error number at your TACL prompt Error displays the error description and returns control to the TACL program From the descrip...

Page 361: ...of the terminal disk file or printer to which you want to send operator messages The printing distributor then begins displaying or directing operator messages to the device you have specified as in this example Stopping a Printing Distributor 1 Press the Break key on your keyboard 2 Enter the TACL STOP command with the name of your EMSDIST process To learn the name of your EMSDIST process enter S...

Page 362: ...ferent formats depending on the way your system has been configured For example you might use a printing distributor console application or other application to display operator messages When you use a printing distributor to display operator messages they appear in a format similar to this example the timestamp the names of the system and the process reporting this message the owner name subsyste...

Page 363: ...t the message means The main window of the TSM EMS Event Viewer displays messages in this format Date Time SSID Subject Event Event Name Event Text 10 03 96 08 10 23 Tandem DSK G01 SYSTEM 500 Path Switch Operator s Console Message The SSID column identifies the owner name subsystem name and version The Event column displays the event number Printing Distributor Message Format For event messages se...

Page 364: ...w to direct operator messages to a specific file then display them on your terminal 1 Direct operator messages to the disk OPS subvolume LOGS and file MSG1 EMSDIST TYPE PRINTING COLLECTOR 0 TEXTOUT OPS LOGS MSG1 Disk file logging begins and continues until you stop the printing distributor 2 When you want to return to a TACL prompt press the Break key on your terminal 3 Display the contents of the...

Page 365: ...ely to be open at any time Example To print the contents of the disk log file NEWLOG to a printer named HANS1 enter FUP COPY NEWLOG S HANS1 SHARE You can specify that logging begin or end or both on a specified date at a specified time by using the EMSDIST TIME and STOP options This example begins the printing distributor immediately starts printing at 1 00 a m on May 12 1993 on the printer named ...

Page 366: ...t to use you can start the TSM client software components in any order To start the TSM EMS Event Viewer Application 1 Do one of On the Windows NT desktop click Start and then choose Programs TSM Client TSM Event Viewer In the TSM Low Level Link Application a Click System Discovery TSM displays the Management view window which shows the physical view of your system b From the Display menu choose E...

Page 367: ...for you to set up the search criteria used to retrieve events based on start and end time subsystem source and specific events You can save any Event Retrieval Criteria you have specified for future use Select Events for Display After retrieving the events from the NonStop Kernel system to the workstation you can further select which events you want to look at You can Change event display paramete...

Page 368: ...Monitoring Event Messages Guardian User s Guide 425266 001 17 14 Using the Event Viewer ...

Page 369: ... 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 In the Guardian Environment The following procedure finds the version of a product s object file that you use because of the values in your PMSEARCHLIST TACL ...

Page 370: ...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 Files can be stored either singly or in sets called ar format archive files An ar format archive file is normally used only in the OSS file system and on UNIX systems If you request version information for an ar for...

Page 371: ...der the RUN command in the TACL Reference Manual If you specify pathname in the VPROC command you must enter at least one valid run option If no run option is needed use the NAME option file set Is a file or set of files entered as system volume subvolume fileid The file set parameter specifies the Guardian file name of the product whose version information you are seeking The fileid specification...

Page 372: ...der the RUN command in the TACL Reference Manual When you specify pathname in the VPROC command you must enter at least one valid run option for VPROC to run successfully If no run option is needed use the NAME option pathname Specifies the absolute OSS pathname of the product whose version information you are seeking VPROC does not support the wild card asterisk in OSS pathnames in the Guardian e...

Page 373: ...ethods are described in the vproc 1 reference page either online or in the Open System Services Shell and Utilities Reference Manual Note Currently VPROC has access only to local OSS files VPROC can process files in the OSS file system only if VPROC is run on a TNS R system running a D30 00 or later release with the Open System Services environment active 10 VPROC NAME USR LIB LIBC B Archive membe...

Page 374: ...r 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 To exit VPROC enter CTRL Y at the VPROC prompt In this example VPROC displays information about Peruse VPROC T9617G03 30 MAR 1999 SYSTEM NAME Date 12 April ...

Page 375: ... product number and version level There can be multiple version procedures per product The version procedure information has this format cttttrvv_ddmmmyy_nnnnnn_xxxxxx or cttttrvv_ddmmmyyyy_nnnnnn_xxxxxx where ctttt is the Tandem number T number of the corresponding product rvv is the version of the product ddmmmyy or is the release date of the product version ddmmmyyyy nnnnnn is the abbreviated p...

Page 376: ...ntering the file name or pathname value Effect If you are using VPROC interactively VPROC prompts you for another file name or pathname If you are using VPROC from a TACL or an OSS shell prompt VPROC terminates Recovery Check the file name or pathname and enter a corrected command or value Cause No version procedure information is stored in the specified file Effect This is an informative message ...

Page 377: ...emote system Task 2 Interpret SYSINFO Output SYSINFO provides this information about your system 7 SYSINFO 8 SYSINFO node SYSINFO T9268D37 27 NOV 1997 SYSTEM SNAX Date 12 APR 1999 08 17 34 COPYRIGHT TANDEM COMPUTERS INCORPORATED 1985 1987 1997 System name SNAX EXPAND node number 122 Current SYSnn SYS01 System number D19983 Software release ID D47 00 Displayed Label Displayed Information System nam...

Page 378: ...Displaying Version and System Information Guardian User s Guide 425266 001 18 10 Task 2 Interpret SYSINFO Output ...

Page 379: ... to determine whether all devices and paths are in their correct or normal condition Listings of devices paths and processes generated by the SCF INFO and STATUS commands see the example in Listing the Devices on Your System on page 19 4 Listings of devices paths and processes generated by the Subsystem Control Facility SCF A spooler configuration listing see the example in Section 14 Performing R...

Page 380: ...ity Devices on your system including disks printers terminals and tape drives SCF Disk free space Disk Space Analysis Program DSAP Files on your system File Utility Program FUP Kernel managed swap files NSKCOM Local area networks SCF Pathway transaction processing system PATHCOM Processes running on your system TACL PPD and STATUS commands Processors ViewSys 018 CDT CDD ServerNet Adapter ServerNet...

Page 381: ...command processors disks files processes spooler components audit trails audit dumps TMF transactions and tape mount requests For more information see the Object Monitoring Facility OMF Manual The TSM EMS Event Viewer helps Himalaya S series users perform many of the tasks associated with viewing and monitoring EMS event logs It enables you to search for and view the log files in a variety of ways...

Page 382: ...subtypes and other device characteristics For information about specific devices such as disks and tapes use the SCF INFO and STATUS commands To list all the devices on your system enter this command at your TACL prompt SCF LISTDEV The format of the LISTDEV display is shown below The data shown in the report means LDev Name PPID BPID Type RSize Pri Program nnn process nn nnn nn nnn nn nn nnnnn nnn...

Page 383: ...0 132 180 SHARK SYSTEM SYS00 OZKRN 26 ZZWAN 0 288 1 5535 50 3 132 180 SHARK SYSTEM SYS00 WANMGR 27 ZZSTO 0 289 1 5535 65 96 64801 180 SHARK SYSTEM SYS00 TZSTO 28 ZZLAN 0 16 1 5535 43 0 132 180 SHARK SYSTEM SYS00 LANMAN 30 ZSNET 0 17 1 5535 66 0 132 180 SHARK SYSTEM SYS00 OZKRN 46 ZM00 0 18 0 0 45 0 132 201 SHARK SYSTEM SYS00 QIOMON 48 TAPE1 0 274 1 5535 4 6 2048 200 SHARK SYSTEM SYS00 OTPPROCP 49 ...

Page 384: ...te Substate Explanation ABORTING The object is being aborted The object is responding to an ABORT command or some type of malfunction In this state no new links are allowed and drastic measures may be underway to reach the STOPPED state This state is irrevocable DEFINED One of the generally defined possible conditions of an object with respect to the management of that object DIAGNOSING The object...

Page 385: ...ut I O process is down for an unknown reason STOPPING The object is in transition to the STOPPED state No new links are allowed to or from the object Existing links are in the process of being deleted SUSPENDED The flow of information to and from the object is restricted typically it is prevented A subsystem must clearly distinguish between the type of information that is allowed to flow in the SU...

Page 386: ...p Mirror MirrorBackup Primary Backup PID PID 62 STOPPED STOPPED STOPPED STOPPED 0 268 1 265 STORAGE Status DISK SHARK DATA03 LDev Primary Backup Mirror MirrorBackup Primary Backup PID PID 61 STOPPED STOPPED STOPPED STOPPED 0 269 1 264 STORAGE Status DISK SHARK DATA08 LDev Primary Backup Mirror MirrorBackup Primary Backup PID PID 56 STOPPED STOPPED STOPPED STOPPED 3 258 2 259 STORAGE Status DISK SH...

Page 387: ...M171 DATA00 LDev Path PathStatus State SubState Primary Backup PID PID 6 PRIMARY ACTIVE STARTED 0 10 1 10 6 BACKUP INACTIVE STARTED 0 10 1 10 6 MIRROR ACTIVE STARTING REVIVE 0 10 1 10 6 MIRROR BACKUP INACTIVE STARTING REVIVE 0 10 1 10 LDev The logical device number Path The disk path assignment PathStatus The status of the disk path whether the disk path is the current path ACTIVE or not INACTIVE ...

Page 388: ...ev Primary Backup Mirror MirrorBackup Primary Backup PID PID 61 STOPPED STOPPED STOPPED STOPPED 0 269 1 264 35 STATUS DATA01 DETAIL STORAGE Detailed Status DISK SHARK DATA01 Disk Path Information LDev Path PathStatus State SubState Primary Backup PID PID 63 PRIMARY ACTIVE STARTED 0 267 1 266 63 BACKUP INACTIVE STARTED 0 267 1 266 63 MIRROR ACTIVE STARTED 0 267 1 266 63 MIRROR BACKUP INACTIVE START...

Page 389: ...s in use For more information about MEDIACOM the listings it generates and the tasks it enables you to perform see the DSM Tape Catalog Operator Interface MEDIACOM Manual and to Section 10 Using Labeled Tapes Checking Tape Drive Status With SCF 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 MEDIACOM T6028...

Page 390: ...re the output on a disk Checking Printer Status To check the status of all printers on your system with the SPOOLCOM utility enter SPOOLCOM DEV A listing similar to this is sent to your home terminal 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 LD...

Page 391: ...es and other devices Example To check the status of the printer LASER with the SPOOLCOM DEV command enter SPOOLCOM DEV LASER A listing such as this is sent to your home terminal 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 COLLECT STATE FLAGS CPU PRI UN...

Page 392: ...n appears press F1 to view CPU busy statistics To exit from the ViewSys utility press F16 Note The Measure utility also collects and displays statistics about system performance and the performance of processors and other system components Operations management personnel often use this utility to help fine tune and balance a system See the Measure User s Guide and the Measure Reference Manual for ...

Page 393: ...s and processors on your network enter SCF SCF Banner 1 CPUS A report similar to the following is displayed on your home terminal To check the configuration characteristics status and operating system version of all processors connected to your network enter 3 CPUS DETAIL A report similar to the following is displayed on your home terminal See Interpreting the CPUS Display on page 19 16 for an exp...

Page 394: ...perating system version of all processors connected to the system C2 enter 2 CPUS C2 A report such as this is displayed on your home terminal See Interpreting the CPUS Display on page 19 16 for an explanation of the elements in this display Checking ServerNet LAN Subsystem Status The ServerNet LAN Systems Access SLSA subsystem supports parallel local area network LAN I O allowing S series servers ...

Page 395: ... enter SCF STATUS SAC sac name A listing similar to this is sent to your home terminal To check the status of an adapter enter SCF STATUS ADAPTER adapter name A listing similar to this is sent to your home terminal To check the status of a LIF enter SCF STATUS LIF lif name A listing similar to this is sent to your home terminal To check the status of a PIF enter SCF STATUS PIF pif name STATUS SAC ...

Page 396: ...N LAN0 enter SCF STATUS LIF ZZLAN LAN0 DETAIL STATUS PIF ZZLAN E4SA0 0 SLSA Status PIF Name State ZZLAN E4SA0 0 A STARTED STATUS SAC ZZLAN E4SA1 SLSA Status SAC Name Owner State ZZLAN E4SA1 0 1 STARTED ZZLAN E4SA1 1 0 STARTED ZZLAN E4SA1 2 0 STARTED ZZLAN E4SA1 3 1 STARTED STATUS ADAPTER ZZLAN SLSA Status ADAPTER Name State ZZLAN MIOE0 STARTED ZZLAN E4SA0 STARTED ZZLAN MIOE1 STOPPED ZZLAN E4SA2 ST...

Page 397: ...0 lines are defined and started with SCF from the WAN subsystem You use the SCF interface to the WAN subsystem to Define ATP6100 lines and the modifiers that affect their operation Start ATP6100 lines Stop alter or delete ATP6100 lines Monitor the ATP6100 processes and restart them if both the primary and backup processes fail To check the status of an ATP6100 line first enter the Subsystem Contro...

Page 398: ...ur system s data communications subsystem It is an Expand I O process that transmits and receives data on a communications line either directly or by communicating with another I O process You can check the status of the line handlers on your system or on another system in your network to which you have remote access To check the status of the line handlers on your system enter SCF STATUS LINE lin...

Page 399: ...gement Facility TMF subsystem a standard Compaq tool that maintains the consistency integrity and durability of a distributed database that is being updated by concurrent transactions You use the TMFCOM command interface or the TM View graphical user interface to manage and operate the TMF subsystem and as a system operator you might check TMF status in your routine system monitoring To monitor th...

Page 400: ...play information about the data volumes for which the TMF subsystem generates audit records on behalf of transactions performed on those volumes enter STATUS DATAVOLS You can control which volumes are displayed using the STATE AUDITTRAIL and RECOVERYMODE parameters The normal operating state for a data volume is STARTED which indicates that the volume is ready to process TMF transactions Audited r...

Page 401: ...rk transactions to be resolved Data Volumes The TMF subsystem is starting data volumes Running Backout The subsystem is backing out transactions that must be aborted Started The TMF subsystem has started Stopping The TMF subsystem is stopping and is in one of the following conditions Waiting for Transactions to Finish The subsystem is waiting for all transactions to be completed Data Volumes The s...

Page 402: ... State Started Transaction Rate 0 10 TPS AuditTrail Status Master Active audit trail capacity used 55 First pinned file MAT1 ZTMFAT AA000044 Reason Active transaction s Current file MAT1 ZTMFAT AA000045 AuditDump Status Master State enabled Status active Process X545 File MAT2 ZTMFAT AA000042 BeginTrans Status Enabled Catalog Status Status Up Audit Recovery Volume Trail Mode State DATA1 MAT Online...

Page 403: ...N process within the Pathway environment enter STATUS PATHMON PATHMON States The status of the PATHMON process can be either STARTING or RUNNING STARTING indicates that a cold or cool start has not finished RUNNING indicates that a cold or cool start has finished The other elements of the STATUS PATHMON display are as follows CPUS shows the number of the primary and backup processors in which the ...

Page 404: ...unning stopped and so forth For specific information about interpreting this display see the NonStop TS MP System Management Manual To check the status of the PATHMON process for your application enter STATUS PATHMON PATHCOM responds with a display such as RUNNING EXTERNALTCPS 0 LINKMONS 0 PATHCOMS 1 SPI 1 FREEZE RUNNING STOPPED THAWED FROZEN PENDING SERVERCLASSES 13 5 18 0 0 RUNNING STOPPED PENDI...

Page 405: ...he file extents dynamically with FUP or perform other procedures as determined by your local system policies Example To check the size of the file DATA1 MEMOS enter FUP INFO DATA1 MEMOS DETAIL A report such as this is sent to your home terminal DATA FILES FILEA 10 Jul 1993 14 05 ENSCRIBE TYPE U CODE 100 EXT 224 PAGES 14 PAGES ODDUNSTR MAXEXTENTS 370 BUFFERSIZE 4096 OWNER 8 255 SECURITY RWEP NUNU L...

Page 406: ...mmand files to perform routine system monitoring and other tasks These allow you to run many procedures so that you can quickly determine system status produce reports or perform other common tasks 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...

Page 407: ...E COMMENT THIS CHECKS THE SPOOLER COLLECTOR PROCESSES SPOOLCOM COLLECT COMMENT THIS CHECKS THE LINE HANDLERS SCF STATUS LINE COMMENT THIS CHECKS THE STATUS OF TMF TMFCOM STATUS TMF COMMENT THIS CHECKS THE STATUS OF PATHWAY PATHCOM ZVPT STATUS PATHWAY STATUS PATHMON COMMENT THIS IS THE FILE SYSCHK COMMENT THIS CHECKS ALL DISKS SCF STATUS DISK STORAGE Status DISK SHARK DATA12 LDev Primary Backup Mir...

Page 408: ...LX LINE3 WAITING H SPLX LASER WAITING H SPLP COMMENT THIS CHECKS ALL SACS SCF STATUS SAC SLSA Status SAC Name Owner State ZZLAN E4SA1 0 1 STARTED ZZLAN E4SA1 1 0 STARTED ZZLAN E4SA1 2 0 STARTED ZZLAN E4SA1 3 1 STARTED COMMENT THIS CHECKS ALL ADAPTERS SCF STATUS ADAPTER SLSA Status ADAPTER Name State ZZLAN MIOE0 STARTED ZZLAN E4SA0 STARTED ZZLAN MIOE1 STARTED ZZLAN E4SA2 STARTED COMMENT THIS CHECKS...

Page 409: ...MF1 ZTMFAT AA000045 AuditDump Status Master State enabled Status active Process X545 File TMF2 ZTMFAT AA000042 BeginTrans Status Enabled Catalog Status Status Up Processes Status Dump Files 0 State InProgress COMMENT THIS CHECKS THE STATUS OF PATHWAY PATHCOM ZVPT STATUS PATHWAY STATUS PATHMON RUNNING EXTERNALTCPS 0 LINKMONS 0 PATHCOMS 1 SPI 1 FREEZE RUNNING STOPPED THAWED FROZEN PENDING SERVERCLAS...

Page 410: ...Monitoring Hardware Components Guardian User s Guide 425266 001 19 32 Automating System Monitoring ...

Page 411: ...Identifying Problems Several tools might be available on your system to assist you or your operations management in problem identification and tracking including The Event Management Service Analyzer EMSA is used to extract specific types of event messages from EMS log files and to create an ENSCRIBE database that you can query to analyze problem trends For more information see the EMS Analyzer Us...

Page 412: ...r specific events The TSM EMS Event Viewer is part of the TSM client server application which provides troubleshooting service and maintenance tools that run on a Compaq NonStop Himalaya S series server and on a PC compatible workstation For more information see the TSM Configuration Guide A Problem Solving Process Table A 1 shows a worksheet that you can use to help you through the problem solvin...

Page 413: ...o reported the problem and how can this person be contacted 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 Situation Facts Escalation Decision Plan to Verify Fix Plan to Prevent and Control Damage Category ...

Page 414: ...the worksheet s rows indicate whether the cause in question could have produced the problem symptoms you listed on the left Write yes in the appropriate box if a possible cause explains a fact Write no in the appropriate box if a possible cause does not explain a fact The most likely cause is the one that best explains all the facts that is the cause that is answered yes in many spaces in the colu...

Page 415: ...olutions that are reasonable considering time expense and safety Task 3 Escalate the Problem If the simple solution you have tried in the previous tasks do not solve the problem you might consider escalating the problem to get additional help Task 3 1 Evaluate the Situation After you complete each task in the problem solving process you must decide whether you can continue by yourself or if you mu...

Page 416: ...timulating Preventing problems is often less dramatic But in the end prevention is more productive than solving problems Of course the more work you do to prevent problems before they arise the fewer problems will occur at potentially critical times These questions provide a framework for your problem prevention efforts Why did this problem occur What was the root cause Were there any contributing...

Page 417: ...l format supported on Compaq NonStop Kernel systems Other formats include BACKUP and TMF See also IBM format asynchronous A mode of serial data transmission in which characters are sent at random and the transmission is not synchronized with a separate clock signal that is there is no timing relationship between the end of one character and the start of the next The data contains extra bits a star...

Page 418: ... and servers run on a local area network See client server computing client server computing A model for distributing applications Communication takes the form of request and reply pairs which are initiated by the client and serviced by the server Client server computing is often used to connect different types of workstations or personal computers to the host computer system using supported commu...

Page 419: ...e consumer distributor is used by applications provided by Compaq and by users to read the EMS log file or alternate log files and all or specific event messages depending on filter specifications loaded to the consumer distributor process The application can take appropriate action if necessary in response to an important event The TSM EMS Event Viewer application provided by Compaq uses the cons...

Page 420: ...lowing distributor processes for handling event messages consumer forwarding printing and compatibility DSAP See Disk Space Analysis Program DSAP DSM See Distributed Systems Management DSM products E1SA See Ethernet 1 ServerNet adapter E1SA EMS See Event Management Service EMS EMSA See Event Management Service Analyzer EMSA Error A utility program that displays the error message associated with a ...

Page 421: ... of an individual file file mode The mode of operation in which Backup or Restore copy files one at a time File Utility Program FUP A utility program that allows you to perform a variety of operations on disk files forwarding distributor An EMS distributor process that sends selected event messages to an EMS collector on another network node or if the node has multiple collectors to an EMS collect...

Page 422: ...P is connectionless it routes data from a source address to a destination address See IP address IOP See input output process IOP IP See internet protocol IP IP address An internet protocol IP address An IP address consists of two parts a network address which identifies the network and a local address which identifies a host within a network A network address is concatenated with a host address t...

Page 423: ... allows an application or another process to communicate with data communications hardware low PIN A process identification number PIN that can range from 0 through 254 See also high PIN macro A sequence of TACL commands and built in functions that can contain dummy arguments thus providing a means for simple argument substitution When the macro name is given to TACL TACL substitutes the command s...

Page 424: ...incorporated into the operating system NonStop TM MP maintains the consistency and integrity of a distributed database that is updated by concurrent transactions NonStop Virtual Hometerm Subsystem VHS A subsystem that acts as a virtual home terminal for applications by emulating a 6530 terminal NonStop VHS receives messages normally sent to the home terminal such as displays and application prompt...

Page 425: ...ment use the OSS application program interface interactive users of the OSS environment use the OSS shell for their command interpreter operational ready site A fully operational backup site also known as a hot site that has all necessary hardware and software Archived data is sent to the operational ready site but is not loaded onto the system until a disaster occurs operations area The area wher...

Page 426: ...nds SCF can direct output to a disk file an application process a terminal or a printer The initial output destination is determined by the form of the RUN command used to initiate SCF The output destination can be changed dynamically during an SCF session path The route between a processor and a subsystem If a subsystem is configured for fault tolerance it has a primary path from the primary proc...

Page 427: ... An outage class that includes physical faults or failure in the hardware Any type of hardware component failure belongs in this category See outage class PIF See physical interface PIF PIN See performance management planned outage Time during which the system is not capable of doing useful work because of a planned interruption A planned outage can be time when the system is brought down to allow...

Page 428: ...outage class remote mirroring A pair of mirrored disk drives that are used together as a single logical drive in which the primary drive and the backup mirror drive are located in geographically distinct remote locations Each byte of data written to the primary drive is also written to the mirror drive If the primary drive fails the mirror drive can continue operations By providing geographic sepa...

Page 429: ...ommand group of the owner of the subsystem 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 ...

Page 430: ... ServerNet node ID and an identifier that is unique within that ServerNet node ServerNet addressable controller SAC A controller that is uniquely addressable within one or more ServerNet address domains SADs through the node ID and address fields in a request packet A SAC is typically implemented on some portion of a processor multifunction PMF customer replaceable unit CRU an I O multifunction IO...

Page 431: ...t devices on a particular node spooler supervisor A process that monitors and communicates with the other processes and decides when and where to print jobs Each spooler has one supervisor state In Subsystem Control Facility SCF subsystems one of the generally defined possible conditions of an object with respect to the management of that object Examples of states are DEFINED STARTED and STOPPED s...

Page 432: ...perations tasks such as controlling the status of peripherals and other system components super ID 255 255 A user ID that allows users to do anything on the system Users with the super ID can access all data and devices support area The area where the operations staff is located SWAN See ServerNet Wide Area Network SWAN concentrator swap space Each processor has at least one kernel managed swap fi...

Page 433: ...ent and that are based on reduced instruction set computing RISC technology TNS R processors implement the TNS R instruction set and maintain architectural compatibility with TNS processors The term TNS R can refer to the instruction set the architecture or the processors The first TNS R processor is the NSR L processor Systems with these processors are the NonStop Cyclone R and NonStop CLX 2000 s...

Page 434: ...tape drive Labeled tapes are rejected TCM See Tandem Capacity Model TCM TCP IP TCP IP is the name applied to the combined protocol layers that are defined by RFC 793 and 791 See Tandem TCP IP subsystem TERM A task that uses a screen program to control input and output devices such as terminals or workstations or input and output processes such as front end processes Each task runs as a thread in a...

Page 435: ...tion notifications are generated by the TSM server software on a NonStop Himalaya S series server when something occurs that might affect the performance of a resource managed by TSM The TSM Notification Director passes TSM application notifications to the TSM Notification Director where they are used to show up to date resource information TSM client software The portion of the Compaq Tandem Serv...

Page 436: ...ell be read from the other because the content of both disks is the same volume ID number VID A string of up to six alphanumeric characters for example AMBER1 that is assigned to a tape during the MEDIACOM ADD TAPELABEL operation This ID exists only for standard labeled tapes and it resides on the tape s first volume label and should also be on a hand written label which identifies the tape volume...

Page 437: ...9 19 Glossary 1 line 19 19 Attributes of spooler components collectors 15 5 devices 15 15 print processes 15 10 Attributes DEFINE 6 7 consistency checks 6 8 initial settings 6 7 listed by CLASS 6 7 setting with TACL commands 6 9 working attribute set 6 8 Attributes TAPE DEFINE 11 19 Automatic volume recognition AVR 10 2 Glossary 2 AXCEL timestamp information 18 7 B BACKCOPY program 11 23 Backcopy ...

Page 438: ...lified file set list 11 5 using a TAPE DEFINE 11 20 using labeled tapes 11 19 using RUN options 11 6 using wild card characters 11 4 VERIFYREEL option 11 8 VOL option 11 8 VOLUMEMODE option 11 8 BACKUPCPU command in TACL 2 7 BATCH command in Peruse 13 6 BATCH command in Spoolcom 14 8 Batch number 12 4 Binder timestamp information 18 7 Blind password logon feature 2 4 2 10 BLP mode bypass label pro...

Page 439: ...h FUP 7 3 used with Spoolcom 14 3 used with TACL OBEY command 4 8 Command history in TACL 2 15 2 20 Command interpreter TACL 2 2 Command line length Backup and Restore 11 6 11 13 Peruse 13 3 TACL 2 2 Comments in alias definition 5 3 in library file 5 3 in macro definition 5 4 in Spoolcom command file 14 3 in TACL command file 4 8 Common messages 17 3 Communications line 19 20 Communications Subsys...

Page 440: ... 6 3 Defaults logon changing 16 3 DEFINE command in TACL 2 6 DEFINEs altering example 12 13 attributes consistency checks 6 8 default settings 6 7 initial settings 6 7 optional 6 7 required 6 7 working set 6 8 classes 6 3 CATALOG DEFINE 6 4 DEFAULTS DEFINE 6 4 MAP DEFINE 6 4 SPOOL DEFINE 6 5 TAPE DEFINE 6 5 commands TACL table 6 9 creating example 6 9 12 12 definition of 6 1 deleting example 12 13...

Page 441: ...14 10 15 15 modifying attributes of 15 13 ownership 15 15 queues See Device queue shared 14 10 15 15 suspended 14 6 taking offline 14 6 Device spooler 12 2 attributes 12 6 form name 12 6 header message 12 6 state 12 6 errors that all users can correct 14 7 print queue 12 1 Disabling DEFINEs 6 6 Disk defined Glossary 4 Glossary 20 problems solving 9 28 space 9 14 sparing sectors 9 12 Disk files See...

Page 442: ... 14 29 checking spooler supervisor 14 10 checking status of PATHMON process 19 26 checking status of print device 14 20 checking status of SPOOLCOM jobs 14 22 checking status of spooler supervisor 14 29 checking status of TACL process 16 26 checking status of terminal line 16 31 checking status of TMF 19 23 checking TACL processes 4 4 clearing a device invalid state 14 34 clearing a nonprintable j...

Page 443: ...drive 10 12 SPOOLCOM DEV command 19 13 starting and resetting disks 9 7 starting new TACL process 16 29 start of shift checklist 1 4 stoping user process 16 28 stopping and restarting spooler subsystem 14 18 stopping and starting tape drives 10 13 stopping TACL process 16 27 TACL PPD command 4 2 4 4 TACL STATUS command 4 2 tape process warning message 10 16 unloading tapes 10 27 viewing labeled ta...

Page 444: ...key sequenced files 8 9 partitioned files 8 12 relative files 8 8 unstructured files 8 6 File Utility Program FUP basic uses of 7 1 BUILDKEYRECORDS command 8 20 commands ALTER 8 19 8 21 COPY 8 15 CREATE 8 1 8 14 14 13 DUPLICATE 7 13 7 15 8 17 DUPLICATE with RESTARTABLE option 7 14 EXIT 7 2 FC 7 21 FILES 7 9 GIVE 7 16 HELP 7 7 HISTORY 7 21 INFO 7 10 7 12 19 27 LOAD 8 16 LOADALTFILE 8 18 PURGE 7 17 ...

Page 445: ...ng distributor 17 2 Free space disk 9 14 FROMCATALOG file set qualifier for Backup 11 6 Full logon feature in TACL 2 4 Function key defined as a macro in TACL 5 2 5 5 defined as an alias in TACL 5 3 5 5 to declare current job in Peruse 13 4 to display a job in Peruse 13 5 FUP See File Utility Program FUP G GIVE command in FUP 7 16 Global passwords in network security 16 22 GMT Binder timestamp inf...

Page 446: ...ssage 12 6 state 12 6 selection algorithm 12 6 K Kernel Managed Swap Facility KMSF 9 25 Kernel managed swap files 9 25 KEYS command in TACL 5 6 Key sequenced files adding a partition 8 21 adding an alternate key 8 19 creating partitioned 8 12 8 13 with alternate keys 8 11 8 12 format of 8 9 increasinging a partition 8 20 loading 8 18 loading a partition 8 20 moving a partition 8 19 reorganizing 8 ...

Page 447: ...connection with device 15 14 making connection with device 14 14 15 12 15 18 rerouting jobs 15 14 subcommands BROADCAST 15 18 DELETE 14 5 14 24 15 14 15 19 DEV 14 5 14 14 14 23 14 24 15 12 15 14 15 18 FONT 15 18 STATUS 14 5 15 14 XREF 14 5 Locations spooler adding to spooler 15 17 attributes 15 18 deleting from spooler 15 19 establishing 15 12 Logging off in TACL 2 6 Logging on in Safeguard 2 9 in...

Page 448: ...ges 10 14 operator messages 17 1 processes 16 2 system status 16 2 Monitors 19 16 N NAME option in TACL command 2 7 4 9 Native Mode information 18 7 Network security 16 19 16 23 NL mode no label processing 10 5 10 7 NL mode tape processing Glossary 18 NLCHECK state 10 5 10 7 Glossary 8 No label processing NL mode 10 5 10 7 No label protection BLP mode 10 5 10 8 Node name 3 3 NonStop process pairs ...

Page 449: ...ATHCOM 19 25 PATHMON processes 19 25 Pathway commands 19 25 processes 19 25 transaction processing applications 19 25 PAUSE command in TACL 4 7 PEEK program 19 3 A 1 Peripheral device Glossary 3 Peruse 12 2 13 1 13 14 command summary table 13 6 commands COPIES 13 8 DEL 13 4 FILES 13 12 FIND 13 7 JOB 13 4 13 8 13 14 LIST 13 4 13 5 13 7 LIST LAST 13 11 LOC 13 8 13 11 NUMCOL 13 12 PAGE 13 7 13 10 PUR...

Page 450: ...ng information about 4 2 4 4 ID listed by STATUS command in TACL 4 3 running at a high PIN 4 6 security 16 15 16 18 starting with TACL RUN command 4 5 stopping with TACL STOP command 4 7 TACL restarting a 4 9 starting a remote 2 6 16 21 Process problems solving 4 11 Processes 19 16 Processor Glossary 12 Product files finding in the Guardian environment 18 1 Product version information 18 7 18 9 Pr...

Page 451: ...ption 11 14 11 16 LISTALL option 11 14 11 15 LISTONLY option 11 14 11 15 MAP NAMES option 11 17 MAPNAMES option 11 14 MULTIDRIVE option 11 14 MYID option 11 14 11 16 NOPROMPT option 11 14 NOSAFEGUARD option 11 14 NOT option 11 14 11 16 NOUNLOAD option 11 14 11 15 OPEN option 11 14 PAGELENGTH option 11 14 PART option 11 14 PARTOF option 11 14 PARTONLY option 11 15 REBUILD option 11 15 REMOTEIOSIZE ...

Page 452: ... 9 7 SWITCH 9 9 objects 19 16 Scratch tape 10 17 10 29 SEARCH DEFINE 6 3 Sector defective listing 9 12 sparing See also Sparing sectors determining which sectors to spare 9 12 SECURE command in FUP 7 16 Security 1 3 in TACL WHO display 2 14 Security file 7 16 Security system file 2 14 3 13 3 14 7 16 16 13 interfaces for 16 8 logon 2 3 16 10 network 16 19 16 23 process 16 15 16 18 Safeguard 2 1 2 9...

Page 453: ...15 3 15 5 STATUS 14 4 14 10 15 3 UNIT 15 4 COMMENT 14 4 DEV checking devices 14 28 CLEAR 14 4 DELETE 14 4 15 14 DEVRESET 15 15 DEVTYPE 15 15 DRAIN 14 4 14 6 14 28 14 31 14 34 15 8 15 14 ENDFF 15 15 EXCLUSIVE 15 9 15 15 FIFO 15 15 FORM 15 15 function 14 4 HEADER 15 16 LUEOLVALUE 15 16 LUEOLWHEN 15 16 LUTOFVALUE 15 16 monitoring 14 19 PARM 15 16 PROCESS 14 14 15 7 15 11 15 16 rerouting 14 21 RESTART...

Page 454: ...4 4 14 5 Spoolcom utility 12 2 14 1 14 7 command summary table 14 8 commands and spooler components 14 8 interactive use of 14 2 reading commands from a command file 14 3 security 14 1 Spooler adding device to running spooler 15 11 bringing from warm state to active state 14 12 broadcast and nonbroadcast groups 12 8 cold starting 14 12 14 15 collectors 12 2 components 12 2 control files 15 19 corr...

Page 455: ...specific type of file such as key sequenced files Subnetworks 16 23 SUBSORT DEFINE 6 3 Subsystem Control Facility SCF 9 1 Subsystem messages 17 3 Subsystems monitoring 16 2 SUBVOLS command in FUP 7 9 Subvolume defaulting in FUP 7 8 in TACL 3 3 Subvolume name 3 3 Super ID user 16 10 16 11 capabilities 16 11 predefined on a new system 16 12 Supervisor spooler checking status of 14 9 defined 12 2 how...

Page 456: ...TAL Transaction Application Language example of Peruse with 13 9 finding errors in a listing 13 10 Tandem Advanced Command Language TACL commands BACKUPCPU 2 7 EXIT 2 8 FC 2 17 FILEINFO 3 6 FILENAMES 3 6 FILES 3 5 HISTORY 2 15 KEYS 5 6 LOAD 5 12 LOGOFF 2 6 LOGON 2 3 OBEY 4 8 PASSWORD 2 8 PAUSE 4 7 PPD 4 3 PURGE 3 8 REMOTEPASSWORD 2 7 RENAME 3 8 RUN 4 5 SETPROMPT 3 12 5 12 STATUS 4 2 STOP 4 7 SYSTE...

Page 457: ...command 10 7 Tape labeled automatic volume recognition AVR 10 2 DEFINE attributes table 10 9 drive request 10 7 mount message 10 1 10 6 tape processing modes bypass label processing BLP mode 10 5 10 8 no label processing NL mode 10 5 10 7 10 8 standard label processing LP mode 10 5 10 6 using with Backcopy 11 23 11 25 using with Backup and Restore 11 19 11 22 Tape mounting for Backup 11 20 for Res...

Page 458: ... in TACL 2 14 Users of system See System users USERS program in TACL 2 14 USERS program TACL 14 31 16 7 Users system capabilities of 16 11 classes of 16 10 getting information about 2 14 V Version procedure information 18 7 Version Procedure utility VPROC 18 1 18 8 ViewSys utility 19 14 Volume Glossary 4 Glossary 20 See also Disk VOLUME command in FUP 7 8 in Peruse 13 6 in TACL 2 8 3 10 Volume ide...

Page 459: ...and 11 24 in Backup and Restore commands 11 4 in DEFINE templates 6 3 in FUP DUP command 7 13 in FUP INFO command 7 11 in FUP RENAME command 7 15 in TACL commands 3 5 in TACL FILEINFO command 3 7 in USERS program example 2 17 in VPROC command 18 3 18 4 two asterisks in DEFINE templates 6 3 plus sign in Peruse DEV display 14 7 hyphen as FUP prompt 7 2 in DEFINE names 6 2 two slashes in TACL FC comm...

Page 460: ...Index Guardian User s Guide 425266 001 Index 24 Special Characters ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands