Created On:  24 March 2011

Problem:

The server-side main thread(IIOP_TM) properties are not documented in VisiBroker for C Developer's Guide.

Resolution:

The following table lists the server-side main thread model IIOP_TM/IIOP_TM connection properties used in VisiBroker for C :

Property
Default
Description
vbroker.se.iiop_tm.host
null
Specifies the host name that can be used by this server engine. The default value, null, means use the host name from the system. Host names or IP addresses are acceptable values.
vbroker.se.iiop_tm.proxyHost
null
Specifies the proxy host name that can be used by this server engine. The default value, null, means use the host name from the system. Host names or IP addresses are acceptable values.
vbroker.se.iiop_tm.scms
iiop_tm
Specifies the list of Server Connection Manager name(s).
vbroker.se.iiop_tm.scm.iiop_tm.manager.type
Socket
Specifies the type of Server Connection Manager.
vbroker.se.iiop_tm.scm.iiop_tm.manager.connectionMax
0
Specifies the maximum number of cache connections on the server. The default value, 0 (zero), implies no restriction.
vbroker.se.iiop_tm.scm.iiop_tm.manager.connectionMaxIdle
0
Specifies the time, in seconds, that the server uses to determine if an inactive connection should be closed.
vbroker.se.iiop_tm.scm.iiop_tm.manager.garbageCollectTimer
30
The garbage-collection timer (in seconds) for connections.
vbroker.se.iiop_tm.scm.iiop_tm.listener.type
IIOP
Specifies the type of protocol the listener is using.
vbroker.se.iiop_tm.scm.iiop_tm.listener.port
0
Specifies the port number used with the host name property. The default value, 0 (zero), means that the system will pick a random port number.
vbroker.se.iiop_tm.scm.iiop_tm.listener.portRange
0
This property is effective only when listener.port is greater than 0 (zero). If the listener cannot bind to that port because the port may be in use then the listener will try to bind to the ports in the range [port, port portRange]. If no ports in the range are available then a COMM_FAILURE exception will be thrown.
vbroker.se.iiop_tm.scm.iiop_tm.listener.proxyPort
0
Specifies the proxy port number used with the proxy host name property. The default value, 0 (zero), means that the system will pick a random port number.
vbroker.se.iiop_tm.scm.iiop_tm.listener.rcvBufSize
0
Specifies the size of the receive socket buffer. The default value 0 implies a system dependent value.
vbroker.se.iiop_tm.scm.iiop_tm.listener.sendBufSize
0
Specifies the size of the send buffer. The default value 0 implies a system dependent value.
vbroker.se.iiop_tm.scm.iiop_tm.listener.socketLinger
0
A TCP/IP setting
vbroker.se.iiop_tm.scm.iiop_tm.listener.keepAlive
true
A TCP/IP setting
vbroker.se.iiop_tm.scm.iiop_tm.listener.giopVersion
1.2
This property can be used to resolve interoperability problems with older VisiBroker ORBs that cannot handle unknown minor GIOP versions correctly. Acceptable values for this property are 1.0, 1.1 and 1.2.
vbroker.se.iiop_tm.scm.iiop_tm.listener.preferIPv4Stack
false
It is a boolean value indicating whether the listener has to use IPv4 or IPv6. The default value is false, which will enforce usage of IPv6. If the property "vbroker.se.iiop_tp.host" is given an IPv4 or IPv6 address value, then you can ignore the property setting.
Note: On Windows XP platform, the IPv6 stack does not accept IPv4 traffic. This is the Microsoft implementation limitation, however, Vista and above do not have such limitation. Enabling IPv6 stack on Windows XP requires the associated “…preferIPv6Address…” properties to be set accordingly. This property also superseded the old-style property name “vbroker.connection.onlyListenIPv4=”. This property is applicable to 8.5 version only.
vbroker.se.iiop_tm.scm.iiop_tm.listener.preferIPv6Addresses
false
It is a boolean value indicating whether the listener would generate IPv4 or IPv6 address. The default value is false, which put IPv4 address into the IOR.
If the property "vbroker.se.iiop_tp.host" is given an IPv4 or IPv6 address value, then you can ignore the property setting. This property is applicable to 8.5 version only.
vbroker.se.iiop_tm.scm.iiop_tm.listener.preferIPv6AddressType
none
Specifies the preferred IPv6 address scope type to be returned if multiple scope addresses are configured for a given host.
The default value is none. Valid values are “none”, “linklocal”, and “others”.
“none” provides the first address returned by the getaddrinfo() network function.
“linklocal” provides the address type of Link-Local.
“others” returned the first other address except if it is the Link-Local type. This property is applicable to 8.5 version only.
vbroker.se.iiop_tm.scm.iiop_tm.listener.preferipv6ScopeId
null
Provides value that identified the scope identifier or interface number. It is used in conjunction with the IPv6 scoped addresses such as link-local or site-local. The default value is null.
This value will be used to formulate into the form “%” for the getaddrinfo() network function to translate the scope identifier string into a sin6_scope_id integer value of the sockaddr_in6 structure.
For example,
vbroker.se.iiop_tp.scm.iiop_tp.listener. preferIPv6Addresses=true
vbroker.se.iiop_tp.scm.iiop_tp.listener.ipv6ScopeId=eth0
Assuming that link-local address is returned with the value “fe80::1”. Internally, the scoped address “fe80::1%eth0” will be formulated and passed to getaddrinfo().
Alternatively, you could also set via "vbroker.se.iiop_tp.host" with the value “fe80::1%eth0”. This property is applicable to 8.5 version only.
vbroker.se.iiop_tm.scm.iiop_tm.dispatcher.type
MainThread
Specifies the type of thread dispatcher used in the Server Connection Manager.
vbroker.se.iiop_tm.scm.iiop_tm.dispatcher.threadStackSize
0
The size of the thread stack. The default value 0 indicates the system default. However, on the HP-UX platform, the default value is 128 KB.
vbroker.se.iiop_tm.scm.iiop_tm.dispatcher.coolingTime
3
Time duration, in seconds, when a connection is considered hot (expecting more requests). After the time is elapsed, the connection is returned back from the dispatcher.
vbroker.se.iiop_tm.scm.iiop_tm.connection. rcvBufSize
0
Specifies the size of the receive socket buffer. The default value 0 implies a system dependent value.
vbroker.se.iiop_tm.scm.iiop_tm.connection.sendBufSize
0
Specifies the size of the send buffer. The default value 0 implies a system dependent value.
vbroker.se.iiop_tm.scm.iiop_tm.connection.socketLinger
0
A TCP/IP setting
vbroker.se.iiop_tm.scm.iiop_tm.connection.keepAlive
true
A TCP/IP setting
vbroker.se.iiop_tm.scm.iiop_tm.connection.tcpNoDelay
true
When this property is set to false, this turns on buffering for the socket. The default value, true, turns off buffering, so that all packets are sent as soon as they are ready.
 
 
 
 
Old KB# 33751