JBoss Community Archive (Read Only)

RHQ 4.9

JBossAS5 - Queue Service

Overview

Internal Name:

Queue

Description:

a JMS queue

Singleton:

no

Plugin:

JBossAS5

Managed Resource Configuration

The message counter metrics will not be collected by default. In order
for these metrics to be collected for all Topics and Queues for a given application server instance,
go to the instance's JMX Console, and invoke the
enableMessageCounters operation on the jboss.messaging:service=ServerPeer MBean.
To ensure the message counters are still enabled when the application server is restarted,
edit that instance's deploy/messaging/messaging-service.xml file and set the
EnableMessageCounters attribute to "true".

Connection Settings

Name

Description

Required

Internal Name

Jms Type

 

yes

jms-type

Custom Properties

Maps a list of custom property names to the the fully qualified class names of the org.rhq.plugins.jbossas5.adapter.api.PropertyAdapter implementations that should be used for those properties.

no

customProperties

Component Type

 

yes

componentType

Component Subtype

 

yes

componentSubtype

Component Name

 

yes

componentName

Template Name

 

yes

templateName

Component Name Property

The name of the Resource configuration property whose value should be used as the
underlying ManagedComponent name when creating a new Resource of this type.

yes

componentNameProperty

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Metrics

Name

Type

Description

Internal Name

Run State

trait

Run State

runState

Created Programmatically

trait

Was this queue created programmatically? If Yes, the queue will not survive a restart of the application server. If No, the queue was created via a deployment XML file.

createdProgrammatically

Message Counter History Day Limit

trait

This queue's message counter history day limit - <0: unlimited, =0: history disabled, >0: maximum day count

messageCounterHistoryDayLimit

Consumer Count

measurement

The number of consumers on the queue

consumerCount

Delivering Count

measurement

The number of messages currently being delivered

deliveringCount

Message Count

measurement

The number of messages in the queue

messageCount

Scheduled Message Count

measurement

The number of scheduled messages in the queue

scheduledMessageCount

Count

measurement

The total message count since startup or last counter reset

messageStatistics.count

Count Delta

measurement

The message count delta since last method call

messageStatistics.countDelta

Depth

measurement

The current message count of pending messages within the queue waiting for dispatch

messageStatistics.depth

Depth Delta

measurement

The message count delta of pending messages since last method call

messageStatistics.depthDelta

Time Last Update

measurement

The timestamp of the last message add

messageStatistics.timeLastUpdate

Clustered

trait

True if this queue is clustered, false otherwise

clustered

You must use the internal name to reference traits in Dynamic Group Definition expressions.

Configuration Properties

Name

Description

Required

Internal Name

Name

The name of this queue (e.g. 'MyQueue').

yes

name

JNDI Name

This queue's JNDI name (e.g. '/queue/MyQueue').

yes

JNDIName

Clustered

Is this queue clustered? For an existing queue, this property is read-only. If not specified
when creating a new queue, the default value is false.

no

clustered

Down Cache Size

When paging messages to storage from a subscription, they first go into a "Down Cache" before
being written to storage. This enables the write to occur as a single operation, thus aiding
performance. This setting determines the maximum number of messages that the Down Cache will hold
before they are flushed to storage.
Updates to this property will not go into effect until the queue has been restarted.
The default value is 2000.

no

downCacheSize

Full Size

The maximum number of messages for the queue held in memory at any one time.
The actual queue can hold many more messages than this, but these are paged to and from
storage as necessary, as messages are added or consumed.
Updates to this property will not go into effect until the queue has been restarted.
The default value is 200000.

no

fullSize

Max Delivery Attempts

The number of delivery attempts before a message to a subscriber of this queue is moved to the
DLQ. The default value is 10. A value of -1 indicates the default value should be used.

no

maxDeliveryAttempts

Max Size

The maximum number of messages this queue can hold before they are dropped.
A value of -1 means there is no maximum. The default value is -1.

no

maxSize

Page Size

When loading messages from a subscription, this is the maximum number of messages to
pre-load in one operation. Must be less than Full Size and greater than or equal to Down Cache Size.
Updates to this property will not go into effect until the queue has been restarted.
The default value is 2000.

no

pageSize

Redelivery Delay

The delay in milliseconds before a rolled back or recovered message is redelivered.
Set to 0 to disable redelivery. The default value is 0. A value of -1 indicates the default value should be used.

no

redeliveryDelay

DLQ

The JMX ObjectName of the dead letter queue (DLQ) for this queue (e.g.
"jboss.messaging.destination:service=Queue,name=PrivateDLQ") - overrides the default DLQ on the
server peer.

no

DLQ

Expiry Queue

The JMX ObjectName of the expiry queue for this queue (e.g.
"jboss.messaging.destination:service=Queue,name=PrivateExpiryQueue") - overrides the default
expiry queue on the server peer.

no

expiryQueue

Server Peer

The JMX ObjectName of the server peer this queue was deployed on (e.g.
"jboss.messaging:service=ServerPeer"). Updates to this property will not go into effect until
the queue has been restarted.

no

serverPeer

Security Configurations

This element specifies a XML fragment which describes the access control list to be used by the SecurityManager to authorize client operations against the destination. The content model is the same as for the SecurityManager SecurityConf attribute.

yes

securityConfig

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Operations

Name

Description

Remove All Messages

Remove all messages from the destination.

Start

Start the destination.

Stop

Stop the destination.

List All Messages

List all messages for the specified selector

List Durable Messages

List all durable messages for the specified selector

List Non Durable Messages

List all non durable messages for the specified selector

List Message Counter As HTML

Get the message counter as HTML

List Message Counter History As HTML

Get the message counter history as HTML

Reset Message Counter

Reset the message counter

Reset Message Counter History

Reset the message counter history

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 08:29:10 UTC, last content change 2013-09-18 19:42:56 UTC.