ECO NUMBER: VAXCLIU03_072 PRODUCT: OpenVMS VAX OPERATING SYSTEM V7.2 UPDATE PRODUCT: OpenVMS VAX OPERATING SYSTEM V7.2 COVER LETTER 1 KIT NAME: VAXCLIU03_072 2 KITS SUPERSEDED BY THIS KIT: VAXCLIU02_072 3 KIT DEPENDENCIES: 3.1 The following remedial kit(s), or later, must be installed BEFORE installation of this, or any required kit: VAXUPDATE01_072 3.2 In order to receive all the corrections listed in this kit, the following remedial kits, or later, should also be installed: VAXRMS01_072 4 KIT DESCRIPTION: 4.1 Version(s) of OpenVMS to which this kit may be applied: OpenVMS VAX V7.2 4.2 Files patched or replaced: o [SYSMSG]CLIUTLMSG.EXE (new image) o [SYSEXE]SET.EXE (new image) o [SYSEXE]SHOW.EXE (new image) o [SYSEXE]SHWCLSTR.EXE (new image) o [SYSEXE]SUBMIT.EXE (new image) o [SYSUPD]SET.CLD (update to DCLTABLES.EXE) -- COVER LETTER -- Page 2 22 January 2002 5 PROBLEMS ADDRESSED IN VAXCLIU03_072 KIT o Very large figures in the read IO count and read hit count fields will cause a SHOW MEM /CACHE /FULL command to show the Read Hit Rate as greater than 100%. Images Affected: - [SYSEXE]SHOW.EXE 6 PROBLEMS ADDRESSED IN VAXCLIU02_072 KIT o $SHOW ERROR/FULL, fails with SYSTEM-F-VASFULL. Images Affected: - [SYSEXE]SHOW.EXE o Images that should have been placed in the [SYSEXE] directory were being placed in the [SYSLIB] directory. Images Affected: - [SYSEXE]SET.EXE - [SYSEXE]SHOW.EXE - [SYSEXE]SHWCLSTR.EXE - [SYSEXE]SUBMIT.EXE 7 PROBLEMS ADDRESSED IN VAXCLIU01_072 KIT o A new /SHARE qualifier has been added to the SET FILE command. This qualifier allows you to enable or disable global buffers or statistics on a file currently being accessed by other users. Only new accessors of the file will acquire the new settings. This qualifier requires SYSPRV (system privilege). The /SHARE qualifier is only valid with the following qualifiers: /[NO]GLOBAL_BUFFER=count/SHARE /[NO]STATISTICS/SHARE If other qualifiers are needed, they must be entered in a -- COVER LETTER -- Page 3 22 January 2002 separate SET FILE command. /[NO]GLOBAL_BUFFER=count/SHARE The /SHARE qualifier can be used to enable or disable global buffers on a file currently being accessed. However, any new global buffer settings will only be applied to new accessors of the file. And if a file is already opened with global buffers, any new number of global buffers will not take effect until the file is closed by all accessors of the file. /[NO]STATISTICS/SHARE The /SHARE qualifier can be used to enable or disable statistics on a file currently being accessed. However, only statistics of new accessors of the file will be measured. EXAMPLE: $ SET FILE/SHARE/GLOBAL_BUFFER=5000/STATISTICS INVENTORY.IDX This example sets 5000 global buffers on the INVENTORY.IDX file and enables statistics. Without the /SHARE qualifier, if the file was open when the SET FILE command was issued, the following error would be returned: SYSTEM-W-ACCONFLICT (file access conflict). The /SHARE qualifier allows the global buffers and statistics to be enabled on an open file. However, these settings only apply to new Images Affected: - [SYSEXE]SET.EXE - [SYSLIB]DCLTABLES.EXE (SET.CLD replaced) o New qualifier /CONTENTION_POLICY added to SET RMS_DEFAULT (and SHOW RMS_DEFAULT display) to address locking fairness issues. The new Alpha global buffer read-mode lock support introduced in V7.2-1H1 is functionally compatible with both VAX and older Alpha releases. Operations in mixed clusters produce correct results. However, there is a locking fairness issue that may arise with mixed cluster operations. In a mixed cluster environment with very high contention for specific buckets, it is possible for accesses to write-shared files on nodes using read-mode bucket locking to dominate access to a bucket. Nodes without this support might be unable to access the bucket for a protracted period of time. It is also possible to observe comparable behavior on all OpenVMS versions when dealing with accesses to write-shared files without global buffers enabled -- even on a standalone system. A similar fairness issue between lock conversions and new lock requests may be observed in which the new lock -- COVER LETTER -- Page 4 22 January 2002 requests may remain ungranted for an extended period of time. This kit provides an interface for RMS support for a new option to improve fairness under high contention conditions for write-shared files. The option is controlled using the /CONTENTION_POLICY qualifier to the DCL command SET RMS_DEFAULT. The option may be set at a process or system level. Since selecting this option may noticeably increase locking overhead and since many applications will never encounter this issue, the default system behavior leaves this option disabled. A future lock management enhancement should make this fairness workaround unnecessary for later releases. The following are valid PROCESS keywords (/SYSTEM not specified) for SET RMS_DEFAULT/CONTENTION_POLICY: NEVER Never use the higher overhead option to improve fairness for any write-shared files accessed by this process; minimal overhead. SOMETIMES Use this option for fairer bucket access (but higher overhead) to any write-shared files with global buffers enabled that are accessed by this process. ALWAYS Use this option for fairer bucket access (but higher overhead) to all write-shared files accessed by this process. The following are valid SYSTEM keywords (/SYSTEM specified): NEVER (Default) Never use the higher overhead option to improve fairness for any write-shared files accessed on the system; minimal overhead. SOMETIMES Use this option for fairer bucket access (but higher overhead) to any write-shared files with global buffers enabled that are accessed on the system. ALWAYS Use this option for fairer bucket access (but higher overhead) to all write-shared files accessed on the system. Images Affected: -- COVER LETTER -- Page 5 22 January 2002 - [SYSEXE]SET.EXE - [SYSEXE]SHOW.EXE - [SYSMSG]CLIUTLMSG.EXE - [SYSLIB]DCLTABLES.EXE (SET.CLD replaced) o When access is attempted on a QUE object to which the subject account does not have the appropriate privilege, the ensuing audit record does not record the access failure. Images Affected: - [SYSEXE]SUBMIT.EXE o A DCL "$ SHOW CLUSTER" command will hang on startup, on cluster-nodes with many SCS-ports (CIPCA, CIXCD, MC:... Pxx0: devices), if the virtual-circuit (PB$ path-block) count exceeds the SCS-node count X 4. An "SCS-node" is defined as any SCS-speaking node, such as HSJxx/HSCxx Storage Controllers, RFxx DSSI disk-controllers, VMS nodes, etc. Images Affected: - [SYSEXE]SHWCLSTR.EXE 8 KIT INSTALLATION RATING: The following kit installation rating, based upon current CLD information, is provided to serve as a guide to which customers should apply this remedial kit. (Reference attached Disclaimer of Warranty and Limitation of Liability Statement) INSTALLATION RATING: INSTALL_1 : To be installed by all customers. 9 INSTALLATION INSTRUCTIONS: Install this kit with the VMSINSTAL utility by logging into the SYSTEM account, and typing the following at the DCL prompt: @SYS$UPDATE:VMSINSTAL VAXCLIU03_072 [location of the saveset] The saveset location may be a tape drive, CD, or a disk directory that contains the kit saveset. -- COVER LETTER -- Page 6 22 January 2002 No reboot is necessary after successful installation of the kit. Copyright (c) Compaq Computer Corporation, 2002 All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. COMPAQ, the Compaq logo, VAX, Alpha, VMS, and OpenVMS are registered in the U.S. Patent and Trademark Office. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided as is without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY THIS PATCH IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED TO THE EXTENT PERMITTED BY APPLICABLE LAW. IN NO EVENT WILL COMPAQ BE LIABLE FOR ANY LOST REVENUE OR PROFIT, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, WITH RESPECT TO ANY PATCH MADE AVAILABLE HERE OR TO THE USE OF SUCH PATCH.