Retrieve Thread Count (RETTHCNT)

Built-in number for RETTHCNT is 514.
RETTHCNT (
) :   unsigned binary(4)  /* count */

Description:   A count of the number of threads that have been implicitly or explicitly initiated within the process and which have not yet terminated is returned.

Since process initiation implicitly initiates a thread, the minimum value of count is 1.

It is possible that this instruction may be used in a cancel or return handler for a thread that is terminating. If it is, the count that will be returned will still include the terminating thread.

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