_GETTS64M()--Get Multiple Teraspace Pointers for i5/OS PASE
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 i5/OS PASE
program. See i5/OS PASE for more
information about creating i5/OS PASE programs.
The _GETTS64M() function retrieves teraspace address equivalents for a set of i5/OS PASE memory addresses.
Parameters
- list
- (Input/Output) Pointer to an array of type ts64_t into which the caller has stored i5/OS PASE memory addresses.
_GETTS64M replaces each i5/OS PASE 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 i5/OS exception message that the system
converts to an i5/OS PASE signal. See i5/OS PASE
Signal Handling for information about handling i5/OS exceptions.
Usage Notes
- _GETTS64M returns null (zero) for any input address that is either zero or cannot contain i5/OS PASE memory. i5/OS PASE memory is allocated from teraspace, but teraspace has a limited capacity smaller than 64-bits, so i5/OS PASE 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 i5/OS PASE addresses.
Related Information
API introduced: V5R3