documentation tinyAlrm.exe FREEWARE

requires OS/2 2.0 or higher                     June 30 2006
 
Martin@hypermake.de
http://www.hypermake.de


                      TINY ALARM  2.5 


---english--------(german at the end of the file)-------------

Tiny Alarm is a very simple PM program. You can choose between
(Alarm) "Countdown", (Alarm) "time" and "chime". With "Count-
down", you will get a slider with settings from 0 to 60 minutes.
"time" lets you enter an alarm time with hours and minutes.
When time is over, a window opens and you hear a sound.
With "Chime" you will get a beep, for example every 10 minutes.
Normally, the chime clock starts counting when changing the
value in the chime window. With the option "related to time",
the chime is related to the system time: When starting at 13:15
with an one hour chime, it will beep at 14:15, 15:15 without the
"related to time" option. With "related to time" it will beep
at 14:00, 15:00.

You are allowed to use the tree functions simultaneusly.
 
In the Countdown and Alarm time window, you will find a checkbox
"Shutdown". That can be useful if you have the possibility to
turn the system power off by a clock. The Tiny Alarm shutdown
DOES NOT TERMINATE RUNNING PROGRAMS (for programmers: it does not
send WM_QUIT messages).
It's the same effect as pushing Ctrl-Alt-Del: All cached data
will be saved, the harddisk is set to a correct state.
To avoid a shutdown you do not want, a window with a countdown of
30 seconds and several beeps appears before performing shutdown.  
With the parameter "normalshutdown", you can choose a normal
shutdown closing your running programs. But if these apps are
creating a message box like "save file x? Yes No", the system
shutdown fails!!! (Remember the querying DOS and OS/2 command
line windows.) 

TinyAlarm is activated only every two seconds. So a chime of 9
seconds is rounded to 8 seconds.

If you click into the white clock field with the left mouse button,
the program window only shows the white clock area. A second click
will get the menu and titlebar back. With the parameter "float", the
small window floats on top when it is covered by another window.
With the "nodate" parameter, you can decrease the size of the small
clock window.
With "nomenu", the small clock window is standard and changes to
the titlebar window if you point into it with the mouse.

You can also start TinyAlarm with several parameters:

tinyalrm 15        will start 15 minutes countdown

tinyalrm 20:30     will start alarm at alarm time 20:30  

detach tinyalrm 0:1:30
                   starts a 90 sec chime. "detach" does not close 
                   the cmdline window when starting tiny alarm.

tinyalrm title:"Close the toilet window!"
                   sets the title of the main window and the alarm
                   window. Helps you distinguishing several instances
                   of Tiny Alarm. 

tinyalrm bigfont
                   If you have got a 1024x1280 screen, Warp 4 uses
                   bigger default fonts which exceeds the window.
                   Use the "bigfont" option in this case, this will
                   force a bigger window.                   

tinyalrm 20:30 0:10:0 shutdown bigbeep nomenu relatedtime silent
                   sets checkboxes "shutdown", "big beep"
                   and "related to time"
                   "nomenu" shows only the white clock area
                   "silent" turns the long beep completely off

tinyalrm float nodate notime noalarm    
                   the small clock window floats on top, no date
                   and no time is shown; also alarm (countdown,
                   time, chime) values are omitted in the small
                   window. 

tinyalrm float fix 600:350
                   The small clock window floats and is fixed at
                   screen position 650 horizontal 350 vertical
                   (0:0 is the left bottom corner of the screen).
                   The "float fix" setting lets the window always
                   float even if you use a virtual screen utility.

tinyalrm float seldom
                   Floating windows can occur problems when floating
                   while another window draws itself. With "seldom" 
                   TinyAlarm will float only every 10 seconds instead
                   of every 2 seconds, this will reduce such problems
                   with other windows.

tinyalrm onlybeep
                   If the alarm rings TinyAlarm catches the focus.
                   That can be nervy when working in a fullscreen
                   session. "onlybeep" let your hear only ONE beep
                   without opening an alarm window. Do not use this
                   option together with the "silent" option...

Note: A parameter with one number will set countdown, with two 
alarm time and with tree chime. You have to use the : char 
between the numbers. Don't use capital letters.


 Here is the list of all other programs I've programmed. 

 CD Shortcut is also available for Win95/NT.

 You will find the programs in the Internet: visit my Homepage 

 http://www.vr-transport.de/Martin

 both Win95/NT and OS/2; Linux versions for some programs planned. 

 WSedit:
 Editor compatible to Wordstar: reading and writing Wordstar
 (DOS) files, ASCII IBM and ISO codepage.
 Supports Wordstar Ctrl key commands and CUA commands.
 Syntax-highlightning, Translation, spell checking, function
 key macro recorder and a lot of other features. WSedit handles
 very large ASCII files. Freeware.

 pmCalc:
 Pocket calculator with scientific and programmer functions,
 calculating with variables, Regression, easy transfer to/from
 the clipboard, detailed error messages, online help. pmCalc
 recalculates the result after every keystroke. You enter a
 formula like you would in a programming language. Shareware 30$. 

 Hypermake:
 Creates HTML files, Winhelp MS HTML-Help and OS/2 
 Help from a more simple and intelligent ASCII format. 
 Automatic linking, window arrangement, helptables, 
 footnotes, tables and other features. Shareware if 
 source file > 20 kB. 

 TinyAlarm:
 A simple countdown with a slider from 1 to 60, an alarm
 by entering alarm time and a chime. System shutdown. Freeware. 

 Simple Zipshell:
 Packing and unpacking ZIP files by using the graphical desktop.
 Freeware. 

 cd-shortcut: 
 instead of whole directory names you enter only substrings.
 Searching through several drives and opening OS/2 WPS 
 folders. Freeware.
 
 Clear: (only OS/2)
 Creating file lists for deleting and backup. Works together
 with Info-Zip. Freeware.


TinyAlarm History

1.0 -> 2.0 chime, shutdown, small clock window, floating
2.1 -> 2.1 hard and normal shutdown, fixed position
2.1 -> 2.3 auto changing from small to titlebar window when "nomenu",
           new parameters: bigfont, notime, float seldom, onlybeep.
2.3 -> 2.4 ringing is limited to 3 times, countdown OK when using
           big system fonts 
2.4 -> 2.5 title: commandline parameter let you distinguish several
           instances of TinyAlarm; minor fixes for use with current
           OS/2 - eCS distributions


---german-------------------------------------------------------------

"Tiny Alarm" ("Winziger Wecker") ist ein sehr einfaches PM-
Programm. Sie knnen zwischen "Countdown" (Kurzzeitwecker),
"time" (Weckzeit) und "chime" (ein in festen Intervallen sich
wiederholender Piepston) whlen. Mit "Countdown" erhalten Sie
einen Schieber mit einem Bereich von 0 bis 60 Minuten. Mit
"Alarm time" knnen Sie einen einfachen Wecker aktivieren,
wobei Sie einfach die Minuten und Stunden der Weckzeit
eingeben.
"enabled" und "disabled" bedeutet "Wecker eingeschaltet" und
"ausgeschaltet". Der Wecker lutet, indem ein Fenster geffnet
wird und ein Klingelton ertnt.
Normalerweise beginnt der Chime dann zu zhlen, wenn die letzte
nderung im Chime-Fenster vorgenommen wurde. Wenn Sie aber
"related to time" whlen, bezieht sich der Chime auf die Tages-
zeit. Wenn Sie einen Chime von 1 Stunde um 13:15 starten, knnen
Sie es also entweder um 14:15 und 15:15 piepsen lassen oder mit 
"related to time" zur vollen Stunde. 

Sowohl im Countdown- als auch im Time-Fenster knnen Sie bei
"Shutdown" (Systemabschlu) ein Hckchen setzen. Das ist
zusammen mit einer Zeitschaltuhr sinnvoll, die den Strom des
Computers abdreht. Der Tiny Alarm Systemabschlu SCHLIESST
NICHT DIE LAUFENDEN PROGRAMME (fr Freaks: sendet keine
WM_QUIT messages). Es ist der selbe Effekt wie wenn man Strg-
Alt-Entf drckt: Alle gepufferten Daten werden geschrieben,
die Festplatte wird in einen sauberen Zustand gebracht.
Um nicht einen solchen "harten" Systemabschlu aus Versehen
zu produzieren, erscheint 30 Sekunden vorher mit mehreren
Piepsern ein Fenster, mit dem man den Vorgang noch abbrechen
kann.
Mit dem Parameter "normalshutdown" werden die laufenden Pro-
gramme ordnungsgem geschlossen. Wenn diese aber beim
Schlieen Rckfragen machen wie "Datei x sichern Ja Nein?",
klappt der Systemabschlu nicht!!! (Achtung bei den rckfra-
genden DOS- und OS/2-Fenstern!)

Da TinyAlarm nur alle zwei Sekunden die Zeit berprft, wird
ein Chime von z. B. 9 Sekunden zu 8 Sekunden.

Ein linker Mausklick in das weie Anzeigefeld fhrt zur allei-
nigen Anzeige des weien Anzeigefeldes. Ein weiterer Mausklick
holt das Men wieder her. Mit dem Parameter "float" schiebt
sich Tiny Alarm bei der alleinigen Anzeige des weien Feldes
immer in den Vordergrund. Mit "nodate" lt sich die Anzeige
des Datums unterdrcken, so da dieses Feld noch kleiner wird.

Mit "nomenu" wird die alleinige Anzeige der Uhr ohne Men zum
Standard. Das Fenster wechselt zur Men-Anzeige, wenn die
Maus einfach in das kleine Uhr-Fenster gezogen wird.


Es knnen auch einzelne Parameter bergeben werden:

tinyalrm 15       startet mit Kurzzeitwecker 15 Minuten

tinyalrm 20:30    startet mit Weckzeit 20.30 Uhr

detach tinyalrm 0:1:30
                  startet einen 90 sek chime. "detach" schliet 
                  nicht das Kommandozeilenfenster beim Start
                  von Tiny Alarm

Beachte: Ein Parameter mit einer Zahl setzt den Countdown, mit
zwei setzt Alarm time und mit drei den Chime. Es mssen Doppel-
punkte zwischen den Zahlen verwendet werden. Geben Sie bitte
nur Kleinbuchstaben ein.


tinyalrm title:"Toilettenfenster schlieen!"
                   ermglicht Ihnen, bei mehreren Tiny Alarm Instanzen
                   diese auseinanderzuhalten. Statt "Tiny Alarm" er-
                   scheint sowohl im Hauptfenster als auch im Alarm-
                   fenster der gewnschte Titel.  

tinyalrm bigfont
                   Bei sehr hohen Bildschirmauflsungen (1024x1280
                   und grer) verwendet Warp 4 standardmig grere
                   Schriften. Das kann zur Folge haben, da Texte
                   abgeschnitten werden. Verwenden Sie in diesem Fall
                   den Parameter "bigfont".

tinyalrm 20:30 0:10:0 shutdown bigbeep nomenu relatedtime silent
                  setzt Hckchen bei "shutdown", "big beep"
                  und "related to time"
                  "nomenu" zeigt nur das weie Anzeigefeld
                  "silent" dreht den langen Piepston ganz ab 

tinyalrm float nodate notime noalarm    
                   Das Anzeigefenster ohne Titelzeile schiebt
                   sich immer in den Vordergrund (float), dabei 
                   werden weder Datum, Uhrzeit noch Alarmangaben
                   von Countdown, Time und Chime angezeigt. Das
                   groe Fenster mit Titelzeile bleibt davon
                   unberhrt.

tinyalrm float fix 600:350
                   Das kleine Anzeigefenster schiebt sich in
                   den Vordergrund immer bei Position 650 hori-
                   zontal 350 vertikal, wobei 0:0 die linke
                   untere Ecke des Bildschirms ist. Mit
                   "float fix" erscheint das Fenster selbst
                   bei virtuellen Bildschirmtools stndig.

tinyalrm float seldom
                   In den Vordergrund sich schiebende Fenster knnen
                   bei anderen Programmen Probleme verursachen, wenn
                   diese sich gerade aufbauen und Ihnen ein floaten-
                   des Fenster dazwischenfunkt. Mit "seldom" (selten)
                   kann die Float-Frequenz von 2 Sekunden auf 10
                   Sekunden erhht werden, was die meisten Probleme
                   beseitigt.

tinyalrm onlybeep
                   Wenn es klingelt, holt sich TinyAlarm den Fokus.
                   Das kann rgerlich sein, wenn man sich gerade
                   in einer Gesamtbildschirmsitzung befindet.
                   "onlybeep" ffnet gar kein Fenster mehr sondern
                   es ertnt nur noch der Klingelton. Verwenden Sie
                   "onlybeep" nicht zusammen mit "silent" ...!


Weitere Programme von mir, alle auch auf deutsch:

 Im Internet finden Sie die Programme ber meine 
 Homepage: 

 http://www.hypermake.de

 Stand: Juli 2006

 Alle Programme gibt es fr OS/2 und Windows. Linux-Versionen sind fr
 die Zukunft geplant.


 WSedit
 Wordstar-kompatibler Freeware-Editor. Liest und schreibt
 Wordstar (DOS), ASCII IBM und ISO Zeichensatz.
 Untersttzt neben gewhnlichen CUA-Befehlen auch die
 Wordstar-Ctrl-Befehle. Syntax-Highlightning, bersetzung,
 Wortprfung, Funktionstasten als belegbare Makrotasten
 und vieles mehr. Kann sehr lange Dateien lesen und
 schreiben. Freeware. 

 Simple Zipshell
 eine Handvoll kleiner Batch-Dateien, um mit ZIP-Dateien
 elegant ber die graphische Oberflche ein- und auspacken
 zu knnen. Freeware. Win95-Archiv enthlt Info-Zip.   

 pmCalc
 Taschenrechner mit wissenschaftlichen und Programmierer
 Funktionen, Rechnen mit Variablen, Regression, Unter-
 sttzung der Zwischenablage, detaillierte Fehlermeldungen,
 kontextsensitive Hilfe. pmCalc berechnet das Ergebnis erneut
 nach jedem Tastendruck. Man gibt Formeln entsprechend der
 Schreibweise von Programmiersprachen ein. Shareware 50 DM.

  
 HyperMake. Erzeugt HTML-Dateien, Winhelp und 
 OS/2 Hilfe aus einem einfachen und intelligenten 
 ASCII-Formates. Automatische Querverweise, 
 Fensteranordnung, Funoten, Helptables usw. 
 Shareware bei Quelltextgre > 20 kB. Siehe 
 Hypertext. 

 Textbuch. Doppelte Buchfhrung 
 fr Selbstndige und kleine bis mittlere GmbH's. Mit 
 Inventarspiegel. Arbeitet wie ein Compiler. Input und 
 Output sind Textdateien. Umfangreiche 
 Hypertext-Hilfedatei. Shareware bei > 350 
 Buchungsstze pro Jahr. 

 cd-shortcut 2.0: Abkrzung fr cd 
 (change directory). statt vollstndiger 
 Verzeichnisnamen werden Substrings eingegeben. 
 Freeware 

 nur OS/2 

 Clear Datensicherungs- und  Lschprogramm.
 Erstellt Textdatei-Dateilisten nach 
 diversen Kriterien arbeitet mit zip zusammen. 
 Freeware 


---english at the beginning of the file----------

