Build Utility Tasks

This section covers the Build Extensions Ant tasks and utilities that extend the EWM Ant toolkit by offering the build additional Ant conditions and evaluators, as well as, the ability to: manage build results, load Build Extensions facilities located in other plug-ins, manipulate text, get a unique number, get/set passwords, and log messages.

• Conditions
  This section describes the custom conditions provided by the Build Extensions Toolkit. Conditions are nested elements of the condition and waitfor task that evaluate to true or false.
• Evaluators
  This section describes the custom evaluators provided by the Build Extensions Toolkit. Evaluators are extensions to the built-in Ant PropertyHelper task that perform specialized actions when resolving or creating Ant properties.
• buildCacheClear
  The buildCacheClear task is used to clear items from a cache element in the Build Cache.
• buildCacheCreate
  The buildCacheCreate task is used to create a cache element in the Build Cache.
• buildCacheDelete
  The buildCacheDelete task is used to delete a cache element from the Build Cache.
• deleteBuildResults
  The deleteBuildResults task deletes a filtered list of build results for the specified build.
• deleteBuildSnapshots
  The deleteBuildSnapshots task deletes a filtered list of SCM snapshots for the specified build.
• escapeProperty
  The escapeProperty task escapes property values embedded in build properties.
• getNextMacroCounter
  The getNextMacroCounter task returns the next integer value of the macro counter.
• getPassword
  The getPassword task decrypts a previously encrypted password value.
• getProcessAreas
  The getProcessAreas task is used to retrieve a list of semicolon-separated process area names from the Jazz™ repository.
• loadBuildExtensions
  The loadBuildExtensions task is used to register participating EWM and Enterprise Extensions Ant tasks and types under the Build Extensions Toolkit namespace, when and if they are available. This function allows all participating tasks and types to be referenced by a common namespace.
• logMessage
  The logMessage task writes a message to the build log.
• propertyNameList
  The propertyNameList task returns a list of property names that are contained in the specified PropertySet.
• setBuildResult
  The setBuildResult task updates the specified build results.
• setBuildResultDeletable
  The setBuildResultDeletable task sets the specified build results deletable.
• setBuildResultNonDeletable
  The setBuildResultNonDeletable task sets the specified build results non-deletable.
• setPassword
  The setPassword task encrypts a password value.
• stripTrailingBlanks
  The stripTrailingBlanks task strips trailing blanks from each line of a z/OS file stored in the USS.
• teamPlatformShutdown
  The teamPlatformShutdown task stops a Team Platform instance started by the teamPlatformStartup task.
• teamPlatformStartup
  The teamPlatformStartup task starts an independent instance of the Team Platform in the current Ant environment.
• unEscapeProperty
  The unEscapeProperty task restores escaped property values embedded in build properties.