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 is:

siebel[[.transport][.[encryption][.[compression]]]]://host[:port]/EnterpriseServer/AppObjMgr[/SiebelServer]

Here is an example of a connect string:

SiebelApplication.Login "host=""siebel://host/EnterpriseServer/AppObjMgr/SiebelServer""", "CCONWAY", "CCONWAY"

Note that the entire protocol string is optional. You may specify the transport protocol alone and separate it from siebel with a single period. However, if you specify any of the other protocols, you must use a period as a placeholder for each protocol not specified, for example:

siebel...zlib://host/siebel/AppObjMgr

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

Make the following substitutions for the placeholders in the example:

Table 23.  Substitutions When Logging into a Siebel Server
In Place Of
Insert
transport
One of the following values:
  • tcpip (the default)
  • http
encryption
One of the following values:
  • none (default)
  • mscrypto (not supported by Java Data Bean)
  • rsa (supported by Java Data Bean)
compression
One of the following values:
  • none
  • zlib (the default)
host
The name of the computer on which the gateway server is installed
port
The gateway port; by default 2320. This changes only if the Siebel administrator has changed the default during installation
AppObjMgr
The name of the defined Application Object Manager that you want the thin client to access; this can be a user-defined component or one of these predefined components:
  • ISSObjMgr_<lang>
  • SCCObjMgr_<lang>
  • SSEObjMgr_<lang>
  • SSVObjMgr_<lang>
(For more information, read Siebel Server Administration Guide.)
SiebelServer
The Siebel Server to which the client should connect.
Note that this value should not be specified if Resonate is being used. This is because the Resonate Server dynamically chooses the Siebel Server with the lowest utilization.

For more information about this method, read Login.

Here 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/frashid"""
   Format of the connect string is
   '"host=" + """siebel://<Gateway>/<Enterprise>/<App. Object Mgr>/<Siebel Server>"""

   retval = siebDataCtl.Login(lng + lstr, "username", "password")

Here 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

   retval = siebDataCtl.Login(lng + lstr, "username", "password")
   

Here is a sample connect string for the COM Data Control operating in a load-balanced environment:

   '''COM Data Control : Resonate Load Balancing
   lstr = "host=" + """siebel://12.22.20.99/Siebel/SSEObjMgr"""
   'Format of the connect string is
   '"host=" + """siebel://<VIP>/<Enterprise>/<App. Object Mgr>"""
   'Or, the connect string is
   'lstr = "host=" + """siebel.tcpip.none.none://12.22.20.99/Siebel/SSEObjMgr"""

   retval = siebDataCtl.Login(lng + lstr, "username", "password")

Here 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/SIEBEL_SERVER" + char(34) + " Lang = " + char(34) + "LANG" + char(34)


 Siebel Object Interfaces Reference 
 Published: 18 June 2003