CA-GSS/ISERV Commands › CA-GSS/ISERVE Operator Commands › DISPLAY ENQUEUES

Previous Topic: DISPLAY EDITOR

Next Topic: DISPLAY FNTAB

DISPLAY ENQUEUES

Use the DISPLAY ENQUEUES command to list all currently held enqueues that were obtained using the ENQUEUE() function.

Syntax

Use this format for the DISPLAY ENQUEUES command:

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

Fields in the Example

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

1- to 8-character name that serves as a high-level qualifier of the resource.

RNAME

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

Usage Notes

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