Siebel Object Interfaces Reference > Programming > Siebel Object Interface Events and Siebel Extension Events >

Connect String

The connect string is a URL containing the information needed to connect to any Siebel Server component. It specifies both the protocol and the details of the Client Application Manager service in the Siebel Servers to which the client connects. The generic form of the syntax for the connect string follows:

host="siebel[.transport][.encryption][.compression]://host[:port]/EnterpriseServer/AppObjMgr_lang" lang="lang_code"

The following is an example of a connect string. SiebelApplication is an application instance:

SiebelApplication.Login "host=""siebel://host/EnterpriseServer/SCCObjMgr_enu"" "lang="ENU"", "CCONWAY", "CCONWAY"

Note that the entire protocol string is optional. You can specify the transport protocol alone and separate it from siebel with a single period:

siebel.tcpip://host/siebel/AppObjMgr_lang

However, if you specify any of the other protocols, you must use a period as a placeholder for each protocol not specified. The following is an example:

siebel...zlib://myhost/siebel/SCCObjMgr_enu

Protocols that are not specified receive their default values, as shown in Table 20.

Make the following substitutions for the placeholders in the example:

For more information about the Login method, see Login Method.

The following is a sample connect string for the COM Data Control operating in Server Mode:

   'COM Data Control : SERVER Mode
   lstr = "host=" + """siebel://frashid/Siebel/SSEObjMgr_enu"""
   'Format of the connect string is
   '"host=" + """siebel://<host>/<Enterprise>/<App. Object Mgr_lang>"""
   lng = "lang=" + """ENU"""
   retval = siebDataCtl.Login(lng + lstr, "username", "password")

The following is a sample connect string for the COM Data Control operating in Local Mode. When running in Local Mode, the COM Data Control must reside on the same machine as the Mobile Web Client.

   'COM Data Control : LOCAL Mode
   lstr = "cfg=" + """D:\Client\mwebc\BIN\ENU\siebel.cfg,ServerDataSrc"""

   'Format of the connect string is
   '"cfg=" + """Absolute path of the CFG file, DataSource"""
   'Datasource = ServerDataSrc or Local or Sample
   lng = "lang=" + """ENU"""
   retval = siebDataCtl.Login(lng + lstr, "username", "password")

The following is a sample connect string for the COM Data Control for PowerBuilder. Char(34) denotes a double quote:

ConnStr = "host =" + char(34) + "siebel://HOST/ENTERPRISE_SERVER/SCCObjMgr_enu/SIEBEL_SERVER" + char(34) + " Lang = " + char(34) + "LANG" + char(34)

If you are using a single sign-on (SSO) with Java Data Bean, you must use the login ID of an employee as the username and the value of the trust token (the TrustToken parameter in the application's CFG file) in the connect string to log into the server.

For example, the connect string would be:

m_dataBean.login("Siebel://gatewayserver:2321/enterpriseServer/SCCObjMgr_enu", SADMIN, HELLO,"enu");

where SADMIN is an employee and TrustToken = HELLO in the [LDAPSecAdpt] section of uagent.cfg.

Using Load Balancing with the Connect String

Siebel COM Data Control operating in server mode and Java Data Bean support Siebel native load balancing across Siebel Servers. The standard connect string is modified to direct requests to an appropriate virtual host that includes specific Siebel Servers with the desired object manager, and to provide the path to the file that defines the virtual host.

Connect strings that use Siebel native load balancing have the following structures:

• COM Data Control:

  host="siebel://VirtualHost/EnterpriseServer/AppObjMgr_lang"vhosts="<path to lbconfig.txt>"

  where lbconfig.txt is the file that defines virtual hosts.

  For information on lbconfig.txt definition of virtual hosts, see Siebel System Administration Guide.

• Java Data Bean:

  host="siebel://VirtualHost/EnterpriseServer/AppObjMgr_lang"

  When using generated code, by default, virtual host definitions are read from the siebel.conmgr.virtualhosts property in the siebel.properties file. The siebel.properties file must be in the classpath of the Java Virtual Machine.

  For information on definition of virtual hosts in siebel.properties, see Transports and Interfaces: Siebel Enterprise Application Integration.

The following is a sample connect string for the COM Data Control operating in Server Mode in an environment that implements Siebel round-robin load balancing across Siebel Servers:

'COM Data Control : Load Balancing
lstr = "host=" + """siebel://VirtualServer1/Siebel/SSEObjMgr_enu""" + "vhosts=" + """m:\siebel\admin\lbconfig.txt"""
lng = "lang=" + """ENU"""
retval = siebDataCtl.Login(lng + lstr, "username", "password")

where VirtualServer1 matches the VirtualServer parameter in the session manager rules in lbconfig.txt, for example:

"VirtualServer1=1:SiebServA:2321;2:SiebServB:2321;"

For information on the structure of the lbconfig.txt file, see Siebel System Administration Guide.