JMS connector properties

The following properties are used to configure the JMS connectors:

  • 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 MobiLink server messages window for this connector.

    See Sending a QAnywhere message to a JMS connector.

    In Sybase Central, set this property in the Connector Wizard on the Connector Names page in the Connector name field.

  • ianywhere.connector.incoming.priority   The priority, expressed as an integer, assigned to all incoming messages. If the value is unspecified or negative, the default for that type of connector is used. In JMS, the default is to use the priority of the JMS message. In web services, the default is 4.

  • ianywhere.connector.incoming.retry.max   The maximum number of times the connector retries 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 does not give up.

  • ianywhere.connector.incoming.ttl   The time-to-live, expressed as an integer, assigned to all incoming messages measured in milliseconds. If the value is unspecified or negative, the default for that type of connector is used. If the value is 0, messages do not expire. In JMS, the default is calculated using the expiration time of the JMS message. In web services, the default is 0.

  • 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 window, Properties tab, by clicking New.

  • ianywhere.connector.logLevel   The amount of connector information displayed in the MobiLink server messages window and message 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 window, 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 window, 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 window, 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 window, 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 window 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, JNDI factory field; or on the Connector Properties window on the JMS tab, JNDI section, JNDI Factory 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, Password field; or on the Connector Properties window on the JMS tab, JNDI section, Password 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 window 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 window 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 window 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 window 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 window 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 window 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 window on the JMS tab, Topic section, Password field.

  • 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 MobiLink server messages window for this connector.

    See Sending a QAnywhere message to a JMS connector.

    In Sybase Central, set this property in the Connector Wizard on the Connector Names page in the Connector name field.

  • ianywhere.connector.incoming.priority   The priority, expressed as an integer, assigned to all incoming messages. If the value is unspecified or negative, the default for that type of connector is used. In JMS, the default is to use the priority of the JMS message. In web services, the default is 4.

  • ianywhere.connector.incoming.retry.max   The maximum number of times the connector retries 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 does not give up.

  • ianywhere.connector.incoming.ttl   The time-to-live, expressed as an integer, assigned to all incoming messages measured in milliseconds. If the value is unspecified or negative, the default for that type of connector is used. If the value is 0, messages do not expire. In JMS, the default is calculated using the expiration time of the JMS message. In web services, the default is 0.

  • 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 window, Properties tab, by clicking New.

  • ianywhere.connector.logLevel   The amount of connector information displayed in the MobiLink server messages window and message 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 window, 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 window, 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 window, 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 window, 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 window 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, JNDI factory field; or on the Connector Properties window on the JMS tab, JNDI section, JNDI Factory 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, Password field; or on the Connector Properties window on the JMS tab, JNDI section, Password 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 window 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 window 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 window 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 window 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 window 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 window 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 window on the JMS tab, Topic section, Password field.