Radio Toolbelt (Project 'Hephaestus') - at.exe

At Process

Easily schedule actions to occur at a specified time/event.

Concepts

A trigger is the definition of something occuring and the action is what to do when that trigger occurs. It is possible to configure as many trigger/action combinations as desired.

Triggers

It is currently possible to setup a trigger for the following:

• time
• interval
• folder

Time

The time trigger will execute an action whenever the specified time takes place.

time {time} [every/days {day(s)/range}] [chdir {folder}] run {command/argument(s)}

The time value (required) can be any of the following styles:

• 9am
• 0900
• 09:00:00
• 9a

The every keyword (optional); if provided can handle the following styles:

• Monday
• M-Su
• Monday, Wednesday, Friday
• 1
• 1, 15
• December 25th

The chdir keyword (optional) provides a means to set the working folder before executing the command.

After the run keyword is the command and any parameters necessary (the action) that will execute when this trigger occurs.

Interval

The interval trigger will execute an action on a particular, repeating duration.

interval {frequency} [days {day(s)}] [times {time(s)}] [chdir {folder}] run {command/argument(s)}

The frequency value (length of time, required) can be any of the following styles:

• 5:00
• 5m

The days keyword is optional; if provided can handle the following styles:

• M
• 12/1-12/31

The times keyword is optional; if provided can handle the following styles:

• 9a-5p

The chdir keyword (optional) provides a means to set the working folder before executing the command.

After the run keyword is the command and any parameters necessary (the action) that will execute when this trigger occurs.

Folder

The folder trigger will execute an action whenever file changes are detected in the specified folder.

folder {folder} [exclude "{change types}"] [delay {duration}] run {command/argument(s)}

The folder value is the folder (path) that will be monitored for file changes.

The exclude keyword (optional) provides a means to ignore certain types of file changes from causing the trigger to execute the defined action:

• created
• changed
• renamed
• deleted

It may be necessary to hold off executing the action to allow the current activity to complete; this is where the delay keyword (optional) can be leveraged. The duration value is number of milliseconds; however supports values such as:

• 5:00
• 5m
• 30s

After the run keyword is the command and any parameters necessary (the action) that will execute when this trigger occurs.

Configure

schedule file

It is recommended that the schedule be named using at as the file extension. See the Commands section (below) for how to utilize the schedule file.

Commands

There are two categories of commands; internal and external. External commands are any other programs/utilities/etc that you can execute using the Windows Command Line. The internal commands are:

• email

Email

The email command uses the same parameters/arguments as the email command-line utility. Please refer to that documentation for more details.

Schedule File

By default, at.exe assumes that you will be processing a default.at file in the same folder as at.exe. It is possible, however, to launch different instances of at.exe with different schedule files.

at.exe c:\toolbelt\default.at

This example will launch at.exe and use the default.at file located in the c:\toolbelt folder.

Additional Information

Toolbelt List
Release Notes
End User License Agreement