Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

JMS connector properties

You use JMS connector properties to specify connection information with the JMS system. They configure a connector to a third party JMS messaging system such as BEA WebLogic or Sybase EAServer.

You can set and/or view properties in several places:

• Sybase Central Connector Wizard.

  See Setting up JMS connectors.

• Sybase Central Connector Properties dialog.

• Server management requests.

  See Creating and configuring connectors.

• The ml_qa_global_props MobiLink system table.

  See ml_qa_global_props.

The following properties are used to configure the JMS connector:

• ianywhere.connector.nativeConnection  The Java class that implements the connector. It is for QAnywhere internal use only, and should not be deleted or modified.

• ianywhere.connector.id (deprecated)  An identifier that uniquely identifies the connector. The default is the value of the connector property ianywhere.connector.address.

• ianywhere.connector.address  The connector address that a QAnywhere client should use to address the connector. This address is also used to prefix all logged error, warning, and informational messages appearing in the server console for this connector.

  See Addressing QAnywhere messages meant for JMS.
  In Sybase Central, set this property in the Connector wizard, Connector Names page, Connector Name field.

• ianywhere.connector.incoming.retry.max  The maximum number of times the connector will retry transferring a JMS message to a QAnywhere message store before giving up. After the maximum number of failed attempts, the JMS message is re-addressed to the ianywhere.connector.jms.deadMessageDestination property value. The default is -1, which means that the connector will never give up.

• ianywhere.connector.outgoing.deadMessageAddress  The address that a message is sent to when it cannot be processed. For example, if a message contains a JMS address that is malformed or unknown, the message is marked as unreceivable and a copy of the message is sent to the dead message address.

  If no dead message address is specified, the message is marked as unreceivable but no copy of the message is sent.
  In Sybase Central, you can set this property in the connector properties dialog Properties tab, by clicking New.

• ianywhere.connector.logLevel  The amount of connector information displayed in the MobiLink server console and log file. Values for the log level are as follows:

  • 1  Log error messages.

  • 2  Log error and warning messages.

  • 3  Log error, warning, and information messages.

  • 4  Log error, warning, information, and debug messages.

  In Sybase Central, set this property on the connector properties dialog, on the General tab, in the Logging Level section.
  You can also set this property for all connectors. To do this in Sybase Central, connect to a server message store and choose the task Change Properties of this Message Store. Open the Server Properties tab.

• ianywhere.connector.compressionLevel  The default message compression factor of messages received from JMS: an integer between 0 and 9, with 0 indicating no compression and 9 indicating maximum compression.

  In Sybase Central, set this property on the connector properties dialog, on the General tab, in the Compression Level section.
  You can also set this property for all connectors. To do this in Sybase Central, connect to a server message store, choose the task Change Properties of this Message Store, and open the Server Properties tab.

• ianywhere.connector.jms.deadMessageDestination  The address that a JMS message is sent to when it cannot be converted to a QAnywhere message. This might occur if the JMS message is an instance of an unsupported class, if the JMS message does not specify a QAnywhere address, if an unexpected JMS provider exception occurs, or if an unexpected QAnywhere exception occurs.

  In Sybase Central, set this property on the connector properties dialog, on the JMS tab, in the Other section, in the Dead Message Destination field.

• ianywhere.connector.outgoing.retry.max  The default number of retries for messages going from QAnywhere to the external messaging system. The default value is 5. Specify 0 to have the connector retry forever.

  In Sybase Central, you can set this property in the connector properties dialog, Properties tab, by clicking New.

• ianywhere.connector.runtimeError.retry.max  The number of times a connector retries a message that causes a RuntimeException. If a dead message queue is specified, the message is put in that queue. Otherwise, the message is marked as unreceivable and skipped. Specify a value of 0 to have the server never give up.

• ianywhere.connector.startupType  Startup types can be automatic, manual, or disabled.

• xjms.jndi.authName  The authentication name to connect to the external JMS JNDI name service.

  In Sybase Central, set this property in the Connector wizard, JNDI Settings page, User Name field; or on the connector properties dialog on the JMS tab, JNDI section, User Name field.

• xjms.jndi.factory  The factory name used to access the external JMS JNDI name service.

  In Sybase Central, set this property in the Connector wizard, JNDI Settings page, Password field; or on the connector properties dialog on the JMS tab, JNDI section, Password field.

• xjms.jndi.password.e  The authentication password to connect to the external JMS JNDI name service.

  In Sybase Central, set this property in the Connector wizard, JNDI Settings page, Name Service URL field; or on the connector properties dialog on the JMS tab, JNDI section, URL field.

• xjms.jndi.url  The URL to access the JMS JNDI name service.

  In Sybase Central, set this property in the Connector wizard, JNDI Settings page, Name Service URL field; or on the connector properties dialog on the JMS tab, JNDI section, URL field.

• xjms.password.e  The authentication password to connect to the external JMS provider.

• xjms.queueConnectionAuthName  The user ID to connect to the external JMS queue connection.

  In Sybase Central, set this property in the Connector wizard, JMS Queue Settings page, User Name field; or on the connector properties dialog on the JMS tab, Queue section, User Name field.

• xjms.queueConnectionPassword.e  The password to connect to the external JMS queue connection.

  In Sybase Central, set this property in the Connector wizard, JMS Queue Settings page, Password field; or on the connector properties dialog on the JMS tab, Queue section, Password field.

• xjms.queueFactory  The external JMS provider queue factory name.

  In Sybase Central, set this property in the Connector wizard, JMS Queue Settings page, Queue Factory field; or on the connector properties dialog on the JMS tab, Queue section, Queue Factory field.

• xjms.receiveDestination  The queue name used by the connector to listen for messages from JMS targeted for QAnywhere clients.

  In Sybase Central, set this property in the Connector wizard, Connector Names page, Receiver Destination field.

• xjms.topicFactory  The external JMS provider topic factory name.

  In Sybase Central, set this property in the Connector wizard, JMS Topic Settings page, Topic Factory field; or on the connector properties dialog on the JMS tab, Topic section, Topic Factory field.

• xjms.topicConnectionAuthName  The user ID to connect to the external JMS topic connection.

  In Sybase Central, set this property in the Connector wizard, JMS Topic Settings page, User Name field; or on the connector properties dialog on the JMS tab, Topic section, User Name field.

• xjms.topicConnectionPassword.e  The password to connect to the external JMS topic connection.

  In Sybase Central, set this property in the Connector wizard, JMS Topic Settings page, Password field; or on the connector properties dialog on the JMS tab, Topic section, Password field.