_CVTSPP()--Convert Space Pointer for i5/OS PASE

 #include <as400_protos.h>

 void* _CVTSPP(const ILEpointer  *source);

Note: This function can only be used in an i5/OS PASE program. See i5/OS PASE for more information.

The _CVTSPP() function converts the teraspace address in a tagged space pointer to an equivalent i5/OS PASE memory address.

Parameters

source

(Input) Pointer to a tagged space pointer or 16-byte null pointer. The source address must 16-byte aligned.

Authorities

_CVTSPP requires no authority.

Return Value

_CVTSPP returns the i5/OS PASE memory address equivalent of the input tagged space pointer. The result is zero (null) if the input is a 16-byte null pointer or a tagged space pointer that does not contain the teraspace address equivalent of some valid i5/OS PASE memory address.

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. _CVTSPP returns an i5/OS PASE memory address regardless of whether there is currently any memory at that address (as long as the input tagged pointer contains the teraspace address equivalent of a valid i5/OS PASE memory address).

Related Information

• _CVTTS64()--Convert Teraspace Address for i5/OS PASE
• _GETTS64() and _GETTS64_SPP--Get Teraspace Address for i5/OS PASE
• _GETTS64M()--Get Multiple Teraspace Addresses for i5/OS PASE
• _SETSPP()--Set Space Pointer for i5/OS PASE
• _SETSPPM()--Set Multiple Space Pointers for i5/OS PASE