Software Product Description Digital Optical Storage Management Software (OSMS) for OpenVMS VAX and Alpha, Version 3.4 November, 1996 SPD 47.46.05 1 DESCRIPTION The Digital[TM] Optical Storage Management Software (Digital OSMS) for OpenVMS[TM] product provides OpenVMS applications and users the functionality necessary to access an optical disk library (or jukebox) using the conventional device, file, and record access services provided by the OpenVMS Operating System. In most cases, no changes will be required to existing applications that use magnetic disk storage. The OpenVMS VAX[TM] and OpenVMS Alpha version of Digital OSMS provides local or VMScluster[TM] access to rewritable or WORM (Write Once, Read Many) media containing FILES- 11 on-disk structure by way of the RW5xx series of optical libraries. Digital OSMS for OpenVMS Alpha does not support any configuration using WORM media containing the WORMS-11[R] on-disk structure. Pseudo-Device Representation Digital OSMS allows the OpenVMS host to view the optical library as a virtual set of disk devices. This translates to one virtual disk device for each optical disk surface in the library. For example, the Digital RW531 optical library has two single-headed optical disk drives and 32 optical disk cartridge storage slots. Each storage slot holds one optical disk cartridge, so the library has the capacity of 64 optical disk surfaces. The optical library, therefore, appears to applications as 64 virtual disk devices, named JBA0: through JBA63:. The JB devices are not physical devices; they are called pseudo-devices. Excluding those functions that are unique to the optical technology, these pseudo-devices emulate the operation of a conventional OpenVMS magnetic disk. Volume Access 1 Volumes in an optical library used with Digital OSMS are accessed using the same techniques that are used to access conventional OpenVMS disks. The standard OpenVMS INITIALIZE command is used to prepare each side of an optical disk cartridge for use and the standard OpenVMS MOUNT command is used to make the volume known to OpenVMS. WORM volumes can only be "initialized" once, whereas rewritable volumes, like magnetic disks, can be "initialized" multiple times. Once a volume has been mounted, Digital OSMS manages the use of the physical optical disk drives to allow volumes to remain logically mounted regardless of where the volume is in the optical library. File Access Files on volumes under control of Digital OSMS are accessed using the same techniques that are used to access conventional OpenVMS files. Once a volume has been mounted, files may be opened, read, written, and closed using the conventional OpenVMS system services and run-time library functions. WORM volumes use the WORMS-11 file system. Rewritable volumes use the FILES-11 file system. Digital OSMS provides essentially transparent access using standard OpenVMS commands and I/O statements from application programs. Digital OSMS supports all OpenVMS commands and their library routine equivalents, such as, but not limited to: ALLOCATE DEALLOCATE MOUNT APPEND DELETE[2] OPEN BACKUP[1] DIFFERENCE PURGE CLOSE DIRECTORY READ COPY DISMOUNT RENAME CREATE EDIT WRITE CREATE INITIALIZE[3] /DIRECTORY [1] Not all backup options are supported using WORM media. [2] This command can be used with WORM media but will not free up additional disk space as with rewritable media. [3] This command can be used only once with WORM media. 2 2 SYSTEM MANAGEMENT FUNCTIONS The management utility tool, JBUTIL, lets the system manager control the parameters affecting the operation of the optical library. The utility also allows cartridges to be loaded into and removed from the optical library. Once a cartridge has been placed in a storage slot inside the optical library, it will remain associated with the corresponding JBxx: device destination until the cartridge is removed from the optical library using JBUTIL. The ODUTIL utility is provided for analyzing and recovering lost files on WORM media - for VAX systems only. The ODUTIL utility lets the user: o Recover files that have been "lost" on a WORMS-11 optical disk; that is, files that still exist on the disk but are not entered into any directory. o Display the number of allocated blocks in all files currently visible (not deleted) on the disk volume. o Analyze and repair the file structure of a WORMS-11 optical disk by correcting the pointer that describes the next free block to use on the optical disk. o Recreate corrupted directories and restore the required files into the directory. Some of these functions were provided by the ODRECOVER and ODANALYZE utilities in previous releases. 3 HARDWARE REQUIREMENTS The person planning a system configuration must understand the hardware requirements of the complete system. Due to the variety of processors that support OpenVMS and the length of time that some OpenVMS systems have been in service, there exist a huge combination of processor, SCSI adapter/controller, and optical subsystem combinations. Some combinations are not supported. For example, the VAX 6000, 7000, 8000, and 10000 series processors are only supported when the optical library is connected to an HSD or HSJ controller. Alpha Processors Supported 3 ___________________________________________________________ DEC[TM] 2100 Supported Adapters/Controllers A500MP, HSD30, HSJ30, HSJ40, A600MP KFESA, KFESB, KZTSA, KZPAA ___________________________________________________________ DEC 3000 Supported Adapters/Controllers 300, 300L, KZTSA, PMAZB, PMAZC, and 2nd embedded 300LX controller on 400, 500, 600, 700, 800, 900 400, 400S 500, 500S, 500X 600, 600S 700 800, 800S 900 ___________________________________________________________ DEC 4000 Supported Adapters/Controllers 600, 700 HSD30 KFESA, KFESB ___________________________________________________________ DEC 7000 Supported Adapters/Controllers 600 HSD30, HSJ30, HSJ40 KFMSB, KZMSA ___________________________________________________________ DEC 10000 Supported Adapters/Controllers 600 HSD30, HSJ30, HSJ40 KFMSB, KZMSA 4 ___________________________________________________________ AlphaServer[TM] Supported Adapters/Controllers 400 KFESA, KFESB, KZPSA, KZPAA 1000 HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPSA, KZPAA 1000A HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPSA, KZPAA 2000 HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPSA, KZPAA 2100 HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPSA, KZPAA 2100A HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPSA, KZPAA 4100 HSD30, HSJ30, HSJ40, KZPAA 8200 HSD30, HSJ30, HSJ40 KFESA, KFESB, KZPAA 8400 HSD30, HSJ30, HSJ40 KFESA, KFESB, KFMSB, KZPSA, KZPAA ___________________________________________________________ AlphaStation[TM] Supported Adapters/Controllers 200 KFESA, KFESB, KZPSA, KZPAA 250 KFESA, KFESB, KZPSA, KZPAA 255 KFESA, KFESB, KZPSA, KZPAA 400 KFESA, KFESB, KZPSA, KZPAA 500 KFESA, KFESB, KZPSA, KZPAA 600 KFESA, KFESB, KZPSA, KZPAA VAX Processors Supported ___________________________________________________________ VAX 6000 Supported Adapters/Controllers 210, 220, 230, HSD30, HSJ30, HSJ40, KFMSB 240 310, 320, 330, HSD30, HSJ30, HSJ40, KFMSB 340, 360 410, 420, 430, HSD30, HSJ30, HSJ40, KFMSB 440, 450, 460 510, 520, 530, HSD30, HSJ30, HSJ40, KFMSB 540, 550, 560 610, 620, 630, HSD30, HSJ30, HSJ40, KFMSB 640, 650, 660 5 ___________________________________________________________ VAX 7000 Supported Adapters/Controllers 610, 620, 630, HSD30, HSJ30, HSJ40, KFMSB 640, 650, 660 710, 720, 730, HSD30, HSJ30, HSJ40, KFMSB 740, 750, 760 ___________________________________________________________ VAX 10000 Supported Adapters/Controllers 610, 620, 630, HSD30, HSJ30, HSJ40, KFMSB 640, 650, 660 ___________________________________________________________ VAXserver[TM] 6000 Supported Adapters/Controllers 210, 220 HSD30, HSJ30, HSJ40, KFMSB 310, 320 HSD30, HSJ30, HSJ40, KFMSB 410, 420 HSD30, HSJ30, HSJ40, KFMSB 510, 520 HSD30, HSJ30, HSJ40, KFMSB ___________________________________________________________ VAXserver Supported Adapters/Controllers 8200, 8250 HSD30, HSJ30, HSJ40 8300, 8350 HSD30, HSJ30, HSJ40 ___________________________________________________________ VAXserver Supported Adapters/Controllers 8530, 8550 HSD30, HSJ30, HSJ40 8700 HSD30, HSJ30, HSJ40 8800, 8810, HSD30, HSJ30, HSJ40 8820, 8830, 8840 ___________________________________________________________ VAXstation[TM] 3100 Supported Adapters/Controllers 30, 38 uses embedded controllers 40, 48 96 ___________________________________________________________ MicroVAX[TM] 3100 Supported Adapters/Controllers 80 uses embedded controllers Other Hardware Required: Supported Optical Libraries 6 For OpenVMS VAX and OpenVMS Alpha processors, the Digital OSMS for OpenVMS supports the following specific 5.25-inch optical libraries: ___________________________________________________________ 5.25-in. Optical Multifunction Libraries Drives Slots RW504, RW525, 1 16 RW524 RW510, RW530, 2 32 RW531[1] RW532[1] 4 64 RW514, RW534 4 88 RW516, RW536 4 144 RW546 2 16 RW551[1] 2 32 RW552[1] 4 64 RW555 4 128 RW557 6 238 [1] RW531, RW532, RW551, and RW552 libraries are supported only in single picker mode. Disk Space Requirements Blocks[1] Mbytes VAX 15,000 7.7 installation VAX use 4,000 2[2] Alpha 15,000 7.7 installation Alpha use 3,500 1.75[2] [1] 1 block = 512 bytes [2] Digital OSMS uses one cache file per optical storage volume. As a result, volume caching options selected at installation can result in disk requirements ranging from 4 additional blocks to cache one optical disk volume to 15,597,092 additional blocks - the maximum allowable cache for 476 optical disk volumes. 7 These counts refer to the disk space required on the system disk. Additional disk space can be required based on the user's system environment and configuration, as well as the user options selected at installation time. The minimum memory supported is 16 Mbytes for VAX systems and 32 Mbytes for Alpha systems. The use of this software in conjunction with increased memory capability improves performance. The memory size suggested for most typical VAX hardware configurations is at least 32 Mbytes. Processors and Devices Not Supported The following processors, adapters and optical devices are not supported with this release ___________________________________________________________ Unsupported Adapters HSC, KZQSA, PB2HA Processors All VAX 4000 Models All MicroVAX variants using KZQSA host controller All VAXstation 4000 Models VAXserver 400 Model 200, 300, 500 VAXserver 3100 Model 10/10E, 20/20E VAXserver 3300, 3400, 3500, 3600, 3602, 3800, 3900 DEC 2000 Model 300, 500 DEC 10004 Model 200 Optical RV720-ZA, RV30, Cygnet 1602 with 2 LSMI Libraries 4100 drives, Cygnet 1802 with 2 to 5 LSMI 4100 drives, LSMI LF45000 RapidChanger 4 SOFTWARE REQUIREMENTS Operating System o OpenVMS VAX V6.2 o OpenVMS Alpha V6.2, V6.2-1H1, V6.2-1H2, V6.2-1H3 Optional Software o HSJ Family Array Controller V2.7. Refer to SPD 47.26.xx. 8 o HSD30 Array Controller Operating Software (HSOF) V2.7. Refer to SPD 53.53.xx. 5 ORDERING INFORMATION Software Licenses[1] QL-0UMA9-AA OSMS 5.25-in. for max. 16 platters QL-0UBA9-AA OSMS 5.25-in. for max. 32 platters QL-0UCA9-AA OSMS 5.25-in. for max. 88 platters QL-0UEA9-AA OSMS 5.25-in. for max. 144 platters QL-5CGA9-AA OSMS 5.25-in. for max. 238 platters Software Media and Documentation QA-0UBAA-H5 TK50 for OpenVMS VAX[2] QA-0UBAA-H8 CD-ROM for OpenVMS VAX[2] QA-0UBAB-H8 CD-ROM for OpenVMS Alpha[3] Software Documentation QA-0UBAA-GZ Documentation for OpenVMS VAX[4] QA-0UBAB-GZ Documentation for OpenVMS Alpha[4] Software Installation Services QT-0UBA9-I9 For all OSMS licenses Software Product Services [1] Upgrade licenses from 88-144 platters and 144-238 platters are also available. Consult with the local Digital office. [2] This product is also available as part of the OpenVMS VAX Consolidated Software Distribution on CD-ROM. [3] This product is also available as part of the OpenVMS Alpha Consolidated Software Distribution on CD-ROM. [4] The software documentation for the OpenVMS product is available as part of the OpenVMS VAX Online Documentation Library on CD-ROM and the OpenVMS Alpha Consolidated Software Distribution on CD-ROM. 9 ___________________________________________________________ Software Product Services QT-0UMA9-**[5] OSMS 5.25 in. with 16 platter license QT-0UBA9-**[5] OSMS 5.25 in. with 32 platter license QT-0UCA9-**[5] OSMS 5.25 in. with 88 platter license QT-0UEA9-**[5] OSMS 5.25 in. with 144 platter license QT-5CGA9-**[5] OSMS 5.25 in. with 238 platter license [5] **Denotes variant fields. For additional information on available licenses, services, and media, refer to the appropriate price book. 6 SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more information about Digital licensing terms and policies, contact your local Digital office. License Management Facility Support Digital OSMS for OpenVMS supports the OpenVMS License Management Facility. License units for Digital OSMS for OpenVMS VAX and Alpha are allocated to a single 5.25-inch optical library based on the size and slot capacity of the optical library. The license is based on unlimited system use. Upgrade license units for Digital OSMS for OpenVMS VAX and Alpha are used in conjunction with a hardware upgrade of the applicable optical libraries and are added to the original license to provide a total equal to the combined units of the original license plus the upgrade license. For more information on the License Management Facility, refer to the OpenVMS VAX Operating System Software Product Description (SPD 25.01.xx) or the OpenVMS Alpha Operating System Software Product Description (SPD 41.87.xx), or the License Management Facility manual of the appropriate 10 version (VAX or Alpha) of the OpenVMS Operating System documentation sets. 7 CLUSTER ENVIRONMENT Digital OSMS for OpenVMS VAX and OpenVMS Alpha using the RW5xx optical libraries with rewritable or WORM media containing the FILES-11 on-disk structure is supported on local or VMScluster access when installed with a valid and licensed OpenVMS configuration. Digital OSMS for OpenVMS VAX using RW5xx optical libraries with WORM media containing WORMS-11 on-disk structure is supported on a local processor access when installed with a valid and licensed OpenVMS configuration. Digital OSMS on OpenVMS Alpha does not support any configuration using WORM containing the WORMS-11 on-disk structure. OpenVMS cluster configurations are described in the OpenVMS Cluster Software Product Description (SPD 29.78.xx) 8 OpenVMS TAILORING CLASSES The following OpenVMS classes are required for full functionality of Digital OSMS for OpenVMS: o OpenVMS required saveset o Network support o Utilities For more information on OpenVMS classes and tailoring, refer to the OpenVMS VAX Operating System Software Product Description (SPD 25.01.xx) or the OpenVMS Alpha Operating System Software Product Description (SPD 41.87.xx). 11 9 GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. 10 DISTRIBUTION MEDIA OpenVMS VAX systems: TK50 and CD-ROM The software documentation for this product is also available as part of the OpenVMS VAX Online Documentation Library on CD-ROM. OpenVMS Alpha systems: CD-ROM o This product is also available as part of the OpenVMS Alpha Consolidated Software Distribution on CD-ROM. o The software documentation for this product is also available as part of the OpenVMS Alpha Online Documentation Library on CD-ROM. 11 SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information, contact your local Digital office. 12 SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase of a license for the product as defined in the Software Warranty Addendum provided with the license Product Authorization Key. [R]WORMS-11 is a registered trademark of Perceptics Corporation. 12 [TM] AlphaServer, AlphaStation, DEC, Digital, OpenVMS, VAX, VAXserver, VMScluster, and the DIGITAL logo are trademarks of Digital Equipment Corporation. ©1996 Digital Equipment Corporation. All rights reserved. 13