_CVTSPP()--Convert Space Pointer for IBM PASE for i

 #include <as400_protos.h>

 void* _CVTSPP(const ILEpointer  *source);

Note: This function can only be used in an IBM^® i PASE program. See the IBM PASE for i topic collection for more information.

The _CVTSPP() function converts the teraspace address in a tagged space pointer to an equivalent IBM PASE for i 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 IBM PASE for i 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 IBM PASE for i memory address.

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. _CVTSPP returns an IBM PASE for i 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 IBM PASE for i memory address).

Related Information

• _CVTTS64()--Convert Teraspace Address for IBM PASE for i
• _GETTS64() and _GETTS64_SPP--Get Teraspace Address for IBM PASE for i
• _GETTS64M()--Get Multiple Teraspace Addresses for IBM PASE for i
• _SETSPP() and _SETSPP_TS64()--Set Space Pointer for IBM PASE for i
• _SETSPPM()--Set Multiple Space Pointers for IBM PASE for i

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