CEMT INQUIRE ENQ
|CEMT INQUIRE ENQ
|Function: Retrieve information about enqueues held or
| waited on by a UOW, or about UOWs holding or waiting on a
| specified enqueue.
|Description: INQUIRE ENQ returns information about the
| enqueues held by a UOW. Enqueues are used by CICS to
| lock recoverable resources such as file records or queues to
| the UOW that is updating them. User enqueues obtained by
| the EXEC CICS ENQ command are also returned.
| You can use INQUIRE ENQ to indicate which records and
| queues would be affected if the UOW were forced.
| The transaction also returns information about UOWs that
| are waiting on the enqueues. This enables you to diagnose
| enqueue deadlocks between tasks wanting to update the
| same resources.
| Enqueues are typically held in active state, which means that
| other tasks are allowed to wait for the enqueue. However, if
| the UOW that owns the enqueue suffers an in-doubt failure,
| the enqueue is usually converted to the retained state until
| the in-doubt failure can be resolved. INQUIRE ENQ also
| retrieves information about these enqueues and can be used
| to identify which records and queues would be affected if the
| UOW were forced.
|Notes:
| 1. Both UOW-lifetime and task-lifetime enqueues are
| returned by INQUIRE ENQ. (For an explanation of
| UOW- and task-lifetime enqueues, see the
| MAXLIFETIME option of the EXEC CICS ENQ command
| in the
CICS System Programming Reference
manual.)
| 2. On an in-doubt failure, user enqueues are released,
|
unless
the EXEC CICS ENQ command specified
| MAXLIFETIME(TASK) and it is not the end-of-task
| syncpoint that suffers the failure.
|Input: Press the Clear key to clear the screen. There are
| two ways of commencing this transaction:
|Type CEMT INQUIRE ENQ (theminimum abbreviation is
|CEMT I ENQ). You get a display that lists all enqueues for
| all the current UOWs.
|Type CEMT INQUIRE ENQ (CEMT I ENQ)followed by as
| many of the other attributes as are necessary to limit the
| range of information that you require. So, for example, if
| you enter cemt i enq d, the resulting display shows you
| the details only of enqueues on records in VSAM data
| sets open in non-RLS mode or CICS-maintained data
| tables.
|
|55─ ──CEMT Inquire Enq ──┬ ┬──────────── ──────────5
|└┘──Uow(value)
|5─ ──┬ ┬──────────────���─ ──┬ ┬─────────────── ──────5
|└┘──TRansid(value)└ ┘──TAskid(value)
|5─ ──┬ ┬────────── ──┬ ┬───────────── ──────────────5
| ├ ┤─ACtive─── ├ ┤─Dataset─────
| └ ┘─RETained─ ├ ┤─File────────
| ├┤─EXecenq─────
| ├┤─ADdrexecenq─
| ├┤─TDq─────────
| └┘─TSq─────────
|5─ ──┬ ┬──────── ──┬ ┬───────────────── ────────────5
|├┤─Owner── └ ┘──Netuowid(value)
| └ ┘─Waiter─
|5─ ──┬ ┬───────────────── ──┬ ┬───────────────── ───5
|└┘──ENqfails(value)└ ┘──RESource(value)
|5─ ──┬ ┬───────────── ──┬ ┬────────────────── ──────5
|└┘──RLen(value)└ ┘──QUalifier(value)
|5─ ──┬ ┬───────────── ─5%
|└┘──QLen(value)
| Sample screen
|à
|ð
| INQ ENQ
| STATUS: RESULTS
|Enq(AC143ðð1D4A726ð1) Tra(CECI) Tas(ððððð38) Act Exe Own
|Res(ACCOUNTS.DBASE1 ) Rle(ð15) Enq(ðððððððð)
|Enq(AC143ðð1D4A726ð1) Tra(CECI) Tas(ððððð38) Act Add Own
|Res(g... ) Rle(ðð4) Enq(ðððððððð)
|
Figure 69. CEMT INQUIRE ENQscreen
|Note: There are blank fields on the screen where a value
| does not apply or is ‘negative’; that is, the value
| begins with ‘No’. To modify these fields, locate them
| by tabbing (they appear in the same sequence as in
| the expanded format), and overtype with input valid
| for that field. You may find it more convenient to use
| the expanded format when setting one of these
| values, (negating is easier because you are
| overtyping a displayed field with its negative causing
| the result to become non-displayed).
| If you place the cursor against a specific entry in the list and
| press ENTER, CICS displays an expanded format as shown
| in Figure 70.
|à
|ð
| INQ ENQ
| RESULT
| Enq
| Enq(AC143ðð1D4A726ð1)
| Transid(CECI)
| Taskid(ððððð38)
| State(Active)
| Type(Execenq)
| Relation(Owner)
| Duration()
| Resource(ACCOUNTS.DBASE1)
| Rlen(ð15)
| Enqfails(ðððððððð)
| Netuowid(..GBIBMIYA.IYA2T5C2...Mx...)
| Qualifier()
| Qlen(ððð)
|
Figure 70. The expanded displayof anindividual entry
80 CICS Supplied Transactions