pli

Description

Compiles one or more PL/I programs.

Parameters

Attribute Description Required
configuration The name of the active directive set configuration to be used when searching for directive set files. No
connectionName The name of the remote connection. No
destdir The name of the directory where the output(s) from a compilation are to be written. Defaults to the current directory. No
failonerror If true, stops the build process if the task exits with a return-code other than 0. Defaults to false. No
mf.forceCompile If true, compiles a PL/I program even if it is not out-of-date. Defaults to false. No
is64bit If true, compiles a PL/I program to a 64-bit target. Defaults to false (i.e. 32-bit target). No
projectName The name of the project. No
settingsDir The name of the active directive set settings directory. No
srcdir The name of the directory where the PL/I source file(s) are to be picked up from. Must not be used if nested mffilelist elements have been specified. Defaults to the current directory. No
srcfile The name of the source file to be compiled. Must not be used if nested mffilelist elements have been specified. No
mf.buildThreadCount The maximum number of parallel compilations to be used. Defaults to 1. No
useDirectiveSet If true, this indicates that the build should search for a directive set file. Defaults to false. No
userEnv The name of the properties file that contains the user specified environment variables. No
verbose If true, causes additional informational messages to be displayed by the task. Defaults to false. No

Parameters specified as nested elements

fileset
Use nested <fileset> elements to specify the source file name(s) to be compiled.
mfdirlist
Use nested <mfdirlist> elements to specify directives to be used to compile the program(s). See mfdirlist.
mffilelist
Use nested <mffilelist> elements to specify the source file name(s) to be compiled, and include file locations. See mffilelist.

Errors and return codes

By default, the return code of a <pli> task is ignored. When you set failonerror="true", any non-zero response is treated as an error and means the build exits.

Examples

Generate PL/I build artefacts for a referenced mffilelist element using the directives in a referenced mfdirlist element:

<mfdirlist id="pli_directive_set_1">
    <directive name="-debug"/>
    <directive name="-isuffix .inc"/>
    <directive name="-mvs"/>
</mfdirlist>

<mffilelist id="pli_file_set_1" srcdir="${basedir}" type="srcfile">
    <file name="Program1.pli"/>
</mffilelist>

<mffilelist id="pli_include_locations">
    <path type="copybook" name="${basedir}/pliincludes"/>
</mffilelist>

<pli destdir="${basedir}/bin" forcecompile="true" failonerror="true">
    <mfdirlist refid="pli_directive_set_1"/>
    <mffilelist refid="pli_include_locations"/>
    <mffilelist refid="pli_file_set_1"/>
</pli>

Generate PL/I build artefacts for a nested mffilelist element using the directives in a nested mfdirlist element:

<pli destdir="${basedir}/bin" forcecompile="true" failonerror="true">
    <mfdirlist>
        <directive name="-debug"/>
        <directive name="-isuffix .inc"/>
        <directive name="-mvs"/>
    </mfdirlist>
    <mffilelist>
        <path type="copybook" name="${basedir}/pliincludes"/>
    </mffilelist>
    <mffilelist srcdir="${basedir}" type="srcfile">
        <file name="Program1.pli"/>
    </mffilelist>
</pli>