DCMT VARY QUEUE

DCMT VARY QUEUE changes queue attributes.
idmscu19
DCMT VARY QUEUE changes queue attributes.
The following topics are discussed on this page:
Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────►             └─ 
broadcast-parms
 ─┘  ►─── Vary QUeue 
queue-id
 ────────────────────────────────────────────────────►  ►─┬─ ONline ────────────────────────────────┬────────────────────────────────►◄    ├─ OFfline ───────────────────────────────┤    ├─ Maximum records 
max-entry-count
 ───────┤    ├─ TAsk code 
task-code
 ───────────────────┤    ├─ THreshold count 
queue-entry-count
 ─────┤    └─ DELete ────────────────────────────────┘
Parameters
  • broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members.
    For more information about broadcasting and
    broadcast-parms
    syntax, see the section How to Broadcast System Tasks.
  • queue-id
    The ID of the queue to be varied, as defined on the system generation QUEUE statement.
  • ONline
    Varies the queue online.
  • OFfline
    Varies the queue offline.
  • Maximum Records
    Varies the maximum entry count for the queue.
    A maximum entry count of 0 directs DC/UCF not to monitor the number of records in the queue. The maximum record count is initially established at system generation time by the UPPER LIMIT parameter of the QUEUE statement.
  • max-entry-count
    The new maximum entry count: an integer in the range 0 through 32,767.
  • TAsk code
    Varies the task invoked to process queue records for the queue.
    The task invoked for a queue is initially established at system generation time by the INVOKES TASK parameter of the QUEUE statement.
  • task-code
    The code of the new task, as assigned to a task in the data dictionary.
  • THreshold count
    Varies the threshold count for the queue.
    The threshold count is the number of entries that must exist in the queue before DC/UCF invokes the task associated with the queue. The threshold count is initially established at system generation time by the THRESHOLD parameter of the QUEUE statement.
  • queue-entry-count
    The new threshold count: an integer in the range 1 through 32,767.
  • DELete
    Deletes the named queue from the queue area. DELETE has no effect of queues defined at system generation time and stored in the data dictionary.
More Information
  • For more information about queue definition in the data dictionary, see the documentation of the QUEUE statement in the IDD DDDL Reference
    section
    .
  • For more information about queue definition at system generation time, see the documentation of 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 displaying queue attributes, see the section DCMT DISPLAY QUEUE.
Usage
Varying a Queue Online or Offline
A queue is initially defined as online or offline at system generation time by the ENABLED/DISABLED parameter of the QUEUE statement. The following considerations apply:
  • When a disabled queue that has exceeded its threshold is varied ONLINE, the task associated with the queue is invoked at the next request to place a record in the queue.
  • Varying a queue OFFLINE prevents the task associated with the queue from being invoked to process queue records. However, records can still be written to the queue until the maximum entry count is reached.
Example
DCMT VARY QUEUE queue-id OFFLINE
      VARY QUEUE OLQQNOTE OFFLINE IDMS DC265002 V105 USER:JSMITH   QUEUE OLQQNOTE VARIED OFFLINE
DCMT VARY QUEUE queue-id THRESHOLD COUNT
      VARY QUEUE OLQQNOTE THRESHOLD COUNT 5 IDMS DC265003 V105 USER:JSMITH   THRESHOLD VARIED FROM 00001 TO 00005