Macros are configuration snippets used in source, destination and next action elements to represent dates, times, filenames and task parameters. For example, if the year is 2015, a task using a macro of data[yyyy].log runs against a value of data2015.log .

Macro attributes:

  • Enclose macro attributes in square brackets ( [macroattribute] ).
  • Place macro arguments (usually a DateSpec or an integer) after the attribute and a colon ( : ). For example:

    [macroattribute]:macroArgument .

Macros in task parameters or global parameters are interpreted as macros as usual. For example:

A global parameter named Error_Subject is set with a value of ERROR in '[TaskName]' at [hh]:[mm]:[ss]

A Next Action subject is set to [Parm:Error_Subject]

When the task is run, this is interpreted as ERROR in 'Get TPS Reports' at 12:34

Where macros can be used:

  • Source Folder Name
  • Source Filemask
  • Destination Path
  • Destination Filename
  • Email Message Address To
  • Email Message Subject
  • Email Message Body
  • FTP QUOTE Fields
  • Parameters consumed by built-in or custom scripts