Progress® OpenEdge® Compilation Tools

General

Tasks

!!UPDATED!!

Types

Selectors

RCodeSelector

PCTCompileExt task -- <pct:compile_ext />

Description

This task is a rewrite of PCTCompile ; the only difference is this task is using a background Progress session, and the Java part controls the compilation. This allows more things : one example could be using custom mappers (see examples).

Parameters

Attribute	Description	Type	Requirement	Default value
destDir	Directory where to put compiled code	File	Required	No default value
minSize	Compile using option `MIN-SIZE=<value>`	Boolean	Optional	False
MD5	Compile using option `GENERATE-MD5=<value>`	Boolean	Optional	False
RunList	Generates a .run file for each compiled file, which summarizes RUN statements	Boolean	Optional	False
Listing	Generates a listing file for each compiled file (LISTING attribute of COMPILE statement). Generated file name is identical to source file name.	Boolean	Optional	False
Preprocess	Generates a preprocessed file for each compiled file (PREPROCESS attribute of COMPILE statement). Generated file name appends .preprocess to source file name.	Boolean	Optional	False
DebugListing	Generates a debug-listing file for each compiled file (DEBUG-LIST attribute of COMPILE statement). Generated file name replaces extension of source file name with .dbg	Boolean	Optional	False
KeepXref	Keeps the generated XREF file for each file. Generated file name replaces extension of source file name with .xref	Boolean	Optional	False
failOnError	If task should end just after a failed file compilation	Boolean	Optional	False
noXRef [Deprecated]	Don't use XREF when compiling or when reading files to compile	Boolean	Optional	False
XRefDir	Where PCT files (CRC, includes, preprocess, listing and debug-listing) should be created	File	Optional	<destDir>/.pct
forceCompile	Always compile everything	Boolean	Optional	False
XCode	Compiles using XCODE option	Boolean	Optional	False
XCodeKey	Sets specific key for encrypted procedures	String	Optional	No default value
NoCompile	Just prints files to recompile with the reason why, without executing COMPILE statement	Boolean	Optional	False
numThreads !!NEW!!	Starts n parallel compilation threads	Integer	Optional	1
Languages	Identifies which language segments to include in the compiled r-code. LANGUAGES option of the COMPILE statement	Strubg	Optional	No default value

PCTCompile inherits attributes from PCT and PCTRun.

Parameters as nested elements

fileset (org.apache.tools.ant.types.Fileset)

Adds a file set to the file list to compile

mapper (org.apache.tools.ant.types.Mapper)

Adds a custom mapper

Examples

<PCTCompileExt destDir="build" dlcHome="${env.DLC}">
  <fileset dir="src">
    <include name="**/*.p"/>
    <exclude name="test/**"/>
  </fileset>
  <propath>
    <pathelement path="src/include"/>
  </propath>
  <mapper type="flatten" />
</PCTCompileExt>

Compiles every *.p in src directory (and subdirs) except those from src/test, with PROPATH set to src/include, and put .r in build directory (removing any subdirectory reference), i.e. foo/bar.p results in build/bar.r

<PCTCompileExt destDir="build" dlcHome="${env.DLC}">
  <fileset dir="src">
    <include name="**/*.p"/>
  </fileset>
  <compositemapper>
    <regexpmapper from="^(.*)\.p$$" to="\1renamed.r" />
    <regexpmapper from="^(.*)\.t$$" to="triggers/\1.r" />
  </compositemapper>
</PCTCompileExt>

Compiles every *.p in src directory (and subdirs), and apply a regexp for resulting file : any .p file results in a .r file appended with renamed, and any .t file results in .r file compiled in triggers directory.

<PCTCompileExt numThreads="3" destDir="build" dlcHome="${env.DLC}">
  <fileset dir="src">
    <include name="**/*.p"/>
    <include name="**/*.w"/>
  </fileset>
</PCTCompileExt>

Compiles every .p and .w in src directory (and subdirs), with 3 compilation threads.