Retrieve Thread Identifier (RETTHID)

Built-in number for RETTHID is 516.
RETTHID (
) :   aggregate(8)  /* thread_identifier */

Description:   A thread identifier is returned which is unique within the process. While no two threads initiated within the same process will have the same identifier, it is possible that threads in different processes may have the same value for the identifier.

The thread identifier is used on some instructions to identify a thread. For example, it may be useful in associating queue space messages with a particular thread.

When a thread ends, its thread identifier is never reused within the process.

Authorization Required

• None

Lock Enforcement

• None

Exceptions

06 Addressing

• 0601 Space Addressing Violation
• 0602 Boundary Alignment
• 0603 Range

08 Argument/Parameter

• 0801 Parameter Reference Violation

10 Damage Encountered

• 1004 System Object Damage State
• 1044 Partial System Object Damage

1C Machine-Dependent

• 1C03 Machine Storage Limit Exceeded

20 Machine Support

• 2002 Machine Check
• 2003 Function Check

22 Object Access

• 2202 Object Destroyed
• 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
• 4402 Literal Values Cannot Be Changed