Used in conjunction with CBL_THREAD_LIST_NEXT and CBL_THREAD_LIST_END to obtain a list of all currently existing threads that the run-time system knows about.
call "CBL_THREAD_LIST_START" using by reference thread-id by reference thread-state by reference thread-iddata
Using call prototype (see Library Routines - Key) | Picture (32-bit systems) | |
---|---|---|
thread-id | cblt-pointer | usage pointer. |
thread-state | cblt-x4-compx | pic x(4) comp-x. |
thread-iddata | cblt-pointer | usage pointer. |
None.
thread-id | First thread identifier in this routine's internal list | ||||||||||||||||||||||
thread-state | The state of the thread:
| ||||||||||||||||||||||
thread-iddata | A pointer to the thread's id-data, if that data area exists (otherwise NULL). id-data is specified by the routine CBL_THREAD_ALLOC_IDDATA. | ||||||||||||||||||||||
return-code | A value indicating success or otherwise. See RETURN-CODE Values For Thread-control Routines |
Only information on existing threads, that is, threads that have not terminated, is returned. This routine will not return a thread-id for a thread that has terminated but has not been detached.