home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 October / PCO1097.ISO / FilesBBS / DOS / DATSCRN.EXE / DATSCRN.DOK < prev    next >
Encoding:
Text File  |  1997-08-23  |  33.5 KB  |  600 lines
  1.  
  2.           DATSCRN Version 0.51Γ - Copyright: Carsten Kruse
  3.        Compiler fuer ANSI- und ASCII-"Datum"-Files fuer BBSs
  4.                                   
  5.                            Carsten Kruse
  6.                          Hilde-Coppi-Str. 5
  7.                              07552 Gera
  8.                                   
  9.                         BBS: +49-365-4205249
  10.                     Usenet: c.k@beg.gera.thur.de
  11.                           FIDO: 2:248/4002
  12.                         Treknet: 37:103/410
  13.                        Blind-Net: 333:490/100
  14.                                   
  15.                                   
  16.                                   
  17.                        ╔═══════════════════╗
  18.                        ║   DOKUMENTATION   ║
  19.                        ╚═══════════════════╝
  20.  
  21.  
  22.  
  23.  
  24.        0. Ich will schnell updaten, wo finde ich die Infos?
  25.        
  26.        Einfach die Datei HISTORY.DOK durchlesen :-)
  27.  
  28.  
  29.  
  30.        1. Wofuer ist DATSCRN gedacht?
  31.  
  32.        Das  BBS-Programm  "Remote  Access"  (und evtl.  auch andere)
  33.        bietet die Moeglichkeit, den Usern  beim Login einen fuer den
  34.        jeweiligen Tag zugeschnittenen Screen zu zeigen.  So kann man
  35.        also fuer den Neujahrstag, fuer den Heiligabend oder auch den
  36.        Tag der deutschen Einheit einen speziellen Screen  erstellen.
  37.        Dies  macht  man  normalerweise  mit dem exzellenten TheDraw.
  38.        Anschliessend benennt man  die  Datei  nach folgendem Schema:
  39.        MM-DD.A??  (wobei A??  fuer ANS, ASC und AVT  steht.)  Danach
  40.        speichert  man  die Dateien im zugehoerigen Verzeichnis, z.B.
  41.        \RA\TXTFILES.    Bei   diesem   Verzeichnis   und   ggf.  dem
  42.        Logverzeichnis fuer DATSCRN kann man seit v0.37 die  Variable
  43.        %TASK%  verwenden,  so  dass man mit *einer* Installation von
  44.        DATSCRN dennoch mehrere  Tasks  bedienen  kann.  Man schreibt
  45.        also z.B. in C:\RA%TASK%\TXTFILES, was DATSCRN anhand der per
  46.        Kommandozeile   uebergebenen   Tasknummer   (/T=<Tasknummer>,
  47.        entweder direkt als Zahl oder per Mailervariable)  dann  z.B.
  48.        in C:\RA2\TXTFILES umsetzt.
  49.  
  50.        Leider gibt es nun - meiner bescheidenen Meinung nach  -  ein
  51.        paar  Probleme:  Es  gibt  365/366  Tage  im  Jahr - will man
  52.        wirklich  so  viele  Dateien  anlegen?   (Mindestens 730/732,
  53.        falls man auf AVT verzichtet...) Falls man die  alle  anlegt,
  54.        dann  sind  das ca.  700kB, (eigentlich sogar viel mehr, wenn
  55.        man bedenkt, dass pro Datei  ja mindestens ein ganzer Cluster
  56.        verbraten wird), Dateien also, die ausser fuer einen  Tag  im
  57.        Jahr,  sinnlos  auf der Platte herumliegen :-(  Falls man die
  58.        Dateien fuer einen speziellen  Tag  bearbeiten will, muss man
  59.        immer wieder erst TheDraw o.ae.  laden.  (Gewisse  Feiertage,
  60.        z.B.    Ostern,  liegen  ja  jedes  Jahr  auf  einem  anderen
  61.        Datum...)
  62.  
  63.        Darum habe ich DATSCRN  erstellt.   Es gestattet, mit relativ
  64.        geringem Aufwand ANSI- und ASCII-Dateien fuer den  jeweiligen
  65.        Tag    zu   erstellen,   wenn   es   sein   muss,  auch   mit
  66.        "Jedertags-Spruechen",  unter   Schonung   bisher  erstellter
  67.        Datums-Files und  mit  der  Moeglichkeit,  seinen  wertvollen
  68.        Festplattenplatz zu sparen :-)
  69.  
  70.        Seit Version 0.35 kann man  nun seine User noch vielfaeltiger
  71.        erfreuen :-).  Man kann, je nach Wunsch  ein  'Kalenderblatt'
  72.        entweder an die o.g.   Dateien  anhaengen lassen (es ist dann
  73.        zwar eine Datei, aber sie wird in zwei  Schritten  angezeigt)
  74.        oder   aber   das   Kalenderblatt  separat  ausgeben  lassen.
  75.        Damit  kann  man,  so  man  es  moechte,  die  User  noch auf
  76.        besondere  Tage/Feiertage   hinweisen,   die   jedoch   nicht
  77.        unbedingt  so  wichtig  sind, als dass man dafuer extra einen
  78.        Text erstellt haette.  Als nuetzliches Nebenprodukt wird auch
  79.        noch  recht gross das Datum des jeweiligen Tages dargestellt.
  80.        Falls  man  es  uebrigens  partout  will,  kann  man  mittels
  81.        Kommandozeilenoption  /NK  dafuer   sorgen,  dass  weder  ein
  82.        'Jedertags-Text' noch ein speziell fuer  den  Tag  erstellter
  83.        Text (z.B. mit ausfuehrlichen Gedanken zum 7.10.  ;), sondern
  84.        nur   ein   Kalenderblatt  erstellt  wird.   Das  waere  zwar
  85.        ueberhaupt nicht im Sinne  des Programms, aber manchmal gehen
  86.        ja die Wuensche der User unerforschliche Wege... :-)
  87.        Es ist uebrigens dafuer  gesorgt, dass ein Kalenderblatt, was
  88.        als extra Datei erstellt wurde, beim Durchlauf  am  naechsten
  89.        Tage  entweder  ueberschrieben wird (falls etwas fuer den Tag
  90.        in der entsprechenden Vorlagedatei enthalten ist - ganz klar)
  91.        oder  aber  es  geloescht  wird,  oder  aber  -  wenn man die
  92.        Kommandozeilenoption /KJ benutzt -  ein Kalenderblatt mit der
  93.        Mitteilung,  dass  dem   Sysop   fuer   diesen   Tag   nichts
  94.        Bemerkenswertes  bekannt  sei,  erstellt  wird.  Als weiterer
  95.        Anreiz (die einlaufenden  Mails fuer 'Registrierungen' [siehe
  96.        unten]    sind    nicht    sooo     viele)     ist     dieses
  97.        'Kalenderblatt-Feature' uebrigens eines mit einem {+}.
  98.        Seit der Version  0.50Γ  ist  es  moeglich,  dass man auf dem
  99.        Kalenderblatt anzeigen laesst, wieviele Tage es bis  zum/seit
  100.        dem 1.1.2000 sind.  Anmerkung:   Sicher ist bekannt, dass das
  101.        neue Jahrtausend eigentlich erst am 1.1.2001 beginnt,  da  es
  102.        ja  kein  Jahr  0 gab, sondern gleich mit dem Jahr 1 begonnen
  103.        wurde.  Fakt ist aber, dass  ein  Satz "Noch xxx Tage bis zum
  104.        neuen Jahrtausend", der sich auf den 1.1.2000 bezieht, falsch
  105.        ist, und wenn er auf den 1.1.2001 bezogen wird, Fragen dieses
  106.        oder jenen Users an den Sysop  provoziert,  die  dann  wieder
  107.        Nerven  zum  Beantworten  der  Mails kosten...  ;-) Ich denke
  108.        mal, dass es so geht.   Um aber alle Wuensche zu befriedigen,
  109.        ist es seit der 0.51Γ moeglich,  auch  korrekt  "...Tage  bis
  110.        zum/  seit  dem neuen Jahrtausend" anzuzeigen oder aber sogar
  111.        auf Daten eigener Wahl zu  verweisen, z.B. "Noch XYZ Tage bis
  112.        Heiligabend".
  113.        Eine neue Kommandozeilenoption gibt  es  ab der Version 0.36:
  114.        Man kann die Ausgabe des  Headers  und  des  Footers  in  den
  115.        Datumsfiles   unterdruecken.   Dadurch  kann  man  die  Texte
  116.        bereits vorformatiert  und  umrahmt  als  Vorlage fuer andere
  117.        Programme nutzen.  DATSCRN also auf dem Weg zur  eierlegenden
  118.        Wollmilchsau...  ;)
  119.  
  120.        Seit Version 0.38  ist  der  Versuch einer Unterstuetzung von
  121.        Multitaskingsystemen durch Freigabe von Timeslices eingebaut.
  122.        Leider fand ich nur ein Beispiel  fuer  Pascal,  welches  ich
  123.        dann auf PB uebertragen habe (viva la ASM ;).  Allerdings hat
  124.        es  mich bei Tests unter dem bei mir installiertem OS/2 weder
  125.        im DOS- noch im OS/2-Fenster so recht ueberzeugt.  Naja, kann
  126.        sein, dass  ich  noch  eine  bessere  Routine  finde.  Wer es
  127.        wirklich  braucht,  kann  es  per  Kommandozeilenswitch   /RT
  128.        aufrufen. (Verkuerzung auf /R ist hier *nicht* moeglich!)
  129.       
  130.        Man  kann  DATSCRN  jetzt  auch  fuer  weitere  BBS-Programme
  131.        nutzen.   Dort  ist   allerdings   das  Datums-Feature  nicht
  132.        eingebaut.  Man kann aber die Begruessungsdateien WELCOME.A??
  133.        oder   TEXT1.A??    nennen.   Allerdings  sind  dann  etliche
  134.        Einstellungen aus  der  Konfig  nicht  mehr ausnutzbar.  (Die
  135.        "letztens"  erstellten   Dateien   werden   in   jedem   Fall
  136.        geloescht.)  Seit  der  Release  0.3  ist  ein  Feature  fuer
  137.        LORA-BBS und MAXIMUS/2 eingebaut.  Bei diesen Programmen kann
  138.        man man mittels ANS2BBS (ein  Maximus-Tool)  das  ausgegebene
  139.        .ANS-File  in  ein *.BBS-File wandeln.  Auf diese Art wird es
  140.        fuer jede Darstellungsart (ANS,  ASC,  AVT, TTY) tauglich und
  141.        man braucht nur eine Datei.
  142.  
  143.  
  144.  
  145.        2. Was benoetigt man fuer DATSCRN?
  146.  
  147.        Eigentlich nur RA und  einen  Editor,  um  die Files fuer die
  148.        Texte zu editieren  und  das  Konfigfile zu bearbeiten.  (Wer
  149.        will,  kann  das  .cfg-File  auch  ueber  die  Option  /SETUP
  150.        bearbeiten.  [Allerdings nicht  upgraden.])  Einen  wichtigen
  151.        Hinweis  muss  ich  allerdings  geben:  DATSCRN  ist  in  der
  152.        vorliegenden  Version  *nur*  ab  386ern  lauffaehig!!!   Ich
  153.        dachte  mir,  dass  heute  wohl kaum noch jemand eine BBS mit
  154.        286ern betreibt ;->>>  Wenn  ja,  dann ist eine 286er-Version
  155.        gern auf Anfrage erhaeltlich.
  156.  
  157.  
  158.  
  159.  
  160.        3. Wie man DATSCRN zum Laufen bekommt...
  161.  
  162.        An  sich ist bereits alles recht gut dokumentiert.  Zunaechst
  163.        muss  man  das  Konfigurationsfile  "DATSCRN.CFG" bearbeiten.
  164.        Dies  kann  mit  jedem  gewoehnlichen  ASCII-Editor   gemacht
  165.        werden, oder ueber die Option /SETUP.  Dafuer muss allerdings
  166.        das .cfg-File den Anforderungen der v0.40 entsprechen,  sonst
  167.        meckert   das   Programm.    Alle   einzelnen   Zeilen   sind
  168.        kommentiert,  so  dass  das  kein Problem darstellen duerfte.
  169.        Man  kann  sich  auch  an  den  jeweiligen Beispieleintraegen
  170.        orientieren...  ACHTUNG!  User, die aeltere DATSCRN-Versionen
  171.        als v0.34 upgraden, *muessen* die Konfig-Datei erweitern.  Da
  172.        die vielen Diffs inzwischen arg unuebersichtlich wurden, sind
  173.        nunmehr "nur"  noch  die  Upgrade-Files  ab  v0.33 enthalten.
  174.        Dieses bitte mittels ASCII-Editor in das bisherige  .cfg-File
  175.        ganz  ans Ende (jedoch *vor* der Schlussline ### Ende des...)
  176.        einkleben!  Wer eine aeltere Version  als die v0.33 hat, muss
  177.        leider das .cfg-File entweder von  Hand  ergaenzen  oder  neu
  178.        ausfuellen.  Das geht aber mittels datscrn /setup ganz fix.
  179.        Ab der Version 0.40 ist das .cfg-File neu aufgebaut, naemlich
  180.        keyword-orientiert.   Dadurch  ist   es   nun  moeglich,  die
  181.        einzelnen   Eintraege   "logisch"   zu   ordnen,   so    dass
  182.        Konfigurationsfehler  durch  falsche Abstimmung der einzelnen
  183.        Eintraege untereinander kaum  noch passieren duerften.  Damit
  184.        das Umstellen auf das neue Format nicht zu kompliziert  wird,
  185.        liegt ein kleines Programm (039to040.exe) bereit, welches ein
  186.        v0.39-Konfigfile  automatisch mit den erforderlichen Keywords
  187.        versieht.
  188.  
  189.        Danach sollte man sich einmal ansehen,  welche  ANS/ASC-Files
  190.        man  den  schon  erstellt  hat.   Bei mir waren das folgende:
  191.        01-01.A??   ,  05-01.A??,  10-03.A??   und  12-24.A??   Diese
  192.        Datein sind z.T.   recht  muehsam  erstellt,  also sollen sie
  193.        geschont werden und nicht womoeglich  vom  DATSCRN  geloescht
  194.        werden.   Kein  Problem: Man traegt die Dateivornamen einfach
  195.        in der Datei NOT2BDEL.!!!   ein.  (Siehe auch die beigefuegte
  196.        Beispieldatei.)  Wichtig  ist,  dass  die   einzelnen   Daten
  197.        *untereinander*  stehen.   (Wer  nicht RA nutzt, fuer den ist
  198.        die Datei NOT2BDEL.!!!  natuerlich ohne Sinn...)
  199.  
  200.        Jetzt  kann  man  herangehen,  die  Datei  "VORLAGEN.TXT"  zu
  201.        editieren.  Sie  enthaelt  den  Rohtext  fuer  die jeweiligen
  202.        Tage.    Dabei   habe   ich   den   Aufbau   an    den    von
  203.        Newsfilescompilern  angelehnt:  Zuerst das Datum, z.B.  06-01
  204.        fuer den 1. Juni.  Dann  den Text.  Bitte darauf achten, dass
  205.        es  nicht  mehr  als  10  (oder  12,  falls  der "Registriert
  206.        fuer..."-Hinweis unterdrueckt  wird)  Zeilen  pro  Tag  sind,
  207.        diese  Zeilen  sauber  mit  CR  abgeschlossen  sind und nicht
  208.        laenger als 70 bzw.  72 Zeichen sind.  [70 Zeichen dann, wenn
  209.        man  die  Option des 'Schattenwurfes' eingestellt hat.] Alles
  210.        ab  der  11.  bzw.    13.    Zeile  wird  ignoriert  und  ein
  211.        entsprechender Fehler ins Logfile geschrieben.  Enthaelt  der
  212.        Text  dagegen  zu  lange  Zeilen, wird eine Fehlermeldung ins
  213.        Logbuch geschrieben, abgebrochen und kein Screen compiliert.
  214.        Abschluss ist jeweils  der  String  /***/ Wichtig: Auch unter
  215.        dem letzten Text muss ein solcher String sein!   Die  Dateien
  216.        fuer  die  einzelnen  Tage  muessen  uebrigens nicht zeitlich
  217.        geordnet sein ;-> Und:  Man  findet  auch in der Datei selbst
  218.        nochmal einen kurzen Hilfetext :-)
  219.        Wer diese Datei partout  nicht  mag, kann auf sie verzichten.
  220.        Damit dann im Log nicht gemeckert wird,  bitte  Option  /NOVT
  221.        mit angeben.
  222.  
  223.        Nun kann man sich die  Datei HOLY_DAY.TXT vornehmen.  Sie ist
  224.        aehnlich aufgebaut wie die VORLAGEN.TXT.  Nur ist es hier so,
  225.        dass pro Tag hoechstens  3  Zeilen  mit  maximal  42  Zeichen
  226.        gestattet   sind.    Diese  Datei  dient  naemlich  fuer  die
  227.        Kalenderblaetter und  auf  einem  klassischen Abreisskalender
  228.        steht nunmal unter dem Datum auch nur das wichtigste drauf :)
  229.  
  230.        Nun wird man ja  wohl  nicht  fuer jeden Tag einen Extra-Text
  231.        machen wollen und  koennen.   Falls  man  den  entsprechenden
  232.        Schalter  im  Konfigfile  setzt,  kann  man  sich  dann Files
  233.        compilieren lassen, die einen Text haben, der zu (fast) jedem
  234.        Tag   passt.    Die   Vorlagen   findet   man  in  der  Datei
  235.        JEDERTAG.TXT.   Diese  Datei   ist   aehnlich  aufgebaut  wie
  236.        VORLAGEN.TXT, nur  dass  hier  natuerlich  die  Datumsangaben
  237.        fehlen ;-).  Auch hier ist ein kurzer Hilfetext im  Kopf  der
  238.        Datei  enthalten  :-)  Achja:  Leerzeilen sollten zumindest 1
  239.        Leerzeichen enthalten.  Getestet  ist  es auch mit Leerzeilen
  240.        ohne  jeglichen  Inhalt,  aber  man weiss ja nie...  Ich habe
  241.        jetzt eine Datei JEDERTAG.12Z  mit ins Archiv gepackt.  Diese
  242.        Datei enthaelt auch 12-zeilige "Jedertagstexte", die man nach
  243.        der "Registrierung" dann ja nutzen kann.  :-) Allerdings muss
  244.        man    sie    dann     in    VORLAGEN.TXT    umbenennen    ;)
  245.        Selbstverstaendlich gilt auch hier die  Einschraenkung,  dass
  246.        die Zeilen nur 70 bzw.   72  Zeichen lang sein duerfen.  Wird
  247.        ein Text mit einer zu langen Zeile angetroffen, sucht DATSCRN
  248.        nach einem anderen, fehlerfreien Text.  (Das geht  natuerlich
  249.        nur,  wenn nach einem "Jedertagstext" gesucht wird.  Passiert
  250.        das  bei  einem   Vorlagetext   genau   fuer  den  Tag,  wird
  251.        abgebrochen.)  Eine Fehlermeldung mit Angabe des fehlerhaften
  252.        Textes wird ins Logbuch geschrieben.  Wird ein Text gefunden,
  253.        der zu viele Zeilen enthaelt, passiert das selbe.
  254.        
  255.        Man   kann   uebrigens   DATSCRN   veranlassen,   die  beiden
  256.        Textdateien auf zu lange Zeilen bzw. auf Zeilen,  die  zuviel
  257.        sind  (also  mehr als 10 bzw.  12) zu pruefen.  Dazu ruft man
  258.        einfach DATSCRN /CHECK auf.  Eventuell vorhandene fehlerhafte
  259.        Zeilen werden gemeldet und mit einem \!/ bei zu langen Zeilen
  260.        und  einem  \Z/   bei   "ueberfluessigen"  Zeilen  am  Anfang
  261.        versehen, so dass man selbst bei langen Dateien diese  Zeilen
  262.        dann  zum  Zwecke  der Korrektur schnell mit der Suchfunktion
  263.        eines ASCII-Editors  finden  kann.   Wer  die Texte uebrigens
  264.        ganz schnell von Umlauten  befreien  moechte,  kann  bei  mir
  265.        CHA1*.ZIP requesten.  (Siehe auch KRUSISOF.PRG)
  266.  
  267.        Der staendige Gebrauch von DATSCRN koennte nun dazu  fuehren,
  268.        dass  man  nach  einem  Jahr doch an die 700kB (oder mehr als
  269.        1MB,  falls  man  die   10   Zeilen   a  72  Zeichen  jeweils
  270.        ausschoepft...) ansammelt.  Daher  kann  man  in  der  Konfig
  271.        einen  Schalter  setzen, um beim Aufruf des Tools die zuletzt
  272.        compilierten Files zu loeschen.  (Natuerlich wird aufgepasst,
  273.        dass keine geschuetzten Files zerwamst werden ;->>>) Die Info
  274.        ueber die zuletzt geschriebenen  Files verwahrt DATSCR in der
  275.        Datei OLDSTUFF.LST, die also bitte nicht  loeschen.   Dadurch
  276.        wird  verhindert,  dass  am naechsten Tage, wie es der Zufall
  277.        manchmal  will,   womoeglich   der   gleiche  "Jedertagstext"
  278.        ausgesucht wird.  Diese OLDSTUFF.LST hat noch einen  weiteren
  279.        Nebeneffekt: Falls man aus Gedankenlosigkeit das Door zweimal
  280.        am Tag aufruft, dann werden die Files fuer den Tag natuerlich
  281.        *nicht*  nochmal neu compiliert, wenn man den Schalter "Evtl.
  282.        vorhandene Dateien  fuer  den  heutigen  Tag  loeschen" auf N
  283.        gesetzt hat.  Hat man den Schalter auf J gesetzt, wird - ganz
  284.        klar - ueberschrieben.  Will man mal nur einen  kleinen  Test
  285.        machen  oder  einen fuer den Tag doch nicht ganz so passenden
  286.        "Jedertagstext" wegcompilieren  und  nicht  extra  dafuer den
  287.        Schalter in der cfg-Datei umstellen  (oder  die  oldstuff.lst
  288.        loeschen     ;),     dann     kann     man    dies    mittels
  289.        Kommandozeilenparameter /AGAIN  machen.   Falls  man nicht RA
  290.        nutzt,  dann  ist  dieser  Schalter   uebrigens   nicht   von
  291.        Bedeutung, die "letztens" erstellten Dateien werden *in jedem
  292.        Fall*  geloescht  ;->.  Wer uebrigens nach jedem Login in die
  293.        Box  einen  neuen  Screen  erstellen  will  (damit  User, die
  294.        mehrfach am Tag in die Box kommen, jedesmal einen neuen  Text
  295.        lesen koennen ;), der braucht also nur den o.g.  Schalter auf
  296.        J stellen (oder den Schalter, ob es eine RA-BBS ist, auf N zu
  297.        haben)  und  schon  ist es moeglich!  (Seit der Version v0.31
  298.        ist dies auch im Zufalls-Auswahlprozess sichergestellt.  ;)
  299.  
  300.        Uebrigens kann man sich auch noch  aussuchen,  ob  man  seine
  301.        User  mit  vollem  Namen  gruesst,  oder es bei einem "Vielen
  302.        Spass  wuenscht  Dir  Dein  SysOp Paul" bewenden laesst, oder
  303.        aber sogar einen  Alias  verwendet.   (Dann natuerlich sollte
  304.        der  Nachnamen-Schalter  auf  N  stehen,   wird   jedoch   eh
  305.        unterdrueckt  ;)  Man kann also auch "Viel Spass wuenscht Dir
  306.        ∩εδδí" schreiben lassen oder so...
  307.  
  308.        Seit v0.33 kann man seine  User  auch etwas nerven, indem man
  309.        eine Lese-Pause erzwingt.   Diese  dauert  aber  maximal  7s.
  310.        Allerdings  muss  man wissen, welche(s) Steuerzeichen die Box
  311.        fuer  eine  Pause   von   1s   verlangt.    Fuer  RA  ist  es
  312.        voreingestellt und fuer  SBBS  als  Bsp. mit angegeben.  Fuer
  313.        LORA ist es etwas komplizierter, da es zwei Varianten gibt:
  314.        ^F^G     =   1 sek. Pause
  315.        ^W       =   1/2 sek. Pause.
  316.  
  317.        Das Problem ist, dass beim Konvertieren in ein  BBS-File  ein
  318.        Multiplikator fuer Zeichenwiederholung verwendet wird.
  319.        Das sieht dann so aus: ANS = ^W^W^W^W
  320.        Uebersetzt sieht das so aus: ^Y^W^D
  321.        ^Y = wiederhole folgendes Zeichen
  322.        ^W = 1/2 sek. Pause
  323.        ^D = 4 mal.
  324.  
  325.        Daraus   ergibt   sich,   dass  man  als  Pausezeichen  einen
  326.        2-stelligen String einsetzen  muss.   Leerzeichen geht nicht,
  327.        aber  Alt-255   Ctrl-W   geht.    Dadurch   umgeht   man  den
  328.        Multiplikator (er  wird  ab  der  Wiederholung  von 3 Zeichen
  329.        aktiv).  Warum das alles?  Nun, macht man es so, verliert der
  330.        Parameter  I  nicht  seine  Wirkung.  (TNX an Gert Massheimer
  331.        hierfuer :-))
  332.  
  333.        Aus den o.g.  Gruenden  empfehle  ich Sysops, die ein solches
  334.        System fahren und auch ein  Kalenderblatt  erstellen  wollen,
  335.        das Kalenderblatt in eine eigene Datei schreiben zu lassen.
  336.  
  337.        Wer   registriert   hat,   kann   ab   v0.34    sowohl    den
  338.        Begruessungsstring  als auch den "Viel Spass wuenscht Dir..."
  339.        String nach eigenem  Geschmack verfassen.  Einziger Nachteil:
  340.        Der  Sysop-  bzw.   BBS-Name  wird  nicht  mehr  andersfarbig
  341.        dargestellt, war mir zuviel Arbeit.
  342.  
  343.        Ein  weiteres  Feature  ist  ab  v0.34  eingebaut.    Mittels
  344.        Schalter /LB kann man  erzwingen,  dass der ausgewaehlte Text
  345.        auf alle Faelle linksbuendig  ausgegeben  wird.   Dies  wurde
  346.        gewuenscht  z.B.  fuer  Texte mit Aufzaehlungen 1., 2...  Man
  347.        kann es  aber  auch  so  halten,  dass  man  lediglich in den
  348.        Texten, die  es  betrifft,  in  der  *ersten*  Zeile  an  der
  349.        *ersten*   Spalte  eine  Tilde  (~)  setzt.   (In  der  Datei
  350.        VORLAGEN.TXT ist  damit  gemeint,  dass  man  in der *ersten*
  351.        Zeile *unterhalb* des Datums in der ersten Spalte eine  Tilde
  352.        setzt.)   Beim  Kalenderblatt  ist  dies aus gutem Grund (der
  353.        Aehnlichkeit  zur  Vorlage   des  Abreisskalenders  ;)  nicht
  354.        moeglich.  Sobald eine Tilde an der richtigen Stelle entdeckt
  355.        wird, weiss  DATSCRN  Bescheid.   Einfach  mal  ausprobieren.
  356.        Ebenfalls nur fuer registrierte Nutzer!
  357.  
  358.        Das Programm legt ein Logfile an, welches DATSCRN.LOG heisst.
  359.        Falls man allerdings nicht  unbedingt  auf Logfiles steht, so
  360.        gibt es jetzt einen Schalter, um dies abzustellen.  Man kann
  361.        das Logfile in ein Verzeichnis seiner Wahl schreiben.  Falls
  362.        ein  Fehler  auftritt,   dann   steht   das  dort  zu  lesen.
  363.        Zusaetzlich  wird  natuerlich  vermerkt,  wann  das  Programm
  364.        jeweils gestartet wurde...  Dieses Logfile  kann  nach  einer
  365.        gewissen  Zeit  recht gross werden.  Dies kann man vermeiden,
  366.        indem  man  das  schoene  Freeware-Tool  SMALLLOG  verwendet,
  367.        welches hervorragend geeignet  ist,  solche Logfiles notfalls
  368.        auf eine gewuenschte Groesse zu "shrinken".  (Man kann es als
  369.        SMALLLOG.ZIP in meiner BBS saugen ;-> )
  370.  
  371.        Tja  -  und nun die entscheidende Frage - wie startet man das
  372.        Programm am besten?  Antwort: In RACONFIG fuer eine bestimmte
  373.        Uhrzeit - am besten  ist  wohl  0.01  Uhr  oder so geeignet -
  374.        einen Event definieren mit einem  bestimmten  Errorlevel  als
  375.        Exit.   In  der START.BAT (oder wie immer Eure Batch fuer die
  376.        BBS lautet) diesen Errorlevel aufgreifen (Achtung - den hohen
  377.        Errorlevel immer  zuerst  ;->)  und  das  Programm ausfuehren
  378.        lassen...  Natuerlich kann man das Programm auch um 06.00 Uhr
  379.        aufrufen - dann wird eben, falls man  RA  faehrt,  bis  dahin
  380.        kein  Datumsscreen gezeigt.  (Bei anderen BBSs wird weiterhin
  381.        der zuletzt erstellte Screen [z.B. WELCOME.A??] angezeigt ;))
  382.        
  383.        WICHTIGER HINWEIS: DATSCRN laeuft - in Abhaengigkeit von  der
  384.        Groesse  der beiden Dateien VORLAGEN.TXT und JEDERTAG.TXT nur
  385.        Bruchteile von  bzw.   wenige  Sekunden.   Danach  wuerde das
  386.        Batchfile,  so man keinen Mailer verwendet und einen eXternen
  387.        Event  laufen  laesst,  also   die  Kontrolle  wieder  an  RA
  388.        zurueckgeben.  Problem:  Es  ist  immer  noch  die  "gleiche"
  389.        Uhrzeit  -  da  i.B. auf Events nur minutengenau getimt wird.
  390.        Daher ruft RA  das  Tool  erneut  auf.   Ich  weiss im Moment
  391.        keinen anderen Weg, als  eine  Zeitschleife  einzubauen,  die
  392.        eine  entsprechende Verzoegerung bewirkt.  Dies kann man z.B.
  393.        mit dem Toolchen VERZOEG,  welches ich vor kurzem geschrieben
  394.        habe, machen.   (Kann  man  in  meiner  BBS  als  VERZOEG.ZIP
  395.        saugen.   (Oder  man legt sich 4DOS zu ;) Aber vielleicht hat
  396.        ja jemand noch  einen  anderen  brauchbaren Tip...  (Das also
  397.        nur, wenn man RA stand alone betreibt!)
  398.  
  399.  
  400.        Und hier noch eine Anleitung, wie man  DATSCRN  zusammen  mit
  401.        LORA-BBS betreibt, um alle eingebauten Features zu nutzen:
  402.  
  403.        Der   beste   Zeitpunkt  um  Datscreen  zu  starten  ist  der
  404.        Midnight-Event.   Darin  sollte   folgender  Batch  gestartet
  405.        werden:
  406.  
  407.        ===== Welcome2.Bat =====
  408. CD\                                      ; ins Root-Verz. wechseln
  409. CD Lora\Utility\Datscrn                  ; in Datscrn-Verz. wechseln
  410. Datscrn.Exe                              ; DatScrn starten
  411. D:\OS2-Tool\ANS2BBS.Exe Welcome2.ANS     ; das erstellte ANSI-File in ein
  412.                                          ; BBS-File wandeln
  413. Copy Welcome2.BBS D:\Lora\Misc\German    ; BBS-File ins deutsche Texte-Verz.
  414.                                          ; der Lora kopieren
  415. CD\                                      ; ins Root-Verz. wechseln
  416. CD Lora                                  ; ins Lora-Verz. wechseln
  417.        ========= Ende =========
  418.  
  419.        Achtung:
  420.        Alles nach den Semikola sind Kommentare und muessen samt  den
  421.        diesen vor  dem  Start  des  Batches  entfernt  werden.  Ggf.
  422.        sollten natuerlich auch  die  Pfade  angepasst  werden.   Der
  423.        Aufruf des  Welcome2.BBS  wird  vom  Welcome.BBS aus gemacht.
  424.        Einfach folgende Zeile an das Ende des Files haengen:
  425.  
  426.        LD:\Lora\Misc\German\Welcome2.BBS
  427.  
  428.        im Klartext:
  429.  
  430.        [Ctrl-W][L]D:\Lora\Misc\German\Welcome2.BBS
  431.  
  432.        (Fuer  diese  Anleitung  danke   ich   ganz   herzlich   Gert
  433.        Massheimer,  Sysop  der DELTA-OS BOX [2:2476/62]) Ich moechte
  434.        auch an dieser  Stelle  nochmals  betonen,  dass ich in einem
  435.        solchen Falle, so ich ein Kalenderblatt haben moechte, dieses
  436.        in eine extra Datei schreiben lassen wuerde  und  diese  dann
  437.        genauso wie oben beschrieben behandeln liesse.
  438.  
  439.  
  440.  
  441.        4. Was kostet DATSCRN und wie ist es um den Support bestellt?
  442.  
  443.        - Zunaechst muss ich sagen, dass ich DATSCRN so bereitstelle,
  444.          wie es ist.   Ich  gebe  keine  Garantie  auf das Programm,
  445.          ausser, dass es Platz auf der Festplatte belegt.   Auf  gut
  446.          Deutsch: Jegliche Haftung ist *ausgeschlossen*.  Es koennen
  447.          also  keinerlei  Ansprueche  an  den  Autor geltend gemacht
  448.          werden.   (Nur  mal  nebenbei:  Es  duerfte  auch  verdammt
  449.          schwerfallen, mit  diesem  Programm  irgendwelche  Schaeden
  450.          anzurichten ;->> )
  451.  
  452.        - Jetzt etwas sehr erfreuliches: DATSCRN ist Freeware.  D.h.,
  453.          es  darf  kostenlos jederzeit benutzt werden und das Archiv
  454.          DATSCRN.ZIP  darf   *unveraendert*   weitergegeben  werden.
  455.          Falls Ihr dieses  Programm  von  irgendjemandem  fuer  Geld
  456.          erworben  habt, dann verlangt es zurueck und gebt mir ruhig
  457.          auch Bescheid, damit ich mich ebenfalls beschweren kann.
  458.          Eines muss allerdings gesagt werden:  sollte jemand  dieses
  459.          Tool     benutzt,     um    rassistische,    faschistische,
  460.          frauenfeindliche, obszoene oder kriminelle Texte zu zeigen,
  461.          dann  erlischt  die  Erlaubnis  zur  Nutzung  dieses  Tools
  462.          augenblicklich und ich behalte mir ggf. eine Anzeige vor.
  463.  
  464.  
  465.        - Warum steht jetzt beim Versionsnamen  ein  Γ  dahinter  und
  466.          wann  kommt  die naechste Release?  - Antwort:  Das Problem
  467.          fuer mich ist, dass ich  eine ganze Menge Arbeit in DATSCRN
  468.          investiert habe, aber feststellen musste,  dass  sich  seit
  469.          ca.    1   Jahr   die   "Registrierungen"   (von  sonstigen
  470.          Rueckkopplungen ganz  zu  schweigen  ;-\)  sehr  in Grenzen
  471.          halten.  Ich nehme an, dass es zum einen daran liegt,  dass
  472.          Mailboxen  nicht  mehr ganz so im Trend liegen und zweitens
  473.          das  eben  ein  DOS-Programm   ist  (und  eine  Portiertung
  474.          meinerseits nach OS/2 nicht moeglich ist :-().  Daher  habe
  475.          ich beschlossen, DATSCRN zunaechst  nicht  mehr  grossartig
  476.          weiterzuentwickeln.    Boshafterweise   bleibe   ich  aber,
  477.          gemein,  gemein...,   bei   dem  Keysystem.   Aktualisierte
  478.          Versionen,   also   mit   aktualisierten   Textfiles,  bzw.
  479.          kleineren Fixes oder ggf.  auch Erweiterungen, wird es aber
  480.          weiterhin geben.
  481.  
  482.        - Frage: Da ist doch aber etwas mit einem Schluessel (Key) in
  483.          der DATSCRN.CFG zu lesen???   -  Antwort: Ja.  Wer moechte,
  484.          kann mir *entweder* einen kleinen Brief  mit  *frankierter*
  485.          Antwortpostkarte   und   vielleicht   auch  einer  schoenen
  486.          Ansichtskarte fuer meine Kinder  schicken und den folgenden
  487.          Daten:
  488.  
  489.            * Name der Deiner BBS - exakt, wie Du ihn in der
  490.              DATSCRN.CFG eingetragen hast.
  491.            * Dein Vorname und Nachname
  492.            * Bitte jeweils auch die exakte Klein/Grossschreibung 
  493.              beachten!
  494.            * und moeglichst noch einen Hinweis, wo Du das Programm
  495.              herbekommen hast.
  496.  
  497.          Sofort bekommst Du einen  Key  zugesandt,  der  die  letzte
  498.          Zeile  mit  der  Werbung fuer meine BBS beseitigt und statt
  499.          dessen  ein  "Registriert  fuer  YYYY  ZZZZZZZ"  erscheinen
  500.          laesst.   (Das  sieht  doch   unheimlich  gut  aus,  oder?)
  501.          Natuerlich steht anstellen XXXX usw dann dort  *Dein*  Name
  502.          ;->  Du  kannst  ab  dann alle Features der "registrierten"
  503.          Version nutzen :-)
  504.  
  505.          ACHTUNG!  Ab Version  v0.34  musste  das Keysytem geaendert
  506.          werden, weil irgendein  sich ganz toll vorkommender  kewler
  507.          scene  coder  einen  illegalen  Keymaker in Umlauf brachte.
  508.          (Er hatte  uebrigens  die  Frechheit,  sogar  noch  ein (c)
  509.          hineinzuschreiben!)    Damit   waere   mir   die    einzige
  510.          Moeglichkeit  genommen,  zu  erfahren, wer mein Tool nutzt.
  511.          Daher habe ich diesmal  doch  etwas  mehr Muehe in das neue
  512.          Keysystem  gesteckt,  so  dass  es  etwas  schwerer  fallen
  513.          duerfte, den Key zu knacken.  Machbar  ist  es  sicher,  so
  514.          dass ich ggf. einen neuen Key erstellen muesste.  Ich frage
  515.          mich  aber  ernsthaft, was jemand davon hat, einen Key fuer
  516.          *MAIL*ware zu knacken. Naja, was solls...
  517.  
  518.          WICHTIG!  Wer DATSCRN (noch  ;) "unregistriert" nutzt, darf
  519.          den  Eintrag  NICHTREGISTRIERT  *nicht*  aendern.   DATSCRN
  520.          meckert sonst und macht eine 5s-Pause mit Hinweis.  Das ist
  521.          vor allem fuer Leute gedacht, die beim Updaten evtl.  ihren
  522.          Keyeintrag   beschaedigen   und  so  gleich  einen  Hinweis
  523.          bekommen.
  524.  
  525.          Man kann  mir  das  Registrierungsformular  auch per E-Mail
  526.          zukommen  lassen,  also  an  carsten.kruse@beg.gera.thur.de
  527.          oder an  meine  FIDO-Adresse  (2:248/4002)  oder  eine  der
  528.          anderen,  oben  angegebenen  Netzadressen.   Ich werde mich
  529.          bemuehen, Dir den Key moeglichst umgehend zuzucrashen.  Man
  530.          kann neue Versionen von DATSCRN  uebrigens immer in der BeG
  531.          als DATSCRN.ZIP oder unter dem Magic DATSCREEN bekommen.
  532.          
  533.          Zudem  kann   man   auch   bei   weiteren   BBSs,  die  als
  534.          Registrierungssite   arbeiten,   via   E-Mail   einen   Key
  535.          anfordern. Naeheres steht in REGSITE.TXT!
  536.  
  537.        Wer  uebrigens  partout  etwas bezahlen moechte, der gebe das
  538.        Geld doch einfach UNICEF, Kto-Nr 300 000 auf allen Banken und
  539.        Sparkassen.
  540.  
  541.  
  542.        Ein Programm lebt immer  auch  davon,  dass  der  Autor  eine
  543.        gewisse Rueckkopplung erfaehrt.  Daher bin ich ueber Hinweise
  544.        (und natuerlich auch ueber Lobe ;->) erfreut.  Fehlerhinweise
  545.        bitte mit moeglichst genauer Beschreibung. 
  546.  
  547.        Ab   Version   0.37   ist   ein   Achiv  namens   DAT-OS2.LZH
  548.        eingebunden, welches eine OS/2-Variation der DATSCRN-Idee ist
  549.        und  von  Gert   Massheimer   entwickelt   und  als  Freeware
  550.        freigegeben wurde.  Der Funktionsumfang und die Strukturen in
  551.        den  .cfg/.txt-Files  ist  zu   95%ig   mit   DATSCRN   (DOS)
  552.        kompatibel,  so  dass  ein Umstieg sehr leicht moeglich sein
  553.        sollte.  Alles weitere steht in diesem Archiv.  DATSCRN2 wird
  554.        "lediglich" kostenlos als 3rd-Party-Produkt mit diesem Archiv
  555.        mitgeliefert.  RA-Sysops  sollten  beachten,  dass Gerts Tool
  556.        (momentan)   noch   nicht   das   "Datumsfeature"   von    RA
  557.        unterstuetzt,  da  nur  eine  ANS-Datei  mit waehlbarem Namen
  558.        ausgegeben wird.   Weiterhin  gilt  zu  beachten,  dass diese
  559.        OS/2-Version *nicht* seperat, sondern nur  in  diesem  Archiv
  560.        und unveraendert vertrieben werden darf.  Der jeweilige Sysop
  561.        vor Ort darf es sich allerdings selbstverstaendlich anpassen!
  562.        Die momentan beigefuegte Version ist an den Stand der Release
  563.        0.40 angeglichen.
  564.  
  565.  
  566.  
  567.        5. Etwas zum Programm und seinem Autor
  568.  
  569.        Mein Name ist Carsten Kruse, ich bin momentan 36 Jahre alt(?)
  570.        und  Sysop  der  "Bildungsecke  Gera  (BeG)", die seit Anfang
  571.        September 1994 am  Netz  ist.   Beruflich  verdiene ich meine
  572.        Broetchen    als    Lehrer    fuer    Physik,     Astronomie,
  573.        Informationstechnische  Grundbildung  und  Englisch.  Mit dem
  574.        Programmieren  beschaeftige  ich  mich  seit  1985,  als  ich
  575.        computermaessig  mit  einem  muehsam  zusammengesparten Atari
  576.        800XL begann.  (Daher auch meine Vorliebe fuer BASIC...)
  577.  
  578.        Und damit sind wir beim Programm: Ich  habe  es  komplett  in
  579.        PowerBASIC  3.20   geschrieben.    Compiliert   wurde  es  im
  580.        386er-Code mit Option  auf  FAST  (statt  auf  SMALL).  Dabei
  581.        wurden   saemtliche   nicht   notwendigen   Bibliotheken  vom
  582.        Compilieren  ausgeschlossen,   so   dass   die  Groesse  noch
  583.        annehmbar ist.  (Ist trotzdem recht aufgeblaeht, da viel Text
  584.        enthalten ist.  Erstellt habe ich die Release 0.1α  innerhalb
  585.        von  drei   Nachmittagen.    Die   Patches   hin   zu   einer
  586.        "endgueltigen"  Release  werden  sicher  etwas  mehr  Zeit in
  587.        Anspruch nehmen.   Allerdings  laeuft  DATSCRN  bereits jetzt
  588.        schon sehr zufriedenstellen und daher ist zunaechst  an  eine
  589.        Weiterentwicklung   nicht  mehr  gedacht.   Man  sollte  aber
  590.        dennoch ab und an in die BeG gucken und DATSCRN requesten, da
  591.        ich zumindest  immer  Archive  mit aktualisierten Textdateien
  592.        (holy_day.txt, vorlage.txt, jedertag.txt) bereitstellen will.
  593.  
  594.  
  595.              Carsten Kruse
  596.  
  597.        Gera, 23.08.97
  598.  
  599.        ---eof---
  600.