mffilelist

Description

mffilelist is an explicitly-named list of files used by the cobol, cobollbr, and cobollinkasm, bms, cobol, cobollbr, cobollink, ims, pli and plilink tasks and can either appear inside one of these tasks or as a standalone type.

Parameters

Attribute	Description	Required
delete	If false, does not delete the files in the list specified by the task. Defaults to `true`. Note: Note that the delete attribute is ignored when a nested path element is specified.	No
refid	Makes the `mffilelist` instance in effect a reference to another `mffilelist` instance. Note: Note that attributes or nested elements must not be set if refid is specified.	No
srcdir	The name of the directory where the file(s) in this list reside. Defaults to the current directory.	No
type	The type of the file(s) in this list.	No

Parameters specified as nested elements

file

Use nested <file> elements to name each file in the list.

Attribute	Description	Required
`name`	The name of the file.	Yes
`srcdir`	The name of the directory where the file resides. Must not be used if the srcname attribute has been specified.	No
`srcname`	The name of the file on the local file system. Must not be used if the srcdir attribute has been specified.	No

path

Use nested <path> elements to name each path in the list. The path element is currently used by the cobol and pli tasks for the specification of COBOL copybook paths and PL/I include file paths, the ims task for the specification of IMS copybook paths and the asm task for the specification of Assembler macro paths.

Attribute	Description	Required
path	The name of the path.	Yes
type	The type of the path. The value of this attribute should be "copybook", "imscpy" or "asmmacro".	Yes

mffilelist

Use nested <mffilelist> elements to include files listed in file lists elsewhere.

Attribute	Description	Required
refid	Makes the `mffilelist` instance in effect a reference to another `mffilelist` instance. Note: Note that attributes or nested elements must not be set if refid is specified.	Yes

Examples

Specify a number of files each residing in the same location:

<mffilelist id="same.location.files" srcdir="${basedir}" delete="false">
    <file name="Program1.cbl"/>
    <file name="Program2.cbl"/>
    <file name="Program3.cbl"/>
</mffilelist

Specify a number of files each residing in different locations:

<mffilelist id="different.location.files"> delete="true";
    <file name="Program1.cbl" srcdir="${basedir}/subdir"/>
    <file name="Program2.cbl" srcdir="${basedir}"/>
    <file name="Program3.cbl" srcdir="${basedir}/subdir"/>
</mffilelist>

Specify asmmacro locations:

<mffilelist id="asmmacro.location.files">
    <path type="asmmacro" name="${basedir}/asmmacros"/>
</mffilelist>

Specify copybook locations:

<mffilelist id="copybook.location.files">
    <path type="copybook" name="${basedir}/copybooks"/>
</mffilelist>

Specify imscpy locations:

<mffilelist id="imscpy.location.files">
    <path type="imscpy" name="${basedir}/imscopybooks"/>
</mffilelist>

Specify nested file lists:

<mffilelist id="copy1.list"> 
    <path type="copybook" name="${mf.projectLocation.mffilelist}/folder1"/> 
</mffilelist> 
 
<mffilelist id="copy2.list"> 
    <mffilelist id="innerlist"> 
        <mffilelist refid="copy1.list"/> 
        <path type="copybook" name="${mf.projectLocation.mffilelist}/folder2"/> 
    </mffilelist> 
</mffilelist> 
 
<mffilelist id="cobol.copybook.locations"> 
    <mffilelist refid="copy2.list"/> 
    <path type="copybook" name="${mf.projectLocation.mffilelist}/folder3"/> 
</mffilelist>