CONTENTS Title Page Copyright Page Preface 1 Utilities Overview 1.1 Development Utilities 1.1.1 VAXELN Debugger 1.1.2 VAXELN Performance Utility 1.1.3 VAXELN Display Utility 1.1.4 VAXELN Error Logging Tools 1.2 Command Language Utility 1.3 Network Utilities 1.3.1 LAT Control Program 1.3.2 Outbound Remote Terminal Utility 2 VAXELN Debugger 2.1 Selecting a Debugger Environment 2.2 Invoking the VAXELN Debugger 2.2.1 Initiating Remote Debugging 2.2.1.1 EDEBUG Command Syntax 2.2.1.2 Using Qualifiers to Control the EDEBUG Command 2.2.1.3 Redirecting Debugger I/O 2.2.2 Initiating Local Debugging and the Kernel Session 2.3 VAXELN Debugger Features 2.3.1 Command Sessions and Process Identifiers 2.3.2 Control-C Sessions 2.3.3 Breakpoints 2.3.4 Symbolic Debugging 2.4 Debugger Syntax Rules 2.4.1 Expressions 2.4.1.1 String Expressions 2.4.1.2 Address Expressions 2.4.2 Identifiers 2.4.2.1 Defining Identifiers 2.4.2.2 Predefined Identifiers 2.4.2.3 Program Locations and Variable Names 2.4.3 Variable References 2.4.4 Types and Typecasting 2.4.5 Computational Constants 2.4.5.1 Boolean Constants 2.4.5.2 Integer Constants 2.4.5.3 Floating-Point Constants 2.4.5.4 String Constants 2.4.5.5 Special Constants 2.4.6 Comments 2.5 Command Summary @ (Execute Procedure) ATTACH CALL CANCEL BREAK CANCEL CONTROL CANCEL EXCEPTION BREAK CREATE JOB CREATE PROCESS Ctrl/C Ctrl/Z DEBUG DEFINE DELETE PROCESS DEPOSIT EVALUATE EXAMINE EXAMINE/INSTRUCTION EXAMINE/PSL EXAMINE/SOURCE EXIT GO HALT HELP IF LEAVE LOAD PREDECESSOR SEARCH SET BREAK SET COMMAND SET CONTROL SET EXCEPTION BREAK SET LOG SET MODE SET OUTPUT SET PROGRAM SET RETURN BREAK SET SESSION SET SOURCE SET STEP SET TIME SHOW BREAK SHOW CALLS SHOW COMMAND SHOW JOB SHOW MESSAGE_TEXT SHOW MODE SHOW MODULE SHOW OBJECT SHOW PROCESS SHOW PROGRAM SHOW SCOPE SHOW SESSION SHOW SYMBOL SHOW SYSTEM SHOW TIME SHOW TRANSLATION SPAWN STEP SUCCESSOR TYPE UNLOAD WAIT 3 VAXELN Performance Utility 3.1 VAXELN Performance Utility Features 3.2 Collecting Performance Data 3.2.1 Preparing for Performance Analysis 3.2.2 Invoking the Collector 3.2.3 Collector Commands EXIT GO HELP SET COVERAGE SET DATA_FILE SET JOB_SAMPLING SET NODE SET PC_SAMPLING SET PROCESS_SAMPLING SET SYSTEM_SERVICE_SAMPLING SHOW DATA_FILE SHOW NODE SHOW RUN STOP 3.3 Using the Analyzer 3.3.1 Invoking the Analyzer 3.3.2 Analyzer Output 3.3.2.1 Analyzer Tables 3.3.2.2 Analyzer Histograms 3.3.3 Analyzer Commands EXIT FILE HELP PLOT PRINT SET DATA_FILE TABULATE 4 VAXELN Display Utility 4.1 Building EDISPLAY into Your Application 4.2 Starting Up EDISPLAY at Runtime 4.2.1 Using EDISPLAY from a Remote VMS System Terminal 4.2.2 EDISPLAY Keywords and Qualifiers 4.2.3 Manipulating Display Screens 4.2.4 Refreshing a Display Screen 4.2.5 Terminating EDISPLAY 4.3 Setup Display 4.3.1 Display Rate Menu Entry 4.3.2 Memory Display Menu Entry 4.3.3 Job Display Menu Entry 4.3.4 Help Menu Entry 4.3.5 Exit Edisplay Menu Entry 4.4 Memory Display 4.5 Job Display 4.6 Date and Time Settings 5 Error Logging Services 5.1 Overview 5.2 Building the Error Logging Service into an Application 5.3 Local Error Logging 5.3.1 Resetting System Time for Current Time Stamps 5.3.2 Last-Fail Support for Q22-bus, VAXBI, and 6000 Series Targets 5.4 Remote Error Logging Using the Error Log Server (ELSE) 5.4.1 Starting and Stopping ELSE 5.4.2 ELSE$ERRORLOG Parameter 5.4.3 RUN Command Qualifiers for ELSE 5.5 Generating Error Log Reports ANALYZE/ERROR_LOG 6 VAXELN Command Language Utility 6.1 Building ECL into Your Application 6.2 Initiating an ECL Session at Runtime 6.2.1 Session Work Environment 6.2.2 Terminating an ECL Session 6.2.3 Restriction on Remote Terminal Sessions from VMS 6.3 Entering Commands 6.3.1 Parts of a Command Line 6.3.2 Command Prompting 6.3.3 Entering Comments 6.3.4 Abbreviating Command Names 6.4 Entering Parameters 6.4.1 Specifying a File 6.5 Entering Command Qualifiers 6.5.1 Qualifier Defaults 6.5.2 Qualifiers That Accept Values 6.5.3 Abbreviating Qualifiers and Keywords 6.6 Entering Dates and Times 6.7 Executing an ECL Command 6.8 Single-Line Command Editing 6.9 File Specifications 6.10 Using Wildcards 6.10.1 Directory Specifications 6.10.2 Input File Specifications 6.10.2.1 Asterisk ( * ) Wildcard 6.10.2.2 Percent (%) Wildcard 6.10.3 Output File Specifications 6.11 Device Names 6.12 User Identification Code (UIC) 6.12.1 Protection Code 6.13 Establishing and Changing UIC-Based Protection 6.13.1 Volumes 6.13.2 Directories 6.13.3 Files 6.14 ECL Dictionary := = (Assign Command String) @ (Execute Procedure) COPY CREATE CREATE/DIRECTORY DEFINE/HELP DELETE DIRECTORY DISMOUNT EXECUTE HELP INITIALIZE LOAD/PROGRAM LOAD/SYSTEM Login Procedure LOGOUT MOUNT PURGE RENAME RUN SET DEFAULT SET FILE SET HOST SET ON SET PROTECTION SET TERMINAL SET TIME SET UIC SET VERIFY SHOW DEFAULT SHOW DEVICES SHOW NAME_SERVER SHOW TERMINAL SHOW TIME SHOW UIC TYPE UNLOAD/PROGRAM 7 Local Area Transport Control Program 7.1 LAT Concepts 7.2 Including LATCP in a VAXELN Application 7.2.1 Building the LAT Driver into an Application 7.2.2 Building LATCP into an Application 7.3 Invoking LATCP at Runtime 7.4 Entering Commands 7.4.1 Parts of a Command Line 7.4.2 Command Prompting 7.4.3 Entering Comments 7.4.4 Abbreviating Command Names 7.5 Entering Parameters 7.5.1 Specifying Names 7.5.1.1 Specifying Port Names and Service Names 7.5.1.2 Specifying Node Names 7.6 Entering Command Qualifiers 7.6.1 Qualifier Defaults 7.6.2 Qualifiers That Accept Values 7.6.3 Abbreviating Qualifiers and Keywords 7.7 LATCP Commands CREATE PORT CREATE SERVICE DELETE PORT DELETE SERVICE EXIT HELP SET COUNTERS/ZERO SET NODE SET PORT SET SERVICE SHOW CHARACTERISTICS SHOW COUNTERS SHOW PORTS SHOW SERVERS START NODE STOP NODE 8 Outbound Remote Terminal Utility 8.1 Building SET_HOST into Your Application 8.2 Starting Up SET_HOST at Runtime 8.3 Terminating SET_HOST A Debugging and Analyzing Closely Coupled Multiprocessing Systems A.1 Debugging a Secondary System A.2 Analyzing the Performance of a Secondary System FIGURES 1-1 VAXELN Utilities in a VAXELN Development Configuration 2-1 VAXELN Remote Debugger Environment 2-2 VAXELN Local Debugger Environment 2-3 Initial EDEBUG Screen 3-1 PC Sampling Data by Routine 3-2 PC Sampling Data by Source Line 3-3 Source Code Coverage Data - Brief Format 3-4 Source Code Coverage Data - Full Format 3-5 Job Sampling Data 3-6 Process Sampling Data 3-7 System Service Sampling Data 3-8 Histogram PC Sampling Output by Routine 3-9 Histogram PC Sampling Output by Source Line 4-1 EDISPLAY Setup Display Example 4-2 EDISPLAY Memory Display Example 4-3 EDISPLAY Job Display Example TABLES 2-1 EDEBUG Qualifiers 2-2 DEFINE Data Types 2-3 SET MODE Keywords 4-1 EDISPLAY Screen Manipulation Keys 5-1 RUN Command Qualifiers for ELSE 7-1 LAT Node Counters 7-2 Protocol Error Bit Mask Definitions