HP OpenVMS Systems Documentation
HP OpenVMS RTL General Purpose (OTS$) Manual
Order Number: AA--PV6HE--TK
This manual documents the general-purpose routines contained in the OTS$ facility of the OpenVMS Run-Time Library.
Revision/Update Information: This manual supersedes the HP OpenVMS RTL General Purpose (OTS$) Manual for OpenVMS Alpha Version 7.3.
Software Version: OpenVMS I64 Version 8.2 OpenVMS Alpha Version 8.2
© 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
The HP OpenVMS documentation set is available on CD-ROM.
This manual provides users of the OpenVMS operating system with detailed usage and reference information on general-purpose routines supplied in the OTS$ facility of the Run-Time Library.
This manual is intended for system and application programmers who write programs that call OTS$ Run-Time Library routines.
This manual is organized into two parts as follows:
The Run-Time Library routines are documented in a series of reference manuals. A description of how the Run-Time Library routines are accessed and of OpenVMS features and functionality available through calls to the OTS$ Run-Time Library appears in the OpenVMS Programming Concepts Manual. Descriptions of other RTL facilities and their corresponding routines and usages are discussed in the following books:
The Guide to the POSIX Threads Library contains guidelines and reference information for HP POSIX Threads2, the HP Multithreading Run-Time Library.
Application programmers using any programming 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 manual. 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:
HP welcomes your comments on this manual. Please send comments to either of the following addresses:
How To Order Additional Documentation
For information on how to order additional documentation, visit the following World Wide Web address:
The following conventions are used in this manual:
This part of the HP OpenVMS RTL General Purpose (OTS$) Manual contains a general overview of the
routines provided by the OpenVMS RTL General Purpose (OTS$) Facility,
and lists them by function.
|OTS$CNVOUT||Convert a D-floating, G-floating, H-floating, IEEE S-floating or IEEE T-floating value to a character string.|
|OTS$CVT_L_TB||Convert an unsigned integer to binary text.|
|OTS$CVT_L_TI||Convert a signed integer to signed integer text.|
|OTS$CVT_L_TL||Convert an integer to logical text.|
|OTS$CVT_L_TO||Convert an unsigned integer to octal text.|
|OTS$CVT_L_TU||Convert an unsigned integer to decimal text.|
|OTS$CVT_L_TZ||Convert an integer to hexadecimal text.|
|OTS$CVT_TB_L||Convert binary text to an unsigned integer value.|
|OTS$CVT_TI_L||Convert signed integer text to an integer value.|
|OTS$CVT_TL_L||Convert logical text to an integer value.|
|OTS$CVT_TO_L||Convert octal text to an unsigned integer value.|
|OTS$CVT_TU_L||Convert unsigned decimal text to an integer value.|
|OTS$CVT_T_ x||Convert numeric text to a D-, F-, G-, H-, IEEE S-, or IEEE T-floating value.|
|OTS$CVT_TZ_L||Convert hexadecimal text to an unsigned integer value.|
For more information on Run-Time Library conversion routines, see the CVT$ reference section in the HP OpenVMS RTL Library (LIB$) Manual.
|OTS$DIVC x||Perform complex division.|
|OTS$DIV_PK_LONG||Perform packed decimal division with a long divisor.|
|OTS$DIV_PK_SHORT||Perform packed decimal division with a short divisor.|
|OTS$MOVE3||Move data without fill.|
|OTS$MOVE5||Move data with fill.|
|OTS$MULC x||Perform complex multiplication.|
|OTS$POWC xC x||Raise a complex base to a complex floating-point exponent.|
|OTS$POWC xJ||Raise a complex base to a signed longword exponent.|
|OTS$POWDD||Raise a D-floating base to a D-floating exponent.|
|OTS$POWDR||Raise a D-floating base to an F-floating exponent.|
|OTS$POWDJ||Raise a D-floating base to a longword integer exponent.|
|OTS$POWGG||Raise a G-floating base to a G-floating or longword integer exponent.|
|OTS$POWGJ||Raise a G-floating base to a longword integer exponent.|
|+OTS$POWHH_R3||Raise an H-floating base to an H-floating exponent.|
|+OTS$POWHJ_R3||Raise an H-floating base to a longword integer exponent.|
|OTS$POWII||Raise a word integer base to a word integer exponent.|
|OTS$POWJJ||Raise a longword integer base to a longword integer exponent.|
|OTS$POWLULU||Raise an unsigned longword integer base to an unsigned longword integer exponent.|
|OTS$POW xLU||Raise a floating-point base to an unsigned longword integer exponent.|
|OTS$POWRD||Raise an F-floating base to a D-floating exponent.|
|OTS$POWRJ||Raise an F-floating base to a longword integer exponent.|
|OTS$POWRR||Raise an F-floating base to an F-floating exponent.|
|OTS$POWSJ||Raise an IEEE S-floating base to a longword integer exponent.|
|OTS$POWSS||Raise an IEEE S-floating base to an S-floating or longword integer exponent.|
|OTS$POWTJ||Raise an IEEE T-floating base to a longword integer exponent.|
|OTS$POWTT||Raise an IEEE T-floating base to a T-floating or longword integer exponent.|
|OTS$SCOPY_DXDX||Copy a source string passed by descriptor to a destination string.|
|OTS$SCOPY_R_DX||Copy a source string passed by reference to a destination string.|
|OTS$SFREE1_DD||Free one dynamic string.|
|OTS$SFREEN_DD||Free n dynamic strings.|
|OTS$SGET1_DD||Get one dynamic string.|
|OTS$CALL_PROC||Perform a call to a procedure that may be either in native code or in a translated image.|
|OTS$JUMP_TO_BPV||Transfer control to a bound procedure.|
On Alpha and I64 systems, if you use the OTS$ entry points for certain mathematics routines, you must link against the DPML$SHR.EXE library. Alternately, you can use the equivalent math$ entry point for the routine and link against either STARLET.OLB or the DPML$SHR.EXE library. Math$ entry points are available only on Alpha and I64 systems.
Table 1-9 lists the affected OTS$ entry points with their equivalent math$ entry points. Refer to the Compaq Portable Mathematics Library for information about the math$ entry points.
|OTS$ Entry Point||Math$ Entry Point|