CA-GSS/ISERV Commands › GSS Extended Functions › DISPLAY ENQUEUES

DISPLAY ENQUEUES

This command lists all currently held enqueues that were obtained using the ENQUEUE() function.

Syntax

Display ENQueues

Example

------------------------ CA‑GSS/ISERVE Control Panel -------  ROW 1 TO 2 OF 2
==> display enqueues                                                  => PAGE
Target node: *                ssid: *    Host node: B1MAIN           ssid ISRV
==============================================================================
IMODID     STAT    LEVEL   COUNT      QNAME      RNAME
E 00001022 OWN     EXCL               GVAR       I/O.COUNTER.PHASE.1
E 00001295 SHR              2         GVAR       I/O.COUNTER.PHASE.1

prefix

One of these values:

Enqueue.

Lock. (Locks are not available for use by IMODs.)

IMODID

Hexadecimal ID of the IMOD that owns or is waiting for the resource.

STAT

Current ownership status, as follows:

OWN

IMOD has the requested level of ownership.

blank

IMOD is waiting for the requested ownership.

LEVEL

Level of ownership that was requested:

CONT

Control ownership. Other IMODs can have shared ownership of the resource, but they cannot have exclusive or control ownership of it.

EXCL

Exclusive ownership. Other IMODs cannot have any type of ownership of the resource.

SHR

Shared ownership. Other IMODs can have shared ownership of the resource, but they cannot have exclusive or control ownership of it.

COUNT

For SHR-type enqueues, the maximum permitted simultaneous SHR users.

QNAME

A one through eight character name that serves as a high-level qualifier of the resource.

RNAME

A 1 through 128 character name that, when appended to qname, uniquely identifies a resource. If the rname length exceeds the display width, it is wrapped onto the following lines.

Usage Notes

The IMOD tasks can use the ENQUEUE() function to serialize their use of resources. The enqueues that are obtained through this function are similar, but not identical to, z/OS system-level enqueues.