_GETTS64() and _GETTS64_SPP()--Get Teraspace Address for i5/OS PASE


  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 i5/OS PASE program. See i5/OS PASE for more information about creating i5/OS PASE programs.

The _GETTS64() function returns the 64-bit teraspace address equivalent of an i5/OS PASE 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 i5/OS PASE 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 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

  1. _GETTS64 returns zero if the input memory address is null (zero) or points to a location that cannot contain i5/OS PASE 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
Top | i5/OS PASE APIs | APIs by category