reply queue aliasing, reply queue, aliasing, queue-manager aliasing, queue manager" /> Attributes for queues
Home

 

Attributes for queues

 

Types of queue: The queue manager supports the following types of queue definition:

Local queue

This is a physical queue that stores messages and can be one of the following:

Local queue manager queue

The queue exists on the local queue manager (private in z/OS parlance).

Shared queue (z/OS only)

This is a physical queue that stores messages. The queue exists in a shared repository that is accessible to all the queue managers that belong to the queue-sharing group that owns the shared repository.

Applications connected to any queue manager in the queue-sharing group can place messages on and remove messages from queues of this type. Such queues are effectively the same as local queues. The value of the QType queue attribute is MQQT_LOCAL.

Applications connected to the local queue manager can place messages on and remove messages from queues of this type. The value of the QType queue attribute is MQQT_LOCAL.

Cluster queue

This is a physical queue that stores messages. The queue exists either on the local queue manager, or on one or more of the queue managers that belong to the same cluster as the local queue manager.

Applications connected to the local queue manager can place messages on queues of this type, regardless of the location of the queue. If an instance of the queue exists on the local queue manager, the queue behaves in the same way as a local queue, and applications connected to the local queue manager can remove messages from the queue. The value of the QType queue attribute is MQQT_CLUSTER.

Remote queue

This is not a physical queue; it is the local definition of a queue that exists on a remote queue manager. The local definition of the remote queue contains information that tells the local queue manager how to route messages to the remote queue manager.

Applications connected to the local queue manager can place messages on queues of this type; the messages are placed on the local transmission queue used to route messages to the remote queue manager. Applications cannot remove messages from remote queues. The value of the QType queue attribute is MQQT_REMOTE.

We can also use a remote queue definition for:

  • Reply-queue aliasing

    In this case the name of the definition is the name of a reply-to queue. For more information, see WebSphere MQ Intercommunication.

  • Queue-manager aliasing

    In this case the name of the definition is an alias for a queue manager, and not the name of a queue. For more information, see WebSphere MQ Intercommunication.

Alias queue

This is not a physical queue; it is an alternative name for a local queue, a shared queue, a cluster queue, or a remote queue. The name of the queue to which the alias resolves is part of the definition of the alias queue.

Applications connected to the local queue manager can place messages on queues of this type; the messages are placed on the queue to which the alias resolves. Applications can remove messages from queues of this type if the alias resolves to a local queue, a shared queue, or a cluster queue that has a local instance. The value of the QType queue attribute is MQQT_ALIAS.

Model queue

This is not a physical queue; it is a set of queue attributes from which a local queue can be created.

Messages cannot be stored on queues of this type.

Queue attributes: Some queue attributes apply to all types of queue; other queue attributes apply only to certain types of queue. The types of queue to which an attribute applies are shown in Table 82 and subsequent tables.

Table 82 summarizes the attributes that are specific to queues. The attributes are described in alphabetic order.

Note:
The names of the attributes shown in this book are descriptive names used with the MQINQ and MQSET calls; the names are the same as for the PCF commands. When MQSC commands are used to define, alter, or display attributes, alternative short names are used; see the WebSphere MQ Script (MQSC) Command Reference for details.
Table 82. Attributes for queues The columns apply as follows:

  • The column for local queues applies also to shared queues.

  • The column for model queues indicates which attributes are inherited by the local queue created from the model queue.

  • The column for cluster queues indicates the attributes that can be inquired when the cluster queue is opened for inquire alone, or for inquire and output. If the cluster queue is opened for inquire plus one or more of input, browse, or set, the column for local queues applies instead.
Attribute Description Local Model Alias Remote Cluster Topic
AlterationDate Date when definition was last changed Yes No Yes Yes No AlterationDate
AlterationTime Time when definition was last changed Yes No Yes Yes No AlterationTime
BackoutRequeueQName Excessive backout requeue queue name Yes Yes No No No BackoutRequeueQName
BackoutThreshold Backout threshold Yes Yes No No No BackoutThreshold
BaseQName Queue name to which alias resolves No No Yes No No BaseQName
CFStrucName Coupling-facility structure name Yes Yes No No No CFStrucName
ClusterName Name of cluster to which queue belongs Yes No Yes Yes Yes ClusterName
ClusterNamelist Name of namelist object containing names of clusters to which queue belongs Yes No Yes Yes No ClusterNamelist
CLWLQueuePriority Cluster workload queue priority Yes No Yes Yes Yes CLWLQueuePriority
CLWLQueueRank Cluster workload queue rank Yes No Yes Yes Yes CLWLQueueRank
CLWLUseQ Use remote queue Yes No No No No CLWLUseQ
CreationDate Date that the queue was created Yes No No No No CreationDate
CreationTime Time that the queue was created Yes No No No No CreationTime
CurrentQDepth Current queue depth Yes No No No No CurrentQDepth
DefBind Default binding Yes No Yes Yes Yes DefBind
DefinitionType Queue definition type Yes Yes No No No DefinitionType attribute
DefInputOpenOption Default input open option Yes Yes No No No DefInputOpenOption
DefPersistence Default message persistence Yes Yes Yes Yes Yes DefPersistence
DefPriority Default message priority Yes Yes Yes Yes Yes DefPriority
DistLists Distribution list support Yes Yes No No No DistLists
HardenGetBackout Whether to maintain an accurate backout count Yes Yes No No No HardenGetBackout
IndexType Index type Yes Yes No No No IndexType
InhibitGet Whether get operations for the queue are allowed Yes Yes Yes No No InhibitGet
InhibitPut Whether put operations for the queue are allowed Yes Yes Yes Yes Yes InhibitPut
InitiationQName Name of initiation queue Yes Yes No No No InitiationQName
MaxMsgLength Maximum message length in bytes Yes Yes No No No MaxMsgLength
MaxQDepth Maximum queue depth Yes Yes No No No MaxQDepth
MsgDeliverySequence Message delivery sequence Yes Yes No No No MsgDeliverySequence attribute
NonPersistentMessageClass Reliability goal for non persistent messages Yes Yes No No No NonPersistentMessageClass
OpenInputCount Number of opens for input Yes No No No No OpenInputCount
OpenOutputCount Number of opens for output Yes No No No No OpenOutputCount
ProcessName Process name Yes Yes No No No ProcessName
QDepthHighEvent Whether Queue Depth High events are generated Yes Yes No No No QDepthHighEvent attribute
QDepthHighLimit High limit for queue depth Yes Yes No No No QDepthHighLimit
QDepthLowEvent Whether Queue Depth Low events are generated Yes Yes No No No QDepthLowEvent attribute
QDepthLowLimit Low limit for queue depth Yes Yes No No No QDepthLowLimit attribute
QDepthMaxEvent Whether Queue Full events are generated Yes Yes No No No QDepthMaxEvent
QDesc Queue description Yes Yes Yes Yes Yes QDesc
QName Queue name Yes No Yes Yes Yes QName
QServiceInterval Target for queue service interval Yes Yes No No No QServiceInterval
QServiceIntervalEvent Whether Service Interval High or Service Interval OK events are generated Yes Yes No No No QServiceIntervalEvent attribute
QSGDisp Queue-sharing group disposition Yes No Yes Yes No QSGDisp attribute
QueueAccounting Queue accounting data collection Yes Yes Yes Yes Yes QueueAccounting
QueueMonitoring Online monitoring data for queues QueueMonitoring
QueueStatistics Queue statistics data collection Yes Yes Yes Yes Yes QueueStatistics
QType Queue type Yes No Yes Yes Yes QType
RemoteQMgrName Name of remote queue manager No No No Yes No RemoteQMgrName
RemoteQName Name of remote queue No No No Yes No RemoteQName
RetentionInterval Retention interval Yes Yes No No No RetentionInterval
Scope Whether an entry for the queue also exists in a cell directory Yes No Yes Yes No Scope
Shareability Queue shareability Yes Yes No No No Shareability
StorageClass Storage class for queue Yes Yes No No No StorageClass
TriggerControl Trigger control Yes Yes No No No TriggerControl
TriggerData Trigger data Yes Yes No No No TriggerData
TriggerDepth Trigger depth Yes Yes No No No TriggerDepth
TriggerMsgPriority Threshold message priority for triggers Yes Yes No No No TriggerMsgPriority
TriggerType Trigger type Yes Yes No No No TriggerType
Usage Queue usage Yes Yes No No No Usage attribute
XmitQName Transmission queue name No No No Yes No XmitQName



 

Home