TASKLCK view

To display information about IBM CICS tasks that have outstanding lock conditions, perform one of the following actions:

Hyperlink from the
- Lock Analysis field of the EZCFSSI, EZCFAST, EZCICS, and EZCMTASK Easy menus
- All Locks field of the EZCSTSK Easy menu
- Suspend Type field of the CTASK view
Issue the following command:
TASKLCK [target [tranID [lockType [lockName]]]]
where

Related topic

Task-views

Parameter	Description
target	Is the specific or generic name of a target CICS region
tranID	Is the specific or generic name of a transaction
lockType	Specifies the type of lock condition, as follows: L local locks G global locks R RLS file locks
lockName	Is up to 12 characters of a lock name

The following figure is displayed.

ddmmmyyyy hh:mm:ss ------ BMC AMI Ops WINDOW INTERFACE (Vv.r.mm) --------------
COMMAND ===>                                                 SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>
>W1 =TASKLCK==========(ALL======*=======)ddmmmyyyy==hh:mm:ss====MVCICS===D===38
CMD Task Target   Tran S L H HoldWait Short Lock   Suspend Suspend Suspend
--- ID             ID T T W Time       Name       Type    Resource Time
       87 BCVCP53E PRGE S G H 01:21:38 PENQGBLPAT1 ICWAIT            01:21:38
       87 BCVCP53E PRGE S G H 01:21:38 PENQGBLXXX5+ ICWAIT            01:21:38
      102 BCVCP64E PRG2 S G W 01:21:30 PENQGBLPAT1 ENQUEUE TEST     00:00:00
      318 BCVCD640 PFLQ S L H 00:00:09 BCVM.CICS64+ ICWAIT   L426     00:00:09
      319 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
      323 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
      321 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
      318 BCVCD640 PFLQ S L H 00:00:09 BCVM.CICS64+ ICWAIT   L426     00:00:09
      320 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
      324 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
      322 BCVCD640 PFLN S L W 00:00:09 BCVM.CICS64+ ENQUEUE FCDSRECD 00:00:09
       87 BCVCP53E PRGE S L H 01:21:38 ...........+ ICWAIT            01:21:38
       91 BCVCP64E PATE S L H 00:03:10 .&.........+ ICWAIT            00:03:10
       91 BCVCP64E PATE S L H 00:03:10 thisis a ve+ ICWAIT            00:03:10
       91 BCVCP64E PATE S L H 00:03:10 thisresourc+ ICWAIT            00:03:10
       91 BCVCP64E PATE S L H 00:03:10 ABCD         ICWAIT            00:03:10
       91 BCVCP64E PATE S L H 00:03:10 ABCD,...?..+ ICWAIT            00:03:10

If the value in the Lock Type field is G, using the hyperlink displays TASKLCKG; if the field value is R, the link displays TASKLCKR. If the value is L, the hyperlink refreshes the TASKLCK view and only L-type records are displayed.

If the value in the Short Lock Name field is an address, the DUMP view is shown. If the value in the Lock Type field is R, using the Short Lock Name hyperlink displays the TASKLCKR view. If the value in the Pool Name field (visible by scrolling the display to the right) begins with FC, using the Short Lock Name hyperlink displays the TASKLCKF view.

Related views

The following views are part of the TASKLCK family of views.

View	Description
TASKLCKZ	Summary information is available for every field on the TASKLCK view. To see summary information, type Sum on the COMMAND line, place the cursor on the column that you want to summarize, and then press Enter. The results are displayed in the TASKLCKZ view. From the TASKLCKZ view (and any summary view), you can expand the count value to see the individual records that were used to summarize the selected line. In the case of TASKLCKZ, expanded records are displayed in the TASKLCK view.
TASKLCKQ	To display the Quick Menu for CICS tasks that have outstanding lock conditions, hyperlink from the Task ID field of the TASKLCK view.
TASKLCKD	To display detail information about CICS tasks that have outstanding lock conditions, hyperlink from the Task Status field of the TASKLCK view.
TASKLCK2	To display detail information about CICS tasks that have outstanding lock conditions, including their 255-byte name and hexadecimal equivalent, hyperlink from the Enq Name (51 characters) field of the TASKLCKD view.
TASKLCKG	To display detail information about CICS tasks that have outstanding global lock conditions, hyperlink from the Lock Type field on the TASKLCK view when that field contains a value of G. The TASKLCKG view displays global resources and their holders and waiters. Because it is difficult to synchronize times across multiple CICS systems, the view is sorted by enqueue name, followed by the holder/waiter indicator, followed by the hold/wait time. Therefore, it is possible that the longest holder with waiters may not be at the top of the list. If the value Short Lock Name field is an address, using the hyperlink displays the DUMP view. If the value in the Lock Type field is R, using the Short Lock Name hyperlink displays the TASKLCKR view. If the value in the Pool Name field (visible by scrolling the display to the right) begins with FC, using the Short Lock Name hyperlink displays the TASKLCKF view
TASKLCKH	This view is a summary view for the TASKLCKG view. From the TASKLCKH view (and any summary view), you can expand the count value to see the individual records that were used to summarize the selected line. In the case of TASKLCKH, expanded records are displayed in the TASKLCK view.
TASKLCKR	To display information about CICS tasks that have outstanding RLS-type lock conditions, hyperlink from the Short Lock Name field on the TASKLCK view when the value in the TASKLCK view’s Lock Type field is R. The TASKLCKR view displays only RLS lock-type entries.
TASKLCKS	This view is a summary view for the TASKLCKR view. From the TASKLCKS view (and any summary view), you can expand the count value to see the individual records that were used to summarize the selected line. In the case of TASKLCKS, expanded records are displayed in the TASKLCK view.
TASKLCKF	To display detail information about CICS tasks that have outstanding non RLS lock conditions, hyperlink from the Short Lock Name field on the TASKLCKF view when the value in the Pool Name field (visible by scrolling the display to the right) begins with FC.
TASKLCKY	This view is a summary view for the TASKLCKF view. From the TASKLCKY view (and any summary view), you can expand the count value to see the individual records that were used to summarize the selected line. In the case of TASKLCKY, expanded records are displayed in the TASKLCK view.

Using the TASKLCK view

The tasks that are shown in the TASKLCK view either are waiting for a resource that is held by another task or are holding a resource for which another task is waiting.

The TASKLCK view is filtered in this order: target name, transaction ID, lock type, and user/system indicator. The target name, transaction ID, and lock type all default to *; the user/system indicator defaults to U for user tasks only.

System tasks

Because system tasks do not cause locking within general user applications, they are filtered from the TASKLCK views. The information is still collected and can be displayed by the following command:

TASKLCK * * * *

Lock Type field

The LT field (lock type) can have one of three values:

L local resource
G global resource
R RLS resource

The LT field serves as a hyperlink. The destination of the hyperlink depends on the displayed value:

Hyperlinking on an R value displays the TASKLCKR view. This tabular view is filtered to display only RLS file lock entries.
Hyperlinking on an L value refreshes the TASKLCK view with entries that have a lock type of L.

TASKLCK view showing only L-type records

ddmmmyyyy hh:mm:ss ------ BMC AMI Ops WINDOW INTERFACE (Vv.r.mm) --------------
COMMAND ===>                                                 SCROLL ===> PAGE
CURR WIN ===> 1        ALT WIN ===>
>W1 =TASKLCK==TASKLCK=(BCVDVPC==*=======)ddmmmyyyy==hh:mm:ss====MVCICS===D===12
CMD Task Target   Tran S L H HoldWait Short Lock   Suspend Suspend Suspend
--- ID             ID T T W Time       Name       Type    Resource Time
       55 BCVCD630 PFLQ S L H 00:00:06 BCVM.CICS63+ ICWAIT   L415     00:00:06
       56 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       60 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       55 BCVCD630 PFLQ S L H 00:00:06 BCVM.CICS63+ ICWAIT   L415     00:00:06
       57 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       61 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       58 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       59 BCVCD630 PFLN S L W 00:00:06 BCVM.CICS63+ ENQUEUE FCDSRECD 00:00:06
       30 BCVCD630 BCRT S L H 00:14:57 BBK1CRTR                       00:00:00
       31 BCVCD640 BCRT S L H 00:14:50 BBK1CRTR                       00:00:00
       27 BCVCD630 JNL2 S L H 00:14:57 CMRJRNL                        00:00:00
       28 BCVCD640 JNL2 S L H 00:14:50 CMRJRNL                        00:00:00

Hyperlinking on an G value displays the TASKLCKG view which shows global resources and their holders and waiters.

Hold/Wait field

H indicates the task is holding the resource. W indicates it is waiting for the resource.

A green H indicates that there are no tasks waiting for the held resource.
A yellow H indicates a that there are tasks waiting for held the resource.
A red W indicates the task is waiting for a resource.

The Hold/Wait field serves as a filtering hyperlink. Clicking on any value refreshes the TASKLCK view and displays only those records with the same enqueue name as the selected record.

TASKLCK view filtered to show resources with the same name

Short Lock Name field

The Short Lock Name field serves as a variable hyperlink:

If the value in the Lock Type field is R, using the Short Lock Name hyperlink displays the TASKLCKR view.
If the value in the Pool Name field (visible by scrolling the display to the right) begins with FC, using the Short Lock Name hyperlink displays the TASKLCKF view.