Back Again/2000 Scheduler Initialization
========================================

Author:  Michael Warmuth <michael@warmuth.at>
Type:    Utility for Back Again/2000 Server
Version: 0.0.01
(c) Michael Warmuth - EDV-Dienstleistungen 2001


1. Preface
----------

The backup program Back Again/2000 Server 2.10d has an WPS integrated scheduler
which seems to be a subclass of the WPFolder class. To schedule a backup set
just place a shadow of the set in this folder and specify the date/times the
backup set should be executed.

Although there is a problem: At system startup this scheduler does not
initialize which means that no backups will be started. The installation of
Back Again/2000 Server does put an object called "Back Again/2000 Scheduler"
into the Startup folder, but what this thing is for nobody knows.

After digging around I found out that when the Back Again/2000 Scheduler Folder
is accessed the first time using the WPS the initialization takes place.

As CDS's (the vendor of this program) does not response to various e-mails or
is able to answer support questions sent using their Web form I had to solve
this problem (which is just one of many) by myself. The result is this REXX
program.


2. Function
-----------

The program is started from within the Startup folder, accesses the Back
Again/2000 Scheduler Folder using the SysSetObjectData function and exits. This
is sufficient to initialize the scheduler.

(To be exact: The code needed is just !one! line. The rest of the program is
for installation and de-installation.)


3. Installation
---------------

+ Unzip the content of the archive to a *temporary* directory.

+ Run:

     SchedAdd Install

  This copies itself and the file with the icon to the Back Again/2000 prgram
  directory. If it cannot find it the installation will fail. Then it creates
  a program object for itself within the Back Again/2000 Server folder and
  a shadow object of this program object in the Startup folder. If this all
  worked successfully it will delete itself and the icon file from the
  temporary directory you unzipped it into.


4. Usage
--------

There is not much to do: The shadow object in the Startup folder does all it
needs to do. If you want to try it out manually, just start it without any
parameter:

   SchedAdd

To check if it works correctly shut down your system. Restart it, but do not
touch the Back Again/2000 folder, it's content or it's subfolders and their
content using the WPS. Open a OS/2 Window instead and check the content of the
file "EVENTS.LOG" in the root directory of the boot drive (if you did not
change this). The last lines should say something like:

   [23-JUN-01 23:23:18] 'XXX.BST' added to scheduler

where XXX are the names of your scheduled backup sets. Check the time within
square brackets, which should be the time the WPS initialized at system
startup.

If this is true, the installation was successful. If not you still have a
problem.


5. De-Installation
------------------

Just run:

   SchedAdd Uninstall

This will remove the program objects and delete the program file and the icon
file.


6. Help
-------

There are only two ressources for help:

+ This file.

+ Run:

     SchedAdd Help


7. Remarks
----------

I am quite sure that this program - in its current form - does not work with
the non-server version of Back Again/2000. First of all I do not know if there
is a scheduler included in this version. If it is, then this program can
work there, too. But as the string "SV" (for SerVer) occures in the object IDs
of the Back Again/2000 WPS objects there is a big chance that they are
different from the non-server version. For this very reason all strings are
defined at the start of the code. Exchange them with the appropriate values and
if it works then send me the result, please.


Vienna, Austria, 20010624

