home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
AmigActive 4
/
AACD04.ISO
/
AACD
/
Utilities
/
ClockedX
/
ClockedX.doc
< prev
next >
Wrap
Text File
|
1999-11-01
|
11KB
|
221 lines
#==========================================================================#
| |
| ClockedX 1.1ß |
| ------------- |
| |
| a helpful commodity for starting programs at specific times of day |
| |
| by Niels Böhm alias Mr.WC |
| |
#==========================================================================#
requirements: an Amiga/emulator (obviously)
kickstart 2.05 / OS 37 or higher
commodities.library V37 or higher
COPYRIGHT ANNOTATION:
Although this program is freeware and may be copied and spread at
will, yet the copyright remains intact. None of the files may be
changed in any way and the archive must be distributed in its
complete form.
The author may not be held responsible for damage or loss of data
caused by this program, wether directly or indirectly.
The program:
With this program one can have executed certain actions at certain times of
day. It is supposed to be a system-conforming commodity. hopefully :-)
The gadget user interface (GUI):
The GUI (what means the preferences window in this case) may not only be
opened in one way. Following possibilities exist:
(1) by executing ClockedX, while the Tooltype "CX_POPUP" either
must not be present or has to be set to "YES" or "TRUE"
(2) by executing ClockedX twice. As a result, the second process
ends immediately and the first one opens its window.
(3) by sending a CONTROL-F break to the process. That can be
achieved, for example, by simultaneously pressing "Ctrl" and
"F" inside the SHELL windows from which ClockedX has been
launched. Another possibility is being provided by the Break
command from the "C:" directory.
(4) by applying the hotkey combination, which has been preset
via the tooltype "CX_HOTKEY". If this tooltype is missing,
the combination defaults to "Ctrl"-"left Amiga key"-"X".
(5) thru the commodity control program "Exchange"
The large part of the GUI is occupied by the list of actions in conjunction
with the string gadget for completing and changing the first one. An action
always consists of the running time and the command to execute, that, after
all, is nothing else than a SHELL command. The same action may be performed
at different times as well as several actions may be started simultaneously.
Any commands that are set off by ClockedX are being launched asynchronously.
That means that ClockedX keeps on running even when the action has not yet
finished. One should especially be aware of this fact when many actions need
to be startet at the same moment as they could possibly affect each other.
The remaining part of the window is occupied by following gadgets:
Insert for inserting/copying an action
Delete for deleting an action
Save for saving all settings to the tooltypes of the
program
Hide for hiding the gadget user interface (GUI)
Enable/Disable for enabling/disabling the program. As long as the
commodity is enabled, the title bar of the window
will display the current system time and the actions
are being executed when the preferred time has been
reached, if it is disabled, neither of the mentioned
things is true.
Quit for exiting ClockedX. The settings will not be saved
on quit.
The description of any of the possible tooltypes will follow:
DONOTWAIT while being ignored by ClockedX,
needs to be specified, when ClockedX
is stored in the "WBStartUp" drawer,
for making the Workbench not to wait
before going on starting the next
program
STARTPRI=<priority> is ignored by ClockedX, too. The
default: "0" programs in the "WBStartUp" drawer
are sorted by the Workbench
according to this start priority.
The application with the highest
priority gets executed at first.
CX_POPKEY=<key combination> specifies the hotkey combination
default: "control lcommand x" through which the window of ClockedX
can be hidden and opened
CX_POPUP=<YES|NO|TRUE|FALSE> determines, if the window should be
default: "YES" opened upon startup of ClockedX.
"YES" and "TRUE" result in a
preopened window at the start, "NO"
and "FALSE" prevent it from doing
so.
CX_PRIORITY=<priority> sets the priority by which the
default: "0" commodity is enqueued into the
InputEvent queue. When, for
instance, another commodity with a
higher priority UNTERCEPTS the timer
events and "DESTROYS" them (what, of
course, no normal program does),
they won't arrive at ClockedX's
filters and as a result the actions
would not be performed. Does,
however, ClockedX have a higher
commodity's priority than the other
program, such problems won't show
up.
LEFT=<left> specifies the offset of the window
default: "0" from the left border of the screen
TOP=<top> specifies the offset of the window
default: "11" from the top border of the screen
WIDTH=<width> sets the width of ClockedX's window
default: "256"
HEIGHT=<height> sets the height of ClockedX's window
default: "123"
INPUT=<input source> determines the source of the inputs
default: "NIL:" for the actions. It defaults to no
input, because the source of input
is the "silicon-NIL-vana". But this
may effortlessly be changed to e.g.
"CON:0/0/640/128/Input/AUTO".
OUTPUT=<output target> determines the target of the outputs
default: "NIL:" of the actions to launch. The
default target for that is the
"silicon-NIL-vana", too, whereby
possible outputs remain invisible.
However, a change into "PRT:" for
outputting to the printer or e.g.
"CON:0/128/640/128/Output/AUTO/WAIT"
for outputting to a console remedies
things.
STACKSIZE=<stack size> changes the stack memory size
default: "4096" assigned to the created processes
into any value starting from 4096
bytes
PRIORITY=<priority> sets the actions' process' priority
default: "0" to a globally predefined value. But
this should, however, not be greater
than ClockedX's task priority (not
to be confused with the commodity's
priority).
ENTRY=<time/action entry> lists the actions and the times at
that the first ones are to be
started. This tooltype may occur
any number of times you like (only
limited by memory).
ClockedX supports all of the 4 Break signals; these have following effects:
Ctrl-C quits ClockedX
Ctrl-D disables ClockedX
Ctrl-E enables ClockedX
Ctrl-F shows/hides the gadget user interface (GUI)
Finally there are some examples with explanation of their effects:
00:00:00 NewSHELL -> always at midnight a SHELL is
being opened
12:00:00 LoadWB -> always at high noon the Workbench
is being loaded, if it wasn't
already open
04:00:00 FixFonts -> the "FONTS:" directory will be
12:00:00 FixFonts updated in 8 hour intervals
20:00:00 FixFonts
06:00:00 Delete T:#? ALL -> always at 6 o'clock AM the
06:00:00 Copy ENV:#? ENVARC: ALL temporary directory is being
emptied and at the same time the
environmental variables are saved
15:30:00 RX S:examine.rexx -> always at half past three PM the
AREXX-script, residing in the
"S:" directory, is being executed
MY THANKS MUST GO TO:
* my finnish friend "wind", for betatesting
* Commodore, for this incredibly fantastic machine called Amiga
If there are questions or problems, you will like to contact my via the
following address:
Niels Böhm
Johannes-Kepler-Str. 2a
07407 Rudolstadt-Schwarza
GERMANY