DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL Optical Storage Management SPD 47.46.06 Software (OSMS) for OpenVMS VAX and Alpha, Version 3.4a DESCRIPTION The DIGITAL[TM] Optical Storage Management Software (DIGITAL OSMS) for OpenVMS[TM] product provides OpenVMS applications and users the func- tionality necessary to access an optical disk library (or jukebox) us- ing the conventional device, file, and record access services provided by the OpenVMS Operating System. In most cases, no changes will be re- quired 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 de- vice 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 op- tical disk surfaces. The optical library, therefore, appears to ap- plications 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, July 1997 these pseudo-devices emulate the operation of a conventional OpenVMS magnetic disk. Volume Access Volumes in an optical library used with DIGITAL OSMS are accessed us- ing 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 vol- ume 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. DIG- ITAL OSMS supports all OpenVMS commands and their library routine equiv- alents, such as, but not limited to: ALLOCATE DEALLOCATE MOUNT APPEND DELETE[2] OPEN BACKUP[1] DIFFERENCE PURGE CLOSE DIRECTORY READ COPY DISMOUNT RENAME ___________________________________________________________________ [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. 2 CREATE EDIT WRITE CREATE INITIALIZE[3] /DIRECTORY ___________________________________________________________________ [3]This command can be used only once with WORM media. SYSTEM MANAGEMENT FUNCTIONS The management utility tool, JBUTIL, lets the system manager control the parameters affecting the operation of the optical library. The util- ity also allows cartridges to be loaded into and removed from the op- tical library. Once a cartridge has been placed in a storage slot in- side the optical library, it will remain associated with the corre- sponding 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 vis- ible (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 hard- ware requirements of the complete system. Due to the variety of pro- cessors that support OpenVMS and the length of time that some Open- VMS 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 opti- cal library is connected to an HSD or HSJ controller. Alpha Processors Supported ___________________________________________________________________ DEC[TM]_2100____Supported_Adapters/Controllers_____________________ A500MP, HSD30, HSJ30, HSJ40, A600MP__________KZTSA,_KZPAA_______________________________________ DEC_3000________Supported_Adapters/Controllers_____________________ 300, 300L, KZTSA, PMAZB, PMAZC, and 2nd embedded controller 300LX 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 4 ___________________________________________________________________ 600 HSD30, HSJ30, HSJ40 ________________KZMSA______________________________________________ DEC_10000_______Supported_Adapters/Controllers_____________________ 600_____________HSD30,_HSJ30,_HSJ40________________________________ AlphaServer[TM]_Supported_Adapters/Controllers_____________________ 400 KZPSA, KZPAA 1000 HSD30, HSJ30, HSJ40 KZPSA, KZPAA 1000A HSD30, HSJ30, HSJ40 KZPSA, KZPAA 2000 HSD30, HSJ30, HSJ40 KZPSA, KZPAA 2100 HSD30, HSJ30, HSJ40 KZPSA, KZPAA 2100A HSD30, HSJ30, HSJ40 KZPSA, KZPAA 4100 HSD30, HSJ30, HSJ40, KZPAA 8200 HSD30, HSJ30, HSJ40 KZPAA 8400 HSD30, HSJ30, HSJ40 ________________KFMSB,_KZPSA,_KZPAA________________________________ AlphaStation[TM]Supported_Adapters/Controllers_____________________ 200 KZPSA, KZPAA 250 KZPSA, KZPAA 255 KZPSA, KZPAA 400 KZPSA, KZPAA 500 KZPSA, KZPAA 600 KZPSA, KZPAA VAX Processors Supported 5 ___________________________________________________________________ __________________uses_2nd_embedded_controller_____________________ VAX_4000__________Supported_Adapters/Controllers___________________ PMAZ, KZQSA, HSD30 __________________uses_2nd_embedded_controller_____________________ VAX_6000__________Supported_Adapters/Controllers___________________ 210, 220, 230, HSD30, HSJ30, HSJ40 240 310, 320, 330, HSD30, HSJ30, HSJ40 340, 360 410, 420, 430, HSD30, HSJ30, HSJ40 440, 450, 460 510, 520, 530, HSD30, HSJ30, HSJ40 540, 550, 560 610, 620, 630, HSD30, HSJ30, HSJ40 640,_650,_660______________________________________________________ VAX_7000__________Supported_Adapters/Controllers___________________ 610, 620, 630, HSD30, HSJ30, HSJ40 640, 650, 660 710, 720, 730, HSD30, HSJ30, HSJ40 740,_750,_760______________________________________________________ VAX_10000_________Supported_Adapters/Controllers___________________ 610, 620, 630, HSD30, HSJ30, HSJ40 640, 650, 660 6 VAXserver[TM]______________________________________________________ 6000______________Supported_Adapters/Controllers___________________ 210, 220 HSD30, HSJ30, HSJ40 310, 320 HSD30, HSJ30, HSJ40 410, 420 HSD30, HSJ30, HSJ40 510,_520__________HSD30,_HSJ30,_HSJ40______________________________ 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 2nd embedded controller 40, 48 96_________________________________________________________________ VAXstation 4000______________Supported_Adapters/Controllers___________________ PMAZ uses 2nd embedded controller 7 MicroVAX[TM]_______________________________________________________ 3100______________Supported_Adapters/Controllers___________________ 80________________uses_2nd_embedded_controller_____________________ MicroVAX II & III_______________Supported_Adapters/Controllers___________________ KZQSA Other Hardware Required: Supported Optical Libraries For OpenVMS VAX and OpenVMS Alpha processors, the DIGITAL OSMS for Open- VMS supports the following specific 5.25-inch optical libraries: ___________________________________________________________________ 5.25-in. Optical Li- Multifunction braries_____________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 8 ___________________________________________________________________ VAX instal- 15,000 7.7 lation VAX use 4,000 2[2] Alpha in- 15,000 7.7 stallation 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.__________ These counts refer to the disk space required on the system disk. Ad- ditional disk space can be required based on the user's system envi- ronment and configuration, as well as the user options selected at in- stallation 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 in- creased memory capability improves performance. The memory size sug- gested 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 sup- ported with this release ___________________________________________________________________ Unsupported________________________________________________________ Adapters HSC, PB2HA Processors VAXserver 400 Model 200, 300, 500 VAXserver 3100 Model 10/10E, 20/20E 9 ___________________________________________________________________ VAXserver 3300, 3400, 3500, 3600, 3602, 3800, 3900 VAXstation 4000 VLC DEC 2000 Model 300, 500 DEC 10004 Model 200 Optical Li- RV720-ZA, RV30, Cygnet 1602 with 2 LSMI 4100 braries drives, Cygnet 1802 with 2 to 5 LSMI 4100 drives, LSMI LF45000 RapidChanger SOFTWARE REQUIREMENTS Operating System o OpenVMS VAX V7.1 o OpenVMS Alpha V7.1 Optional Software o HSJ Family Array Controller V2.7. Refer to SPD 47.26.xx. o HSD30 Array Controller Operating Software (HSOF) V2.7. Refer to SPD 53.53.xx. 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 ___________________________________________________________________ [1]Upgrade licenses from 88-144 platters and 144-238 platters are also available. Consult with the local DIGITAL office. 10 ___________________________________________________________________ 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__________________________________________ QT-0UMA9- OSMS 5.25 in. with 16 platter license **[5] QT-0UBA9- OSMS 5.25 in. with 32 platter license **[5] QT-0UCA9- OSMS 5.25 in. with 88 platter license **[5] QT-0UEA9- OSMS 5.25 in. with 144 platter license **[5] ___________________________________________________________________ [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. [5]**Denotes variant fields. For additional information on avail- able licenses, services, and media, refer to the appropriate price book. 11 ___________________________________________________________________ QT-5CGA9- OSMS 5.25 in. with 238 platter license **[5]______________________________________________________________ [5]**Denotes variant fields. For additional information on avail- able licenses, services, and media, refer to the appropriate price book. SOFTWARE LICENSING This software is furnished under the licensing provisions of DIGITAL Equipment Corporation's Standard Terms and Conditions. For more in- formation about DIGITAL licensing terms and policies, contact your lo- cal DIGITAL office. License Management Facility Support DIGITAL OSMS for OpenVMS supports the OpenVMS License Management Fa- cility. 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 ca- pacity of the optical library. The license is based on unlimited sys- tem use. Upgrade license units for DIGITAL OSMS for OpenVMS VAX and Alpha are used in conjunction with a hardware upgrade of the applicable opti- cal libraries and are added to the original license to provide a to- tal equal to the combined units of the original license plus the up- grade 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 appropri- ate version (VAX or Alpha) of the OpenVMS Operating System documen- tation sets. 12 CLUSTER ENVIRONMENT DIGITAL OSMS for OpenVMS VAX and OpenVMS Alpha using the RW5xx opti- cal libraries with rewritable or WORM media containing the FILES-11 on-disk structure is supported on local or VMScluster access when in- stalled 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 con- figuration. DIGITAL OSMS on OpenVMS Alpha does not support any con- figuration 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) 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). GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future version of this product may be different from the requirements for the current version. 13 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 Con- solidated 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. SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more in- formation, contact your local DIGITAL office. SOFTWARE WARRANTY Warranty for this software product is provided by DIGITAL with the pur- chase 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. [TM] AlphaServer, AlphaStation, DEC, Digital, OpenVMS, VAX, VAXserver, VMScluster, and the DIGITAL logo are trademarks of Digital Equipment Corporation. ©1997 Digital Equipment Corporation. All rights reserved. 14