IBM SC34-4499-03 manual Setting up the bridge environment, Prerequisites, Environment variables

These con®guration maps should be imported into your development library so that it can be loaded by all of the users sharing that library. The step-by step instructions are described in ªInstalling and activating the ENVY/Manager-TeamConnection Bridgeº on page 253 .

Usually, the Library Supervisor or the ®rst user to use the bridge will perform this operation and then inform other users that the tool is available in the library.

The sections that follow describe the steps necessary to set up the bridge and verify that it is functional.

Setting up the bridge environment

The following information is especially pertinent to the individual(s) responsible for bridge setup and administration.

Prerequisites

Before the bridge will work, you must have the following:

vVisualAge Smalltalk Pro Version 4.0 or later installed. See the VisualAge Smalltalk documentation to con®rm that you have the appropriate hardware and software prerequisites available.

vA TeamConnection server that is running.

vA TeamConnection GUI client installed on the machine where you are running your Smalltalk image.

Note: This release of the bridge only runs on OS/2 and Windows platforms.

You should verify that you are able to communicate with the relevant TeamConnection server by using the TeamConnection GUI client. If you cannot communicate with the TeamConnection server in this manner, the bridge will de®nitely not function correctly.

Only certain releases of TeamConnection support the bridge. If you have received the bridge with your release of TeamConnection, you probably have a matching version. If not, then you may have to upgrade your release of TeamConnection. The DLL TCEMBR.DLL should be available to programs in your environment, because this is the DLL that contains the primitives used by the bridge.

Environment variables

The bridge relies on the user to specify the various parameters that make up the TeamConnection context. By default, the bridge will query the variables in the environment that the image is running. These variables, TC_FAMILY , TC_RELEASE , and TC_WORKAREA, are used as initial values for the default TeamConnection context.

There are two additional environment variables that can be de®ned for the bridge, as follows:

252User's Guide