VAXstation 8000 Owner's Manual Order Number: EK-VS800-OM-001 February 1988 OPERATING SYSTEM: VMS digital equipment corporation maynard, massachusetts ___________________________________________________ 1988 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. Digital Equipment Corporation assumes no responsi- bility for the use or reliability of its software on equipment that is not supplied by Digital or its affiliated companies. Copyright (c)February 1988 by Digital Equipment Corporation ___________________________________________________ All Rights Reserved USA U.S.A. Printed in This equipment generates, uses, and may emit radio frequency energy. The equipment has been type tested and found to comply with the limits for a Class A computing device pursuant to Subpart J of Part 15 of FCC Rules, which are designed to provide reasonable protection against such radio frequency interference. Operation of this equipment in a residential area may cause interference in which case the user at his own expense will be required to take whatever measures may be required to correct the interference. of Digital Equipment The following are trademarks ___________________________________________________ Corporation: DEC ULTRIX VAXstation DECnet ULTRIX-32 VMS DECUS UNIBUS VT MicroVAX VAX MicroVMS VAXBI DIGITAL PDP VAXcluster The X Window System is a trademark of Massachusetts Institute of Technology. Contents _______________________________________________________ How to Use This Book ...................... ix Chapter 1 Introduction to the Workstation VAXstation 8000 .................1-1 Pedestal ......................1-3 Monitor .......................1-6 Peripheral Repeater ..............1-6 Peripheral Devices ...............1-6 SYSTEM OPTIONS ................. 1-10 Memory Options ................. 1-11 Mass Storage Options............. 1-12 Peripheral Device Option .......... 1-12 Output Device Options ............ 1-13 SYSTEM SPECIFICATIONS ............ 1-13 Chapter 2 Workstation Operations PREPARATION ....................2-1 NORMAL SYSTEM STARTUP .............2-6 Language Selection ...............2-9 Extraordinary Operations .......... 2-11 ERRORS AND MESSAGES ............. 2-12 Startup Errors ................. 2-12 Autostart Messages .............. 2-13 Bootstrap Error Messages .......... 2-16 RESTART ...................... 2-17 ___ iii MONITOR ADJUSTMENTS ............. 2-17 Adjusting Contrast and Brightness ... 2-18 Degaussing the Screen ............ 2-18 Tilting the Monitor ............. 2-18 TAPE OPERATIONS ................ 2-18 Tape Handling.................. 2-21 Tape Write-Protect .............. 2-22 Tape Insertion ................. 2-24 Tape Rewinding and Unloading ....... 2-26 Chapter 3 Using the Workstation INTRODUCTION ...................3-1 STARTING A SESSION ...............3-3 Logging in .....................3-5 STARTUP WORK AREA ................3-7 Introduction to Windowing System .....3-8 Using Windows.................. 3-11 Using the Icon box .............. 3-15 Using Terminal Emulator Windows ..... 3-19 Cutting and Pasting with the Mouse... 3-19 Changing Terminal Characteristics--the yterm Set-Up Menu .............. 3-20 ENDING A SESSION ............... 3-22 Appendix A System Configuration INTRODUCTION ...................A-1 RUNNING THE AUTOSIZER .............A-2 EXAMINING THE CONFIGURATION DATA BASE .A-6 __ iv Appendix B Changing System Parameters INTRODUCTION ...................B-1 EEPROM Utility Overview ...........B-2 EEPROM Utility Guidelines ..........B-4 USING THE EEPROM UTILITY ...........B-6 EEPROM Utility Commands ...........B-8 Getting Help ...................B-9 Answering Questions ..............B-9 Selecting a Section ............. B-10 READING AND CHANGING EEPROM........ B-11 Startup Section--Loading the EEPROM Utility Buffer ...................... B-11 Startup Section--Restoring EEPROM Data B-14 General Section--Configuration and Summary ..................... B-15 Console Section--Default Console Baud Rate........................ B-17 Boot Section--Default Boot Device .... B-19 Microcode Patch Section--Microcode Patches ..................... B-21 End-Of-Pass Section--Exiting the EEPROM Utility ..................... B-24 CHECKSUMS .................... B-25 Appendix C Disk Formatting INTRODUCTION ...................C-1 TEST DESCRIPTION ................C-2 Test 1: Disk Formatter ............C-2 Format........................C-2 Reformat ......................C-3 Test 2: Verify/Bad-Block Update ......C-3 Test 3: Verify Only ..............C-3 RUNNING THE FORMATTER .............C-4 Flags ........................C-6 _ v Appendix D The Terminal Emulator TERMINAL CHARACTERISTICS ...........D-1 CHANGING TERMINAL CHARACTERISTICS ....D-3 Issuing DCL Commands..............D-3 Specifying Display Output ..........D-6 Changing Default Terminal Characteristics ................ D-10 Using the yterm Set-Up Menu to Change Terminal Characteristics ......... D-13 Appendix E Customizing Your Work Area Examples 2-1 Autostart Messages ............. 2-13 2-2 Halt Message .................. 2-16 A-1 Bootstrapping VDS ................A-2 A-2 Running the Autosizer .............A-5 A-3 Examining the Configuration Data Base .A-6 B-1 Running the EEPROM Utility .........B-6 B-2 EEPROM General Section Help Display .. B-11 B-3 EEPROM Restoring Data Display ...... B-14 B-4 EEPROM Configuration and Summary Display ..................... B-15 B-5 EEPROM Changing Console Default Baud Rate Display ..................... B-18 B-6 EEPROM Changing Default Boot Device Display ..................... B-20 B-7 EEPROM Loading Microcode Patches Display ..................... B-22 C-1 Selecting and Formatting a Drive 0....C-4 C-2 Formatting with the RUN Command ......C-6 C-3 Setting Event Flags ..............C-7 D-1 Sample .XDEFAULTS file ........... D-13 __ vi Figures 1-1 VAXstation 8000 .................1-2 1-2 Pedestal I/O Panel ...............1-4 1-3 Mouse ........................1-8 1-4 Keyboard ......................1-9 1-5 Dial Array .................... 1-10 1-6 Tablet....................... 1-13 2-1 Pedestal Control Panel ............2-3 2-2 Peripheral Repeater ..............2-7 2-3 Monitor Controls and Indicators ......2-8 2-4 System Startup Display, Upper Window . 2-10 2-5 System Startup Display, Lower Window . 2-11 2-6 Tape Drive Controls and Indicators... 2-21 2-7 Tape Cartridge ................. 2-23 2-8 Tape Cartridge Insertion .......... 2-24 3-1 Start Session Form ...............3-3 3-2 Problem Report Form ..............3-6 3-3 Startup Work Area ................3-8 3-4 A Window Banner and Its Components... 3-10 3-5 Overlapping Windows ............. 3-13 3-6 Icon box ..................... 3-16 3-7 yterm Set-Up Menu ............... 3-21 Tables 1-1 VAXstation 8000 Options .......... 1-11 1-2 Memory Configuration............. 1-11 1-3 Nonremovable-Disk Configuration ..... 1-12 1-4 VAXstation 8000 Physical Specifications ................ 1-14 1-5 VAXstation 8000 Electrical Specifications ................ 1-16 1-6 VAXstation 8000 Environmental Specifications ................ 1-17 2-1 Pedestal Control Panel Controls and Indicators .................... 2-4 ___ vii 2-2 VAXBI Node Description ........... 2-14 2-3 Hexadecimal Values for Memory Options 2-15 2-4 Tape Drive Indicators ............ 2-19 2-5 Tape Drive Controls ............. 2-20 3-1 Select Operations for Cut and Paste .. 3-20 B-1 EEPROM Utility Summary ............B-2 B-2 EEPROM Utility Commands ...........B-8 D-1 Command Line Options..............D-4 D-2 Size and Placement Command Line Options D-8 D-3 Fonts ........................D-9 D-4 .XDEFAULTS File Options .......... D-11 ____ viii How to Use This Book _______________________________________________________ The VAXstation 8000 The VAXstation 8000 is a high-performance work- station providing real-time interactive three- dimensional color graphics on a raster display. It was developed jointly by Digital Equipment Corporation and Evans & Sutherland Computer Corporation. Purpose of This Manual This manual tells you how to turn on the VAXstation 8000 under normal conditions. This manual: 1. Identifies and describes the major components of the VAXstation 8000. 2. Tells you how to turn on the VAXstation 8000 and verify that it has loaded its operational software, and explains how to recognize an error condition. 3. Tells you how to log in to the system, manipu- late windows and icons, and customize your work area. __ ix Intended Audience This manual is written for all owners and users of the VAXstation 8000. It is assumed that the typical VAXstation 8000 user is an expert in a discipline and will use the VAXstation 8000 to run applications appropriate to that discipline. The typical user is not expected to be an expert in workstations, graphics, computers, software, programming, or data processing. Associated Documents The following table lists the manuals and guides associated with the VAXstation 8000. ____________________________________________________ Order Number Title EK-VS800-SM VAXstation 8000 System Manual EK-VS800-IG VAXstation 8000 Installation Guide EK-VSXDA-TM VSXXX-DA Dial Array Technical Manual EK-VSXPR-TM VSXXX-CA/CB Peripheral Repeater Technical Manual EK-VR290-IN VR290 Color Video Monitor Installation/Owner's Guide AA-KW93A-TE SGR Programmer's Guide AA-KW92A-TE SGR Reference Manual AA-KW96A-TE SGR Reference Card AA-KW95A-TE HPWS Release Notes _ x ____________________________________________________ Order Number Title AA-KW94A-TE HPWS Installation Guide AA-KW90A-TE HPWS Toolkit Guide AA-KZ54A-TE HPWS General Information AA-KZ63A-TE X Toolkit Library--C Language Interface, Toolkit Beta Version 0.1, X Protocol Version 11 AA-KW91A-TE MIT XLib--C Language X Interface, ____________________________________________________ Protocol Version 11, Release 1 __ xi Conventions The notational conventions used in this manual are described in the following table: ___ xii ____ xiii ____________________________________________________ Convention Meaning NOTE Contains general information. CAUTION Contains information to prevent damage to equipment. Keywords and terms are printed in _______ Italics italics at first use, and, if defined or described, listed in the index. If not defined at first use, keyword definitions can be found in the Glossary or ___ ____________ _____ SGR Programmer's Guide Graphics Concepts appendix. Read as "mm through nn." This use of angle brackets and the colon indicates a bit field, or a set of lines or signals. For example, A<17:00> is the mnemonic for address lines "A17 through A00." Addresses Unless otherwise noted, all addresses are given in hexadecimal notation. k, M Abbreviations for kilo, Mega. Unless otherwise noted, k and M represent the full decimal value of quantities. For example: 8 kbytes 8192 bytes 8000 bytes / 32 kwords 32768 words 32000 words / 512 kbits 524288 bits 512000 bits / 4 Mbytes 4194304 bytes 4000000 bytes / Represents nonprinting keyboard keys, such as , , or . Represents the keys needed to enter a control sequence. A control sequence is entered by pressing and typing at the same time. ^n Terminal echo for control sequence ___ xiv . AbbreviationsAbbreviations are in accordance with ____________________________________________________ . ___ ___ ___ DEC STD 015 Chapter 1 Introduction to the Workstation _______________________________________________________ This chapter briefly describes the main parts of of the VAXstation 8000, system options, and system specifications. VAXstation 8000 The major physical components of the VAXstation 8000 (Figure 1-1) are: 1. Pedestal 2. Monitor 3. Peripheral Repeater 4. Peripherals Introduction to the Workstation 1-1 Figure 1-1: VAXstation 8000 Pictorial of the pedestal, monitor, PR box, and peripherals 1-2 Introduction to the Workstation Pedestal The pedestal is the largest unit of the workstation and contains the following physical and functional components. Control Panel The control panel contains various switches to power on the pedestal and load (bootstrap) the software. In addition, it has several indicators that show operational status; refer to the PREPARATION section in Chapter 2 for more detail. I/O Panel The monitor and peripheral repeater are connected to the pedestal on the I/O panel (Figure 1-2). The I/O panel is behind the pedestal's rear cover panel. Note that the I/O panel also provides connectors for an Ethernet cable and an optional ASCII output device. AC Circuit Breaker The circuit breaker for ac power to the pedestal is also located at the rear of the pedestal (Figure 1-2). This circuit breaker is normally left on at all times, and power is controlled with the control panel keyswitch. Host Subsystem The subsystem provides all the general-purpose ____ host processing functions. It runs the operating system software and includes the host processor, system memory, mass storage (disk and tape drives), local area network (Ethernet) controller, and interface to the graphics subsystem. Introduction to the Workstation 1-3 Figure 1-2: Pedestal I/O Panel Same as System Manual, but with callouts. NEW FIGURE 10-29-87 1-4 Introduction to the Workstation Mass Storage Mass storage, which is part of the host subsystem, is all the electromechanical data storage devices; that is, the nonremovable-disk drives (also called fixed-disk or Winchester drives), and tape drive. _ Nonremovable-Disk Drive _ The primary mass storage device is the RD54 nonremovable-disk drive. The VAXstation 8000 supports up to three 150-Mbyte RD54 drives for a disk capacity of up to 450 Mbytes (see Tables 1-1 and 1-3). _ Tape Drive _ The DIGITAL TK50 Tape Drive is 95-Mbyte streaming tape drive. It is used primarily for updating software and doing system backup. Operation of this drive is described in the TAPE OPERATIONS section in Chapter 2. Graphics Subsystem Modules The graphics subsystem provides all the graphics processing, display, and manipulation functions. In addition to the graphics subsystem modules contained within the pedestal, the graphics subsystem includes the monitor, peripheral repeater, and peripherals. The graphics subsystem modules include a graphics control processor and a set of six modules called the . The graphics control ________ ____ ___ graphics card set processor provides the interface to the host subsystem. The graphics card set provides all the graphics functions, such as rotation, scaling, translation, shearing, shading, and antialiasing. Introduction to the Workstation 1-5 Monitor The DIGITAL VR290 Color Monitor is part of the graphics subsystem, and is the focal point for all system operations. In addition to normal graphics displays, the monitor displays system status and error messages. The monitor normally sits on top of the peripheral repeater. Peripheral Repeater The DIGITAL VSXXX-CA/CB Peripheral Repeater sits below and supports the monitor. The peripheral repeater (also called the PR box) provides an interface between the peripherals and the remainder of the graphics subsystem. It also supplies ac power to the monitor through a switched receptacle, and dc power to the peripherals. Peripheral Devices Up to eight peripheral devices (also called interactive devices) can be connected to the peripheral repeater. Standard peripheral devices are the mouse, keyboard, and dial array. A graphics tablet is optional. Descriptions of the standard peripheral devices follow. 1-6 Introduction to the Workstation Mouse The standard mouse, Figure 1-3, is a DIGITAL VSXXX- AA Mouse with three programmable buttons. The mouse is a pointing device normally associated with one or more pointers (such as an arrow) on the monitor screen. Moving the mouse on a desktop causes corresponding movement of its associated pointer on the monitor screen. The application software running in the VAXstation 8000 determines the function of each mouse button. Introduction to the Workstation 1-7 Figure 1-3: Mouse Pictorial of the mouse 1-8 Introduction to the Workstation Keyboard The standard keyboard, Figure 1-4, is a DIGITAL LK201 Keyboard. Usually, 57 of the 105 keys provide standard typing functions and the remaining 48 provide programmable functions. The application software running in the VAXstation 8000 determines the function of each programmable key. Figure 1-4: Keyboard Pictorial of the keyboard Dial Array The standard dial array, Figure 1-5, is a DIGITAL VSXXX-DA Dial Array. The dial array has eight optical shaft-encoders, each having an associated segmented-LED (light-emitting diode) display. Each encoder and display can be programmed to control a parameter or function (such as scale, zoom, pan, rotate, and so on) as determined by the application software running in the VAXstation 8000. Introduction to the Workstation 1-9 Figure 1-5: Dial Array Pictorial of the dial array SYSTEM OPTIONS System options are listed in Table 1-1 and described in subsequent sections. 1-10 Introduction to the Workstation ____________________________________________________ Table 1-1: VAXstation 8000 Options ____________________________________________________ Option Description Memory MS820-BA 4-Mbyte memory module MS820-CA 16-Mbyte memory module Mass Storage RD53 71-Mbyte nonremovable- RD54 disk drive 150-Mbyte nonremovable- disk drive Peripheral VSXXX-AB Tablet devices Output devices RS232-compatible (data only) ASCII output device, up to 1200 baud. ____________________________________________________ Memory Options The base configuration of the VAXstation 8000 includes 16-Mbytes of memory on one module. An additional memory module can be installed to provide the total memory capacity shown in Table 1-2. ____________________________________________________ Table 1-2: Memory Configuration Capacity MS820-BA MS820-CA ____________________________________________________ (Mbytes) Modules Modules 16 0 1 20 1 1 32 0 2 ____________________________________________________ Introduction to the Workstation 1-11 Mass Storage Options The base configuration of the VAXstation 8000 includes one 150-Mbyte RD54 nonremovable-disk drive. Two additional drives can be installed to provide the nonremovable disk capacity shown in Table 1-3. ____________________________________________________ Table 1-3: Nonremovable-Disk Configuration Capacity RD53 RD54 ____________________________________________________ (Mbytes) Drives Drives 150 0 1 220 1 1 290 2 1 300 0 2 370 1 2 450 0 3 ____________________________________________________ Peripheral Device Option The DIGITAL VSXXX-AB Tablet (Figure 1-6) is an optional peripheral device. The tablet has a pointing device normally associated with one or more pointers (such as an arrow) on the monitor screen. The pointing device is either a stylus or a puck. The stylus is similar to a pencil and is simply a pointing device. The puck "points" with cross-hairs, and also has a set of four programmable buttons. The major difference between the tablet pointing device and the mouse is that the stylus or puck is moved within the boundaries of the tablet. The tablet provides a programmable coordinate-grid. The application software running in the VAXstation 8000 determines scale of the grid coordinates and the function of the puck buttons. 1-12 Introduction to the Workstation Figure 1-6: Tablet Pictorial of the tablet Output Device Options The VAXstation 8000 provides a port for connecting an optional ASCII output device (Figure 1-2). This is an RS232-compatible port, with only data lines and ground; control signal lines are not connected. This port is intended only for output. SYSTEM SPECIFICATIONS The VAXstation 8000 is designed to work in an open office environment. The physical, electrical, and environmental specifications for the VAXstation 8000 are listed in Tables 1-4 through 1-6. Introduction to the Workstation 1-13 ____________________________________________________ Table 1-4: VAXstation 8000 Physical Specifications ____________________________________________________ Parameter Specifications Pedestal Height 64.77 cm (25.50 in) Length 74.93 cm (29.50 in) Width 36.20 cm (14.25 in) Weight Approximately 84.00 kg (185.00 lb) VSXXX-CA/CB Peripheral Repeater 8.13 cm ( 3.20 in) Height 39.22 cm (15.40 in) Length 39.22 cm (15.40 in) Width 5.44 kg (12.00 lb) Weight VSXXX-DA Dial Array Height 8.00 cm ( 3.15 in) Length 29.21 cm (11.50 in) Width 17.20 cm ( 6.80 in) Weight 1.13 kg ( 2.50 lb) VSXXX-AA Mouse Height 42.01 cm ( 1.60 in) Diameter 5.08 cm ( 3.50 in) Weight 0.19 kg ( 6.00 oz) VSXXX-AB Tablet (Optional) 5.08 cm ( 2.00 in) Height 42.01 cm (16.50 in) Length 42.01 cm (16.50 in) Width 1.36 kg ( 3.00 lb) Weight 1-14 Introduction to the Workstation Table 1-4 (Continued): VAXstation 8000 Physical ____________________________________________________ Specifications ____________________________________________________ Parameter Specifications LK201 Keyboard Height 4.06 cm ( 1.60 in) Length 53.34 cm (21.00 in) Width 17.78 cm ( 7.00 in) Weight 1.36 kg ( 3.00 lb) VR290 Monitor Height 47.0 cm (18.5 in) Length 54.6 cm (21.5 in) Width 51.8 cm (20.0 in) Weight 41 kg (90 lb) Display size 326 275 mm (12.8 10.8 Diagonal size in) Resolution 480 mm (18.9 in) viewable 1024 horizontal 864 vertical pixels ____________________________________________________ Introduction to the Workstation 1-15 ____________________________________________________ Table 1-5: VAXstation 8000 Electrical Specifications ____________________________________________________ Device Power Requirement Pedestal 88 to 132 Vac, 47 to 63 Hz, at 20 A (maximum) 176 to 264 Vac, 47 to 63 Hz, at 10 A (maximum) VSXXX-CA/CB 88 to 132 Vac, 47 to 63 Hz, Peripheral Repeater at 2.4 A (steady state) 176 to 264 Vac, 47 to 63 Hz, at 1.3 A (steady state) VSXXX-DA Dial Array +5.0 Vdc # VSXXX-AA Mouse +5.0 Vdc # VSXXX-AB Tablet +12.0 Vdc # LK201 Keyboard +12.0 Vdc # VR290 Monitor 88 to 132 Vac, 60 Hz # 185 to 264 Vac, 50 Hz 150 W nominal ____________________________________________________ Power supplied by VSXXX-CA/CB Peripheral Repeater # Power supplied through a switched receptacle on # the VSXXX-CA/CB Peripheral Repeater ____________________________________________________ 1-16 Introduction to the Workstation ____________________________________________________ Table 1-6: VAXstation 8000 Environmental Specifications ____________________________________________________ Parameter Specification Operating Temperature 10o to 40o C (50o to Altitude 104o F) # Relative humidity 2.4 km (8000 ft) maxi- Maximum wet-bulb tempera- mum ture 10% to 90% (noncondens- Minimum dew-point tempera- ing) ture 28o C (82.4o F) 2o C (36o F) Nonoperating Temperature -40o to 66o C (-40o to Altitude 151o F) Relative humidity 4.9 km (16000 ft) typi- cal 10% to 95% (noncondens- ing) Storage Temperature 5o to 50o C (41o to 122o Relative humidity F) Maximum wet-bulb tempera- 10% to 95% (noncondens- ture ing) 32o C (90o F) ____________________________________________________ De-rate maximum operating temperature 1.82o C/km # (1.0o F/1000 ft) above sea level. ____________________________________________________ Introduction to the Workstation 1-17 Chapter 2 Workstation Operations _______________________________________________________ This chapter tells you how to turn on the VAXstation 8000 and bootstrap its software. It also describes the controls, indicators, and media-handling proce- dures for mass storage devices. only This chapter describes the normal system startup and bootstrap procedures. PREPARATION The instructions in this chapter assume your VAXstation 8000, operating system, and workstation software are correctly installed. For site require- ments and complete installation instructions, see the __________ ____ ____________ ______ VAXstation 8000 Installation Guide. Before performing the steps for a system startup, make sure that the pedestal ac circuit breaker (Figure 1-2) is on. Normally, this circuit breaker is always on, and power is controlled by the keyswitch on the pedestal control panel. Workstation Operations 2-1 The pedestal control panel is shown in Figure 2-1, and the controls and indicators are described in Table 2-1. The Auto Start and Update switches should be set as follows: _ Auto Start on (dot-in-circle is pressed) _ _ Update off (dot-above-circle is pressed) _ 2-2 Workstation Operations Figure 2-1: Pedestal Control Panel Pictorial of Pedestal Control Panel Workstation Operations 2-3 Table 2-1: Pedestal Control Panel Controls and ____________________________________________________ Indicators ____________________________________________________ Switch PositionDescription Power Off (dot-above-circle) All system dc keyswitch power is turned off, except for 300 Vdc from the ac converter. Secure Power (dc) is applied to the system and instructions are being executed. Host console mode is disabled. Enable Power (dc) is applied to the system and instructions are being executed. Host console mode is enabled. Restart This is a momentary contact position. The power-down/power- up sequence is executed to reinitialize the system. System power is not turned off. Auto Off (dot-above-circle pressed) The Start host enters console mode and switch[1] halts when: _ system power is turned on, or _ _ a console mode I (initialize) _ command is entered. The host does not boot the operating system. ____________________________________________________ [1]Toggling this switch during normal operation has no effect on the system. 2-4 Workstation Operations Table 2-1 (Continued): Pedestal Control Panel ____________________________________________________ Controls and Indicators ____________________________________________________ Switch PositionDescription On (dot-in-circle pressed) The host attempts a warm restart when: _ system power is turned on, or _ _ a console mode I (initialize) _ command is entered. If the restart fails, the host attempts to boot the operating system. Update Off (dot-above-circle pressed) switch[1] The host EEPROM (electrically erasable programmable read-only memory) is write-protected. On (dot-in-circle pressed) The host EEPROM can be written under software control; that is, using the EEPROM utility. Power Green When on, indicates that all indicator voltages are within tolerance. When off, indicates that there is no dc power. Run Green When on, indicates that the host indicator is executing program macrocode (VAX instructions). When off, indicates the host is in console mode. ____________________________________________________ [1]Toggling this switch during normal operation has no effect on the system. Workstation Operations 2-5 Table 2-1 (Continued): Pedestal Control Panel ____________________________________________________ Controls and Indicators ____________________________________________________ Switch PositionDescription Fault Red Turns on during self-test, and indicator stays on if any VAXBI module fails self-test. Turns off after 20 seconds if the normal self- test diagnostics pass. ____________________________________________________ NORMAL SYSTEM STARTUP You must turn on three power switches: 1. Peripheral Repeater 2. Monitor 3. Pedestal The monitor receives its power through a switched receptacle on the peripheral repeater. The peripheral repeater and the monitor should be turned on before the pedestal, because the monitor is needed to display system messages. When pedestal power is turned on, an automatic bootstrap program is executed to load system software. __ ___ __ ___ _________ _____ ____ __ ____ ___ If any of the following steps fail or give the ____ Note _____ ___________ _____ __ _______ _______ _____ __ wrong indication, refer to Startup Errors, later in ____ ________ this chapter. 1. Locate the peripheral repeater's power switch (see Figure 2-2) and press the switch. The green indicator on the front of the peripheral repeater should light after approximately 10 seconds. 2. Locate the monitor's power switch (Figure 2-3) and press the switch. The green indicator on the front lower-right corner of the monitor should light within 30 seconds. If monitor intensity 2-6 Workstation Operations is correctly adjusted, you should see a display on the monitor within 30 seconds of turning on pedestal power. Note that the monitor power switch can remain on and monitor power can be controlled with the peripheral repeater power switch. Figure 2-2: Peripheral Repeater Pictorial of PR Power switch and LED 3. Locate the power keyswitch on the pedestal control panel (Figure 2-1). a. Turn the power keyswitch to the Secure position. b. The green Power indicator should light immediately and stay lighted as long as power is applied to the system. c. The green Run indicator should be off. Workstation Operations 2-7 Figure 2-3: Monitor Controls and Indicators Pictorial of Monitor Power switch and LED d. The red Fault indicator should light immediately and stay lighted until self-test passes (approximately 20 seconds). 2-8 Workstation Operations During startup, the system components run automatic self-tests. The progress and results of a system startup are displayed as follows: _ The red Fault light on the pedestal control _ panel is turned off. _ The green Run light on the pedestal control _ panel is turned on, indicating that the host processor is in . _______ ____ program mode _ The four keyboard indicators (above special _ function keys F15 and F16) turn on and off in unison, and then blink in alternate pairs for approximately 60 seconds. Finally, the four indicators turn off and the keyboard bell sounds once. _ Within 60 seconds after power is turned on, _ two "windows" will be displayed on the screen. See Language Selection for a description of the information displayed in these windows. At this point, the operating system (but not the workstation software) has been loaded. You must now select a language in the next section. Language Selection Figures 2-4 and 2-5 show the upper and lower windows displayed during the first part of a normal system startup. The results of the power-up self-tests and system startup messages are displayed in the upper window. These are described in Autostart Messages. You can adjust the monitor display at this point; see MONITOR ADJUSTMENTS in this chapter. ________ _________ ________ ___ ___ ________ __ Graphics subsystem failures are not reported in ____ Note ___ _______ _______ __ ___ ________ __ ___ ________ the startup display on the monitor. If the graphics _________ _____ __________ _____ __ ______ __ subsystem fails self-test, there is either no _______ _______ __ ___ _______ __ ___ ____ ________ startup display on the monitor or the four keyboard __________ __________ ______ ____ __ ___ ______ ___ indicators (described above) turn on and remain on, ___ ___ ________ ____ ______ _____ ______ and the keyboard bell sounds three times. Workstation Operations 2-9 Figure 2-4: System Startup Display, Upper Window The lower window (Figure 2-5) displays a blue bar across the top, a language selection menu, and a small box. At this point, the only keys enabled on _ the keyboard are the standard keyboard number keys _| 1 through 0, the Delete key . Pressing any other key, or pressing the enabled keys in the wrong sequence, causes the keyboard bell to sound. To select a language: 1. Type the number for the desired language. The _ number is displayed in the box adjacent to the _| menu. The keys are disabled until a number has been typed. _| If you make a mistake, press to complete the selection. 2-10 Workstation Operations The blue bar moves from the top of the lower window to the top of the upper window, indicat- ing that the keyboard is now active in the upper window. Figure 2-5: System Startup Display, Lower Window After you have selected a language, the system loads the workstation software. Additional system messages will be displayed until the Start Session Form is displayed. The Start Session Form is part of the human interface to the workstation software and is described in Chapter 3. Extraordinary Operations In addition to the normal system startup, there are several operating modes for the VAXstation 8000 and several ways to load the software. In general, these optional operating modes and bootstraps are used for extraordinary or abnormal conditions. They require system operator skills beyond the assumed skills a typical VAXstation 8000 user might have to run application software. The following appendices describe such extraordinary operations. Workstation Operations 2-11 _ Appendix A describes how to bootstrap the VAX _ Diagnostic Supervisor (VDS) and run a program called the autosizer. The autosizer builds a configuration data base, and this data base is used by VDS to run other diagnostics. _ Appendix B describes a utility program that _ runs under VDS and is used to examine or modify specific system parameters stored in EEPROM. _ Appendix C describes how to format nonremovable _ disks using a diagnostic program that runs under VDS. To operate the system in a way other than is described in this manual, see your system manager or refer to other system documentation. ERRORS AND MESSAGES The following sections list things to check if the step-by-step procedures in NORMAL SYSTEM STARTUP fail. They also describe the format of the messages displayed in the upper window. Startup Errors If any of the startup procedures in NORMAL SYSTEM STARTUP fails or gives the wrong indication, make sure that the pedestal ac circuit breaker is on, verify all switch settings, and check the following cable and cord connections: _ Power cord from pedestal to wall receptacle _ _ Power cord from monitor to peripheral repeater _ _ Power cord from peripheral repeater to wall _ receptacle _ Signal cable from pedestal to monitor _ _ Signal cable from pedestal to peripheral _ repeater 2-12 Workstation Operations _ Signal cable from keyboard to peripheral _ repeater If all the switch settings and connections appear to be correct, refer the problem to your system manager. Autostart Messages Example 2-1 shows the typical messages displayed on the monitor during a successful system autostart. Example 2-1: Autostart Messages #ABCDEFGHIJK..N# . . 2 3 4 5 6 7 . . . . . . . . 01400000 VAX/VMS Version V4.7 19-Oct-1987 17:00 %%%%%%%%%%% OPCOM 10-NOV-1987 12:09:52.23 %%%%%%%%%%% (system information messages) Example 2-1 Description: 1. #ABCDEFGHIJK..N# This sequence of 14 alphabetic characters is displayed one character at a time as the host processor runs through its self-tests. Note that tests L and M are normally disabled, and a period (.) is displayed in place of the L and M. The number sign (#) indicates the start and end of the sequence. If the sequence stops before the N is displayed, an error has been detected. The last character displayed corresponds to the last test to pass. The tests are described in the . If a failure __________ ____ ______ ______ VAXstation 8000 System Manual is indicated, refer the problem to your system manager. Workstation Operations 2-13 2. . . 2 3 4 5 6 7 . . . . . . . . This line of numerical characters shows the status of the self-tests for each of the system modules, or . The modules in a _____ _____ VAXBI nodes typical system are listed in Table 2-2. The status is either pass, fail, or missing, as follows: _ Pass: A number, corresponding to the , is _______ node-ID _ displayed if the node passed self-test. _ Fail: A hyphen (-) preceding a node-ID number _ indicates that the node failed its self-test. If a failure is indicated, refer the problem to your system manager. _ Missing: A period (.) in place of a number _ indicates the node is not installed. Node 4 is normally the only node-ID replaced by a period, indicating that an optional, second memory module is not installed. ____________________________________________________ Table 2-2: VAXBI Node Description Node Module ____________________________________________________ Number Number Description 2 KA825 Host processor module 3 MS820 Memory module 4 MS820 Memory module (optional) 5 KFBTA Disk controller 6 DEBNK Tape and Ethernet controller 2-14 Workstation Operations ____________________________________________________ Table 2-2 (Continued): VAXBI Node Description Node Module ____________________________________________________ Number Number Description 7 KA800 Graphics subsystem control processor. The self-test report for this module includes the status of self-test for all the graphics card set modules. ____________________________________________________ ________ _________ ________ ___ ___ ________ Graphics subsystem failures are not reported ____ Note __ ___ _______ _______ __ ___ ________ __ ____ _ in the startup display on the monitor. If node 7 _______ _____ __________ _ __ __ ___ __________ (KA800) fails self-test, a -7 is not displayed; ________ _____ __ __ _______ _______ __ ___ instead, there is no startup display on the ________ __ ________ _____ ________ _________ monitor. To indicate other graphics subsystem _________ ___ ____ ________ __________ __________ failures, the four keyboard indicators (described ______ ____ __ ___ ______ ___ ___ ___ ________ ____ above) turn on and remain on, and the keyboard bell ______ _____ ______ sounds three times. ___ _________ _________ ___ __ ___ ___ ________ __ The bootstrap operation may or may not continue if _ __________ ____ __ _______ __ _______ _________ a particular node is missing or failed, depending __ ___ ________ __ ___ _____ __________ ___ on the function of the node. Self-tests are _________ __ ___ __________ ____ ______ _______ described in the VAXstation 8000 System Manual. 3. 01400000 This hexadecimal value is the upper address + 1 of installed VAXBI memory. In other words, 13FFFFF+1 = 140000016, indicating that 20 Mbytes of memory are installed. Table 2-3 shows the valid hexadecimal values. ____________________________________________________ Table 2-3: Hexadecimal Values for Memory Options ____________________________________________________ Value Capacity (Mbytes) 100000016 16 20 140000016 32 200000016 ____________________________________________________ Workstation Operations 2-15 VAX/VMS Version V4.7 19-Oct-1987 17:00 %%%%%%%%%%% OPCOM 10-NOV-1987 12:09:52.23 %%%%%%%%%%% (system information messages) This typical operating system banner, followed by system information messages, indicates that the bootstrap is executing successfully. For explanations of these messages, refer to your operating system documentation. Bootstrap Error Messages If no errors are reported in the first two lines of the Autostart Message (Example 2-1), the host will attempt to bootstrap the operating system. If bootstrap cannot proceed, the host will abort the bootstrap, display a message, halt, and enter The display will be similar to _______ _____ console mode. Example 2-2. Example 2-2: Halt Message ?01 PC = 000002000 >>> Example 2-2 Description: 1. This is a host processor halt code. Code ?01 is a normal halt code; it means the self-test passed. The halt occurred because the system was started in instead of . _______ ____ _______ ____ console mode program mode That is, the power keyswitch is in the Enable position instead of the Secure position. (The halt codes are described in the __________ ____ VAXstation 8000 .) ______ ______ System Manual 2-16 Workstation Operations 2. PC = 00000200 This hexadecimal address is contained in the PC (program counter). It is the address of the next instruction to be executed in program mode, not console mode. 3. >>> This is the console mode prompt. If the system starts in console mode, and you do not know what to do, refer the problem to your system manager. RESTART A restart is performed with system power on. When performed, a restart resets certain system parameters to a predetermined condition and then executes an automatic bootstrap. To restart the system: 1. System power must be on. In other words, the power keyswitch should be in the Secure position. See Figure 2-1. 2. Set the pedestal control panel Auto Start switch to on (dot-in-circle is pressed). 3. Rotate the power keyswitch to the Restart position, then return it to the Secure position. MONITOR ADJUSTMENTS The monitor operator adjustments and controls, shown in Figure 2-3, are: _ Contrast _ _ Brightness _ _ Degauss _ _ Tilt _ Workstation Operations 2-17 Adjusting Contrast and Brightness To change the contrast and brightness: 1. Turn the Contrast control to its minimum position. 2. Adjust the Brightness control to the point where the display disappears. 3. Adjust Contrast to your liking. Degaussing the Screen The Degauss switch corrects color purity. If the display shows color distortion, momentarily press the Degauss switch. If additional degaussing is required, you must wait 10 minutes for the degaussing circuit to recover before pressing the switch again. Tilting the Monitor To change the angle of monitor tilt: 1. Unlock the monitor base by sliding the tilt lever toward the back of the base. 2. Position the monitor to your liking. 3. Lock the monitor base by sliding the tilt lever toward the front of the base. TAPE OPERATIONS This section describes: _ Handling and storing tape cartridges _ _ Write-protecting, inserting, rewinding, and _ unloading TK50 tape cartridges For the command procedures to perform read and write operations, see the operating system or application documentation. 2-18 Workstation Operations The tape drive holds one removable TK50 magnetic tape cartridge. The drive includes a cartridge release handle, a lighted (red) load/unload pushbutton, and a green indicator. See Tables 2-4 and 2-5 and Figure 2-6. ____________________________________________________ Table 2-4: Tape Drive Indicators Green Red ____________________________________________________ Indicator Indicator[1] Description OFF OFF No power to the tape drive OFF ON Do not lift cartridge release handle. Occurs when: _ Self-test is running _ _ Cartridge is inserted but _ handle is up _ Tape is loading or unloading _ _ Tape is stopped _ ON OFF Safe to lift cartridge release handle ON ON Tape loaded successfully Blinking[2] Tape is in forward motion. ON Read/write commands are being processed Blinking Blinking Tape is rewinding. ____________________________________________________ [1]Integral to the load/unload pushbutton switch. [2]Irregular, fast blinking means the system is performing tape calibration on a new tape. A tape calibration sequence takes up to 2 minutes. Workstation Operations 2-19 ____________________________________________________ Table 2-4 (Continued): Tape Drive Indicators Green Red ____________________________________________________ Indicator Indicator[1] Description Blinking Blinking A fault has occurred. Press and release the load/unload button rapidly four times. If the condition remains, do not use the drive or remove the cartridge. Call ____________________________________________________ your service representative. [1]Integral to the load/unload pushbutton switch. ____________________________________________________ ____________________________________________________ Table 2-5: Tape Drive Controls ____________________________________________________ Control Position Description Cartridge Release UP To insert or remove a Handle tape. DOWN To lock tape in operating position. Load/Unload IN Loads the tape. Pushbutton OUT Rewinds and unloads the tape. ____________________________________________________ 2-20 Workstation Operations Figure 2-6: Tape Drive Controls and Indicators Similar to drawing MLO-370-85. Label green indicator. Tape Handling Figure 2-7 shows a TK50 tape cartridge. The following guidelines should be followed when handling cartridges: _ Do not apply stick-on labels to the top, bottom, _ or sides of a cartridge. Do not write on a tape Workstation Operations 2-21 cartridge with a pen or pencil. Write the tape identification on a label, then insert the label into the slot on the front of the cartridge. _ Do not drop the cartridge. The impact from a _ fall can damage the cartridge. _ Before using new prerecorded tapes, allow them _ to stabilize at room temperature for 24 hours. _ Store cartridges at an even temperature between _ 10o and 52o C (14o and 125o F). _ Do not expose tape cartridges to dust, direct _ sunlight, heat, X-ray equipment, magnets, or equipment that generates magnetic fields such as motors, transformers, or video displays. _ Cartridges should be inserted and removed only _ when power is on; that is, the green indicator is on, and the red indicator is off. Tape Write-Protect To prevent overwriting tape data, slide the write- protect "switch" to the left. See Figure 2-7. An orange square will be visible in the top left notch of the switch, indicating that you cannot write to the tape. Slide the switch to the right when you want to write the tape. 2-22 Workstation Operations Figure 2-7: Tape Cartridge Drawing MLO-371-85 Workstation Operations 2-23 Tape Insertion Figure 2-8 shows the sequence for inserting a tape cartridge. Figure 2-8: Tape Cartridge Insertion Similar to drawing MLO-372-85 __________ ______ __ ________ ___ _______ ____ Cartridges should be inserted and removed only _______ Caution ____ _____ __ __ ____ _____ _________ __ ___ ___ when power is on (the green indicator is on, and ___ ___ _________ __ _____ the red indicator is off). 1. Make sure that system power is on and the red load/unload indicator is off. Note that the red indicator is normally lighted for approximately 2-24 Workstation Operations 2 seconds during the tape drive power-up self- test. When the red indicator is off, and the green indicator is on, it is safe to lift the cartridge release handle. 2. Lift the cartridge release handle. _____ ____ ___ _________ _______ ______ ____ Never lift the cartridge release handle when _______ Caution ___ ___ _________ __ ___ the red indicator is on. 3. Hold the cartridge so that the write-protect switch is at the top, and insert the cartridge into the drive. _ Red indicator is on. _ _ Green indicator is off. _ 4. Push down the cartridge release handle. _ Red indicator is off _ _ Green indicator is on _ 5. Push the load/unload button to the In position. _ Red indicator is on _ _ Green indicator is off _ 6. The tape loads in 10 to 15 seconds. Tape loading means that an internal drive mechanism places the tape leader on a take-up reel. Data transfers can take longer than 30 minutes. If a tape is in place when system power is turned on, rewinding and loading can take up to 2 minutes. If a tape is new, the system performs a calibration sequence, and loading can take up to 2 minutes. __ ___ ___ _________ ______ _______ __ ___ If the red indicator blinks rapidly at any _______ Caution _____ _ _____ ___ _________ _____ ___ _______ ___ time, a fault has occurred. Press and release the ___________ ______ ____ ______ __ ___ _________ load/unload button four times. If the condition ________ __ ___ ___ ___ _____ __ ______ ___ remains, do not use the drive or remove the __________ ____ ____ _______ _______________ cartridge. Call your service representative. Workstation Operations 2-25 Tape Rewinding and Unloading ___ ____ ______ ___ ______ _ ____ _________ You must rewind and unload a tape cartridge _______ Caution ______ ___ ______ __ ____ ___ ______ before you remove it from the drive. 1. Press the load/unload button to the out position to rewind and unload the tape. A tape can also be rewound under software control. See your software documentation for information. _ The red and green indicators blink as the _ tape rewinds to the beginning of the tape. _ As the tape unloads into the cartridge, _ the red indicator stays on and the green indicator is off. _ When the tape is unloaded, the red indicator _ is off and the green indicator is on. 2. Lift the cartridge release handle. _ Red indicator is on _ _ Green indicator is off _ _____ ____ ___ _________ _______ ______ ____ Never lift the cartridge release handle when _______ Caution ___ ___ _________ __ ___ the red indicator is on. 3. Remove the cartridge and store it. 4. Push down the cartridge release handle. _ Red indicator is off _ _ Green indicator is on _ 2-26 Workstation Operations Chapter 3 Using the Workstation _______________________________________________________ INTRODUCTION This chapter describes how to use your VAXstation 8000 running the VAX/VMS operating system and High- Performance Workstation Software (HPWS) to perform routine tasks. In addition, it includes tutorials for certain operations. In general, HPWS comprises the following: _ Session manager _ _ Window manager _ _ Terminal emulator application _ The session manager helps control a user session. A user session includes checking initial authoriza- tion, starting an individual work environment, and ending a session. The window manager provides user control of windows on the screen. (HPWS uses the TM X Window System ). The terminal emulator appli- cation provides interactive communication with the operating system. Using the Workstation 3-1 Assumptions The descriptions of operations in this chapter make the following assumptions: 1. Your account already exists. If you are not sure what your account name and password are, ask your system manager. 2. You have a general understanding of the VMS operating system and know how to enter simple commands using DCL (Digital Control Language). Two manuals you may wish to consult are _______ VAX/VMS and ___ __________ _____ __ _____ ___ ___ DCL Dictionary Guide to Using DCL and . _______ __________ __ _______ Command Procedures on VAX/VMS 3. You are not necessarily an expert at using a mouse. This chapter gives detailed instructions on how to use a mouse. The following terms are used in describing actions performed with a mouse: _ Cursor: The is a graphic symbol that ______ cursor _ moves on the screen in accordance with how you move the mouse on your table. The cursor assumes different shapes in different situations. One common cursor shape is an X. _ Pointing: When you move the cursor to _ an object (image) on the screen, you are to that object. ________ pointing _ Selecting: Once you point to an object, you _ it by clicking (briefly pressing and ______ select releasing) the left button on the mouse. (Other applications make use of the other mouse buttons.) _ Dragging: Dragging refers to a sequence of _ actions that includes: (1) pressing a mouse button; (2) while holding down the button, moving the mouse to a desired location; and (3) releasing the button. This technique is used when moving windows. 3-2 Using the Workstation _ Keyboard Focusing: This technique refers _ to directing keyboard input to a particular window. When you select a window, you are the keyboard on the selected window, ________ focusing and you will see your keystrokes echoed in that window. STARTING A SESSION Assuming that the system startup and software bootstrap procedures described in Chapter 2 have been successful, your screen will look like Figure 3-1. Figure 3-1: Start Session Form A form requesting your account name and password Figure 3-1 shows the Start Session Form. The Start Session Form is the gate through which you become authorized to use your account. ___ __________ ____ ________ _ ______ ________ The VAXstation 8000 provides a screen time-out ____ Note ________ _____ _ ______ __ ___________ ___ ______ feature. After a period of inactivity, the screen ____ ______ ___ _________ ____ __ ______ ___ _____ goes blank. Any activity, such as moving the mouse __ ________ _ ____ ________ ___ ______ ______ or pressing a key, restores the screen image. Using the Workstation 3-3 Name Notice that the box has a heavier border Password than the box. The heavy border indicates that the Name box has the keyboard focus. Do the following: 1. Select the Password box. (Remember: Selecting an object means moving the mouse cursor to that object and clicking the left mouse button.) Notice that the heavy border has moved to the Password box. 2. Select the Name box. Notice that the heavy border has moved back to the Name box. 3. Select one box and then the other. Do this several times to get the feel of selecting with the mouse. 4. Select the Name box and type something. An insertion point (caret) moves along as you type, indicating your typing position. Notice that what you type appears in the box with the heavy border. The keyboard is focused on (or ________ attached ) that box. The heavy border indicates the box __ to that has the keyboard focus. 5. Select the Password box and type something. Note that the letters you type are not displayed on the screen. Instead, a gray bar advances with the insertion point. 6. Select the box. This action erases everything you have typed. 7. Type something (it doesn't matter in which box) and practice erasing by using various keys: _ The Delete key erases the character to _ the left of the insertion point. You will probably use this deleting method the most. _ Try using the < > and the < > keys to move # # = = _ the insertion point left and right. Move the insertion point into the middle of a line you have typed. Then type something. Notice that the new characters you type push the existing 3-4 Using the Workstation characters to the right, rather than write over them. _ With the insertion point in the middle of a _ line you have typed, press . This action erases the character to the right of the insertion point. Logging in The usual way to log in is: 1. Type the account name. 2. Press . This focuses the keyboard on the Password box. 3. Type the password. 4. Press . This causes the name and the password to be sent to the system, which checks the information to see if it is correct, and if it is, lets you into the account. __ ____ ___ _______ ________ _ _________ _________ If your VMS account requires a secondary password, ____ Note _ _____ ___ _______ __ ___ ______ _____ ___ ____ a third box appears on the screen after the name ___ ___ _______ ________ ___ _________ ____ ___ and the primary password are verified. This box _____ ___ ____ ___ __ ___ ___ ___ ___ _______ works the same way as the box for the primary _________ password. The Start Session Form is flexible in the order in which you can enter items, and in how you move from item to item. For example, instead of entering the items in the usual manner described above, you could select the Password box and enter your password, then select the Name box and enter the name, and then send the information to the system by clicking the box. When you select the box, you are in effect saying to the system: "Take the information I have entered and verify it. If it is correct, let me into my account." Using the Workstation 3-5 Before entering your account, try one more exercise: 1. Enter information into the Name box and the Password box, but make sure the information is wrong. For example, misspell the name or the password. Or, enter information into only one of the boxes. Or, erase all information. (You can do this by clicking the box, for example.) In any case, make sure that you have entered ___ not the correct information that is required for successful login. 2. Click on the box to send the information to the system. 3. Because the information you sent is not correct, the system does not let you start a session. Instead, it displays the Problem Report Form. Figure 3-2: Problem Report Form A form that lets you try again Do the following: 1. Press . (Alternatively, you can select the box. The Start Session Form reappears.) 3-6 Using the Workstation 2. Reenter your account name and password, this time correctly. STARTUP WORK AREA The start-up work area includes the following: _ Icon box with five icons _ _ Session window _ _ New Term window _ _ Messages window _ _ Terminal emulator (yterm) window _ When the account name and password are verified, your screen looks like Figure 3-3. You can set up your account so that a differently arranged work area appears when you log in--see Appendix E. Using the Workstation 3-7 Figure 3-3: Startup Work Area the default work area Introduction to Windowing System This section provides a brief overview of the windowing system and describes the components of a window. 3-8 Using the Workstation Windows You can think of the work area as a desk top with sheets of paper lying on it. You can move the sheets of paper around, just as you can with sheets of paper on your desk, and you can put sheets of paper above or under other sheets, just as you can stack sheets of paper on your desk. In HPWS, these sheets of paper are called . _______ windows A window represents an application program. For example, the large window on the left of the work area represents the terminal emulator application. This application produces a window that emulates the screen of a VT100-series terminal. The emulator application is called and is discussed in the _____ yterm following sections and in Appendix D. Windows are made up of a banner and a context area. The , found at the top of the window, ______ banner provides a way to change the window's size, shape, and location in the work area, as well as a way to close the window. Figure 3-4 shows a banner and its components. A banner has four components. From left to right, they are: _ Close button --causes the window to shrink to an _ icon (see the following subsection). _ Title bar --identifies the name of the application _ and can be used to move the window. _ Lower button --causes a window to move to the _ bottom of a stack of overlapping windows. _ Resize button --causes the window to change size. _ Using the Workstation 3-9 Figure 3-4: A Window Banner and Its Components Window banner and components The window's functions occur in the . _______ ____ context area For example, a terminal emulator window emulates a terminal, and thus interaction with the operating system takes place in a terminal emulator window's context area. Icons Icons are symbolic representations of windows. Icons are interactive; that is, by clicking on an icon, you can open (activate) or close the window with which it is associated. The HPWS window manager stores icons in a window called the ____ Icon . ___ box 3-10 Using the Workstation Buttons Buttons are interactive areas in a window that, when clicked on, perform an action. The entire context area of a window can be made up of a button (for example, the context area in a New Term window is a New Terminal button). Using Windows This section describes how to manipulate (close, move, resize, and stack) windows in the start-up work area using the window banner to control your work. Note that when you first enter the work area, the keyboard is not focused on a window. Obtaining Keyboard Focus Because you can have many windows in a work area, but only one keyboard, HPWS provides a mechanism to specify which window the keyboard is focused on. Simply clicking the left mouse button in a window (or in its Title bar) causes the keyboard to be associated with the window and for the Title bar to darken. In a similar manner, the Title bar becomes light again when the window loses keyboard focus. Closing Windows To close an open window, click on its Close button; the window shrinks into an icon. Try clicking on the Close button of the terminal emulator window. Clicking on a lightened icon in the Icon box causes its associated window to shrink into the icon. Clicking on a darkened icon opens its window. To reopen the terminal emulator window, click on the darkened yterm icon. Note that an application continues to run whether its window is open or closed. Using the Workstation 3-11 Moving Windows The Title bar can be used to move a window. Try the following: 1. Move the cursor to the Title bar of the terminal emulator window. 2. Click the left mouse button and keep it depressed. An outline of the window appears. 3. Move the mouse around. The outline moves accordingly. Moving an object this way is known as . ________ dragging 4. Drag the outline to where you want to terminal window to be. Release the button. The window is now in its new position. To cancel a moving operation during the drag, click another mouse button before releasing the left mouse button. The outline disappears, and the window is not moved. 5. Practice moving the Icon box. Make the Icon box and the terminal emulator window overlap. 6. Practice moving the New Term window. Produce an overlapping arrangement like the one in Figure 3-5. 3-12 Using the Workstation Figure 3-5: Overlapping Windows overlapping windows Resizing Windows The Resize button allows you to change the size of a window. Try the following: 1. Move the cursor to the Resize button of the terminal emulator window. 2. Click the left mouse button and keep it depressed. 3. Move the mouse around while keeping the button depressed. Notice the position of the cursor. You will see that the cursor is controlling a rectangular box that acts as if it were a rubber band. The box stretches and shrinks in accordance with the way you move the cursor. Using the Workstation 3-13 This rubber-band box is how you tell the system what size you want the window to be. When the box is the size you want, release the button. The window disappears, then instantly reappears in the new size. You can resize a window in one dimension (height or width) or in both dimensions simultaneously. To resize in one dimension, click on the Resize button and move the cursor across one border of the window. As long you cross only one border, the rubber-band box that follows your cursor will change in only one dimension. If after crossing one border you cross an adjacent border, then you will get a rubber-band box that can change in both dimensions. Try moving the cursor through one border and then through the border. The first border ________ opposite touched reverts to its original location, and the other one becomes a rubber-band line that follows the cursor. To cancel the resizing operation during the drag, click another mouse button before releasing the left mouse button. The outline disappears, and the window retains its original size. Stacking Windows When windows are arranged in a stack (overlapped), clicking on the Lower button of a window causes the window to be pushed to the bottom of the stack. Practice using the Lower button to produce different stacking orders. To bring a window to the top of a stack, simply click on the window itself. 3-14 Using the Workstation Using the Icon box The window on the upper right of the work area contains the Icon box. It holds icons for all windows. When a window is closed, its icon is darkened; when a window is open, its icon is lightened. You can use the Icon box banner the same as all other window banners, expect that you cannot close this window. Clicking on the leftmost banner symbol neatly organizes all icons in the box. Figure 3-6 shows how each icon relates to its window in the work area. Using the Workstation 3-15 Figure 3-6: Icon box Icon box, with icons and windows 3-16 Using the Workstation The Icon box is divided into squares, each of which can hold an icon. You can move an icon from one square to another square by clicking on an icon, dragging it with the mouse, and releasing the button when you have the icon where you want it. At start up, the Icon box contains the following icons: _ Console --produces a console window in the work _ area when opened. The console window is used for diagnostic tasks. _ New Term --produces a terminal emulator window. _ At start up, this icon is inactive and is associated with the New Term window. Clicking on this window's context area (New Terminal button) produces a terminal emulator window. ____ ____ ___ _______ _ ___ ________ _______ Each time you produce a new terminal window, ____ Note __ __ __________ __ ___ _____ ____ __ ___ ____ it is positioned in the upper left of the work _____ __ _______ ______ __ __ ___ ____ _________ area. If another window is in the same position, ___ ___ ______ ____ __ ______ __ ___ __ ___ the new window will be placed on top of the ________ _______ ___ ____ ___ ___ __ ___________ existing window, and thus may not be immediately ________ __ ____ __ ____ _____ ____ ___ _______ apparent to you. In this case, move the window. __ ____ __ ___ ___ ______ ___ ___ ________ As soon as you do, you'll see the existing ______ ________ _______ ___ ___ ____ window revealed beneath the new one. _ Session --ends the session. At start up, this icon _ is inactive and is associated with the Session window. Clicking on this window's context area (Click Here to End button) ends the session. (This process is described in the next section, Ending A Session.) _ --controls the System Messages window. _ Errors and other types of system messages are displayed in this window. If you click on the Acknowledge button in this window, both the window disappear. They ___ ___ ________ ____ and the Messages icon reappear automatically if a system message is generated; otherwise they do not reappear for the rest of the session. Using the Workstation 3-17 If you want to keep the option of seeing the Messages window, shrink (close) this window to its icon. Then, when you want to see it, just click on the icon. Alternatively, you can leave the window in your area; but remember not to click on the Acknowledge button. _ yterm --represents a terminal emulator window in _ your work area. Each terminal emulator window is identified with a yterm icon. If your work area is crowded with too many terminal windows, you can shrink some of them into icons--by clicking on their Close buttons, or by clicking on their icons. Try the following: 1. Practice moving icons around, leaving empty squares between icons. 2. Click on the Cleanup button of the Icon box. Immediately, the Icon box is repacked so that the icons fill the squares in a sequential manner, starting from the top left and going to the right, row by row. 3. Create several more terminal windows. (To create a terminal window, click on the context area in the New Term window. If the New Term window is not in the work area, click on the New Term icon to expand it.) 4. Focus the keyboard on one of the terminal logout lo windows and type or . The window disappears, as does the icon that represents it. 5. Log out of another terminal window in the same manner. The terminal and its icon both disappear. The Icon box now has holes where the icons once were. 6. Click on the Cleanup button to reorganize the Icon box. 3-18 Using the Workstation 7. Click on the Resize button in the Icon box window, and change the shape of the Icon box. To accommodate the icons, the Icon box changes size in discrete jumps. Using Terminal Emulator Windows As well as emulating a VT100-series terminal, the HPWS terminal emulator provides a way to transfer information between windows and change certain terminal characteristics. The following sections describe these features. Cutting and Pasting with the Mouse To transfer information between terminal emulator windows, HPWS provides a cut-and-paste facility. This feature is disabled in the startup work area; enabling and disabling the cut-and-paste feature is described in Appendix D. To perform a cut-and-paste operation, you must first select an area (region, word, or line) in a terminal window, move the cursor to the desired window and paste it into the window. Table 3-1 describes how to perform select opera- tions. Using the Workstation 3-19 ____________________________________________________ Table 3-1: Select Operations for Cut and Paste ____________________________________________________ Operation User Action Select region Drag with left button depressed. Select word Make two quick clicks on left button. Select line Make three quick clicks on left button. Extend previous Drag with right button selection depressed. Paste Click middle button. ____________________________________________________ The selected characters are highlighted by reversed screen color during mouse clicking or dragging operations. The selected text may be pasted to any terminal window visible on the screen. Changing Terminal Characteristics--the yterm Set-Up Menu You can change various characteristics of a terminal emulator window by using the _____ ______ yterm Set-Up . Do the following: ____ menu 1. Move the mouse cursor into a terminal window. 2. While holding down the key, click the left or middle mouse button. The Set-Up menu (Figure 3-7) appears. 3-20 Using the Workstation Figure 3-7: yterm Set-Up Menu Set-Up menu Using the Workstation 3-21 3. Practice clicking on the upper left box. Click repeatedly to alternate the display in that box between "80 Columns" and "132 Columns". 4. With the box displaying "132 Columns", click Save on the box. The window disappears for an instant, then reappears in 132-column width. By clicking on the Save box, you are implementing the choice you made by clicking on one of the other boxes. 5. Practice making choices in the other boxes. Implement your choice by clicking on the Save box. Exit 6. Remove the Set-Up menu by clicking on the box. For more information about the Set-Up menu, see Appendix D. ENDING A SESSION You can end a session at any time. Ending a session does the following: _ Stops all applications (processes) running in _ the session. _ Clears the work area from the screen. _ _ Returns the Start Session Form to the screen. _ To end your current session: 1. Move the cursor to the Session window. If the window is currently closed, open it. 2. Click on the Click Here to End button. The session ends. 3-22 Using the Workstation Appendix A System Configuration _______________________________________________________ This appendix describes how to run the diagnostic program named EVSBA to automatically determine the current system configuration. INTRODUCTION The autosizer program (diagnostic name EVSBA) is run to determine what devices are currently installed and operating in the system. It creates a configuration data base that is used by the VAX Diagnostic Supervisor (VDS) when running the EEPROM utility (Appendix B) and disk formatter (Appendix C). The autosizer runs in stand-alone mode under VDS. ___ _____________ ____ ____ ____ __ _______ The configuration data base must be created ____ Note __ _______ ___ _________ _____ ____ ___ __ by running the autosizer every time VDS is _____________ bootstrapped. System Configuration A-1 RUNNING THE AUTOSIZER To run the autosizer, you must first load VDS. Example A-1 shows how to bootstrap VDS and Example A-2 shows how to run the autosizer. Example A-1: Bootstrapping VDS $ ^P >>> B /R5:10 MU60 . . 2 3 4 5 6 7 . . . . . . . . 01000000 VAX DIAGNOSTIC SOFTWARE PROPERTY OF DIGITAL EQUIPMENT CORPORATION ***CONFIDENTIAL AND PROPRIETARY*** Use Authorized Only Pursuant to a Valid Right-to-Use License Copyright, Digital Equipment Corporation, 1987. All Rights Reserved. DIAGNOSTIC SUPERVISOR. ZZ-EBSAA-10.10-1122 14-JAN-88 14:51:34 DS> Example A-1 Description: Insert the diagnostic tape cartridge (labeled ) __________ ____ ___ _____ VAXSTATION 8000 HDW FILES into the tape drive. Make sure the cartridge is write-protected. See Chapter 2 for tape handling and drive operating procedures. $ ^P >>> Press to enter console mode. The console-mode prompt is returned. >>> B /R5:10 MU60 Enter the console-mode boot command to boot VDS, where: B -- is the console-mode boot command. A-2 System Configuration /R5: --specifies processor general purpose register 5. 10 -- is passed to R5 to specify VDS is to be bootstrapped. MU -- specifies a bootstrap from tape. 6 -- is the tape controller's (DEBNK) node number. 0 -- is the first (and only) tape drive (TK50). . . 2 3 4 5 6 7 . . . . . . . . System Configuration A-3 Self-test is run on the VAXBI nodes. This line of numerical characters shows the results of self-test for each nodes: _ The node is displayed if the node passed _____ Pass: _ self-test. _ A hyphen (-) precedes the number if the _____ Fail: _ node failed its self-test. _ A period (.) in place of a number ________ Missing: _ indicates the node is not installed. Normally, node 4 is the only node not installed. 01000000 This hexadecimal value is the upper address + 1 of installed VAXBI memory. VAX DIAGNOSTIC SOFTWARE PROPERTY OF DIGITAL EQUIPMENT CORPORATION ***CONFIDENTIAL AND PROPRIETARY*** Use Authorized Only Pursuant to a Valid Right-to-Use License Copyright, Digital Equipment Corporation, 1987. All Rights Reserved. DIAGNOSTIC SUPERVISOR. ZZ-EBSAA-10.10-1122 14-JAN-88 14:51:34 DS> This is the VDS banner, displayed when VDS is loaded. It is followed by the VDS prompt. _____________ ___ ____ ____ _____ ____ ____ _ Bootstrapping VDS from tape takes more than 5 ____ Note ________ ___ _____ _________ __ ___ ____ _____ minutes. The green indicator on the tape drive ______ ____________ __________ ____ ____ __ _____ blinks irregularly, indicating that tape is being _____ read. A-4 System Configuration Example A-2: Running the Autosizer DS> R EVSBA ..Program: EVSBA - AUTOSIZER level 3, revision 6.0, 3 tests, at 15:24:10.10 ..End of Run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:24:15.84 DS> Example A-2 Description: After VDS is loaded, VDS commands are entered to run the autosizer. DS> R EVSBA Enter the command to run the autosizer, where _ is the abbreviated VDS RUN command to load and start the specified diagnostic, . _____ EVSBA __ _____ _______ _______ __ ____ ___ _________ It takes several minutes to load the autosizer ____ Note ____ _____ ___ _____ _________ __ ___ ____ _____ from tape. The green indicator on the tape drive ______ ____________ __________ ____ ____ __ _____ blinks irregularly, indicating that tape is being _____ read. ..Program: EVSBA - AUTOSIZER level 3, revision 6.0, 3 tests, at 15:24:10.10 ..End of Run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:24:15.84 DS> The autosizer displays a start banner and completion summary message, followed by the VDS prompt. Note that the autosizer executed in less than 6 seconds. System Configuration A-5 Example A-3: Examining the Configuration Data Base DS> SH DEV ETA DEBNK HUB 6000C000 BI Node Number (HEX)=00000006(X) MUA6 TK50 _ETA 60580000 KA0 KA820 HUB 00000000 K-bytes of Main Memory = 16384, BI Node Number (HEX)=00000002(X) TCA0 SLU _KA0 00000000 Serial Line Externally Wrapped=No Baud Rate=9600 TCB0 SLU _KA0 00000000 Serial Line Externally Wrapped=No Baud Rate=9600 TCC0 SLU _KA0 00000000 Serial Line Externally Wrapped=No Baud Rate=9600 KA1 KA800 HUB 6000E000 Local Memory Size in MB=1. BI Node Number (HEX)=00000006(X) DUA KFBTA HUB 6000A000 BI Node Number (HEX)=00000005(X) DUA25 RD54 _DUA 60540000 DUA26 RD54 _DUA 60540000 ETA0 LANCE _ETA 60580000 DS> EXAMINING THE CONFIGURATION DATA BASE Example A-3 shows how to read the configuration information compiled by the autosizer. Example A-3 Description: DS> SH DEV Enter the (abbreviated) VDS SHOW DEVICE command. ETA DEBNK HUB 6000C000 BI Node Number (HEX)=00000006(X) . ETA0 LANCE _ETA 60580000 DS> The configuration data base is displayed as a table, followed by the VDS prompt. Each line of the table describes a path between the processor running VDS and other system devices. This path has to be defined to test devices, and without the autosizer data base, would require the user to enter the path using the VDS ATTACH command. A-6 System Configuration _____ __ ___ ______ _______ ___________ _______ Lines in the actual display wrap-around differ- ____ Note _____ ____ _____ __ _______ ____ ___ _______ __ ently than shown in Example A-3. The example is _________ ___ ____ ________ formatted for easy reading. For additional information on VDS commands, see ___ VAX . __________ __________ ______ ______ ___________ Diagnostic Supervisor User's Guide, EK-VXDSU-UG System Configuration A-7 Appendix B Changing System Parameters _______________________________________________________ Important system data is stored in the host processor's EEPROM (electrically-erasable, programmable, read-only memory). This appendix explains how to use the EEPROM utility (named EBUCA) to examine and change certain information stored in that EEPROM. The EEPROM utility runs in stand-alone mode under VDS. INTRODUCTION With the exception of certain system parameters, most of the information in EEPROM never, or rarely, needs to be changed. The information most likely to be changed is: _ configuration _____ ______ VAXBI nodes' _ _ Default boot device _ _ Default console baud rate _ To read and modify data stored in the host EEPROM, you should use the EEPROM utility. You enter commands to the EEPROM utility through a dialog; that is, the utility displays a series of questions, and you type the answer. Changing System Parameters B-1 EEPROM Utility Overview The EEPROM utility dialog has eight sections with a specific set of questions and answers for each section. The questions are always displayed in the same sequence. Some responses, such as circumflex (^) or right angle bracket ( ), change the > sequence or bypass the remaining questions. Each section allows you to read, and in some cases modify, particular data. Table B-1 lists the data accessed and actions provided by each section. ____________________________________________________ Table B-1: EEPROM Utility Summary ____________________________________________________ Section Action/Information STARTUP Read general help information. Select source of data to be loaded into utility buffer. GENERAL Display configuration table showing VAXBI devices installed and VAXBI node number. Display a summary of important EEPROM data. Read or modify: KA825 serial number VAXBI self-test timeout value F chip (floating-point chip) RCX50 self-test enable/disable[1] Cache memory enable/disable CONSOLE Read or modify: Default console baud rate Logical console VAXBI node number. ____________________________________________________ [1]An RX50 diskette controller contained on the KA825 module. Not used in the VAXstation 8000. B-2 Changing System Parameters ____________________________________________________ Table B-1 (Continued): EEPROM Utility Summary ____________________________________________________ Section Action/Information BOOT Display boot code summary. Change the default boot device. Verify that boot code contains no errors. Display boot code. Add or delete boot code. Change the DU boot device con- troller's interrupt and polling address. MICROCODE Read or modify processor and patch PATCH revision numbers. Verify that patches contain no errors. Load a new set of patches. List patches. Add or delete a single patch. HEXADECIMAL This section allows changes directly EXAMINE/DEPOSITto EEPROM, using console mode E and D commands. An intermediate buffer is not used, allowing potentially erroneous and possibly catastrophic modifications. This section is not described in this manual. ETHERNET This section affects the Ethernet port on the KA825 module. This port is not used in the VAXstation 8000 and this section is not described in this manual. Changing System Parameters B-3 ____________________________________________________ Table B-1 (Continued): EEPROM Utility Summary ____________________________________________________ Section Action/Information END OF PASS Make another pass of the dialog Save EEPROM data on tape. Write changes into EEPROM. Exit without making changes. ____________________________________________________ EEPROM Utility Guidelines The EEPROM contains important system data. The following guidelines will help you avoid making mistakes: 1. To help you decide what section you want to change and how to change it, review the examples in this appendix. 2. Use the procedures in this appendix to run the EEPROM utility. 3. Find the section of the utility dialog that applies to the data you want to read or modify. 4. Answer the dialog questions. 5. If you make changes, write the data to EEPROM, then verify system operation. __ ____________ _____ ____ ___ __________ In applications other than the VAXstation ____ Note _____ ______ _______ ___ ______ __ __ _______ 8000, EEPROM changes are backed up by writing __ ____ __________ __ ______ ____ __ _____ _____ to file EEPROM.IMA on device CSA0 or CSA1. These ___ ______ _____ ___ ___ ____ ________ _____ are device names for the dual diskette drive _________ __ ___ _____ __________ _______ ___ connected to the KA825 processor. Because the __________ ____ ____ ___ ___ _ ________ ______ VAXstation 8000 does not use a diskette drive, ___ ______ ____ __ ______ __ ___ __________ you cannot back up EEPROM on the VAXstation _____ ___ ________ _____ _____ ___________ __ 8000. The original image file, EEPROM.IMA, is ___ ____ ____ ___ ____ __ _ _____ ___________ the only back up. This is a write restriction _____ _______ ___ _____ _____ ____ ____ ____ only. Reading the saved image from CSA1 will _____ __________ __ __ ______ __ ___ _______ cause EEPROM.IMA to be loaded in the buffer. B-4 Changing System Parameters ___ _______ ____ __ ______ __ ___ __________ Any changes made to EEPROM on the VAXstation ____ ____ __ ________ ______ ___ ______ ______ 8000 will be retained unless the EEPROM buffer __ ______ ____ __________ ___ ___ ______ __ is loaded from EEPROM.IMA and the buffer is ____________ _______ __ _______ subsequently written to EEPROM. If you do not make any changes, abort the dialog session. 6. Exit the EEPROM utility. When you examine or modify EEPROM data, you do not directly access EEPROM. In the Startup section of the dialog, you load EEPROM data into a buffer. All subsequent operations affect the data in the buffer. The buffer is loaded from one of the following: _ Primary processor (KA825 host) EEPROM _ _ Attached processor EEPROM (not used in the _ VAXstation 8000) _ An initialization file _ _ A backup file _ After you have changed the data in the buffer, you answer questions in the End-Of-Pass section of the dialog to do one of the following: _ Write the buffered data to EEPROM. _ _ Exit from the utility if you decide not to make _ any changes. Changing System Parameters B-5 Example B-1: Running the EEPROM Utility DS> R EBUCA ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? USING THE EEPROM UTILITY To run the EEPROM utility, you must first load VDS and run the autosizer. Appendix A, Example A-1 shows how to bootstrap VDS and Example A-2 shows how to run the autosizer. Example B-1 shows the information typically displayed when the utility is started. The display is explained following the example. Example B-1 Description: This example assumes VDS has been bootstrapped and the autosizer diagnostic EVSBA has been run. When EVSBA finishes, it returns the VDS prompt. Set the pedestal control panel Update switch to off (dot-above-circle pressed). The utility will tell you when to set this switch to on. Follow the sequence in Example B-1. DS> R EBUCA In response to the VDS prompt, enter the VDS RUN command specifying the EEPROM utility filename EBUCA. Alternatively, the command: B-6 Changing System Parameters @EBUCA can be entered. This command runs EBUCA through a command file (EBUCA.COM) and does not require that the autosizer be run prior to EBUCA. ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? After the utility is loaded, the startup message is displayed, and you can start the EEPROM dialog. __ _____ _______ _______ __ ____ ___ _______ ____ It takes several minutes to load the utility from ____ Note _____ ___ _____ _________ __ ___ ____ _____ ______ tape. The green indicator on the tape drive blinks ____________ __________ ____ ____ __ _____ _____ irregularly, indicating that tape is being read. Changing System Parameters B-7 EEPROM Utility Commands The EEPROM utility commands are described in Table B-2. ____________________________________________________ Table B-2: EEPROM Utility Commands ____________________________________________________ Command Description ^ (circumflex) Displays the previous question. > (right angle bracket) Skips over remaining sections of the dialog to the End-Of-Pass section. h or H Displays a general help list. The current question is redisplayed. ? (question mark) Displays help specific to the current question. Help is not available for all questions. Aborts the current operation and the EEPROM utility and exits to the VAX diagnostic supervisor. If pressed while listing patches or boot code, the listing may continue for a short time, then the listing is stopped and the next question is displayed. Pressing a second exits the EEPROM utility as above. Aborts both the the EEPROM utility and the VAX diagnostic supervisor, and exits to console mode. Resumes data display stopped by CTRL/S. B-8 Changing System Parameters ____________________________________________________ Table B-2 (Continued): EEPROM Utility Commands ____________________________________________________ Command Description Redisplays the current line. Stops displaying data. Deletes all characters typed on the current line. The current question is redisplayed. ____________________________________________________ Getting Help You can display a general help list by typing H (or h) at any time during the dialog. To get help on a specific question, type ? in response to the question. Help is not available for all questions. Answering Questions The default response for all questions is displayed in braces. Most questions require a YES or NO response, and the default response is usually NO. In the following question for example, ___ Y/N indicates a YES or NO answer is required, and ___ {N} indicates that NO is the default response. Want a different default boot device Y/N {N} ? A few questions require a value or some other information. In the following two questions, the default node and unit number, , is changed by ____ {40} entering Y in response to the first question and 50 in response to the second question. Want to modify the default boot device node and unit number Y/N {N} ? Y Enter node and unit number of form nu: {40} : 50 A response is not entered until is pressed. Pressing only will enter the default response. Any other valid response is entered by pressing after the response. Changing System Parameters B-9 If you try to enter an invalid response to a question or prompt, an error message is displayed and the current question is redisplayed. Table B-2 lists other commands and control characters that can be typed in response to questions. Selecting a Section Each section of dialog, except the Startup and End-Of-Pass sections, is selected by answering by answering the question EE> Are you interested in the nnnnn section Y/N {N} ? Where EE> This is the EEPROM utility prompt. It is displayed for all sections except the Startup section and the End-Of-Pass section. Questions within the selected section are not preceded by the prompt. nnnnn This represents the name of the section; for example: EE> Are you interested in the general section Y/N {N} ? EE> Are you interested in the console section Y/N {N} ? EE> Are you interested in the boot code section Y/N {N} ? {N} The default answer is displayed inside the braces. In this example, N or NO, is the default answer. B-10 Changing System Parameters Instead of answering the section question, you can list the section's parameters by typing ? at the start of a section. Example B-2 shows the display when ? is entered in response to the General section question. Example B-2: EEPROM General Section Help Display EE> Are you interested in the general section Y/N {N} ? ? This section provides routines to Display VAXBI configuration Display summary of EEPROM data Perform EEPROM Sanity check Examine/modify the following: CPU serial number VAXBI self-test timeout F Chip enable RCX50 self-test enable Cache enable READING AND CHANGING EEPROM Sections Startup Section--Loading the EEPROM Utility Buffer through End-Of-Pass Section--Exiting the EEPROM Utility provide examples of the most common EEPROM operations. Startup Section--Loading the EEPROM Utility Buffer The four questions of the startup section dialog are: Source for loading EEPROM work buffer is the primary processor. Want to change this Y/N {N} ? Want to load the initialization file KAINITX.SYS Y/N {N} ? Want to load buffer from EEPROM saved image on CSA1 Y/N {N} ? Want to load buffer from EEPROM on attached processor Y/N {N} ? You load the buffer in the Startup section of the dialog. The Startup section dialog asks you what EEPROM information you want to load into the buffer. It is the buffer data that you will read or Changing System Parameters B-11 modify. You are asked to load data from one of four sources. 1. To load the buffer from the primary processor EEPROM, answer YES to the first question: Source for loading EEPROM work buffer is the primary processor. Want to change this Y/N {N} ? In the VAXstation 8000, this is the host processor EEPROM. Usually, you will load this data into the buffer. 2. To load the buffer from the initialization file, KAINITx.SYS, answer YES to the second question: Want to load the initialization file KAINITX.SYS Y/N {N} ? There are different versions of the initial- ization file for processors having either one (KAINIT1.SYS) or two (KAINIT2.SYS) EEPROMs. The utility automatically selects the correct version. Both the initialization file and the backup file (saved image file, EEPROM.IMA) re- quire approximately 5 seconds to load. You load this file from tape to rebuild EEPROM data only when you have not previously saved the EEPROM data, and you believe that much of the EEPROM data is in error. The initialization file contains data that is basic to all systems; it does not contain parameters specific to your system or previous changes you have made to EEPROM. After loading the initialization file, you may have to update some of the data in the buffer. 3. To load the buffer from the backup file, EEPROM.IMA, answer YES to the third question: Want to load buffer from EEPROM saved image on CSA1 Y/N {N} ? B-12 Changing System Parameters You should load data from this tape file if you discover an error in EEPROM data. The backup file contains contains initialization file data. _______ ______ ______ ____ __________ ___ Loading EEPROM buffer from EEPROM.IMA and _______ Caution ____________ _______ __ ______ ____ ___ ______ subsequently writing to EEPROM from the buffer ____ _________ ___ _______ ____ __ _______ will overwrite any changes made to EEPROM. __ ____________ _____ ____ ___ __________ _____ In applications other than the VAXstation 8000, ______ _______ ___ ______ __ __ _______ __ EEPROM changes are backed up by writing to ____ __________ __ ______ ____ __ _____ _____ file EEPROM.IMA on device CSA0 or CSA1. These ___ ______ _____ ___ ___ ____ ________ _____ are device names for the dual diskette drive _________ __ ___ _____ __________ _______ ___ connected to the KA825 processor. Because the __________ ____ ____ ___ ___ _ ________ ______ VAXstation 8000 does not use a diskette drive, ___ ______ ____ __ ______ __ ___ __________ you cannot back up EEPROM on the VAXstation _____ ___ ________ _____ _____ ___________ __ 8000. The original image file, EEPROM.IMA, is ___ ____ ____ ___ ____ __ _ _____ ___________ the only back up. This is a write restriction _____ _______ ___ _____ _____ ____ ____ ____ only. Reading the saved image from CSA1 will _____ __________ __ __ ______ __ ___ _______ cause EEPROM.IMA to be loaded in the buffer. 4. Attached processor EEPROM. Want to load buffer from EEPROM on attached processor Y/N {N} ? A YES response to the last question in the Startup section dialog should display an error message, because the VAXstation 8000 does not have an attached processor. Loading data into the buffer from either the backup or initialization file does not erase the file. Changing System Parameters B-13 Startup Section--Restoring EEPROM Data If you find an error in EEPROM data, you can re- store correct data from a backup file. Example B-3 shows the dialog for restoring EEPROM data. Example B-3: EEPROM Restoring Data Display ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? Source for loading EEPROM work buffer is the primary processor Want to change this Y/N {N} ? Y Want to load initialization file KAINITX.SYS Y/N {N} ? Want to load buffer from EEPROM saved image on CSA1 Y/N {N} ? Y EE> Are you interested in the general section Y/N {N} ? > * END OF PASS * Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Want to write changes back to the same EEPROM Y/N {N} Y Put control panel switch to update position Are you ready to continue Y/N {N} ? Y Update could take several minutes-DO NOT ABORT DURING UPDATE ** Operation was SUCCESSFUL ** Want to exit the utility Y/N {N} ? Y ..End of run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:03:17.95 B-14 Changing System Parameters General Section--Configuration and Summary The VAXBI configuration matrix shows the VAXBI node numbers and the devices assigned to the numbers. The EEPROM summary lists important EEPROM parameters. Example B-4 shows both the configuration and summary, and how to exit the utility without making changes. Example B-4: EEPROM Configuration and Summary Display ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? Source for loading EEPROM work buffer is the primary processor Want to change this Y/N {N} ? EE> Are you interested in the general section Y/N {N} ? Y Want to display VAXBI configuration matrix Y/N {N} ? Y --------------------------------------------------------- NODE REVISION CODE DEVICE CODE & TYPE --------------------------------------------------------- 02 882F 0105 KA825 CPU 03 0003 0001 MS820 MEMORY 04 0003 0001 MS820 MEMORY 05 004B 410D KFBTA 06 0243 410E DEBNK 07 0002 410C KA800 CPU Want to display a summary of EEPROM contents (From Work Buffer) Y/N {N} ? Y --------------------------------------------------------- EEPROM Summary --------------------------------------------------------- KA825 serial number is NI5520009 CPU REV: 01 PATCH REV: 1 Console default BAUD rate is 1200 VAXBI self-test timeout in seconds is 10 The VAXBI node number of the logical console is 02 Example B-4 Continued on next page Changing System Parameters B-15 Example B-4 (Continued): EEPROM Configuration and Summary Display F CHIP is enabled RCX50 self-test is disabled CACHE is enabled The default boot device is DU50 Boot Command Parser - Version 200 Boot Device Type DU - Version 201 Boot Device Type MU - Version 102 Boot Device Type ET - Version 104 EEPROM sanity check is good --------------------------------------------------------- KA825 serial number is NI5520009 Want to change this Y/N {N} ? > * END OF PASS * Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Y ..End of run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:03:17.95 Example B-4 Description: --------------------------------------------------------- NODE REVISION CODE DEVICE CODE & TYPE --------------------------------------------------------- These are all specific to the device listed in the configuration matrix. is the VAXBI node number. ____ NODE is the device's revision level. ________ ____ REVISION CODE is a hexadecimal VAXBI device code. ______ ____ DEVICE CODE Boot Command Parser - Version 200 Boot Device Type DU - Version 201 Boot Device Type MU - Version 102 Boot Device Type ET - Version 104 In the EEPROM summary, these version numbers are the version numbers of the microcode for that B-16 Changing System Parameters type of device. EEPROM sanity check is good --------------------------------------------------------- KA825 serial number is NI5520009 Want to change this Y/N {N} ? > In the EEPROM summary, this is the result of a a test that verifies the contents of specific EEPROM locations. If the values are not correct, the utility asks if you want to change them. If the response is YES, the utility automatically corrects the values. The response shown, > (right angle bracket), causes the utility to skip to the End-Of-Pass section. Console Section--Default Console Baud Rate Example B-5 shows how the default console baud rate is changed from 1200 to 9600. Note how the ^ (circumflex) command is used to repeat the previous question and review the change. Changing System Parameters B-17 Example B-5: EEPROM Changing Console Default Baud Rate Display ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? Source for loading EEPROM work buffer is the primary processor Want to change this Y/N {N} ? EE> Are you interested in the general section Y/N {N} ? EE> Are you interested in the console section Y/N {N} ? Y Console default BAUD rate is 1200 Want to change this Y/N {N} ? Y BAUD rate: 150 Want this Y/N {N} ? BAUD rate: 300 Want this Y/N {N} ? BAUD rate: 600 Want this Y/N {N} ? BAUD rate: 1200 Want this Y/N {N} ? BAUD rate: 2400 Want this Y/N {N} ? BAUD rate: 4800 Want this Y/N {N} ? BAUD rate: 9600 Want this Y/N {N} ? Y The VAXBI node number of the logical console is 02 Want to change this Y/N {N} ? ^ Console default BAUD rate is 2400 Want to change this Y/N {N} ? The VAXBI node number of the logical console is 02 Want to change this Y/N {N} ? > Example B-5 Continued on next page B-18 Changing System Parameters Example B-5 (Continued): EEPROM Changing Console Default Baud Rate Display * END OF PASS * Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Want to write changes back to the same EEPROM Y/N {N} Y Put control panel switch to update position Are you ready to continue Y/N {N} ? Y Update could take several minutes-DO NOT ABORT DURING UPDATE ** Operation was SUCCESSFUL ** Want to exit the utility Y/N {N} ? Y ..End of run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:03:17.95 Boot Section--Default Boot Device Example B-6 shows how the default boot device is changed. The lists the revision level ____ _______ BOOT SUMMARY and location for the boot command parser and the boot code for each boot device type. The boot command parser uses the boot command you enter to find the specific or default boot device. In Example B-6, only the node-ID of the default boot device controller is changed. You can change the entire device specification. Boot devices are specified in the form , where ____ ddnu = device type __ dd = VAXBI node number _ = controller unit number _ u For example, is a disk on node 5, unit number ____ DU50 0. See for more __________ ____ ______ ______ VAXstation 8000 System Manual information on specifying the boot device. Changing System Parameters B-19 Example B-6: EEPROM Changing Default Boot Device Display ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? Source for loading EEPROM work buffer is the primary processor Want to change this Y/N {N} ? EE> Are you interested in the general section Y/N {N} ? EE> Are you interested in the console section Y/N {N} ? EE> Are you interested in the boot code section Y/N {N} ? Y Want to display the boot summary Y/N {N} ? Y -------------------------------------------------------- BOOT SUMMARY -------------------------------------------------------- The default boot device is DU40 Boot command parser - Version 200 Start Add 20090104 Last Add 20090169 Boot Device Type DU - Version 201 Start Add 00002058 Last Add 0000252E Boot Device Type MU - Version 102 Start Add 0000252F Last Add 00002905 Boot Device Type ET - Version 104 Start Add 00002906 Last Add 00002A5A -------------------------------------------------------- The default boot device is DU40 Want a different default boot device Y/N {N} ? The default boot device is DU40 Want to modify the default boot device node and unit number Y/N {N} ? Y Enter node and unit number of form nu: {40} : 50 Want to verify boot code against files on disk Y/N {N} ? ^ The default boot device is DU50 Want to modify the default boot device node and unit number Y/N {N} ? > Example B-6 Continued on next page B-20 Changing System Parameters Example B-6 (Continued): EEPROM Changing Default Boot Device Display * END OF PASS * Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Want to write changes back to the same EEPROM Y/N {N} Y Put control panel switch to update position Are you ready to continue Y/N {N} ? Y Update could take several minutes-DO NOT ABORT DURING UPDATE ** Operation was SUCCESSFUL ** Want to exit the utility Y/N {N} ? Y ..End of run, 0 errors detected, pass count is 1, time is 15-JAN-1988 15:03:17.95 Microcode Patch Section--Microcode Patches KA825 Processor microcode is contained in control- store memory, which consists of DRAM (dynamic random-access memory) and ROM (read-only memory). A microcode patch is stored in DRAM, and replaces a section of microcode contained in ROM. Normally, the processor executes the ROM microcode, checking each section of code to see if there is a patch for that section. If a patch exists, the processor executes the microcode patch from DRAM instead of executing the microcode from ROM. Digital issues patches on an updated utility tape, and you must load the patches into EEPROM. The patches are loaded from EEPROM to control-store DRAM when system power is turned on, the pedestal control panel key-switch is turned to Restart, or the console mode T command is executed. Patches are stored on the utility tape in file KApppp.PAT, where is the patch revision ____ pppp number. Use the EEPROM utility to load the patches from this file to the EEPROM. The patches remain unchanged in EEPROM until new patches are loaded. Changing System Parameters B-21 Example B-7 shows an EEPROM utility session for loading microcode patches. The sequence is explained following the example. Example B-7: EEPROM Loading Microcode Patches Display DS> DIR DUBOOKA.SYS;5 EBSAA.EXE;325 EBUCA.COM;5 EBUCA.EXE;1 EBUCA.HLP;7 EEPROM.IMA;1 KA0023.PAT;1 KABOO2.SYS;3 KAINIT1.SYS;5 KAINIT2.SYS;1 DS> R EBUCA ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? Source for loading EEPROM work buffer is the primary processor Want to change this Y/N {N} ? EE> Are you interested in the general section Y/N {N} ? EE> Are you interested in the console section Y/N {N} ? EE> Are you interested in the boot code section Y/N {N} ? EE> Are you interested in the microcode patch section Y/N {N} ? Y Want to examine/modify CPU and Patch revision information Y/N {N} ? Want to compare patches in buffer against patch file on disk Y/N {N} ? Want to load a new set of microcode patches Y/N {N} ? Y Enter file specification: KA0002.PAT Want to list patches Y/N {N} ? > * END OF PASS * Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Want to write changes back to the same EEPROM Y/N {N} Y Put control panel switch to update position Are you ready to continue Y/N {N} ? Y Update could take several minutes-DO NOT ABORT DURING UPDATE ** Operation was SUCCESSFUL ** Want to exit the utility Y/N {N} ? Y Example B-7 Continued on next page B-22 Changing System Parameters Example B-7 (Continued): EEPROM Loading Microcode Patches Display ..End of run, 0 errors detected, pass count is 1, time is 14-JAN-1988 15:03:17.95 Example B-7 Description: DS> DIR In response to the VDS prompt, enter the directory command to list the tape files. Record the file name KApppp.PAT that has the highest number for . This file contains the most ____ pppp recent patches. DS> R EBUCA In response to the VDS prompt, enter the VDS RUN command specifying the EEPROM utility filename EBUCA. ..Program: EBUCA - VAX 8200/8300 EEPROM UTILITY and VAXBI CONFIGURATOR, revision 2.4, 1 test, at 14:59:14:46. Testing: _KA0 ** EBUCA STARTUP ** Do you want help Y/N {N} ? After the utility is loaded, the startup message is displayed, and you can start the EEPROM dialog. __ _____ _______ _______ __ ____ ___ _______ ____ It takes several minutes to load the utility from ____ Note _____ ___ _____ _________ __ ___ ____ _____ ______ tape. The green indicator on the tape drive blinks ____________ __________ ____ ____ __ _____ _____ irregularly, indicating that tape is being read. The patch file, KApppp.PAT, contains a list of processor revision numbers that are compatible with the patches. As the patches are loaded, the utility uses the processor revision number to verify that the patches are compatible with the processor. If the patches are not compatible, they are not loaded, and an error message is displayed. Changing System Parameters B-23 End-Of-Pass Section--Exiting the EEPROM Utility To exit the EEPROM utility, type (right angle > bracket) at any point in the dialog. This brings you to the End-Of-Pass section of the dialog. The five questions of the End-Of-Pass section dialog are: Want to make another pass Y/N {N} ? Want to abort this session Y/N {N} ? Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Want to write changes back to the same EEPROM Y/N {N} ? Want to select destination node for outputting changes Y/N {N} ? 1. If you have made changes, you should review the changes by making another pass of the dialog. That is, answer YES to the first question: Want to make another pass Y/N {N} ? 2. To exit the utility without making changes, answer YES to the second question: Want to abort this session Y/N {N} ? 3. You cannot write changes to backup file EEPROM.IMA in the VAXstation 8000. Want to write buffer to image file EEPROM.IMA on CSA1 Y/N {N} ? Answer NO to the third question. 4. To write changes to the primary processor EEPROM (the KA825 in the VAXstation 8000) answer YES to the fourth question: Want to write changes back to the same EEPROM Y/N {N} ? 5. Attached processor EEPROM. Want to select destination node for outputting changes Y/N {N} ? B-24 Changing System Parameters In the VAXstation 8000, a YES response to the last question should display an error message, because the only VAXBI node with EEPROM in the VAXstation 8000 is the KA825 host, or primary, processor. ___ _________ ______ __ ___ ________ _________ The Structure Memory in the graphics subsystem ____ Note ____ _______ ________ ____ ______ __ ___ _ _____ uses EEPROM, however, this module is not a VAXBI ____ ___ ___ ______ __ ___ _______ ____ ___ ______ node and its EEPROM is not updated with the EEPROM ________ ______ Utility, EBUCA. CHECKSUMS Boot code, the set of microcode patches, and the processor control-store memory each have a unique checksum, that is stored in EEPROM. When you turn the system on, the processor recalculates these checksums and compares the results to the values stored in EEPROM. If there is a mismatch in any comparison, self-test fails. The EEPROM utility also recalculates the three checksums, and compares the results to the stored values. Boot code and patch checksums are recalculated from data in the utility buffer; control-store checksums are recalculated from the processor control-store memory. If an error occurs, the utility asks if you want to store the value in the utility buffer as the new checksum. You should not change the stored checksum value unless you know what caused the error. In most cases, if the checksum comparison fails, you should load new EEPROM data. Changing System Parameters B-25 Appendix C Disk Formatting _______________________________________________________ This appendix describes how to run the EVRND program to format a nonremovable disk. INTRODUCTION The formatter program (diagnostic name EVRND) is run to format or reformat nonremovable disks. The formatter runs in stand-alone mode under VDS. The formatter consists of the following three tests: 1. Disk format 2. Verify and bad-block update 3. Verify only The formatter has five modes, or sections, for running different combinations of the three tests: _ Default (executes tests 1 and 2) _ _ Format (executes test 1) _ _ Verify and update (executes test 2) _ _ Verify without update (executes test 3) _ Disk Formatting C-1 _ All (executes tests 1, 2, and 3) _ TEST DESCRIPTION When executed for the first time, the diagnostic uses approximately 5 seconds for initialization and approximately 10 seconds for cleanup upon completion. The following subsections describe the three formatter diagnostic tests. Test 1: Disk Formatter All selected units are formatted. Bad block information is written to cylinder 0. Cylinder 0 consists of bad spots listed on the manufacturer's bad block cylinder, as well as bad spots found during format time that are not listed in the bad block cylinder. Such unlisted bad spots are reported in bad block reports. Bad block reports can be disabled by setting event flag 1 (Example C-3). The size of the bad block table is drive-specific. If the bad block table written to cylinder 0 becomes full before formatting is complete, the drive is failed. Test 1 either formats or reformats disks, as determined by event flag 3. Format To format a disk, event flag 3 should be clear. The manufacturer's bad block information (on the last cylinder) is used to create the bad block table. The bad block table is written to cylinder 0 as the replacement cache table (RCT) when the format operation is complete. C-2 Disk Formatting Reformat To reformat a disk, event flag 3 should be set. The test uses the RCT on cylinder 0 to creates its bad block table, adding any bad spots detected as a result of reformatting. If event flag 3 is set and the drive had not been previously formatted by this formatter, the test will not find a RCT on cylinder 0 and will report a fatal error. This test is data-destructive. Its approximate run time is 4 minutes for an RD52, 7 minutes for an RD53, and 12 minutes for an RD54. Test 2: Verify/Bad-Block Update All selected units will be tested. If the selected units have not been previously formatted by test 1, this test will fail. Any bad spot detected during verification is checked against the bad spots listed in the bad block table on cylinder 0; that is, against the known bad spots. Any bad spots not listed in the bad block table are reported in bad block reports and the bad block table is updated. Bad block reports can be disabled by setting event flag 1 (Example C-3). This test is data-destructive. Its approximate run time is 3 minutes for an RD52, 5 minutes for an RD53, and 8 minutes for an RD54. Test 3: Verify Only This test is identical to test 2, with the exception that the bad block table is not updated. Any detected bad spots are reported as in test 2. Bad block reports can be disabled by setting event flag 1 (Example C-3). This test is not data- destructive. Its approximate run time is 3 minutes for an RD52, 5 minutes for an RD53, and 8 minutes for an RD54. Disk Formatting C-3 RUNNING THE FORMATTER To run the formatter, you must first load VDS and run the autosizer. Appendix A, Example A-1 shows how to bootstrap VDS and Example A-2 shows how to run the autosizer. Example C-1 shows how select a drive for formatting and how to load and start the formatter. Example C-1: Selecting and Formatting a Drive 0 DS> SELECT DUA,DUA25 DS> LOAD EVRND DS> START/SECTION=ALL .. PROGRAM: ZZ-EVRND KFBTA LEVEL-3 DISK FORMATTER, revision 1.3, 3 tests, at 09:54:46 .. END OF RUN. 0 ERRORS DETECTED. PASS COUNT: 1. TIME: 10:23:05 DS> Example C-1 Description: This example assumes VDS has been bootstrapped and the autosizer diagnostic EVSBA has been run. When EVSBA finishes, it returns the VDS prompt. DS> SELECT DUA,DUA25 DS> In response to VDS prompt, enter the SELECT command and specify DUA (disk controller) and DUA25 (drive 0) for testing. The VDS prompt is returned. DS> LOAD EVRND DS> In response to VDS prompt, enter a LOAD command, specifying the name of the formatter diagnostic, EVRND. When the diagnostic is loaded, the VDS prompt is returned. C-4 Disk Formatting __ _____ _______ _______ __ ____ ___ _________ It takes several minutes to load the formatter ____ Note ____ _____ ___ _____ _________ __ ___ ____ _____ from tape. The green indicator on the tape drive ______ ____________ __________ ____ ____ __ _____ blinks irregularly, indicating that tape is being _____ read. At this point, event flags (if any) are set (Example C-3). DS> START/SECTION=ALL Enter the START command to begin formatting. In this example, the /SECTION qualifier specifies that all three tests in the formatter diagnostic are to be executed. The /SECTION qualifier arguments, syntax, and results are as follows: /SECTION=DEFAULT -- executes tests 1 and 2 /SECTION=FORMAT -- executes test 1 /SECTION=VERIFY_UPDATE -- executes test 2 /SECTION=VERIFY_NO_UPDATE -- executes test 3 /SECTION=ALL -- executes tests 1, 2, and 3 __ ___ _____ _______ __ _______ _______ ___ If the START command is entered without any ____ Note ___________ ___ _______ _______ ______ _ ___ __ qualifiers, the default section (tests 1 and 2) __ _________ is executed. .. PROGRAM: ZZ-EVRND KFBTA LEVEL-3 DISK FORMATTER, revision 1.3, 3 tests, at 09:54:46 .. END OF RUN. 0 ERRORS DETECTED. PASS COUNT: 1. TIME: 10:23:05 DS> The diagnostic prints a banner when it starts. The banner identifies the diagnostic and the time is began executing. When the diagnostic is completed, a summary is printed. The summary reports the results of the tests and the time execution stopped. The diagnostic then returns the VDS prompt. Disk Formatting C-5 The RUN command can be used in place of the LOAD and START commands. Example C-2 shows the RUN command to perform the same tests as Example C-1. _____ _____ ______ __ ___ ____ ___ ___ _______ __ Event flags cannot be set when the RUN command is ____ Note _____ used. Example C-2: Formatting with the RUN Command DS> RUN/SECTION=ALL EVRND Flags The formatter diagnostic allows you to set up to three event flags, to control reporting and execution. Event flags should be set after the diagnostic is loaded (Example C-3) because the LOAD and RUN commands clear all event flags. _ Event flag 1 controls bad block reporting. If _ event flag 1 is set, bad blocks found during the format or verify operation will not be reported. Event flag 1 affects all three formatter tests. _ Event flag 2 controls soft error reporting. _ If event flag 2 is set, soft errors will not be reported. Event flag 2 affects all three formatter tests. _ Event flag 3 controls formatter execution, and _ affects only test 1. If event flag 3 is clear, the formatter test uses the manufacturer's bad block information (on the last cylinder) to build the replacement cache table on cylinder 0. In other words, the flag is clear to format a disk that had not been previously formatted with this formatter. C-6 Disk Formatting If event flag 3 is set, the formatter test uses the replacement cache table on cylinder 0 to update bad blocks. In other words, the flag is set reformat a disk that had been previously formatted with this formatter. If the flag is set and the disk had not been previously formatted, an error will be reported. Example C-3: Setting Event Flags DS> SELECT DUA,DUA25 DS> LOAD EVRND DS> SET EVENT FLAGS 1,2 DS> START/SECTION=ALL .. PROGRAM: ZZ-EVRND KFBTA LEVEL-3 DISK FORMATTER, revision 1.3, 3 tests, at 09:54:46 .. END OF RUN. 0 ERRORS DETECTED. PASS COUNT: 1. TIME: 10:23:05 A summary report is given after each device is tested. This report is cryptic, consisting of hard and soft error counts, as well as retry, read, write, and seek counts. The summary report can be disabled by setting the IES flag. Summary information can be displayed with the VDS SUMMARY command whether the IES flag is set or clear. For additional information on VDS commands, see ___ VAX . __________ __________ ______ ______ ___________ Diagnostic Supervisor User's Guide, EK-VXDSU-UG Disk Formatting C-7 Appendix D The Terminal Emulator _______________________________________________________ The VAXstation 8000 High-Performance Workstation Software (HPWS) provides a terminal emulator window application (called ). It lets you _____ yterm create windows in your work area that emulate VT102 terminals. The emulator has the following features: _ VT102 compatibility _ _ Flexibility of size and location _ _ Multiple fonts _ _ Cut-and-paste facility with mouse control _ TERMINAL CHARACTERISTICS The emulator uses an LK201 keyboard and supports compose character key sequences. Keypad mappings may be different for applications that recognize differences between LK201 and VT100 keyboards, and such applications may utilize these differences. The terminal emulator does not support the following VT200-series terminal features: _ Dynamically redefinable character sets _ The Terminal Emulator D-1 _ National replacement character sets _ The shift lock key operates as a shift lock, not as a caps lock. Shifted versions of "," and "." produce the same results as if "<" and ">", respectively, were typed. VT100 keyboard users may find this trait useful. Resizing Resizing a terminal window changes the size of the window. Resizing is accomplished by clicking the left mouse button on the Resize button in the window banner, and with the mouse button pressed moving the mouse. A window is resized in increments of the width and height of one character. The window manager notifies the operating system of a size change when a window is resized. Conforming applications, such as TPU, can be used with a window of arbitrary size. Note that certain applications or utilities (for example, EDT) may not be able to use arbitrarily sized windows. Also, some applications may not support resizing a window in the middle of an application or session, and some applications may not inform the operating system of size changes. In addition, certain applications, upon discovering that a terminal window is larger than 80 characters wide, cause it to be resized to 132 characters. A user can find the dimensions of a resized window by typing the following DCL command: $ SHOW TERMINAL D-2 The Terminal Emulator CHANGING TERMINAL CHARACTERISTICS Once a user has successfully completed the Start Session Form, the HPWS window manager starts a terminal emulator window, with default settings. Clicking on the New Terminal button in the New Term window starts a new terminal window. Users can modify characteristics of a terminal emulator window by: _ Issuing DCL commands _ _ Creating a file (.XDEFAULTS) in the user's _ SYS$LOGIN directory that overrides the appli- cation defaults _ Accessing the yterm Set-Up menu and changing _ characteristics within a window Issuing DCL Commands To start a terminal emulator window from a DCL command line (rather than from a New Terminal button), define two symbols: one to specify a symbol for the executable code and one to specify a symbol to spawn the process. (See also Appendix E. For example: $ YTERM_EXE:==$HPWS$EXE:HPWS$YTERM $ YTERM:=="SPAWN/NOWAIT YTERM_EXE" This technique is necessary before running the emulator from either a DCL command line or a command file (such as STARTSESSION.COM described in Appendix E. Once yterm symbols have been defined, a window can be started by typing the following: $ YTERM You can specify a wide variety of terminal characteristics on the command line; for example: $ YTERM -FN VTSINGLE The Terminal Emulator D-3 In this case, specifies the font used ___ ________ -FN VTSINGLE in the window. Table D-1 lists the command line specifications with defaults and describes their functions. ____________________________________________________ Table D-1: Command Line Options Command Line ____________________________________________________ Specifier Description +autorepeat turns on keyboard autorepeat-- _______ default -autorepeat turns off keyboard autorepeat +autowrap turns on screen autowrap-- _______ default -autowrap turns off screen autowrap +keyclick turns on keyclick -keyclick turns off keyclick-- _______ default -fn (font_name) specifies named font used in window-- _______ __ _____ default is fixed -fb (font_name) specifies bold named font in window +fk specifies kilter fonts used in window -fk specifies not to use kilter fonts in window-- _______ default +cap turns on arrow key application mode D-4 The Terminal Emulator ____________________________________________________ Table D-1 (Continued): Command Line Options Command Line ____________________________________________________ Specifier Description -cap turns off arrow key application mode-- _______ default +kap turns on keypad key application mode -kap turns off keypad key applica- tion mode-- _______ default -is (number) changes icon symbol in Icon box--numbers: 0 to 4, _______ __ default is _ 0 -in (icon_name)[1] changes text in Icon box under icon symbol-- _______ __ _______ default is "yterm" -n (window_ changes text in window banner-- name)[1] _______ __ _______ default is "yterm" +i brings window up as an icon -i brings window up as a terminal window-- _______ default -b (number) changes number of pixels from window border to where text is written-- _______ __ _ default is 2 +rv turns on reverse video in window ____________________________________________________ [1]Text string must be in quotes if you use more than one word. The Terminal Emulator D-5 ____________________________________________________ Table D-1 (Continued): Command Line Options Command Line ____________________________________________________ Specifier Description -rv turns off reverse video in window-- _______ default +se enables cut and paste via mouse -se disables cut and paste via mouse-- _______ default ____________________________________________________ Specifying Display Output In addition to specifying terminal characteristics on a command line, you can specify what VAXstation a terminal emulator window appears within DECnet. For example, in some development environments, you might find it useful to direct screen output to another VAXstation 8000 node. In this instance, you must first define the logical name DISPLAY, as follows: $ DEFINE DISPLAY WIGGLE::0 Where is the name of the DECnet VAXstation ______ WIGGLE node, and is the screen number on that VAXstation. _ For the VAXstation 8000, the value is always 0. You can then specify the display output on the command line by typing the following: $ YTERM WIGGLE::0 In this case, the terminal emulator window will appear on the VAXstation 8000 screen with the node name WIGGLE. D-6 The Terminal Emulator Changing Emulator Window Size, Shape, and Placement In addition to the command line options described in Table D-1, the size, shape, and placement (offset) of a window can be specified on the command line by typing, for example, the following: $ YTERM "=80x50+40+50" The Terminal Emulator D-7 Where determines the window's width, ______________ "=80x50+40+50" height, and placement, using the following syntax: "=x{+-}{+-}" Note that these specifications must be enclosed in double quotes. Table D-2 lists and describes each element. ____________________________________________________ Table D-2: Size and Placement Command Line Options ____________________________________________________ Element Description width width of yterm in characters (not pixels) height height of yterm in characters (not pixels) {+-}x +x offset in x from top of screen in pixels -x offset in x from bottom of screen in pixels {+-}y +y offset in y from left of screen in pixels -y offset in y from right of screen in pixels ____________________________________________________ Changing Fonts HPWS provides a wide variety of fonts in the HPWS$FONTS directory. Fonts can be changed using a command line option. Not all fonts in the HPWS$FONTS directory work effectively in terminal emulator windows; supported fonts are listed in Table D-3. D-8 The Terminal Emulator Fonts can be specified using the -FN or -FB options. For double-height and double-width characters, use the +FK option. The eight kilter fonts listed in Table D-3 are loaded with the +FK option. ____________________________________________________ Table D-3: Fonts Roman Font Bold Font ____________________________________________________ File Name File Name Size in Pixels FIXED.SNF Not 6 x 13 Available VTSINGLE.SNF VTBOLD.SNF 8 x 13 KILTER.SNF KILTERB.SNF 16 x 15 KILTERD.SNF KILTERDB.SNF 16 x 15 K28BOT.SNF K28BOTB.SNF 16 x 15 K28TOP.SNF K28TOPB.SNF 16 x 15 ____________________________________________________ Examples of how to specify fonts follow: _ To specify the fixed font option, enter one of _ the following: In a command line: $ YTERM -FN FIXED In an .XDEFAULTS file: yterm.font fixed _ To specify the kilter font option, enter one of _ the following: In a command line: $ YTERM +FK The Terminal Emulator D-9 In an .XDEFAULTS file: yterm.kilterFonts on Changing Default Terminal Characteristics Upon starting a terminal emulator window, the application searches for a file called .XDEFAULTS in the user's SYS$LOGIN directory; if it does not find this file, it uses the default settings previously discussed. Users can specify which default characteristics emulator windows start up with by creating a file called .XDEFAULTS in their SYS$LOGIN directory. Create a .XDEFAULTS file with an editor, one option per line. The syntax of a line in .XDEFAULTS is: yterm.option [value] For example, to turn off autorepeat, use the following line in your .XDEFAULTS file: yterm.autorepeat off The case of each letter in a .XDEFAULTS file is important. For example, "boldFont" must be entered exactly as shown and not as, say, "boldfont". Note also that a .XDEFAULTS file is a data file and not a command procedure. In addition, command line options override .XDEFAULTS file values. Table D-4 lists all options with their syntax and a description. D-10 The Terminal Emulator ____________________________________________________ Table D-4: .XDEFAULTS File Options ____________________________________________________ .XDEFAULTS Line Description autorepeat on turns on autorepeat-- _______ default off turns off autorepeat autowrap on turns on screen autowrap-- _______ default off turns off screen autowrap keyclick on turns on keyclick off turns off keyclick-- _______ default font (font_ specifies named font to be name) used in window-- _______ __ default is _____ fixed boldFont (font_ specifies bold named font name) to be used in window kilterFonts off specifies not to use kilter font in window-- _______ default on specifies to use kilter font in window cursorMode on turns on arrow key application mode off turns off arrow key application-- _______ default keypadMode on turns on keypad key application mode The Terminal Emulator D-11 ____________________________________________________ Table D-4 (Continued): .XDEFAULTS File Options ____________________________________________________ .XDEFAULTS Line Description off turns off keypad key application mode-- _______ default iconShape (icon_ changes icon symbol in Icon number) box--numbers: 0 to 4-- _______ default __ _ is 0 geometry refer to Table D-2 iconName (icon_ changes text in Icon box name) under icon symbol-- _______ default __ _______ is "yterm" windowName (window_ changes text in window banner_ banner-- _______ __ _______ default is "yterm" name) iconStartup on brings window up as an icon off brings window up as terminal window-- _______ default internalBorder specifies number of pixels (number) from window border to where text is written reverseVideoon brings window up with reverse video on-- _______ default off brings window up with reverse video off selectEnableon enables cut and paste via mouse D-12 The Terminal Emulator ____________________________________________________ Table D-4 (Continued): .XDEFAULTS File Options ____________________________________________________ .XDEFAULTS Line Description off disables cut and paste via mouse-- _______ default ____________________________________________________ Example D-1 shows a sample .XDEFAULTS file. Example D-1: Sample .XDEFAULTS file yterm.autorepeat off yterm.keyclick on yterm.geometry =80x24+100+100 yterm.windowName VMS yterm.reverseVideo on yterm.kilterFonts on Using the yterm Set-Up Menu to Change Terminal Characteristics While using a terminal emulator window, users can change some of the characteristics of the window. The yterm Set-Up menu is a window that appears when you: 1. Hold down the key and 2. Click the left or middle mouse buttons while the mouse cursor is in the window. The yterm Set-Up menu appears so that the upper left corner of the menu is positioned at the mouse cursor. To move the yterm Set-Up menu, move the mouse cursor to the desired location and repeat Steps 1 and 2. The menu has 14 options and remains visible and on top of all other windows until the Exit option is selected, even if the window has been changed to an icon. You can make multiple selections but none take effect until you click on the Save option. You The Terminal Emulator D-13 select options by pointing at them with the mouse pointer and clicking the left mouse button. Some menu options offer two or more choices; others indicate an action to be taken. The following list shows the options available. yterm Menu Options 80 Columns | 132 Columns Normal Video | Reverse Video Autowrap On | Autowrap Off Numeric Keypad | Application Keypad Normal Cursor Keys | Application Cursor Keys Auto Repeat | No Auto Repeat Key Click Off | Key Click On Block Cursor | Underline Cursor Cursor On | Cursor Off Reset terminal Clear display VT100 Mode | VT 52 Mode | VT220 Mode 7 bit | VT220 Mode 8 bit Exit Save D-14 The Terminal Emulator Appendix E Customizing Your Work Area _______________________________________________________ Upon startup, HPWS provides a default work area that includes an icon box, several windows with buttons, and a terminal emulator window. After checking the user information supplied in the Start Session Form, the HPWS session manager reads a file called SYS$MANAGER:HPWS$STARTSESSION.COM, unless it finds a file called STARTSESSION.COM in the user's SYS$LOGIN directory. This appendix provides a brief example of a STARTSESSION.COM file. Using a standard VMS editor, system managers can modify the STARTSESSION.COM file to affect all workstation users, or individual users can create a customized work area by creating a STARTSESSION.COM in their SYS$LOGIN directories. (A good place to begin is to copy SYS$MANAGER:HPWS$STARTSESSION.COM into your account.) The following sample STARTSESSION.COM file opens the HPWS window manager and two Terminal Emulator windows--each 80 columns by 24 lines, with the names "Top" and "Bottom." Define global symbols or logicals in a LOGIN.COM file and session-specific information in a STARTSESSION.COM file. A line Customizing Your Work Area E-1 similar to the one creating the symbol YTERM must appear in the STARTSESSION.COM. Sample STARTSESSION.COM File $ ! Spawn HPWS Window Manager $ ! $ WM :== $HPWS$EXE:HPWS$WM.EXE $ SPAWN/NOWAIT/NOTIFY WM "=5x3+700+32" $ ! Create the symbol for YTERM.EXE: $ ! $ YTERM :== $HPWS$EXE:HPWS$YTERM.EXE $ SPAWN/NOWAIT/NOTIFY YTERM -N "Top" "=80x24+150+100" $ SPAWN/NOWAIT/NOTIFY YTERM -N "Bottom" "=80x24+150+500" E-2 Customizing Your Work Area