Appendix A   Administered Object Attributes

This appendix provides reference tables for the attributes of the ConnectionFactory, XAConnectionFactory, destination, and endpoint administered objects.

ConnectionFactory Administered Object

---

Table A-1 summarizes the configurable properties of both ConnectionFactory and XAConnectionFactory administered objects. The attributes are presented in alphabetical order for quick reference. For groupings of these attributes in functional categories, and a description of each, see "MQ Client Runtime Configurable Properties".

Table A-1    Connection Factory Attributes 

Attribute/property name	Type	Default Value	Reference
imqAckOnAcknowledge	String	not specified	Table 4-5
imqAckOnProduce	String	not specified	Table 4-5
imqAckTimeout	String	0 millisecs	Table 4-1
imqBrokerHostName	String	localhost	Table 4-1
imqBrokerHostPort	Integer	7676	Table 4-1
imqBrokerServicePort	Integer	0	Table 4-1
imqConfiguredClientID	String	not specified	Table 4-3
imqConnectionType	String	TCP	Table 4-1
imqConnectionURL	String	http://localhost/ imq/tunnel	Table 4-1
imqDefaultPassword	String	guest	Table 4-3
imqDefaultUsername	String	guest	Table 4-3
imqDisableSetClientID	Boolean	false	Table 4-3
imqFlowControlCount	Integer	100	Table 4-5
imqFlowControlIsLimited	Boolean	false	Table 4-5
imqFlowControlLimit	Integer	1000	Table 4-5
imqJMSDeliveryMode	Integer	2 (persistent)	Table 4-4
imqJMSExpiration	Long	0 (does not expire)	Table 4-4
imqJMSPriority	Integer	4 (normal)	Table 4-4
imqLoadMaxToServerSession	Boolean	true	Table 4-7
imqOverrideJMSDeliveryMode	Boolean	false	Table 4-4
imqOverrideJMSExpiration	Boolean	false	Table 4-4
imqOverrideJMSPriority	Boolean	false	Table 4-4
imqOverrideJMSHeadersTo TemporaryDestinations	Boolean	false	Table 4-4
imqQueueBrowserMaxMessages PerRetrieve	Integer	1000	Table 4-6
imqQueueBrowserRetrieveTimeout	Long	60,000 millisecs	Table 4-6
imqReconnect	Boolean	false	Table 4-2
imqReconnectDelay	Integer	30,000 millisecs	Table 4-2
imqReconnectRetries	Integer	0	Table 4-2
imqSetJMSXAppID	Boolean	false	Table 4-8
imqSetJMSXConsumerTXID	Boolean	false	Table 4-8
imqSetJMSXProducerTXID	Boolean	false	Table 4-8
imqSetJMSXRcvTimestamp	Boolean	false	Table 4-8
imqSetJMSXUserID	Boolean	false	Table 4-8
imqSSLIsHostTrusted	Boolean	true	Table 4-1

For more information on using ConnectionFactory administered objects see Chapter 3, "Using Administered Objects."

Destination Administered Objects

---

A destination administered object represents a physical destination (a queue or a topic) in a broker to which the publicly-named destination object corresponds. Its only attribute is the physical destination's internal, provider-specific name. By creating a destination object, you allow a client's MessageConsumer and/or MessageProducer objects to access the corresponding physical destination.

Table A-2    Destination Attributes

Attribute/property name	Type	Default
imqDestinationDescription	String	A Description for the Destination Object
imqDestinationName	String1	Untitled_Destination_Object

1 Destination names can contain only alphanumeric characters (no spaces) and must begin with an alphabetic character or the characters "_" and/or "$".

For more information on Destination administered objects see Chapter 3, "Using Administered Objects."

Endpoint Administered Objects

---

An endpoint administered object represents an endpoint object. By creating an administered object for an endpoint, you allow the endpoint to be accessed through a look-up operation while isolating specific endpoint information from application code or particular provider requirements. You can set one or more attributes for an endpoint administered object. These are described in Table A-3.

For additional information about endpoint administered objects, see "Using JAXM Administered Objects".

Table A-3    Endpoint Attributes 

Attribute Name	Type	Description
imqSOAPEndpointList	String	A list containing one or more url's delimited by spaces. This list contains the url's of all endpoints to which you want to broadcast a SOAP message. Each URL should be associated with a servlet that can receive and process a SOAP message.
imqEndpointName	String	The name of the endpoint object. Default: Untitled_Endpoint_Object
imqEndpointDescription	String	A description of the endpoint and its use. Default: A description for the endpoint object.