Copyright © Cloud Software Group, Inc. All Rights Reserved

Sessions Reference

When you add a service to an adapter, TIBCO Designer automatically creates the corresponding session and endpoint, depending on the protocol and delivery mode being used. Session and endpoint are placed in the Advanced folder of the Generic Adapter Configuration. This section is a reference to the sessions included with TIBCO Designer.

Creating sessions explicitly is not recommended. TIBCO Designer creates a session and an endpoint for you when you create a service. Under certain situations, expert users may need to create sessions explicitly.

The following sessions are discussed:

•	RV Session

•	RVA Session

•	RVCM Session

•	RVCMQ Session

•	RVTX Session

•	JMS Session

Sessions encapsulate stateful connections to a messaging source (such as a TIBCO Rendezvous daemon), database, or remote server.

To Create a Session

1.	Select the Adapter Services folder in the project panel.

2.	Drag a service (e.g. a Publication Service) into the design panel.

3.	Specify the transport type and fill in the information in the Transport tab.

4.	TIBCO Designer creates the service and creates a corresponding session and endpoint in the Advanced folder.

For TIBCO Rendezvous configuration, you must be familiar with TIBCO Rendezvous administration, as discussed in the TIBCO Rendezvous documentation set.

RV Session

For TIBCO Rendezvous sessions, the configuration panel includes the following information.

To edit the global variables used in this panel, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 65 RV Session

Name	Name of the TIBCO Rendezvous session.
Description	Optional description of the session.
Service	Global variable that specifies the service for this session. By default, the variable is defined to be the default TIBCO Rendezvous service (7500).
Network	Global variable that specifies the network for this session. By default, the variable 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.
Daemon	Global variable that specifies the TIBCO Rendezvous daemon for this session. Default is the empty string.
SSL	Check this option if you wish to use SSL. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.

RVA Session

For RVA sessions, the configuration panel includes the following information.

To edit the global variables in this panel, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 66 RVA Session

Name	Name of the TIBCO Rendezvous session.
Description	Optional description of the session.
Host	Global variable that specifies the name of the host. If no host is specified or the empty string is provided, the local host machine is the default.
Port	Global variable that specifies the port number for this session. This attribute is ignored if the host is not specified.
Enable HTTP	When checked, first try to connect to rva through the specified port; if that attempt fails, then try tunneling through the HTTP port. When unchecked (the default), do not try HTTP tunneling.

RVCM Session

For RVCM sessions, the configuration panel includes the following information.

To edit the global variables, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 67 RVCM Sessions

Name	Name of the rvCmSession.
Description	Optional description of the session.
Service	Global variable that specifies the service for this session. By default, the variable is defined to be the default TIBCO Rendezvous service (7500).
Network	Global variable that specifies the network for this session. By default, the variable defaults to the empty string, which is interpreted as the primary network. Using this attribute only makes sense on computers with more than one network interface.
Daemon	Global variable that specifies the TIBCO Rendezvous daemon for this session. Default is the empty string.
SSL	Check this option if you want to use SSL. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.
CM Name	Used to identify the delivery tracking session. It must be unique across the entire network. See A Note on Global Variables for information about this field.
Relay Agent	Relay agent for this session.
LedgerFile	Global variable that points to a ledger file. If the variable’s value is a valid filename, the session uses a file-based ledger. See A Note on Global Variables for information about this field.
Synchronous Ledger Writes	If True, then operations that update the ledger file do not return until the changes are written to the storage medium. If False, the operating system writes changes to the storage medium asynchronously.
Default Time Limit (ms)	Default timeout value for all associated publishers, in milliseconds. Defaults to 0 (infinite).
Require Old Messages	Indicates whether a persistent correspondent requires delivery of messages sent to a previous session with the same name for which delivery was not confirmed. Its value affects the behavior of other delivery-tracking senders. If checked, and if the name attribute is non-NULL, then this session requires certified senders to retain unacknowledged messages sent to this persistent correspondent. If unchecked, messages are not retained.

 

RVCMQ Session

For RVCMQ sessions, the configuration panel includes the following information.

To edit the global variables in this panel, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 68 RVCMQ Session

Name	Name of the RVCMQ session.
Description	Optional description of the session.
Service	Global variable that specifies the service for this session. By default, the variable is defined to be the default TIBCO Rendezvous service (7500).
Network	Global variable that specifies the network for this session. By default, the variable defaults to the empty string, which is interpreted as the primary network. Using this attribute only makes sense on computers with more than one network interface.
Daemon	Global variable that specifies the TIBCO Rendezvous daemon for this session. Default is the empty string.
SSL	Check this option if you want to use SSL. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.
CMQ Name	Sequence of global variables that specifies the name of the queue.
Complete Time (ms)	If the complete time is non-zero, the scheduler waits for a listener member to complete an assigned task. If the complete time elapses before the scheduler receives completion from the listener member, the scheduler reassigns the task to another listener member. Default is 0. See TIBCO Rendezvous Concepts for more information.
Scheduler Heartbeat (ms)	The scheduler session sends heartbeat messages at this interval (in milliseconds). All member sessions in the queue must specify the same value for this parameter. Acceptable values are the unsigned 32-bit integers (except zero). Default is 1000.
Scheduler Weight	Represents the ability of this session to fulfill the role of 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. Acceptable values range from 1 to 65545. Default is 1.
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. All member sessions in the queue must specify the same value for this parameter. Acceptable values are unsigned 32-bit integers (except zero). Defaults is 3000.
Listener Weight	Relative listener 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. Default is 1.
Listener Tasks	Listener tasks for this session. Default is 1.

 

RVTX Session

For TIBCO Rendezvous TX sessions, the configuration panel includes the following information.

To edit the global variables in this panel, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 69 RVTX Session

Name	Name of TIBCO Rendezvous TX session.
Description	Optional description of the session.
Service	Global variable that specifies the service for this session. By default, the variable is defined to be the default TIBCO Rendezvous service (7500).
Network	Global variable that specifies the network for this session. By default, the variable defaults to the empty string, which is interpreted as the primary network. Using this attribute only makes sense on computers with more than one network interface.
Daemon	Global variable that specifies the TIBCO Rendezvous daemon for this session. Default is the empty string.
SSL	Check this option if you want to use SSL. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.
Transactional Name	Sequence of global variables used to identify the transaction session. This name must be unique across the entire network.
Default Time Limit	Default timeout value for all associated publishers, in milliseconds. Defaults to 0 (infinite).
Operation Timeout	Maximum amount of time that a transaction will wait for the RVTX daemon to reply.

JMS Session

For JMS sessions, the configuration panel includes the following information.

To edit the global variables in this panel, click the Global Variables tab in the project panel in the upper left quadrant. For more information, see TIBCO Designer User’s Guide.

Table 70 JMS Session

Name	Name of the JMS session.
Description	Optional description of the session.
JNDI Lookups	If checked, a JMDI Server is used. In that case, a number of fields in this tab change correspondingly.
Use SSL	If this option is checked, the adapter connects to the JMS server using SSL. For this case, an SSL tab becomes available that lets you specify SSL settings. See Configure SSL Dialog below.
(JNDI) Connection Factory Type	Specifies the type of connection to the JMS server or the JNDI server. Choose topic or queue. Note: if you already specified the connection factory type for a service, you cannot change it for the session.
(JNDI) Connection Factory Name	Name of the connection factory.
(JNDI) Connection Username	Username for logging into the JMS server or JNDI server.
(JNDI) Connection Password	Password for logging into the JMS server or JNDI server.
(JNDI) Provider URL	URL of the server.

Configure SSL Dialog

If you check Use SSL in the basic configuration tab for a JMS session, a Configure SSL button becomes available. When you click the button, an SSL configuration dialog prompts you for the following information:

Basic Tab

For the Basic tab, either click Copy From to use the SSL information used by another session, or fill in the following fields.

 

Table 71 Basic Tab

Trusted Certificates Folder	Click the browse icon and select the folder in which the trusted certificates to be used by this transport are stored. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.
Identity	Click the browse icon and select the identity to be used by this transport. See Chapter 5, Managing Trusted Certificates in TIBCO Designer User’s Guide.

Advanced Tab

If you wish, you can also provide the following advanced information:

i

Table 72 Advanced Tab

Trace	If checked, SSL tracing is turned on.
Debug Trace	If checked, the SSL debug trace is turned on.
Verify Host Name	This field specifies that the host name of the HTTP server should be checked against the host name listed in the server’s digital certificate. This provides additional verification that the host name you believe you are connecting to is in fact the desired host. If the specified host name is not an exact match to the host name specified in the server’s digital certificate, the connection is refused. Note: If you specify an equivalent hostname (for example, an IP address), but the name is not an exact match of the hostname in the host’s digital certificate, the connection is refused.
Expected Host Name	This name must match the name in the certificate.
Strong Cipher Suites Only	If checked, only strong Cypher Suites are allowed. See OpenSSL v3.0 Cipher Suite List for a list of available suites.

OpenSSL v3.0 Cipher Suite List

The following list is available on http://www.openssl.org/docs/apps/ciphers.html#CIPHER_SUITE_NAMES

Table 73 Cipher Suite List

Suite Name	OpenSSL Name	E4JMS Client
SSL_RSA_WITH_NULL_MD5	NULL-MD5	C
SSL_RSA_WITH_NULL_SHA	NULL-SHA	C
SSL_RSA_EXPORT_WITH_RC4_40_MD5	EXP-RC4-MD5	C & Java
SSL_RSA_WITH_RC4_128_MD5	RC4-MD5	C & Java
SSL_RSA_WITH_RC4_128_SHA	RC4-SHA	C & Java
SSL_RSA_EXPORT_WITH_RC2_CBC_40_MD5	EXP-RC2-CBC-MD5	C & Java
SSL_RSA_WITH_IDEA_CBC_SHA	IDEA-CBC-SHA	C
SSL_RSA_EXPORT_WITH_DES40_CBC_SHA	EXP-DES-CBC-SHA	C & Java
SSL_RSA_WITH_DES_CBC_SHA	DES-CBC-SHA	C & Java
SSL_RSA_WITH_3DES_EDE_CBC_SHA	DES-CBC3-SHA	C & Java
SSL_DHE_DSS_EXPORT_WITH_DES40_CBC_SHA	EXP-EDH-DSS-DES-CBC-SHA	C & Java
SSL_DHE_DSS_WITH_DES_CBC_SHA	EDH-DSS-CBC-SHA	C
SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA	EDH-DSS-DES-CBC3-SHA	C & Java
SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA	EXP-EDH-RSA-DES-CBC-SHA	C & Java
SSL_DHE_RSA_WITH_DES_CBC_SHA	EDH-RSA-DES-CBC-SHA	C & Java
SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA	EDH-RSA-DES-CBC3-SHA	C & Java
SSL_DH_anon_EXPORT_WITH_RC4_40_MD5	EXP-ADH-RC4-MD5	C
SSL_DH_anon_WITH_RC4_128_MD5	ADH-RC4-MD5	C
SSL_DH_anon_EXPORT_WITH_DES40_CBC_SHA	EXP-ADH-DES-CBC-SHA	C
SSL_DH_anon_WITH_DES_CBC_SHA	ADH-DES-CBC-SHA	C
SSL_DH_anon_WITH_3DES_EDE_CBC_SHA	ADH-DES-CBC3-SHA	C

Copyright © Cloud Software Group, Inc. All Rights Reserved