IBM SC34-4499-03 Personal Computer User Manual


 
starting, and stopping build servers” on page 137 for more information.) It is
recommended that you follow a naming convention for this attribute, using
values such as os2 and mvs.
Comparison operator and RC value
Together, these two attributes make up a Boolean expression that defines the
criteria used to decide whether a specific build event was successfully
accomplished, when evaluated against the value returned by the build script.
(The Comparison operator and RC value fields on the GUI correspond to the
-condition and -value attributes in the command.)
The values allowed for Comparison operator are as follows:
v EQ or == - Equals
v LT or < - Less than
v LE or <= - Less than or equals
v GT or > - Greater than
v GE or >= - Greater than or equals
v NE or != - Not equal to
RC value can be any positive integer. An example of a Boolean expression
formed from these two attributes is
return_value LE 4
, meaning that the build
event is considered a success if the build script returns a value less than or
equal to four.
Parameters
This is a string passed to the build script as its argument. If the string includes
blanks, enclose the string in double quotes. For example, for a builder used for
VisualAge C++ compiling, you might specify a parameter string of "/Ss /Ge-".
If the string includes a double quote, precede the double quote with a
backslash (\). If the string includes a dash (-), precede the dash with a blank
space, otherwise the string is interpreted as the start of a TeamConnection
action flag.
Timeout
This attribute specifies the number of minutes that a build server will be
allowed to complete a build event after it receives the build job from the
TeamConnection family server. The default is 1440 minutes (24 hours). If the
build event does not complete within this time, the build event fails.
Writing a build script
When you create a builder, you must specify a build script. The build script actually
invokes the transformation tool and passes it parameters defined in the Parameters
attribute of the builder.
150 User’s Guide