1.3.12 StpDDFpath – Pfaddefinitionen in DDFDF.DAT
StpDDFPath( strBufName, nlDateiindex, nlPfadnummer, strMask, strValue );
|
Argumente
|
StrBufName
Buffer der Datei DDFDF.DAT (standard: strDDF)
| ||||||
|
|
nlDateiindex:
Aus diesem Parameter wird der Key für den Datensatz in DDFDF gebildet: „P“ + (4 Byte nlDateiindex rechtsbündig mit führenden Leerzeichen) + 3 Leerzeichen + „0“.
| ||||||
|
|
nlPfadnummer
Ergibt die Position im Datensatz (DDFDF) mit dem Key laut nlDateiindex, an die die 100 Byte Pfadinformation geschrieben werden: Position= (nlPfadnummer * 100) – 90
| ||||||
|
|
strMask
Maskierungszeichen. Wird das Zeichen in strValue eingesetzt, wird an dieser Stelle der Wert nicht überschrieben.
| ||||||
|
|
strValue
Definition des Pfades, die eingetragen oder geändert wird.
| ||||||
|
Rückgabewert:
|
StpRc:
| ||||||
|
Fehlerarten:
|
Analog StpUpp/StpUpd
| ||||||
|
Beschreibung
|
Diese Funktion ändert oder fügt eine Pfaddefinition ein.
Zuerst muss der DDFDF-Satz lt. nlDateiindex gelesen werden, also der Satz mit dem Key „P“ + (4 Byte nlDateiindex rechtsbündig mit führenden Leerzeichen) + 3 Leerzeichen + „0“.
Wenn es diesen Satz nicht gibt, muss er neu geschrieben werden: Key + Rest Leerzeichen.
Die Dateibeschreibung mit der richtigen Anzahl Pfade muss angelegt sein.
Dann wird strValue an die Position lt. nlPfadnummer geschrieben.
Siehe auch Kapitel „Satzaufbau der DDFDF.DAT für die StpDDF-Befehle“.
| ||||||
|
Funktionsart
|
STPFunktion
|
DD-Generierung, Index neu aufbauen
Wird StpDDFpath im Kontext von infra-Setup verwendet, setzt es selbstständig die für eine DD-Generierung oder den Neuaufbau des Indexteils notwendigen Flags in „g_str_Sub_ReorgFlag“, so dass Setup automatisch abhängig von der jeweiligen Feldänderung nur eine DD-Generierung oder eine Index-Generierung der jeweiligen Datenbankdatei anstößt.