TaskForest
A simple, expressive, open-source, text-file-based Job Scheduler with console, HTTP, and RESTful API interfaces.
Documentation
  1. Downloading TaskForest
  2. Installing TaskForest
  3. Configuring TaskForest
    1. Jobs & Families
    2. Calendars
    3. Automatic Retries
    4. Sending Emails
    5. Options
    6. Configuration File
  4. Running TaskForest
  5. Running the TaskForest Web Server
  6. Web Server Security
  7. Checking TaskForest Status
  8. Rerunning a Job
  9. Marking a Job
  10. Tokens
  11. Releasing all Dependencies from a Job
  12. Putting a Job on Hold
  13. Releasing a Hold Off a Job
  14. HOWTO
  15. The RESTful Web Service
  16. Frequently Asked Questions (FAQ)
  17. Bugs
  18. Change Log
  19. Author
  20. Acknowledgements
  21. Copyright

Checking TaskForest Status

To get the status of all currently running and recently run jobs, enter the following command:

status

OR

status --log_dir=/foo/logs --family_dir=/foo/families

OR

status --log_dir=/foo/logs --family_dir=/foo/families \
--collapse

If the --collapse option is used then pending repeat jobs will not be displayed.

The ``status'' command also accepts a ``--date'' option, in which case it displays all the jobs that ran for that date. The date must be in the ``YYYYMMDD'' format:

status --log_dir=/foo/logs --family_dir=/foo/families \
--date 20090201

If the date specified is not the same as the current date, the ``--collapse'' option doesn't make any sense, because there can't be any pending jobs for a date in the past.

When displaying the status for days in the past, there is no way for the system to know what time zone the jobs were scheduled for. This is because the corresponding family file could have changed between the time that the job ran and the time that you're running the status command. To resolve this, the system will always display jobs in the time zone specified by the 'default_time_zone' option. If the default time zone is not specified, its default value is ``America/Chicago''.

Checking Status Via the Web Site

To check the status for the current day's jobs, direct your browser to /status.html. To check the status for earlier days, use the "View Logs" form that's available on every page of the web site.