Installationshandbuch AS-SPOOL-ARCHIV Version 2.0

Transkript

1 AS-SPOOL-ARCHIV Version 2.0

2 Inhaltsverzeichnis 1. Allgemeines Voraussetzung Datenträger Was wird installiert? Erstinstallation Installationsvorgang Erste Schritte Starten Erstellen eines Archives Arbeiten mit Archiveinträgen Beenden Handbuch Hotline Eingabe von Freigabecodes AS Software GmbH Seite: 2

3 1999 AS SOFTWARE GmbH Alle Rechte vorbehalten. Es ist untersagt, Kopien der Software und/oder Dokumentation (ausgenommen zu Sicherungszwecken) für den gewerbsmäßigen Vertrieb zu erstellen. Die kostenlose Weitergabe, der Software und/oder Dokumentation an Dritte ist erlaubt. Das Tool funktioniert auf dem nicht autorisierten System in der Regel 30 Tage und geht dann in den Schutzmodus über. Nach Ablauf der 30-Tage-Frist kann bei uns ein Freigabecode telefonisch oder per Telefax angefordert werden. Es gilt der jeweils aktuelle Tool-Preis. IBM, IBM AS/400 sind eingetragene Warenzeichen der International Business Machines Corp., USA 1999 AS Software GmbH Seite: 3

4 1. Allgemeines 1.1. Voraussetzung Betriebssystem V3R2M0 oder Höher 1.2. Datenträger Sollte es sich bei dem Datenträger um eine CD handeln, können Sie diese sowohl auf der AS/400 als auch auf einem PC einlegen. Fall Sie das Produkt über einen angeschlossenen PC installieren wollen, finden Sie im Verzeichnis ASSOFT das Dokument PCINST.HTM. Falls die Autorun Funktion Ihres PC s eingeschaltet ist, wird dieses Dokument automatisch beim Einlegen der CD angezeigt. Folgen Sie bitte den Installationsanweisungen die in diesem Dokument beschrieben sind AS Software GmbH Seite: 4

5 2. Was wird installiert? Bibliothek ASARCV020 Außer den Programmen und der Datenbank werden hier noch die Subsystem- und Jobbeschreibungen sowie einige Datenbereiche installiert. Benutzerprofil Es wird das Benutzerprofil SPLARC angelegt. Unter Diesem Benutzerprofil werden die Spool-Daten Archiviert. Dieses Benutzerprofil wird nur vom Spool- Archiv selbst benötigt. Ein Anmelden mit diesem Profil ist nicht erforderlich. Folgende Befehle werden aus der Bibliothek ASARCV020 in die QGPL gestellt, sodaß sofort mit AS-SPOOL-ARCHIV gearbeitet werden kann, ohne die Bibliotheksliste zu verändern. Alle diese Befehle verweisen dann auf die Bibliothek ASARCV020. Es sind keinerlei weitere Programmübertragungen notwendig. Achten Sie bitte darauf, dass diese Befehle evtl. gleichnamige vorhandene Befehle in der Bibliothek QGPL überschreiben. CFGSPLARC CHGARCD CHGARCSPL CHGSPLARC CLRSPLARC CNTSPLARC CPYARCD CRTSPLARC DLTSPLARC DSPARCSPL DSPSPLARC ENDSPLARC FILARCSPL FILSPLARC HLDSPLARC PRTARCSPL PRTSPLARC RLSSPLARC RMVARCSPL RNMSPLARC RSTSPLARC RTVARCINT RTVARCNAM RTVSPLINT SAVSPLARC SCNARCSPL SNDARCSPL SPLARCCTL STRSPLARC USRARCSPL WRKARCSPL WRKSPLARC *CMD Konfiguration *CMD Archivbeschreibung ändern *CMD Spoolarchiv ändern *CMD Archiv ändern *CMD Archivinhalt löschen *CMD Verbundenes Archiv erstellen *CMD Archivbeschreibung kopieren *CMD Archiv erstellen *CMD Archiv löschen *CMD Archiveintrag anzeigen *CMD Archiv anzeigen *CMD Archivierung beenden *CMD Kopieren SPOOL-Archiv in Datei *CMD Kopieren SPOOL-Archiv-Eintrag in Datei *CMD Anhalten SPOOL-Archiv *CMD Archiveintrag drucken *CMD Drucken SPOOL-Archiv *CMD SPOOL-Archiv freigeben *CMD Archiveintrag löschen *CMD Archiv umbenennen *CMD Archiv zurückspeichern *CMD Archivnummer auffinden *CMD Archivnamen auffinden *CMD internte Archivnummer finden *CMD Archiv sichern *CMD Spool-Archiv-Eintrag durchsuchen *CMD Archiveintrag faxen *CMD Controljob *CMD Archivunterstüzung starten *CMD benutzerdefinierter Befehl *CMD mit Archiveinträgen arbeiten *CMD Mit SPOOL-Archiv arbeiten 1999 AS Software GmbH Seite: 5

6 3. Erstinstallation 3.1. Installationsvorgang Zur Installation der Software bitte folgende Schritte durchführen: Mit QSECOFR oder einem anderen Benutzerprofil mit gleicher Berechtigung anmelden. Den Datenträger in die passende Einheit einlegen. Um das Produkt zu laden, folgenden Befehl eingeben: LODRUN XXXXXXXXXX (XXXXXXXXXX steht für den Einheitennamen z. B. TAP01 od. OPT01) Nach einiger Zeit wird der Installationsbildschirm mit allen, auf dem Datenträger ausgelieferten Produkten, angezeigt. Wählen Sie das gewünschte Produkt mit Auswahl 1 aus Erste Schritte Hier in diesem Kapitel wird nur grob die Arbeitsweise von AS-SPOOL-ARCHIV erläutert. Mit diesem Leitfaden sollte es Ihnen möglich sein, ein Archiv zu erstellen und zu handhaben. Für detailiertere Informationen schlagen Sie bitte im Benutzerhandbuch nach. Dieses ist im Lieferumfang nur in Form eines Worddokumentes enthalten. Lesen Sie dazu das Kapitel Handbuch Starten Um Spool-Dateiein zu überwachen und zu archivieren, muss zunächst die Archivierung gestartet werden. Geben Sie dazu folgenden Befehl ein: STRSPLARC Mit diesem Befehl wird das Subsystem QARCV020 gestartet. Darin laufen zwei Jobs (SPLARC, SPLARC1) im Status DEQW (=Belastet nicht das System). Diese Jobs überwachen die konfigurierten Outq s und archivieren die Spool- Dateien, für die ein Archiv definiert wurde AS Software GmbH Seite: 6

7 Erstellen eines Archives Um ein Archiv erstellen zu können, muss zunächst in die Archivverwaltung eingestiegen werden. Geben Sie dazu den Befehl WRKSPLARC ein. Sie erhalten nun eine Bildschirmanzeige mit einer Übersicht aller definierten Archive. Um ein neues Archiv zu erstellen, geben Sie in der ersten Zeile bitte die Auswahl 1 und den Namen eines Archives an. Drücken Sie die Datenfreigabetaste. Danach wird der Befehl CRTSPLARC geprompted und Sie können die Auswahlparameter für dieses Archiv eingeben. Hinweis: Einen Teil der zu definierenden Parameter erkennen Sie, indem Sie sich anhand der SPOOL-Datei mit Auswahl 8 mit Spool-Dateien arbeiten die Attribute der Spooldatei anzeigen lassen. Dies kann Ihnen u.u. helfen, die zu archivierenden SPOOL-Dateien genauer zu definieren AS Software GmbH Seite: 7

8 SPOOL-Ausgabewarteschlange Dieses Feld ist in Verbindung mit dem Feld Bibliothek ein Pflichtfeld und muß den Namen der Ausgabewarteschlange und deren Bibliothek beinhalten, aus der SPOOL-Dateien archiviert werden sollen. Unter Verwendung eines Plus-Zeichens, kann eine Liste der zu verwendenden Ausgabewarteschlangen eingegeben werden, d.h. es werden aus allen diesen Ausgabewarteschlangen Archivierungen durchgeführt. Mit der Auswahl *ALL ermittelt das System selbstständig alle Ausgabewarteschlangen und erstellt damit eine Liste der Ausgabewarteschlangen. Anmerkung: Wenn Sie mit *ALL arbeiten erhöhen Sie damit den Arbeitsaufwand Ihres SPOOL-Archives. Wenn Sie also Ihre Ausgabewarteschlangen nicht kennen, sollten Sie mit Befehlstaste 4 arbeiten. Sie können auch, nachdem Sie Ihr SPOOL-Archiv mit *ALL bei SPOOL- Ausgabewarteschlange erstellt haben, es mit der Auswahl 2 ändern und alle nicht notwendigen Ausgabewarteschlangen mit einem < (+ Bibliothek löschen nicht vergessen) entfernen. Damit reduziert sich die Zahl der Prüfungen, und Sie entlasten damit wieder Ihr SPOOL-Archiv-Prüfprogramm. Es können maximal 192 Ausgabewarteschlange selektiert werden. In diesem Feld können darüberhinaus mit der Befehlstaste 4 alle im System befindlichen Ausgabewarteschlangen angezeigt werden. SPOOL-Datei 1999 AS Software GmbH Seite: 8

9 Hier muß der Name jener zu archivierenden SPOOL-Datei angegeben werden. Unter Verwendung eines Plus-Zeichens, kann eine Liste der zu verwendenden Spooldateien eingegeben werden, d.h. es werden aus allen diesen Spooldateien Archivierungen durchgeführt. Es wird erst geprüft, ob die Spooldatei zu archivieren wäre, und anschließend wird nach Archivierungsvarianten gesucht. Mit Auswahl *ALL erfolgt keine Einschränkung der SPOOL-Datei. Einheitendatei Hier kann der Name einer bestimmte Einheitendatei in Verbindung mit einer Bibliothek angegeben werden. Bei der Archivierung werden dann nur jene SPOOL-Einträge herangezogen, deren Einheitendatei entspricht. Mit dem Defaultwert *ALL erfolgt hier keinerlei Einschränkung. Formularart Hier kann eine bestimmte Formularart angegeben werden. Bei der Archivierung werden dann nur jene SPOOL-Dateien archiviert, die mit der angegebenen Formularart erstellt worden sind. Mit dem Defaultparameter *ALL erfolgt hier keinerlei Einschränkung. Mit dem Parameter *STD selektieren Sie nur jene Listen deren Formularart *STD enthält. Benutzerdaten Gibt an, welche Benutzerdatenmarkierung für die Archivierung ausgewählt werden sollen. Mit dem Defaultparameter *ALL erfolgt hier keinerlei Einschränkung. Text Beschreibung Es kann ein Text angegeben werden, der beim Arbeiten mit SPOOL- Archiven angezeigt wird AS Software GmbH Seite: 9

10 Wenn Sie in dieser Anzeige alle Parameter ausgefüllt haben und vorwärtsblättern kommen folgende Parameter: Wann archivieren Gibt an, dass SPOOL-Dateien abhängig davon archiviert werden, ob bestimmte Zeilen in der Datei Daten enthalten, die die angegebene Beziehung erfüllen. Diese Prüfung wird am Anfang der Datei sowie bei jedem Gruppenwechsel ausgeführt werden. Mit *ALWAYS erfolgt hier keinerlei zusätzliche Prüfung. Mit den Auswahlen *IF, *AND und *OR können über die Folgeparameter Zeile, Anfangsposition, Vergleichwert und Länge Ausschlüsse getroffen werden. Um Mehrfachverknüpfungen treffen zu können, müssen Sie sich mit einem Plus- Zeichen die Parameterliste öffnen. Es können maximal drei Selektionen durchgeführt werden. Bei der Zeilennummer kann entweder eine Zeilennummer oder *PAGE definiert werden. Die Zeilennummer verweist auf eine direkte Zeilennummer; - *PAGE auf irgendwo auf der Seite. Die Anfangsposition kann mit einer Zahl direkt definiert werden, oder mit *SCAN variabel gehalten werden. Der Vergleichswert gibt den zu suchenden String an. Dieser sollte, - um unliebsame Überraschungen zu vermeiden -, unter einem Hochkomma ( ) angegeben werden. Die Länge definiert den Suchstring und kann mit einer Zahl von angegeben werden. Mit *CALC wird die exakte Länge des Suchstrings durch das Programm ermittelt AS Software GmbH Seite: 10

11 Beispiel: In einer SPOOL-Datei befinden sich nacheinander Lieferschein, Kopien der Lieferscheine, Rechnungen sowie Kopien der Rechnungen. Bei Lieferscheinen steht in der Zeile 2 auf der Stelle 3 LIEFERSCHEIN. In der Zeile 3 auf der Stelle 3 steht Seite 1. Bei den Kopien steht zusätzlich auf Zeile 3 Stelle 11 Kopie. Um nur die Originale der Lieferscheine zu archivieren muß im Parameter GROUP der Gruppenwechsel mit der Konstanten 'Seite 1' auf der Zeile 3 Stelle 3 definiert werden. Der Parameter (SELECT) muß wie folgt aussehen: Gruppenwechsel Gibt an, ob und ggf. wann ein Gruppenwechsel stattfindet. Durch Gruppenwechsel wird die Spool-Datei in einzelne Abschnitte untergliedert, sobald der Wert an der angegebenen Position in der angegebenen Zeile erscheint. Bei einem Gruppenwechsel wird die Prüfung des Parameters SELECT ausgeführt, um zu entscheiden ob die Seiten bis zum nächsten Gruppenwechsel archiviert werden (siehe Beispiel bei Paramter SELECT). Zur Angabe der Bedingungen, aufgrund derer in der Datei ein Gruppenwechsel stattfindet soll, wird eine Wertegruppe für jede Bedingung angegeben. Jede Gruppe muß genau vier Werte enthalten: 1999 AS Software GmbH Seite: 11

12 Bei der Zeilennummer kann entweder eine Zeilennummer oder *PAGE definiert werden. Die Zeilennummer verweist auf eine direkte Zeilennummer. *PAGE gibt irgendwo auf der Seite an. Die Anfangsposition kann mit einer Zahl direkt definiert werden, oder mit *SCAN variabel gehalten werden. Der Vergleichswert gibt den zu suchenden String an. Er sollte, - um unliebsame Überraschungen zu vermeiden -, unter einem Hochkomma ( ) angegeben werden. Die Länge definiert den Suchstring und kann mit einer Zahl von angegeben werden. Mit *CALC wird die exakte Länge des Suchstrings durch das Programm ermittelt. Es besteht auch die Möglichkeit, gezielt einen Gruppenwechsel zu definieren, wenn sich an einer bestimmten Stelle ein Feldinhalt verändert (z.b. Rechnungsnummer auf Seite 1 und auf Seite 2). Dazu dürfen die Parameterwerte *PAGE, *SCAN und *CALC nicht verwendet werden, sondern es muß gezielt beziffert werden. Als Vergleichswerte setzten Sie den Parameter *CHANGE ein. Z.B.: Die Rechnungsnummer wird in der Länge 7 auf Zeile 12, Position 112 auf die Seite gedruckt. Die Gruppenwechseldefinition muß dann folgendermaßen aussehen. Für diesen Parameter können mehrere Werte eingegeben werden. Werden auf einer Eingabeanzeige zusätzliche Eingabefelder für die Eingabe von Werten benötigt, ein Pluszeichen (+) in das Feld neben dem Satz "+ für weitere" eingeben und die Eingabetaste drücken AS Software GmbH Seite: 12

13 Es können maximal 3 Abfragen als Gruppenwechselstufe angegeben werden. Diese sind als ODER -Verknüpfungen zu sehen. Anmerkung: Es können nur SPOOL-Dateien mit dem Druckertyp *SCS und *IPDS archiviert werden. Die Parameter Wann archivieren und Gruppenwechsel können nur für SPOOL-Dateien verwendet werden, die mit dem Druckertyp *SCS (s. SPOOL-Attribute 2. Seite) erstellt wurden. Wenn Sie jedoch SPOOL-Dateien mit dem Druckertyp *IPDS archivieren wollen, so müssen Sie mit *ALWAYS und ohne Gruppenwechsel die SPOOL-Datei archivieren. Es ist dann auch keine Archivanzeige mehr möglich. Das SPOOL- Archiv kann lediglich erneut ausgedruckt werden. Da auch kein Gruppenwechsel definiert werden kann, wird die gesamte SPOOL-Datei als ein Archiveintrag abgespeichert. Durch erneutes vorwärtsblättern gelangen Sie zu folgenden Parametern. Suchbegriff Es können bis zu 10 Suchbegriffe definiert werden. Diese geben an, welche Daten aus einer Spool-Datei zum Suchen verwendet werden. Für diesen Parameter können mehrere Werte eingegeben werden. Werden auf einer Eingabeanzeige zusätzliche Eingabefelder für die Eingabe von Werten benötigt, ein Pluszeichen (+) in das Feld neben dem Satz "+ für weitere" eingeben und die Eingabetaste drücken. Zur Angabe welche Daten aus einer Spool-Datei zum Suchen verwendet werden sollen, wird eine Wertegruppe für jeden Suchbegriff angegeben. Die 1999 AS Software GmbH Seite: 13

14 Definition des Suchbegriffes kann auf zwei verschiedene Varianten eingegeben werden. Zunächst muß der Suchbegriff als Name definiert werden. Um zu einem späteren Zeitpunkt SPOOL-Archive verbinden zu können, sollten Sie sich bei der Namenskonvention eine Richtlinie zurechtlegen. Schlagen Sie dazu auch im Kapitel Verbundene SPOOL-Archive nach. Doppelte Archivierung zulässig Dieser Parameter definiert, ob eine Mehrfacharchivierung zulässig ist. Erlaubte Parameter sind *YES und *NO. Bei Eingabe von *NO wird geprüft, ob die Kombination Jobname/SPOOL-Datei/Nummer bereits archiviert ist. Bei *YES wird diese Prüfung nicht durchgeführt. Nachdem alle erforderlichen Parameter gefüllt sind, kann das SPOOL-Archiv mit Daten-Freigabetaste erstellt werden. Es wird dabei in der Statuszeile angezeigt, was der Befehl momentan ausführt. Wenn das Spoolarchiv erstellt ist, beginnt mit der Erstellung des nächsten zutreffenden Spooleintrages die Archivierung. Wenn Sie einen bereits bestehenden SPOOL-Eintrag archivieren wollen, um zu testen, ob Ihr SPOOL-Archiv richtig definiert ist, so müssen Sie den SPOOL-Eintrag in der Ausgabewarteschlange anhalten und wieder freigeben. Im Subsystem ASARCV020 wird nun ein Job aktiv, der die Archivierung prüft und durchführt Arbeiten mit Archiveinträgen Nachdem die Archive eingerichtet wurden und die Archivierung läuft, kann nun mit dem Befehl WRKSPLARC die Liste der Archive angezeigt werden AS Software GmbH Seite: 14

15 Hier kann mit den oben angeführten Auswahlen und den unten angeführten Funktionstasten das Archiv bedient werden. Es kann bspw. mit der Auswahl 12 in ein Archiv verzweigt werden bzw. mit Funktionstaste 11 die Archivbeschreibung ausgeschaltet und in eine mehrspaltige Anzeige geschaltet werden. Mit der Auswahl 12 kann in ein bestehendes Archiv verzweigt werden. es wird zunächst ein Schirm angezeigt, mit dem auf einem bestimmten Archiveintrag positioniert werden kann AS Software GmbH Seite: 15

16 Durch die Eintragung dieses Suchbegriffschlüssels erfolgt die nächste Anzeige automatisch sortiert nach Kundennummer. Es wird bei diesem Suchbegriff aufgesetzt. In dieser Anzeige kann nun mit den oben angeführten Auswahlen bzw. den unten angeführten Funktionstasten in diesem Archiv gearbeitet werden. Es kann also ein Eintrag bspw. mit der Auswahl 5 angezeigt oder mit Auswahl 6 gedruckt werden. Es kann auch mit den Funktionstasten 10 und 11 innerhalb der Suchbegriffe gescrollt werden. Die Anzeige der Standardsuchbegriffe Datei/Benutzer/Datum/Zeit/Seiten wird immer angezeigt und kann nicht ausgeschaltet werden Beenden Um die Archivierung zu beenden, geben Sie ENDSPLARC ein. Beachten Sie jedoch, dass während dieser Zeit keine weiteren Spool-Dateien archiviert werden können. Wenn die Überwachung nicht läuft und im System Spool- Dateien generiert werden, die in ein Archiv gehören sollten, kann es zum Verlust dieser Archiveinträge kommen AS Software GmbH Seite: 16

17 4. Handbuch Das Handbuch befindet sich als MS Word Dokument auf dem Datenträger. Sollten Sie MS Word 97 nicht zu Verfügung haben, können Sie kostenlos den Word - Viewer verwenden. Sie finden dieses Freeware Programm auf unserer CD im Verzeichnis ASSOFT unter dem Namen WD97VWR.EXE Falls Sie eine CD-ROM erhalten haben, können Sie auf einem PC direkt in das Verzeichnis ASTOOL wechseln und das Dokument HB[TOOL].DOC anzeigen bzw. drucken. Handelt es sich bei dem Datenträger um eine Bandsicherung, so speichern Sie bitte die Dokumente mit folgendem Befehl zurück: RSTDLO DLO(*ALL) SAVFLR(ASINST) RSTFLR(YYYY) DEV(XXXXXXXXXX) YYYY steht für einen vorhandenen Ordner Ihrer Wahl. Falls Sie einen neuen Ordner einrichten möchten, können Sie das mit dem Befehl CRTFLR FLR(YYYY) XXXXXXXXXX steht für den Einheitennamen z. B. TAP01 Von einem PC aus können Sie dann auf den Ordner zugreifen AS Software GmbH Seite: 17

18 5. Hotline Sollten Sie Fragen oder Probleme im Zusammenhang mit dem Produkt haben, steht Ihnen die Hotline in zur Verfügung. Österreich unter der Tel. Nr. (1) DW 33 Deutschland unter Außerdem können Sie uns Ihre Probleme, Anregungen, Wünsche und Beschwerden als an die Adresse zusenden Eingabe von Freigabecodes Das AS-AS-SPOOL-Archiv ist mit einem Freigabecode geschützt. Falls Sie das Produkt nach Ablauf der Testzeit nicht an uns retournieren, erhalten Sie für jedes Modul einen Freigabecode von uns, den Sie wie folgt eingeben können: ADDLIBLE ASARCV020 Freigabecode SETSECCDE MOD(ARC020) TOOLLIB(ASARCV020) CODE(XXXXXXXXXX) XXXXXXXXXX steht für den Freigabecode, den Sie entweder von unserer Hotline erfahren oder der Rechnung entnehmen AS Software GmbH Seite: 18