CONTENTS Title Page Copyright Page About This Guide 1 Introduction to VAXcluster Console System 1.1 Product Overview 1.2 Software Components 1.2.1 I/O Data Logger 1.2.2 Data Scanner 1.2.3 Event Logger 1.2.4 Central Control Coordinator Interface 1.2.5 Monitor Interface 1.2.6 Connect Interface 1.2.7 Record Interface 1.2.8 Review Interface 1.2.9 Access Interface 1.2.10 Configuration Editor 1.2.11 Configuration File 1.2.12 Log Files 2 Central Control Coordinator 2.1 Starting the C³ 2.2 C³ Window 2.2.1 Selecting an Icon 2.2.2 Choosing a Command 2.3 Viewing Events 2.3.1 Scan Events 2.3.2 Event Information 2.3.3 VCS Events 2.4 Connecting to a Node 2.5 Starting the Monitor Interface 2.6 Getting Information About the Configuration 2.7 Reviewing Log Data 2.8 Setting Host to a Node 2.9 Customizing C³ General Features 2.10 Customizing the Connect Interface 2.11 Customizing the Monitor Interface 2.12 Customizing the Review Interface 2.13 Customizing the Set Host Command 2.14 Saving and Restoring Customization Settings 2.14.1 Saving Customization Settings 2.14.2 Restoring Customization Settings 2.14.3 Customizing C³ DECterm Windows 2.15 Exiting from the C³ 3 Creating the VCS Configuration with the Configuration Editor DECwindows Interface 3.1 Configuration File 3.2 Starting the Configuration Editor 3.3 Adding a Node 3.4 Adding a Peripheral 3.5 Adding a Cluster 3.6 Adding an Event 3.7 Adding a Scan Profile 3.8 Adding a VCS User 3.9 Setting Up the VCS Environment 3.10 Labels 3.11 Modifying the Configuration 3.11.1 Adding Duplicate Nodes 3.11.2 Deleting from the Configuration 3.12 Customizing the Central Control Coordinator 3.13 Verifying the Configuration 3.14 Exiting from the Configuration Editor 4 Configuration Editor Commands @ (Execute Command File) ADD ADD CLUSTER ADD EVENT ADD NODE ADD PERIPHERAL ADD SCAN ADD USER DELETE EXIT HELP MODIFY MODIFY CLUSTER MODIFY EVENT MODIFY NODE MODIFY PERIPHERAL MODIFY SCAN MODIFY USER QUIT SET SET DISPLAY SET LOGGING SET SECURITY SET VERIFY SHOW SPAWN VERIFY 5 DCL Commands 5.1 Node Name Conventions 5.2 DCL Command Reference VCS VCS ACCESS VCS ACCESS /DEFAULT VCS CONNECT VCS CONVERT VCS COORDINATE VCS EDIT CONFIGURATION VCS MONITOR VCS RECONFIGURE VCS RECORD VCS REVIEW VCS SHUTDOWN VCS START LOGGER VCS START SCANNER 6 Monitor Interface 6.1 Introduction 6.1.1 Connect Mode 6.1.2 Monitor Mode 6.1.2.1 Log Window 6.1.2.1.1 Event Log Window 6.1.2.1.2 Event Context Window 6.1.2.2 Event Summary Window 6.1.2.3 Command Line 6.1.2.4 Message Line 6.2 Command Processing in the Monitor Mode 6.2.1 Line Editing Functions 6.2.2 Key Definitions 6.2.3 VAXstation Mouse 6.2.4 Node Names 6.2.5 Text Strings Contained in Command Lines 6.2.6 Specifying Control Characters 6.2.7 Date and Time Arguments 6.3 Monitor Interface Commands @ (Execute Command File) CONNECT CYCLE DEFINE/KEY DISABLE ENABLE EXIT FIND GOTO HELP NEXT EVENT NEXT SCREEN ONE_WINDOW OTHER_WINDOW OUTPUT PREVIOUS EVENT PREVIOUS SCREEN RECONFIGURE REFRESH REVIEW SAVE SCROLL SELECT SET BELL SET BREAK SET ESCAPE SET LOCK SET MOUSE SET PRIVILEGES SET SHIFT_KEY SET TIME_STAMP SET WIDTH SHIFT SHOW DIRECTORY SHOW KEYS SHOW MONITOR SHOW NODES SHOW TIME SHUTDOWN TWO_WINDOWS UNDEFINE/KEY VIEW WAIT WRITE 7 Summary of Monitor Interface Tasks 7.1 Entering and Exiting the VCS Monitor Interface 7.2 Getting Help 7.3 Communicating with Nodes 7.4 Viewing Current Console Logs 7.5 Viewing Events 7.6 Viewing Event Context 7.7 Controlling the Window Display 7.8 Searching for Information 7.9 Showing Information About the Current Monitor Interface Session 7.10 Reviewing Log Data 7.11 Copying a Buffer into a File 7.12 Viewing the Messages Received in the Current Monitor Interface Session 7.13 Modifying Key Definitions 7.14 Tailoring Your Monitor Interface Environment 8 Creating Your Own Icons 8.1 Creating an Icon Picture 8.1.1 Drawing an Icon Picture 8.1.2 Capturing an Icon Picture 8.2 Converting the Image 8.3 Reviewing the Icon 8.3.1 Getting Information About an Icon 8.3.2 Icon Names 8.3.3 Icons Supplied by VCS 8.3.4 Exiting from the Icon Review 8.4 Using the Icon 9 Writing Access Interface Applications 9.1 Overview of the Callback Routines 9.2 Creating User Code 9.3 Application Design Considerations 9.3.1 Event Management 9.3.2 Testing Environment 9.3.3 Logic Verification 9.4 Linking and Executing User Code 9.5 Debugging User Code 9.6 Customizing the DCL Command Syntax 9.7 Callback Routine Reference VCS$USER_INITIALIZE VCS$USER_MAINLOOP VCS$USER_RECONFIGURE VCS$USER_SCAN_EVENT VCS$USER_SHUTDOWN VCS$USER_VCS_EVENT 10 Event Notification System 10.1 Getting Started 10.1.1 Starting ENS 10.1.2 Using the ENS Editor 10.1.3 Testing ENS 10.1.4 Log Files 10.1.5 Logical Names 10.2 ENS Action Routines 10.2.1 Brdcst 10.2.2 Mail 10.2.3 DECtalk 10.2.4 Window 10.2.4.1 Window Customization 10.2.5 Window1 10.2.5.1 Window1 Customization 10.3 Adding Your Own Action Routines 10.3.1 Command Procedure Action Routines 10.3.2 Image Action Routines 10.3.2.1 Using Mailboxes 10.3.2.2 Passing a Parameter String to an Image 10.3.2.3 Passing a Parameter Structure to an Image 10.3.2.4 Testing and Debugging an Action Routine 10.4 ENS Editor Commands ADD ADD ACTION ADD EVENT COPY COPY ACTION COPY EVENT DELETE EXIT HELP MODIFY MODIFY ACTION MODIFY EVENT SHOW A Log Files A.1 Introduction A.2 Log File Analysis A.3 Console and Event Log File Record Formats A.3.1 Version Record A.3.2 VCS Error Record A.3.3 Service Initiation/Termination Record A.3.4 User Status Change Record A.3.5 User to Node Output Record A.3.6 Log Data Record - (Partial, Complete, or Full) A.3.7 VCS Event Record A.3.8 Scan Event Record B System Messages and Error Recovery Procedures B.1 General Instructions B.2 System Messages and Error Recovery Procedures ABOPRC . . . BADLOG BADLOGVER . . . C3LOGIC C3MEM . . . CFGSKW CFGUNVER . . . CONFVRF CONNECT . . . CONVICON CONVLOGS . . . CREATEFILE CTYLOSS . . . DEFBRKCLR DEFESC . . . DUPMBX DUPMBX . . . DW_DEL_SCAN DW_DEL_USER . . . DW_NODENOTVIS DW_NOLABEL . . . DW_REPLSCAN DW_REPLUSER . . . EVCOUNTINV EVENTCNT . . . FILENOTUIL FILNOTOPN . . . IMGCOMP INIT . . . LABELCNT LATDISCON . . . LOCKON LOCKOUT . . . MONS_BUFFERR MONS_CMDERR . . . MONS_NEGSHIFT MONS_NEXTEVENT . . . MONS_PREVEVENT MONS_REVIEWDIR . . . MONS_SHOWNBKESC MONS_TWOWDW . . . NOAPP NOBITS . . . NODESCANMISS NODESCANNOF . . . NOFRAME NOFUTLOGS . . . NOPRIVILEGES NOREQFONT . . . OLDSEC OPENIN . . . PORTALLOC PRCQUOTA . . . RENBADLOG REQFAIL . . . SCANCNT SCANCTXERR . . . SHUTDOWN SPAWNERR . . . SYNCHUNKNOWN SYNCHWAIT . . . TOOMANYSYS TOOMNYC3 . . . WAITEFN WORKING . . . WRTSIZE EXAMPLES 9-1 Sample Application Code FIGURES 1-1 VCS Console Data Flow 4-1 Event Anatomy 5-1 Recorded Text Anatomy 5-2 Reviewed Text Anatomy 5-3 Reviewed Event Anatomy 6-1 Monitor Interface Display with One Log Window 6-2 Monitor Interface Display with Two Log Windows 6-3 Event Summary Window 6-4 Window Control Keys 6-5 Keypad Layout 6-6 Reviewed Text Anatomy 6-7 Reviewed Event Anatomy 8-1 Creating Your Own Icons 9-1 VCS Access Interface Argument Block 10-1 ENS Window 10-2 ENS Window Action Routine Icon 10-3 ENS Window1 10-4 ENS Mailbox Structure A-1 Record Header A-2 Version Record A-3 VCS Error Record A-4 Service Initiation/Termination Record A-5 User Status Change Record A-6 User to Node Output Record A-7 Log Data Record A-8 VCS Event Record A-9 Scan Event Record TABLES 2-1 Icon Status 4-1 Configuration Editor Commands 4-2 Node Access Commands 4-3 VCS Management Commands 5-1 VCS DCL Commands 6-1 Command Line Editing Keys 6-2 Monitor Interface Commands 6-3 Control Key Names 6-4 Reserved Control Key Names 6-5 Function and Keypad Key Names 7-1 Monitor Interface Tasks and Commands 9-1 Access Interface Callback Routines 9-2 VCS Common Source Files 9-3 VCS$USER_INITIALIZE Argument List 9-4 VCS$USER_MAINLOOP Argument List 9-5 VCS$USER_RECONFIGURE Argument List 9-6 VCS$USER_SCAN_EVENT Argument List 9-7 VCS$USER_VCS_EVENT Argument List 9-8 VCS Event Codes 10-1 ENS Window Routine Customization Parameters 10-2 ENS Window1 Routine Customization Parameters 10-3 ENS Parameter Names and Definitions 10-4 ENS Mailbox Message Types A-1 Record Header Fields A-2 Console and Event Log Record Types A-3 Version Record Information A-4 VCS Error Record Information A-5 Service Initiation/Termination Record Information A-6 User Status Change Record Information A-7 User Change Codes A-8 User to Node Output Record Information A-9 Log Data Record Information A-10 Partial Lines A-11 VCS Event Record Information A-12 VCS Event Codes A-13 Scan Event Record Information B-1 Severity Levels