Configuring Transports for Rendezvous


Transports mediate the flow of messages between TIBCO Enterprise Message Service and TIBCO Rendezvous.

timemsd connects to Rendezvous daemons in the same way as any other Rendezvous client would. Transport definitions (in the file transports.conf) configure the behavior of these connections. You must properly configure these transports.

Transport Definitions

transports.conf contains zero or more transport definitions. Each definition begins with the name of a transport, surrounded by square brackets. Subsequent lines set the parameters of the transport.

Table 8 Rendezvous: Transport Parameters (Sheet 1 of 3)
Parameter
Description
type
Required. For Rendezvous transports, the value must be either tibrv or tibrvcm.
Rendezvous Parameters
The syntax and semantics of these parameters are identical to the corresponding parameters in Rendezvous clients. For full details, see the Rendezvous documentation set.
service
When absent, the default value is 7500.
network
When absent, the default value is the host computer’s primary network.
daemon
When absent, the default value is an rvd process on the local host computer.
To connect to a non-default daemon, supply hostname:protocol:port. You may omit any of the three parts. The default hostname is the local host computer. The default protocol is tcp. The default port is 7500.
Rendezvous Certified Messaging (RVCM) Parameters

Use these properties only for tibrvcm transports.

The syntax and semantics of these parameters are identical to the corresponding parameters in Rendezvous CM clients. For full details, see the Rendezvous documentation set.
cm_name
Correspondent name.
rv_tport
Required. Each RVCM transport depends in turn upon an ordinary Rendezvous transport. Set this parameter to the name of a Rendezvous transport (type tibrv) defined in the EMS configuration file transports.conf.
ledger_file
Name for file-based ledger.
sync_ledger
true or false. If true, operations that update the ledger do not return until changes are written to the storage medium.
request_old
true or false. If true, this transport server requests unacknowledged messages sent from other RVCM senders while this transport was unavailable.
default_ttl
This parameter sets default CM time limit (in seconds) for all CM messages exported on this transport.
explicit_config_only
true or false. If true, tibemsd allows RVCM listeners to register for certified delivery only if they are configured in advance with the EMS server (either in tibrvcm.conf or using the create rvcmlistener command). That is, tibemsd ignores registration requests from non-configured listeners.
If false (the default), tibemsd allows any RVCM listener to register.
EMS Parameters
topic_import_dm
queue_import_dm
EMS sending clients can set the JMSDeliveryMode header field for each message. However, Rendezvous clients cannot set this header. Instead, these two parameters determine the delivery modes for all topic messages and queue messages that tibemsd imports on this transport.
TIBEMS_PERSISTENT | TIBEMS_NON_PERSISTENT | TIBEMS_RELIABLE
When absent, the default is TIBEMS_NON_PERSISTENT.
export_headers
When true, tibemsd includes JMS header fields in exported messages.
When false, tibemsd suppresses JMS header fields in exported messages.
When absent, the default value is true.
export_properties
When true, tibemsd includes JMS properties in exported messages.
When false, tibemsd suppresses JMS properties in exported messages.
When absent, the default value is true.

Example

These examples from transports.conf illustrate the syntax of transport definitions.

[RV01] 
   type = tibrv 
   topic_import_dm = TIBEMS_RELIABLE 
   queue_import_dm = TIBEMS_PERSISTENT 
   service = 7780 
   network = lan0 
   daemon = tcp:host5:7885 
 
[RV02] 
   type = tibrv 
   service = 7890 
   network = lan0 
   daemon = tcp:host5:7995 
 
[RVCM01] 
   type = tibrvcm 
   export_headers = true 
   export_properties = true 
   rv_tport = RV02 
   cm_name = RVCMTrans1 
   ledger_file = ledgerFile.store 
   sync_ledger = true 
   request_old = true 
   default_ttl = 600 

TIBCO Enterprise Message Service™ User’s Guide
Software Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com