Description

Sets the attributes of the selected files to the specified attribute mask.

Declaration

<AMSETATTRIBUTES SOURCE="text" SUBFOLDERS="yes/no" ISNEWERTHAN="date" ISOLDERTHAN="date" ATTRIBUTES="text (+/-RASH combination)" ATTRFILTER="text (+/-RASH combination)" EXCLUDE="text" RESULTDATASET="text" />

Examples

<AMSETATTRIBUTES SOURCE="c:\myfile.txt" ATTRIBUTES="+s" />

<AMSETATTRIBUTES SOURCE="C:\SourceFolder\*.*" SUBFOLDERS="YES" ISOLDERTHAN="%DateSerial(2007,02,26) + TimeSerial(23,41,46)%" ATTRIBUTES="+a" ATTRFILTER="-s-h" EXCLUDE="*.pri" RESULTDATASET="SetAttrDataset" />

General Tab Parameters

Source: Specifies the files that should be affected by the attribute change. This can be a fully qualified path and file name (preferred) or a file name only (requires use of the Change Folder action). Wildcard characters (* or ?) may be used to specify files matching a certain mask. Multiple file and/or file masks may be specified by separating the entries with a pipe symbol (|).

Text, Required
MARKUP:
a) SOURCE="C:\sourcefoldername\file.txt"
b) SOURCE="C:\sourcefoldername\*.txt"
c) SOURCE="C:\sourcefoldername\*.txt|C:\sourcefoldername\*.doc"
d) SOURCE="file.txt"

Attributes: Specifies the attribute combination that the files should be changed to reflect. In Visual mode, simply select from the drop-down lists. In AML mode, use the RASH attribute system as outlined below.

Using the RASH Attribute System:

+ is Turn On
- is Turn Off

R - Read-Only
A - Archive
S - System
H - Hidden

Examples:

Use +R to turn on the read-only attribute and - R to turn it off. Not specifying R as a part of the text would ignore it.

Use +A to turn on the archive attribute and - A to turn it off. Not specifying A as a part of the text would ignore it.

To change several attributes in a single pass, simply put them together:

• +R-A-S+H would turn on the read-only and hidden attributes and turn off archive and system.

• +R+S+H would turn on the read-only, hidden, and system attributes. Archive would be left as is.

Text, Required
MARKUP:
a) ATTRIBUTES="+A+H" (turn on archive and hidden attributes)
b) ATTRIBUTES="-R-S-H" (turn off read-only, system, and hidden attributes)
c) ATTRIBUTES="-R-A+S+H" (turn off read-only and archive attributes, turn on system and hidden attributes)

Create and populate dataset: Specifies the name of a dataset to be created and populated with the result. In addition to the standard dataset fields, the dataset will contain the following:

• Source: the path and file name of the source file

• Destination: the path and file name of the destination file

• Result: the result of the action—0 for success, or an error code for failure

• Message: textual information about the result

Text, Optional
MARKUP: RESULTDATASET="DatasetName"

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 not to affect 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"

Only if newer than: Causes the action to only affect files if the source is newer than the date/time specified. If this parameter is left blank or not included, the date of the files will be ignored (unless limited by the Only if older than [ISOLDERTHAN] parameter).

Date, Optional, Default: (none)
MARKUP: ISNEWERTHAN="%DateSerial(2007,02,01) + TimeSerial(00,00,00)%"

Only if older than: Causes the action to only affect files if the source is older than the date/time specified. If this parameter is left blank or not included, the date of the files will be ignored (unless limited by the Only if newer than [ISNEWERTHAN] parameter).

Date, Optional, Default: (none)
MARKUP: ISOLDERTHAN="%DateSerial(2007,02,01) + 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 copied 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 copy. 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)