pliclean

Description

Cleans all the PL/I build artefacts created by the pli task.

Parameters

Attribute	Description	Required
destdir	The name of the directory where the build artefacts to be cleaned are located.	Yes
destfile	The name of the output file that is to be cleaned.	No
desttype	The type of the build artefacts that are to be cleaned. The value of this attribute must be one of "exe", "dll" or "lib". Defaults to "exe".	No
failonerror	If true, stops the build process if the task exits with a return-code other than 0. Defaults to `false`.	No
verbose	If true, causes additional informational messages to be displayed by the task. Defaults to `false`.	No

Parameters specified as nested elements

mfdirlist: Use nested <mfdirlist> elements to specify directives to be used to compile the program(s). See mfdirlist.
fileset: Use nested <fileset> elements to specify the source file name(s) whose artefacts should be cleaned.
mffilelist: Use nested <mffilelist> elements to specify the source file name(s). See mffilelist.
mfdestfilelist: Use nested <mfdestfilelist> elements to specify any additional build artefact(s) that need to be cleaned. See mfdestfilelist.

Errors and return codes

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

Examples

Remove all PL/I build artefacts of type dll 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>

<pliclean destdir="${basedir}/bin" desttype="dll">
    <mfdirlist refid="pli_directive_set_1"/>
    <mffilelist refid="pli_include_locations"/>
    <mffilelist refid="pli_file_set_1"/>
</pliclean>

Remove additional PL/I build artefacts using a nested mfdestfilelist element:

<pliclean destdir="${basedir}/bin" desttype="dll">
    <mfdestfilelist>
        <file name="${basedir}/bin/Macro.stb"/>
        <file name="${basedir}/bin/MacroAndSql.stb"/>
        <file name="${basedir}/bin/Sql.stb"/>
        <file name="${basedir}/bin/Macro.adt"/>
        <file name="${basedir}/bin/MacroAndSql.adt"/>
        <file name="${basedir}/bin/Sql.adt"/>
    </mfdestfilelist>
</pliclean>