Dokumentation zur VorgehensweiseDatenbankschnittstelle

Vorgehensweise

Protokolle auf die Datenbank sichern (Funktionsbaustein BAL_DB_SAVE)

Protokolle im Hauptspeicher können Sie mit dem Funktionsbaustein BAL_DB_SAVE sichern. Dieser kann die gesamten Daten des Hauptspeichers auf der Datenbank ablegen (Importing-Parameter I_SAVE_ALL = 'X'). Sie können aber auch gezielt eine Teilmenge durch Angabe einer Menge von Protokollhandles (Importing-Parameter I_T_LOG_HANDLE) spezifizieren.

Beim Sichern von Protokollen wird eine interne Protokollnummer vergeben (Feld LOGNUMBER). Zur Laufzeit ist dieses Feld hingegen nur mit einem temporären Wert gefüllt (z.B. $00001).

Daher liefert der Funktionsbaustein BAL_DB_SAVE eine Tabelle zurück (Exporting-Parameter E_NEW_LOGNUMBERS), die LOG_HANDLE, externe Nummer EXTNUMBER, temporäre LOGNUMBER und endgültige LOGNUMBER gegenüberstellt. Auf diese Weise können Sie nach dem Sichern herausfinden, welche Nummer für ein Protokoll vergeben wurde.

Das Sichern kann auch IN UPDATE TASK erfolgen (Importing-Parameter I_IN_UPDATE_TASK = 'X').

Protokolle auf der Datenbank suchen (Funktionsbaust. BAL_DB_SEARCH)

Sind Protokolle auf der Datenbank gespeichert, muß man sie natürlich auch wiederfinden können. Dies erfolgt durch den Funktionsbaustein BAL_DB_SEARCH.

Diesem übergeben Sie die Filterkriterien für den Protokollkopf (Struktur BAL_S_LFIL) und Sie erhalten eine Tabelle von Protokollköpfen (Struktur BALHDR) zurück, die den Kriterien entsprechen. Diese können Sie dann an den Funktionsbaustein BAL_DB_LOAD übergeben, welcher dann diese Protokolle in den Hauptspeicher lädt.

Protokolle von der Datenbank laden (Funktionsbaustein BAL_DB_LOAD)

Protokolle können Sie mit dem Funktionsbaustein BAL_DB_LOAD von der Datenbank laden. Die Angabe, welche Protokolle in den Hauptspeicher geladen werden sollen, kann auf verschiedene Arten erfolgen:

  • I_T_LOG_HANDLE Eine Tabelle mit Protokollhandles

  • I_T_LOGNUMBER Eine Tabelle mit internen Protokollnummern

  • I_T_LOG_HEADER Eine Tabelle mit Protokollköpfen (Rückgabewert vom Funktionsbaustein BAL_DB_SEARCH)

Protokolle auf der Datenbank löschen (Funktionsbaustein BAL_DB_DELETE)

Falls Sie aus der Applikation heraus Protokolle löschen möchten, benutzen Sie den Funktionsbaustein BAL_DB_DELETE. Analog zum Funktionsbaustein BAL_DB_LOAD kann die Menge der zu löschenden Protokolle über die Angabe von Protokollhandles, Protokollnummern oder Protokollköpfen geschehen.

Analog zum Funktionsbaustein BAL_DB_SAVE kann das Sichern auch im UPDATE TASK geschehen.