Installation

System requirements

The PCT plug-in requires Ant 1.6 or higher. However, it has only been tested with 1.7.1 version of Ant. Please feel free to notify of other success stories. To obtain more information about this wonderful build tool, visit the official Ant home page at the Apache Jakarta site : http://ant.apache.org

PCT binaries can be used with either version 9 or version 10 of Progress ; using version 8 requires manual compilation.

Installation (binary package)

The PCT plug-in comes as a single .zip file. Unzipping this file into a directory of your choice (referred to as <INST_DIR>) will produce two subdirectories : /lib and /website.

Before you can use the PCT Ant tasks in your build scripts, you have to add them to your system. The simplest way to install PCT is to copy <INST_DIR>lib/PCT.jar in the <ANT_HOME>/lib directory. In this case, you just have to declare the tasks in your build script as follows :

<taskdef resource="PCT.properties" />

It's also possible to keep PCT.jar in a separate directory. In this case, declare the tasks as follows :

<taskdef resource="PCT.properties" classpath="<INST_DIR>/lib/PCT.jar" />

Note for previous versions users : PCT uses .r files for its internal use : these files had previously to be copied to your $DLC directory. This is no longer the case as of 0.10 : r-code is wrapped in PL, extracted on the fly from PCT.jar when running a PCT tasks. PCT.jar contains both the v9 and v10 r-code versions.

!!!NEW!!!PCT tasks can be used with XML namespaces. Check Antlib namespaces before using that. One way to use PCT this way is to declare the pct namespace in your project :

<project xmlns:pct="antlib:eu/rssw/pct" >
  <!-- Only if PCT.jar doesn't live in $ANT_HOME/lib -->
  <taskdef uri="antlib:eu/rssw/pct"
              resource="eu/rssw/pct/antlib.xml"
              classpath="path/to/PCT.jar" />
...
</project>

After having declared PCT, you'll be able to use PCT tasks in this manner :

  <pct:run procedure="..." />
  <pct:compile ... /> 

Documentation shows "old" names first, followed by the name in the pct namespace.

Please note that the behavior of PCT remains unchanged whichever style you're choosing. Old names are not deprecated, and will live a long life...

Tasks overview

11 tasks are available in PCT :

• Create a new database with or without a specific structure description
• Load a database schema into an existing database
• Dump a database schema into a text file
• Run a progress procedure
• Compile Progress code
• Create and/or update Progress r-code libraries
• Generate database documentation
• Use PXG files to generate Java proxy classes
• Convert WebSpeed HTML files to Progress .w files
• Load binary datas into dabase
• Create a file listing CRC for each database's table