_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

  1. _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.

  2. _GETTS64M returns (non-null) teraspace pointers regardless of whether there is currently any memory at the IBM PASE for i addresses.


Related Information


API introduced: V5R3

[ Back to top | IBM PASE for i APIs | APIs by category ]