DCMT DISPLAY QUEUE Command

DCMT DISPLAY QUEUE displays information associated with DC/UCF queues.
idmscu19
DCMT DISPLAY QUEUE displays information associated with DC/UCF queues.
This article describes the following information:
Syntax
►►─ DCMT ─┬───────────────────┬─────────────────────────────────────────►           └─ broadcast-parms ─┘  ►─ Display ─┬─ QUeue queue-id ────┬────────────────────────────────────►◄              └─ QUeues ─┬────────┬─┘                         └─ *ALL ─┘
Parameters
  • broadcast-parms
    Executes the DCMT command on all or a list of data sharing group members.
    For more information about broadcasting and broadcast-parms syntax, see
    Reference section
    .
  • QUeue
    Displays information about a specific queue.
  • queue-id
    Identifies the queue to be displayed. queue-id must be the identifier of the queue to be displayed.
  • QUeues
    Displays information about multiple queues.
  • *ALL
    Displays information about all queues known to the system. This includes both queues defined at system generation time and those defined dynamically.
    If *ALL is not specified, information is displayed only for queues defined at system generation time.
Usage
Queues Listed in the Queue Definition Table
The queue definition table includes only queues defined at system generation time. Dynamically created queues (that is, queues created by PUT QUEUE commands) are not displayed.
Display for a Specified Queue
DCMT DISPLAY QUEUE displays the following information for a specified queue:
Field
Value
Queue Name
Queue name
Task Code
The name of the task invoked to process queue records
Times Invoked
Number of times the queue task has been invoked
Queue Status
The status of the queue:
INSRV
OUTSRV
Current Rec Cnt
Count of records currently in the queue
Threshold Cnt
The number of records written to the queue before the task is invoked
Max Rec Cnt
Maximum record count (that is, the maximum number of entries permitted in the queue; if 0, no limit exists)
Date Created
The date the queue was created
Retention
The retention period of the queue
Global
YES indicates that the queue is shared between data sharing members; NO indicates that the queue is local to the current CV
Display for All Queues
DCMT DISPLAY QUEUES displays the following information for all queues:
Field
Value
Queue Name
The name of the queue
Taskcode/Invoked
The name of the task invoked to process queue records and the number of times it was invoked
Curr
Count of records currently in the queue
Thrt
The threshold count
Max
Maximum record count (that is, the maximum number of entries permitted in the queue; if 0, no limit exists)
Ret
The retention period of the queue
Global
YES indicates that the queue is shared between data sharing members; NO indicates that the queue is local to the current CV
Example
The following example displays all queues defined to the DC/UCF system.
  DCMT D QUEUE *ALL                                                  *** QUEUE DEFINITION TABLE ***                               QUEUE NAME    TASKCODE/INVOKED CURR THRT  MAX  RET GLOBAL   $ADCTEST       1                 00004 00000 0000 255 NO       $ADSCIDX                         00001 00000 0000 255 NO       JPDD1                            00003 00000 0000 255 NO       JPDX1                            00003 00000 0000 255 NO       JPDX2                            00002 00000 0000 255 NO       KJMQUE1                          00001 00000 0000 255 NO       KJMQUE2                          00001 00000 0000 255 NO       OLQQNOTE         OLQTNOTE/00000  00000 00001 0000 001 NO       RTSVQ                            00002 00000 0000 255 NO       TASK_ANALYZER_12                 00001 00000 0000 255 NO      
More Information
  • For more information about varying queue attributes, see the section DCMT VARY QUEUE.
  • For more information about deleting queues, see the section QUED.
  • For more information about queue definition in the data dictionary, see documentation of the QUEUE statement in the
    IDD DDDL Reference section
    .
  • For more information about queue definition at system generation time, see documentation of the QUEUE statement in the
    Administrating section
    .
  • For more information about PUT QUEUE commands, see the
    DML Reference section for COBOL
    .
  • For more information about queue management, see the
    Navigational DML Administrating section
    .
  • For more information about queue definition tables, see the
    System Reference section
    .
  • For more information about sharing the queue area in a data sharing environment, see the
    System Reference section
    .