Connecting Small Clients to Open Interface Drivers

To identify the connection between each ESQL small client and its OIB/OID, Progress provides an OID Connection (-SV) startup parameter. This parameter introduces a list of additional parameters that specify the connection between the small client and the OIB/OID. This connection parameter list directly follows the -SV parameter on an OIB or ESQL small client command line up to the next -db parameter or end-of-line character. Only the small client can specify database connection parameters, and any -db parameter list(s) it specifies can appear before or after the -SV parameter list on the command line. The OIB passes those parameters that affect each OID (including database connection parameters) to the OID.

You can only include one -SV parameter list on each OIB and small client command line. If a Parameter File (-pf) startup parameter is included in the -SV list, all parameters in the file, up to the first -db, are part of the -SV parameter list. However, all parameters after and including the first -db in the parameter file are ignored, and are not passed to OIDs. The only parameters you can effectively put in this parameter file are for the OID connection.

Table 3–2 lists the startup parameters that you can include in a -SV parameter list for both small clients and the OIB. See the Progress Startup Command and Parameter Reference for a complete description of each parameter.

Table 3–2: OID Connection (-SV) Parameter List
Startup Parameter
Description
-H
Host Name of the OIB
-m11
Auto Server (passed to OIDs by the OIB)
-m22
Manual Server (specified for a user-started OID server only)
-Mm
Message Buffer Size
-N
Network Type
-pf
Parameter File
-pp
PROPATH used to modify the PROPATH of an OID so that it may locate existing r-code files.
-S
Service Name for the OIB
  1. No need for you to specify—the OIB automatically provides it.
  2. Required if you start an OID directly. For more information, see the "Starting UNIX Open Interface Brokers" section.

OID Startup and the Progress Client Environment

In addition to the OID connection parameters, specify all Progress session-wide client parameters when you start the OIB (or an OID directly), such as the Number of Databases (-h), No Lock (-NL), and Record Buffer Size (-Mr) startup parameters. The ESQL small client cannot pass these parameters to the OID once it has started. Essentially, each OIB establishes a common Progress client environment for all OIDs that it spawns. The one exception to this is when starting a local small client that auto-starts the OID. For more information, see the "Starting ESQL Small Clients" section.

The following sections describe how to start an OIB and ESQL small client using -SV and -db parameter lists.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095