OpenVMS I/O User’s Reference Manual Order Number: AA–PV6SD–TK April 2001 This manual contains the information necessary to interface directly with the I/O device drivers supplied as part of the Compaq OpenVMS operating system. Several examples of programming techniques are included. This document does not contain information on I/O operations using the OpenVMS Record Management Services. Revision/Update Information: This manual supersedes the OpenVMS I/O User’s Reference Manual, OpenVMS Alpha Version 7.2, OpenVMS VAX Version 7.2 Software Version: OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.3 Compaq Computer Corporation Houston, Texas © 2001 Compaq Computer Corporation Compaq, 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. Microsoft, MS-DOS, Visual C++, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States and other countries. Intel, Intel Inside, and Pentium are trademarks of Intel Corporation in the United States and other countries. Motif, OSF/1, and UNIX 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. 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. ZK6136 The Compaq OpenVMS documentation set is available on CD-ROM. This document was prepared using DECdocument, Version 3.3-1b. Contents Preface ............................................................ xvii 1 ACP–QIO Interface 1.1 ACP Functions and Encoding . ................................ 1–2 1.2 File Information Block (FIB) . ................................ 1–3 1.3 ACP Subfunctions . ........................................ 1–7 1.3.1 Directory Lookup . ........................................ 1–7 1.3.1.1 Input Parameters ...................................... 1–8 1.3.1.2 Operation ............................................ 1–9 1.3.1.3 Directory Entry Protection ............................... 1–9 1.3.2 Access . ................................................ 1–9 1.3.2.1 Input Parameters ...................................... 1–10 1.3.2.2 Operation ............................................ 1–11 1.3.3 Extend . ................................................ 1–11 1.3.3.1 Input Parameters ...................................... 1–11 1.3.3.2 Operation ............................................ 1–12 1.3.4 Truncate ................................................ 1–13 1.3.4.1 Input Parameters ...................................... 1–13 1.3.4.2 Operation ............................................ 1–13 1.3.5 Read/Write Attributes ..................................... 1–14 1.3.5.1 Input Parameters ...................................... 1–14 1.4 ACP-QIO Record Attributes Area ................................ 1–18 1.5 ACP–QIO Attributes Statistics Block ............................. 1–20 1.6 Major Functions ............................................. 1–22 1.6.1 Create File .............................................. 1–23 1.6.1.1 Input Parameters ...................................... 1–23 1.6.1.2 Disk ACP Operation .................................... 1–24 1.6.1.3 Directory Entry Creation ................................ 1–25 1.6.1.4 Magnetic Tape ACP Operation ............................ 1–25 1.6.2 Access File .............................................. 1–25 1.6.2.1 Input Parameters ...................................... 1–26 1.6.2.2 Operation ............................................ 1–26 1.6.3 Deaccess File ............................................ 1–27 1.6.3.1 Input Parameters ...................................... 1–27 1.6.3.2 Operation ............................................ 1–27 1.6.4 Modify File .............................................. 1–27 1.6.4.1 Input Parameters ...................................... 1–28 1.6.4.2 Operation ............................................ 1–28 1.6.5 Delete File .............................................. 1–28 1.6.5.1 Operation ............................................ 1–29 iii 1.6.6 Movefile Subfunction ...................................... 1–29 1.6.6.1 Calling the Movefile Subfunction . ....................... 1–29 1.6.6.2 Input Parameters ...................................... 1–30 1.6.6.3 Operation ............................................ 1–32 1.6.7 Mount . ................................................ 1–33 1.6.8 ACP Control ............................................. 1–33 1.6.8.1 Input Parameters ...................................... 1–33 1.6.8.2 Magnetic Tape Control Functions . ....................... 1–34 1.6.8.3 Miscellaneous Disk Control Functions ...................... 1–34 1.6.8.4 Disk Quotas . ........................................ 1–35 1.7 I/O Status Block ............................................. 1–37 2 Disk Drivers 2.1 Supported Disk Devices and Controllers . ....................... 2–1 2.1.1 UDA50 UNIBUS Disk Adapter .............................. 2–1 2.1.2 KDA50 Disk Controller .................................... 2–2 2.1.3 KDB50 Disk Controller .................................... 2–2 2.1.4 HSC40, HSC50, and HSC70 Controllers ....................... 2–2 2.1.5 SII Integral Adapter ...................................... 2–3 2.1.6 KFQSA Adapter . ........................................ 2–3 2.1.7 RQDX3 Disk Controller .................................... 2–3 2.1.8 RA70 and RA90 Disk Drives ................................ 2–3 2.1.9 RA60 Disk .............................................. 2–3 2.1.10 RA80/RB80/RM80 and RA81 Fixed-Media Disks . ............... 2–4 2.1.11 RB02 and RL02 Cartridge Disk (VAX Only) ..................... 2–4 2.1.12 RC25 Disk (VAX Only) ..................................... 2–4 2.1.13 RD53 and RD54 Disks (VAX Only) ............................ 2–4 2.1.14 RF30 and RF71 Disks ..................................... 2–5 2.1.15 RK06 and RK07 Cartridge Disks (VAX Only) ................... 2–5 2.1.16 RM03 and RM05 Pack Disks (VAX Only) ....................... 2–5 2.1.17 RP05 and RP06 Disk (VAX Only) ............................. 2–5 2.1.18 RP07 Fixed-Media Disk (VAX Only) ........................... 2–5 2.1.19 RRD40 and RRD50 Read-Only Memory (CD-ROM) ............... 2–5 2.1.20 RX01 Console Disk (VAX Only) .............................. 2–6 2.1.21 RX02 Disk (VAX Only) ..................................... 2–6 2.1.22 RX23 (VAX Only) . ........................................ 2–7 2.1.23 RX33 (VAX Only) . ........................................ 2–7 2.1.24 RX50 (VAX Only) . ........................................ 2–7 2.1.25 RZ22, RZ23, and RZ55 Disks ................................ 2–7 2.1.26 TU58 Magnetic Tape (DECtape II) ............................ 2–7 2.2 Driver Features ............................................. 2–8 2.2.1 Dual-Pathed Disks........................................ 2–8 2.2.2 Dual Porting MASSBUS Disks .............................. 2–9 2.2.2.1 Port Selection and Access Modes . ....................... 2–9 2.2.2.2 Disk Use and Restrictions ............................... 2–10 2.2.2.3 Restriction on Dual-Ported Non-DSA Disks in a Cluster . ....... 2–10 2.2.3 Dual-Pathed DSA Disks .................................... 2–11 2.2.4 Dual-Porting HSC Disks . ................................ 2–11 2.2.5 Dual-Pathed RF-Series Disks ................................ 2–11 2.2.6 Data Check ............................................. 2–12 2.2.7 Effects of a Failure During an I/O Write Operation ............... 2–13 2.2.8 Overlapped Seeks . ........................................ 2–13 iv 2.2.9 Error Recovery . ........................................ 2–14 2.2.9.1 Skip Sectoring ........................................ 2–14 2.2.10 Logical-to-Physical Translation (RX01 and RX02) . ............... 2–15 2.2.11 DIGITAL Storage Architecture (DSA) Devices ................... 2–16 2.2.11.1 Bad Block Replacement and Forced Errors for DSA Disks ....... 2–17 2.2.12 VAXstation 2000 and MicroVAX 2000 Disk Driver . ............... 2–18 2.2.13 SCSI Disk Class Driver .................................... 2–18 2.2.14 Audio Extensions to the SCSI Disk Class Driver . ............... 2–19 2.2.14.1 $QIO Interface to Audio Functionality of the SCSI Disk Class Driver .............................................. 2–20 2.2.14.2 Defining an Audio Control Block (AUCB) ................... 2–20 2.2.14.3 Error Handling in Applications Using SCSI Audio Functions .... 2–23 2.2.14.4 Using CD-ROM to Store Both Data and Audio Information ...... 2–25 2.2.14.5 Programming Audio Applications . ....................... 2–26 2.2.14.6 Application Program Example Using SCSI Audio Capabilities (VAX only) . ........................................ 2–26 2.3 Disk Driver Device Information . ...............................