CONTENTS Title Page Copyright Page Preface 1 Installing and Upgrading Your VAXELN System 1.1 Installation Notes 1.1.1 Software Distribution Kit Changes 1.1.2 Using the AWD Option or a Nonsystem Device When Installing VAXELN DECwindows Software 1.1.3 Installing the VAXELN Toolkit and the Ada Products 1.1.4 Installing ERF Support for KA and rtVAX Processors 1.2 Upgrading 1.2.1 C math.h and stdlib.h Definition Modules 1.2.2 VAXELN Ada Toolkit 2 Enhancements 2.1 New Processor Support 2.1.1 VAX 4000 Model 200 Processor 2.1.2 VAX 6000 Model 500 Series 2.1.3 rtVAX 9000 Model 110 and 310 Processors 2.2 New Device Support 2.2.1 KDM70 Disk Controller 2.2.2 RA Disk Drives 2.2.3 RF Disk Drives 2.2.4 SCSI Devices 2.3 System Service Enhancements 2.3.1 Bitmap Allocation Enhancements 2.3.2 SET JOB PRIORITY ANY Kernel Routine 2.3.3 New Memory Allocation Routines 2.4 Downline Load Service Enhancement 2.5 Internet Service Enhancements 2.5.1 Internet Service Support for Ada, FORTRAN, and Pascal Programming 2.5.2 New Internet Control Routines 2.5.3 File Transfer Protocol Client Interface 2.5.4 TELNET Server 2.5.5 Broadcast Address 0.0.0.0 2.5.6 Automatic Recalculation of Broadcast Addresses at System Startup 2.5.7 Setting the Broadcast Address Using the INET SET INTERFACE Routine 2.5.8 Unit Number Default for Internet Device Names 2.6 File Service Enhancements 2.7 Device Driver Enhancements 2.7.1 DSIDRIVER Disk Driver 2.7.2 EZDRIVER Ethernet Datalink Driver 2.7.3 SCSI Driver 2.7.3.1 SCSI Asynchronous Event Notification 2.7.3.2 SCSI Driver Modifications 2.8 Math Runtime Library Enhancements 2.9 Ada Integration 2.9.1 Ada VAXELN_SERVICES Package 2.9.2 Ada Documentation 2.10 C Runtime Library Enhancement 2.11 VAXELN Pascal Compiler Enhancements 2.12 System Builder Enhancements 2.12.1 Target Processor Menu 2.12.2 System Characteristics Menu 2.12.3 Network Nodes Characteristics Menu 2.12.4 Internet Characteristics Menu 2.12.5 Device Description Menu 2.12.6 DECwindows Server Characteristics Menu 2.13 Error Logging Service Enhancements 2.14 POSIX Support 2.15 DECwindows Enhancements 2.15.1 DECwindows Server Enhancements 2.15.2 DECwindows Client Enhancements 2.16 Documentation Enhancements 3 Corrections 3.1 Kernel Corrections 3.1.1 RAISE EXCEPTION Routine Executes Correctly When Called from User-Mode Program Executing in Kernel Mode 3.1.2 Behavior of Datagrams Sent to a Full Port Now Predictable 3.1.3 KERNELDEF Corrected to Produce Constant Name for WCB Wait Field 3.2 Program Loader Corrections 3.2.1 Program Loader Now Detects Programs That Exceed P0 Virtual Memory Size 3.2.2 Shareable Image Match Control Is Now Compatible with VMS Systems 3.2.3 Program Loader Memory Loss Corrected 3.3 General Runtime Library Corrections 3.3.1 Callback Routines Passed by Reference 3.3.2 Routine Exception Handlers Now Handle Asynchronous Exceptions Correctly 3.4 Math Runtime Library Correction 3.5 C Runtime Library Corrections 3.5.1 fgetc Function Returns EOF Predictably 3.5.2 Open Operations for Shared Files Using Append Access Mode No Longer Cause Data to Be Overwritten 3.5.3 Calls to fflush No Longer Cause Data to Be Overwritten 3.5.4 Seek Operations on Remote ULTRIX Files Now Reposition the File Pointer 3.6 File Service Corrections 3.6.1 File Service Routines Return ELN$_SUCCESS for Normal Successful Completion 3.6.2 TMSCPCLASS Driver No Longer Hangs After Bad Tape Initializations 3.6.3 Volume Names Now Created Correctly by MOUNT Routines 3.6.4 C Programs Now Can Read Undefined Format Files Correctly 3.6.5 Insufficient Disk Blocks for Extending Index File Handled More Cleanly 3.6.6 File Service No Longer Crashes When Writing to Contiguous Files of Length Zero 3.7 IEEE/Ethernet Datagram Service Correction 3.8 DECnet Service Correction 3.9 Internet Services Corrections 3.9.1 accept Function Now Returns the Address of a Connected Socket 3.9.2 Linger Time Option Now Honored If Set Before Call to accept 3.9.3 getsockname and getpeername Functions Now Return Information Unconditionally 3.10 LAT Host Services Corrections 3.11 Terminal Driver Correction 3.12 VAXELN_SERVICES Package Corrections 3.13 VAXELN Pascal Compiler Corrections 3.13.1 Correct Code Is Now Generated for Port Identifiers 3.13.2 Compiler Now Issues a Warning When Exported Symbol Tables Are Too Large 3.13.3 Compiler Generates Correct Code for Calls to CONVERT 3.13.4 Compiler Provides the Debugger with Correct Symbol Table Data for Byte-Sized Integers 3.13.5 Passing Function Returning Subtypes as Parameters 3.13.6 Compiler Failure with INLINE Attribute Corrected 3.14 System Builder Corrections 3.14.1 Terminal Characteristics Are No Longer Ignored When the DZSDRIVER Is Used as Both a Console and Terminal Driver 3.14.2 Program Image Sections That Exceed the P0 Virtual Memory Size Are Now Detected 3.14.3 Program Arguments That Exceed 100 Characters Are Now Truncated 3.14.4 Shareable Image Match Control Is Now Compatible with VMS Systems 3.15 VAXELN Performance Utility Correction 3.15.1 Collector No Longer Reports Insufficient Memory When System Has Sufficient Resources 3.15.2 Analyzer /[NO]ZERO Qualifier Corrected 3.16 VAXELN DECwindows Client Software Correction 3.16.1 DWT$CARDINAL Redefined 3.16.2 XUI Toolkit Supplied as Shareable Image Library 4 Restrictions 4.1 Target Processor Restrictions 4.2 Kernel Restrictions 4.3 Closely Coupled Multiprocessing Restrictions 4.4 DECnet Service Restrictions 4.4.1 Large Data Transfers from a VAXELN DECnet Node 4.4.2 Network Support for IEEE 802 4.4.3 Support for DEC LANcontroller 400 4.5 Internet Services Restrictions 4.5.1 The connect Function Always Blocks 4.5.2 The listen Function Accepts Invalid Values 4.5.3 Interchanging the DECnet and Internet Services on an Ethernet Controller 4.5.4 The inet_ntoa Function Returns a Pointer to Static Data 4.5.5 Network Loopback Device Not Provided 4.6 Remote Terminal Utility Restrictions 4.6.1 VMS-Specific Messages Not Supported 4.6.2 Using a VMS Command File to SET HOST to a VAXELN Target 4.6.3 VAXELN Outbound Remote Terminal Access to VMS Defaults to /NOBROADCAST 4.6.4 Wait Required After Terminating Remote Connection 4.6.5 SET TERMINAL/[NO]EIGHT_BIT Has No Effect 4.6.6 SET HOST Sessions Dropped 4.7 File Service Restrictions 4.7.1 Logical I/O Operations Fail After a SET DEFAULT FILESPEC Call 4.7.2 MOUNT_VOLUME Warning Message 4.7.3 DIRECTORY_LIST Search of VMS Version 4.6 or 4.7 Directories Fails 4.7.4 Writing Files on Remote MS-DOS Systems from VAXELN Pascal 4.8 Device Driver Restrictions 4.8.1 Maximum Length of a LAT Port Name 4.8.2 LAT Driver Does Not Support All Functions of TTY ASSERT BREAK 4.8.3 Limit on Number of Outstanding Reads and Writes for DRB32 Utility Routines 4.8.4 DHVDRIVER Support for the DHQ11 and CXY08 Assumes DHV Mode 4.8.5 Serial-Line Drivers Need Increased Pool Size 4.8.6 RV20 Optical Disk Drive 4.8.7 SCSI Port Driver Interface Not Available in Ada 4.8.8 SCSI Port Driver Supports Only Logical Unit Number 0 4.8.9 DRQ3BX Driver Interface Replacing DRQ3B Interface 4.8.10 User-Written Terminal Drivers Must Be Recompiled and Relinked 4.8.11 MUDRIVER May Hang Before RV20 Is Initialized 4.9 C Runtime Library Restrictions 4.9.1 Function getc Fails to Echo Characters for Files Other than stdin 4.9.2 Pascal Procedure GET CONTROL KEY Not Directly Supported in VAXELN C 4.9.3 VAX C CC$MIXED_FLOAT Macro Not Supported 4.9.4 C RTL Function CLEANUP P1 CTX Returns Allocated Resources on Exit from a Process 4.10 VAXELN Pascal Compiler Restrictions 4.10.1 Limit on Array Sizes in Compiler-Debugger Interface 4.10.2 Initializing Aggregates to a Constant Value 4.10.3 Passing PROCEDURE_TYPE and FUNCTION_TYPE Routines as Arguments 4.10.4 Pascal I/O Exception Handling 4.10.5 Cannot Use Same File Variable for Both External and Internal Files 4.10.6 ZERO Function Cannot Clear More Than 64 Kbytes 4.10.7 SCA INSPECT Command Bugchecks When Specified with a Routine and Its Parameters 4.11 Debugger Restrictions 4.11.1 Cannot Use Version 4.3 Debugger Remotely with Version 4.0 Images 4.11.2 EDEBUG/LOAD Does Not Clear Fields in NCP Database 4.11.3 EDEBUG/LOAD Command Ignores Version Numbers 4.11.4 Debugger Consumes Pool Blocks and Ports on Process Creation and Deletion 4.11.5 Contents of Global Common Data Cannot Be Examined from the Debugger 4.11.6 Debugger Hangs When Writing FORTRAN Message Strings That Include FAO Characters 4.11.7 Specifying Program Names That Contain Hyphens 4.12 Command Language (ECL) Restriction 4.13 Performance Utility Restrictions 4.13.1 Using EPA and Authorization Required in the Same System 4.13.2 Sampling with Multiple Instances of the Same Job 4.13.3 Potential Problems with Collector STOP Command on Tightly Coupled Multiprocessors 4.14 POSIX Restrictions 4.14.1 Function Support 4.14.2 Support Limited to Three Terminal Drivers 4.14.3 User-Written Terminal Drivers Must Be Recompiled and Relinked 4.14.4 Multiprocessor Support Not Available 4.14.5 Avoid Calling POSIX Functions from VAXELN Subprocesses 4.14.6 Using the VAXELN SET TIME Routine to Set the Clock 4.14.7 Executing POSIX Programs from ECL 4.14.8 Possible Loss of Two Memory Pages 4.14.9 Argument Value Limits for Clock, Per-Process Timer, and Sleep Routines 4.14.10 Files Open When a Program Calls an exec Function Are Closed When the Calling Program Terminates 4.14.11 File Descriptors for Sockets Are Invalid in a Child Process 4.15 DECwindows Restrictions 4.15.1 Terminal Emulator Fonts in Version 4.3 Different from Version 4.0 4.15.2 Cannot Use ReGIS with Terminal Emulators 4.15.3 Programs That Link Against DECwindows Toolkit Libraries Must Link Against ELNDECW_XLIBSHR 4.15.4 Limited Support Provided for VAXELN Pascal Programming 4.15.5 UIL Compiler Is Not Provided 4.15.6 Changes to DECwindows Definition Files 4.16 COPYSYS Command Procedure Restriction 4.17 VMS Command Restriction - SET VOLUME/HIGHWATER A VAXELN Performance Information and Disk I/O Performance Tuning B Enhancements Provided in Previous Version 4. n Releases B.1 VAXELN Toolkit Version 4.2 Enhancements B.2 VAXELN Toolkit Version 4.1 Enhancements B.3 VAXELN Toolkit Version 4.0 Enhancements TABLES 2-1 New Memory Allocation Routines 2-2 Internet Control Routines 2-3 Byte-Order Conversion Routines 2-4 Internet Address Manipulation Routines 2-5 Socket Transport Interface Routines 2-6 New Internet Control Routines 2-7 FTP Routines 2-8 SCSI Port Driver Interface Extension Routines for AEN 2-9 VAXELN POSIX Functions