_GETTS64M()--Get Multiple Teraspace Pointers for IBM PASE for i
Syntax
#include <as400_protos.h> void _GETTS64M(ts64_t *list, unsigned count);
Default Public Authority: *USE
Library: Standard C Library (libc.a)
Threadsafe: Yes
Note: This function 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 _GETTS64M() function retrieves teraspace address equivalents for a set of IBM PASE for i memory addresses.
Parameters
- list
- (Input/Output) Pointer to an array of type ts64_t into which the caller has stored IBM PASE for i memory addresses.
_GETTS64M replaces each IBM PASE for i memory address with an equivalent 64-bit teraspace address.
- count
- (Input) Specifies the number of entries in the list array.
Authorities
_GETTS64M requires no authority.
Return Value
_GETTS64M returns no function result.
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
- _GETTS64M returns null (zero) for any input address that is either zero or cannot contain IBM PASE for i memory. IBM PASE for i memory is allocated from teraspace, but teraspace has a limited capacity smaller than 64-bits, so IBM PASE for i can only provide addressability to a subset of a 64-bit address space.
- _GETTS64M returns (non-null) teraspace pointers regardless
of whether there is currently any memory at the IBM PASE for i addresses.
Related Information
- _CVTSPP()--Convert Space Pointer for IBM PASE for i
- _CVTTS64()--Convert Teraspace Address for IBM PASE for i
- _GETTS64() and _GETTS64_SPP--Get Teraspace Address 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