Syntax and parameters

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

Product

The ws_ant script is available in WebSphere Application Server and WebSphere Application Server Network Deployment.

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 ]

Parameters

The parameters of the ws_ant script are:

• target
  Optional. 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
  Optional. The value instance specifies the name of your instance. The default value is default.

• -find
  Optional. 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/WebAS5/Base/bin and specify -find myfile.xml, the script searches the file system in this order:

  1. /QIBM/ProdData/WebAS5/Base/bin/myfile.xml
  2. /QIBM/ProdData/WebAS5/Base/myfile.xml
  3. /QIBM/ProdData/WebAS5/myfile.xml
  4. /QIBM/ProdData/myfile.xml
  5. /QIBM/myfile.xml
  6. /myfile.xml

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

• -listener
  Optional. The value listenerclass specifies a class name to be added as a project listener.

• -logger
  Optional. The value loggerclass specifies a class name to be used for logging.

• -logfile
  Optional. The value logfile specifies the name of the file that to which the script writes logging information.

• -emacs
  Optional. 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
  Optional. 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
  Optional. If you specify this parameter, the script does not display any progress messages.

• -version
  Optional. 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.