Southsoftware.com
.:Pricing
Home
Products
Downloads
Support
Contacts
Site Map
.:Advanced Task Scheduler
About product
Download trial
Purchase license
Compare editions
View screenshot
FAQ & Support
Press Kit
.:Articles
Online manual
Blog posts
Videos
More articles...
.:Follow us
Follow us on Facebook Follow us on Twitter Follow us on YouTube
   

Shortcut type

Launch application

This task type allows launching application, script, batch file, opening document or Internet page.

Executable file name
Enter the application’s executable file name in the Executable file name field. You can also click the Browse button to find the application’s executable file on your computer disks or click the Lookup button to select application from the list of applications installed on your computer.

To open document, enter its path and file name in the field Executable file name. Documents, types of which are registered in your system, will open automatically. If document type is not registered in the system, but you know, which application should open it – you can enter the application’s executable file name in the Executable file name field and specify the document’s path and file name in the Command line arguments field.

To open Internet page: in the field Executable file name enter the page’s URL (like this: http://www.southsoftware.com/).

If you need to launch some Windows Explorer features such as My Computer, Recycle Bin, etc. please read the following topics:
Start tasks with Explorer
Start tasks with RunDLL

Command line arguments
Command line arguments for selected executable file. Professional and Network Editions: command line may include any combination of the following arguments:

Argument Description
%tempfile% (can be used with indexes: %tempfile1%, %tempfile2%, etc.) Will be replaced by name of a temporary file.
%tempfiledel% (can be used with indexes: %tempfiledel1%, %tempfiledel2%, etc.) Will be replaced by name of a temporary file. The temporary file will be deleted when task execution is complete.
%tempfilelog% (can be used with indexes: %tempfilelog1%, %tempfilelog2%, etc.) Will be replaced by name of a temporary file. The temporary file content will be added to the log file when task execution is complete.
%tempfilelogdel% (can be used with indexes: %tempfilelogdel1%, %tempfilelogdel2%, etc.) Will be replaced by name of a temporary file. The temporary file content will be added to the log file and the temporary will be deleted when task execution is complete.
%actionschedule% Will be replaced by name of the action that caused task execution.
%actiontime% Will be replaced by time of start of task execution.
%actionsource% Will be replaced by action source information.
%actionsourceextra% Will be replaced by action source extra information.
%lasterrorcode% Will be replaced by LastErrorCode.
%lastexitcode% Will be replaced by LastExitCode.

Start in this folder
The folder, which is set as the start folder for the running task. Many programs search for their auxiliary files in the start folder. To make sure that your scheduled program finds its auxiliary files, specify the correct path in this field.

Initial window state
Application’s initial window state. Scheduled application’s new window will be open in the state specified here (Normal, Minimized, Maximized, Normal and no active, Minimized and no active).

Run the application in the hidden state
Application will be launched in hidden window.

Do not wait for the application terminated
Application will be launched without waiting for its termination. If this option is checked the value of Exit code is unknown (Professional and Network Editions only).

Save the stdout to the log
Save application’s stdout and stderr outputs to the log file (Professional and Network Editions only).

Terminate the application if it is running for
Terminate application if it is running for the specified time (Professional and Network Editions only).

Returning codes
Error code: Error code of launching the application
Exit code: Exit code returned by the launched application

Statement

Control statements allow evaluating a sequence of shortcuts when condition is true and evaluating a different sequence of shortcuts when condition is not true.

IF
The IF statement is one of the most useful control structures. It enables you to evaluate a sequence of commands if a condition is true and evaluate a different sequence of commands if it is not true.

ELSEIF
The ELSEIF statement enables you to evaluate a sequence of commands if a condition is true and evaluate a different sequence of commands if it is not true.

ELSE
The ELSE enables you to evaluate a sequence of commands if none of the IF or ELSEIF conditions are true. Note: There is a maximum of one ELSE per IF statement.

ENDIF
The ENDIF statement finishes the IF..ELSEIF..ELSE sequence.

DELAY
The DELAY statement suspends execution of the task for a specified time period.

Conditions

LastErrorCode
The code of the error of the last command execution (0 means command executed successfully).

LastExitCode
The code returned by the command (for example, Kill Process command returns number of killed processes).

FILE EXISTS
Test if the specified file or folder exists. The File name is a folder or path and file name, which can contain wildcard characters (* and ?).

FILE NOT EXISTS
Test if the specified file or folder not exists. The File name is a folder or path and file name, which can contain wildcard characters (* and ?).

FILE LOCKED
Test if the specified file is locked. The File name is the file that will be tested.

FILE NOT LOCKED
Test if the specified file is not locked. The File name is the file that will be tested.

IDLE TIME
Test the user idle time.

SYSTEM UPTIME
Test the time elapsed since the last system boot.

Terminal Services: All these checks are performed taking into account the session/user under which the task is being executed.

Automate FTP transfers with Advanced Task Scheduler

Advanced Task Scheduler allows uploading, downloading and deleting files from an FTP or Secure FTP (FTPS) server. These operations can be scheduled to run in a specified time, time intervals, or by such events as file modification or creation. Advanced Task Scheduler can run FTP transfers when a specified user is logged on to the system or run them in background even when no user is logged on.

All editions of Advanced Task Scheduler support FTP operations. The examples below are for Advanced Task Scheduler Professional.

Upload a file to an FTP server

To upload a file to an FTP server with Advanced Task Scheduler, create a task with FTP upload shortcut type. Enter path to the file you want to upload to the Local dir field, select the Include files check box and enter name of the file to the field next to check box. FTP server address and directory is specified in the Remote dir field. Server address must start with ftp:// or ftps:// prefix.

In the If destination file already exists box you can choose how to process already existing files: leave them or overwrite.

There are FTP options in the bottom of the dialog where you can enter username/password and set tunneling proxy settings.

FTP Upload

Download a file from an FTP server

To download a file from an FTP server with Advanced Task Scheduler, create a task with FTP download shortcut type. Enter FTP server address and directory where the file is located to the Remote dir field. Server address must start with ftp:// or ftps:// prefix. Enter path to a folder where you want to download the file to the Local dir filed, select the Include files check box and enter name of the file to the field next to check box.

In the If destination file already exists box you can choose how to process already existing files: leave them or overwrite.

There are FTP options in the bottom of the dialog where you can enter username/password and set tunneling proxy settings.

FTP Download

Upload and download a folder or directory tree

In addition to single file transfer, Advanced Task Scheduler allows FTP operations with multiple files. The Include files and Exclude files fields are used to configure multiple file transfer.

  • When both Include files and Exclude files check boxes are unchecked, all files and all subfolders are uploaded or downloaded.
  • The Include files field contains a list of files or filemasks to include. Several files and filemasks separated by semicolon can be specified.
    For example, “file.txt;*.doc” will include the file.txt file and all .doc files.
  • The Exclude files field contains a list of files or filemasks to exclude. Several files and filemasks separated by semicolon can be specified.
    For example, “file.txt;*.doc” will exclude the file.txt file and all .doc files.
  • To include or exclude files in subfolders, directory separators (“\”) can be used in filemasks.
    For example, “file.txt” – include or exclude file.txt file only,
    dir\file.txt” – include or exclude file.txt file from “dir” subfolder only,
    *.txt” – include or exclude all .txt files from all subfolders,
    dir\*.txt” – include .txt files from “dir” and all its subdirectories.
  • To download files without recursing down directories in the file system, specify “*\*.*” in the Exclude files field.

Delete files from an FTP server

To delete files from an FTP server with Advanced Task Scheduler, create a task with FTP delete schedule type.
The task options are very similar to the upload and download schedule types.

Error handling if FTP fails

FTP operations return number of files affected in the LastExitCode value. You can check that value in the IF statement. Please note that if you use Leave existing file option, the left files will not count. The task in the example below displays success or fail message depending on the result on the FTP upload operation.

FTP Task

Perl scripting in Advanced Task Scheduler

Internal and standard Perl interpreter
Advanced Task Scheduler comes with internal portable Perl interpreter. You only need to install Advanced Task Scheduler, create a Perl script task and use all Perl scripting power.

Perl Task
Perl Execution Log

Getting Perl version
The script below displays current Perl version to the task execution log:

print "Version: $]";

Current task’s arguments
The script below displays the %advscheduler hash variable to the task execution log:

foreach $key (keys %advscheduler) {
  print $key, "=", $advscheduler{$key}, "\n";
}

Load code from external files
The script below runs Perl code from the filename.pl file:

require 'filename.pl';

For portable Perl the filename.pl file must be located in the current directory or in a directory listed in the Additional library path option in the Scripts section of the Preferences window. For installed Perl the filename.pl file must be located in the current directory or in a directory listed in the PERL5LIB environment variable.

Commander features
Perl script can call some Advanced Task Scheduler features via the Command line tool. The example below demonstrates how to send an e-mail message to a GMail address:

system($commander,
"--SendEMail",
"-email",
"username\@gmail.com",
"-server",
"smtp.gmail.com:587",
"-auth",
"username\@gmail.com",
"password",
"-starttls",
"-sender",
"sender\@mail.com",
"-subject",
"Subject",
"-msg",
"Text") == 0 or die "system @args failed: $?"

Where $commander is file name and path to the Command line tool: advscheduler_commander.exe, advscheduler_procmd.exe (Professional Edition) or advscheduler_netcmd.exe (Network Edition). Command line described in the Command line tool topic.

Python scripting in Advanced Task Scheduler

Internal and standard Python interpreter
Advanced Task Scheduler comes with internal portable Python interpreter. You only need to install Advanced Task Scheduler, create a Python script task and use all Python scripting power.

Python Task
Python Execution Log

Getting Python version
The script below displays current Python version to the task execution log:

import platform
print platform.python_version()

Current task’s arguments
The script below displays the advscheduler dictionary to the task execution log:

for key, value in advscheduler.iteritems() :
  print key, value

Load code from external files
The script below runs Python code from the filename.py file:

import filename.py

For portable Python the filename.py file must be located in the current directory or in a directory listed in the Additional library path option in the Scripts section of the Preferences window. For installed Python the filename.py file must be located in the current directory or in a directory listed in the PYTHONPATH environment variable.

Commander features
Python script can call some Advanced Task Scheduler features via the Command line tool. The example below demonstrates how to send an e-mail message to a GMail address:

from subprocess import call
call([commander,
"--SendEMail",
"-email",
"username@gmail.com",
"-server",
"smtp.gmail.com:587",
"-auth",
"username@gmail.com",
"password",
"-starttls",
"-sender",
"sender@mail.com",
"-subject",
"Subject",
"-msg",
"Text"]);

Where commander is file name and path to the Command line tool: advscheduler_commander.exe, advscheduler_procmd.exe (Professional Edition) or advscheduler_netcmd.exe (Network Edition). Command line described in the Command line tool topic.

   
About us   Privacy policy   Terms of use   Link to us
Current Version: 5.0.0.700
The following prices are based on a single order:
Basic Edition 32 and 64-bit$ 39.95 USD
Professional Edition 32 and 64-bit$ 59.95 USD
Network Edition 32 and 64-bit$ 149.95 USD
.:Testimonials

I use Advanced Task Scheduler to run my backups jobs. After performing a backup by standard Windows 2003 Server means, Advanced Task Scheduler launches a script which copies files. I am glad I chose your program.

Rob Hannigan

.:Requirements
Computer: Minimum required by operating system you are running.
Disk Space: Under 30 MB
Operating System: Microsoft Windows 32-bit or 64-bit.
Read more...