Installation

In this section we describe how to run the installation procedure for the VisualAge Pacbase Workbenches.

The installation procedure begins by running the Workbench SETUP.EXE found on the VisualAge Pacbase installation CD.

Running the SETUP.EXE begins the SmartGuide used for the installation procedure. This is shown in Figure 4-33.

Clicking Next displays a panel where you will need to confirm your acceptance of the Java license agreement, as shown in Figure 4-34.

You must indicate that you accept the license and click Next to proceed. This displays the panel shown in Figure 4-35.

Figure 4-35 User options for the Workbench

The Workbench installation gives you the options of installing the Workbenches for either all users on the machine or for a specific user. Depending on your organization’s policies, for example, you may install the administration

Workbench only for users that will function as VisualAge Pacbase administrators. For the batch and e-business workstations, you may decide to install these for all users of the machine without specifying a user.

For our redbook example, we installed the Workbench so that anyone using the machine would be able to access the administration, batch, and e-business Workbenches.

Once you have indicated your choice of user installation option, clicking Next displays the panel shown in Figure 4-36.

Figure 4-36 Indicating the destination folder

The panel in the preceding figure is used to indicate the location of the files that will be installed for the Workbench. The default location is:

C:\Program Files\IBM\VisualAge Pacbase\Workbench\

You can change the location by clicking the Change ... button and specifying a new path. For our redbook example, we used the default location.

To continue with the installation procedure, click Next. This displays the panel shown in Figure 4-37.

Figure 4-37 Selecting the Workbench modules

Using this panel, you can specify which Workbench modules you want to install. Note that you also have the option of installing the Rational Rose Bridge as part of the e-business module. This feature is discussed more fully in chapter 15 of this redbook. For our redbook example, we chose to install all of the Workbench modules and the Rational Rose Bridge.

To continue, click Next. This displays the next panel for the installation process, seen in Figure 4-38.

Figure 4-38 Specifying the communications type

The next part of the installation procedure requires you to indicate the type of communication that you will be using, either a gateway or middleware (the default).

Selecting Gateway and clicking Next displays the panel shown in Figure 4-39.

Figure 4-39 Additional communications information

Here, you need to provide the database name and a four-character code for the database. You can also indicate whether or not the middleware has any security associated with it.

Click Next to continue and the panel shown in Figure 4-40 is displayed.

After specifying the IP address and port, click Next to continue. This displays the panel shown in Figure 4-41.

Figure 4-41 Connecting additional databases

When you install the Workbench modules in VisualAge Pacbase, you are setting up connections to the administration and development databases used by your organization. The installation process allows you to iterate through the

installation process in order to install the Workbench modules for the appropriate administration and development databases. Click No to proceed with the installation or click Yes to indicate that you wish to connect another database.

The earlier example showed the selection of a gateway for the type of

communications. If you select Middleware as the type of communications, the panel shown in Figure 4-42 is displayed.

Figure 4-42 Middleware communications type

In fact, this screen is very similar to the one displayed if gateway is selected as the type of communications. One major difference is that the Location name must be specified and the Edit host ... button is active when middleware is selected.

Clicking the Edit host... button displays a panel that gives you an example of the type of entries for the Location name, as seen in Figure 4-43.

Figure 4-43 Edit host options

The Location name field corresponds to the example names between the < and >. The series of SmartGuide panels that specify the communications type and the options associated with either the gateway or middleware are used to create the basis.ini and vaplocat.ini files which control the connection activity during the startup of the Workbench modules.

Earlier, it was mentioned that the Workbench install process allows you to iterate through the databases for connection. When you complete this iterative selection of databases, you will see the panel in Figure 4-44.

Figure 4-44 Proceeding with the Workbench installation

To proceed with the installation, click Next. The installation will proceed by displaying a panel with a progress bar as it copies the necessary files. When the process finishes, the panel in Figure 4-45 is displayed.

Figure 4-45 Completion of the installation of Workbench

Click Finish to end the Workbench install procedure.

At this point the Workbenches are not actually installed and operational on the workstation. In order to complete the process you need to click Start ->

Programs -> Workbench and then select each of the Workbenches you want to

make operational for this workstation. The first time you select an Workbench in this manner, the autoinstaller is activated, which will copy the specific files for each Workbench module. This is true only for the first time you select the Workbench module. After that, selecting Start -> Programs -> Workbench and then selecting an Workbench module will start that Workbench.

Verifying the Workbench installation

In this section we describe the results of installing the VisualAge Pacbase Workbenches. The examples in this section reflect the default location of

C:\Program Files\IBM\VisualAge Pacbase\Workbench\

If you changed the destination folder, then you will need to verify your installation accordingly.

The Workbench installation procedure establishes the directory structure shown in Figure 4-46.

Figure 4-46 Directory structure from Workbench installation

The Workbench modules are installed in:

C:\Program Files\IBM\VisualAge Pacbase\Workbench\workstation

The directory structure for this appears in Figure 4-47.

In addition to the directory structure in the preceding figure, the workstation subdirectory contains various files, as seen in Figure 4-48, which is a partial listing of the files for the workstation.

Figure 4-48 Partial listing of files for workstation

Of particular interest in this collection of files are the bases.ini and vaplocat.ini files, which manage the connection activity during the workstation startup. The base.ini is basically the logical description of the connection and the vaplocat.ini corresponds to the physical description of the connection.

Customizing the Workbenches

This section contains a brief discussion of how to customize the appearance of the Workbench and pertains to the administrator’s Workbench, the developer Workbench, and the e-business Workbench.

Each Workbench operates through a set of tabs that allow you to work with the entities managed within the VisualAge Pacbase repository. The initial set of tabs are the result of the Workbench installations.

VisualAge Pacbase includes a facility to add tabs, remove tabs, and change the order of tabs for any of the Workbenches.

The configuration manager

In order to change the tabs for the Workbench you must execute:

..\Workbench\cfm.bat

Figure 4-49 Configuration file manager

By default, the configuration file manager opens to the options associated with the developer Workbench. To change to either the administrator Workbench or e-business Workbench, select File -> Open and navigate to:

..\Workbench\workstation\modules

In this directory, you will see three directories:

򐂰 Admin, which corresponds to the administrator Workbench

򐂰 Batch, which corresponds to the developer Workbench (opened by default)

Each of these directories contains the file named default.cfg, as seen in Figure 4-50.

Figure 4-50 Opening default.cfg for the Workbench

Opening the default.cfg file results in the panel in Figure 4-51. In the list of workbooks, selecting the entry for Workbench will display the current list of tabs for the Workbench associated with the default.cfg file. Right-clicking the entry for

Workbench will display a small context menu that will allow you to add pages

(tabs).

Selecting Add Pages will present another panel with a list of the tabs that can be added to the Workbench. For example, to add the Programs tab to the

e-business Workbench, select it by clicking it and then click OK, as seen in Figure 4-52.

Figure 4-52 Adding the Programs tab

This will cause an entry for Programs to be added to the list of tabs, as seen in Figure 4-53.

The Programs tab is currently located as the rightmost tab. You can move it to the left in the tab order by using the toolbar Up button. We used multiple clicks to position the Programs tab as shown in Figure 4-54.

To remove any of the tabs, right-click the tab and select Remove page from the context menu as seen in Figure 4-55.