Thread status
The current status of a thread is viewed from the General page in the Thread Properties window, under Detailed status.
| Value number | Status | Character-based interface value |
|---|---|---|
| 1 | Running | RUN |
| 2 | Job held | HLD |
| 3 | Held | HLDT |
| 4 | Stopped by a signal | SIGS |
| 5 | Waiting for save while active checkpoint | CMTW |
| 6 | Waiting for condition | CNDW |
| 7 | Waiting for dequeue | DEQA/DEQW |
| 8 | Waiting for event | EVTW |
| 9 | Waiting for activity level | INEL |
| 10 | Waiting for Java™ program | JVAA/JVAW |
| 11 | Waiting for lock | LCKW |
| 12 | Waiting for lock space | LSPW |
| 13 | Waiting for mutex | MTXW |
| 14 | Waiting for select | SELW |
| 15 | Waiting for semaphore | SEMW |
| 16 | Waiting for signal | SIGW |
| 17 | Waiting for thread | THDW |
| 18 | Waiting for time interval | TIMA/TIMW |
| 19 | Unknown | Blank |
Note: In properties, threads that have been held more than
once will have Held (n) status, where n is the number of times the
thread has been held. For performance reasons, the held count will
not be displayed in the Detailed Status column. For threads that are
waiting for a lock, a dequeue, or a lock space, additional information
is provided that identifies the item being waited on.
An example of a detailed status is:
- Waiting for dequeue
- The thread of the job is waiting for completion of a dequeue operation.
A dequeue is an operation for removing messages from queues. Messages
are communications sent from one person or program to another. In
particular, a message is enqueued (placed) on a queue system object
by one thread and dequeued (removed) by another thread. Note: When Waiting for dequeue is shown on a properties page, additional information that identifies the queue being waited on is displayed. When the job or thread is waiting on the dequeue operation to complete for an IBM® i object, you will see a 10-character object name, its library, and the object type. If the job or thread is waiting on the dequeue operation to complete for an internal object, you will see a 30-character object name. For internal objects you need job control special authority (*JOBCTL) to see the 30-character name.
The detailed status can display an associated status value, which provides additional details about the current status of the thread. An example of a detailed status plus the associated status value is:
- Held (n)
- An individual thread is held. Unlike a job, a thread can have multiple holds on it at the same time. A number (for example, Held (3)) following the thread status tells the user how many times that thread has been held without being released. For example, if a thread has had three holds put on it and then has been released once, it still has two holds against it. A number is only shown when the status appears on the properties page and will not appear when displayed in a list. To resume thread processing, select the Release action for the thread.
For more information about the different thread statuses, see the System i® Navigator online help.