Session Reference

After you add a session, the configuration options for the session are displayed in the Configuration panel. The transport session type you select determines the specific options you have to configure.

Rendezvous Sessions

You can use the Rendezvous Configuration panel to specify the general information. For options specific to this transport type, you can use the Rendezvous Options panel.

The following table lists the options in the Rendezvous Configuration panel:

Name Description
Name Name of the TIBCO Rendezvous transport session.
Description (Optional) Description of the transport session.
Daemon Module property that specifies the TIBCO Rendezvous daemon for this session.
Network Module property that specifies the network for this session. By default, the property is an empty string, which is interpreted as the primary network. Using this attribute only makes sense on computers with more than one network interface.
Service Module property that specifies the service for this transport. By default, the property is defined to be the default TIBCO Rendezvous service (7500).
Connection Type The type of the connection:
  • Reliable
  • Certified
  • Distributed Queue

If the connection type is Reliable, no additional configuration is required.

If the connection type is Certified, you have to specify additional options in the Rendezvous Options panel. The following table lists the options specific to the Certified connection type:

Name Description
CM Name Used to identify the delivery tracking session. It must be unique across the entire network.
Ledger File Module property that points to a ledger file. If the value of the variable value is a valid file name, the transport uses a file-based ledger.
Sync Ledger File This check box controls the behavior of TIBCO Rendezvous when the ledger file is updated:
  • Selected: operations that update the ledger file do not return until the changes are written to the storage medium. By default, this check box is selected.
  • Cleared: the operating system writes changes to the storage medium asynchronously.
Relay Agent Relay agent for this transport.
Require Old Message This check box indicates whether a persistent correspondent requires delivery of messages sent to a previous transport with the same name for which delivery was not confirmed. Its value affects the behavior of other delivery-tracking senders:
  • Selected: if the name attribute is non-NULL, this transport requires certified senders to retain unacknowledged messages sent to this persistent correspondent. By default, this check box is selected.
  • Cleared: messages are not retained.
Message Timeout (ms) Maximum time (in milliseconds) that this call can block while waiting for a reply. The default value is 0.

If the connection type is Distributed Queue, you have to specify additional options in the Rendezvous Options panel. The following table lists the options specific to the Distributed Queue connection type:

Name Description
CMQ name Sequence of the module property that specifies the name of the queue.
Worker Weight Relative worker weights assist the scheduler in assigning tasks. When the scheduler receives a task, it assigns the task to the available listener with the greatest listener weight. The default value is 1.
Worker Tasks Worker tasks for this session. The default value is 1.
Worker Complete Time (ms) If the complete time is non-zero, the scheduler waits for a worker member to complete an assigned task.

If the complete time elapses before the scheduler receives completion from the worker member, the scheduler reassigns the task to another worker member.

The default value is 0.

Scheduler Weight Represents the ability of this session to fulfill the role of the scheduler, relative to other members of the same queue.

The queue members use relative scheduler weight values to elect one member as the scheduler. Members with higher scheduler weight take precedence.

The value is in the range 1 - 65545. The default value is 1.

Scheduler Heartbeat (ms) The active scheduler sends heartbeat messages at this interval (in milliseconds). The same scheduler heartbeat interval must be specified for all members in the queue. The default value is 1000 ms.
Scheduler Activation (ms) When the heartbeat signal from the scheduler has been silent for this interval (in milliseconds), the queue member with the greatest scheduler weight takes its place as the new scheduler.

The same scheduler activation interval must be specified for all members in the queue. The default value is 3000 ms.

JMS Sessions

You can use the JMS Configuration panel to specify the general configuration information for a JMS session. For options specific to this transport type, you can use the More Options panel.

The following table lists the options in the JMS Configuration panel:

Name Description
Name Name of the JMS transport.
Description (Optional) Description of the transport.
Connection Type Lists the available connection types:
  • Direct: this is the default setting. The connection is direct.
  • JNDI: a JNDI server is used.
Provider URL (Direct connection type only) URL of the server.
Connection Factory (Direct connection type only) Two connection factory types are available:
  • TopicConnectionFactory: a message published to a topic is broadcast to one or more subscribers. All messages published to the topic are received by all services that have subscribed to the topic. This messaging model is known as publish-subscribe.
  • QueueConnectionFactory: a message sent to a queue is consumed by one and only one receiver. Each message has only one receiver, though multiple receivers might connect to the queue. The first receiver to access the queue obtains the message. The other receivers do not. This messaging model is known as point-to-point.
JNDI Reference (JNDI connection type only) JNDI server information.

In addition to the options in the JMS Configuration panel, you have to specify the options in the More Options panel. The following table lists the options in the More Options panel:

Name Description
Client ID ID of the client.
User Identity Detailed information of the user.