fteAnt (run Ant tasks in a WebSphere MQ File Transfer Edition environment)

The fteAnt command runs Ant scripts in an environment that has WebSphere® MQ File Transfer Edition Ant tasks available.

Purpose

Use the fteAnt command to run an Ant script in an environment with WebSphere MQ File Transfer Edition. Unlike the standard ant command, fteAnt requires that you define a script file.

Syntax

Syntax diagram format

           

Read syntax diagramSkip visual syntax diagram
fteAnt

>>-fteAnt--+-------------+--+-------------+--------------------->
           '-+- -d-----+-'  '-+- -q-----+-'   
             '- -debug-'      '- -quiet-'     

>--+---------------+--+------------------+---------------------->
   '-+- -v-------+-'  '-+- -k----------+-'   
     '- -verbose-'      '- -keep-going-'     

>--+---------------------+--+--------------------------+-------->
   '- -D--property=value-'  '- -propertyfile-- -(name)-'   

>--+- -f-- -(Ant script)---------+--+-----------+--------------><
   +- -file-- -(Ant script)------+  '-(targets)-'   
   '- -buildfile-- -(Ant script)-'                  

Parameters

-debug or -d
Optional. Generate debugging output.

-quiet or -q
Optional. Generate minimal output.

-verbose or -v
Optional. Generate verbose output.

-keep-going or -k
Optional. Execute all targets that do not depend on failed targets.

-D property=value
Optional. Use value for a given property. Properties set with -D take precedence over those set in a properties file.

The com.ibm.wmqfte.propertyset property is available only if you have enabled the new function included with Version 7.0.4.1. Use the property com.ibm.wmqfte.propertyset to specify the set of configuration options used for Ant tasks. Use the name of a non-default coordination queue manager as the value for this property. Ant tasks then use the set of configuration options associated with this non-default coordination queue manager. If you do not specify this property, the default set of configuration options based on the default coordination queue manager is used. If you specify the cmdqm attribute for an Ant task, this attribute takes precedence over the set of configuration options specified for the fteAnt command. This behavior applies regardless of whether you are using the default set of configuration options or specifying a set with the com.ibm.wmqfte.propertyset property.

-propertyfile (name)
Optional. Load all properties from a file with -D properties taking precedence.

-f (Ant script), -file (Ant script), or -buildfile (Ant script)
Required. Specifies the name of the Ant script to run.

targets
Optional. The name of one or more targets to run from the Ant script. If you do not specify a value for this parameter, the default target for the script is run.

-version
Optional. Displays the WebSphere MQ File Transfer Edition command and Ant versions.

-? or -h
Optional. Displays command syntax.

Example

In this example, the target copy in Ant script fte_script.xml is run and the command writes debugging output to standard out.
fteAnt -d -f fte_script.xml copy

Return codes

0
Command completed successfully.
1
Command ended unsuccessfully.
Other status return codes can also be specified from Ant scripts, for example by using the Ant fail task.

Reference Reference

Feedback

Timestamp icon Last updated: Tuesday, 30 January 2018
http://www.ibm.com/support/knowledgecenter/SSEP7X_7.0.4/com.ibm.wmqfte.doc/fteant.htm