Viewing the status of source-controlled objects

After a PowerBuilder workspace is assigned to a source control project through a connection profile, icons in the PowerBuilder System Tree display the source control status of all objects in the workspace. The same icons are also displayed for objects in the Library painter if the workspace to which they belong is the current workspace for PowerBuilder.

Source control icons

The icons and their meanings are described in Table 3-3 and Table 3-4.

Table 3-3: Source control status icons in PowerBuilder

Icon

Source control status of object displaying icon

An image of a green plus sign.

The object resides only locally and is not under source control.

An image of a green dot.

The object is under source control and is not checked out by anyone. The object on the local computer is in sync with the object on the server unless the icon for indeterminate status also appears next to the same object.

An image of a green check mark.

The object is checked out by the current user.

An image of red X.

The object is checked out by another user.

An image of a question mark.

The current status of an object under source control has not been determined. You are likely to see this icon only if the Perform Diff On Status Update check box is not selected and if diffs are not performed for your source control system based on version number. This icon can appear only in conjunction with the icon for a registered object (green dot icon) or for an object checked out by another user (red x icon).

A small plus sign on the right side of a circle.

The object on the local computer is registered to source control, but is out of sync with the object on the server. This icon can also appear with the icon for an object checked out by another user. The Perform Diff On Status Update check box must be selected for this icon to display.

Compound icons with a red check mark can display only if your SCC provider permits multiple user checkouts. These icons are described in the following table:

Table 3-4: Source control status icons with multiple checkouts enabled

Icon

Source control status of object displaying icon

An image of a red check mark above a green dot.

The object is under source control and is checked out nonexclusively by another user. PowerBuilder allows a concurrent checkout by the current user.

An image of a red check mark above a green check mark.

The object is checked out by both the current user and another user.

An image of a red check mark above the out-of-sync icon.

The object is checked out nonexclusively by another user and the version in the current user’s local path is out of sync.

For more information on allowing multiple user checkouts, see “Checking objects out from source control”.

Pop-up menus

Pop-up menus for each object in the workspace change dynamically to reflect the source control status of the object. For example, if the object is included in a source-controlled workspace but has not been registered to source control, the Add To Source Control menu item is visible and enabled in the object’s pop-up menu. However, other source control menu items such as Check In and Show Differences are not visible until the object is added to source control.

Library painter Entry menu

Additional status functionality is available from the Entry menu of the Library painter. Depending on the source control system you are using, you can see the owner of an object and the name of the user who has the object checked out. For most source control systems, you can see the list of revisions, including any branch revisions, as well as version labels for each revision.

NoteLibrary painter selections When a painter is open, menu commands apply to the current object or objects in the painter, not the current object in the System Tree. This can get confusing with the Library painter in particular, since Library painter views list objects only (much like the System Tree), and do not provide a more detailed visual interface for viewing current selections, as other painters do.

StepsTo view the status of source-controlled objects

  1. In a Library painter view, select the object (or objects) whose status you want to determine.

  2. Select Entry>Source Control>Source Control Manager Properties.

    A dialog box from your source control system displays. Typically it indicates if the selected file is checked in, or the name of the user who has the file checked out. It should also display the version number of the selected object.

    NoteDisplaying the version number in the Library painter You can display the version number of all files registered in source control directly in the Library painter. You add a Version Number column to the Library painter List view by making sure the SCC Version Number option is selected in the Options dialog box for the Library painter.

    For more information, see “Controlling columns that display in the List view”.