Syntax and parameters

For more information about running ANT commands, see the Apache ANT User Manual.

Authority

To run this script your user profile must have *ALLOBJ authority.

Syntax

The syntax of the ws_ant script is:

ws_ant [ target ] [ -instance instance ] [-find file]
 [-buildfile buildfile] [-listener listenerclass]
 [-logger loggerclass] [-logfile logfile] [-emacs] [-debug]
 [-verbose] [-quiet] [-version] [-projecthelp] [-help]

The parameters of the ws_ant script are:

• target
  This is an optional parameter. The value target specifies the name of the target to execute in the buildfile. If this parameter is not specified, the script calls the default target of your buildfile.

• -instance
  This is an optional parameter. The value instance specifies the name of your instance. The default value is default.

• -find
  This is an optional parameter. The value file specifies to search towards the root of the file system for the buildfile to be used. For example, if you run the ws_ant command from /QIBM/ProdData/WebASE/ASE5/bin and specify -find myfile.xml, the script searches the file system in this order:

  1. /QIBM/ProdData/WebASE/ASE5/bin/myfile.xml
  2. /QIBM/ProdData/WebASE/ASE5/myfile.xml
  3. /QIBM/ProdData/WebASE/myfile.xml
  4. /QIBM/ProdData/myfile.xml
  5. /QIBM/myfile.xml
  6. /myfile.xml

• -buildfile
  This is an optional parameter. The value buildfile specifies the fully qualified name of the buildfile that contains the target definition. The default value is build.xml.

• -listener
  This is an optional parameter. The value listenerclass specifies a class name to be added as a project listener.

• -logger
  This is an optional parameter. The value loggerclass specifies a class name to be used for logging.

• -logfile
  This is an optional parameter. The value logfile specifies the name of the file that to which the script writes logging information.

• -emacs
  This is an optional parameter. By default, ANT adds the name of the current task to the beginning of all logging messages. If you specify the -emacs parameter, the script does not add the name of the task to the messages.

• -debug
  This is an optional parameter. If you specify this parameter, the script displays debugging information.

• -verbose
  This optional parameter turns on verbose messages, which can be helpful if you need to debug the script.

• -quiet
  This is an optional parameter. If you specify this parameter, the script does not display any progress messages.

• -version
  This is an optional parameter. If you specify -version, the script displays version information.

• -projecthelp
  This optional parameter displays the project help message.

• -help
  This optional parameter displays the syntax help message.