HP 3000 Manuals HP 3000 Manuals
Silhouette Reference Manual Printed in U.S.A. HP 3000 Computer Systems HP Part No. 30302-90005 Edition U1288 Printed Dec 1988
Notice The information contained in this document is subject to change without notice. HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated to another language without the prior written consent of Hewlett-Packard Company. Copyright Æ 1988 by HEWLETT-PACKARD COMPANY Printing History New editions are complete revisions of the manual. Update packages, which are issued between editions, contain additional and replacement pages to be merged into the manual by the customer. The date on the title page and back cover of the manual changes only when a new edition is published. When an edition is reprinted, all the prior updates to the edition are incorporated. No information is incorporated into a reprinting unless it appears as a prior update. First Edition December 1988 A.20.00 Preface This is the first edition of the Silhouette Reference Manual (30302-90005). Silhouette is Hewlett-Packard's solution for providing high system availability. It allows you to dynamically duplicate databases from a primary HP 3000 system(s) to a secondary system if there is a primary system failure, to backup the databases without interrupting the primary system, and to improve system performance through load balancing over two or more systems. This manual is written for System Operators and System Managers who manage Silhouette. It explains how to use Silhouette in both interactive and batch job modes of operation. It includes a reference section on the commands used to manage Silhouette functions Organization of this Manual To help you find the information you need, a brief description of each chapter and appendix in this guide follows: Chapter 1 Introduction briefly describes the various Silhouette functions and an overview of what happens in the event of a primary system, secondary system, or communication line failure. Chapter 2 Using Silhouette describes system requirements, the various internal Silhouette components, commands, configuration files, special files, reports, and super transactions. Chapter 3 Silhouette Overview describes the normal operation of Silhouette and how to deal with possible system problems. Chapter 4 Installing Silhouette describes installing and configuring Silhouette, creating the configuration file, establishing the databases and logfiles, starting the system, verifying the installation and a worksheet for your use while managing Silhouette. Chapter 5 Silhouette Recovery Procedures describes how to recover from problem situations on the primary system, the communications line, or the secondary system. Chapter 6 Silhouette Commands is a reference section for Silhouette commands, including options, parameters, operation, and in most cases, examples. Appendix A Error Messages is a listing of all Silhouette error messages. Appendix B Diagnostic Messages is a listing of all Silhouette diagnostic messages. Appendix C Troubleshooting describes TSTART. TSTART provides diagnostic information on any problems encountered while starting Silhouette. Glossary A listing of terms and definitions used in this manual. How to Use this Manual If you are new to Silhouette, read Chapters 1 and 2 first. If you want an overview of how Silhouette operates under normal conditions, turn to Chapter 3. If you are an experienced Silhouette Operator, turn to Chapters 4 and 5 for task-oriented discussions on installing Silhouette or dealing with system problems. If you require specific information on Silhouette commands, turn to Chapter 6. In addition to this manual, you might also find the following sources of information useful: DSD/DS HP 3000 to HP 3000 (32189-90002) HP 3000 Data Base Management Reference Manual (32215-90003) LAN/3000/XL Link and Terminal LAN Link Hardware Reference Manual (36921-90002) MPE V Intrinsics Reference Manual (32033-90007) MPE V System Operation and Resource Management Reference (32033-90005) NS Cross-System Network Manager Reference Manual (5958-8564) TurboIMAGE/XL Database Management System Reference Manual (30391-90001) Conventions NOTATION DESCRIPTION UPPERCASE Within syntax statements, characters in uppercase must be entered in exactly the order shown, though you can enter them in either uppercase or lowercase. For example: SHOWJOB Valid entries: showjob ShowJob SHOWJOB Invalid entries: shojwob ShoJob SHOW_JOB italics Within syntax statements, a word in italics represents a formal parameter or argument that you must replace with an actual value. In the following example, you must replace filename with the name of the file you want to release: RELEASE filename punctuation Within syntax statements, punctuation characters (other than brackets, braces, vertical parallel lines, and ellipses) must be entered exactly as shown. { } Within syntax statements, braces enclose required elements. When several elements within braces are stacked, you must select one. In the following example, you must select ON or OFF: {ON } SETMSG {OFF} [ ] Within syntax statements, brackets enclose optional elements. In the following example, brackets around ,TEMP indicate that the parameter and its delimiter are optional: PURGE {filename} [,TEMP] When several elements with brackets are stacked, you can select any one of the elements or none. In the following example, you can select devicename or deviceclass or neither: [devicename ] SHOWDEV [deviceclass] [...] Within syntax statements, a horizontal ellipsis enclosed in brackets indicates that you can repeatedly select elements that appear within the immediately preceding pair of brackets or braces. In the following example, you can select itemname and its delimiter zero or more times. Each instance of itemname must be preceded by a comma: [,itemname][...] If a punctuation character precedes the ellipsis, you must use that character as a delimiter to separate repeated elements. However, if you select only one element, the delimiter is not required. In the following example, the comma cannot precede the first instance of itemname: [itemname][,...] |...| Within syntax statements, a horizontal ellipsis enclosed in parallel vertical lines indicates that you can select more than one element that appears within the immediately preceding pair of brackets or braces. However, each element can be selected only one time. In the following example, you must select ,A or ,B or ,A,B or ,B,A : {,A} {,B}|...| If a punctuation character precedes the ellipsis, you must use that character as a delimiter to separate repeated elements. However, if you select only one element, the delimiter is not required. In the following example, you must select A or B or AB or BA. The first element cannot be preceded by a comma: {A} {B}|,...| ... Within examples, horizontal or vertical ellipses indicate where portions of the example are omitted. NOTATION DESCRIPTION Å Within syntax statements, the space symbol Å shows a required blank. In the following example, you must separate modifier and variable with a blank: SET[(modifier)]Å(variable); shading Within an example of interactive dialog, shaded characters indicate user input or responses to prompts. In the following example, OMEGA is the user's response to the NEW NAME prompt: NEW NAME? OMEGA [[ ]] The symbol [[ ]] indicates a key on the terminal's keyboard. For example, [[CTRL]] indicates the Control key. [[CTRL]]char [[CTRL]]char indicates a control character. For example, [[CTRL]] Y means you have to simultaneously press the Control key and the Y key on the keyboard. base prefixes The prefixes %, #, and $ specify the numerical base of the value that follows: %num specifies an octal number. #num specifies a decimal number. $num specifies a hexadecimal number. When no base is specified, decimal is assumed. Bit When a parameter contains more than one piece of data (bit:length) within its bit field, the different data fields are described in the format Bit (bit:length), where bit is the first bit in the field and length is the number of consecutive bits in the field. For example, Bits (13:3) indicates bits 13, 14, and 15: most significant least significant |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--| | 0| | | | | | | | | | | | |13|14|15| |--|--|--|--|--|--|--|--|--|--|--|--|--|--|--|--| Bit (0:1) Bits(13:3)