Kontakt

Ansicht
Dokumentation

INITIALIZE_LIVECACHE_LVC - Initialisieren des liveCaches

INITIALIZE_LIVECACHE_LVC - Initialisieren des liveCaches

TXBHW - Original Tax Base Amount in Local Currency   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

Funktionalität

Dieser Funktionsbaustein dient zur Initialisierung eines liveCache in einem SCM-System.

Beispiel

Hinweise

Schnittstelle:

IV_CON_NAME: Name der Datenbankverbindung
IV_ONLY_POST_ACTIONS: 'X': Nur Nachbereituns-Aktionen (Reports,...) aufrufen

Ausnahme ERROR_MESSAGE wird nie ausgelöst. Bei Fehlern bricht der Funktionsbaustein mit E-Meldung ab.

Besonderheiten:

  • Die einzelnen Aktionen des Funktionsbausteins und ihr Ergebnis werden in einer Tabelle als erweitertes Protokoll festgehalten. Dieses wird in der Transaktion LC10 unter #Eigenschaften# und #Operating# angezeigt.
  • Zu Beginn versucht der Funktionsbaustein, eine Sperre (LC_ADMIN_) zu setzen. Hält jemand anderers bereits diese Sperre, bricht der Funktionsbaustein mit E-Meldung ab. Die Sperre wird nach Beendung (mit oder ohne Fehler) des Funktionsbausteins wieder freigegeben.

Voraussetzungen:

  • Die Integrationsdaten für den liveCache müssen korrekt hinterlegt sein (Transaktion DB59 oder LC10 -> Integration). Desweiteren müssen über die DBMRFC-Verbindung DBMServer Kommandos für den liveCache absetzbar sein.
  • Falls der Funktionsbaustein nur für Nachbereitungsaktionen verwendet wird (IV_ONLY_POST_ACTIONS = 'X'), so muss die Instanz ONLINE sein und über die Sekundärverbindung müssen SQL-Anweisungen absetzbar sein.
  • Der ausführende Benutzer muss die Berechtigung haben, einen liveCache zu initialisieren. Diese ist in der Rolle SAP_BC_LVC_SUPERUSER enthalten.
  • Der im User Profile Container des DBMServer hinterlegte SAP-Benutzer muss mit dem Eintrag für den Standard-liveCache-Benutzer in den Integrationsdaten übereinstimmen. Nach dem Initialisieren wird der Benutzer so auf dem liveCache angelegt, wie er im User Profile Container hinterlegt ist.

Ablaufschritte:

Falls IV_ONLY_POST_ACTIONS = initial

Der Funktionsbaustein

  • führt die eventuell in den Integrationsdaten hinterlegten Vorbereitungs-Reports aus.
  • benachrichtigt alle Work-Prozesse, dass sie vor der nächsten SQL-Anweisung über die Sekundärverbindung diese nochmals auf Gültigkeit überprüfen müssen.
  • initialisiert den liveCache durch Ausführung des Scriptes lcinit bzw. lcinit.bat (Windows). In Abhängigkeit vom Codepage-Typ des Applikationsservers wird dabei ein UNICODE oder ein ASCII-liveCache angelegt.
  • überprüft die Protokolldatei lcinit.log nach Fehlermeldungen.
  • führt die eventuell in den Integrationsdaten hinterlegten Nachbereitungs-Reports aus.

Falls IV_ONLY_POST_ACTIONS = 'X'

Der Funktionsbaustein

  • überprüft, ob der liveCache ONLINE ist und per SQL über die Sekundärverbindung erreicht werden kann.
  • benachrichtigt alle Work-Prozesse, dass sie vor der nächsten SQL-Anweisung die Sekundärverbindung auf Gültigkeit überprüfen (und ggf. eine neue aufbauen) müssen.
  • führt die eventuell in den Integrationsdaten hinterlegten Nachbereitungs-Reports aus.

Besonderheiten bei den Vor- und Nachbereitungs-Reports:

  • In den Integrationsdaten können bis zu zehn Reports als Vor- oder als Nachbereitungs-Reports zu einer Aktion angegeben werden.
  • Die Reports einer solchen Reportkette (z.B. Vorbereitungs-Reports für das Initialisieren) müssen alle unterschiedlich sein. Unterschiedliche Ketten (z.B. Vorbereitungs-Reports und Nachbereitungs-Reports für das Initialisieren) können aber dieselben Reports enthalten.
  • Die Reports werden durch den Funktionsbaustein synchron in einer weiteren Task abgearbeitet
  • Die Reports können - wenn Asynchronität gewünscht ist - Aktionen asynchron ausführen oder als Hintergrundjob einplanen.
  • Die Reports können durch Export eines Textes in den Hauptspeicher signalisieren, ob ein Fehler aufgetreten ist oder ein Abbruch des Funktionsbausteins gewünscht ist:
EXPORT report_return_text =
TO MEMORY ID 'LC_REPORT_RETURN_TEXT'
  • : bis zu 255 Zeichen lang

  • beginnt mit #STOP # : Report signalisiert, dass die weitere Durchführung des Start-, Stopp- oder Initialisieren-Vorgangs durch den Funktionsbaustein abgebrochen werden soll - z.B. weil der Report den liveCache-Start selbst durchführt. Funktionsbaustein beendet sich (ohne Fehlermeldung).

  • beginnt nicht mit #STOP #: Report liefert Fehler. Genauere Fehlermeldung steht im . Funktionsbaustein bricht mit Fehlermeldung ab.

  • : Zu sehen im Detailprotokoll in der LC10 (unter #Eigenschaften# und #Operating#)

Weiterführende Informationen





Parameter

IV_CON_NAME
IV_ONLY_POST_ACTIONS

Ausnahmen

ERROR_MESSAGE

Funktionsgruppe

SLCR

General Data in Customer Master   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6395 Date: 20240523 Time: 102705     sap01-206 ( 79 ms )