Refreshing the status of objects
PowerBuilder uses the source control connection defined for a
workspace to check periodically on the status of all objects in the
workspace. You can set the status refresh rate for a workspace on
the Source Control page of the Workspace Properties dialog box. You
can also select the Perform Diff on Status Update option to detect
any differences between objects in your local directories and
objects on the source control server.
For more information about source control options you can set
on your workspace, see Setting up a
connection profile.
PowerBuilder stores status information in memory, but it does
not automatically update the source control status of an object
until a System Tree or Library painter node containing that object
has been expanded and the time since the last status update for that
object exceeds the status refresh rate.
Status information can still get out of sync if multiple users
access the same source control project simultaneously and you do not
refresh the view of your System Tree or Library painter. By using
the Refresh Status menu item, you can force a status update for
objects in your workspace without waiting for the refresh rate to
expire, and without having to open and close tree view nodes
containing these objects.
The Refresh Status feature runs in the background on a
secondary thread. This allows you to continue working in
PowerBuilder while the operation proceeds. When the Refresh Status
command is executed, your SCC status cache is populated with fresh
status values. This allows subsequent operations like a target-wide
synchronization (through a GetLatestVersion call) to run much
faster.
To refresh the status of objects
-
Right-click the object in the System Tree or in a Library
painter view and select Refresh Status from the pop-up
menuor
Select the object in a Library painter view and select
Entry>Source Control>Refresh Status from the Library
painter menu.If the object you selected is not a workspace, target, or
PBL file, the object status is refreshed and any change is made
visible by a change in the source control icon next to the
object. If you selected an object in a Library painter view, the
status of this object in the System Tree is also updated.For information about the meaning of source control icons
in PowerBuilder, see Viewing the status
of source-controlled objects. -
If the object you selected in step 1 is a workspace or
target file, select a radio button to indicate whether you want
to refresh the status of the selected file only or of multiple
files in the workspace or target. -
If the object you selected in step 1 is a PBL, or if you
selected the multiple files option in step 2, make sure that the
check box is selected next to the object or objects whose status
you want to refresh, and click OK.Status is refreshed for every object selected in the
Refresh Status dialog box. Any change in status is made visible
by a change in the source control icon next to the objects (in
the selected workspace, target, or PBL) that are
refreshed.