Set Space Pointer from Pointer (SETSPPFP)

Op Code (Hex)	Operand 1	Operand 2
0022	Receiver	Source pointer

Operand 1: Space pointer.

Operand 2: Data pointer, system pointer, or space pointer.

Bound program access
Built-in number for SETSPPFP is 141. SETSPPFP ( source_pointer : system pointer OR data pointer OR space pointer(16) ) : address /* receiver */ The `source pointer` operand corresponds to operand 2 on the SETSPPFP operation. The return value corresponds to operand 1 after the function completes.

Bound program access

Built-in number for SETSPPFP is 141. SETSPPFP ( source_pointer : system pointer OR data pointer OR space pointer(16) ) : address /* receiver */

The source pointer operand corresponds to operand 2 on the SETSPPFP operation. The return value corresponds to operand 1 after the function completes.

Description: A space pointer is returned in operand 1 with the addressability to a space from the pointer specified by operand 2.

The meaning of the pointers allowed for operand 2 is as follows:

Pointer	Meaning
Data pointer or space pointer	The space pointer returned in operand 1 is set to address the same byte addressed by the operand 2 source pointer.
System pointer	The space pointer returned in operand 1 is set to address the first byte of the space associated with the system object addressed by the system pointer for operand 2. If the operand 2 system pointer addresses a system object with no associated space, the invalid space reference (hex 0605) exception is signaled.

The object destroyed (hex 2202) exception, parameter reference violation (hex 0801) exception, and pointer does not exist (hex 2401) exception are not signaled when operand 1 and operand 2 are space pointer machine objects. This occurs when operand 2 contains an internal machine value that indicates one of these error conditions exists. If the corresponding exception is not signaled, operand 1 is set with an internal machine value that preserves the exception condition that existed for operand 2. The appropriate exception condition will be signaled for either pointer when a subsequent attempt is made to reference the space data that the pointer addresses.

Authorization Required

Space authority
- Operand 2 (if a system pointer)
Execute
- Contexts referenced for address resolution

Lock Enforcement

Materialize
- Contexts referenced for address resolution

Exceptions

06 Addressing

0601 Space Addressing Violation
0602 Boundary Alignment
0603 Range
0604 External Data Object Not Found
0605 Invalid Space Reference

08 Argument/Parameter

0801 Parameter Reference Violation

0A Authorization

0A01 Unauthorized for Operation

10 Damage Encountered

1004 System Object Damage State
1005 Authority Verification Terminated Due to Damaged Object
1044 Partial System Object Damage

1A Lock State

1A01 Invalid Lock State

1C Machine-Dependent

1C03 Machine Storage Limit Exceeded

20 Machine Support

2002 Machine Check
2003 Function Check

22 Object Access

2201 Object Not Found
2202 Object Destroyed
2203 Object Suspended
2204 Object Not Eligible for Operation
2207 Authority Verification Terminated Due to Destroyed Object
2208 Object Compressed
220B Object Not Available

24 Pointer Specification

2401 Pointer Does Not Exist
2402 Pointer Type Invalid
2403 Pointer Addressing Invalid Object Type

2E Resource Control Limit

2E01 User Profile Storage Limit Exceeded

36 Space Management

3601 Space Extension/Truncation

44 Protection Violation

4401 Object Domain or Hardware Storage Protection Violation
4402 Literal Values Cannot Be Changed