CONTENTS Title Page Copyright Page Preface 1 Installing and Upgrading Your VAXELN System 1.1 Upgrading 1.1.1 VMS Version 4.7 or Higher Required 1.1.2 C MATH.H and STDLIB.H Definition Modules Must Now Be Included from VAXELNC 1.2 Installation Notes 1.2.1 Changes to Software Distribution Kit for Version 4.2 1.2.2 Installing Internet Services 1.2.3 Including KA620, KA800, KA64A, rtVAX 300, rtVAX 1000, or Support in the Error Format Utility (ERF) 1.2.4 Modifying the rtVAX 300 Kernel 2 Enhancements and Corrections 2.1 Version 4.2 Enhancements 2.1.1 New Processor Support 2.1.2 New Device Support 2.1.2.1 VT1000 X Window Terminal 2.1.2.2 SPX Graphics Accelerator for the VAXstation 3100 2.1.2.3 Monochrome Graphics Support for VAXstation 2000 and VAXstation 3100 2.1.2.4 DEC LANcontroller 400 2.1.2.5 QDSS Graphics Controller 2.1.2.6 DRB32-W 2.1.2.7 RV20 Write-Once Optical Drive 2.1.3 Kernel Enhancements 2.1.3.1 Optimized Kernels for VAX 6000 Series Models 210, 310, and 410 2.1.3.2 KER$WAIT_ANY_EXPEDITED and KER$WAIT_ALL_EXPEDITED Procedures 2.1.3.3 Specifying Interrupt CPUs for Devices on VAX 6000 Series Processors 2.1.3.4 Support for Native XMI Devices 2.1.4 System Builder Enhancements 2.1.4.1 New Keystroke Commands 2.1.4.2 Target Processor Menu 2.1.4.3 Network Node Characteristics Menu 2.1.4.4 Internet Network Description Menu 2.1.4.5 Device Description Menu 2.1.4.6 DECwindows Server Characteristics Menu 2.1.4.7 New Logical Name for Selecting Kernel Console Polled I/O Image 2.1.5 VAXELN Pascal Enhancements 2.1.5.1 ALIGNED Storage Attribute Extended 2.1.5.2 LSEDIT Language Templates 2.1.6 Runtime Library Enhancements 2.1.6.1 Enhanced DRQ3B Utility Routines 2.1.6.2 ELN$CPU_INTERRUPT_MASK 2.1.7 DECwindows Enhancements 2.1.7.1 VAXELN DECwindows Internet Transport 2.1.7.2 Terminal Emulators Compatible with DECterm Version 2.1 2.1.7.3 User-Specified Xlib Output Buffer Size 2.1.7.4 User-Specified Server Transfer Size 2.1.8 Debugger Enhancement - SHOW SCOPE Command 2.1.9 VAXELN Command Language (ECL) Enhancements 2.1.9.1 Support for Login Command Files 2.1.9.2 Customizing ECL Commands 2.1.10 EWRITEBOOT Utility 2.2 Version 4.2 Corrections 2.2.1 VAXELN Kernel 2.2.2 System Builder 2.2.3 Debugger 2.2.4 VAXELN Pascal Compiler 2.2.5 C Runtime Library 2.2.6 File Service 2.2.7 VAXELN DECwindows Software 2.2.8 Internet Services 2.2.9 VAXELN Device Drivers 2.2.10 LAT Services 3 Restrictions 3.1 DECwindows 3.1.1 DECwindows Compatible Only with D_floating Point Shareable Libraries 3.1.2 Terminal Emulator Fonts in Version 4.2 Different from Version 4.0 3.1.3 Cannot Use ReGIS 3.1.4 Xlib and XUI Toolkit Must Be the Same Library Type 3.2 VAXELN Pascal 3.2.1 Limit on Array Sizes in Compiler-Debugger Interface 3.2.2 Initializing Aggregates to a Constant Value 3.2.3 Passing PROCEDURE_TYPE and FUNCTION_TYPE Routines as Arguments 3.2.4 Pascal I/O Exception Handling 3.2.5 Inefficient Code Generated for Functions with the INLINE Attribute 3.2.6 Cannot Use Same File Variable for Both External and Internal File 3.2.7 Passing Function Returning Subtypes as Parameters 3.2.8 Compiler Failure with INLINE Attribute 3.2.9 Passing Module-Level PORT Variables to READONLY Value Parameters 3.2.10 ZERO Function Cannot Clear More Than 64 Kbytes 3.3 VAXELN C Runtime Library 3.3.1 getc Fails to Echo Characters for Files Other Than stdin 3.3.2 Pascal Procedure GET_CONTROL_KEY Not Directly Supported in VAXELN C 3.3.3 VAX C CC$MIXED_FLOAT Macro Not Supported 3.3.4 C RTL Function ELN$CLEANUP_P1_CTX Returns Allocated Resources on Exit from a Process 3.4 System Builder 3.4.1 COPYSYS.COM May Need to Be Modified to Boot VAX 6000 Series Processors 3.4.2 Restrictions on VAXELN Image Sizes for Certain Targets 3.5 Debugger (EDEBUG) 3.5.1 Cannot Use Version 4.2 Remote Debugger with Version 4.0 Images 3.5.2 EDEBUG/LOAD Does Not Clear Fields in NCP Database 3.5.3 EDEBUG/LOAD Command Ignores Version Numbers 3.5.4 Debugger Consumes Pool Blocks on Process Creation and Deletion 3.5.5 Contents of Global Common Data Cannot Be Examined from the Debugger 3.5.6 Debugger Does Not Respond to Control Characters in Command Files 3.5.7 STEP Command Malfunctions When Using Debuggger and Performance Utility 3.6 VAXELN Performance Utility (EPA) 3.6.1 Using EPA and Authorization Required in the Same System 3.6.2 Sampling with Multiple Instances of the Same Job 3.6.3 VAXELN Performance Collector Was Incorrectly Reporting Service Information 3.7 Remote Terminal Utility 3.7.1 VMS-Specific Messages Not Supported 3.7.2 Using a VMS Command File to SET HOST to a VAXELN Target 3.7.3 VAXELN Outbound Remote Terminal Access to VMS Defaults to /NOBROADCAST 3.7.4 Wait Required After Terminating Remote Connection 3.7.5 SET TERMINAL/[NO]EIGHT_BIT Has No Effect 3.8 VAXELN Command Language (ECL) Restrictions 3.9 File Service 3.9.1 Logical I/O Operations Fail After a ELN$SET_DEFAULT_FILESPEC Call 3.9.2 MOUNT_VOLUME Warning Message 3.9.3 DIRECTORY_LIST Search of VMS Version 4.6 or 4.7 Directories Fails 3.9.4 Writing Files on Remote MS-DOS Systems from VAXELN Pascal 3.10 Internet Software 3.11 Device Drivers 3.11.1 Maximum Length of a LAT Port Name 3.11.2 LAT Driver Does Not Support All Functions of ELN$TTY_ASSERT_BREAK 3.11.3 Limit on Number of Outstanding Read and Writes for DRB32 Utility Routines 3.11.4 DHVDRIVER Support for the DHQ11 and CXY08 Assumes DHV Mode 3.11.5 Serial Line Drivers Need Increased Pool Size 3.11.6 RV20 Optical Disk Drive 3.12 DECnet and VAXELN Networks 3.12.1 Out-of-Band Characters 3.12.2 Large Data Transfers from a VAXELN DECnet Node 3.12.3 Network Support for IEEE 802 3.12.4 Support for DEC LANcontroller 400 3.13 Closely Coupled Symmetric Multiprocessing Restrictions 3.13.1 Do Not Specify the trace Argument When Loading a KA800 Processor 3.13.2 Unpredictable Behavior for Datagrams Sent to a Full Port 3.14 Floating-Point Emulation Required for G_floating Point Operations 3.15 VMS Command Restriction - SET VOLUME/HIGHWATER 4 Documentation Notes 4.1 VAXELN Development Utilities Guide 4.1.1 Add MNA to the Network Device Menu 4.1.2 Additions to Controller Type Table 4.1.3 Replace SGEC Entry in the Integral-Bus Device Information Table 4.1.4 Add DEMNA and SGEC to Datalink Device Default Addresses 4.1.5 Add MNA to Mnemonic/Host Processor Table 4.1.6 Additional Information for Setting Up VAX 8 nnn Bootstrap 4.1.7 Minimum Console Patch Level for Down-Line Loading VAX 6000-Series Processors 4.1.8 Additions to Processor Command Table 4.1.9 Information about Booting from Nonremovable Disks, Including the Use of EWRITEBOOT 4.1.9.1 Systems Having VMB in ROM-for Example, the MicroVAX Family 4.1.9.2 Systems Requiring VMB.EXE to Be Loaded from the Boot Disk (for example, the VAX 6000 Series) 4.1.10 System Builder Program Arguments Apply Only to Jobs Created at System Startup Time 4.1.11 ECL EXECUTE Job Arguments Default to Null Strings 4.1.12 Clarification of EDEBUG SEARCH Command 4.1.13 Clarification of EDEBUG TYPE Command 4.1.14 Reloading a Machine That Is Running the Network Service 4.1.15 DSSI Disk Support for VAX 4000-300 Systems 4.2 VAXELN Runtime Facilities Guide 4.2.1 Highest Interrupt Priority Correction 4.2.2 Expanded Discussion of Displaying Message Text on VMS Systems 4.2.3 Corrections for Ethernet/IEEE 802 Network Interface Examples 4.2.4 Deleting Messages Received Using the ELN$NI_RECEIVE Routine 4.2.5 A Note on Digital-Supplied Device Drivers 4.3 VAXELN Messages Manual 4.3.1 New System Builder Messages 4.3.2 New Bugcheck Messages 4.3.3 Services for Communicating with ULTRIX Nodes 4.3.3.1 Requesting Connections from VAXELN Systems 4.3.3.2 Accepting Connections on ULTRIX Systems 4.3.3.3 Requesting Connections on ULTRIX Systems 4.3.3.4 Accepting Connections on VAXELN Systems 4.3.4 Additional VMS Emulation Routines 4.4 VAXELN Application Design Guide 4.5 VAXELN Pascal Language Reference Manual 4.5.1 Correction of INSERT_QUEUE, REMOVE_QUEUE Procedure Names 4.5.2 Correction of QUEUE_POSITION Values with INSERT_ENTRY Procedure 4.5.3 Correction of Operator Precedence Rules 4.5.4 Correction of Values for Inserting Queue Entries 4.5.5 Correction to file_attribute Argument of OPEN Procedure 4.5.6 Correction to action Argument of OPEN Procedure 4.6 VAXELN Pascal Runtime Library Reference Manual 4.6.1 Corrections to Arguments for ADQ32 Utility Routines 4.6.2 Missing Note for Description of KER$ENTER_KERNEL_CONTEXT Routine 4.6.3 Replacement Description for ELN$COPY_FILE ELN$COPY_FILE 4.7 VAXELN C Reference Manual 4.7.1 Correction to localtime Function Description 4.7.2 Format for the setsockopt Function 4.8 VAXELN C Runtime Library Reference Manual 4.8.1 Correction to Format for eln$inet_show_interface 4.8.2 Replacement Description for eln$copy_file eln$copy_file 4.9 VAXELN FORTRAN Runtime Library Reference Manual 4.9.1 The Value of .TRUE. 4.9.2 Corrections for ELN$NI_TRANSMIT Routine 4.9.3 Replacement Description for ELN$COPY_FILE ELN$COPY_FILE 4.10 VAXELN Ada User's Manual 4.11 VAXELN Guide to DECwindows 4.11.1 Setting Application Defaults Using Calls to OPEN DISPLAY 4.11.2 Specifying Language Variants 4.11.3 Customizing the Window Manager 4.11.4 STOPWATCH.C Updated with UID File Information 4.12 VAXELN Pocket Reference 4.13 Clarification of KER$ACCEPT_CIRCUIT Procedure 4.14 Correction for KER$CREATE_PORT message_limit Argument 4.15 ELN$ALLOCATE_STACK Clarification 4.16 ELN$ADQ_START Routine Must Be Used with All Clock Modes 4.17 Corrections to Status Value Descriptions 4.17.1 KER$CONNECT_CIRCUIT and the KER$_NO_MEMORY Status Values 4.17.2 Datagram Information for KER$SEND Procedure's KER$_COUNT_OVERFLOW Status Value 4.17.3 Additional Explanation for KER$_NO_MAP_REGISTER Status 4.18 Default Value for ELN$NI_CONNECT promiscuous Argument A VAXELN Performance Information and Disk I/O Performance Tuning A.1 Performance Data A.1.1 Test Descriptions A.1.1.1 Process Context Switch Tests A.1.1.2 Interrupt Service Routine Tests A.1.2 Test Methodology A.1.3 Test Conditions A.1.4 Performance Data Tables A.1.5 Data Computation A.2 Disk I/O Performance Tuning A.2.1 Disk I/O Tuning Summary A.2.2 Optimizing Disk I/O Throughput A.2.2.1 Transfer Size A.2.2.2 Cluster Size A.2.2.3 Buffer Size A.2.2.4 Other Factors Affecting Performance A.2.2.5 Disk I/O Tuning Examples A.2.2.5.1 Comparisons of I/O Parameter Tuning A.2.2.5.2 Comparisons of Tuning Results on Different Configurations A.2.3 I/O Tuning in C and FORTRAN A.2.3.1 C Language Tuning Considerations A.2.3.2 FORTRAN Tuning Considerations B VAXELN Version 4.1 Enhancements and Corrections B.1 Version 4.1 Enhancements B.1.1 New Processor Support B.1.2 New Device Support B.1.3 Closely Coupled Symmetric Multiprocessing Support for VAX 6000 Series Systems B.1.4 Kernel Enhancements B.1.4.1 CREATE_AREA_EVENT and CREATE_AREA_SEMAPHORE Routines B.1.4.2 Kernel Routine Changes for New Area Functionality B.1.5 SS$ Message Text B.1.6 Shared Status Text B.1.7 Multiple Ethernet Controller Support B.1.8 Network Management Service B.1.9 Down-Line Load Service B.1.10 Internet Services B.1.11 Support for Third-Party SCSI Devices B.1.12 File Service Enhancements B.1.12.1 Direct Device Access for Local Disks B.1.12.2 Data Access Protocol Upgraded B.1.13 Runtime Library Enhancements B.1.13.1 Language Support for ADQ32 Driver Interface B.1.13.2 Language Support for Network Management Service B.1.13.3 Language Support for Down-Line Load Service B.1.13.4 Language Support for SCSI Generic Device Class Driver Message Interface B.1.13.5 Language Support for DDA Disk Interface B.1.13.6 C Language Support for Internet Services B.1.13.7 New Timeout Status Value for IEQ11-A and IEU11-A Interface Routines B.1.13.8 New Device Types for Network Interface Routines B.1.13.9 New Range for Network Interface Routine count Argument B.1.13.10 C Runtime Library Enhancements B.1.14 System Builder Enhancements B.1.14.1 Main Menu B.1.14.2 Target Processor Menu B.1.14.3 System Characteristics Menu B.1.14.4 Network Node Characteristics Menu B.1.14.5 Device Description Menu B.1.14.6 Terminal Description Menu B.1.14.7 DECwindows Server Characteristics Menu B.1.15 Debugger Enhancements B.1.15.1 Multiple Command Line Recall B.1.15.2 New /MESSAGE_LIMIT Qualifier for the LOAD Command B.1.15.3 Process Name Display in Command Output B.1.15.4 New SHOW OBJECT Command B.1.15.5 Updated SHOW SYSTEM Command B.1.16 New ECL COPY Command Qualifiers B.1.17 VAXELN DECwindows Enhancements B.1.17.1 VAXELN DECwindows Server Enhancements B.1.17.2 VAXELN DECwindows XUI Toolkit Enhancements B.1.17.3 VAXELN DECwindows File Names Renamed B.2 Version 4.1 Corrections B.2.1 VAXELN DECwindows Server B.2.2 C Runtime Library B.2.3 VAXELN Pascal Compiler B.2.4 Pascal Runtime Library B.2.5 FORTRAN Runtime Library B.2.6 Debugger B.2.7 System Builder B.2.8 VAXELN File Service B.2.9 VAXELN Command Language C VAXELN Version 4.0 Enhancements and Corrections C.1 Version 4.0 Enhancements C.1.1 New Processor Support C.1.2 Device Support C.1.3 DECwindows Support C.1.4 Network Support for IEEE 802 C.1.5 Closely Coupled Symmetric Multiprocessing Support for VAX 6300 Series Systems C.1.6 Support for VMS Emulation Routines C.1.7 System Builder (EBUILD) Enhancements C.1.8 VAXELN Command Language (ECL) Enhancements C.1.9 Error Logging Utility Enhancements C.1.10 Enhancements to VAXELN Kernel C.1.10.1 Increased Object Support for WAIT_ALL and WAIT_ANY Routines C.1.10.2 KER$UNWIND Procedure Can Unwind 0 Frames C.1.10.3 New Function KER$GET_UPTIME C.1.11 Enhancements to Runtime Libraries C.1.11.1 Language Support for ELN$TTY and ELN$NI Routines C.1.11.2 Enhancements to C Runtime Library C.1.12 Remote Terminal Utility C.1.13 Terminal Driver Enhancements C.1.13.1 Performance Increase of Reads C.1.13.2 Improved Error Reporting C.1.14 Other Driver Enhancements C.2 Version 4.0 Corrections C.2.1 VAXELN Kernel C.2.2 System Builder C.2.3 Program Loader C.2.4 VAXELN Performance Utility (EPA) C.2.5 VAXELN C Runtime Library C.2.6 Terminal Driver C.2.6.1 Single Character I/O Now Passes CTRL/X C.2.6.2 XON Character No Longer Lost C.2.7 VAXELN Networks C.2.7.1 Target No Longer Lost from Network C.2.7.2 Multiple Name Server Condition No Longer Returns Exception C.2.8 LAT Driver D Upgrading from Version 3.2 or Lower D.1 Changes to Exception Handling and KER$UNWIND D.2 VAX RTA Version 2.0 with VAXELN Version 4.0 D.3 Multiple CREATE_DEVICE Calls Require Unique RELATIVE_VECTOR Argument D.4 Question in COPYSYS.COM E DRQ3BX Device Driver Interface E.1 DRQ3BX Routine Descriptions ELN$DRQ3BX_INITIALIZE ELN$DRQ3BX_MAP_READ_BUFFERS ELN$DRQ3BX_MAP_WRITE_BUFFERS ELN$DRQ3BX_QUEUE_READ ELN$DRQ3BX_QUEUE_WRITE ELN$DRQ3BX_READ_FUNCTION ELN$DRQ3BX_TRANSFER_DONE_READ ELN$DRQ3BX_TRANSFER_DONE_WRITE ELN$DRQ3BX_UNMAP_READ_BUFFERS ELN$DRQ3BX_UNMAP_WRITE_BUFFERS ELN$DRQ3BX_WRITE_FUNCTION E.2 DRQ3BX Data Definitions E.2.1 DRQ3BX C Type Declarations E.2.2 DRQ3BX FORTRAN Constant Declarations E.2.3 DRQ3BX Pascal Constant and Type Declarations E.3 DRQ3BX Examples E.3.1 DRQ3BX C Example E.3.2 DRQ3BX Pascal Example TABLES 1-1 New Files for the Version 4.2 Distribution Kit 2-1 New System Builder Keystroke Commands 2-2 VAXELN Pascal Alignment Attributes 4-1 Window Manager Default Names A-1 System Configurations A-2 ISR and Context Switch Test Conditions A-3 Interrupt Tests-rtVAX 1000-Time in Microseconds A-4 Interrupt Tests-rtVAX 3300-Time in Microseconds A-5 Interrupt Tests-rtVAX 3500-Time in Microseconds A-6 Interrupt Tests-rtVAX 3800-Time in Microseconds A-7 Context Switch Tests-rtVAX 1000-Time in Microseconds A-8 Context Switch Tests-rtVAX 3300-Time in Microseconds A-9 Context Switch Tests-rtVAX 3500-Time in Microseconds A-10 Context Switch Tests-rtVAX 3800-Time in Microseconds A-11 Summary of Disk I/O Tuning Techniques A-12 Throughput Rates with Different Buffer Sizes, Cluster Size 127, on a MicroVAX II with an RQDX3/RD53 A-13 Throughput Rates with Different Cluster Sizes, Buffer Size 32768, on a MicroVAX II with an RQDX3/RD53 A-14 Throughput Rates for a MicroVAX II and a MicroVAX 3500 C-1 Network Interface Routines E-1 DRQ3BX Routines