SyncDiscs user guide

Syncjob files


Syncjob files

A syncjob file is created when the menu button to the right of the Save button in the main control window is used to raise a Save as dialogue, and the file is saved, either by dragging the file icon to a Filer window, or by entering the full path and pressing <Return> or clicking on OK.

The file will contain a complete copy of every setting (as in the main control window and the additional settings window) as pertaining at the time the file is created. These settings will be used to start or queue a synchronisation when the file is subsequently run. Note that the syncjob settings can be different to those shown in the control and settings windows when it is subsequently run, and will not change those settings. Different syncjobs may have different settings - the settings for a job will apply only to that job.

syncsave.png -
6Kb

Ways to use syncjob files

In order for syncjob files to be recognised and acted on correctly, then, if SyncDiscs has not already been run, SyncDiscs must have been 'seen' by the filer. This occurs when the directory containing SyncDiscs is first opened by the filer, or by adding SyncDiscs to Configure>Boot>Look at so its !Boot file is run when the machine is booted.

Double clicking
Double clicking on a syncjob file displayed in a filer window will cause SyncDiscs to load and run the file. If SyncDiscs is not already on the iconbar, then it will be launched first. If SyncDiscs is idling, then the synchronisation will start immediately. If SyncDiscs is already running a synchronisation, the new job will be placed in the job queue, and will be acted on as the queue is processed.
Drag 'n drop
Dragging a syncjob file from a filer display and dropping it onto the SyncDiscs main window (or progress window) or onto the iconbar icon will run the file in the same way as double clicking (above). It is also possible to drag 'n drop a selection of syncjob files, when all the jobs will be queued.
Use of the Ctrl key - If the Ctrl key is held down during the drag 'n drop, then all the settings are loaded into the SyncDiscs control window, but the job is not run or added to the queue. The settings may then be modified as required before manually running the synchronisation or resaving the file. This applies also when double clicking on a syncjob file. (Note: Dragging a selection of files with Ctrl held down will load only one set of settings, since the contents of each file will overwrite the previous contents in the SyncDiscs dialogue)
Alarm applications
A common requirement with backup management is to do backups at regular intervals using an alarm application. This is easily done using e.g. !Alarm itself or !Organizer.
Alarm
From the iconbar menu select Alarms.... If you already have some alarms set, the alarm listing will open. Click menu in this window, and select Set new alarm.

alarm3.png - 19Kb

The alarm edit window will open (shown below). If you do not yet have any alarms entered, the alarm edit window will open immediately when you select Alarms... from the iconbar menu.

alarm.png - 34Kb

You will need to do the following.
  • Set the date and time for the first occurrence of the alarm
  • Tick the option Task alarm
  • Tick the option Repeating alarm. The window will now extend to show the frequency options
  • Set the frequency at which the alarm is to repeat
  • Drag the syncjob file icon from the filer display into the message field, where the file path will be entered
  • Once happy with the settings click Save. The file will now be run at the time and frequency specified

The screen shots above were taken using !Alarm version 2.79 (RISC OS 5)

Organizer
From the iconbar menu select Alarm.... This will open the dialogue shown below. To set up an alarm carry out the following.
  • Set the time of day when the backup is to take place
  • Tick the option Task alarm
  • Tick the option Repeating alarm
  • In the lower part of the window (only visible once 'Repeating alarm' has been ticked) set up the repeat interval
  • Drag the syncjob file icon from the filer display into the message field, where the file path will be entered
  • Once happy with the settings click OK. The file will now be run at the time and frequency specified

org.png - 42Kb

The above screen shot was taken using !Organizer version 2.06.

Obey files
It may be that you want to backup several different directories at the same time. Assuming you have already saved a jobfile for each of the directories, then the simple way is to double click on each of them in turn to load them into the queue. As an alternative, it may be neater to set up an obey file to run several syncjobs at the same time. This is easily accomplished.

Create a new obey file in your favourite text editor. Type in Filer_run followed by a space. Leave the caret where it is and, while holding down Shift, drag in the syncjob file you wish to include and then press <Enter>. Holding down the Shift key means that the file path of the dragged file is entered into the file, rather than the contents of the file. Repeat for other files as required. The obey file may now look something like this.

obey.png - 11Kb

Now save the file in a suitable location. Make sure it is filetyped as an obey file. Double clicking on its icon will run it, the effect being to load all the jobs into the SyncDiscs queue and run them. You could also set up a task alarm for it in the same way as described above. When the file is run by the alarm application, the jobs will be queued in SyncDiscs and processed in turn.

Queue limits
Note that there is a limit to the number of jobs that can be queued at the same time (25 in version 1.24)

  Precautions   |   Index   |   Date/time stamps  

SyncDiscs is © 2012, Chris Johnson and David Pilling
Email:chris@chris-johnson.org.uk

This document last modified on 2nd November 2020

These pages are best viewed in a CSS compliant browser. For RISC OS, Netsurf would be the browser of choice.