Initialization settings that affect source control
Settings for managing source control operations
In
addition to the SccMaxArraySize described in “Fine-tuning performance
for batched source control requests”, and SccMultiCheckout described
in “Multiple
user checkout”,
there are other PB.INI parameters you can add
that affect source control operations.
|
PB.INI parameter |
Permitted values |
Description |
|---|---|---|
|
SccCOImport |
|
During checkout the default behavior For a fuller description of the permitted values, see Table 3-7. |
|
SccUCImport |
|
When you revert a checkout, the default For the meaning of the permitted values, see Table 3-7. |
|
SccGLImport |
|
When you issue a GetLatestVersion call, For the meaning of the permitted values, see Table 3-7. |
|
SccRBImport |
|
When you issue a checkout, get latest If you select Cancel, the older images for the objects that For the meaning of the permitted values, see Table 3-7. |
|
SccMaxArraySize |
nn (positive integer) |
Allows you to override the 25-file limit |
|
SccCaseSensitive |
|
By default, PowerBuilder uses a case |
|
SccMultiCheckout |
|
If your SCC provider permits multiple |
|
SccCheckoutNoLock |
|
Based on known defaults for the SCC provider |
Permitted values for Import parameters
Table 3-7 describes
the effect of permitted values for the SccCOImport, SccUCImport,
SccGLImport, and SccRBImport parameters in the PB.INI initialization
file. You can also add an import parameter without assigning it
a value. This has the same effect as the default behavior during
checkout, undo checkout, get latest version, and rollback operations.
|
Permitted value |
Description |
|---|---|
|
full |
Forces a full build of the target after For SccCOImport and SccUCImport, you can combine the “full” value For SccRBImport, if rollback fails for any reason, the build operation |
|
inc |
Examines the entire target for additional For SccCOImport and SccUCImport, you can combine the “inc” value For SccRBImport, if rollback fails for any reason, the build operation |
|
outofdate |
Compares the exported object images to The “outofdate” value is not available for |
Settings for troubleshooting problems with source control
In addition
to the initialization parameters that can help with managing source control
operations, there are also parameters you can use to troubleshoot problems
with source control. These parameters should not be used in normal operations.
They should be used only for diagnosing a problem with source control. Table 3-8 describes these
parameters.
|
PB.INI parameter |
Permitted values |
Description |
|---|---|---|
|
SccExtensions |
0 or 1 (1 is default) |
Add this parameter and set it to 0 to
For more information about SccQueryInfoEx calls, |
|
SccLogLevel |
1 or 3 (1 is default) |
Add this parameter and set it to 3 to |
|
SccMultithread |
0 or 1 (1 is default) |
Add this parameter and set it to 0 to |
|
SccDiffStrategy |
nn (positive integer) |
Depending on the capabilities of an SCC You can override the default comparison strategy by adding |
Comparison strategies
By default, PowerBuilder uses the SCCQueryInfoEx API
extension command to compare objects in target PBLs with object
files in a source control repository.
For more information on the SCCQueryInfoEx API
extension command, see “Extension to the SCC API”.
A backup strategy is set for SCC providers that do not support
the API extension. The default backup strategy for all SCC providers
except ClearCase and Perforce is to issue an SccDiff command.
For ClearCase, the backup strategy compares the PBL object with
the local project path object file. For Perforce versions earlier
than 2008, the strategy for comparing differences first examines
the SCC_STATUS_OUTOFDATE bit returned by the SccQueryInfo command
and then compares the PBL object with the local project page object file.
You can override the default comparison strategy by adding
the SccDiffStrategy parameter to the initialization file and assigning
a value to it from Table 3-9. You can also add the values together
to use multiple comparison strategies, as long as those strategies
are supported by your SCC provider.
Perforce 2008 and later
The Perforce client behavior changed with the 2008 version.
SccQueryInfo does not return information about
added objects to a Perforce 2008 depot. Therefore, for this SCC
client, it is best to perform full synchronizations from the Perforce
management utility or by using the OrcaScript scc refresh
target <full> command. You also need
to add the SccDiffStrategy parameter to the initialization file
and set its bit value to 08 to make sure that the source code in the
target PBLs match the object files in the local project path.
|
Parameter value |
Object comparison strategy |
|---|---|
|
02 (default) |
Compares by version number (SCCQueryInfoEx) — not supported |
|
04 |
Examines the SCC_STATUS_OUTOFDATE |
|
08 |
Compares the source code in the target |
|
16 |
Uses the SccDiff command |