Test Temporary Object (TESTTOBJ)

Op Code (Hex)	Extender	Operand 1	Operand 2 [3]
TESTTOBJB 1CA1	Branch options	Object	Branch targets

TESTTOBJI 18A1	Indicator options	Object	Indicator targets

Operand 1: System pointer.

Operand 2 [3]:

Branch Form-Instruction number, relative instruction number, branch point, or instruction pointer.
Indicator Form-Numeric variable scalar or character variable scalar.

Bound program access

Built-in number for TESTTOBJ is 462.
TESTTOBJ (
          object   : address of system pointer
) :   signed binary(4) /* return_code */

The return code will be set as follows:

Return code	Meaning
1	Pointer addresses temporary object
0	Pointer does not address temporary object (permanent object)

This built-in function is used to provide support for the branch and indicator forms of the TESTTOBJ operation. The user must specify code to process the return code and perform the desired branching or indicator setting.

Description

The object addressed by the pointer in operand 1 is checked to determine if it is a temporary object.

Note: A temporary object is an object that does not persist across IPL's. It is automatically destroyed at system termination.

Based on results, the resulting condition is used with the extender to transfer control (branch form) or to assign a value to indicator operand (indicator form).

Operand 1

The object to be tested is addressed by this system pointer. Any system object can be tested. An unresolved system pointer will be resolved by this instruction.

Resultant Conditions

Temporary-The object specified by the system pointer is a temporary object.
This is the equal condition.
Not temporary-The object specified by the system pointer is not a temporary object. It is a permanent object.
This is the unequal condition.

Authorization Required

Object management
- Operand 1
Execute
- Context referenced for address resolution

Lock Enforcement

Materialize
- Operand 1
- Context referenced for address resolution

Exceptions

06 Addressing

0601 Space Addressing Violation
0602 Boundary Alignment
0603 Range

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

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