  
  BTOOL v1.19                                                 (c) by DRK-SOFT
  


  Ŀ
   BESCHREIBUNG 
  

  BTool ist ein kleines Programm, das mehr oder weniger ntzliche Routinen
  fr Batchdateien anbietet. So knnen Batchdateien um Funktionen erweitert
  werden, die mit den Standard-Befehlen nicht so einfach zu realisieren sind.



    JETZT ERSTMAL WICHTIGE HINWEISE - AM ENDE DER DOKU LIEST SIE EH KEINER  <g>
  

                Dieses Programm gehrt zu den Freeware-Programmen !
  Das bedeutet, da dieses Programm beliebig oft benutzt, kopiert, gelscht,
  verschenkt, bestaunt, beschimpft, .... ja sogar weggeworfen werden darf !

    Fr Schden jedlicher Art, die durch die Benutzung dieses Programmes
    auftreten sollten,  ist der Autor AUF KEINEN FALL haftbar zu machen.

   Auch wenn dieses Programm Freeware ist und nichts kostet wrde ich mich
   ber eine kleine Gegenleistung sehr freuen. Eine einfache Mail an mich
   in der mir mitgeteilt wird welche Version dieses Programms benutzt wird
   und woher diese Version bezogen wurde. Dadurch erfahre ich etwas ber die
   Verbreitung dieses Programmes und im Gegenzug informiere ich dafr dann
   ber evtl. neue Versionen. Fragen, Anregungen, Kritik, Lob, Spenden, etc.
   sind natrlich auch willkommen.

          Mail an :     Christian Klak@2:2433/613.15       (FIDO)
                        drk-soft@gmx.net                   (EMail)




  Ŀ
   SYNTAX 
  

   BTOOL <Funktion> [Parameter]

   Funktion     : die gewnschte Funktion
   Parameter    : die notwendigen Parameter abhngig von der Funktion




  Ŀ
   FUNKTIONEN (alphabetisch sortiert) 
  

  
   BEEP                                                Erzeugt einen Beep-Ton

   Beispiel : BTOOL BEEP
  
   CDCLOSE                                       Schliesst ein CDRom-Laufwerk

   Beispiel : BTOOL CDCLOSE              ( Schliesst erstes CDRom )
              BTOOL CDCLOSE H:           ( Schliesst CDRom H: )

   ERRORLEVEL :     0 = Ok      1 = Fehler aufgetreten
  
   CDOPEN                                           ffnet ein CDRom-Laufwerk

   Beispiel : BTOOL CDOPEN               ( ffnet erstes CDRom )
              BTOOL CDOPEN H:            ( ffnet CDRom H: )

   ERRORLEVEL :     0 = Ok      1 = Fehler aufgetreten
  
   CHECK_OS2                                                 Ist OS/2 aktiv ?

   Beispiel : BTOOL CHECK_OS2

   ERRORLEVEL :  0 = kein OS/2         1 = OS/2 v1.x        2 = OS/2 v2.x
                 3 = OS/2 WARP v3.0    4 = OS/2 WARP v4.0
  
   CHECK_WIN                                              Ist Windows aktiv ?

   Beispiel : BTOOL CHECK_WIN

   ERRORLEVEL :  0 = kein Windows  1 = Windows 3.x   2 = Win95   3 = WinNT
  
   DESQVIEW                                              Ist DesqView aktiv ?

   Beispiel : BTOOL DESQVIEW

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   DIR_EXIST                                      Existiert das Verzeichnis ?

   Beispiel : BTOOL DIR_EXIST C:\DOS6

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   DISKFREE                 Ausreichend Speicher auf dem aktuellen Laufwerk ?

   Beispiel  : BTOOL DISKFREE 100M
   Bedeutung : Sind auf dem aktuellen Laufwerk noch 100MB frei ??

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung :      100  bedeutet 100 Bytes.
                    100K bedeutet 100 KBytes.
                    100M bedeutet 100 MBytes.
  
   ECHO                        ECHO-Ersatz mit einigen Makros     (umleitbar)

   Makros :             $DIR      : aktuelles Verzeichnis
                        $DRIVE    : aktuelles Laufwerk
                        $DAY      : aktueller Tag
                        $MONTH    : aktueller Monat
                        $YEAR2    : aktuelles Jahr ( zweistellig )
                        $YEAR4    : aktuelles Jahr ( vierstellig )
                        $DATE     : aktuelles Datum
                        $TIME     : aktuelle Uhrzeit
                        $DOY      : der Tag des Jahres
                        $KW       : aktuelle Kalenderwoche
                        $CPU      : benutzter Prozessor

                        $D        : aktueller Tag
                        $M        : aktueller Monat
                        $Y        : aktuelles Jahr (zweistellig)
                        $C        : aktuelles Jahrhundert (zweistellig)
                        $h        : Stunde
                        $m        : Minute
                        $s        : Sekunde

   Beispiel : BTOOL ECHO Heute ist der $DAY.$MONTH.$YEAR4
  
   ECHO_CENTER                 ECHO-Ersatz mit einigen Makros     (umleitbar)

   Identisch mit Funktion ECHO, allerdings wird die Ausgabe zentriert !
  
   EMS_INSTALLED                                Ist ein EMS-Treiber geladen ?

   Beispiel : BTOOL EMS_INSTALLED

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   EMSFREE                                 Ist noch genug EMS-Speicher frei ?

   Beispiel : BTOOL EMSFREE 4096

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung : Angaben immer in KByte
  
   FILE_EXIST                      Existenz einer Datei ( WildCards erlaubt )

   Beispiel : BTOOL FILE_EXIST C:\AUTOEXEC.*

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   GET_DAY                                Liefert den Wochentag im Errorlevel

   Beispiel :  BTOOL GET_DAY

   ERRORLEVEL :    0 = SONNTAG       1 = MONTAG        2 = DIENSTAG
                   3 = MITTWOCH      4 = DONNERSTAG    5 = FREITAG
                   6 = SAMSTAG
  
   GET_DAYOFMONTH                    Liefert den Tag des Monats im Errorlevel

   Beispiel :  BTOOL GET_DAYOFMONTH
  
   GET_HOUR                         Liefert die aktuelle Stunde im Errorlevel

   Beispiel :  BTOOL GET_HOUR
  
   GET_MONTH                                  Liefert den Monat im Errorlevel

   Beispiel :  BTOOL GET_MONTH

   ERRORLEVEL :    1  = JANUAR      2  = FEBRUAR        3  = MRZ
                   4  = APRIL       5  = MAI            6  = JUNI
                   7  = JULI        8  = AUGUST         9  = SEPTEMBER
                   10 = OKTOBER     11 = NOVEMBER       12 = DEZEMBER
  
  
   GET_WEEKOFYEAR            Liefert die aktuelle Kalenderwoche im Errorlevel

   Beispiel :  BTOOL GET_WEEKOFYEAR
  
   IPX_INSTALLED                                Ist ein IPX-Treiber geladen ?

   Beispiel : BTOOL IPX_INSTALLED

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_286+                                       Abfrage auf 286er oder hher

   Beispiel : BTOOL IS_286+

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_386+                                       Abfrage auf 386er oder hher

   Beispiel : BTOOL IS_386+

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_486+                                       Abfrage auf 486er oder hher

   Beispiel : BTOOL IS_486+

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_CDROM                             Ist das aktuelle Laufwerk ein CDROM ?

   Beispiel : BTOOL IS_CDROM

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_DATE                                    Abfrage eines bestimmten Datums

   Beispiel :  BTOOL IS_DATE 24.12.1995

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung :  Das bergebene Datum wird eigenstndig um das System-
                datum erweitert, so kann z.B. durch BTOOL IS_DATE 01
                auch der erste eines jeden Monats abgefragt werden.
  
   IS_DAY                                Abfrage eines bestimmten Wochentages

   Beispiel :  BTOOL IS_DAY FREITAG

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_MONTH                                   Abfrage eines bestimmten Monats

   Beispiel :  BTOOL IS_MONTH JANUAR

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_RAMDISK                        Ist das aktuelle Laufwerk eine RAMDISK ?

   Beispiel : BTOOL IS_RAMDISK

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_SET                          Ist eine Variable im Environment gesetzt ?

   Beispiel : BTOOL IS_SET TEMP

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_SUBST                          Ist das aktuelle Laufwerk substituiert ?

   Beispiel : BTOOL IS_SUBST

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   IS_TIME                                    Abfrage einer bestimmten Uhrzeit

   Beispiel :  BTOOL IS_TIME 08:35

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung :  Die bergebene Uhrzeit wird eigenstndig um die System-
                uhrzeit erweitert, so kann z.B. durch BTOOL IS_TIME 09
                auch abgefragt werden, ob es zwischen 9 Uhr und 10 Uhr ist.
  
   MEMFREE                                Ist noch genug Hauptspeicher frei ?

   Beispiel : BTOOL MEMFREE 600

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung : Angaben immer in KByte
  
   MSCDEX                                                  Ist MSCDEX aktiv ?

   Beispiel : BTOOL MSCDEX

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   POPDIR                Setzt das zuletzt mit PUSHDIR gesicherte Verzeichnis
                         wieder als aktuelles Verzeichnis

   Beispiel : BTOOL POPDIR  oder  BTOOL POPDIR 1

   Bemerkung : Benutzung der Nummer siehe unter PUSHDIR
  
   PUSHDIR                    Sichert das aktuelle Verzeichnis auf einem Stack

   Beispiel : BTOOL PUSHDIR  oder  BTOOL PUSHDIR 1

   Bemerkung : Durch die Angabe einer Nummer knnen mehrere unterschiedliche
               Stacks angelegt werden um evtl. Probleme mit gleichzeitig
               laufende Batchdateien zu vermeiden. Der Nummer entsprechend
               wird auf unterschiedliche Dateien zugegriffen - dadurch kann
               auch in mehreren Batchdateien zeitgleich mit den Routinen
               PUSHDIR/POPDIR gearbeitet werden.

               Die Angabe der Nummer ist aber nicht notwendig.
  
   RANDOM                              Liefert eine Zufallszahl im Errorlevel

   Beispiel : BTOOL RANDOM 20    -> liefert Zufallszahl zwischen 0 und 19
  
   SAVESCREEN           Schreibt den aktuellen Bildschirminhalt in eine Datei

   Beispiel : BTOOL SAVESCREEN HARDCOPY.TXT

   ERRORLEVEL :     0 = Ok      1 = Fehler aufgetreten
  
   SET_ERRORLEVEL       Beendet einfach nur mit einem bestimmten Errorlevel

   Beispiel : BTOOL SET_ERRORLEVEL 10
  
   WAIT                                Wartet eine bestimmte Zeit in Sekunden

   Beispiel : BTOOL WAIT 10
  
   VAR_ADD        Addiert eine positive/negative Zahl zu einer Variablen

   Beispiel :       SET NUMMER=0
                    BTOOL VAR_ADD NUMMER 10
                    BTOOL VAR_ADD NUMMER -10

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten

   Bemerkung :  Die gewnschte Variable muss bereits existieren
                und einen numerischen Wert haben.
  
   VAR_CHGEXT     ndert bei Variablen die einen Filenamen beinhalten
                  die Extension des Filenamens.

   Beispiel :       SET FILE=TEST.ZIP
                    BTOOL VAR_CHGEXT FILE RAR
                    ECHO %FILE%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_GETCDROM   Speichert den Laufwerksbuchstaben vom gefundenen CDRom
                  in einer gewuenschten Environmentvariable.

   Beispiel :       BTOOL VAR_GETCDROM CDROM    (Speichert erstes CDROM)
                    ECHO %CDROM%

                    BTOOL VAR_GETCDROM CDROM 2  (Speichert zweites CDROM)
                    ECHO %CDROM%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_GETRAMDISK  Speichert den Laufwerksbuchstaben von einer gefundenen
                   RamDisk in einer gewuenschten Environmentvariable.

   Beispiel :       BTOOL VAR_GETRAMDISK RAMDISK    (Speichert erste RamDisk)
                    ECHO %RAMDISK%

                    BTOOL VAR_GETCDROM RAMDISK 2    (Speichert zweite RamDisk)
                    ECHO %RAMDISK%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_LOWCASE    ndert den Inhalt einer Variablen in Kleinbuchstaben.

   Beispiel :       BTOOL VAR_LOWCASE PATH
                    ECHO %PATH%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_RANDOMNAME  Erzeugt einen zuflligen Dateinamen und speichert
                   ihn in einer Environment-Variablen ab.

   Beispiel :       BTOOL VAR_RANDOMNAME TEMPFILE
                    ECHO %TEMPFILE%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_READSTR     Liest einen String in eine Variable ein.

   Beispiel :       BTOOL VAR_READSTR EINGABE
                    ECHO %EINGABE%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   VAR_SET         SET-Ersatz mit Macro-Ersetzung.

   Beispiel :       BTOOL VAR_SET NASE=$CPU
                    ECHO %NASE%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten

   Bemerkung :  Fr die Liste der mglichen Makros siehe ECHO
  
   VAR_UPCASE     ndert den Inhalt einer Variablen in Grossbuchstaben.

   Beispiel :       BTOOL VAR_UPCASE PATH
                    ECHO %PATH%

   ERRORLEVEL :     0 = Ok          255 = Fehler aufgetreten
  
   WAITORKEY      Wartet eine bestimmte Zeit in Sekunden oder auf Tastendruck

   Beispiel : BTOOL WAITORKEY 10

   ERRORLEVEL :     0 = Zeit abgelaufen    1 = Taste gedrckt
  
   XMS_INSTALLED                                Ist ein XMS-Treiber geladen ?

   Beispiel : BTOOL XMS_INSTALLED

   ERRORLEVEL :     0 = NEIN      1 = JA
  
   XMSFREE                                 Ist noch genug XMS-Speicher frei ?

   Beispiel : BTOOL XMSFREE 4096

   ERRORLEVEL :     0 = NEIN      1 = JA

   Bemerkung : Angaben immer in KByte
  


 Ŀ
  VIREN-SCHUTZ 
 

 Vor jeder Ausfhrung berprft das Programm sich selbst auf Vernderungen.
 Werden Vernderungen festgestellt, wird eine Warnung ausgegeben und das Pro-
 gramm beendet. Da ein Virus die Ursache fr die Vernderung sein knnte,
 empfiehlt es sich bei dieser Warnung den kompletten Rechner auf Viren zu
 untersuchen.

 Zustzlich liegt diesem Programm im Originalarchiv die Datei CRCHECK.TXT
 bei, mit deren Hilfe alle Dateien die zu diesem Programm gehren auf
 Korrektheit/Virenbefall berprft werden knnen. Dazu wird allerdings das
 zustzliche Programm CRCHECK bentigt, dass diesem Archiv nicht beiliegt.

  CrCheck ist ein Programm von ROSE Softwareentwicklung
  (c) ROSE Softwareentwicklung, Dipl.-Ing (FH) Ralph Roth


                                                                      - ENDE -
