home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1177 / pswsowin.doc < prev    next >
Encoding:
Text File  |  1993-10-07  |  11.2 KB  |  281 lines
  1. ********** PSWSO 2.2 **********
  2.  
  3. Beschreibung und Bedienungsanleitung
  4.  -> des Windows-Menüprogramms für das Sortierprogramm PswSort
  5.  
  6. Copyright   c  1990-1993
  7. Profi-Software Theo Saleck
  8. Langhecker Weg 13
  9. D-65618 Selters-Münster
  10.  
  11. Das Programm PSWSO und diese Beschreibung sind
  12. urheberrechtlich geschützt. Ein Kopieren bzw. die
  13. Vervielfältigung der Beschreibung sind nicht erlaubt und
  14. können rechtliche Folgen nach sich ziehen.
  15.  
  16. Das durch die Registrierung erworbene Nutzungsrecht
  17. berechtigt nur zur Benutzung mit einem Computer bzw. bei
  18. Servern an einem Bildschirm. Ein Kopieren des Programms zum
  19. Zwecke der Sicherung ist erlaubt.
  20.  
  21.  
  22. 1. Was ist PswSo
  23.      PswSo ist ein komfortables Eingabe- und Änderungs-Interface
  24.      für die Steuerinformationen des Sortierprogramms PswSort.
  25.      
  26.      Mit PswSo können Sie bequem über die Nutzung der Windows-
  27.      Fenstertechnik
  28.      - Parameter eingeben und in Form von BAT-Dateien speichern
  29.        -> hierbei können alle Dateien über Auswahlfenster
  30.            ermittelt werden
  31.      - Parameter wieder einlesen und ändern
  32.      - Das Sortierprogramm PswSort ablaufen lassen.
  33.      Das Sortierprogramm kann natürlich mittels der erstellten
  34.      und gespeicherten BAT-Datei auch ohne Windows direkt in DOS
  35.      ablaufen.
  36.  
  37. 1.1 Unterschied zwischen Shareware-Prüfversion und Vollversion
  38.      Es besteht funktionell kein Unterschied. Bei der Shareware-
  39.      Prüfversion erscheint lediglich ein Hinweis im Grundfenster.     
  40.  
  41. 2. Installation und Verzeichnisse
  42.      Bei Installation des Programms ist folgendes zu beachten:
  43.  
  44. 2.1 DOS-PATH-Eintragung
  45.       Der Kommandointerpreter COMMAND.COM und das Runtime-System
  46.       VBRUN100.DLL müssen über den DOS-Pfad erreichbar sein.
  47.       Das gleiche gilt für das Sortierprogramm PswSort.
  48.  
  49. 2.2 Standardverzeichnisse von PswSo
  50.       PswSo Windows-Menü benutzt zur komfortableren Arbeit 
  51.       mehrere Verzeichniseinträge, die vom Benutzer vor dem
  52.       Start in der Aufruf-Befehlszeile (Windows Programmeigen-
  53.       schaften gem. 2.4) festgelegt und während des Laufes 
  54.       auch noch im Grundfenster, Rahmen "Standardverzeichnisse"
  55.       geändert werden können.
  56.       
  57.       Es sind dies die Verzeichnisse:
  58.       a) Programme    - für die Programmteile von PswSo 
  59.                       (derzeit die .DOC - Dateien) 
  60.       b) Prozeduren    - für die zu speichernden und zu lesenden
  61.                       BAT-Dateien 
  62.       c) Dateien    - für die Ein- und Ausgabedateien der 
  63.                       Sortierung.
  64.  
  65. 2.3 Einrichten des Programms im Windows Programm-Manager
  66.  
  67.       a) Anlegen bzw. Ändern des Objektes
  68.            Das Programmobjekt wird im Programm-Manager
  69.            - mit dem Menü-Punkt Datei/Neu angelegt
  70.               Im Fenster "Neues Programmobjekt" wird
  71.               "Programm" angeklickt.
  72.            - mit dem Menü-Punkt Datei/Eigenschaften geändert
  73.            
  74.       b) Eintrag der programmspezifischen Parameter
  75.            Nach den Aktionen gem. a) erscheint in Windows
  76.            das Fenster "Programmeigenschaften"
  77.            Hier sind die folgenden Eintragungen zu machen:
  78.            - Beschreibung     : Eintrag nach Ihrer Wahl
  79.                 z.B. "PswSort Menü"
  80.            - Befehlszeile        : Aufruf des Programms PswSo
  81.                    mit Zusatzparametern
  82.                    => gem. 2.4
  83.            - Arbeitsverzeichnis    : Grundverzeichnis, das vor dem
  84.                            Laden durch Windows
  85.                            eingestellt wird.
  86.            - Tastenkombination    : keine
  87.               
  88. 2.4 Eintragungen in die Befehlszeile
  89.       Wie bereits in 2.2 aufgeführt, enthält die Befehlszeile die
  90.       Angaben für die Standardverzeichnisse.
  91.       Die Syntax des Eintrages "Befehlszeile" ist folgendermaßen:
  92.       
  93.       programm [programmverzeichnis],[prozedurverzeichnis],[dateiverzeichnis]
  94.         
  95.       Beachten Sie hierbei, daß die Befehlszeile im Windows-Fenster
  96.       länger ist als der Ausschnitt, den Sie sehen können. Sie schreiben
  97.       einfach weiter.
  98.       
  99.       
  100.         Beispiel:
  101.           C:\SORT\PSWSO.EXE C:\SORT,C:\BATDIR,C:\DATEN
  102.           
  103.      
  104.       Fehlen die oder einzelne Angaben zu den Verzeichnissen oder ist
  105.       die Angabe falsch, wird das Windows-Arbeitsverzeichnis genommen.
  106.       
  107.           
  108. 3. Arbeiten mit PswSo  
  109.      Das Programm kann bei Kenntnis der grundlegenden Begriffe von
  110.      PswSort als selbsterklärend angesehen werden.
  111.      
  112.      Nachfolgend sollen aber dennoch einige Ausführungen über die
  113.      wichtigsten Funktionen gemacht werden.
  114.  
  115.  
  116. 3.1 Aufbau der Fenster und Farbgebung innerhalb der Fenster
  117.       Das Menüsystem besteht aus:
  118.       - dem Grundfenster
  119.       - einem Sortierfeld-Eingabefenster
  120.           Das Ergebnis wird im Grundfenster in der Liste
  121.           "Sortierfelder" mitgeführt.
  122.       - einem Datei-Auswahlfenster für die Auswahl der benötigten
  123.           Dateinamen
  124.       - einem Verzeichnis-Auswahlfenster für die Zuordnung von
  125.           Standardverzeichnissen
  126.       - verschiedenen Abfrage- und Hinweisfenstern
  127.       - Textfenstern für die Protokolle und Beschreibungen gem.
  128.           3.2 und 3.3
  129.           
  130.       Die verschiedenen Dateien werden ausgewählt, indem die Buttons
  131.       neben den Bezeichnungen betätigt und die Auswahlfenster aktiviert
  132.       werden.
  133.       
  134.       Merkmale werden über Pull-Down-Listen ausgewählt.
  135.       
  136.       Numerische Einträge werden direkt in die Felder geschrieben.
  137.       
  138.       Die Sortierfeld-Eingabe und Änderung wird über die Funktions-
  139.       Buttons bei "Sortierfelder bearbeiten" aktiviert. Zu ändernde
  140.       Sortierfelder sind vorher in der Liste anzuklicken.
  141.       
  142.       Das Löschen von Sortierfeldern wird durch Anklicken des Feldes
  143.       und Betätigen des Buttons Löschen bei "Sortierfelder bearbeiten"
  144.       durchgeführt.
  145.       
  146.       
  147.       Farbgebung:
  148.       -----------
  149.       Jede Farbe eines Feldes hat ihre bestimmte Bedeutung:
  150.       
  151.       - Gelb    : Das Feld ist standardmäßig belegt und noch nicht
  152.                  vom Anwender geändert.
  153.                  
  154.       - Grün    : Das Feld wurde vom Anwender geändert und hat einen
  155.                  gültigen Inhalt.
  156.       
  157.       - Rot    : Das Feld ist entweder ungültig oder noch nicht
  158.                  ausgefüllt (kann auch keine Standardwert annehmen).
  159.                  Ein Ablauf mit einem vorhandenen roten Feld ist 
  160.                  nicht möglich !!!
  161.       
  162.       - Weiß    : Das Feld ist nicht ansprechbar, da es wegen anderer
  163.                  Angaben nur diesen bestimmten Wert annehmen kann.
  164.       
  165.       
  166.       
  167.      
  168. 3.2 Die Punkte des Menüs
  169.       Die Punkte des Menüs werden in der Reihenfolge und Staffelung
  170.       des Auftretens beschrieben:
  171.       
  172.       - Datei
  173.           . Parameter einlesen
  174.               Bereits vorhandene manuell oder mit dem Menü-System
  175.               erstellte .BAT -Dateien von PswSort können eingelesen
  176.               und geändert werden.
  177.           
  178.           . Einleseprotokoll anzeigen
  179.               Beim Einlesen der Parameter wird ein Protokoll geführt,
  180.               in dem die erkannten Parameter sowie eventuell erkannte
  181.               Fehler enthalten sind.
  182.               Dieses Protokoll wird in einem nicht-modalen Textfenster
  183.               angezeigt.
  184.               Achtung: Die Angaben liegen auf keiner Datei vor und
  185.               sind nach Programmende oder nach einem erneuten Einlesen
  186.               von Parametern nicht mehr verfügbar !
  187.           
  188.           . Parameter speichern
  189.               Die eingegebenen Parameter werden gespeichert.
  190.               Es wird der Name des Einlesens verwendet. Wurde ohne
  191.               Einlesen vorhandener Parameter eingegeben, wird die
  192.               Funktion "Parameter speichern als..." durchgeführt.
  193.           
  194.           . Parameter speichern als...
  195.               Neue Parameter werden unter einem Namen, eingelesene
  196.               Parameter unter einem veränderten Namen abgespeichert.
  197.       
  198.       
  199.       - Sortierungs-Start
  200.           . Das Sortierprogramm PswSort wird in einem DOS-Fenster
  201.               nach vollständiger Eingabe der Programmparameter 
  202.               ausgeführt. Es darf kein rotes Feld mehr in der 
  203.               Grundmaske sein.
  204.               Der Lauf wird nochmals über ein Abfragefenster
  205.               bestätigt.
  206.               Vor Aufruf des DOS werden die Parameter als .BAT-
  207.               Datei mit dem vorgegebenen Namen gespeichert.
  208.               Ist noch keine Name verfügbar wird wie bei 
  209.               "Parameter speichern als..." abgefragt.
  210.               -> Nach Ende der Sortierung im DOS-Fenster bleibt
  211.                    dieses am Bildschirm stehen und verlangt
  212.                    einen Tastendruck. Diese Pause ist eingefügt,
  213.                    um Ihnen die Kontrollmöglichkeit über den
  214.                    DOS-Ablauf zu geben.
  215.                    Nach dem Tastendruck wird automatisch wieder
  216.                    in das Menüsystem zurückgekehrt und das 
  217.                    vollständige Ablaufprotokoll kann über den
  218.                    Menüpunkt "Ablaufprotokoll" angezeigt werden.
  219.          
  220.       
  221.       - Ablaufprotokoll
  222.           . Anzeige des nach einem Sortierlauf von PswSort
  223.               erstellten Ablaufprotokolls (Beschreibung in Hilfe).
  224.               Nur, wenn die Protokollausgabe auf Datei erfolgte.
  225.               Fenster: nicht-modal
  226.       
  227.       - Hilfe
  228.           . Beschreibung PswSort-Menü
  229.               Informationen zum Windows-Menüsystem (diese Datei)
  230.               Fenster: nicht-modal
  231.           
  232.           . Beschreibung PswSort Allgemeines
  233.               Informationen grundsätzlicher Art
  234.               Fenster: nicht-modal
  235.           
  236.           . Beschreibung PswSort Parameter+Steuerung
  237.               Programmparameter und Programmsteuerung
  238.               Fenster: nicht-modal
  239.           
  240.           . Beschreibung PswSort Fehler+Protokoll
  241.               Fehlermeldungen und Beschreibung Ablaufprotokoll
  242.               Fenster: nicht-modal
  243.           
  244.           . Info
  245.               Programm und Ersteller-Information zum Menü-System
  246.               Fenster: modal
  247.           
  248.       
  249.       - Ende
  250.           Der Menüpunkt "Ende" beendet das Programm.
  251.           Die Funktion wurde absichtlich nicht in "Datei" gelegt,
  252.           um einen Bedienungsschritt einzusparen.        
  253.  
  254.  
  255. 3.3 Fensterformen
  256.       Das Programm verwendet zusätzlich zum Grundfenster 2 grund-
  257.       sätzliche Fensterformen:
  258.       
  259.       a) Modales Fenster: 
  260.            Das Fenster kann bewegt werden, muß aber
  261.            zur Weiterarbeit mit einer Eingabe bedient werden.
  262.            Unter diese Fensterart fallen alle Hinweis und Abfrage-
  263.            sowie die Dateiauswahl- und das Sortierfeld-Eingabefenster.
  264.          
  265.       b) Nicht-modales Fenster: 
  266.            Unter diese Form fallen alle Dokumentations-Fenster.
  267.            Die Fenster bleiben bei Weiterarbeit verfügbar, bis sie
  268.            mit dem Knopf OK oder der Taste ESC geschlossen werden.
  269.            Sie sind verschiebbar und in ihrer Größe änderbar.
  270.            Der Text kann über Scroll-Leisten zum Lesen verschoben
  271.            werden. Auch ist eine Anzeige über den gesamten Bildschirm
  272.            mit den gewohnten Windows-Rahmenknöpfen möglich.
  273.            
  274.            Zu den nicht-modalen Fenstern gehören
  275.            - die 4 Beschreibungs-Fenster aus Hilfe
  276.            - das Inhaltsverzeichnis-Fenster zu den 3 Beschreibungen
  277.                  für PswSort
  278.            - das Ablaufprotokoll
  279.            - das Einleseprotokoll
  280.           
  281.