Logging on and Getting Started

Before starting the Contract Repository Editor, make sure that you have installed all necessary software. The CD-ROM includes all the software needed to run the Contract Repository Editor, with the exception of BEA TUXEDO, Netscape Communicator, and the Jolt Repository Editor on UNIX platforms. For details on system requirements, supported platforms, and Contract Repository software installation, refer to the BEA TUXEDO Builder Release Notes and the BEA TUXEDO Builder Setup and Installation Guide included with your CD-ROM.

If you have an existing Jolt installation and you want to migrate the Jolt Repository to the Contract Repository database, you need to use the Migration Utility before you start the Contract Repository Editor (see Migrating the Jolt Repository). Otherwise, just start the Contract Repository Editor (see Starting the Contract Repository Editor) and log on (see Logging On to the Contract Repository Editor).

Migrating the Jolt Repository

The Migration Utility is required only if you have an existing Jolt installation and you want to migrate the Jolt Repository to the Contract Repository database. The utility is provided with the Contract Repository and is a part of the Contract Repository Server. This utility calls a special service in the Contract Repository Server that performs the actual migration and loading of the Contract Repository database.

When migrating the Jolt Repository to the Contract Repository:

• Packages are converted to interfaces

• Services are converted to operations

• Elements are created for each parameter

• Service parameters are converted to operation parameters

Start the Migration Utility by following the steps in Migration Utility Instructions.

Migration Utility Instructions

To run the migrate program:

1. Start a command prompt in DOS or UNIX window.

2. At the command line, type:

   jmigrate <old Jolt repository file> <output log file>

3. The error output displays any errors caused by the migrate operation.

4. Upgrade your 1.0 BEA TUXEDO Builder repository (created by jmigrate) to the BEA TUXEDO Builder 2.0 format by running bldr_upgrade. An example of the command line is:

   bldr_upgrade -r <old_data_file> -u <irepository>

   In this example, old_data_file is replaced by your repository data file name and irepository refers to the new repository data file included in the BEA TUXEDO Builder 2.0 release.

• Duplicate object (module, interface, operation, element) found.

• Unable to migrate the object (module, interface, operation, element).

Starting the Contract Repository Editor

To start the Contract Repository Editor:

1. Select the BEA TUXEDO Builder folder icon from your directory tree.

2. Select the Contract Repository Editor icon from the BEA TUXEDO Builder folder. The opening window in Figure 3-1 displays.

3. Refer to Logging On to the Contract Repository Editor and follow the instructions to log on.

When the Contract Repository Editor is started, the opening window in Figure 3-1 displays.

Figure 3-1 Contract Repository Editor at Start Up

Logon Instructions

After starting the Contract Repository Editor, follow the directions to log on:

1. Choose File -> Logon from the menu bar

   Or

   Click on the Logon toolbar button.

2. The Logon window shown in Figure 3-2 displays with text entry fields. Complete these fields to establish a connection with the machine offering the Contract Repository services.

   Figure 3-2 Logon Window

   

3. Type the name of the BEA TUXEDO host machine that is running the Contract Repository Server in the Host field. The Host field must not be left blank.

4. Type the port number of the JSL in the Port # field. The Port # field must be an integer and must not be left blank.

5. Type the BEA TUXEDO user name in the User field. The User name field must not be left blank and has 30-character limit.

6. Type the BEA TUXEDO password in the Password field, if required by your server configuration.

7. Type the BEA TUXEDO application password (8-character limit) in the Application Password field if required by your server configuration.

8. Click OK.

   Note: The first three fields in the Logon window can be set up as defaults in the Settings window to save retyping the fields during future logons. See Setting the Logon Default Instructions.

To save keystrokes at logon, you can customize your logon default settings. The first three fields in the Logon window can be set up as defaults in the Settings window to provide defaults for the text entry fields for future logons. Set the logon values to avoid retyping the values at each logon to the Contract Repository.

Figure 3-3 Logon Settings Window

Setting the Logon Default Instructions

To set the logon default:

1. Choose Settings -> Logon from the menu bar

   Or

   Click on the Settings toolbar button.

2. The Settings window in Figure 3-3 displays.

3. Type the values for Host, Port #, and User (30-character limit). The Port # field, if entered, must be an integer.

4. To set the values, click OK. Click Cancel to return to the previous window.