[an error occurred while processing this directive]
HP OpenVMS Systems Documentation |
HP OpenVMS RTL Library (LIB$) ManualOrder Number: AA-QSBHE-TE
January 2005
This manual documents the library routines contained in the LIB$ and CVT$ facilities of the OpenVMS Run-Time Library. Revision/Update Information: This manual supersedes HP OpenVMS RTL Library (LIB$) Manual, OpenVMS Alpha Version 7.3. Software Version: OpenVMS I64 Version 8.2 OpenVMS Alpha Version 8.2
Hewlett-Packard Company
© Copyright 2005 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP 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 HP 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. HP shall not be liable for technical or editorial errors or omissions contained herein. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Printed in the US
ZK5932 The HP OpenVMS documentation set is available on CD-ROM.
PrefaceThis manual provides users of the HP OpenVMS operating system with detailed usage and reference information on library routines supplied in the LIB$ and CVT$ facilities of the Run-Time Library (RTL). Intended AudienceThis manual is intended for system and application programmers who write programs that call LIB$ and CVT$ Run-Time Library routines. Document StructureThis manual is organized into three parts as follows:
Related DocumentsThe Run-Time Library (RTL) routines are documented in a series of reference manuals. General descriptions of OpenVMS RTL routines appear in the following manual:
Specific descriptions of the other RTL facilities and their corresponding routines appear in the following manuals:
Application programmers using any language can refer to the Guide to Creating OpenVMS Modular Procedures for writing modular and reentrant code. High-level language programmers will find additional information on calling Run-Time Library routines in their language reference manuals. Additional information may also be found in the language user's guide provided with your OpenVMS language software. For a complete list and description of the manuals in the OpenVMS documentation set, see the HP OpenVMS Version 8.2 New Features and Documentation Overview. For additional information about HP OpenVMS products and services, see the following World Wide Web address:
Reader's CommentsHP welcomes your comments on this manual. Please send comments to either of the following addresses:
How To Order Additional DocumentationFor information on how to order additional documentation, visit the following World Wide Web address:
ConventionsIn this manual, every use of DECwindows and DECwindows Motif refers to HP DECwindows Motif for OpenVMS software. The following conventions are also used in this manual:
Part 1
This part contains one chapter that provides a brief overview of the
LIB$ and CVT$ Run-Time Library facilities and lists the LIB$ and CVT$
routines and their functions. It also provides guidelines and
information on using the LIB$ facility with VAX, Alpha, and
HP OpenVMS Industry Standard 64 for Integrity Servers (I64) platforms.
|
Routine Name | Function |
---|---|
LIB$ADAWI | Add adjacent word with interlock. |
LIB$ADDX | Add two multiple-precision binary numbers. |
LIB$ADD_TIMES | Add two quadwords times. |
LIB$ANALYZE_SDESC | Analyze a string descriptor. |
LIB$ANALYZE_SDESC_64 | Analyze a string descriptor. 1 |
LIB$ASN_WTH_MBX | Assign a channel to a mailbox. |
LIB$AST_IN_PROG | Check for active AST. |
LIB$ATTACH | Attach a terminal to a process. |
LIB$BBCCI | Test and clear a bit with interlock. |
LIB$BBSSI | Test and set a bit with interlock. |
LIB$BUILD_NODESPEC | Build a node-name specification. |
LIB$CALLG | Call a procedure with a general argument list. |
LIB$CALLG_64 | Call a procedure with a general argument list. 1 |
LIB$CHAR | Transform a byte to the first character of a string. |
LIB$COMPARE_NODENAME | Compare two node names. |
LIB$COMPRESS_NODENAME | Compress a node name to its short form equivalent. |
LIB$CONVERT_DATE_STRING | Convert a date string to a quadword. |
LIB$CRC | Calculate a cyclic redundancy check (CRC). |
LIB$CRC_TABLE | Construct a cyclic redundancy check (CRC) table. |
LIB$CREATE_DIR | Create a directory. |
LIB$CREATE_USER_VM_ZONE | Create a user-defined storage zone. |
LIB$CREATE_USER_VM_ZONE_64 | Create a user-defined storage zone. 1 |
LIB$CREATE_VM_ZONE | Create a new storage zone. |
LIB$CREATE_VM_ZONE_64 | Create a new storage zone. 1 |
LIB$CRF_INS_KEY | Insert a key in the cross-reference table. |
LIB$CRF_INS_REF | Insert a reference to a key in the cross-reference table. |
LIB$CRF_OUTPUT | Output some cross-reference table information. |
LIB$CURRENCY | Get the system currency symbol. |
LIB$CVTF_FROM_INTERNAL_TIME | Convert internal time to external time (F-floating value). |
LIB$CVTS_FROM_INTERNAL_TIME | Convert internal time to external time (IEEE S-floating value). |
LIB$CVTF_TO_INTERNAL_TIME | Convert external time to internal time (F-floating value). |
LIB$CVTS_TO_INTERNAL_TIME | Convert external time to internal time (IEEE S-floating value). |
LIB$CVT_DX_DX | Convert the specified data type. |
LIB$CVT_FROM_INTERNAL_TIME | Convert internal time to external time. |
LIB$CVT_TO_INTERNAL_TIME | Convert external time to internal time. |
LIB$CVT_VECTIM | Convert 7-word vector to internal time. |
LIB$CVT_ xTB | Convert numeric text to binary. |
LIB$CVT_ xTB_64 | Convert numeric text to binary. 1 |
LIB$DATE_TIME | Return the date and time as a string. |
LIB$DAY | Return the day number as a longword integer. |
LIB$DAY_OF_WEEK | Return the numeric day of the week. |
LIB$DECODE_FAULT | Decode instruction stream during a fault. 2 |
LIB$DEC_OVER | Enable or disable decimal overflow detection. 2 |
LIB$DELETE_FILE | Delete one or more files. |
LIB$DELETE_LOGICAL | Delete a logical name. |
LIB$DELETE_SYMBOL | Delete a CLI symbol. |
LIB$DELETE_VM_ZONE | Delete a virtual memory zone. |
LIB$DELETE_VM_ZONE_64 | Delete a virtual memory zone. 1 |
LIB$DIGIT_SEP | Get the digit separator symbol. |
LIB$DISABLE_CTRL | Disable CLI interception of control characters. |
LIB$DO_COMMAND | Execute the specified command. |
LIB$EDIV | Perform an extended-precision divide. |
LIB$EMODD | Perform extended multiply and integerize for D-floating values. |
LIB$EMODF | Perform extended multiply and integerize for F-floating values. |
LIB$EMODG | Perform extended multiply and integerize for G-floating values. |
LIB$EMODH | Perform extended multiply and integerize for H-floating values. 2 |
LIB$EMODS | Perform extended multiply and integerize for IEEE S-floating values. |
LIB$EMODT | Perform extended multiply and integerize for IEEE T-floating values. |
LIB$EMUL | Perform an extended-precision multiply. |
LIB$ENABLE_CTRL | Enable CLI interception of control characters. |
LIB$ESTABLISH | Establish a condition handler. 2 3 |
LIB$EXPAND_NODENAME | Expand a node name to its full name equivalent. |
LIB$EXTV | Extract a field and sign-extend. |
LIB$EXTZV | Extract a zero-extended field. |
LIB$FF x | Find the first clear or set bit. |
LIB$FID_TO_NAME | Convert a device and file ID to a file specification. |
LIB$FILE_SCAN | Perform a file scan. |
LIB$FILE_SCAN_END | End a file scan. |
LIB$FIND_FILE | Find a file. |
LIB$FIND_FILE_END | End of find file. |
LIB$FIND_IMAGE_SYMBOL | Merge activate an image symbol. |
LIB$FIND_VM_ZONE | Find the next valid zone. |
LIB$FIND_VM_ZONE_64 | Find the next valid zone. 1 |
LIB$FIT_NODENAME | Fit a node name into an output field. |
LIB$FIXUP_FLT | Fix floating reserved operand. 2 |
LIB$FLT_UNDER | Detect a floating-point underflow. 2 |
LIB$FORMAT_DATE_TIME | Format a date and/or time. |
LIB$FORMAT_SOGW_PROT | Format protection mask. 4 |
LIB$FREE_DATE_TIME_CONTEXT | Free the context used to format a date. |
LIB$FREE_EF | Free an event flag. |
LIB$FREE_LUN | Free a logical unit number. |
LIB$FREE_TIMER | Free timer storage. |
LIB$FREE_VM | Free virtual memory from the program region. |
LIB$FREE_VM_64 | Free virtual memory from the program region. 1 |
LIB$FREE_VM_PAGE | Free a virtual memory page. |
LIB$FREE_VM_PAGE_64 | Free a virtual memory page. 1 |
LIB$GETDVI | Get device/volume information. |
LIB$GETJPI | Get job/process information. |
LIB$GETQUI | Get queue information. |
LIB$GETSYI | Get systemwide information. |
LIB$GET_ACCNAM | Get access name table for a security object identified by name. 4 |
LIB$GET_ACCNAM_BY_CONTEXT | Get access name table for a security object identified by $GET_SECURITY or $SET_SECURITY context. 4 |
LIB$GET_COMMAND | Get line from SYS$COMMAND. |
LIB$GET_COMMON | Get string from common area. |
LIB$GET_CURR_INVO_CONTEXT | Get current invocation context. 1 |
LIB$GET_DATE_FORMAT | Return the user's date input format. |
LIB$GET_EF | Get an event flag. |
LIB$GET_FOREIGN | Get foreign command line. |
LIB$GET_FULLNAME_OFFSET | Get the offset to the starting position of the most significant part of a full name. |
LIB$GET_HOSTNAME | Get host node name. |
LIB$GET_INPUT | Get line from SYS$INPUT. |
LIB$GET_INVO_CONTEXT | Get invocation context. 1 |
LIB$GET_INVO_HANDLE | Get invocation handle. 1 |
LIB$GET_LUN | Get logical unit number. |
LIB$GET_MAXIMUM_DATE_LENGTH | Get the maximum possible date/time string length. |
LIB$GET_PREV_INVO_CONTEXT | Get previous invocation context. 1 |
LIB$GET_PREV_INVO_HANDLE | Get previous invocation handle. 1 |
LIB$GET_SYMBOL | Get the value of a CLI symbol. |
LIB$GET_USERS_LANGUAGE | Return the user's language choice. |
LIB$GET_VM | Allocate virtual memory. |
LIB$GET_VM_64 | Allocate virtual memory. 1 |
LIB$GET_VM_PAGE | Get a virtual memory page. |
LIB$GET_VM_PAGE_64 | Get a virtual memory page. 1 |
LIB$ICHAR | Convert the first character of a string to an integer. |
LIB$I64_CREATE_INVO_CONTEXT | Allocate and initialize an invocation context block. 5 |
LIB$I64_GET_CURR_INVO_CONTEXT | Get current invocation context. 5 |
LIB$I64_FREE_INVO_CONTEXT | Deallocate an invocation context block. 5 |
LIB$I64_GET_CURR_INVO_HANDLE | Get current invocation handle. 5 |
LIB$I64_GET_FR | Get floating-point register value. 5 |
LIB$I64_GET_GR | Get general register value. 5 |
LIB$I64_GET_INVO_HANDLE | Get invocation handle. 5 |
LIB$I64_GET_INVO_CONTEXT | Get invocation context. 5 |
LIB$I64_GET_PREV_INVO_CONTEXT | Get previous invocation context. 5 |
LIB$I64_GET_PREV_INVO_END | Free memory used to process unwind descriptors. 5 |
LIB$I64_GET_PREV_INVO_HANDLE | Get previous invocation handle. 5 |
LIB$I64_GET_UNWIND_HANDLER_FV | Given a pc_value, find the function value (address of the procedure descriptor) for the condition handler, if present, and write it to handler_fv. 5 |
LIB$I64_GET_UNWIND_LSDA | Find Address of Unwind Information Block Language-Specific Data. 5 |
LIB$I64_GET_UNWIND_OSSD | Find address of the unwind information block operating system-specific data area. 5 |
LIB$I64_INIT_INVO_CONTEXT | Initialize an invocation context block that has already been allocated. 5 |
LIB$I64_IS_AST_DISPATCH_FRAME | Determine whether a given PC value represents an AST dispatch frame. 5 |
LIB$I64_IS_EXC_DISPATCH_FRAME | Determine whether a given PC value represents an exception dispatch frame. 5 |
LIB$I64_PUT_INVO_REGISTERS | Update register contetnts using a given invocation context. 5 |
LIB$I64_PREV_INVO_END | Free memory used tp process unwind descriptors. 5 |
LIB$I64_SET_FR | Write context of invocation context block. 5 |
LIB$I64_SET_GR | Write invocation block general register value. 5 |
LIB$I64_SET_PC | Write pc_copy value of invocation context block. 5 |
LIB$INDEX | Index to relative position of substring. |
LIB$INIT_DATE_TIME_CONTEXT | Initialize the context used in formatting date/time strings. |
LIB$INIT_TIMER | Initialize times and counts. |
LIB$INSERT_TREE | Insert entry in a balanced binary tree. |
LIB$INSERT_TREE_64 | Insert entry in a balanced binary tree. 1 |
LIB$INSQHI | Insert entry at the head of a queue. |
LIB$INSQHIQ | Insert entry at the head of a queue. 1 |
LIB$INSQTI | Insert entry at the tail of a queue. |
LIB$INSQTIQ | Insert entry at the tail of a queue. 1 |
LIB$INSV | Insert a variable bit field. |
LIB$INT_OVER | Detect integer overflow. 2 |
LIB$LEN | Return the length of a string as a longword. |
LIB$LOCC | Locate a character. |
LIB$LOCK | Lock a specified image in the process's working set. |
LIB$LOOKUP_KEY | Look up keyword in table. |
LIB$LOOKUP_TREE | Look up an entry in a balanced binary tree. |
LIB$LOOKUP_TREE_64 | Look up an entry in a balanced binary tree. 1 |
LIB$LP_LINES | Specify the number of lines on each printer page. |
LIB$MATCHC | Match characters, return relative position. |
LIB$MATCH_COND | Match condition values. |
LIB$MOVC3 | Move characters. |
LIB$MOVC5 | Move characters with fill. |
LIB$MOVTC | Move translated characters. |
LIB$MOVTUC | Move translated until character. |
LIB$MULTF_DELTA_TIME | Multiply delta time by F-floating scalar. |
LIB$MULTS_DELTA_TIME | Multiply delta time by IEEE S-floating scalar. |
LIB$MULT_DELTA_TIME | Multiply delta time by scalar. |
LIB$PARSE_ACCESS_CODE | Parse access-encoded name string. 4 |
LIB$PARSE_SOGW_PROT | Parse protection string. 4 |
LIB$PAUSE | Pause program execution. |
LIB$POLYD | Evaluate polynomials for D-floating values. |
LIB$POLYF | Evaluate polynomials for F-floating values. |
LIB$POLYG | Evaluate polynomials for G-floating values. |
LIB$POLYH | Evaluate polynomials for H-floating values. 2 |
LIB$POLYS | Evaluate polynomials for IEEE S-floating values. |
LIB$POLYT | Evaluate polynomials for IEEE T-floating values. |
LIB$PUT_COMMON | Put string into common area. |
LIB$PUT_INVO_REGISTERS | Put invocation registers. 1 |
LIB$PUT_OUTPUT | Put line to SYS$OUTPUT. |
LIB$RADIX_POINT | Radix point symbol. |
LIB$REMQHI | Remove entry from head of queue. |
LIB$REMQHIQ | Remove entry from head of queue. 1 |
LIB$REMQTI | Remove entry from tail of queue. |
LIB$REMQTIQ | Remove entry from tail of queue. 1 |
LIB$RENAME_FILE | Rename one or more files. |
LIB$RESERVE_EF | Reserve an event flag. |
LIB$RESET_VM_ZONE | Reset virtual memory zone. |
LIB$RESET_VM_ZONE_64 | Reset virtual memory zone. 1 |
LIB$REVERT | Revert to the handler of the procedure activator. 2 3 |
LIB$RUN_PROGRAM | Run new program. |
LIB$SCANC | Scan for characters and return relative position. |
LIB$SCOPY_DXDX | Copy source string by descriptor to destination. |
LIB$SCOPY_R_DX | Copy source string by reference to destination. |
LIB$SCOPY_R_DX_64 | Copy source string by reference to destination. 1 |
LIB$SET_LOGICAL | Set logical name. |
LIB$SET_SYMBOL | Set the value of a CLI symbol. |
LIB$SFREE1_DD | Free one or more dynamic strings. |
LIB$SFREEN_DD | Free n dynamic strings. |
LIB$SGET1_DD | Get one dynamic string. |
LIB$SGET1_DD_64 | Get one dynamic string. 1 |
LIB$SHOW_TIMER | Show accumulated times and counts. |
LIB$SHOW_VM | Show virtual memory statistics. |
LIB$SHOW_VM_64 | Show virtual memory statistics. 1 |
LIB$SHOW_VM_ZONE | Display information about a virtual memory zone. |
LIB$SHOW_VM_ZONE_64 | Display information about a virtual memory zone. 1 |
LIB$SIGNAL | Signal exception condition. |
LIB$SIG_TO_RET | Convert a signaled message to a return status. |
LIB$SIG_TO_STOP | Convert a signaled condition to a signaled stop. |
LIB$SIM_TRAP | Simulate floating trap. 2 |
LIB$SKPC | Skip equal characters. |
LIB$SPANC | Skip selected characters. |
LIB$SPAWN | Spawn a subprocess. |
LIB$STAT_TIMER | Return accumulated time and count statistics. |
LIB$STAT_VM | Return virtual memory statistics. |
LIB$STAT_VM_64 | Return virtual memory statistics. 1 |
LIB$STOP | Stop execution and signal the condition. |
LIB$SUBX | Perform multiple-precision binary subtraction. |
LIB$SUB_TIMES | Subtract two quadword times. |
LIB$SYS_ASCTIM | Invoke $ASCTIM to convert binary time to ASCII. |
LIB$SYS_FAO | Invoke $FAO system service to format output. |
LIB$SYS_FAOL | Invoke $FAOL system service to format output. |
LIB$SYS_FAOL_64 | Invoke $FAOL system service to format output. 1 |
LIB$SYS_GETMSG | Invoke $GETMSG system service to get message text. |
LIB$TABLE_PARSE | Implement a table-driven, finite-state parser. |
LIB$TPARSE | Implement a table-driven, finite-state parser. 2 |
LIB$TRAVERSE_TREE | Traverse a balanced binary tree. |
LIB$TRAVERSE_TREE_64 | Traverse a balanced binary tree. 1 |
LIB$TRA_ASC_EBC | Translate ASCII to EBCDIC. |
LIB$TRA_EBC_ASC | Translate EBCDIC to ASCII. |
LIB$TRIM_FILESPEC | Fit a long file specification into a fixed field. |
LIB$TRIM_FULLNAME | Trim a full name to fit into a desired output field. |
LIB$UNLOCK | Unlock a specified image in the process's working set. |
LIB$VERIFY_VM_ZONE | Verify a virtual memory zone. |
LIB$VERIFY_VM_ZONE_64 | Verify a virtual memory zone. 1 |
LIB$WAIT | Wait a specified period of time. |
Next | Contents | Index |