System Generation Statements › QUEUE Statement—Defines DC/UCF System Queues › QUEUE Statement Parameters

QUEUE Statement Parameters

QUEue queue-id

Specifies the queue identifier.

Queue-id must be a one- through 16-character alphanumeric value.

Version is version-number

Qualifies the queue with a version number.

Version-number must be an integer in the range 1 through 9,999. The default is 1.

Although multiple versions of a queue can exist in the data dictionary, the DC/UCF system uses only one version of a queue at runtime. If multiple ADD QUEUE statements specify the same queue identifier, the system uses the first statement that appears in the system definition.

ENAbled

Specifies the queue is be enabled when the DC/UCF system starts up.

ENABLED is the default when you specify neither ENABLED nor DISABLED in the QUEUE statement.

DISabled

Specifies the queue is not enabled when the DC/UCF system starts up.

Note: Users can override the ENABLED/DISABLED parameter at runtime for the duration of system execution with the DCMT VARY QUEUE command.

INVokes task task-code

Specifies the task the DC/UCF system invokes when the number of entries in the queue reaches the limit specified in the THRESHOLD parameter (see below).

Task-code must identify a task previously defined in the data dictionary with a TASK statement.

The INVOKES TASK parameter is required for ADD operations.

Note: Users can override this parameter at runtime for the duration of system execution with the DCMT VARY QUEUE command.

Version version-number

Qualifies the task code with a version number.

Version-number must be an integer in the range 1 through 9,999. The default is 1.

RETention is

Specifies the amount of time the DC/UCF system is to retain the queue. The retention period begins when the first record is stored in the queue.

queue-retention-period

Specifies the queue retention period in days.

Queue-retention-period must be an integer in the range 1 through 255. A retention period of 255 is synonymous with FOREVER. A retention period of 0 defaults to 1.

FORever

Directs the DC/UCF system not to delete the queue based on a retention period.

FOREVER is the default when you omit the RETENTION parameter from the QUEUE statement.

THReshold is queue-entry-count

Specifies the number of entries that must exist in the queue before the DC/UCF system invokes the task specified in the INVOKES TASK parameter to process the entries.

Queue-entry-count is an integer in the range 1 through 32,767. The default is 1.

Note: Users can override this parameter at runtime for the duration of system execution with the DCMT VARY QUEUE command.

UPper limit is maximum-entry-count

Specifies the maximum number of entries permitted in the queue.

Maximum-entry-count is an integer in the range 1 through 32,767. The default, 0, directs DC/UCF not to monitor the number of entries in the queue.

Note: Users can override this parameter at runtime for the duration of system execution with the DCMT VARY QUEUE command.