CONTENTS Title Page Copyright Page Preface Part 1: Overview of Major New Features 1 Summary of New VMS Version 5.4 Software Features 2 Introduction to Vector Processing 2.1 Overview of the Vector Processing Environment 2.1.1 VAX Vector Processing Systems 2.1.2 Vectorized Programs 2.1.3 VMS Support for Vector Processing 2.1.3.1 Life of a Vector Consumer 2.1.3.2 VAX Vector Instruction Emulation Facility (VVIEF) 2.2 Managing the Vector Processing Environment 2.2.1 Loading the VMS Vector Processing Support Code 2.2.2 Configuring a VMS Vector Processing System 2.2.3 Managing Vector Processes 2.2.3.1 Adjusting System Resources and Process Quotas 2.2.3.2 Distributing Scalar and Vector Resources Among Processes 2.2.4 Restricting Access to the Vector Processor by Using ACLs 2.2.5 Obtaining Information About a Vector Processing System 2.2.5.1 DCL Lexical Functions F$GETJPI and F$GETSYI 2.2.5.2 SHOW CPU Command 2.2.5.3 SHOW PROCESS and LOGOUT/FULL Commands 2.2.5.4 Vector Processing Support Within the VMS Accounting Utility (ACCOUNTING) 2.2.5.5 Vector Support Within the Error Log Utility (ERROR LOG) 2.2.5.6 Vector Support Within the VMS Monitor Utility (MONITOR) 2.2.6 Loading the VAX Vector Instruction Emulation Facility (VVIEF) 2.2.7 System Messages Related to Vector Processing Activities 2.3 Programming in a Vector Processing Environment 2.3.1 Vector Routines in the MTH$ Run-Time Library 2.3.2 Obtaining Information About a Vector Processing System 2.3.3 Releasing the Vector Processor 2.3.4 Preserving and Restoring a Routine's Vector State 2.3.5 Debugging a Vectorized Program 2.3.5.1 Vector Processing Support Within the VMS Debugger 2.3.5.2 Vector Processing Support Within the VMS System Dump Analyzer (SDA) 2.3.5.3 Vector Processing Support Within the VMS Delta/XDelta Utility 2.3.5.4 Vector Processing Support Within the VMS Patch Utility 2.3.6 Servicing Vector Exceptions 2.3.7 Requirements of the VAX Procedure Calling and Condition Handling Standard for Vector Processing 2.3.7.1 Vector Register Usage 2.3.7.2 Vector and Scalar Processor Synchronization 2.3.7.3 Memory Synchronization 2.3.7.4 Exception Synchronization 2.3.7.5 Synchronization Summary 2.3.7.6 Condition Handler Parameters and Invocation 2.3.8 VMS Accounting Utility (ACCOUNTING) Resource Packet Format 2.3.9 VMS Monitor Utility (MONITOR) VECTOR Class Record 3 Introduction to DECdtm Services 3.1 Characteristics of Distributed Transactions 3.2 Transaction Processing System Model 3.2.1 Resource Manager 3.2.2 Transaction Manager 3.2.3 Log Manager 3.3 Overview of Two-Phase Commit Protocol 3.4 Managing DECdtm Services Using VMS Utilities 3.5 New TRANSACTION_ID Data Type for Programming Routines Part 2: General User Features 4 DCL Commands and Lexical Functions 5 EVE Editor 5.1 Box Editing 5.2 New Command: CONVERT TABS 5.3 New Qualifiers: /WORK and /INTERFACE 5.4 Additional Sources of New EVE Information 6 System Messages 6.1 VMS Facilities with New or Modified System Messages 6.2 System Messages Available from Online Help 7 DECwindows User and Desktop Applications 7.1 Session Manager 7.1.1 Setting Another Session Language 7.1.2 Changing Your Target Screen 7.2 CDA Viewer 7.2.1 Viewing a PostScript File 7.2.2 New Processing Options for Viewing PostScript Files 7.3 Calculator 7.4 Clock 7.5 Mail: Displaying PostScript Files Part 3: System Management Features 8 AUTOGEN Command Procedure 8.1 Parameter Name Validation 8.2 AGEN$FEEDBACK.REPORT Replaced by New File 8.3 MODPARAMS.DAT Includes External Parameter Files 8.4 MIN_, MAX_, and ADD_ Values Allowed for Page and Swap Files 8.5 New Feedback Parameters 8.6 Logical Names Defined by AUTOGEN 8.7 New Technique for Running AUTOGEN in Batch Mode 8.8 Using MAIL to Send AGEN$PARAMS.REPORT 9 User Environment Test Package (UETP) 9.1 RRD40 Compact Disc Drive Support 9.2 Vector Processing Support 10 SYSMAN Utility 10.1 Running a SYSMAN Command Procedure 10.2 Defining Keys with the DEFINE command 10.3 Spawning a Subprocess from Within SYSMAN 10.4 Using DCL Verification 10.5 Using Loadable Image Commands 11 VAXcluster Management 11.1 CI Architecture Extensions 11.2 MSCP Server Load Sharing 11.3 Preferred Path Support for DSA disks 12 System Generation Utility (SYSGEN) 12.1 SCSI_NOAUTO Parameter 12.2 LOAD_PWD_POLICY Parameter 12.3 LOAD_SYS_IMAGES Parameter 12.4 Supported Device Names for VAXft 3000 Systems 12.5 New SYSGEN Commands SHOW/BI=BIindex SHOW/BUS=busId SHOW/XMI=BIindex 13 Error Log Utility (ERROR LOG) 13.1 Supported Device Types for VAXft 3000 Systems 13.2 New Keywords for /EXCLUDE and /INCLUDE Qualifiers 13.3 New Qualifier: /NODE 14 System Security 14.1 Site-Defined Password Policy 14.1.1 Screening New Passwords 14.1.1.1 Password History List 14.1.1.2 Site-Specific Filter 14.1.2 Specifying a Password Algorithm 15 Log Manager Control Program Utility (LMCP) 15.1 Managing Transaction Log Files 15.1.1 Defining SYS$JOURNAL 15.1.2 Placing a Transaction Log File 15.1.3 VAXcluster Failover 15.1.4 Determining Transaction Log File Size 15.1.5 Creating Transaction Log Files 15.1.6 Example of Creating a Transaction Log File 15.1.7 Resizing and Moving Transaction Log Files 15.2 Format of Transaction Log Files CONVERT CREATE DUMP HELP REPAIR ABORT COMMIT EXIT FORGET HELP NEXT SHOW 16 Monitor Utility (MONITOR) 16.1 MONITOR TRANSACTION Command 16.2 TRANSACTION Class Record 16.3 MONITOR VECTOR Command 16.4 VECTOR Class Record 17 Network Control Program Utility (NCP) 17.1 Line and Circuit Name Support for VAXft 3000 Systems 17.2 Line and Circuit Names for New Ethernet/820 Controllers 18 VMS Volume Shadowing Phase II Part 4: Programming Features 19 VMS Debugger 19.1 Debugging Vectorized Programs 19.2 Command Interface: New and Enhanced Commands and Qualifiers 19.3 DECwindows Interface: Enhancements to Menus and Dialog Boxes 20 Linker Utility (LINK) 21 Utility Routines: MAIL 22 System Services 22.1 Summary of New System Services 22.2 Using Transaction Management System Services 22.2.1 Transaction Processing System Model 22.2.2 Transaction Management 22.2.3 Starting a Transaction 22.2.4 Completing a Transaction 22.2.5 Calling a Planned Abort 22.2.6 Example of Using Transaction Management System Services 22.3 Using the Initialize Volume ($INIT_VOL) System Service 22.4 Descriptions of New System Services $ABORT_TRANS $ABORT_TRANSW $END_TRANS $END_TRANSW $FORMAT_AUDIT $HASH_PASSWORD $INIT_VOL $RELEASE_VP $RESTORE_VP_EXCEPTION $RESTORE_VP_STATE $SAVE_VP_EXCEPTION $START_TRANS $START_TRANSW 22.5 Modified System Services 22.5.1 $CHANGE_ACL 22.5.1.1 Vector Processing: New Object Type 22.5.1.2 System Security: New Item Codes 22.5.2 $CHECK_ACCESS: Vector Processing and System Security Support 22.5.3 $ENQ: Enhanced Lock Manager Support 22.5.4 $GETDVI: New Device Classes 22.5.5 $GETJPI 22.5.5.1 Vector Processing: New Item Codes 22.5.5.2 System Security: New Item Codes 22.5.6 $GETSYI 22.5.6.1 Vector Processing: New Item Codes 22.5.6.2 System Security: New Item Code 22.5.7 $GETUAI: New Item Codes for Enhanced Password Screening 22.5.8 $MOD_IDENT: New Status Code 22.5.9 $MOUNT: Volume Shadowing Flags 22.5.10 $SETUAI: New Item Codes for Enhanced Password Screening 22.6 Implementing Site-Specific Security Policies 22.6.1 Creating Loadable Security Services 22.6.1.1 Preparing and Loading a System Service 22.6.1.2 Removing an Executive Loaded Image 22.6.2 Installing Site-Specific Password Policy Filters 22.6.2.1 Creating a Shareable Image 22.6.2.2 Installing a Shareable Image 23 Run-Time Library Routines 23.1 Parallel Processing (PPL$) 23.2 Mathematics (MTH$) 24 VMS Record Management Services 24.1 VMS RMS Asynchronous Support for Process-Permanent Files 24.2 Local Buffer Maximum Increased 24.3 Access-Mode Protection for VMS RMS 24.3.1 Access-Mode Protected Services 24.3.2 Access-Mode Protected Memory 24.4 Expired-Date Suppression 24.4.1 The Role of XAB$_NORECORD XABITM 24.4.2 Applications for XAB$_NORECORD XABITM 25 I/O Driver Support 25.1 Pseudoterminal Driver 25.2 Shadow Set Virtual Unit Driver 25.3 New Modifier Bits for TRM$_MODIFIERS Item Code 25.4 Itemlist Read Function I/O Status Block 25.5 New ACP-QIO Function Attributes 26 System Dump Analyzer Utility (SDA) 26.1 New SHOW PROCESS Qualifier: /IMAGES 26.2 New SHOW PROCESS Qualifier: /VECTOR_REGISTERS 27 Device Support 27.1 VAX 9000 Hardware Considerations 27.2 VAX 9000 System Address Space 27.3 Driver Debugging with Pool Checking 28 VAX Text Processing Utility (VAXTPU) 28.1 New Qualifier: /INTERFACE 28.2 New and Enhanced Built-In Procedures 28.3 Work File Support 29 VAX RMS Journaling: Support for DECdtm Services 29.1 Support for DECdtm Transactions 29.2 RUF Services Emulated 29.3 Network Support 29.4 Record Stream Association 29.4.1 How Streams Become Associated with a Transaction 29.4.2 Stream Association Using RUF and DECdtm Services 29.5 Detached Recovery 29.5.1 Synchronous and Asynchronous Recovery 29.5.2 Partial Recovery 29.6 Placement of Recovery Unit Journals 29.7 Multiple Long-Term Journals Allowed 29.8 Mixed-Version Clusters 30 VMSINSTAL 30.1 New Parameter for the VMSINSTAL SPKITBLD.COM Procedure 30.2 New and Enhanced VMSINSTAL Callbacks 31 DECwindows and CDA Programming Features 31.1 New Programming Examples in DECW$EXAMPLES Directory 31.1.1 BTrap (Broadcast Message Trapper) 31.1.2 TestVHist (Histogram Widget Exerciser) 31.1.3 TestVList (VList Widget Exerciser) 31.1.4 VDragExample (VDrag Exerciser) 31.2 XUI Toolkit: Enhancements to Color Mixing Widget 31.3 VMS DECwindows Display PostScript System 31.4 Compound Document Architecture (CDA) 31.4.1 PostScript Support for CDA VIEW Command 31.4.2 CDA Viewer Support of Adobe Font Metrics and DECmath Fonts 31.4.3 New CDA Documentation A VMS Version 5.3 Features A.1 VMS Version 5.3 System Management Features A.1.1 Extension of Lock Manager Limit A.1.2 NCP Executor Command Changes A.1.3 Parameter for SET/DEFINE EXECUTOR A.1.4 SHOW EXECUTOR CHARACTERISTICS Command A.2 VMS Version 5.3 Support for the VMS Distributed Name Service A.2.1 Introduction to the Distributed Name Service A.2.2 The DNS Namespace A.2.2.1 Planning Namespace Objects A.2.2.2 Restrictions A.2.2.3 Using the Namespace A.2.2.4 Object Names A.2.2.5 Object Attributes A.2.3 Structure of a Namespace A.2.3.1 Naming Syntax A.2.3.2 Logical Names A.2.3.3 Valid Characters for DNS Names A.2.4 Creating Objects A.2.5 Modifying Objects A.2.6 Distributing the Namespace A.2.6.1 Replicating Directories A.2.6.2 Types of Directories A.2.6.3 Setting Confidence A.2.6.4 Maintaining Consistency in Data A.2.7 Requesting Information from DNS A.2.7.1 Reading Objects A.2.7.2 Listing Information A.2.7.3 How the Clerk Locates Data A.2.8 DNS System Services $DNS $DNSW A.2.9 DNS Run-Time Routines DNS$APPEND_SIMPLENAME_TO_RIGHT DNS$COMPARE_FULLNAME DNS$COMPARE_SIMPLENAME DNS$CONCATENATE_NAME DNS$COUNT_SIMPLENAMES DNS$CVT_DNSADDRESS_TO_BINARY DNS$CVT_DNSADDRESS_TO_NODENAME DNS$CVT_NODENAME_TO_DNSADDRESS DNS$CVT_TO_USERNAME_STRING DNS$PARSE_USERNAME_STRING DNS$REMOVE_FIRST_SET_VALUE DNS$REMOVE_LEFT_SIMPLENAME DNS$REMOVE_RIGHT_SIMPLENAME A.2.10 Starting the DNS Clerk A.2.11 DECnet Event Messages B VMS Version 5.2 Features B.1 VMS Version 5.2 System Management Features B.1.1 System Generation Utility (SYSGEN) B.1.1.1 DEINSTALL Command Description B.1.1.2 ERLBUFFERPAGES Parameter B.1.2 NETCONFIG.COM Security Enhancements B.1.2.1 Default Access Options B.1.2.2 Security Benefits B.1.2.3 Questions Posed by NETCONFIG.COM B.1.3 New NETCONFIG_UPDATE.COM for Existing Networks B.1.3.1 Benefits of NETCONFIG_UPDATE.COM B.1.3.2 Using NETCONFIG_UPDATE.COM in a VAXcluster B.1.4 Backup Utility (BACKUP) B.1.4.1 Performance Enhancements B.1.4.2 Setting Up the BACKUP Account B.1.4.3 Setting System Generation Utility (SYSGEN) Parameters B.1.4.4 Understanding Why the Output Device Seems Idle B.1.4.5 /BUFFER_COUNT Command Qualifier Is Now Obsolete B.1.4.6 Cyclic Redundancy Checking Emulation Improvements B.1.4.7 Pressing Ctrl/T to Obtain Information About BACKUP Operations B.2 VMS Version 5.2 System Services Features B.2.1 Modifications to $SETUAI and $GETUAI B.2.2 New Item Codes for $SETUAI and $GETUAI B.2.3 New Authorization Flags for $SETUAI and $GETUAI B.2.4 Modifications to $MOUNT B.2.5 Modifications to $DISMOUNT B.2.6 Modification to $MOD_IDENT B.2.7 Modifications to Existing System Services for Clusterwide Process Accessibility B.2.8 Process Information Services B.2.9 Overview of $GETJPI and $GETJPI with $PROCESS_SCAN B.2.10 Using the Process ID to Obtain Information B.2.11 Using the Process Name to Obtain Information B.2.12 Modifications to $GETJPI B.2.13 Using $GETJPI Alone B.2.14 Requesting Information About a Single Process B.2.15 Requesting Information About All Processes on the Local System B.2.16 Using $GETJPI with $PROCESS_SCAN B.2.17 Using the $PROCESS_SCAN Item List and Item-Specific Flags B.2.18 Requesting Information About Processes That Match One Criterion B.2.19 Requesting Information About Processes That Match Multiple Values for One Criterion B.2.20 Requesting Information About Processes That Match Multiple Criteria B.2.21 Specifying a Node as Selection Criterion B.2.22 Scanning All Nodes on the Cluster for Processes B.2.23 Scanning Specific Nodes on the Cluster for Processes B.2.24 Conducting Multiple Simultaneous Searches with $PROCESS_SCAN B.2.25 Programming Considerations for GETJPI$ B.2.26 Using Item Lists Correctly B.2.27 Improving Performance by Using Buffered $GETJPI Operations B.2.28 Meeting Remote $GETJPI Quota Requirements B.2.29 Using $GETJPI Control Flags B.2.30 Descriptions of New VMS Version 5.2 System Services $DEVICE_SCAN $PROCESS_SCAN C VMS Version 5.1 Features C.1 VMS Version 5.1 Support for Compound Documents C.1.1 VMS Commands and Utilities C.1.1.1 Displaying RMS File Tags C.1.1.1.1 DIRECTORY/FULL C.1.1.1.2 ANALYZE/RMS_FILE C.1.1.2 Creating RMS File Tags C.1.1.3 Preserving RMS File Tags and DDIF Semantics C.1.1.3.1 COPY Command C.1.1.3.2 VMS Mail Utility C.1.1.4 APPEND Command C.1.2 DDIF Support in a Heterogeneous Environment C.1.2.1 EXCHANGE/NETWORK Command C.1.2.2 COPY Command C.1.2.3 VMS Mail Utility C.1.2.4 DDIF File Access Within a Mixed Version Cluster C.1.3 VMS RMS Interface Changes C.1.3.1 Programming Interface for File Tagging $XABITM C.1.3.2 Accessing a Tagged File C.1.3.2.1 File Accesses That Do Not Sense Tags C.1.3.2.2 File Accesses That Sense Tags C.1.3.3 Preserving Tags C.1.4 Distributed File System Support for DDIF Tagged Files C.1.5 VMS RMS Errors C.2 EXCHANGE/NETWORK Command EXAMPLES 8-1 Sample AUTOGEN Command Procedure 15-1 Sample Transaction Log File 22-1 Using Transaction Management Services B-1 Using $GETJPI to Obtain Information About the Calling Process B-2 Using $GETJPI and the Process Name to Obtain Information About a Process B-3 Using $GETJPI to Request Information About All Processes on the Local System B-4 Using $GETJPI and $PROCESS_SCAN to Select Process Information by User Name B-5 Using $GETJPI and $PROCESS_SCAN with Multiple Values for One Criterion B-6 Selecting Processes That Match Multiple Criteria B-7 Searching the Cluster for Process Information B-8 Searching for Process Information on Specific Nodes in the Cluster B-9 Using a $GETJPI Buffer to Improve Performance B-10 Using $GETJPI Control Flags to Avoid Swapping a Process into the Balance Set C-1 Tagging a File C-2 Accessing a Tagged File FIGURES 2-1 VAX 6000-400 Series Vector-Present Processor Configuration 2-2 VAX 9000 Series Vector-Present Processor Configuration 2-3 Life of a Vector Consumer 3-1 Sample Debit/Credit Transaction Execution 3-2 Participants in a Distributed Transaction Example 7-1 DECwindows Screen Number Dialog Box 7-2 DECwindows Screen Number Dialog Box 12-1 SCSI_NOAUTO System Parameter 15-1 Sample Transaction Log File Configuration on Two-Node VAXcluster 16-1 TRANSACTION Class Record Format 16-2 VECTOR Class Record Format 22-1 Transaction Processing Components 27-1 VAX 9000 System Architecture 27-2 VAX 9000 XMI Address Space 27-3 SCU/XMI Systems I/O Address Space 27-4 SCU Bus Address Allocation 27-5 XJA Private Space Address Allocation 27-6 SCU/XMI Systems Address Bit Structure A-1 A DNS Namespace A-2 Valid Character Codes for DNS Simple Names A-3 Additional Character Codes Allowed in Quoted Simple Names A-4 A Partitioned Namespace A-5 A Namespace with Replicated Directories TABLES 1-1 Summary of VMS Version 5.4 Software Features 2-1 Settings of VECTOR_PROC System Parameter 2-2 System Messages Relating to Vector Processing 2-3 Summary of Exception Conditions 4-1 Summary of New and Enhanced DCL Commands 4-2 Summary of New and Enhanced Lexical Functions 5-1 EVE Box Editing Commands 14-1 Arguments to the /ALGORITHM Qualifier 16-1 Descriptions of TRANSACTION Class Record Fields 16-2 Descriptions of VECTOR Class Record Fields 16-3 Descriptions of Additions to System Record Fields 21-1 Mail Utility Routines 22-1 New VMS Version 5.4 System Services 22-2 $ABORT_TRANS Operation Flag 22-3 $END_TRANS Operation Flag 22-4 $START_TRANS Operation Flags 22-5 Legal QUECVT Conversions 22-6 Values Returned by the DEVCLASS Item 22-7 Attributes of an Identifier 31-1 Display PostScript Documentation A-1 DNS Item Code Arguments B-1 UAF Process Quotas for the BACKUP Account B-2 Suggested Values for UAF Process Quotas B-3 Process Identification C-1 Tag Support Item Codes