Description

Concatenates two files and outputs the result to a third file.

Declaration

<AMCONCATENATEFILE FILEA="Text" FILEB="Text" CONCATENATEDFILE="Text" OVERWRITEFILE="Text" />

Example

<AMCONCATENATEFILE FILEA="C:\Documents and Settings\marie.black\My Documents\bpaserver.txt" FILEB="C:\Documents and Settings\marie.black\My Documents\dungeon.txt" CONCATENATEDFILE="newfile.txt" />

General Tab Parameters

File A: Specifies the path and file name for the first file. Click the Expression Builder icon to build and insert an expression.

Text, Required
MARKUP: FILEA="C:\Folder\FileName1.txt"

File B: Specifies the path and file name for the second file.

Text, Required
MARKUP: FILEB="C:\Folder\FileName2.txt

Concatenated file: Specifies the path and file name for the concatenated file.

Text, Required
MARKUP: CONCATENATEDFILE="C:\FolderName\NewConcatenatedFile"

Overwrite if file exists: Specifies whether or not to overwrite if file already exists.

Yes/No, Optional - Default "No"
MARKUP: OVERWRITEFILE="YES"

Options Tab Parameters

Include Subfolders: When set to YES (selected), specifies that, if present, subfolders should be searched for files matching the mask specified in the Source [SOURCE] parameter

Yes/No, Optional, Default: NO
MARKUP: SUBFOLDERS="YES"

Exclude mask: Causes the action to not copy files matching the masks specified. Filenames or wildcard masks may be used. Multiple entries may be specified by separating them with a pipe symbol (|), for example: *.txt|*.bak

Text, Optional, Default: (blank)
MARKUP: EXCLUDE="*.txt"

Regular Expression: Select the check box if the value in Exclude Mask is a regular expression.

Only if newer than: Causes the action to only copy files if the source is newer than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored (excluding Only if newer [ISNEWER] parameter).

Date, Optional, Default: (none)
MARKUP: ISNEWERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

Only if older than: Causes the action to only copy files if the source is older than the date/time specified. If parameter is left blank or not included, the date of the files will be ignored (excluding Only if newer [ISNEWER] parameter).

Date, Optional, Default: (none)
MARKUP: ISOLDERTHAN="%DateSerial(2001,10,12) + TimeSerial(00,00,00)%"

Click Custom to select from other time options (Last 30 seconds, Last 30 minutes, Last 24 hours, Last 30 Days, Last 12 Months, Last 5 Years, Next 30 Seconds, Next 30 Minutes, Next 24 Hours, Next 30 Days, Next 12 Months, Next 5 Years). A expression appears in the text box (e.g., %DateAdd( "s", -30, CStr( Now() ))%) and the Expression check box is selected. You can also click the Expression Builder icon to build a custom expression.

Attributes Tab Parameters

Attributes: This group of settings causes the action to filter which files are processed based on the attribute settings of the source files. In visual mode, a group of controls is provided to assist in the selection of this parameter. In markup mode, a single text item must be specified that contains the attributes of the files you wish to process. The available options are:

• R—Read only: Specifying "+R" causes files with this attribute turned on to be included; "-R" causes files with this attribute turned off to be included; not specifying the letter (default) causes this attribute to be ignored.

• A—Archive: Specifying "+A" causes files with this attribute turned on to be included; "-A" causes files with this attribute turned off to be included; not specifying the letter (default) causes this attribute to be ignored.

• S—System: Specifying "+S" causes files with this attribute turned on to be included; "-S" causes files with this attribute turned off to be included; not specifying the letter (default) causes this attribute to be ignored.

• H—Hidden: Specifying "+H" causes files with this attribute turned on to be included; "-H" causes files with this attribute turned off to be included; not specifying the letter (default) causes this attribute to be ignored.

• C—Compression: Specifying "+C" causes files with this attribute turned on to be included; "-C" causes files with this attribute turned off to be included; not specifying the letter (default) causes this attribute to be ignored.

Text, Optional (blank)
MARKUP:
ATTRFILTER="+R+A-S-H" (move read-only and archive files, not system or hidden)
ATTRFILTER="-S" (do not move "system" files)