Kontakt

Ansicht
Dokumentation

WFMC_MESSAGES_SELECT - Selektion von Nachrichten

WFMC_MESSAGES_SELECT - Selektion von Nachrichten

CPI1466 during Backup   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Es werden Nachrichten einer Applikation (z.B. V2 - Lieferung) abhängig vom Verarbeitungsmodus selektiert. Bereiche für Objektschlüssel, Nachrichtenart und Sendemedium schränken die Selektion ein. Rückgabe ist eine Tabelle der selektierten Nachrichten. Die beiden Parameter Applikation und Verarbeitungsmodus sind zwingend.

Der Steuerung erfolgt über den Verarbeitungsmodus. Dabei werden Status und Versandzeitpunkt der Nachrichten bestimmt (die verschiedenen Status und Zeitpunkte sind als Übersicht im Hinweis aufgeführt). Es wird immer eine Menge von gleichartigen Nachrichten (also Nachrichten, die sich nur in Erstellungsdatum und -uhrzeit unterscheiden) betrachtet. Je nach Modus wird - bezogen auf die jüngste Nachricht - wie folgt selektiert:

  • 1 : Erstverarbeitung
Es werden Nachrichten mit Status 0 und Versandzeitpunkt 3 ausgewählt.
  • 2 : Wiederholverarbeitung
Hier muß die jüngste Nachricht den Status 1 oder 2 besitzen.
  • 3 : Fehlerverarbeitung
Es wird geprüft, ob die jüngste Nachricht den Status 2 hat besitzt.

Bei Wiederhol- oder Fehlerverarbeitung spielt der Versandzeitpunkt keine Rolle, da die Nachrichten schon einmal verarbeitet wurden. Ob bei diesen beiden Modus eine Nachricht überhaupt wiederholt werden darf hängt an der Nachrichtenart. Dort kann die die Eigenschaft 'manuell änderbar / wiederholbar' (T685B-NBEAR) eingestellt werden. Dies wird auch bei Erstverarbeitung genutzt: Je nach Ausprägung dürfen die Parameter der Verarbeitung (z.B. Drucker) geändert werden. (Anmerkung: Das Kennzeichen NAST-REPET wird nicht mehr verwendet). Das Kennzeichen wird der Nachricht mitgegeben und im Baustein WFMC_MESSAGES_MAINTAIN verwendet.

Beispiel

Das nachfolgende Programm selektiert alle offenen Nachrichten (also mit Status 0) aus Lieferungen.

program msgsel.

data: msgs like msg0 occurs 100 with header line.

call function 'WFMC_MESSAGES_SELECT'
exporting pi_application = 'V2'
pi_processing = '1'
tables tx_messages = msgs.

Referenz für die Verwendung ist das Programm SD70AV2A (Transaktion VL71) - Nachrichten aus Lieferungen.

Hinweise

Es gibt die folgenden Ausprägungen der beiden Parameter Status und Verarbeitungszeitpunkt (Felder VSTAT und VSZTP in Tabelle NAST):

  • Status
  • 0 : noch nicht verarbeitet

  • 1 : fehlerfrei verarbeitet

  • 2 : fehlerhaft verarbeitet

  • Verarbeitungzeitpunkt
  • 1 : Batch (über RSNAST00)

  • 2 : Batch mit Zeitpunkt

  • 3 : Explizite Anforderung

  • 4 : Sofort, in der Verbuchung

Ablauf: Es wird zunächst versucht einen Massenzugriff über den Objektschlüssel durchzuführen. Andernfalls erfolgt die (normale) Selektion über eine Bereichstabelle. Ein 'cost-based' Optimizer sollte dabei den richtigen Index wählen, insbesondere falls die Menge der Objektschlüssel leer ist (Anwendung: Alle offenen Nachrichten zu einer Applikation). Mit 'rule-based' Optimizern gibt es Probleme, so daß hier eine mehrzeilige Bereichstabelle in Einzelzeilen aufgebrochen wird.

Weiterführende Informationen

Allgemeine Einführung zur Nachrichtensteuerung.
Dokumentation der Funktionsbausteine WFMC_MESSAGES_EXTEND und WFMC_MESSAGES_PROCESS.





Parameter

PI_APPLICATION
PI_PRINTER
PI_PROCESSING
RI_APPLICATION
RI_MEDIUM
RI_OBJECT
RI_TYPE
TX_MESSAGES

Ausnahmen

Funktionsgruppe

V70A

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4502 Date: 20240523 Time: 082222     sap01-206 ( 108 ms )