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.