
			------------------------------------
			****	OPIS PROGRAMU RUNNER    ****
			------------------------------------
				     v. 2.16

				     PasnSoft
			http://home.comset.net/panoff/runner

 			 Instrukcja obsugi - wersja polska
				  
				  Cardano 20000
				cardano@kki.net.pl




0. SPIS TRECI
--------------

1. KRTKI OPIS
2. KONCEPCJA PROGRAMU
3. PLIK TERMINARZA
4. SKADNIA
5. INSTRUKCJE
6. ZMIENNE
7. OPCJE
8. ZMIANY W WERSJI 2.17





1. KRTKI OPIS
--------------

	RUNNER jest programem stworzonym do automatycznego uruchamiania aplikacji w wybranym momencie, bez ingerencji uytkownika. Mona go uywa do zamykania systemu Windows lub zamykania programw zgodnie z kalendarzem zdarze. Moliwe jestemulowanie zdarze zwiazanych z klawiatur i myszk, sprawdzanie plikw, odgrywanie dwikw czy sprawdzanie poczty, etc. Powysze czynnoci Runner moe wykonywa:
	- raz dziennie
	- raz w tygodniu okrelonego dnia
	- w danym miesicu
	- w dni robocze
	- w pierwszy lub ostatni dzie miesica lub tygodnia
	- kadego dnia
	- w dzie okrelony dat
	- w dzie parzysty lub nieparzysty
	- w zmiennych interwaach od podanego momentu
Pen kontrol nad czasem w programie uzyskuje si dziki nastpujcym moliwociom:
	- zdarzenie o okrelonej godzinie i minucie
	- zdarzenie co pewien czas
	- zdarzenie po pewnym czasie od momentu uruchomienia Runnera (w minutach)
	- zdarzenie po pewnym czasie od zaistnienia innego zdarzenia (w sekundach)
	- zdarzenie po pewnym czasie od zaadowania pliku terminarza dziaa
	- zdarzenie przy zamykaniu Runnera lub systemu
	- zdarzenie w przypadku, gdy kursor znajduje si w jednym z rogw ekranu
Poza tym, moliwe jest uywanie symboli wieloznacznych zamiast jednej lub kilku cyfr w dacie bd godzinie. Komendy mog by rwnie wykonywane okresowo, poczwszy od zadanego momentu. Cykl taki moe take zakoczy si w okrelonym czasie. Programy mog by uruchamiane w stanie zminimalizowanym, zmaksymalizowanym czy ukrytym. Moliwe jest te manipulowanie oknami aplikacji - zamykanie, minimalizowanie, przenoszenie, zwikszanie, ukrywanie etc., a take wysyanie do aplikacji zdarze zwizanych z klawiatur czy myszk. Runner pozwala na dodawanie wasnych opcji do menu programu. Program posiada wbudowan:
	- moliwo tworzenia okienek informacyjnych
	- wskanik wykorzystania pamici RAM
	- moliwo odgrywania dwikw typu WAVE
	- moliwo wstrzymywania systemu
	- moliwo poczenia z serwerem POP3
	- stan upienia
	- kontrol plikw i folferw
Dodatkowo pakiet posiada modu Rupdater.exe sucy do zmiany ustawie programu, bez jego wyczania. Wikszo zdarze moe by zapisywana w pliku dziennika.

2. KONCEPCJA PROGRAMU
---------------------

	Runner potrzebuje do dziaania tekstowego pliku terminarza, w ktrym umieszcza si harmonogram zdarze. cieka i nazwa tego pliku moe by umieszczona w linii polece programu. Jeeli uruchomimy Runnera bez argumentw zostanie wczytany domylny plik terminarza rcomm.txt, znajdujcy si w katalogu roboczym programu. Mona rwnie uy moduu Setup.exe do zdefiniowania domylnego pliku harmonogramu. Zaadowanie terminarza ma miejsce w momencie uruchomienia Runnera oraz o godzinie 00:00. Przy prbie uruchomienia wicej ni jednej kopii programu otrzymamy komunikat "Runner already loaded" i druga kopia zakoczy dziaanie. eby wyczy sprawdzanie, czy kopia programu jest uruchomiiona, naley uu opcji /b w linii polece np. "C:\Runner\runner.exe" /bC:\Runner\shedule.txt. Plik terminarza powinien mie nastpujc struktur:
	;komentarz
	[sekcja 1]
 	komenda 1
 	komenda 2
 	........
 	komenda N
 	;komentarz
 	[sekcja 2]
 	komenda N+1
 	komenda N+2
 	........
 	komenda N+M
Pierwsza (lub jedyna) sekcja moe nie mie komentarza. Zaleca si na kocu pliku dziennika uzycie instrukcji ex, ktora koczy prac programu. Poleca si rwnie umieszczenie skrtu do Runnera w autostarcie.

3. PLIK TERMINARZA
------------------

	Plik terminarza jest podzielony na sekcje, ktore grupuj komendy, majce wykona si jednego dnia. Domylny format nagwka sekcji wyglda nastpujco:
	[*nazwa sekcji*]
Nazwa sekcji skada si z dwch znakw (z wyjtkiem sekcji z okreslonym dniem miesiaca). Wielko liter nie ma znaczenia. Nagwek sekcjimoe rwnie zawiera informacje dodatkowe.
Nazwa sekcji okrela dzie wykonania danej sekcji i tak:
	- wykonywanie codziennie - ev
	- w dni tygodnia:
		* poniedziaek - mn
		* wtorek - tu
		* roda -we
		* czwartek -th
		* pitek - fr
		* sobota - sa
		* niedziela - su
	- okrelony dzie miesica (pierwszy poniedziaek, ostatnia niedziela etc.) - jak w dni tygodnia + cyfra okrelajca, ktory dzie miesica (dla ostatniego dnia miesica mona uzy  litery 'L') np. drugi poniedziaek miesica - [mn 2]
	- dni robocze - wo
	- weekendy - wd
	- ostatni dzie kadego miesica - la
	- pierwszy lub ostatni dzie roboczy lub weekend (pierwszy z litera 'F', ostatni z 'L') np. [wo f] oznacza pierwszy dzie roboczy miesica
	- dni parzyste - en
	- dni nieparzyste - od
	- w okrelonych odstpach - in, poczynajc od okrelonej daty zapisanyj w formcie DD.MM.RR (separatory nie maj znaczenia, kady element daty moe zosta opuszczony np. .MM.) np. [in 10 10.10.] - wykonanie sekcji 10, 20 i 20 padziernika biecego roku.
Istniej dwie sekcje specjalne, mianowicie op i mu, zawierajce opcje i menu uytkownika. Sekcje te s interpretowane w specjalny sposb i naley zwrci szczegln uwag na zachowanie odpowiedniego formatu zapisu.
	
4. SKADNIA
-----------

	Kada sekcja (z wyjtkiem [mu] i [op]) skada si z komendy i komentarza, ktory moze by umieszczony dziki zachowaniu odpowiedniej skadni. Jeeli na pocztku linii wystpi znak rednika, to zostanie ona w caoci zignorowana przez program. Kada linia komend skada si z czterech czci: etykiety oznaczajcej jednorazowe wykonanie (opcjonalnie), pola czasu, komendy i komentarza (opcjonalnie). Pola czasu i komendy mog by od siebie oddzielone spacj.
Etykieta musi by zawsze oddzielona od pola czasu znakiem dwukropka. Umieszczenie komantarza w linii wraz z polem czasu i komend wymaga zastosowania kombinacji znakw *! przed tekstem . Jeeli linia komend jest zbyt duga i nie moe by ogldana bez przewijania, moe zosta podzielona na kilka czci. Umieszczenie kombinacji znakw *+ na kocu linii oznacza, e nastpna linia jest kontynuacj poprzedniej. W kadej linii bdcej kontynuacj poprzedniej tekst komentarza mona umieszcza po znaku dzielenia. Schemat linii komend wyglda nastpujco:
	;Komentarz
	.Etykieta:Czas-Czas{interwa -czas_zakoczenia} komenda *! komentarz
Czas mona wyraa na cztery sposoby:
	- bezporednio, tz. GG:MM (wszystkie cyfr s wymagane, cznie z zerami), np. 05:30. Wmiesce jednej lub kilku cyfr mona uy symbolu wieloznacznego *. Jeeli linia komand ma pole czasu postaci **:**, oznacza to, e komenda bdzie wykonywana co minuta. Jeli 	pole czasu dzie wyglda np. tak 1*:15, znaczy to, e komenda wykona si o godzinie 10:15, 11:15 ..., a do 19:15 wcznie. Pole czasu moe zosta wzbogacone o interwa czasowy. W tym przypadku komenda bdzie wykonywa si poczwszy od danej godziny co okrelony czas np. zapis 10:00 {15-12:00} >komenda oznacza, e komenda bdzie si wykonywa co 15 minut pomidzy godzin 10:00 a 12:00. Moliwy jest rwnie zapis 10:00-12:00 >komenda, ktry oznacza, e komenda wykona si o godzinie 10:00 i przy odwieeniu terminarza (przy resecie Runnera).
	- z opnieniem od momentu uruchomienia Runnera: ^XXX, gdzie XXX oznacza opnienie w minutach, np. ^10 - dziesi minut po uruchomieniu Runnera (zapis ^ oznacza to samo co ^0).
	- z opnieniem od chwili odwieenia terminarza: ~XXX, gdzie XXX oznacza opnienie w minutach, np. ~10 - dziesi minut po odwieeniu terminarza (po resecie z menu Runnera lub po instrukcji re).
	- z opnieniem od momentu wykonania poprzeedniej komendy: +XXX, gdzie XXX oznacza opnienie w sekundach.  Naley pamita, e niedopuszczalna jest spacja pomidzy znakiem + a liczb okrelajc warto opnienia. W tym przypadku nie ma moliwoci cyklicznego wykonywania komend, natomiast nie ma ogranicze co do liczby linii zaczynajcych si znakiem +, jedynie pierwsza linia w takiej grupie musi zaczyna sie w jeden z wczeniejszych sposobw. Dopuszczalne jest niepodawanie adnej komendy po liczbie okrelajcej opnienie. 
Runner umoliwia rwnie wykonywanie komend po zajciu zdarzenia. Aby zdefiniowa tak linie komend, naley poda niemoliw warto pola czasu np. godzina > 23. Poniej znajduj si  rozpoznawane wartoci:
	- 97:XX - aby wykona komend, jeli kursor znajduje si w jednym z rogw ekranu przez 0,4 sekund. XX oznaczaj rogi ekranu: 00 - grny-lewy, 01 - grny-prawy, 02 - dolny-lewy, 03 - dolny-prawy. Dla jednej pozycji moe by przypisanych kilka komend. 
Przykad: 97:01 "C:\Windows\Matrix.scr" /s - uruchamia wygaszacz ekranu, jeli kursor znajdzie si w grnym-prawym rogu.
	- 98:XX - wykonuje komend przy zamkniciu systemu
	- 99:XX - wykonuje komend przy zamkniciu Runnera
Uywanie etykiety oznaczajcej jednorazowe wykonanie umoliwia wykonanie komendy raz dziennie, niezalenie od tego, w jaki sposb zosta wyraony czs wykonania. Etykieta musi byc umieszczona na pocztku linii, przed polem czasu, i musi posiada nastpujc struktur:
	.Identyfikator:
Runner umoliwia take powtarzalne wykonywanie komend. W tym celu za polem czasu podaje si wnawiasach {} odstp czasu w minutach pomidzy wykonaniami komendy, np. ^000{10} komenda - oznacza wykonanie komendy w momencie startu Runnera i co kade nastpne 10 minut. Aby okreli czas zakoczenia cyklu, naley go umieci w nawiasie {}, po liczbie okrelajcej interwa i znaku -, np. 08:00 {10 -17:00} >cm=>ce=Masz wiadomo !!! - od 8:00 do 17:00 bdzie sprawdzana poczta.
Jeeli komenda zawiera ciek do aplikacji, bdzie ona ustawiona jako domylna dla danego programu, z wyjtkiem aplikacji uruchamianych przez linie polece Windows (zobacz modyfikator #).
Za pomoc specjalnych modyfikatorw moliwe s rne sposoby uruchamiania aplikacji, stanu okien czy zapisywania zdarze do dziennika. Naley je umieszcza przed polem ze ciek do programu, niewicej ni jeden, dla jednego programu. Rozrniane s nastpujce modyfikatory
	- stan okna uruchamianej aplikacji ustawia si za pomoc znakw: , (przecinek), ' (apostrof) i ? (znak zapytsnia), ktre oznaczaj uruchomienie programu w stanie odpowiednio: zminimalizowanym, zmaksymalizowanym oraz ukrytym (bez widocznego okna i ikonki w zasobniku systemowym). Ostatni metod naley stosowa ostronie. Nie poleca si uywa tego sposobu dla aplikacji wymagajcych interakcji ze strony uytkownika.
Przykady:
09:30 ,C:\Windows\Notepad.exe - uruchomienie notatnika w stanie zminimalizowanym
09:30 'C:\Windows\Notepad.exe - uruchomienie notatnika w stanie zmaksymalizowanym
09:30 ?C:\Windows\Notepad.exe - uruchomienie notatnika w stanie ukrytym
	- modyfikator # okrela sposb uruchamiania programu. Jeli nie wystpuje on w linii polecenia, oznacza to, e zostanie utworzony nowy proces. Sposb ten dopuszczalny jest tylko dla aplikacji, np.
08:00 C:\Windows\Notepade.exe - uruchomienie notatnika
08:00 command /c MD Nowy_kat - utworzenie katalogu
Moliwe jest rwnie uruchamianie programw przez skrty, a take otwieranie plikw zarejestrowanych typw (rwnowane podwjnemu klikniciu na ikon lewym klawiszem myszy). W tym przypadku przed sciek do pliku naley umieci modyfikator #. Za nim mona podawa cieki do katalogw, skrtw, plikw zarejestrowanych typw, czy adresw URL.
Przykady:
06:00 #C:\Windows\Tips.txt - otwarcie pliku tekstowego w domylnym programie dla typu .txt
~ #http://home.comset.net/panoff/runner - otwarcie strony domowej Runnera

5. INSTRUKCJE
-------------

	Wewntrzne instrukcje programu Runner pozwalaj na kontrol pracy programu i planowanie zada. Mog by one zaplanowane na okrelon chwil, lub te wykona si po zaistnieniu pewnego zdarzenia. Pole polecenia w przypadku stosowania instrukcji musi zaczyna si znakiem > (wiekszoci). W sytuacji, gdy uywamy instrukcji nie naley stosowa modyfikatorw. Poniez najduje si opis instrukcji programu Runner.
	
	I. Instrukcje kontrolujce prac Runnera:
	   - ex - zakoczenie pracy programu, np. 23:59 >ex	   
	   - sl=XX - upienie Runnera na XX minut. w tym przypadku wykonywanie polece zostanie zatrzymane na okrelony czas, ikona w zasobniku systemowym bdzie ukryta.
Przykad: 01:00 >sl=240 - upienie programu na 240 minut.
	   - re = odwieenie terminarza. Polecenia, ktre byly ustawione na wykonanie si w momencie startu Runnera nie zostan wykonane.
Przykad: 06:00 >re - przeaduj terminarz o godzinie 6:00
	   - hd - ukrycie ikony Runnera. Bez ikony na pasku zasobnika systemowego program kontynuuje prac ale jest niedostpny. 
Przykad: 09:30 >hd - ukrycie Runnera o 9:30. Aby pokaza ikon na pasku nalezy w okrlonym momencie uy instrukcji sw lub uruchomi drug kopi programu (wtedy druga kopia pokae komunikat, e program jest ju uruchomiony i pokae ikon pierwszej kopii).
	   - sw - pokazanie ikony Runnera. Dziaa odwrotnie do instrukcji hd.
Przykad: 18:30 >sw - pokazanie ikony Runnera o 18:30
	   - ss nazwa_pliku - zapisuje dane sesji do pliku o podanej nazwie (domylnie Runner.sss). Kiedy wykonywane s instrukcje cb lub cf, dane dotyczce wykonywania polece, tj. komunikaty czy stany plikw, s umieszczane w licie w pamici RAM. Przy zamkniciu Runnera dane te zostaj utracone. Przy ponownym uruchomieniu programu Runner korzysta z danych tylko z aktualnej sesji. Uycie instrukcji ss pozwala zapisa dane sesji, i wykorzysta je przy kolejnym uruchomieniu Runnera. Zaleca si zapisywanie zdarze przy wychodzeniu z programu lub zamykaniu systemu (99:XX i 98:XX). 
Przykad: 99:00 >ss log.txt - zapisuje dane sesji do pliku log.txt przy zakoczeniu przez Runnera pracy.
	   - rs nazwa_pliku - wczytanie pliku z danymi poprzedniej sesji. Ta instrukcja jest uzupeniniem instrukcji ss. Naley j umieci w pierwszej linii sekcji, tak, aby wykonywaa si przy uruchamianiu Runnera tj. ^0.
	   
	II. Instrukcje kontrolujce prac programw.
	   
	    - cw=nazwa - zamyka okno, ktre w belce tytuowej zawiera podan nazw. Akcja ta jest rwnowana z wciniciem X w prawym-grnym rogu okna lub naciniciem Alt+F4. W przypadku tej , jak i poniszych instrukcji, wielko liter ma znaczenie. W czsie poszukiwania okienka zawierajceko w tytule podan nazw bd sprawdzana wszystkie okna otwarte w systemie i instrukcja cw zostanie wysana do wszystkich znalezionych okien. Jeli aplikacja ma niezapisany dokument, pojawi si zapytanie, czy chcemy go zapisa.
Przykad: 12:00 >cw=Notatnik - zamyka notatnik o godzinie 12:00
Instrukcja cw jest przestarzaa i zostanie usunita w przyszych wersjach. W zastpstwie naley uywac instrukcji fw.
	    - dw=nazwa - koczy dziaanie aplikacji o podanej nazwie. Ta instrukcja przerywa dziaanie programu w sposb podobny do nacinicia klawiszy Ctrl+Alt+Del. Wszystkie niezapisane dane zostan utracone. Moliwe s rwnie inne problemy np. brak pamici. Instrukcja dw jest przestarzaa i zostanie usunita w nastpnych wersjach programu. W zastpstwie naley uywa instrukcji fw.
	    - en=nazwa - wysya 'Enter' do okienka zawierajcego w tytule dan nazw. Instrukcja ta jest najczciej uywana do nacinicia domylnego przycisku (domylnie aktywnego).
Przykad:
06:00 scandskw c: - uruchomienie programu ScanDisk
+2 >en=ScanDisk - wysanie 'Enter' po 2 sekundach od wykonania poprzedniego polecenia
06:30 >dw=ScanDisk - koczy dziaanie programu
Instrukcja en jest przestarzaa i zostanie usunita w nastpnych wersjach programu. W zastpstwie naley uywa instrukcji fw.
	    - fw - znajduje okna aplikacji. Instrukcja ta znajduje okna aplikacji i pozwala je kontrolowa (zmienia wielko, przenosi, zamyka, emulowa zdarzenia zwizane z klawiatur bd myszk). Dodatkowo, instrukcja ta umozliwia wykonanie polecenia w odpowiedzi na znalezienie w systemie danego okna aplikacji. Kade okno w systemie ma waciwo 'text' (dla niektrych okien waciwo ta moe nie mie przypisanej wartoci). Dziki temu moliwe jest znalezienie zarwno okien nadrzdnych (Top-level), jak i podrzdnych (przyciski, pola tekstu, pola edycji) zawierajcych okrelony tekst. Teks okna nadrzdnego jest umieszczany w belce tytuowej, natomiast w przypadku okien podrzdnych (elementw kontrolnych) wewntrz okna. Poza waciwoci 'text', kade okno posiada waciwo 'class', ktra jest nazw klasy danego okna (ta waciwo ma zawsze przypisan jak warto). Format instrukcji fw jest nieco zoony:
	czas >fw{kryterium}=polecenie
Pole kryterium skada si z trzech czci:
	kryterium_okna_nadrzdnego;kryterium_okna_podrzdnego
Kryterium okna nadrzdnego jest to tekst zawarty w nazwie szukanego okna lub w nazwie klasy. Kryterium okna podrzdnego (kryterium kontrolki) to tekst zawarty w nazwie szukanego okna lub w nazwie klasy. Oba pola naley oddzieli rednikiem. W przypadku pominicia kryterium okna nadrzdnego, przeszukane zostan wszystkie okna nadrzdne. Jeli pominiemy kryterium okna podrzdnego z zachowaniem rozdzielajcego rednika, zostan znalezione domylnie aktywne elementy kontrolne okien  zawierajcych w tytule okrelony tekst. Pominicie rednika sprawi, e przeszukiwane bd wszystkie okna nadrzdne. Jeli natomiast wszystkie tzry elementy bd istniay, zostanie znalezione okno nadrzdne odpowiadajce kryterium okna nadrzdnego, a nastpnie jego okno podrzdne odpowiadajce kryterium okna kontrolnego. Aby poszukiwa okrelonego tekst w nazwie klasy nalezy kryterium poprzedzi znakiem : (dwukropek).
Przykady:
 	>fw{Okno;Przycisk} - poszukuje elementu kontrolnego (przycisku) zawierajcego tekst 'Przycisk', nalecego do okna zawierajcego w tytule tekst 'Okno'
 	>fw{Okno;} - poszukuje aktywnego elementu kontrolnego okna, zawierajcego w tytule tekst 'Okno'
 	>fw{Okno} - poszukuje okna zawierajcego w tytule tekst 'Okno'
	>fw{::TForm} - poszukuje okna, ktrego nazwa klasy zawiera teks TForm
	>fw{;Przycisk) - poszukuje elementu kontrolnego zawierajcego tekst 'Przycisk' w kadym oknie nadrznym w systemie
	>fw{;} - w tym przypadku zostan wybrane wszystkie aktywne elementy wszystkich okien nadrzdnych w systemie
	>fw{} - w takiej sytuacji zostana wybrane wszystkie okna nadrzdne w systemie
Pole polecenie powinno by w formacie instrukcja=argument (opcjonalny). Dopuszczalne instrukcje to:
cl - zamknicie okna
dy - przerwanie pracy aplikacji do ktorej naley okno
kp - emulacja klawiatury (opis w osobnym rozdziale); pozwala przesya zdarzenia zwizane z naciskaniem klawiszy. Opcja ta jest w fazie eksperymentw i autor programu nie gwarantuje jej poprawnego dziaania.
lc=X,Y - emulacja wcinicia lewego klawisza myszy w punkcie X,Y wybranego okna. Jeeli wartoci X i Y nie zostan podane, program domylnie przyjmie wsprzdne 0,0 (Wskanik myszy nie zostanie przesunity do okrelonego punktu)
rc=X,Y - emulacja nacinicia prawego klawisza myszy
dl=X,Y - emulacja podwjnego kliknicia lewym przyciskiem myszy
dr=X,Y - emulacja podwjnego kliknicia prawym przyciskiem myszy
mv=argumenty - zmiana pozycji lub wielkoci okna. Argumenty okrelaj parametry okna i ich nowe wartoci. Argumanty maj nastpujcy format: l:Lewy,t:Gra,w:Szeroko,h:Wysoko. 
sh=argument - zmiana stanu okna (poka/ukryj/minimalizuj/maksymalizuj). Dopuszczalne argumenty to: mi - minimalizacja, ma - maksymalizacja, hi - ukrycie, bez argumentu - pokazanie okna.

	III. Instrukcje dodatkowe.
	
	- st - przeczenie systemu w stan upienia. Uycie modyfikatora ! spowoduje wybranie metody cakowitego upiena. Pominicie modyfikatora spowoduje wybranie metody z dziaajc pamici RAM
	- me=tekst - okno informacyjne systemu Windows (MessageBox). Uytkownik moe zdefiniowa jedynie tekst. Okno dialogowe pojawi si na wierzchu (dotyczy to rwnie wygaszacza ekranu). Przykad: 08:00 >me=Hello world !!!
	- pl=cieka/nazwa_pliku_wave - odegranie pliku dwikowego WAVE. Nazwa pliku musi by podana wraz z rozszerzeniem. Niepodanie nazwy pliku lub jego nieznalezienie spowoduje odtworzenie domylnego dwiku Windows. Przykad: 08:00 >pl=alarm.wav
	- cb{adres_serwera_poczty:port(opcjonalnie);nazwa_uzytkownika;haslo} - sprawdza konto pocztowe na okrelonym serwerze. Przykad: **:00 >cb{polbox.com;Ktos;Haslo}=>me=Masz Widomo !!! - o kadej penej godzinie bdzie sprawdzana poczta; w przypadku nowej wiadomoci na koncie pojawi si okno informacyjne.
	- cf{argument}=polecenie - sprawdzenie stanu plikw i katalogw Dziki tej instrukcji moliwe jest wykonanie polecenia w przypadku zmiany daty okrelonego pliku lub liczby plikw w katalogu. Pole argumentw musi mie nastepujc struktur: {cieka;plik;gboko;typ}. Parametry cieka i plik okrelaj odpowiednio katalog i plik, ktrego stan bdzie sprawdzany.
Nazwa pliku moe zawiera symbole wieloznaczne. Gboko naley okreli jeeli chcemy katalog przeszukiwa rekursywnie (z podkatalogami). Brak tego parametru spowoduje wyczenie rekursji. Parametr typ okrela co Runner ma sprawdzi: * - sprawdzenie czasu ostatniej zmainy, + sprawdzenie zwikszenia liczby plikw, - sprawdzenie, czy liczba plikw zmniejszya si, 1 - sprawdzenie istnienia pliku, 0 - sprawdzenie, czy plik nie istnienieje. Jedynym wymaganym argumentem jest cieka. Brak innych parametrw spowoduje przyjcie nastpujcych wartoci domylnych: *.* - pliku, 0 - gboko, * -typ. Pzry pierwszym wykonywaniu tej instrukcji stan pliku jest zapisywany, jeeli przy kolejnym wykonaniu stan ten bdzie inny, zostanie wykonane polecenie. Przykad: **:00 >cf{D:\Docs;*.doc;0;*}=xcopy D:\Docs\*.* C:\Docs /e /d - o kadej penej godzinie bd sprawdzana pliki .doc z katalogu D:\Docs, i jeeli ktry z nich zosta zmieniony, wszystkie zostan przekopiowane do katalogu C:\Docs.
	- wl=teks - dopisanie tekstu do pliku dziennika, np. 12:00 >wl=Samo poudnie !!! - zapisanie w pliku dziennika linijki Wed, 5 Apr 2000 12:00 samo poudnie !!!

6. ZMIENNE
----------

	W programie Runner moliwe jest uzywanie specjalnych sw kluczowych zwanych rwnie zmiennymi wewntrznymi), zaczynajcych si znakiem ?. Sowa kluczowe przed wykonaniem instrukcji s zastpowane odpowiednimi wartociami. W zapisie tych sw wielko liter ma znaczenie. Istniej nastepujce sowa kluczowe:
	- ?TODAY - zmienna zostaje zastpiona aktualna dat w formacie DD.MM.RR
	- ?DAY-XX - zmienna zostaje zastpiona dat w formacie DD.MM.RR sprzed XX dni
	- ?DATE__ - zmienna zostaje zastpiona aktualn dat w formacie RRRRMMDD
	- ?TIME__ - zmienna zostaje zastpiona aktualn godzin w formacie GG:MM:SS
	- ?DAT-XX - zmienna zostaje zastpiona dat w formacie RRRRMMDD sprzed XX dni 
	- ?USER - zmienna zostaje zastpiona nazw zalogowanego uytkownika
	- ?HOST - zmienna zostaje zastpiona nazw komputera


7. OPCJE
--------

	Opcje umoliwiaj zmian niektrych domylnych wartoci oraz poszerzaj funkcjonalno programu. Umieszcza si je w specjalnej sekcji rozpoczynajcej si nagwkiem [op]. Nie ma adnych ogranicze odnonie pooenia tej sekcji w pliku terminarza czy jej wielkoci. Nie mona natomiast miesza tej sekcji z sekcj wykonywalna. Niektre opcje nie maja parametrw, inne za posiadaj parametry, ktre umieszcza sie po prawej stronie nazwy opcji. Nazwy opcji skadaj si z dwch liter i s nastpujce:
	- ed - ustawienie edytora dla pliku terminarza, ktry uruchomi si po pdwjnym klikniciuna ikonie programu, lub wybraniu opcji Edit z menu. 
Przykad:
ed=C:\Program Files\UltraEdit\Uedit32.exe - po podwjnym klikniciu plik terminarza zostanie otwarty w programie UltraEdit
	- dc - zamiana domylnego zdarzenia po podwjnym klikniciu na ikonie Runnera. Domylnie program otwiera plik terminarza w notatniku). 
Przykad: 
dc=>me=Runner !!! - po klikniciu pojawi si komunikat o treci Runner !!!
	- hd - uruchomienie Runnera w stanie ukrytym, bez ikony w zasobniku systemowym. Jeeli brak jest tej opcji, program uruchamia si normalnie, z ikonka w pasku.
	- sd - ustawia dat odniesienia (dat zerow)
	- mc - wcza i ustawia wskanik wykorzystania pamici RAM. Program posiada wewntrzny wskanik pamici RAM, dziaajcy w oparciu o informacje od systemu Windows. Wskanik ten pokazuje wykorzystanie pamici RAM na dwa sposoby: zmiana kolorw ikony Runnera w zalenoci od iloci wolnej pamici (od zielonego pzrez ty do czeronego) oraz wywietlanie informacji po najechaniu kursorem nad ikon programu. Domylnie warto przy ktrej ikona Runnera ma kolor zielony wynosi 50%, natomiast dla kolory czerwonego - >20%. W przypadku podania dwch wartoci granicznych, dotycz one koloru tego i czerwonego, za podanie jednej wartoci dotyczy tylko kolory tego.
Przykad:
mc 30 10 - wskanik wczony, przy 30% wolnej pamici ikona bdzie miala kolor zty, przy 10% - czerwony, w przypdaku gdy wolnej pamici jest wicej ni 30% - kolor zielony
	- nn - wyczenie informacji o bdach powstaych podczas wykonywania instrukcji
	- lf - ustalenie cieki dla pliku dziennika, np. lf C:\Windows\Temp\Log.txt
	- le - zapisywanie informacji o bdach do pliku dziennika
	- ls - zapisywanie czasu uruchomienia i zakoczenia pracy Runnera
	- lx - zapisywanie czasu wykonania instrukcji
	- lp - zapisywanie informacji zwizanych z zarzdzaniem energi
	- lh - zapisywanie ukrycia i pokazania ikony Runnera
	- lr - zapisywanie przeadowania (odwieenia) pliku terminarza
	- ll - zapisywanie wykonania instrukcji sl
	
8. PROGRAMY POD DOS
-------------------

	Wiele programw napisanych dal systemu DOS wykorzystuje lini polece do przekazywania argumentw. Mog by one uruchamiane przez Runnera tak jak aplikacje Windows, jednak rekomendowane jest uycie interpretatora polece COMMAND.COM z opcj /c gdzie /c oznacza zamknicie okna DOS po wykonaniu programu (Win95/98) lub CMD.EXE (WinNT).
Przykad:
(Win95/98)
09:00 command.com /c xcopy c:\Moje dokumenty\*.* D:\Backup
(WinNT)
09:00 cmd /c xcopy c:\Moje dokumenty\*.* D:\Backup

9. ZMIANY W WERSJI 2.17
-----------------------
	- automatyczne zapisywanie do pliku dziennika. Instrukcje ss i rs zostay usunite.
	- moliwo wprowadzania do linii polece dowolnych kodw ASCII (z wyjtkiem zero)
	  w zapisie dziesitnym (?XX), semkowym (?0XX), szesnastkowym (0xXX) i binarnym
	  (0bXXXXXXXX)
	- nowe wewntrzne zmienne:
		?TODAYdd - dzie w formacie DD
		?TODAYmm - miesic w formacie MM
		?TODAYy2 - rok w formacie RR
		?TODAYy4 - rok w formacie RRRR
		?WEEKDAY - dzie tygodna (dwucyfrowy ?)
		?YEARDAY - dzie roku (trzycyfrowy)
		?TIME6 - czas w formacie GGMMSS
	- nowe instrukcje do emulacji klawiatury i myszy
		ie=makro
		Makro zapisuje si wedug nastpujcych zasad:
		+ znaki aplfanumeryczne zapisuje si maymi literami
		+ klawisze specjalne:       
ESC ENTER SHIFT ALT CTRL SPACE CAPS TAB F1 .. F12 BS 
INS HOME PGUP DEL END PGDN
UP DOWN LEFT RIGHT (arrows keys)
PRINTSCREEN SCROLL (Scroll Lock) PAUSE
NUM0 .. NUM9 NUMPOINT GREY+ GREY- GREY* GREY/ GREYENTER
		+ emulacja wcinicia klawisza (bez puszczenia) - < przed symbolem klawisza
		+ emulacja puszczenia klawisza - > po symbolu klawisza
		+ emulacja myszki:
			LBUTTON - kliknicie lewym przyciskiem
			RBUTTON - kliknicie prawym przyciskiem
			DLBUTTON - podwjne liknicie lewym przyciskiem
			DRBUTTOM - podwjne kliknicie prawym przyciskiem
			MOVE(X,Y) - ustawienie kursora w punkcie ekranu o wsprzdnych X,Y
			MOVER(dX,dY) - przesunicie kursora z aktualnej pozycji o dX,Dy
			MOVEW(x,y) - ustawienie kursora w punkcie x,y aktywnego okna
		+ emulacja wcinicia (bez puszczenia) klawiszy myszki jak dla klawiatury
		+ DELAY(XXX) - opnienie midzy poszczeglnymi czynnociami makra w milisekundach (domylnie 100)
		+ dodatkowe instrukcje do manipulowania oknami:
			ACT(xxxx) - ustawia okno zawierajce tekst xxx jako aktywne
			SHOW(xxxx) - pokazuje (przywraca) okno
			HIDE(xxxx) - ukrywa okno
			MIN(xxxx) - minimalizuje okno
			MAX(xxxx) - maksymalizuje okno
			CLOSE(xxxx) - zamyka okno
			Uycie powyszych instrukcji bez nawiasu dotyczy bdzie tylko aktywnego okna, za z dopiskiem ALL w nawiasie - wszystkich okien.
			WINMOVE(X,Y) - przesynicie okna do punktu X,Y (lewy-grny rg)
			WINMOVER(dX,dY) - przesunicie wzgldne okna o dX,dY od pooenia aktualnego

PS. Przepraszam za bdy i wszelkie niedocignicia.
    Prosz o informacje o znalezionych bdach.
    Cardano
    email: cardano@kki.net.pl