ADS Anwendungssteuerung Entwicklerhandbuch

Kapitel 4. Installation

4.1 Installation eines Pakets

Folgende Schritte werden von ADS bei der Installation eines Pakets ausgeführt:

Auswahl der Rücksicherungseinheit

Der Benutzer wird aufgefordert, den Namen der Einheit, von der das Paket eingespielt werden soll, einzugeben. Dieser Name wird geprüft, ob er eine gültige Disketten- oder Bandstation bezeichnet.

Einspielen der Objekte

Alle aus der 'QTEMP' gesicherten Objekte werden in die 'QTEMP' eingespielt. Es muss zumindest eine Data-Area mit dem Namen 'INSTALL' existieren, die auf die Bibliothek weiterer gesicherter Objekte verweist. Die Objekte dieser weiteren gesicherten Bibliothek werden anschließend ebenfalls in die 'QTEMP' eingespielt. Im Rahmen dieser beiden Rücksicherungen müssen zumindest die Dateien X0-XV und YT-YV sowie das Programm 'INSTALL' zurückgesichert worden sein.

Auswahl Installationsbibliothek

Aufgrund des Paketleitsatzes in der XU-Installationsdatei wird dem Benutzer der Kurz- und Langname des zu installierenden Pakets angezeigt. Er wird aufgefordert, die Bibliothek einzugeben, in die das Paket installiert werden soll. Diese Bibliothek wird von ADS angelegt und darf noch nicht existieren.

Verträglichkeitsprüfung mit bereits installierten Paketen

Um ein Paket in eine (Programm-)Bibliothek installieren zu können, in der bereits andere Pakete installiert sind, müssen folgende Vorraussetzungen erfüllt sein:

· Für alle in der Bibliothek installierten Pakete muss in der XU-Installationsdatei ein Zuordnungssatz mit dem Eintrag SHR-Pgm-Bib = Ja oder Zwingend vorhanden sein.

· Für alle in der XU-Installationsdatei vorhandenen Zuordnungssätze mit dem Eintrag SHR-Pgm-bib = Zwingend muss das zugeordnete Paket bereits in der Bibliothek installiert sein.

· Für alle in der Bibliothek installierten Pakete muss die aktuelle Version lt. Paketleitsatz in der X7-Installationsdatei größer oder gleich der mindest erforderlichen Version lt. Zuordnungssatz in der XU-Installationsdatei sein.

· Das ADS-Programm 'INSTALLCHK', das aus der ADS-Bibliothek aufgerufen wird, darf keinen Fehler melden. Dieses Programm prüft derzeit nur, dass beim Paket DKS der Name der gewünschten Installationsbibliothek 3-stellig ist.

Wird bei diesen Prüfungen ein Fehler festgestellt, so bricht ADS die Installation ab.

Mischen der eingespielten Dateien

Die eingespielten Dateien X0-XV und YT-YV werden aus der 'QTEMP' mit den bestehenden ADS-Dateien X1-X8 und Datei Y1- Datei Y3 gemischt.

Aufruf INSTALL - paketspezifische Installation

Das Programm 'INSTALL' ist ein Schnittstellenprogramm, um bei der Installation eines Pakets spezifische Funktionen durchführen zu können. Das Programm muss im Rahmen der Installation in die Bibliothek 'QTEMP' eingespielt worden sein.

Die Eigenschaften des Programms 'INSTALL' sind unter 'Erstellen Delivery' beschrieben.

Anmerkung:

Die Installation eines Paketes ist seit Version V03.M07 auch mit dem Befehl LODRUN möglich.

Siehe auch Kapitel 2.2 'Anwendungspaket installieren' im Handbuch Anwendungssteuerung und Kapitel 2.2 'Durchführung Installation' im Installationshandbuch.

4.2 Installation einer Firma

Folgende Schritte werden von ADS bei der Installation einer Firma ausgeführt:

Anlegen der Firmenbibliothek

Es wird eine leere Bibliothek mit dem Kurznamen der Firma angelegt. Diese Bibliothek kann von Paketen für die Speicherung von firmenbezogenen Daten verwendet werden.

Anlegen des Firmenleitsatzes

Für die Firma wird in der X7-Installationsdatei ein Firmenleitsatz angelegt.

Anlegen der firmenbezogenen ADS-Aktivitätssätze

Nachdem definitionsgemäß das Paket für alle Firmen installiert ist, werden die firmenbezogenen Aktivitätsdaten aller ADS-Aktivitäten in die X6-Firmen-Akt-Datei kopiert.

Siehe auch Kapitel 2.3 'Installation Firma' im Handbuch Anwendungssteuerung und Kapitel 2.3.4 'Neue Firma eröffnen' im Installationshandbuch.

4.3 Installation eines Pakets zu einer Firma

Folgende Schritte werden von ADS bei der Installation eines Pakets zu einer Firma ausgeführt.

Verträglichkeitsprüfung

Um ein Paket zu einer Firma installieren zu können, müssen folgende Bedingungen erfüllt sein, falls für die Firma bereits andere Pakete installiert wurden:

· Für alle bereits zur Firma installierten Pakete muss in der X7-Installationsdatei ein Zuordnungssatz mit dem Eintrag SHR-Datei-Bib = Ja oder Zwingend vorhanden sein.

· Für alle in der X7-Installationsdatei vorhandenen Zuordnungssätze mit dem Eintrag SHR-Datei-bib = Zwingend muss das zugeordnete Paket bereits für die Firma installiert sein.

· Für alle zu der Firma installierten Pakete muss die aktuelle Version lt. Paketleitsatz in der X7-Installationsdatei größer oder gleich der mindest erforderlichen Version lt. Zuordnungssatz

Aufruf PKTFIRCHK - paketbezogene Prüfungen

Das Programm PKTFIRCHK ist ein Schnittstellenprogramm, um paketspezifische Prüfungen im Rahmen der Installation durchführen zu können. (Siehe auch: Kapitel 3.2.4)

Aufruf PKTFIR - paketspezifische Installationsfunktion

Das Programm PKTFIR ist ein Schnittstellenprogramm, um paketspezifische Installationsfunktionen durchführen zu können. (Siehe auch: Kapitel 3.2.5)

Anlegen Firmen-Paketzuordnungssatz

Für die Firma wird in der X7-Installationsdatei ein Firmen-Paketzuordnungssatz angelegt.

Anlegen der firmenbezogenen Aktivitätssätze

Die firmenbezogenen Aktivitätsdaten aller paketspezifischen Aktivitäten werden in die X6-Firmen-Akt-Datei kopiert.

Siehe auch Kapitel 2.3.1 'Anwendungspaket zu Firma installieren' im Handbuch Anwendungssteuerung und Kapitel 2.3.5. 'Anwendungspaket zu Firma zuordnen Durchführung' im Installationshandbuch.

4.4 Erstellen Delivery

Delivery Erstellung bedeutet die Erstellung von Auslieferungsbändern, die die Erstinstallation eines Paketes ermöglichen - im Gegensatz dazu: Siehe auch Erstellen von PTF-Medium.

Um ein Paket installieren zu können muss ein Datenträger mit folgenden Objekten ausgeliefert werden:

1. Eine Data-Area mit dem Namen 'INSTALL' und den Attributen

TYPE(*CHAR) LEN(10) VALUE(lib).

Diese Data-Area muss aus der 'QTEMP' gesichert worden sein. 'lib' gibt den Namen der Bibliothek an, aus der die nachfolgenden Objekte gesichert wurden.

Beachten Sie,

dass alle weiteren hier beschriebenen Objekte sowohl aus der 'QTEMP' als auch aus der durch die Data-Area referenzierten Bibliothek gesichert worden sein können. Die im folgenden beschriebenen Objekte müssen am Datenträger vorhanden sein. Sie können aus der Bibliothek 'QTEMP' oder aus der in der o.a. Data-Area 'INSTALL' referenzierten Bibliothek gesichert worden sein.

2. X0-Aktivitätsdatei (Kopie). Diese Datei enthält alle mit dem Paket ausgelieferten Aktivitäten.

3. XP-Protokolldatei (Kopie). Diese Datei wird als leere Datei mitgeliefert.

4. XQ-Expert-Code-Datei (Kopie). Diese Datei enthält alle mit dem Paket ausgelieferten Expert-Codes.

5. XR-Ausschlussdatei (Kopie). Diese Datei enthält alle mit dem Paket ausgelieferten Ausschlussdefinitionen.

6. XS-Berechtigungsdatei (Kopie). Diese Datei kann vorgefertigte ADS-benutzerdefinitionen (Satzart-USERID) enthalten, falls dies für das Paket sinnvoll ist. Es kann aber auch eine leere Datei ausgeliefert werden.

7. XT-Firmen-Aktivitätsdatei (Kopie). Diese Datei wird als leere Datei mitgeliefert.

8. XU-Installationsdatei (Kopie). Diese Datei muss den Paketleitsatz (Satzart-Pkt) sowie alle das Paket betreffenden Paketzuordnungssätze (Satzart-Pkt-Pkt) enthalten.

9. XV-Menüdatei (Kopie). Diese Datei enthält alle mit dem Paket ausgelieferten Menüs.

10. YT-Konstantendatei (Kopie). Diese Datei enthält alle mit dem Paket ausgelieferten Konstantentexte.

11. YV-Sprachendatei (Kopie). Diese Datei enthält alle vom Paket unterstützten Sprachenschlüssel.

Ein Programm 'INSTALL' (siehe auch Kapitel 3.2.3).
Die Funktion dieses Programmes hängt von den Anforderungen des installierten Paketes ab.

Anmerkung:

Die Informationen dieses Kapitels sind nur bis inklusive DKS-Version V03.M06 gütig, da ab V03.M07 gravierende Änderungen im Bereich der Delivery-Erstellung vorgenommen wurden.

4.5 Installation eines PTFs

Folgende Schritte werden von ADS bei der Installation eines PTFs ausgeführt:

Auswahl der Rücksicherungseinheit

Der Benutzer wird aufgefordert, den Namen der Einheit, von der das PTF eingespielt werden soll, einzugeben. Anschließend wird überprüft, ob der Name eine gültige Disketten- oder Bandstation bezeichnet.

Einspielen der Objekte

Alle aus der 'QTEMP' gesicherten Objekte werden in die 'QTEMP' eingespielt. Es muss zumindest eine Data-Area mit dem Name 'PTFVERS' sowie eine in dieser Data-Area referenzierte Data-Area existieren. Diese zweite Data-Area enthält u.a. den Namen einer Bibliothek, aus der weitere Objekte gesichert wurden. Die Objekte dieser Bibliothek werden anschließend ebenfalls in die 'QTEMP' eingespielt. Im Rahmen dieser beiden Rücksicherungen müssen zumindest die Dateien X0-XV und YT-TV sowie das Programm 'INSTPTF' zurückgesichert worden sein.

Auswahl Paketbibliothek

Aufgrund des Paketleitsatzes in der XU-Installationsdatei sowie der entsprechenden Eintragung in der X7-Installationsdatei werden dem Benutzer der Kurz- und Langname sowie die Bibliothek des Paketes, für das ein PTF eingespielt werden soll, angezeigt.

Ab ADS-Version V03M02 muss die Paketbibliothek nicht mehr bestätigt werden.

Verträglichkeitsprüfung mit installierten Paketen

Um ein PTF zu einem Paket installieren zu können, müssen folgende Voraussetzungen erfüllt sein:

· Die neue Version des Paketes muss im Vergleich zum bestehenden Paket

o gleich sein,

oder

o eine um 1 höhere Modifikationsstufe haben,

oder

o eine um 1 höhere Versionsnummer und die Modifikationsstufe 0 haben.

· Für alle in der Bibliothek installierten Pakete muss in der XU-Installationsdatei ein Zuordnungssatz mit dem Eintrag SHR-Pgm-Bib = Ja oder Zwingend vorhanden sein.

· Für alle Pakete in allen Firmen, zu denen das Paket installiert ist, muss in der XU-Installationsdatei ein Zuordnungssatz mit dem Eintrag SHR-Datei-Bib = Ja oder Zwingend vorhanden sein.

· Für alle in der XU-Installationsdatei vorhandenen Zuordnungssätze mit dem Eintrag SHR-Pgm-Bib = Zwingend muss das zugeordnete Paket bereits in der Bibliothek installiert sein.

· Für alle in der XU-Installationsdatei vorhandenen Zuordnungssätze mit dem Eintrag SHR-Pgm-Bib = Zwingend muss das zugeordnete Paket in allen Firmen, für die das Paket installiert ist, vorhanden sein.

· Für alle in der Bibliothek installierten Pakete und in allen dem Paket zugeordneten Firmen muss die aktuelle Version lt. Paketleitsatz in der X7-Installationsdatei größer oder gleich der mindest erforderlichen Version lt. Zuordnungssatz in der XU-Installationsdatei sein.

Wird bei diesen Prüfungen ein Fehler festgestellt, so bricht ADS die Installation ab.

Aufruf INSTPTF - paketspezifisches Installationsprogramm

Das paketspezifische Installationsprogramm INSTPTF wird aufgerufen. Dieses Programm muss im Rahmen der PTF-Installation in die Bibliothek QTEMP eingespielt worden sein.

Die Eigenschaften des Programm INSTPTF sind unter 'Erstellen PTF-Medium' im Kapitel 4.7, "Erstellen PTF-Medium" beschrieben.

Beachten Sie:

Die Informationen dieses Kapitels sind nur bis inklusive DKS-Version V03.M06 gültig, da ab V03.M07 gravierende Änderungen im Bereich der PTF-Einspielung vorgenommen wurden.

4.6 Installation Multi-PTFs

ADS kann auch mehrere PTFs von einem Band in ein Anwendungspaket einspielen.

Die PTF-Installation unterscheidet sich von Kapitel 4.5, "Installation eines PTFs" in folgenden Punkten:

· In der Bibliothek QTEMP muss eine Data-Area namens PTFLIST vorhanden sein, die verschiedene Angaben zu den einzuspielenden PTFs enthält.

· Die unter Kapitel 4.5, "Installation eines PTFs" angeführten Objekte der Bibliothek QTEMP müssen in einer Bibliothek enthalten sein, die beim Paket in der Date-Area PTFLIST angeführt ist.

· Vor der PTF-Einspielung eines Paketes wird geprüft, ob die PTFs dieses Paketes bereits installiert sind - wenn ja kann die Installation der PTFs dieses Paketes übersprungen werden.

· Die Eingabe bzw. Bestätigung der Paketbibliothek ist nicht mehr notwendig - das entsprechende Bildschirmformat wird nur mehr ausgegeben, wenn ein Fehler bei der Versionsprüfung auftritt.

· Der Name des paketspezifischen Installationsprogrammes kann beim Paket in der Data-Area PTFLIST angegeben werden.

· Es kann eine 'Beendigungsmeldung' beim Paket in der Data-Area PTFLIST angegeben werden - diese wird ausgegeben, wenn das betreffende Paket erfolgreich installiert werden konnte (z. B. 'Verlassen Sie ADS...').

· Die Information, dass die PTFs erfolgreich eingespielt werden konnten (ADS1390), wird von ADS selbst ausgegeben.

4.7 Erstellen PTF-Medium

Erstellen PTF-Medium bedeutet die Erstellung von Auslieferungsbändern, die die Einspielung von Programmkorrekturen oder Programmerweiterungen zu einem Anwendungspaket ermöglichen - im Gegensatz dazu: Siehe auch Erstellen Delivery.

Um ein PTF installieren zu können muss ein Datenträger - bis inklusive Version V03.M06 - mit folgenden Objekten ausgeliefert werden:

1. Eine Data-Area mit dem Namen 'PTFVERS' und den Attributen

TYPE(*CHAR) LEN(8) VALUE(dtaara2).

Diese Data-Area muss aus der 'QTEMP' gesichert worden sein. dtaara2 gibt den Namen einer zweiten Data-Area mit den folgenden Attributen an:

TYPE(*CHAR) LEN(512).

Diese Data-Area muss an den Stellen 61-70 die Bibliothek enthalten, aus der die weiteren einzuspielenden Objekte gesichert wurden. Alle anderen Stellen werden von ADS nicht verwendet.

Anmerkung:

Um den Inhalt des Datenträgers besser identifizieren zu können, sollten der Namen dtaara2 nach folgendem Schema aufgebaut sein:

ppptttVxMy

wobei

o ppp ein Kürzel für das Paket ist,

o ttt angibt, ob es sich um ein Auslieferungsmodell oder ein PTF (ttt = MOD oder PTF), und

o VxMy die Versions- und Modifikationsnummer des Pakets bezeichnet.

Die weiteren hier beschriebenen Objekte können sowohl aus der 'QTEMP' als auch aus der durch dtaara2 referenzierten Bibliothek gesichert worden sein.

2. X0-Aktivitätsdatei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Aktivitäten.

3. PR-Protokolldatei (Kopie). Diese Datei wird als leere Datei mitgeliefert.

4. XQ-Expertcode-Datei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Expertcodes.

5. XR-Ausschlussdatei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Ausschlussdefinitionen.

6. XS-Berechtigungsdatei (Kopie). Diese Datei kann neue oder zu ändernde ADS-Benutzerdefinitionen (Satzart-USERID) enthalten, falls dies für das Paket sinnvoll ist. Es kann aber auch eine leere Datei ausgeliefert werden.

7. XT-Firmen-Aktivitätsdatei (Kopie). Diese Datei wird als leere Datei mitgeliefert.

8. XU-Installationsdatei (Kopie). Diese Datei muss den Paketleitsatz (Satzart-Pkt) sowie alle das Paket betreffenden Paketzuordnungssätze (Satzart-Pkt-Pkt) enthalten.

9. XV-Menüdatei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Menüs.

10. YT-Konstantendatei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Konstantentexte.

11. YV-Sprachdatei (Kopie). Diese Datei enthält alle neuen oder zu ändernden Sprachenschlüssel.

12. Ein Programm 'INSTPTF' mit folgenden Eigenschaften:

Parameter

&S1

*CHAR 1024

&DEVICE

*CHAR 10

&LIBRP

*CHAR 512

&PAKET

*CHAR

&PTFVERSI

*CHAR 512

Eingabeparameter

&DEVICE

die bei der PTF-Installation verwendete Rücksicherungseinheit

&LIBRP

die Bibliothek, in der das Paket installiert ist

&PAKET

der Name des installierten Pakets

&PTFVERSI

der Inhalt von dtaara2

Ausgabeparameter

&S1 -

Stelle 344-361 Erfolgs- oder Fehlermeldung

Funktion

Die Funktionen dieses Programms hängen von den Anforderungen des installierten Pakets ab. Die folgenden Aktionen können als Anhaltspunkte für den Programmablauf verstanden werden.

o MRGMSGF des paketbezogenen Message-Files in das ADSMSGF der ADS-BIBLIOTHEK

o Einspielen aller für das PTF benötigten Objekte in die entsprechende Bibliothek (&LIBRP)

o Aufruf paketspezifischer Funktionen

o Update aller paketspezifischen Dateien in allen Firmen, für die das Paket installiert ist

o Update aller ADS-Dateien aufgrund der mitgelieferten Dateien X-XU (und ev.XUV), sowie YT-YV

Beachten Sie:

Im Rahmen der PTF-Installation werden die ADS-Dateien nicht automatisch nachgezogen. Diese Funktion muss paketspezifisch erfolgen!

o Setzen einer Erfolgs- oder Fehlermeldung in der S1; als Erfolgsmeldung sollte die Standardmeldung ADS1390 verwendet werden

Tipp: ADS stellt einige nützliche Statusmeldungen für die PTF-Installation zur Verfügung. Diese Meldungen liegen im Bereich ADS-1380 bis ADS-1400.

13. Alle weiteren für die Installation des Pakets benötigten Objekte. Diese Objekte müssen mit dem Programm INSTPTF geladen werden.

Anmerkung:

Die ausgelieferten Objekte sollten das Benutzerprofil ADS als Eigner haben. Dieses Benutzerprofil wird von ADS zur Verfügung gestellt und ist Voraussetzung für die Arbeit mit ADS.

Beachten Sie:

Die Informationen dieses Kapitels sind nur bis inklusive Version V03.M06 gültig, da ab Version V03.M07 gravierende Änderungen im Bereich der PTF-Einspielung vorgenommen wurden.

4.8 Mehrere PTFs auf einem Band

Wenn mehrere PTFs auf einem Band sein sollten, so sind folgende Abweichungen gegenüber Kapitel 4.7, "Erstellen PTF-Medium" zu berücksichtigen.

· Vor der Durchführung von Punkt 1 von 4.7, "Erstellen PTF-Medium" ist eine Data-Area namens PTFLIST (TYPE(*CHAR LEN(2000)) zu erstellen, die je Paket folgende Informationen enthalten muss:

1 - 10

Paketname

11 - 20

Name der Bibliothek mit den Einspielhilfen (4.7, "Erstellen PTF-Medium" Punkt 1)

21 - 22

Paket-Version

23 - 24

Paket-Modifikationsnummer

25 - 30

Paket-Auslieferungsdatum in der Form JJMMTT

31 - 32

Kennzeichen, ob PTF-Installation der PTFs für dieses Paket beendet werden soll.
Gültige Werte J/N

33 - 39

Meldungsnummer, die ausgegeben werden soll, wenn nach Installation der PTFs für dieses Paket die PTF-Installation beendet werden soll (z. B. ADS1430).

40 - 49

Name des paketspezifischen Installationsprogrammes
Ist hier kein Name eingetragen, wird der Name 'INSTPTF' angenommen.

50 - 59

Name eines Schnittstellenprogrammes
Derzeit nicht verwendet

60 - 128

Derzeit unbenützt

Pro Paket stehen 128 Stellen zu Verfügung, somit sind maximal 15 PTFs möglich.

Alle übergebenen Felder müssen vom TYPE(*CHAR) sein.

Der Bereich 1921 bis 2000 der Data-Area 'PTFLIST' darf nicht verwendet werden.

Diese Data-Area muss aus der Bibliothek 'QTEMP' gesichert werden.

· Die unter Punkt 1 von 4.7, "Erstellen PTF-Medium" verwendeten Objekte müssen (bei allen Paketen) von der Bibliothek gesichert werden, die jeweils in der Data-Area 'PTFLIST' beim Paket an Stelle 11 - 20 eingetragen ist.
Diese Bibliothek muss immer als erste der Paketbibliotheken gesichert werden.

· Die unter Punkt 13 von 4.7, "Erstellen PTF-Medium" (nach dem Beachtungshinweis) angeführte Erfolgsmeldung wird von ADS selbst ausgegeben - eine Meldungsübergabe in der S1 bedeutet, dass ein Fehler aufgetreten ist und ein Abbruch der PTF-Installation eingeleitet wird.
--> auch Ausgabeparameter &S1 korrigieren ... nur: Fehlermeldung