ADS Anwendungssteuerung Entwicklerhandbuch

Satzbeschreibung Datei SOWA

Beschreibung

Diese Datei enthält alle ausgelieferten Programm-Updates für das Anwendungspaket DKS.

Je Programm-Update ist ein Satz enthalten, der auch angibt, ob das Programm-Update auch bereits installiert ist.

Die Datei wird je Anwendung geführt und kann bei Bedarf mit der im Internet verfügbaren Datei synchronisiert werden.

Details finden Sie im Kapitel Live Update in diesem Handbuch.

Technische Daten und Schlüsselfelder

Satzlänge : 512 Bytes

Satzzugriff : Indexiert

Schlüssellänge : 20

Schlüsselfelder: PTF-Anwendung

PTF-Id

Die aktuellen Daten können mit Betriebssystembefehl DSPFD abgerufen werden.

Tabelle 1-2: Satzbeschreibung Datei SOWA

Abkürzungen . . : Lng=Länge, D=Anzahl Dezimalenstellen,

C=Alphanumerisches Feld, N=Gezontes numerisches Feld

Feldname	Art	Lng	D	von	bis	Wert	Bezeichnung
Anwendung	C	10		1	10		Schlüsselbegriff-1 Beispiel: DKS
Id	C	10		11	20		Schlüsselbegriff-2 Begriff der ein Sortware-Update von anderen unterscheidet und die Einspielreihenfolge definiert. Für weitere Details siehe Anmerkung 1)
Art	C	10		21	30		Art des Software-Updates in Bezug auf die Art der Auslieferung. Für DKS werden folgende Werte verwendet:
						*NEWVER	Neue Version des Anwendungspaketes, die automatisch an alle Kunden zugestellt wird. Release, Modifikation und PTF sind in diesem Falle 0. Beispiel: DKS5000.
						*NEWREL	Neues Release des Anwendungspaketes, das automatisch an alle Kunden zugestellt wird. Modifikation und PTF sind in diesem Falle 0. Beispiel: DKS5100.
						*NEWMOD	Neue Modifikation des Anwendungspaketes, die nur bei Bedarf von der Hotline an Kunden weitergegeben wird. PTF ist in diesem Falle 0. Beispiel: DKS5110.
						*NEWPTF	(Neues) PTF des Anwendungspaketes, das nur bei Bedarf von der Hotline an Kunden weitergegeben wird. Beispiel: DKS5111.
Status	C	10		31	40		Dieses Feld gibt darüber Auskunft, in welchem Status sich dieses PTF in Bezug auf Installation befindet.
						*INTERNET	Das PTF liegt im Internet und wurde noch nicht heruntergeladen
						*LOCAL	Das PTF wurde bereits aus dem Internet heruntergeladen, aber noch nicht installiert.
						*INSTALLED	Das PTF wurde bereits installiert.
Source-Dir	C	50		41	90		Relatives Verzeichnis, wo die PTF-Dateien zu finden sind. Wird v. Live-Update-Assistenten benötigt.
						Wert	Z.B.: V4M25211
						Keine Angabe	Als Source-Dir wird die PTF-Id angenommen.
Source-File	C	50		91	140	Wert	Dateiname, unter dem die PTF-Dateien zu finden sind. Wird v. Live-Update-Assistenten benötigt. Dateien mit Namenssuffix ".zip" können vom Live-Update-Assistenten entpackt werden.
						Wert	Z.B. V4M25211.zip
						Keine Angabe	Source-File = PTF-Id Oder Source-File = PTF-ID.zip Oder Es existiert eine Datei "Filelist.txt"
Target-Dir	C	50		141	190		Zielverzeichnis Derzeit nicht in Verwendung, Zielverzeichnisse sind immer gleichnamig.
PTF-Datum	N	8	0	191	198		Datum, das dem PTF zugeordnet ist
Inst-Datum	N	8	0	199	206		Datum, an dem das PTF installiert wurde. Derzeit nicht in Verwendung.
Inst-Zeit	N	6	0	207	212		Uhrzeit, zu dem die Installation des Software-Updates abgeschlossen wurde. Derzeit nicht in Verwendung.
Inst-Userid	C	10		213	222		Userid des Anwenders, der das PTF installiert hat. Derzeit nicht in Verwendung.
Beschreibung-1	C	50		223	272		Erster Teil der Beschreibung des Software-Updates
Beschreibung-2	C	50		273	322		Zweiter Teil der Beschreibung des Software-Updates
Beschreibung-3	C	50		323	372		Dritter Teil der Beschreibung des Software-Updates
Beschreibung-4	C	50		373	422		Vierter Teil der Beschreibung des Software-Updates
Ext-PTF-Id	C	10		423	432		Falls eine Anwendung nach außen hin eine andere PTF-ID verwenden möchte (z.B. DKS verwendet derzeit VmMntttt)
Ersetzt-durch	C	10		433	442		Angabe der PTF-Id die dieses PTF ersetzt. Weitere Details siehe unter Anmerkung 2)
Filler	C	70		443	512		Filler

Die aktuellen Feldbeschreibungen können mit Betriebssystembefehl DSPFFD abgerufen werden.

Anmerkung 1)

Die Zusammensetzung der Software-Id muss so gewählt werden, dass aus dem Namen auch die Reihenfolge innerhalb der Software-Updates genau abgeleitet werden kann. Hintergrund für diese Forderung ist, dass das Programm für die Einspielung der Update eine Reihenfolge benötigt: "Welche Software-Updates müssen in welcher Reihenfolge eingespielt werden?".

Aufgrund dessen bilden sich Software-Updates von DKS wie folgt ab:

Bisher	Neu	Erläuterung
V4M2P02304	DKS04000	Neue Version 4.0
V4M2P03300	DKS04100	Erstes Release zu 4.0
V4M2P04305	DKS04200	Zweites Release zu 4.0
V4M2P05075	DKS04210	Erste Modifikation (Zwischen-PTF) zu Release 4.2
V4M25098	DKS04211	Erstes Einzel-PTF zur ersten Modifikation DKS04210
V4M2P05158	DKS04220	Zweite Modifikation (Zwischen-PTF) zu Release 4.2
Usw.
	DKS4300	Drittes Release zu 4.0

Weiters wird empfohlen nur 8-stellige PTF-Ids zu verwenden, da allenfalls gleichnamige Dateien dann auch in für die iSeries lesbaren CD-Verzeichnissen verwendet werden können.

Anmerkung 2)

Ausgelieferte Software-Updates sind in der Regel kumulativ, d.h. am Anfang steht eine sogenannte "Einzelkorrektur" (z.B. V4R2M2E4 Einbau Ausdruck Karteikarte in SLL); zu einem späteren Zeitpunkt sind so viele Einzelkorrekturen verfügbar, dass eine Zwischen-Version mit allen erstellten Einzelkorrektur erstellt wird – damit ersetzt die Zwischenversion alle vorherigen Einzelkorrekturen! Auf ähnliche Art und Weise ersetzen auch neue Versionen (z.B. V4R3) die Zwischen-PTFs.