MQSeries System Properties

The following sections discuss properties of MQSeries related to links and queues. Refer to IBM MQSeries documentation for more information.

Basic Link Properties (MGW_MQSERIES_PROPERTIES)

Table 31-14 summarizes the basic configuration properties for an MQSeries messaging link. (Refer to "Notes on Table 31-14" for an explanation of the numbers in parentheses.) The table indicates which properties are optional (NULL allowed), which can be altered, and if alterable, which values can be dynamically changed.

Table 31-14 MQSeries Link Properties

Attribute	NULL Allowed?	Alter Value?	Dynamic?
queue_manager	no	no	--
hostname	yes (1)	no	--
port	yes (1)	no	--
channel	yes (1)	no	--
interface_type	yes (2)	no	--
max_connections	yes (3)	yes	yes
username	yes	yes	yes
password	yes	yes	yes
inbound_log_queue	yes (4)	yes(4)	yes
outbound_log_queue	yes (5)	yes(5)	yes

Notes on Table 31-14

1. If the hostname is NULL, the port and channel must be NULL. If the hostname is nonnull, the port and channel must be nonnull. If the hostname is NULL, an MQSeries bindings connection is used; otherwise a client connection is used.
2. If NULL, a default value of DBMS_MGWADM.MQSERIES_BASE_JAVA_INTERFACE is used.
3. If NULL, a default value of 1 is used.
4. The inbound log queue can be NULL if the link is not used for inbound propagation. The log queue can be altered only when no inbound propagation subscriber references the link.
5. The outbound log queue can be NULL if the link is not used for outbound propagation. The log queue can be altered only when no outbound propagation subscriber references the link.

Optional Link Properties

This section describes optional configuration properties supported for an MQSeries messaging link. These properties are specified by using the options parameter of DBMS_MGWADM.CREATE_MSGSYSTEM_LINK and DBMS_MGWADM.ALTER_MSGSYSTEM_LINK.

MQ_ccsid

This property specifies the character set identifier to be used. This should be the character set's integer value (for example, 819) rather than a descriptive string. If not set, the MQSeries default character set 819 is used.

Default: 819

Alterable: yes

Dynamic: no

MQ_ReceiveExit

This property specifies the fully qualified Java classname of a class implementing the MQReceiveExit interface. If not set, no default is used. This class must be in the CLASSPATH of the Messaging Gateway agent.

Default: none

Alterable: yes

Dynamic: no

MQ_SendExit

This property specifies the fully qualified Java classname of a class implementing the MQSendExit interface. If not set, no default is used. This class must be in the CLASSPATH of the Messaging Gateway agent.

Default: none

Alterable: yes

Dynamic: no

MQ_SecurityExit

This property specifies the fully qualified Java classname of a class implementing the MQSecurityExit interface. If not set, no default is used. This class must be in the CLASSPATH of the Messaging Gateway agent.

Default: none

Alterable: yes

Dynamic: no

Optional Queue Properties

This section describes optional configuration properties supported for a registered queue of an MQSeries messaging link. These properties are specified by using the options parameter of DBMS_MGWADM.REGISTER_FOREIGN_QUEUE.

MQ_openOptions

This property specifies the value used for the openOptions argument of the MQSeries Base Java MQQueueManager.accessQueue method. No value is required but if one is given, the Messaging Gateway agent adds MQOO_OUTPUT to the specified value for an enqueue (put) operation. MQOO_INPUT_SHARED is added for a dequeue (get) operation.

Default: MQOO_OUTPUT for an enqueue/put operation; MQOO_INPUT_SHARED for a dequeue/get operation

Alterable: no

Dynamic: no