RetentionInterval (10-digit signed integer) on IBM i

Retention interval.

Local Model Alias Remote Cluster
X X

This is the time which the queue should be retained. After this time has elapsed, the queue is eligible for deletion.

The time is measured in hours, counting from the date and time when the queue was created. The creation date of the queue is recorded in the CreationDate and the create time of the queue is recorded in the CreationTime attribute.

This information is provided to enable a housekeeping application or the operator to identify and delete queues that are no longer required.

Note: The queue manager never tries to delete queues based on this attribute, or to prevent the deletion of queues with a retention interval that has not expired; it is the user's responsibility to cause any required action to be taken.

A realistic retention interval should be used to prevent the accumulation of permanent dynamic queues (see DefinitionType). However, this attribute can also be used with predefined queues.

To determine the value of this attribute, use the IARINT selector with the MQINQ call.

Parent topic: Attributes for queues