OpenVMS Version 7.3 New Features and Documentation Overview Order Number: AA–QSBFD–TE April 2001 This manual describes the new features associated with the OpenVMS Alpha and OpenVMS VAX Version 7.3 operating systems, and provides an overview of the documentation that supports the software. Revision/Update Information: This is a new manual. Software Version: OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.
© 2001 Compaq Computer Corporation Compaq, AlphaServer, POLYCENTER, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office. OpenVMS and Tru64 are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries. UNIX and X/Open are trademarks of The Open Group in the United States and other countries. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Part I OpenVMS Version 7.3 New Features 1 Summary of OpenVMS Version 7.3 New Features 2 Compaq OpenVMS e-Business Features 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 Compaq Secure Web Server for OpenVMS Alpha . . . . . . . . . . . . . . Compaq COM for OpenVMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compaq Java 2 SDK, Standard Edition, for OpenVMS Alpha . .
.7 /ARB_SUPPORT Qualifier Added to INSTALL Utility (Alpha) . . . . . . . . . 4.8 MONITOR Utility New Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.9 OpenVMS Cluster Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.9.1 Clusterwide Intrusion Detection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.9.2 Fast Path for SCSI and Fibre Channel (Alpha) . . . . . . . . . . . . . . . . . . 4.9.
.4.7 New Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.5 Fortran Support for 64-Bit Address (Alpha) . . . . . . . . . . . . . . . . . . . . . . . . 5.6 Large Page-File Sections (Alpha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.7 Multipath System Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.8 Multiprocess Debugging (Alpha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.
5.15.7 SPL STOP TRACE . . . . . . . . . . . . . 5.15.8 SPL UNLOAD . . . . . . . . . . . . . . . . 5.16 System Services . . . . . . . . . . . . . . . . . . 5.17 TCP/IP Files for SDA READ Command Locations . . . . . . . . . . . . . . . . . . . . . . . 5.18 Visual Threads Version 2.1 (Alpha) . . . ........... ........... ........... That Contain ........... ........... ................ ................ ................ Global Symbols and ................ ................
9 Descriptions of OpenVMS Manuals 9.1 9.2 9.2.1 9.2.2 9.3 9.4 9.5 Manuals Included in the OpenVMS Media Kit Manuals in the OpenVMS Documentation Set . OpenVMS Base Documentation Set . . . . . . Continuation of Full Documentation Set . . OpenVMS Alpha Device Driver Manual . . . . . . RMS Journaling Manual . . . . . . . . . . . . . . . . . Archived Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface Intended Audience This manual is intended for general users, system managers, and programmers who use the Compaq OpenVMS Operating System. This document describes the new features related to Version 7.3 of the OpenVMS Alpha and OpenVMS VAX operating systems. For information about how some of the new features might affect your system, read the release notes before you install, upgrade, or use Version 7.3.
Reader’s Comments Compaq welcomes your comments on this manual. Please send comments to either of the following addresses: Internet openvmsdoc@compaq.com Mail Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 How To Order Additional Documentation Use the following World Wide Web address to order additional documentation: http://www.openvms.compaq.com/ If you need help deciding which documentation best meets your needs, call 800-282-6672.
[|] In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. {} In command format descriptions, braces indicate required elements; you must choose one of the options listed. bold text This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. In the HTML version of this Conventions table, this convention appears as italic text.
Part I OpenVMS Version 7.
1 Summary of OpenVMS Version 7.3 New Features Compaq OpenVMS Version 7.3 delivers the highest levels of availability, scalability, flexibility, performance, and security that are required for e-Business. With more than 20 years of proven reliability, OpenVMS continues to improve its availability and performance by including new technology into the base operating system and the OpenVMS Cluster software environment.
Summary of OpenVMS Version 7.3 New Features Java 2 SDK, Standard Edition Attunity Connect "On Platform Package" (native JDBC driver included) Reliable Transaction Router (RTR) OpenVMS Enterprise Directory for e-Business (X.500) OpenVMS Version 7.3 includes all the capabilities of OpenVMS Version 7.2, OpenVMS Version 7.2-1, and the OpenVMS Version 7.2-1H1 hardware release. Table 1–1 summarizes each feature provided by OpenVMS Alpha and OpenVMS VAX Version 7.
Summary of OpenVMS Version 7.3 New Features Table 1–1 Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features Compaq OpenVMS e-Business Infrastructure Package for OpenVMS Alpha Version 7.3 Compaq OpenVMS e-Business This chapter provides information on the following e-Business technologies that are included in the Compaq OpenVMS e-Business Infrastructure Package with OpenVMS Alpha Version 7.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features System Management Features CPU Online Replace (AlphaServer GS160/320 systems) OpenVMS Alpha Version 7.3 supports CPU Online Replace. CPU Online Replace provides the ability to replace secondary CPUs on a running system without rebooting, which increases system maintainability and serviceability.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features System Management Features OpenVMS Cluster systems The following are new OpenVMS Cluster features: Clusterwide intrusion detection Clusterwide intrusion detection is enabled by the integration of intrusion data and information from each system into a clusterwide intrusion database.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features System Management Features Volume Shadowing for OpenVMS Volume Shadowing for OpenVMS introduces three new features: • Minicopy operation, which is a streamlined copy operation. Minicopy can significantly decrease the time it takes to perform a full copy operation and can significantly increase the availability of the shadow sets that use this feature.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features Programming Features Large Page-File sections (Alpha) Previous limits for page-file sections have been extended significantly to take advantage of larger physical memory. Now images that use 64-bit addressing can map and access an amount of dynamic virtual memory that is larger than the amount of physical memory available on the system.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features Programming Features RMS locking enhancements RMS includes the following enhancements for OpenVMS Version 7.3: • Global buffer read-mode bucket locking (Alpha)—Improves RMS application performance on OpenVMS Alpha systems by minimizing locking for shared access to global buffers. Does not require changes to existing applications.
Summary of OpenVMS Version 7.3 New Features Table 1–1 (Cont.) Summary of OpenVMS VAX and OpenVMS Alpha Version 7.3 Software Features Associated Products Features Compaq DECwindows Motif for OpenVMS Compaq DECwindows Motif for OpenVMS Version 1.2-6 provides a full range of changes and enhancements for your desktop. Compaq Distributed Computing Environment (DCE) for OpenVMS The following enhancements are available in Compaq DCE for OpenVMS Version 7.3: DECram Version 3.
2 Compaq OpenVMS e-Business Features This chapter provides information on the e-Business technologies that are included in the Compaq OpenVMS e-Business Infrastructure Package with OpenVMS Alpha Version 7.3. This package provides key Internet and e-Business software technology that enhances the base OpenVMS Alpha operating system. These technologies are licensed with the OpenVMS Alpha operating system. The Compaq OpenVMS e-Business Infrastructure Package Version 1.
Compaq OpenVMS e-Business Features 2.1 Compaq Secure Web Server for OpenVMS Alpha 2.1 Compaq Secure Web Server for OpenVMS Alpha Compaq Secure Web Server for OpenVMS Alpha (CSWS) is based on the popular Apache Web Server from the Apache Software Foundation. Building on the source code from the Apache Software Foundation (http://www.apache.org), Compaq OpenVMS engineering has incorporated and fully integrated OpenSSL with mod_ssl, the most popular open-source implementations of SSL.
Compaq OpenVMS e-Business Features 2.6 Attunity Connect "On Platform" Package 2.6 Attunity Connect "On Platform" Package Attunity Connect is object-oriented middleware that facilitates the development of applications that access, integrate, and update data from multiple, heterogeneous sources across a wide range of operating system platforms. With Attunity Connect, you can extend the life of your existing data and applications and preserve your significant IT investments.
3 General User Features This chapter provides new features information for all users of the Compaq OpenVMS Operating System. 3.1 DCL Commands and Lexical Functions This section describes new and changed DCL commands, qualifiers, and lexical functions for OpenVMS Version 7.3. The following table contains a summary of these changes. For more information, refer to the OpenVMS DCL Dictionary. DCL Command Documentation Update ANALYZE/IMAGE A new qualifier, /SELECT, has been added, along with an example.
General User Features 3.1 DCL Commands and Lexical Functions DCL Command Documentation Update SET AUDIT A new keyword, SERVER, has been added under the LOGFAILURE, LOGIN, and LOGOUT keywords. New text has been added to the /NEW_LOG qualifier. SET CACHE/RESET This new DCL command has been added to support Extended File Cache (XFC).
General User Features 3.1 DCL Commands and Lexical Functions DCL Lexical Documentation Update F$GETDVI The item codes, MT3_DENSITY, MT3_SUPPORTED, and WWID have been added, and the MOUNTCNT item code has been updated. The item codes, DEVTYPE, DEVCLASS, and DEVICE_ TYPE_NAME have been updated, and an example has been added. Tables 1-7 and 1-8 have been removed. F$GETQUI The JOB_STATUS item code list has been updated. F$GETJPI The MULTITHREAD item code has been added.
General User Features 3.3 MIME Utility Enhancements Command Description ADD/BINARY Sets the Content-Type to application/octet-stream and ContentTransfer-Encoding to Base64. This format can be used to represent an arbitrary binary data stream. SHOW option Displays information about the MIME environment. Possible options are CONTENT_TYPE, FILE_TYPES, and VERSION. For more information about the MIME utility commands and qualifiers, refer to the OpenVMS User’s Manual. 3.
4 System Management Features This chapter provides information about new features, changes, and enhancements for system managers. 4.1 OpenVMS Support for New AlphaServer GS Series Systems OpenVMS Alpha Version 7.3 provides support for Compaq’s AlphaServer GS80, GS160 and GS320 systems, which was introduced in OpenVMS Version 7.
System Management Features 4.1 OpenVMS Support for New AlphaServer GS Series Systems 4.1.3 OpenVMS Support for CPU Online Replace With OpenVMS Alpha Version 7.3, you can replace secondary CPUs on a running system without rebooting, which provides increased system maintainability and serviceability. This feature is supported only on AlphaServer GS160/320 systems. Note that replacing the primary CPU requires rebooting. To use this feature, you must first download console firmware Version 5.
System Management Features 4.3 Class Scheduler for CPU Scheduling To invoke the class scheduler, you use the SYSMAN interface. SYSMAN allows you to create, delete, modify, suspend, resume, and display scheduling classes. Table 4–1 shows the SYSMAN command, CLASS_SCHEDULE, and its sub-commands.
System Management Features 4.4 Dedicated CPU Lock Manager (Alpha) 4.4 Dedicated CPU Lock Manager (Alpha) The Dedicated CPU Lock Manager is a new feature that improves performance on large SMP systems that have heavy lock manager activity. The feature dedicates a CPU to performing lock manager operations. A dedicated CPU has the following advantages for overall system performance as follows: • Reduces the amount of MP_SYNCH time • Provides good CPU cache utilization 4.4.
System Management Features 4.4 Dedicated CPU Lock Manager (Alpha) In addition, if the number of active CPUs should ever be reduced below the required threshold by either a STOP/CPU command or by CPU reassignment in a Galaxy configuration, the Dedicated CPU Lock Manager automatically turns off within one second, and the LCKMGR_SERVER process goes into a hibernate state. If the CPU is restarted, the LCKMGR_SERVER process again resumes operations. 4.4.
System Management Features 4.4 Dedicated CPU Lock Manager (Alpha) • You can eliminate the first available nonprimary CPU as an available Fast Path CPU. To do so, clear the bit associated with the CPU ID from the IO_ PREFER_CPUS system parameter. For example, let’s say your system has eight CPUs with CPU IDs from zero to seven and four SCSI adapters that will use Fast Path. Clearing bit 1 from IO_PREFER_CPUs would result in the four SCSI devices being bound to CPUs 2, 3, 4, and 5.
System Management Features 4.
System Management Features 4.8 MONITOR Utility New Features These enhancements are discussed in more detail in the MONITOR section of the OpenVMS System Management Utilities Reference Manual and in the appendix that discusses MONITOR record formats in that manual. Also in the MONITOR utility, the display screens of MONITOR CLUSTER, PROCESSES/TOPCPU, and SYSTEM now have new and higher scale values. Refer to the OpenVMS System Management Utilities Reference Manual: M–Z for more information. 4.
System Management Features 4.9 OpenVMS Cluster Systems 4.9.2 Fast Path for SCSI and Fibre Channel (Alpha) Fast Path for SCSI and Fibre Channel (FC) is a new feature with OpenVMS Version 7.3. This feature improves the performance of Symmetric MultiProcessing (SMP) machines that use certain SCSI ports, or FC. In previous versions of OpenVMS, SCSI and FC I/O completion was processed solely by the primary CPU.
System Management Features 4.9 OpenVMS Cluster Systems Configurations that use Fibre Channel fabrics can be extremely large. Distances up to 100 kilometers are supported in a multisite OpenVMS Cluster system. OpenVMS supports the Fibre Channel SAN configurations described in the Compaq StorageWorks Heterogeneous Open SAN Design Reference Guide, available at the following Compaq web site: http://www.compaq.
System Management Features 4.9 OpenVMS Cluster Systems 4.9.5.1 SCA Control Program The SCA Control Program (SCACP) utility is designed to monitor and manage cluster communications. (SCA is the abbreviation of Systems Communications Architecture, which defines the communications mechanisms that enable nodes in an OpenVMS Cluster system to communicate.) In OpenVMS Version 7.3, you can use SCACP to manage SCA use of LAN paths.
System Management Features 4.9 OpenVMS Cluster Systems Migration support is a superset of the Rolling Upgrade support provided in earlier releases of OpenVMS and is available for mixes that are not warranted. Migration support means that Compaq has qualified the versions for use together in configurations that are migrating in a staged fashion to a newer version of OpenVMS VAX or of OpenVMS Alpha. Problem reports submitted against these configurations will be answered by Compaq.
System Management Features 4.10 OpenVMS SMP Performance Improvements (Alpha) must be placed into a mutex wait state or when mutex waiters must wake up, SCHED will still need to be acquired. • Improved Process Scheduling Changes made to the OpenVMS process scheduler reduce contention on the SCHED spinlock. Prior to OpenVMS Version 7.3, when a process became computable, the scheduler released all IDLE CPUs to attempt to execute the process. On NUMA systems, all idle CPUs in the RAD were released.
System Management Features 4.10 OpenVMS SMP Performance Improvements (Alpha) Prior to OpenVMS Version 7.3, the mailbox driver FDT routines called a routine that locked the MAILBOX spinlock and delivered any required attention ASTs. In most cases, this routine did not require any attention ASTs to be delivered. Because the OpenVMS code that makes these calls already has the MAILBOX spinlock locked, the spinlock acquisition was also an unneeded second acquire of the spinlock. As of OpenVMS Version 7.
System Management Features 4.12 New System Parameters 4.12 New System Parameters This section contains definitions of system parameters that are new in OpenVMS Version 7.3. 4.12.1 AUTO_DLIGHT_SAV AUTO_DLIGHT_SAV is set to either 1 or 0. The default is 0. If AUTO_DLIGHT_SAV is set to 1, OpenVMS automatically makes the change to and from daylight saving time. 4.12.2 FAST_PATH_PORTS FAST_PATH_PORTS is a static parameter that deactivates Fast Path for specific drivers. FAST_PATH_PORTS is a 32-bit mask.
System Management Features 4.12 New System Parameters 4.12.5 LCKMGR_MODE (Alpha) The LCKMGR_MODE parameter controls usage of the Dedicated CPU Lock Manager. Setting LCKMGR_MODE to a number greater than zero (0) indicates the number of CPUs that must be active before the Dedicated CPU Lock Manager is turned on. The Dedicated CPU Lock Manager performs all locking operations on a single dedicated CPU. This can improve system performance on large SMP systems with high MP_Synch associated with the lock manager.
System Management Features 4.12 New System Parameters In this case, the OpenVMS system allocates a total of approximately 6,291,456 bytes of nonpaged pool. Of this amount, the system divides 2,097,152 bytes among the RADs that are not the base RAD. The system then assigns the remaining 4,194,304 bytes to the base RAD.1 4.12.8 RAD_SUPPORT (Alpha) RAD_SUPPORT enables RAD-aware code to be executed on systems that support Resource Affinity Domains (RADs); for example, AlphaServer GS160 systems.
System Management Features 4.12 New System Parameters By default VCC_READAHEAD is 1, which means that the Extended File Cache can use read-ahead caching. The Extended File Cache detects when a file is being read sequentially in equal-sized I/Os, and fetches data ahead of the current read, so that the next read instruction can be satisfied from cache. To stop the Extended File Cache from using read-ahead caching, set VCC_READAHEAD to 0.
System Management Features 4.12 New System Parameters WBM_MSG_LOWER is the lower threshold for the number of messages sent during the test interval that initiates single-message mode. In single-message mode, the writes issued by each remote node are, by default, sent one by one in individual SCS messages to the node with the master write bitmap. If the writes sent by a remote node reach an upper threshold of messages during a specified interval, single-message mode switches to buffered-message mode.
System Management Features 4.13 Volume Shadowing for OpenVMS 4.13.1 Minicopy in Compaq Volume Shadowing for OpenVMS (Alpha) The new minicopy feature of Compaq Volume Shadowing for OpenVMS and its enabling technology, write bitmap, are fully implemented on OpenVMS Alpha systems. OpenVMS VAX nodes can write to shadow sets that use this feature but they can neither create master write bitmaps nor manage them with DCL commands. The minicopy operation is a streamlined copy operation.
System Management Features 4.13 Volume Shadowing for OpenVMS For more information about this new feature, including additional memory requirements for this version of Compaq Volume Shadowing for OpenVMS, refer to Volume Shadowing for OpenVMS. 4.13.2 New Volume Shadowing Features for Multiple-Site OpenVMS Cluster Systems OpenVMS Version 7.3 introduces new command qualifiers for the DCL commands DISMOUNT and SET for use with Volume Shadowing for OpenVMS.
System Management Features 4.13 Volume Shadowing for OpenVMS The device specified must be a member of a shadow set that is mounted on the node where the command is issued. • /MVTIMEOUT=yyyyyy DSAnnnn: Specifies the mount verification timeout value to be used for this shadow set, specified by its virtual unit name, DSAnnnn. The value supplied by this qualifier overrides the SYSGEN parameter MVTIMEOUT for this specific shadow set. The valid range for yyyyyy is 1 to 16,777,215 seconds.
System Management Features 4.13 Volume Shadowing for OpenVMS This qualifier indicates to the shadowing driver the site location of the shadow set member or of the shadow set (represented by its virtual unit name). Prior to using this qualifier, you can define the site location in the SYLOGICALS.COM command procedure to simplify its use. The valid range for nnn is 1 through 255.
System Management Features 4.13 Volume Shadowing for OpenVMS 4.13.2.1 How to Use the New DISMOUNT and SET Command Qualifiers The diagram in this section depicts a typical multiple-site cluster using Fibre Channel. It is used to illustrate the steps which must be taken to manually recover one site when the site-to-site storage interconnect fails. Note that with current Fibre Channel support, neither site can use the MSCP server to regain a path to the DGA devices.
System Management Features 4.13 Volume Shadowing for OpenVMS On Site A: $ DISMOUNT /FORCE_REMOVAL= $1$DGA2000: Once the command has completed, the shadow set will be available for use only at site A. On Site B: $ SET DEVICE /ABORT_VIRTUAL_UNIT DSA42: Once the command completes, the shadow set status will be MntVerifyTimeout. Next, issue the following command to free up the shadow set: $ DISMOUNT/ABORT DSA42: These steps must be taken for all affected multiple-site shadow sets. 4.13.
5 Programming Features This chapter describes new features relating to application and system programming on this version of the Compaq OpenVMS operating system. 5.1 3D Graphics Support The PowerStorm 300 (PBXGD-AD) and PowerStorm 350 (PBXGD-AE) graphics cards are now supported on Alpha-based systems. The OpenGL 3D graphics API is now provided as part of the OpenVMS base operating system. The version of OpenGL supported on the PowerStorm 300 and PowerStorm 350 graphics cards is Version 1.1.
Programming Features 5.2 3X-DAPBA-FA and 3X-DAPCA-FA ATM LAN Adapters (Alpha) 5.2 3X-DAPBA-FA and 3X-DAPCA-FA ATM LAN Adapters (Alpha) The 3X-DAPBA-FA (HE155) and 3X-DAPCA-FA (HE622) are PCI based ATM LAN adapters for Alpha based systems that provide high performance PCI-toATM capability. The 3X-DAPBA-FA adapter offers a 155 Mbps fiber connection; the 3X-DAPCA-FA adapter offers a 622 Mbps fiber connection. The datalink drivers for these adapters function in a new OpenVMS ATM environment.
Programming Features 5.4 Compaq C Run-Time Library Enhancements With OpenVMS Version 7.3, XPG5-compliant strptime becomes a default strptime function in the Compaq C RTL. However, the previous nonpivoting XPG4-compliant strptime function is retained for compatibility. The pivoting is controlled by the DECC$XPG4_STRPTIME logical name. To use the nonpivoting version of strptime, either: • Define DECC$XPG4_STRPTIME to any value before invoking the application.
Programming Features 5.4 Compaq C Run-Time Library Enhancements All C RTL functions that accept or report full file specifications will process file specifications up to 4095 bytes long, subject to the rules defined for the media format. For file specifications in OpenVMS format, there are no special restrictions. In situations where a full file specification cannot be reported because the buffer is too short, the function attempts to report the abbreviated name.
Programming Features 5.4 Compaq C Run-Time Library Enhancements 5.4.6 Alternate Way of Translating UNIX File Specifications The Compaq C RTL was enhanced to allow interpreting the leading part of a UNIX-style file specification as either a subdirectory name or a device name. The default translation of a "foo/bar" UNIX-style name to a "foo:bar" VMS-style name remains the default. To translate a "foo/bar" UNIX-style name to a "[.
Programming Features 5.6 Large Page-File Sections (Alpha) $ SHOW MEMORY/FILES System Memory Resources on 22-MAY-2000 19:04:19.67 Swap File Usage (8KB pages): Index ! Free Size DISK$ALPHASYS:[SYS48.SYSEXE]SWAPFILE.SYS 1 904 904 2 1048 1048 1952 Index " Free Size 253 16888 16888 254 16888 16888 DISK$SWAP:[SYS48.SYSEXE]SWAPFILE.SYS;1 Total size of all swap files: Paging File Usage (8KB pages): DISK$PAGE:[SYS48.SYSEXE]PAGEFILE.SYS;1 DISK$ALPHASYS:[SYS48.SYSEXE]PAGEFILE.
Programming Features 5.7 Multipath System Services • SET DEVICE device-name/PATH=path-description-string/[NO]ENABLE • SHOW DEVICE/MULTIPATH device-name In OpenVMS Version 7.3, the capability to return path information and allow you to enable, disable, and switch specific I/O paths to any device is now implemented in the following new system services: • SYS$DEVICE_PATH_SCAN This service returns path information for a given Multipath I/O device.
Programming Features 5.9 Performance Application Programming Interface (API) 5.9 Performance Application Programming Interface (API) The Performance Application Programming Interface (API) provides a documented functional interface—the $GETRMI system service—that allows performance software engineers to access a predefined list of performance data items. For more information about $GETRMI, refer to the OpenVMS System Services Manual. 5.
Programming Features 5.11 New Process Dump Tools (Alpha) 5.11.1 DCL ANALYZE/PROCESS_DUMP Command The DCL ANALYZE/PROCESS_DUMP command invokes the OpenVMS debugger to analyze a process dump, giving you access to debugger commands for your analysis. In OpenVMS Version 7.3, most of the old DCL ANALYZE/PROCESS_ DUMP qualifiers have no effect. Only the /FULL and /IMAGE qualifiers are still valid. Both these qualifiers are still optional.
Programming Features 5.11 New Process Dump Tools (Alpha) 5.11.4 Analyzing Process Dumps on Different Systems You can analyze a process dump file on a system different from the one on which it was generated. However, if there is a base image link date/time mismatch between the generating system and analyzing system, you must copy SYS$BASE_ IMAGE.EXE from the generating system and point to it with the SDA$READ_ DIR logical name. For example: $ COPY other_node::SYS$LOADABLE_IMAGES:SYS$BASE_IMAGE.
Programming Features 5.11 New Process Dump Tools (Alpha) 5.11.6.1 Special Rights Identifiers You can use the new rights identifier IMGDMP$READALL to allow a nonprivileged user to read a complete process dump. You can use the new rights identifier IMGDMP$PROTECT to protect a complete process dump from being read by the user that created the process dump. These rights identifiers are created during the installation of OpenVMS Version 7.3 by the image SYS$SYSTEM:IMGDMP_RIGHTS.
Programming Features 5.11 New Process Dump Tools (Alpha) 2. Create a protected directory with rights identifier IMGDMP$PROTECT. For example: $ CREATE /DIRECTORY DKA300:[PROCDUMPS] /PROTECTION=(S:RWE,O:RWE,G,W) /OWNER_UIC=IMGDMP$PROTECT $ SET SECURITY DKA300:[000000]PROCDUMPS.DIR /ACL=((DEFAULT_PROTECTION,SYSTEM:RWED,OWNER:RWED,GROUP:,WORLD:), (IDENTIFIER=IMGDMP$PROTECT,ACCESS=READ+WRITE), (IDENTIFIER=IMGDMP$PROTECT,OPTIONS=DEFAULT, ACCESS=READ+WRITE+EXECUTE+DELETE+CONTROL), (CREATOR,ACCESS=NONE)) 3.
Programming Features 5.12 RMS Locking Enhancements • Caches the read-mode lock as a system lock, which is retained over accesses and only lowered to null when the lock is blocking an exclusive write request. This functionality significantly reduces both local and remote lock request traffic (the number of $ENQ and $DEQ system service calls) as well as associated IPL-8 spinlock activity and System Communications Services (SCS) messages for a cluster.
Programming Features 5.12 RMS Locking Enhancements an RMS$_RLK status. Otherwise, the record is returned with one of the following statuses: • RMS$_SUC — No other writers • RMS$_OK_RLK — Record can be read but not written • RMS$_OK_RRL — Exclusive lock is held (lock request denied) but the readregardless (RAB$V_RRL) option is set When only the RAB$V_NLK option is specified, record access can be denied.
Programming Features 5.12 RMS Locking Enhancements Table 5–2 (Cont.) Methods Available for Specifying No Query Record Locking To... Use This Method... Enable no query record locking on a per-record read operation. Set the RAB$V_NQL option in the RAB$W_ROP_2 field. Enable no query record locking at the file level.
Programming Features 5.12 RMS Locking Enhancements With this release, you can optionally request that RMS set these flags in record lock requests by setting the corresponding options RAB$V_NODLCKWT and RAB$V_NODLCKBLK in the new RAB$W_ROP_2 field. For more information about using these options, refer to the flag information in the $ENQ section of the OpenVMS System Services Reference Manual: A–GETUAI. 5.13 OpenVMS Registry Beginning in OpenVMS Version 7.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers 5.14 Alpha SDA Commands, Parameters, and Qualifiers The OpenVMS Version 7.3 software release offers a number of new Alpha SDA commands, parameters, and qualifiers. OpenVMS Version 7.3 also offers many new parameters and qualifiers for existing commands. For more detailed information, refer to the OpenVMS Alpha System Analysis Tools Manual. 5.14.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers Qualifier Meaning /COUNT=[{ALL | records}] Gives the number of records to be displayed. The default is to display all records. /DECIMAL Outputs data as decimal values. /FORWARD Causes SDA to display the records in the history buffer in ascending address order. This is the default. /HEXADECIMAL Outputs data as hexadecimal values. This is the default.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers 5.14.1.3 SHOW MEMORY The SHOW MEMORY command displays the availability and usage of those memory resources that are related to memory. There are no parameters for this command.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers The following shows the parameter for the SHOW RAD command: Parameter Meaning number Displays information on CPUs and memory for the specified RAD The following shows the qualifier for the SHOW RAD command: Qualifier Meaning /ALL Displays settings of the RAD_SUPPORT parameter fields and the CPU and memory assignments for all RADs 5.14.1.5 SHOW TQE The SHOW TQE command displays the entries in the Timer Queue.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers 5.14.2.1 REPEAT The REPEAT command has the following new parameter: Parameter Meaning count The number of times the previous command is to be repeated. The default is a single repeat. The REPEAT command has the following new qualifier: Qualifier Meaning /UNTIL=condition Defines a condition that terminates the REPEAT command. By default, there is no terminating condition. 5.14.2.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers 5.14.2.5 SHOW DEVICE The SHOW DEVICE command has the following new qualifiers: Qualifier Meaning /CDT=address Identifies the device by the address of its Connector Descriptor Table (CDT). This applies to cluster port devices only. /PDT Displays the Memory Channel Port Descriptor Table. This qualifier is ignored for devices other than memory channel. /UCB=ucbaddress This is a synonym for /ADDRESS=ucb-address. 5.14.2.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers Qualifier Meaning /BRIEF Displays only general information about pool and its addresses. /CHECK Checks all free packets for POOLCHECK-style corruption, in exactly the same way that the system does when generating a POOLCHECK crashdump. /MAXIMUM_BYTES [=n] Displays only the first n bytes of a pool packet; default is 64 bytes. /STATISTICS [= ALL] Displays usage statistics about each lookaside list and the variable free list.
Programming Features 5.14 Alpha SDA Commands, Parameters, and Qualifiers 5.14.2.11 SHOW RESOURCE The SHOW RESOURCE command has the following new qualifier: Qualifier Meaning /OWNED Causes SDA to only display owned resources 5.14.2.12 SHOW SPINLOCKS The SHOW SPINLOCKS command has the following new qualifier: Qualifier Meaning /COUNTS Produces a display of Acquire, Spin, and Wait counts for each spinlock 5.14.2.
Programming Features 5.15 New SDA Commands for the Spinlock Tracing Utility 5.15.3 SPL SHOW TRACE This command displays spinlock tracing information. Table 5–3 shows the qualifiers for this command. Table 5–3 Qualifiers for the SPL SHOW TRACE Command Qualifier Meaning /SPINLOCK=spinlock Specifies the display of a specific spinlock, for example, /SPINLOCK=LCKMGR or /SPINLOCK=SCHED. /NOSPINLOCK Specifies that no spinlock trace information be displayed.
Programming Features 5.15 New SDA Commands for the Spinlock Tracing Utility 5.15.5 SPL START TRACE This command enables spinlock tracing. Table 5–5 shows the qualifiers for this command. Table 5–5 Qualifiers for the SPL START TRACE Command Qualifier Meaning /SPINLOCK=spinlock Specifies the tracing of a specific spinlock. /NOSPINLOCK Disables spinlock tracing and does not collect any spinlock data. If omitted, all spinlocks are traced.
Programming Features 5.16 System Services 5.16 System Services The following table describes new and updated system services for OpenVMS Version 7.3. For additional information, refer to the OpenVMS System Services Reference Manual. System Service Documentation Update $CHECK_PRIVILEGES The description of the ’prvadr’ argument has been updated. $CLRAST This service has been documented for Version 7.3. $DCLEXH The description has been updated, and a BASIC example has been added.
Programming Features 5.16 System Services System Service Documentation Update $PROCESS_SCAN The following item codes have been added for Multithreads support: PSCAN$_KT_COUNT and PSCAN$_ MULTITHREAD. $REGISTRY This service is now documented in the OpenVMS System Services Reference Manual: GETUTC–Z and online help. $SCAN_INTRUSION This service has been updated in support of Clusterwide Intrusion. $SCHED The condition value, SS$_INCLASS, has been added, and SS$_ILLSER has been deleted.
Programming Features 5.17 TCP/IP Files for SDA READ Command That Contain Global Symbols and Locations Table 5–7 Modules Defining Global Locations Within the Executive Image File Contents TCPIP$BGDRIVER.STB TCP/IP Internet driver TCPIP$INETACP.STB TCP/IP Internet ACP TCPIP$INTERNET_SERVICES.STB TCP/IP Internet execlet TCPIP$NFS_SERVICES.STB Symbols for the TCP/IP NFS server TCPIP$PROXY_SERVICES.STB Symbols for the TCP/IP proxy execlet TCPIP$PWIPACP.STB TCP/IP PWIP ACP TCPIP$PWIPDRIVER.
Programming Features 5.18 Visual Threads Version 2.1 (Alpha) • Find and Filter support in the Event Window to allow you to quickly locate particular events. • CPU Utilization Window shows the CPU percentage used by each thread. • Thread Transitions Window depicts each state change for a detailed view.
6 Associated Products Features This chapter describes significant new features of Compaq OpenVMS operating system associated products. For a listing and directory information on the OpenVMS associated products, refer to the Guide to OpenVMS Version 7.3 CD-ROMs. 6.1 Availability Manager OpenVMS Version 7.3 contains Availability Manager Version 1.4. Soon after the release of OpenVMS Version 7.3, Availability Manager Version 2.0 will be announced on the following Availability Manager web site: http://www.
Associated Products Features 6.2 Compaq Advanced Server V7.3 for OpenVMS (Alpha) 6.2 Compaq Advanced Server V7.3 for OpenVMS (Alpha) The Compaq Advanced Server Version 7.3 for OpenVMS is supported on Alpha systems only, and is the only version of the Advanced Server for OpenVMS supported on OpenVMS Alpha Version 7.3.
Associated Products Features 6.4 Compaq DCE for OpenVMS 6.4 Compaq DCE for OpenVMS This section describes the enhancements in Compaq Distributed Computing Environment (DCE) for OpenVMS Version 7.3. 6.4.1 Compaq DCE Remote Procedure Call (RPC) Beginning with OpenVMS Version 7.2-1, the NT Lan Manager security in DCE RPC is fully functional. 6.4.
Associated Products Features 6.5 DECram for OpenVMS Version 3.0 (Alpha) • Multiple DECram devices can be members of a Volume Shadowing for OpenVMS shadow set and can be served by Mass Storage Control Protocol (MSCP) or QIO served. • Volume Shadowing for OpenVMS will support shadow sets composed of DECram devices and other disk class devices. • A new DECram command interface (DECRAM>) can be used for creating, initializing, and mounting DECram disks. DECram Version 3.
Associated Products Features 6.6 Enterprise Capacity and Performance (ECP) the I/O. ECP Analyzer for OpenVMS provides both graphic (MOTIF-based) and tabular reports for the data. 6.7 Kerberos for OpenVMS Kerberos Version 1.0 for OpenVMS Alpha and OpenVMS VAX, based on MIT Kerberos Version 5 Release 1.0.5, is included on the OpenVMS Version 7.3 distribution media. (Kerberos documentation provided by MIT is included on the OpenVMS documentation CD-ROM in HTML format.
Associated Products Features 6.8 Universal LDAPv3 API (Alpha) The universal LDAPv3 API is certified with Microsoft’s Active Directory, Novell’s NDS and Compaq’s X.500 Version 4.0, and supports various security mechanisms including Kerberos V5 and Public Key Infrastructure (PKI). The LDAPv3 kits are available from the following World Wide Web address: http://www.openvms.compaq.com/openvms/products/mgmt_agents/index.
Associated Products Features 6.11 Compaq TCP/IP Services for OpenVMS Version 5.1 6.11 Compaq TCP/IP Services for OpenVMS Version 5.1 The Compaq TCP/IP Services for OpenVMS product is the Compaq implementation of the TCP/IP protocol suite and internet services for OpenVMS Alpha and OpenVMS VAX systems. TCP/IP Services provides a comprehensive suite of functions and applications that support industry-standard protocols for heterogeneous network communications and resource sharing. 6.11.
Associated Products Features 6.11 Compaq TCP/IP Services for OpenVMS Version 5.1 6.11.2 TCP/IP Services for OpenVMS Documentation For installation instructions, refer to the Compaq TCP/IP Services for OpenVMS Installation and Configuration manual. The TCP/IP Services for OpenVMS Release Notes provide version-specific information that supersedes the information in the documentation set. The features, restrictions, and corrections in this version of the software are described in the release notes.
Part II Overview of OpenVMS Documentation
7 OpenVMS Documentation Overview This chapter outlines the changes to the OpenVMS documentation from the previous version. 7.1 OpenVMS Documentation Changes Table 7–1 lists the changes to the OpenVMS documentation for OpenVMS Version 7.3. Table 7–1 Changes to Documentation for OpenVMS Version 7.3 Area of Change Description Expanded Online Offerings Documentation CD-ROM The OpenVMS documentation is now available on a single ISO9660 Level 2 CD-ROM.
OpenVMS Documentation Overview 7.1 OpenVMS Documentation Changes Table 7–1 (Cont.) Changes to Documentation for OpenVMS Version 7.3 Area of Change Description Expanded Online Offerings Master Index The OpenVMS Master Index manual in ASCII text format is now included on the documentation CD-ROM. New Manual Availability Manager User’s Guide This new manual for Version 7.
OpenVMS Documentation Overview 7.1 OpenVMS Documentation Changes Table 7–1 (Cont.) Changes to Documentation for OpenVMS Version 7.3 Area of Change Description Restructured Documentation OpenVMS Programming Concepts Manual The OpenVMS Programming Concepts Manual has been restructured and expanded.
8 OpenVMS Printed and Online Documentation This chapter outlines the following OpenVMS documentation components: • Printed documentation (Section 8.1) • Online documentation on CD-ROM (Section 8.2) • Online documentation on the OpenVMS web site (Section 8.3) • Online Help (Section 8.4) 8.1 Printed Documentation This section describes the OpenVMS printed documentation offerings: • Upgrade and installation documentation that is included with your OpenVMS software media kit (Section 8.1.
OpenVMS Printed and Online Documentation 8.1 Printed Documentation Table 8–1 (Cont.) OpenVMS Media Kit Manuals Manual Order Number Upgrade and Installation Manuals OpenVMS License Management Utility Manual AA-PVXUF-TK Guide to OpenVMS Version 7.3 CD–ROMs AA-QSBRE-TE 8.1.
OpenVMS Printed and Online Documentation 8.1 Printed Documentation Table 8–2 (Cont.) OpenVMS Full Documentation Set (QA-001AA-GZ.7.3) Manual Order Number Continuation of Full Documentation Set QA-001AA-GZ.7.
OpenVMS Printed and Online Documentation 8.1 Printed Documentation Table 8–2 (Cont.) OpenVMS Full Documentation Set (QA-001AA-GZ.7.3) Manual Order Number Continuation of Full Documentation Set QA-001AA-GZ.7.3 OpenVMS VAX RTL Mathematics (MTH$) Manual AA-PVXJD-TE OpenVMS VAX System Dump Analyzer Utility Manual AA-PV6TD-TE POLYCENTER Software Installation Utility Developer’s Guide AA-Q28MD-TK VAX MACRO and Instruction Set Reference Manual AA-PS6GD-TE Volume Shadowing for OpenVMS AA-PVXMG-TE 8.1.
OpenVMS Printed and Online Documentation 8.2 Online Documentation on CD-ROM 8.2.2 PDF Viewers Tools are supplied on the documentation CD-ROM for viewing PDF files on OpenVMS Alpha systems and Windows systems. For OpenVMS Alpha users, the Adobe Acrobat Viewer (for Java) is provided. Instructions for installing this Java implementation of the Acrobat Viewer are provided in a README file on the CD-ROM. For users of Windows systems, an executable file for the Adobe Acrobat Viewer is provided.
9 Descriptions of OpenVMS Manuals This chapter provides summary descriptions for the following OpenVMS documentation: • Manuals in the OpenVMS Media Kit (Section 9.1) • Manuals in the OpenVMS Full Documentation set (Section 9.2) • Manual about how to write device drivers for OpenVMS Alpha systems (Section 9.3) • RMS Journaling manual (Section 9.4) • Archived manuals (Section 9.5) 9.1 Manuals Included in the OpenVMS Media Kit Guide to OpenVMS Version 7.
Descriptions of OpenVMS Manuals 9.2 Manuals in the OpenVMS Documentation Set OpenVMS Guide to System Security Describes the security features available in the OpenVMS Alpha and VAX operating systems. Explains the purpose and proper application of each feature in the context of specific security needs. OpenVMS Master Index Offers an edited compilation of indexes from the manuals in the OpenVMS Full Documentation set.
Descriptions of OpenVMS Manuals 9.2 Manuals in the OpenVMS Documentation Set Compaq C Run-Time Library Utilities Reference Manual Provides detailed usage and reference information about the Compaq C Run-Time Library utilities for managing localization and time zone data in international software applications. Compaq Portable Mathematics Library Documents the mathematics routines in the Compaq Portable Mathematics Library (DPML), supplied only with OpenVMS Alpha systems.
Descriptions of OpenVMS Manuals 9.2 Manuals in the OpenVMS Documentation Set OpenVMS Alpha Partitioning and Galaxy Guide Provides complete details about how to use all of the OpenVMS Galaxy features and capabilities available in OpenVMS Alpha Version 7.3. Includes procedures for creating, managing, and using OpenVMS Galaxy computing environments on AlphaServer 8400, 8200, and 4100 systems. OpenVMS Alpha Guide to Upgrading Privileged-Code Applications Explains the OpenVMS Alpha Version 7.
Descriptions of OpenVMS Manuals 9.2 Manuals in the OpenVMS Documentation Set OpenVMS I/O User’s Reference Manual Contains the information that system programmers need to program I/O operations using the device drivers that are supplied with the operating system. OpenVMS Linker Utility Manual Describes how to use the Linker utility to create images that run on OpenVMS systems. Also explains how to control a link operation with link qualifiers and link options.
Descriptions of OpenVMS Manuals 9.2 Manuals in the OpenVMS Documentation Set OpenVMS RTL Screen Management (SMG$) Manual Documents the screen management routines contained in the SMG$ facility of the OpenVMS Run-Time Library. Indicates which routines are specific to Alpha or VAX, as well as how routines function differently on each system. OpenVMS RTL String Manipulation (STR$) Manual Documents the string manipulation routines contained in the STR$ facility of the OpenVMS Run-Time Library.
Descriptions of OpenVMS Manuals 9.3 OpenVMS Alpha Device Driver Manual 9.3 OpenVMS Alpha Device Driver Manual Writing OpenVMS Alpha Device Drivers in C Provides definitive information about writing device drivers in the C programming language for devices connected to Alpha processors. Writing OpenVMS Alpha Device Drivers in C is available from Digital Press. For more information, access the following web site: http://www.bh.com/digitalpress 9.
Descriptions of OpenVMS Manuals 9.5 Archived Manuals Table 9–1 (Cont.
Descriptions of OpenVMS Manuals 9.
Descriptions of OpenVMS Manuals 9.5 Archived Manuals Guide to OpenVMS Performance Management Introduces and explains the techniques used to optimize performance on an OpenVMS VAX system. Migrating an Application from OpenVMS VAX to OpenVMS Alpha Describes how to create an OpenVMS Alpha version of an OpenVMS VAX application. Provides an overview of the VAX to Alpha migration process and information to help you plan a migration.
Descriptions of OpenVMS Manuals 9.5 Archived Manuals OpenVMS AXP Device Support: Reference Provides the reference material for the Writing OpenVMS Alpha Device Drivers in C by describing the data structures, macros, and routines used in device-driver programming. OpenVMS Bad Block Locator Utility Manual Describes how to use the Bad Block Locator utility to locate bad blocks on older types of media.
Descriptions of OpenVMS Manuals 9.5 Archived Manuals OpenVMS RTL Parallel Processing (PPL$) Manual Documents the parallel-processing routines contained in the PPL$ facility of the OpenVMS Run-Time Library. Indicates which routines are specific to Alpha or VAX, as well as how routines function differently on each system. OpenVMS Software Overview Provides an overview of the OpenVMS operating system and some of its available products.
Index A Advanced Server for OpenVMS, 6–2 ANALYZE/PROCESS_DUMP command, 5–9 ATM cluster interconnect, 4–10 Attunity Connect "On Platform" Package, 2–3 Availability Manager, 6–1 B Backup using Volume Shadowing for OpenVMS, 4–20 64-bit addresses support for, 5–5 C Case preservation in file names, C RTL, 5–3 Class scheduler CPU scheduling, 4–2 Cluster interconnects LANs as cluster interconects, 4–11 Clusterwide intrusion detection, 4–8 Compaq 3X-DAPBA-FA adapter, 5–2 Compaq 3X-DAPCA-FA adapter, 5–2 Compaq Ana
DCL lexical F$GETDVI, 3–3 F$GETJPI, 3–3 F$GETQUI, 3–3 F$GETSYI, 3–3 Debugger multiprocess functionality, 5–7 DECevent, 6–6 Dedicated CPU Lock Manager, 4–4 enabling, 4–4 implementing, 4–4 setting affinity, 4–5 supporting fast path devices, 4–5 DISMOUNT/FORCE_REMOVAL command, 4–21 DSGGB-AA switch, 4–9 DSGGB-AB switch, 4–9 DUMP command, 5–17 Dump files analyzing, 5–8 on different systems, 5–10 forcing, 5–10 E ECP Collector, 6–4 ECP Performance Analyzer, 6–4 Enterprise Capacity and Performance (ECP), 6–4 /ERAS
OpenVMS e-Business, 1–3, 2–1 OpenVMS Enterprise Directory for e-Business LDAP, 4–6 X.
SHOW RAD command, 5–19 SHOW RESOURCE command /OWNED qualifier, 5–24 SHOW SPINLOCKS command /COUNTS qualifier, 5–24 SHOW SUMMARY command /PROCESS_NAME=process_name qualifier, 5–24 SHOW TQE command, 5–20 strptime function, 5–2 System management features, 1–3 System parameters AUTO_DLIGHT_SAV, 4–15 FAST_PATH_PORTS, 4–15 LCKMGR_CPUID, 4–15 LCKMGR_MODE, 4–16 NPAGECALC, 4–16 NPAGERAD, 4–16 SHADOW_MAX_UNIT, 4–17 VCC_MAX_IO_SIZE, 4–17 VCC_READAHEAD, 4–17 WBM_MSG_INT, 4–18 WBM_MSG_LOWER, 4–18 WBM_MSG_UPPER, 4–19 WBM