Using the Dimensions Ant Task

To run Dimensions command-lines in a target, add an element similar to the following to your Ant build.xml script:

   <dimensions userID="builduser" password="oH.1x!@46nL"

               database="DEV@PROD" server="prod1">

       <run cmd='download /workset="DEV:CM_FUTURE"

                          /directory="java_build"

                          /user_dir="C:\Workspaces\CM_FUTURE"'/>

</dimensions>

You must be careful with the following characters in command-lines as they may need to be escaped:

Character

Description

Escaped as

"

Double-quotation.

You only need to escape a double-quotation if the characters that enclose it are the same, for example:

  • Escape not required: ' '' '

  • Escape required: ''&quot;''

&quot;

'

Single quotation mark.

You only need to escape a single quotation mark if the characters that enclose it are the same, for example:

  • Escape not required: '' ' ''

  • Escape required: '&apos;'

&apos;

&

Ampersand

&amp;

<

Less-than

&lt;

>

Greater-than

&gt;

If you use a single quotation mark to quote around the cmd attribute you normally only need to escape the following characters:

"

&

<

If you use a double quotation mark to quote around the cmd attribute you normally only need to escape the following characters:

'

&

<

You can run multiple commands in one login session by repeating the <run> nested element. For example:

   <dimensions userID="dmsys" password="dmsys_test"

               database="DEV@PROD" server="prod1">

       <run cmd='SCWS DEV:CM_FUTURE'/>

       <run cmd='LWSD java_build'/>

   </dimensions>

See the Dimensions CM Command-Line Reference for details of Dimensions commands.