I/O User's Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
VSI OpenVMS I/O User’s Reference Manual Document Number: DO-DIOURM-01A Publication Date: August 2019 This manual is intended for system programmers who want to take advantage of the time and space savings that result from direct use of I/O drivers. OpenVMS users who do not require such detailed knowledge of I/O drivers can use the device-inde- pendent services described in the OpenVMS Record Management Services Refer- ence Manual. Revision Update Information: This is a new manual. Operating System and Version: VSI OpenVMS I64 Version 8.4-1H1 VSI OpenVMS Alpha 8.4-2L1 VMS Software, Inc. (VSI) Bolton, Massachusetts, USA I/O User’s Reference Manual: Copyright © 2019 VMS Software, Inc. (VSI), Bolton, Massachusetts, USA Legal Notice Confidential computer software. Valid license from VSI 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. The information contained herein is subject to change without notice. The only warranties for VSI products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. VSI shall not be liable for technical or editorial errors or omissions contained herein. HPE, HPE Integrity, HPE Alpha, and HPE Proliant are trademarks or registered trademarks of Hewlett Packard Enterprise. Intel, Itanium and IA-64 are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other coun- tries. Java, the coffee cup logo, and all Java based marks are trademarks or registered trademarks of Oracle Corporation in the United States or other countries. Kerberos is a trademark of the Massachusetts Institute of Technology. Microsoft, Windows, Windows-NT and Microsoft XP are U.S. registered trademarks of Microsoft Corporation. Microsoft Vista is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. Motif is a registered trademark of The Open Group UNIX is a registered trademark of The Open Group. The VSI OpenVMS documentation set is available on DVD. ii I/O User’s Reference Manual Preface .................................................................................................................................... xi 1. About VSI ..................................................................................................................... xi 2. Intended Audience ......................................................................................................... xi 3. Document Structure ....................................................................................................... xi 4. Device Driver Support for OpenVMS Alpha and Integrity servers 64-Bit Addressing ........ xii 5. About VSI OpenVMS Alpha VXXXXXXXX ................................................................ xii 6. Typographical Conventions .......................................................................................... xiii 7. VSI Encourages Your Comments .................................................................................. xiv 8. How to Order Additional Documentation ...................................................................... xiv Chapter 1. ACP-QIO Interface ............................................................................................ 1 1.1. ACP Functions and Encoding ....................................................................................... 2 1.2. File Information Block (FIB) ........................................................................................ 3 1.3. ACP Subfunctions ........................................................................................................ 7 1.3.1. Directory Lookup .............................................................................................. 8 1.3.1.1. Input Parameters ..................................................................................... 8 1.3.1.2. Operation ............................................................................................... 9 1.3.1.3. Directory Entry Protection ..................................................................... 11 1.3.2. Access ............................................................................................................ 11 1.3.2.1. Input Parameters ................................................................................... 11 1.3.2.2. Operation ............................................................................................. 12 1.3.3. Extend ............................................................................................................ 12 1.3.3.1. Input Parameters ................................................................................... 12 1.3.3.2. Operation ............................................................................................. 14 1.3.4. Truncate .......................................................................................................... 14 1.3.4.1. Input Parameters ................................................................................... 14 1.3.4.2. Operation ............................................................................................. 15 1.3.5. Read/Write Attributes ...................................................................................... 15 1.3.5.1. Input Parameters ................................................................................... 16 1.3.5.2. Attribute Descriptions ........................................................................... 19 1.4. ACP-QIO Record Attributes Area ............................................................................... 21 1.5. ACP-QIO Attributes Statistics Block ........................................................................... 23 1.6. Major Functions ......................................................................................................... 24 1.6.1. Create File ...................................................................................................... 24 1.6.1.1. Input Parameters ................................................................................... 25 1.6.1.2. Disk ACP Operation ............................................................................. 26 1.6.1.3. Directory Entry Creation ....................................................................... 27 1.6.1.4. Magnetic Tape ACP Operation .............................................................. 27 1.6.2. Access File ...................................................................................................... 27 1.6.2.1. Input Parameters ................................................................................... 28 1.6.2.2. Operation ............................................................................................. 29 1.6.3. Deaccess File .................................................................................................. 29 1.6.3.1. Input Parameters ................................................................................... 29 1.6.3.2. Operation ............................................................................................. 29 1.6.4. Modify File ..................................................................................................... 30 1.6.4.1. Input Parameters ................................................................................... 30 1.6.4.2. Operation ............................................................................................. 30 1.6.5. Delete File ...................................................................................................... 31 1.6.5.1. Operation ............................................................................................. 31 1.6.6. Movefile Subfunction ...................................................................................... 32 1.6.6.1. Calling the Movefile Subfunction .......................................................... 32 1.6.7. Mount ............................................................................................................. 35 1.6.8. ACP Control ................................................................................................... 35 iii I/O User’s Reference Manual 1.6.8.1. Input Parameters ................................................................................... 35 1.6.8.2. Magnetic Tape Control Functions .......................................................... 36 1.6.8.3. Miscellaneous Disk Control Functions ................................................... 37 1.6.8.4. Disk Quotas .......................................................................................... 37 1.7. I/O Status Block ......................................................................................................... 39 Chapter 2. Disk Drivers ...................................................................................................... 41 2.1. Driver Features .......................................................................................................... 41 2.1.1. Data Check ..................................................................................................... 41 2.1.2. Effects of a Failure During an I/O Write Operation ............................................ 42 2.1.3.