Apache Ant V1.10-14A for VSI OpenVMS

Thank you for your interest in this port of Apache Ant to VSI OpenVMS. The current release of Apache Ant for VSI OpenVMS is based on the Apache Ant V1.10-14A distribution.

Apache Ant (Another Neat Tool) is a Java library and command-line tool primarily used for building Java-based applications, based on supplied description files and build target specifications; however, the design of Ant is sufficiently flexible that it can be used more generally to drive essentially any process that can be described in terms of targets and tasks and be executed by Java.

Ant provides a number of built-in tasks allowing to compile, assemble, test, and run Java applications. Ant can also be used effectively to build non-Java applications. Users of Ant can develop their own library extensions containing Ant tasks and types and are offered a large number of ready-made commercial or open-source extensions. Ant is extremely flexible and does not impose coding conventions or directory layouts upon the projects that use it as a build tool.

This VSI OpenVMS port of Apache Ant has been modified from the original Ant distribution found at https://ant.apache.org/. The modifications were required to allow for differences in behaviour on VSI OpenVMS compared to other operating systems such as Windows and Linux.

Apache Ant V1.10-14A for OpenVMS requires the following software:

For detailed information about using Apache Ant, see the official Apache Ant documentation available at https://ant.apache.org/.

The kit is provided as an OpenVMS PCSI kit that can be installed by a suitably privileged user using the following command:

$ PRODUCT INSTALL ANT

The installation will then proceed as follows (output may differ slightly from that shown):

The following product has been selected:
    VSI I64VMS ANT V1.10-14A                Layered Product

Do you want to continue? [YES]

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.

Configuring VSI I64VMS ANT V1.10-14A

    VMS Software Inc.

* This product does not have any configuration options.

Execution phase starting ...

The following product will be installed to destination:
    VSI I64VMS ANT V1.10-14A                DISK$I64V842SYS2:[VMS$COMMON.]

Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

The following product has been installed:
    VSI I64VMS ANT V1.10-14A                Layered Product

VSI I64VMS ANT V1.10-14A

    Post-installation tasks are required for Ant for OpenVMS.

    After the installation is complete, perform the following tasks.

         1.  The logical name ANT$HOME must be defined to use V1.10-14A.

             $ DEFINE ANT$HOME <ANT Installation Directory>

         2.  The symbol ANT must be defined. For example:

             $ ANT :== @<ANT Installation Directory>.BIN]ANT.COM

         Then the command ANT can be used. For example:

             $ ant "-version" ! must quote DCL params

Before you can start using Apache Ant V1.10-14A for OpenVMS, you must define the ANT$HOME logical name. To do so, follow these steps:

Now you can boot Apache Ant V1.10-14A for OpenVMS via the ANT command. Note that depending on the parse style that is enabled on your system, you might need to put the -VERSION parameter in quotation marks as shown below:

$ ANT "-VERSION"

The following issues and limitations are known to exist in Apache Ant V1.10-14A for OpenVMS: