Setting up ClearCase and PowerBuilder 6.5
Introduction
The Rational ClearCase/PowerBuilder integration uses 3 directories to manage PowerBuilder objects:
Public – The public directory contains the PowerBuilder libraries (PBLs) which developers work on. The public directory and PBLs do not have to be stored in a VOB. If the public directory and PBLs are stored in a VOB, then developers must ensure a PBL under development is checked out before use (object registration, object checkout,).
Work – The work directory (usually view private) is used to store a developers work PBL. The work PBL contains checked out PowerBuilder objects.
Archive – The archive directory is a versioned directory (stored in a VOB). It is used to version PowerBuilder objects.
Rational ClearCase / PowerBuilder Integration Setup
1 Create a VOB. This document assumes the user has a VOB that will be used to store PowerBuilder objects.
2 Create a VIEW. This document assumes the user has a VIEW that will be used to do development work on PowerBuilder objects.
3 Create 3 new directories in a View in a VOB.
a. Pb_public (optionally in a VOB)
b. Pb_work (optionally in a VOB)
c. Pb_archive (must be in a VOB)
4 Copy the source code (PBLs and related files) into the pb_public directory.
5 Start PowerBuilder and open the application to be added to source control.
6 Open three library view windows and arrange them vertically.
7 Set them to the following directories
a. Left window set to the pb_public directory
b. Middle window set to the pb_work directory
c. Right window set to the pb_archive directory
8 Create the work PBL
a. Click Library -> Create
b. Create the new library in the pb_work directory
c. Name it work.pbl
d. Enter comments and click OK.
9 Add the work.pbl to the applications Library search path.
a. Open your application in an Application Painter window and right click on the application name.
b. Select Properties to open the Application dialog box.
c. Click the Libraries tab.
d. Add in the work PBL location using the browse button.
e. Click on Apply then OK.
f. Minimize the Application Painter window.
10 Connect to SCC
a. Select the Left (public) window.
b. Select Source -> Connect
c. Select SCCAPI
d. Select ClearCase in the SCC Provider window
e. Select Yes to create a new configuration file.
f. Select the pb_archive directory, name and save the Configuration file.
g. Fill in the user name and set the directory to the pb_archive directory.
h. Click OK
11 ClearCase registration
a. Enter the application name
b. Browse to the library in the pb_public folder
c. Click OK
12 All of the Library Painter windows should now have SCC – ClearCase in the window header.
13 Add the Project to Source Control.
a. In the left (public) Library window select the files to add to Source Control.
b. Click Source -> Register
c. If versioning the PBL you will get a window regarding PowerBuilder 8 and renaming the PBL. As this does not apply for PowerBuilder 6.5 just click on OK.
d. NOTE: If the PBL is mixed case (upper and lower) the error “Pathname not found” followed by the path to the PBL file will be displayed. This error is caused by PowerBuilder passing the file name to ClearCase in all lower case. Click “OK” to proceed. The file will still be added to source control. To eliminate the error open ClearCase Explorer and rename the PBL file in the pb_archive folder to the correct mixed case format.
14 Checking out a file
a. Right-click on the file in the left (public) window.
b. Click check-out
c. Select work.pbl in the pb_work folder
d. Enter comments and click OK
e. The file can now be opened and worked on from the middle (work) window
15 Check in a file
a. Right-click the file in the work (middle) window
b. Select Check-in
c. Enter comments and click OK
d. The file is checked in and no longer listed under the work PBL.