Menu:
AngeliaMailTM - On-Line Help - Managing Command Files
AngeliaMail Command Files are an important AngeliaMail feature that can contribute significantly to ease of management and reduction of command line clutter and complexity. The AngeliaMail Command Line Utility accepts parameters for SMTP Host, Recipient Addresses, Subject Line, Message Text (or a path to a text file that will be loaded as message text), attachment path name(s), and processing options such as logging. It will also accept the name (or complete path) of a Command File that contains some or all of these parameters.
For example – to send an email with a Subject Line of "Backup Aborted", no message text, an attachment of "C:\Backup\Backup.Rpt" to 2 groups ("ALERT" and "BACKUP") using the "NORMAL" SMTP mail server would require the following command line: C:\AngeliaMail\AngeliaMail.Exe /HNORMAL /TALERT;BACKUP "/SBackup Aborted" /AC:\Backup\Backup.Rpt
By creating an AngeliaMail Command File named “BackupAlert” with the Host (/H), Recipient addresses (/T) and Subject Line (/S) stored in it, the command line can be reduced to: C:\AngeliaMail\AngeliaMail.Exe /DBackupAlert /AC:\Backup\Backup.Rpt
And if the attachment always has the same path then it could also be added to the command file reducing the actual command line to: C:\AngeliaMail\AngeliaMail.Exe /DBackupAlert
Another advantage of using Command Files is maintainability. Suppose you wanted to add another Email group to the distribution list for the above example. Instead of having to modify your batch file or scheduler event, you can use the AngeliaMail Configuration Utility’s "Command Wizard" to edit the BackupAlert Command File and add an additional Email group there – both simpler and safer than editing your batch file or Scheduler event.
Command Files are created using the "Create An AngeliaMail Command File" selection and modified using the "Edit An Existing AngeliaMail Command File" selection from the "Command Wizard" selection group on Configuration Utility’s main form. The wizard will lead you thru Command File creation or modification a parameter at a time with documentation for each step.
Command Files can be stored in any folder, but we recommend that they be stored in the same location as the configuration (which is the default location and the folder in which the "Save As" dialog will begin). A Command File named "Default.AMC" and stored in the default folder (normally in "All Users\Application Data" unless you have relocated the configuration file) will be called automatically if it exists and no other command file is specified on the AngeliaMail command line.
Note that any parameter entered on the AngeliaMail command line overrides (or supplements) the corresponding parameter in any applicable Command File. See AngeliaMail Command Line Utility for more detailed information about command line parameters.