OpenVMS System Services Reference Manual: A–GETUAI Order Number: AA–QSBMD–TE April 2001 This manual describes a set of routines that the Compaq OpenVMS Operating System uses to control resources, to allow process communication, to control I/O, and to perform other such operating system functions. This manual is in two parts. This first part contains the system services from A through $GETUAI. Revision/Update Information: This manual supersedes the OpenVMS System Services Reference Manual, 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. ZK6243 The Compaq OpenVMS documentation set is available on CD-ROM. This document was prepared using DECdocument, Version 3.3-1b. Contents Preface ............................................................ vii System Service Descriptions $ABORT_TRANS ............................................ SYS1–3 $ABORT_TRANSW . ........................................ SYS1–7 $ACQUIRE_GALAXY_LOCK (Alpha Only) . ....................... SYS1–8 $ADD_HOLDER ............................................ SYS1–10 $ADD_IDENT .............................................. SYS1–13 $ADD_PROXY .............................................. SYS1–16 $ADJSTK . ................................................ SYS1–20 $ADJWSL . ................................................ SYS1–22 $ALLOC . ................................................ SYS1–24 $ASCEFC . ................................................ SYS1–27 $ASCTIM . ................................................ SYS1–31 $ASCTOID . ................................................ SYS1–34 $ASCUTC . ................................................ SYS1–37 $ASSIGN . ................................................ SYS1–40 $AUDIT_EVENT ............................................ SYS1–45 $AUDIT_EVENTW . ........................................ SYS1–63 $AVOID_PREEMPT . ........................................ SYS1–64 $BINTIM . ................................................ SYS1–66 $BINUTC . ................................................ SYS1–69 $BRKTHRU ................................................ SYS1–72 $BRKTHRUW .............................................. SYS1–80 $CANCEL . ................................................ SYS1–81 $CANEXH . ................................................ SYS1–83 $CANTIM . ................................................ SYS1–84 $CANWAK . ................................................ SYS1–86 $CHECK_ACCESS . ........................................ SYS1–88 $CHECK_FEN (Alpha Only) . ................................ SYS1–96 $CHECK_PRIVILEGE ........................................ SYS1–97 $CHECK_PRIVILEGEW ......................................SYS1–102 $CHKPRO . ................................................SYS1–103 $CLEAR_SYSTEM_EVENT (Alpha Only) . .......................SYS1–111 $CLRAST . ................................................SYS1–113 $CLRCLUEVT ..............................................SYS1–114 $CLREF . ................................................SYS1–116 $CMEXEC . ................................................SYS1–117 iii $CMEXEC_64 (Alpha Only) ....................................SYS1–119 $CMKRNL .................................................SYS1–121 $CMKRNL_64 (Alpha Only) ....................................SYS1–124 $CPU_CAPABILITIES (Alpha Only) . ............................SYS1–126 $CPU_TRANSITION (Alpha Only) . ............................SYS1–130 $CPU_TRANSITIONW (Alpha Only) . ............................SYS1–135 $CREATE_GALAXY_LOCK (Alpha Only) .........................SYS1–136 $CREATE_GALAXY_LOCK_TABLE (Alpha Only) ...................SYS1–139 $CREATE_BUFOBJ_64 (Alpha Only) ............................SYS1–142 $CREATE_GDZRO (Alpha Only) ................................SYS1–146 $CREATE_GFILE (Alpha Only) .................................SYS1–154 $CREATE_GPFILE (Alpha Only) ................................SYS1–160 $CREATE_GPFN (Alpha Only) .................................SYS1–164 $CREATE_RDB . ............................................SYS1–169 $CREATE_REGION_64 (Alpha Only) ............................SYS1–171 $CREATE_USER_PROFILE ...................................SYS1–179 $CRELNM .................................................SYS1–185 $CRELNT .................................................SYS1–193 $CREMBX .................................................SYS1–199 $CREPRC .................................................SYS1–206 $CRETVA ..................................................SYS1–224 $CRETVA_64 (Alpha Only) ....................................SYS1–227 $CRMPSC .................................................SYS1–232 $CRMPSC_FILE_64 (Alpha Only) . ............................SYS1–245 $CRMPSC_GDZRO_64 (Alpha Only) . ............................SYS1–251 $CRMPSC_GFILE_64 (Alpha Only) . ............................SYS1–264 $CRMPSC_GPFILE_64 (Alpha Only) . ............................SYS1–272 $CRMPSC_GPFN_64 (Alpha Only) . ............................SYS1–279 $CRMPSC_PFN_64 (Alpha Only) ................................SYS1–286 $CVT_FILENAME (Alpha Only) ................................SYS1–291 $DACEFC .................................................SYS1–296 $DALLOC .................................................SYS1–298 $DASSGN .................................................SYS1–300 $DCLAST ..................................................SYS1–302 $DCLCMH .................................................SYS1–304 $DCLEXH .................................................SYS1–307 $DELETE_BUFOBJ (Alpha Only) . ............................SYS1–310 $DELETE_GALAXY_LOCK (Alpha Only) .........................SYS1–312 $DELETE_GALAXY_LOCK_TABLE (Alpha Only) ...................SYS1–314 $DELETE_INTRUSION . ....................................SYS1–315 $DELETE_PROXY ...........................................SYS1–318 $DELETE_REGION_64 (Alpha Only) ............................SYS1–321 $DELLNM .................................................SYS1–324 $DELMBX .................................................SYS1–327 $DELPRC .................................................SYS1–329 $DELTVA ..................................................SYS1–332 $DELTVA_64 (Alpha Only) ....................................SYS1–334 iv $DEQ .....................................................SYS1–338 $DEVICE_PATH_SCAN .......................................SYS1–343 $DEVICE_SCAN ............................................SYS1–347 $DGBLSC . ................................................SYS1–351 $DISMOU . ................................................SYS1–355 $DISPLAY_PROXY . ........................................SYS1–359 $DLCEFC . ................................................SYS1–365 $DNS (VAX Only) ............................................SYS1–367 $DNSW (VAX Only) . ........................................SYS1–394 $END_TRANS ..............................................SYS1–395 $END_TRANSW ............................................SYS1–400 $ENQ .....................................................SYS1–401 $ENQW . ................................................SYS1–414 $ERAPAT . ................................................SYS1–415 $EXIT ....................................................SYS1–418 $EXPREG . ................................................SYS1–419 $EXPREG_64 (Alpha Only) ....................................SYS1–422 $FAO/$FAOL ...............................................SYS1–426 $FAOL_64 (Alpha Only) .......................................SYS1–447 $FILESCAN ................................................SYS1–449 $FIND_HELD ..............................................SYS1–455 $FIND_HOLDER ............................................SYS1–458 $FINISH_RDB ..............................................SYS1–461 $FORCEX . ................................................SYS1–463 $FORMAT_ACL .............................................SYS1–466 $FORMAT_AUDIT . ........................................SYS1–479 $FREE_USER_CAPABILITY (Alpha Only) . .......................SYS1–483 $GETDVI . ................................................SYS1–485