Example: Configuring MQ Queue and Topic connection factories and destination factories for application clients

The purpose of this article is to help you configure MQ Queue connection factory, MQ Topic connection factory, MQ Queue destination factory, and MQ Topic destination factory settings.

• Required fields:

  • MQ Queue Connection Factory Properties page: name, jndiName and transport type

  • MQ Topic Connection Factory Properties page: name, jndiName and broker Version

  • MQ Queue Factory Properties page: name, jndiName, persistence, priority, expiry, baseQueueName and targetClient

  • MQ Topic Factory Properties page: name, jndiName, persistence, priority, expiry, baseQueueName and targetClient

• Special cases:

  • The transport type must be CLIENT, or BINDINGS.

  • The Broker Vmust be MA0C, or MQSI.

  • The port must be a numerical value between -2417483648 and 2417483647.

  • The CCSID must be a numerical value between -2417483648 and 2417483647.

  • The persistence value must be APPLICATION_DEFINED, QUEUE_DEFINED, PERSISTENT or, NONPERSISTENT.

  • The priority must be APPLICATION_DEFINED, QUEUE_DEFINED, or SPECIFIED.

  • The expiry must be APPLICATION_DEFINED, UNLIMITED, or SPECIFIED.

  • The integer encoding must be Normal, or Reversed.

  • The decimal encoding must be Normal, or Reversed.

  • The floating encoding must be IEEENormal, IEEEReversed or S390.

  • The target client must be JMS or MQ.

  • On the MQ Queue Connection Factory Properties page, only set the queueManager, host, and port values. These are required fields if the transport type is CLIENT.

  • On the MQ Topic Connection Factory Properties page, only set the queueManager, host, and port (required) fields if the transport type is CLIENT.

  • On the MQ Topic Factory Properties, and the MQ Queue Factory Properties pages, only set the Integer encoding, decimal encoding, and floating point encoding (required) fields if you do not set the nativeEncoding value.

  • On the MQ Topic Factory Properties and the MQ Queue Factory Properties pages, the specified priority entry field must be an integer between 0 and 9 if priority is set to SPECIFIED .

  • On the MQ Topic Factory Properties and the MQ Queue Factory Properties pages, the specified expiry entry field must be a value greater than 0 if the expiry value is set to SPECIFIED.

• Example:

  <resources.jms:JMSProvider xmi:id="JMSProvider_1" name="MQ JMS Provider" 
  description="mqJMSProvider:description" 
  externalInitialContextFactory="mqJMSProvider:contextFactoryClass" 
  externalProviderURL="mqJMSProvider:providerUrl">
  <classpath>mqJMSProvider:classpath</classpath>
  <factories xmi:type="resources.jms.mqseries:MQQueueConnectionFactory" 
  xmi:id="MQQueueConnectionFactory_1" name="mqQCF:name" jndiName="mqQCF:jndiName" 
  description="mqQCF:description" userID="mqQCF:user" password="{xor}Mi4OHBllMT4yOg==" 
  queueManager="mqQCF:queueManager" host="mqQCF:host" port="1" channel="mqQCF:channel" 
  transportType="CLIENT" clientID="mqQCF:clientId" CCSID="2">
  <propertySet xmi:id="J2EEResourcePropertySet_3">
  <resourceProperties xmi:id="J2EEResourceProperty_3" name="mqQCF:customName" 
  value="mqQCF:customValue"/>
  </propertySet>
  </factories>
  <factories xmi:type="resources.jms.mqseries:MQTopicConnectionFactory" 
  xmi:id="MQTopicConnectionFactory_1" name="mqTCF:name" jndiName="mqTCF:jndiName" 
  description="mqTCF:description" userID="mqTCF:user" 
  password="{xor}Mi4LHBllNTE7NhE+Mjo=" host="mqTCF:host" port="1" 
  transportType="CLIENT" channel="mqTCF:channel" queueManager="mqTCF:queueManager" 
  brokerControlQueue="mqTCF:brokerControlQueue" 
  brokerQueueManager="mqTCF:brokerQueueManager" brokerPubQueue="mqTCF:brokerPubQueue" 
  brokerSubQueue="mqTCF:brokerSubQueue" brokerCCSubQ="mqTCF:brokerCCSubQ" 
  brokerVersion="MA0C" clientID="mqTCF:clientId" CCSID="2">
  <propertySet xmi:id="J2EEResourcePropertySet_4">
  <resourceProperties xmi:id="J2EEResourceProperty_4" name="mqTCF:customName" 
  value="mqTCF:customValue"/>
  </propertySet>
  </factories>
  <factories xmi:type="resources.jms.mqseries:MQQueue" xmi:id="MQQueue_1" name="mqQ:name"
  jndiName="mqQ:jndiName" description="mqQ:description" persistence="APPLICATION_DEFINED" 
  priority="SPECIFIED" specifiedPriority="1" expiry="SPECIFIED" specifiedExpiry="1" 
  baseQueueName="mqQ:baseQueueName" baseQueueManagerName="mqQ:baseQueueManagerName" 
  CCSID="1" integerEncoding="Normal" decimalEncoding="Normal" 
  floatingPointEncoding="IEEENormal" targetClient="JMS">
  <propertySet xmi:id="J2EEResourcePropertySet_5">
  <resourceProperties xmi:id="J2EEResourceProperty_5" name="mqQ:customName" 
  value="mqQ:customValue"/>
  </propertySet>
  </factories>
  <factories xmi:type="resources.jms.mqseries:MQTopic" xmi:id="MQTopic_1" 
  name="mqT:name" jndiName="mqT:jndiName" description="mqT:description" 
  persistence="APPLICATION_DEFINED" priority="SPECIFIED" specifiedPriority="1" 
  expiry="SPECIFIED" specifiedExpiry="2" baseTopicName="mqT:baseTopicName" CCSID="3" 
  integerEncoding="Normal" decimalEncoding="Normal" floatingPointEncoding="IEEENormal" 
  targetClient="JMS" brokerDurSubQueue="mqT:brokerDurSubQueue" 
  brokerCCDurSubQueue="mqT:brokerCCDurSubQueue">
  <propertySet xmi:id="J2EEResourcePropertySet_6">
  <resourceProperties xmi:id="J2EEResourceProperty_6" name="mqT:customName" 
  value="mqT:customValue"/>
  </propertySet>
  </factories>
  <propertySet xmi:id="J2EEResourcePropertySet_7">
  <resourceProperties xmi:id="J2EEResourceProperty_7" name="mqJMSProvider:customName" 
  value="mqJMSProvider:customValue"/>
  </propertySet>
  </resources.jms:JMSProvider>
  

---

 

Related Tasks

Configuring new Java Message Service destinations for application clients

 

---