HP OpenVMS Systems Documentation
OpenVMS Version 7.3
$ DEFINE/SYSTEM/EXEC ZKO 1 $ DEFINE/SYSTEM/EXEC LKG 2 $! $! At the ZKO site ... $ MOUNT/SYSTEM DSA0/SHAD=($1$DGA0:,$1$DGA1:) TEST $ SET DEVICE/SITE=ZKO DSA0: $! $! At the LKG site ... $ MOUNT/SYSTEM DSA0/SHAD=($1$DGA0,$1$DGA1) TEST $ SET DEVICE/SITE=LKG DSA0: $! $! At both sites, the following would be used: $ SET DEVICE/SITE=ZKO $1$DGA0: $ SET DEVICE/SITE=LKG $1$DGA1:
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.
To prevent the shadowing driver from automatically recovering shadow sets from connection-related failures, three steps must be taken prior to any failure:
$ SET DEVICE /MEMBER_TIMEOUT= x ddcu:
$ SET DEVICE /MVTIMEOUT = y DSAnnnn
In the following diagram, shadow set DSA42 is made up of $1$DGA1000 and $1$DGA2000
<><><><><><><><><><><> LAN <><><><><><><><><><><> Site A Site B | | F.C. SWITCH <><><><> XYZZY <><><><> F.C. SWITCH | | HSG80 <><> HSG80 HSG80 <><> HSG80 | | $1$DGA1000 --------- DSA42 --------- $1$DGA2000
This diagram illustrates that systems at Site A or Site B have direct access to all devices at both sites via Fibre Channel connections. XYZZY is a theoretical point between the two sites. If the Fibre Channel connection were to break at this point, each site could access different "local" members of DSA42 without error. For the purpose of this example, Site A will be the sole site chosen to retain access to the shadow set.
The following actions must be taken to recover the shadow set at Site A.
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.3 Using INITIALIZE/SHADOW/ERASE to Streamline the Formation of a Shadow Set
The new /SHADOW qualifier to the DCL INITIALIZE command is available. The use of the INITIALIZE /SHADOW command to initialize multiple members of a future shadow set eliminates the requirement for a full copy operation when you later create a shadow set.
Compaq strongly recommends that you also specify the /ERASE qualifier with the INITIALIZE/SHADOW command when initializing multiple members of a future shadow set. Whereas the /SHADOW qualifier eliminates the need for a full copy operation when you later create a shadow set, the /ERASE qualifier reduces the amount of time a full merge will take.
If you omit the /ERASE qualifier, and a merge operation of the shadow set is subsequently required (because a system on which the shadow set is mounted fails), the resulting merge operation will take much longer to complete.
The INITIALIZE command with the /SHADOW and /ERASE qualifiers performs the following operations:
You can then mount up to three of the devices that you have initialized in this way as members of a new host-based shadow set.
For more information, refer to Volume Shadowing for OpenVMS.
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.
The implementation of OpenGL Version 1.1 for the PowerStorm 300 or PowerStorm 350 is designed to coexist with installations of the Open3D layered product for older graphics cards. The images shipped with OpenVMS are named DECW$OPENGLSHR_V11 and DECW$OPENGLUSHR_V11. The _V11 suffix is used to distinguish the OpenGL Version 1.1 images from the OpenGL Version 1.0 images shipped with Open3D (DECW$OPENGLSHR and DECW$OPENGLUSHR).
Applications using only OpenGL V1.0 features may be linked against either the Open3D images or the new Version 1.1 images. Applications using OpenGL Version 1.1 features should be linked explicitly against the Version 1.1 images.
For further information on OpenGL support for the PowerStorm 300 and PowerStorm 350, refer to the PowerStorm 300/350 Installation Guide and Release Notes documentation shipped with the graphics card.
If 3D graphics will be used extensively, particularly in an environment using multiple PowerStorm 300 and PowerStorm P350s in a single system, read and strictly observe the guidelines for setting SYSGEN parameters and account quotas contained in the PowerStorm 300/350 OpenVMS Graphics Support Release Notes Version 1.1 and the Compaq PowerStorm 300/350 Graphics Controllers Installation Guide shipped with the graphics card. The Release notes can also be accessed on the OpenVMS Documentation CD-ROM in the following directory:
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-to-ATM 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. The new OpenVMS ATM environment is fully compatible with the existing legacy ATM support and allows both ATM environments to be configured on a single system. Also, the LANCP management interface is the same for both ATM environments.
For additional information about the 3X-DAPBA-FA PCI HE155 ATM and 3X-DAPCA-FA PCI HE622 ATM LAN adapters, refer to the following URL:
The COBOL RTL for both Alpha and VAX supports five new intrinsic functions with four-digit year formats:
The COBOL RTL for Alpha has improved performance for the DISPLAY statement redirected to a file and for programs compiled with the /MATH=CIT3 and /MATH=CIT4 qualifiers.
This RTL's handling of ON SIZE ERROR is now more compatible with that
of Compaq COBOL for OpenVMS VAX.
5.4 Compaq C Run-Time Library Enhancements
The following sections describe the Compaq C RTL enhancements included
in OpenVMS Version 7.3. For more details, refer to the revision of the
Compaq C RTL Reference Manual that ships with Compaq C Version
6.3 or later.
5.4.1 Strptime Function Is XPG5-Compliant
The strptime function has been modified to be compliant with X/Open CAE Specification System Interfaces and Headers Issue 5 (commonly known as XPG5). The change for XPG5 is in how the strptime function processes the "%y" directive for a two-digit year within the century if no century is specified.
When a century is not otherwise specified, XPG5 requires that values for the "%y" directive in the range 69-99 refer to years in the twentieth century (1969 to 1999 inclusive), while values in the range 00-68 refer to years in the twenty-first century (2000 to 2068 inclusive). Essentially, for the "%y" directive, strptime became a "pivoting" function, with 69 being a pivoting year.
Before this change, the strptime function interpreted a two-digit year with no century as a year within twentieth century.
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:
The Compaq C RTL I/O subsystem was enhanced to remove the restriction
of eight nested directory levels for an ODS-5 device. This affects
Compaq C RTL functions such as
5.4.3 Improved Support for Extended File Specifications (Alpha)
The following sections describe improved Compaq C RTL support for
extended file specifications.
126.96.36.199 Compaq C RTL Supports Case Preservation in File Names
Programs linked against the Compaq C Run-Time Library DECC$SHR can now preserve the case of file names on ODS level 5 disks. This applies when creating or reporting file names. By default, this feature is disabled. To enable this feature, enter the following command:
$ DEFINE DECC$EFS_CASE_PRESERVE ENABLE
If file names are all in uppercase, use the following command to convert the names to lowercase when reporting the name in UNIX style:
$ DEFINE DECC$EFS_CASE_SPECIAL ENABLE
If file names are not all in uppercase, then DEFINE DECC$EFS_CASE_SPECIAL ENABLE preserves case.
The commands to disable the preceding logical-name settings are:
$ DEFINE DECC$EFS_CASE_PRESERVE DISABLE $ DEFINE DECC$EFS_CASE_SPECIAL DISABLE
The setting for the DECC$EFS_CASE_SPECIAL logical name, if not set to DISABLE, supersedes any setting for the DECC$EFS_CASE_PRESERVE logical name.
The DECC$EFS_CASE_PRESERVE and DECC$EFS_CASE_SPECIAL logicals are
checked only once per image activation, not on a file-by-file basis.
188.8.131.52 Most C RTL Functions Now Accept Long OpenVMS File Names As Arguments (Alpha)
For OpenVMS Alpha Version 7.2, some basic Compaq C RTL I/O functions ( creat , stat , and the functions from the open family of functions) were enhanced to accept long OpenVMS-style file names for an ODS-5 device.
For OpenVMS Alpha Version 7.3, all other Compaq C RTL functions, except chdir and the functions from the exec family of functions, were also enhanced to accept long OpenVMS-style file names for an ODS-5 device.
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.
UNIX file names have the following restrictions:
Nonquoted command-line arguments passed to C and C++ programs (argv arguments) can now optionally have their case preserved, rather than being lowercased as in previous versions.
By default, this feature is disabled.
To enable this case preservation feature, define the logical name DECC$ARGV_PARSE_STYLE to "ENABLE" and set the process-level DCL parse style flag to "EXTENDED" in the process running the program:
$ DEFINE DECC$ARGV_PARSE_STYLE ENABLE $ SET PROCESS/PARSE_STYLE=EXTENDED
Enabling this feature also ensures that the image name returned in argv is also case-preserved.
To disable this feature, use any one of the following commands:
$ SET PROCESS/PARSE_STYLE=TRADITIONAL
$ DEFINE/SYSTEM DECC$ARGV_PARSE_STYLE DISABLE
$ DEASSIGN DECC$ARGV_PARSE_STYLE
The value of the DECC$ARGV_PARSE_STYLE logical is case-insensitive.
5.4.5 Compaq C RTL Can Implicitly Open Files for Shared Access
The Compaq C RTL was enhanced to open all files for shared access as if the "shr=del,get,put,upd" option was specified in the open* or creat call.
To enable this feature, define the logical name DECC$FILE_SHARING to the value "ENABLE". The value is case-insensitive.
DECC$FILE_SHARING is checked only once per image activation, not on a
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 "[.foo]bar" VMS-style name, define the logical name DECC$DISABLE_TO_VMS_LOGNAME_TRANSLATION to ENABLE.
DECC$DISABLE_TO_VMS_LOGNAME_TRANSLATION is checked only once per image
activation, not on a file-by-file basis.
5.4.7 New Functions
The Compaq C RTL has added the following functions in OpenVMS Version 7.3:
fchown link utime utimes writev
Support has been added to OpenVMS Alpha to allow Fortran developers to use static data in 64-bit address space.
For more information about how to use this feature, refer to the
5.6 Large Page-File Sections (Alpha)
Page-file sections are used to store temporary data in private or global (shared) sections of memory. In previous releases of OpenVMS Alpha, the maximum amount of data that could be backed up to page files was 32 GB per process (4 process page files, each 8 GB) and 504 GB per system (63 page files, each 8 GB).
With OpenVMS Alpha Version 7.3, the previous limits for page-file sections were 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.
With the new design, if a process requires additional page-file space, page files can be allocated dynamically. Space is no longer reserved in a distinct page file, and pages are no longer bound to an initially assigned page file. Instead, if modified pages must be written back, they are written to the best available page file.
Each page or swap file can hold approximately 16 million pages (128 GB), and up to 254 page or swap files can be installed. Files larger than 128 GB are installed as multiple files.
Note the following DCL command display changes and system parameter changes as a result of the larger page-file section design:
$ SHOW MEMORY/FILES System Memory Resources on 22-MAY-2000 19:04:19.67 Swap File Usage (8KB pages): Index (1) Free Size DISK$ALPHASYS:[SYS48.SYSEXE]SWAPFILE.SYS 1 904 904 DISK$SWAP:[SYS48.SYSEXE]SWAPFILE.SYS;1 2 1048 1048 Total size of all swap files: 1952 Paging File Usage (8KB pages): Index (2) Free Size DISK$PAGE:[SYS48.SYSEXE]PAGEFILE.SYS;1 253 16888 16888 DISK$ALPHASYS:[SYS48.SYSEXE]PAGEFILE.SYS 254 16888 16888 Total size of all paging files: 33776 Total committed paging file usage: (3) 1964