Kapitelübersicht
7. Online-Pflege von externen Schnittstellendateien
7.1 Externe Schnittstellendatei aus der Schluessel-Datenbank abziehen PCL1084
7.2 Externe Schnittstellendatei in die Schluessel-Datenbank laden PCL1085
7. Online-Pflege von externen Schnittstellendateien
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
Externe Schnittstellendateien sind sequentielle Dateien.
Da derartige Daten manuell kaum zu bearbeiten sind, wurde im
ASS ein ONLINE-Dialog geschaffen, der in die Transaktion ST06
integriert und im entsprechenden Handbuch beschrieben ist.
Zusaetzlich werden Batch-Funktionen benoetigt, die externe
Schnittstellendateien ONLINE bearbeitbar machen bzw. ONLINE
bearbeitete, externe Schnittstellen wieder als sequentielle
Datei und damit der Folgeeinspeicherung zur Verfuegung stellen.
Diese BATCH-Funktionen werden von den Programmen PCL1084 und
PCL1085 abgedeckt.
Eine ONLINE-Bearbeitung bietet sich beispielsweise an, um die
von PCL1001 erzeugte Datei der fehlerhaften Schnittstellen-
saetze zu korrigieren.
Dabei duerfte einleuchten, dass eine solche manuelle Bearbei-
tung nur auf relativ kleine Datenmengen von einigen tausend
Saetzen ausgerichtet ist.
7.1 Externe Schnittstellendatei aus der Schluessel- PCL1084
Datenbank abziehen
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
FUNKTIONSBESCHREIBUNG:
---------------------
Das Programm PCL1084 ermoeglicht, externe Schnittstellen
von der Schluessel-Datenbank auf sequentiellen Datentraeger
(Schnittstellendatei ASSIN01) abzuziehen.
Eine Rueckfuehrung der Schnittstelle bietet sich z.B.
dann an, wenn die Arbeiten an der Schnittstelle mittels
des Online-Dialogs ST06 zum Abschluss gekommen sind.
Jede externe Schnittstelle wird ueber einen Elementnamen
identifiziert.
Je Programmlauf wird ueber Vorlaufkarte dem Programm PCL1084
ein Elementname mitgegeben.
Das Programm erzeugt zu diesem Elementnamen die Datei ASSIN01,
prinzipiell im Format einer "langen" externen Schnittstelle.
Wird in der Vorlaufkarte jedoch die Option KURZ angegeben, so
erzeugt das Programm die Datei ASSIN01 im Format einer
"kurzen" Schnittstelle.
Wird die Option LOESCHEN angegeben, werden zusaetzlich nach
dem Abzug auf sequentiellen Datentraeger die betreffenden
Saetze auf der Datenbank geloescht, sofern keine fehler-
haften Saetze aufgetreten sind.
Abzuege der externen Schnittstellen, die mit dem Programm
PCL1084 unter Angabe der Option LOESCHEN erstellt wurden,
koennen mit dem Programm PCL1085 wieder auf die Daten-
bank gebracht werden.
Das Programmpaar PCL1084/PCL1085 ist also unter diesem
Aspekt vergleichbar mit dem Programmpaar PCL1004/PCL1005.
ABLAUF:
------
Datenflussplan
--------------
.---.
,' ',
!'.___.'!
! !
! 1 !
! !
'.___.'
!__
_______ !
/ ! !
! 2 ! !
--------- V
! *************
+--------->! !
! PCL1084 !
! !
*************
! !
! !________
____! !
! !
V V
.---. *************
,' ', ! !
!'.___.'! ! 4 !
! ! ! *****
! 3 ! ! /
! ! ******
'.___.'
Dateibeschreibung
-----------------
Nummer ! DD-Name/PGM ! Beschreibung
-------!------------------!----------------------------
! !
1 ! DST002 ! Schluessel-Datenbank
! !
2 ! ASSCO ! Vorlaufkartendatei
! !
3 ! ASSIN01 ! Externe Schnittstelle
! ! (Format: VB LRECL=5000)
4 ! PROTO ! Verarbeitungsprotokoll
! ! (Format: F LRECL=133 CTLASA)
VORLAUFKARTE:
------------
Aufbau der Vorlaufkarten (allgemein)
------------------------------------
Vorlaufkarten-Optionen koennen auf einer oder mehreren Vorlauf-
karten angegeben werden.
Mehrere Optionen in einer Karte sind mit Komma(ta) zu trennen.
Die erste Optionen-Angabe muss in der ersten Spalte beginnen.
Zulaessige Optionen
-------------------
PROGRAMM=PCL1084
Die Angabe des Programmnamens ist Pflicht.
ELEMENT=xxxxxxxx
Diese Angabe ist Pflicht. Mit der Option ELEMENT wird
der Elementname angegeben, der der betreffenden
Schnittstelle auf der Datenbank zugeordnet wurde.
Der Elementname identifiziert eindeutig eine Externe
Schnittstelle.
LOESCHEN
Diese Angabe ist wahlfrei.
Nach dem Abzug der Schnittstelle mit dem angegebenen
Elementnamen auf die Datei ASSIN01 werden die
Schnittstellensaetze aus der Datenbank geloescht.
KURZ
Diese Angabe ist wahlfrei.
ASSIN01 wird im Format einer "kurzen" Schnittstelle
erzeugt.
7.2 Externe Schnittstellendatei in die Schluessel- PCL1085
Datenbank laden
Kapitelübersicht
Inhaltsverzeichnis
Stichwortverzeichnis
FUNKTIONSBESCHREIBUNG:
---------------------
Externe ASS-Schnittstellen koennen in beliebig viele Einheiten
unterteilt sein, wobei jeweils ein Kopf- und ein Endesatz die
Summensaetze einer solchen Einheit begrenzt.
In den meisten Faellen besteht eine Schnittstelle aus einer
einzigen Einheit, d.h. sie enthaelt neben ihren Summensaetzen
nur einen Kopf- und einen Endesatz.
Das Programm PCL1085 erlaubt nun, gezielt derartige Einheiten
einer Schnittstellendatei in die Schluessel-Datenbank zu laden.
Abschnitte einer externen Schnittstellendatei werden mit eins
beginnend durchgezaehlt.
Mittels dieser Zaehlnummer werden sie in der Datei identifi-
ziert.
Jeder geladene Abschnitt erhaelt einen Namen, unter dem er im
Dialog bearbeitet werden kann.
Diese identifizierenden Merkmale werden dem Programm ueber
Vorlaufkarte mitgegeben (s.u.).
PCL1085 verarbeitet alle gaengigen Formate von externen
Schnittstellen.
Das Format einer geladenen Schnittstelle ist jedoch stets das
einer "langen" Schnittstelle.
Enthaelt die externe Schnittstelle einen Formatfehler, wird
eine Fehlermeldung ausgegeben und das Programm beendet.
Wird die Option LOESCHEN angegeben, werden alle Saetze, die
sich unter dem Elementnamen auf der Schluessel-Datenbank
befinden, vor dem Laden geloescht.
Die externen Schnittstellen, die mit dem Programm PCL1085
auf die Schluessel-Datenbank geladen wurden, koennen mit dem
Programm PCL1084 wieder auf sequentielle Datei (ASSIN01) im
Format einer externen Schnittstelle gebracht werden.
Das Programmpaar PCL1084/PCL1085 ist also unter diesem
Aspekt vergleichbar mit dem Programmpaar PCL1004/PCL1005.
ABLAUF:
------
Datenflussplan
--------------
.---.
,' ',
!'.___.'!
! !
! 1 !
! !
'.___.'
!__
_______ !
/ ! !
! 2 ! !
--------- V
! *************
+--------->! !
! PCL1085 !
! !
*************
! !
! !________
____! !
! !
V V
.---. *************
,' ', ! !
!'.___.'! ! 4 !
! ! ! *****
! 3 ! ! /
! ! ******
'.___.'
Dateibeschreibung
-----------------
Nummer ! DD-Name/PGM ! Beschreibung
-------!------------------!----------------------------
! !
1 ! ASSIN01 ! Externe Schnittstelle
! !
2 ! ASSCO ! Vorlaufkartendatei
! !
3 ! DST002 ! Schluessel-Datenbank
! !
4 ! PROTO ! Verarbeitungsprotokoll
VORLAUFKARTE:
------------
Die Optionen koennen auf eine oder mehrere Vorlaufkarten
verteilt angegeben werden.
Mehrere Optionen in einer Karte sind mit Komma(ta) zu trennen.
Die erste Optionen-Angabe muss in der ersten Spalte beginnen.
Folgende Optionen sind zulaessig:
PROGRAMM=PCL1085
Die Angabe des Programmnamens ist Pflicht.
ELEMENT=xxxxxxxx
Diese Angabe ist Pflicht. Mit der Option ELEMENT wird
der Elementname angegeben, unter dem die betreffende
Schnittstelle in der Schluessel-Datenbank gespeichert
werden soll.
LOESCHEN
Diese Angabe ist wahlfrei.
Existiert in der Schluessel-Datenbank unter dem bei
ELEMENT angegebenen Namen bereits eine Schnittstelle,
so wird diese vor dem Laden der neuen Schnittstelle
geloescht.
EXIT=xxxxxxxx
Diese Angabe entspricht der im Programm PCL1001
(vgl. Dokumentation von PCL1001 im Handbuch 'BETRIEB').
Durch diese Angabe wird erreicht, dass
auch bei der Analyse von externen Schnittstellen analog
zur Folgeeinspeicherung die gleichen User-Exits unter-
stuetzt werden.
NUMMER=nnnnn
Die Zahl nach NUMMER= gibt den Abschnitt der Externen
Schnittstelle an, der auf die Schluessel-Datenbank
geladen werden soll.
Das Programm PCL1085 zaehlt die einzelnen Abschnitte
von 1 an, wobei jeder Abschnitt mit dem Kopfsatz anfaengt,
in der Mitte Summensaetze besitzen kann und mit einem
Endesatz endet.
Beispiel: NUMMER=5
Ab dem 5.Kopfsatz bis zum 5.Endesatz werden die Saetze
verarbeitet und auf die Schluessel-Datenbank geschrieben.
Diese Option ist wahlfrei. Standardannahme ist NUMMER=1.
Vorheriges Kapitel: 6. Maschinelle Pflege der Parameterdatenbanken (Werte-, Schluessel- und Steuerungsdatenbank)
Nächstes Kapitel: 8. Sonstige Dienstprogramme