_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

  1. _GETTS64 returns zero if the input memory address is null (zero) or points to a location that cannot contain IBM PASE for i memory.

  2. _GETTS64_SPP returns zero if source is not a tagged space pointer or contains an address that is outside teraspace.

  3. _GETTS64 and _GETTS64_TS64 return a teraspace address regardless of whether there is currently any memory at the result location.


Related Information


API introduced: V5R3

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