_GETTS64() and _GETTS64_SPP()--Get Teraspace Address for IBM PASE for i
Syntax
#include <as400_protos.h> ts64_t _GETTS64(const void *memory); ts64_t _GETTS64_SPP(const ILEpointer *source);
Default Public Authority: *USE
Library: Standard C Library (libc.a)
Threadsafe: Yes
Note: These functions can only be used in an IBM® i PASE program. See the IBM PASE for i topic collection for more information about creating IBM PASE for i programs.
The _GETTS64() function returns the 64-bit teraspace address equivalent of an IBM PASE for i memory address. The _GETTS64_SPP() function returns the 64-bit teraspace address stored in a 16-byte space pointer.
Parameters
- memory
- (Input) Pointer containing either an IBM PASE for i memory address, or a null pointer (zero).
- source
- (Input) Pointer to a 16-byte tagged space pointer or 16-byte null pointer.
Authorities
_GETTS64 and _GETTS64_SPP require no authority.
Return Value
_GETTS64 and _GETTS64_SPP return a 64-bit teraspace address or zero.
Error Conditions
Any error is reported with an IBM i exception message that the system converts to an IBM PASE for i signal. See IBM PASE for i Signal Handling for information about handling IBM i exceptions.
Usage Notes
- _GETTS64 returns zero if the input memory address is null (zero) or points to a location that cannot contain IBM PASE for i memory.
- _GETTS64_SPP returns zero if source is not a tagged space pointer or contains an address that is outside teraspace.
- _GETTS64 and _GETTS64_TS64 return a teraspace address regardless of whether there is currently any memory at the result location.
Related Information
- _CVTSPP()--Convert Space Pointer for IBM PASE for i
- _CVTTS64()--Convert Teraspace Address for IBM PASE for i
- _GETTS64M()--Get Multiple Teraspace Addresses for IBM PASE for i
- _SETSPP() and _SETSPP_TS64()--Set Space Pointer for IBM PASE for i
- _SETSPPM()--Set Multiple Space Pointers for IBM PASE for i
API introduced: V5R3