qRFC-API für die Eingangsqueue 

Die folgende Liste beschreibt die Funktionen des qRFC-API, mit dem Sie Eingangsqueues verwalten und Ihre Elemente bearbeiten können.

 

TRFC_GET_QIN_INFO und TRFC_GET_QIN_INFO_DETAILS

●      Zeigt den aktuellen Inhalt einer oder aller Eingangsqueues an.

 

Beachten Sie auch das Programm RSTRFCIR.

 

TRFC_QIN_GET_CURRENT_PARAM

●      Liefert folgende Informationen über Eingangsqueues: Queuenamen und Queuezähler-Zuordnung zur aktuellen LUW. Sie benötigen diese Informationen, wenn Sie mit der Re-Use-Funktion des qRFC mit Eingangsqueue arbeiten.

 

TRFC_QIN_ACTIVATE

●      Verwenden Sie diesen Funktionsbaustein, wenn Sie einen Queue-Namen (eindeutig oder generisch, wie z.B. BASIS_TEST_*) spezifizieren, um eine oder mehrere Queues zu verarbeiten. Diese Funktion sollte nur benutzt werden, wenn die Queue wegen eines Kommunikationsfehlers (oder wenn eine System- oder Anwendungsausnahme auftrat und das Problem bereits gelöst wurde) blockiert ist. Sie sollte auch benutzt werden, wenn die LUWs in der Eingangsqueue gespeichert wurden und neu aktiviert werden müssen.

●      Eine durch Aufruf der Funktion TRFC_QIN_STOP blockierte Queue kann nicht durch diese Funktion verarbeitet werden.

○       Wenn Sie den Importparameter MAXLUW auf einen Wert ungleich 0 setzen, so aktiviert der qRFC-Manager alle LUWs in der Eingangsqueue.

○       Wenn Sie den Importparameter MAXTIME auf einen Wert ungleich 0 setzen (0 = der Aufruf wird zurückgeschickt, sobald die Queue leer ist), so aktiviert der qRFC-Manager die Queue nur innerhalb der spezifizierten Zeit. Wenn die Zeit während der Verarbeitung der letzten LUW abläuft, so wird dieser Aufruf nach der letzten LUW zurückgeschickt.

○       Wenn Sie den Importparameter MODE auf 'B' ändern, so aktiviert der qRFC-Manager die Queue (Ausführung der qRFC-LUWs) in einem Hintergrund-Job. Die Importparameter für den Start dieses Hintergrund-Jobs sind optional (Voreinstellung: Sofort).

○       Wenn Sie den Importparameter MODE auf 'L' ändern, so verarbeitet der qRFC-Manager alle qRFC-LUWs in einer Queue im Kontext des Aufrufers. Falls bei einem Funktionsbaustein in dieser Queue eine Ausnahme auftritt, wird das einen Kurzdump zur Folge haben, da der qRFC-Manager die Ausnahme in diesem Modus nicht abfangen kann.

○       Wenn Sie den Importparameter USERDEST auf eine "lokale" RFC-Destination (z.B. eine logische Destination mit NONE oder SPACE als Referenzdestination) in der Transaktion SM59 setzen, so verarbeitet der qRFC-Manager alle qRFC-LUWs in einer Queue unter dem Benutzer, der aktuell angemeldet ist. Falls keine Destination angegeben wird, oder der Benutzer nicht definiert wurde, so wird der aktuelle Benutzer verwendet.

 

Beachten Sie auch das Programm RSTRFCI0.

 

TRFC_QIN_DELETE_LUW

●      Löscht die LUW in einer Eingangsqueue (definiert durch den importierenden Parameter TID).

 

TRFC_QIN_DELETE_QUEUE

●      Löscht die gesamte durch den Importparameter QNAME definierte Eingangsqueue.

 

TRFC_QIN_GET_CURRENT_QUEUES

●      Zeigt alle gegenwärtig existierenden Queues an.

 

TRFC_QIN_GET_ERROR_QUEUES

●      Zeigt alle fehlerhaften Queues an, die wegen eines der folgenden Status blockiert sind: SYSFAIL, CPICERR, RETRY, ARETRY, ANORETRY.

○       Queues deren Status auf WAITING steht, werden nicht angezeigt.

 

TRFC_QIN_GET_FIRST_LUW

●      Zeigt Informationen (z.B.: TID) über die erste LUW in einer Queue an.

 

TRFC_QIN_GET_HANGING_QUEUES

●      Diese Funktion zeigt alle blockierten Queues an, inklusive der Queues, die von der Anwendung explizit zur späteren Verarbeitung in die Queue geschrieben wurden und deren Status WAITING ist.

○       Diese Funktion zeigt alle Queues an, deren Status auf WAITING steht. Um nur die fehlerhaften Queues anzusehen, verwenden Sie den Funktionsbaustein TRFC_QIN_GET_ERROR_QUEUES.

 

TRFC_QIN_OVERVIEW

●      Liefert einen Überblick über die gegenwärtig existierenden Eingangsqueues. Diese können unterschiedliche optionale Importparameter besitzen, wie z.B. Queuename, SAP-Mandant.

 

TRFC_QIN_RESTART

●      Verwenden Sie diesen Funktionsbaustein wenn Sie einen Queue-Namen spezifizieren (eindeutig oder generisch, wie z.B. BASIS_TEST_*), um mit der Verarbeitung einer oder mehrerer Queues fortzufahren, unabhängig davon, ob diese Queues vorher gestoppt wurden oder nicht.

○       Wenn Sie den Importparameter FORCE auf SPACE ändern, so reduziert der qRFC Manager den STOP-Zähler und falls dieser Zähler auf 0 steht, wird er die Queue aktivieren. Andernfalls wird der qRFC-Manager die Queue immer aktivieren, egal welchen Stand der STOP-Zähler zeigt.

○       Wenn Sie den Importparameter MAXLUW auf einen Wert ungleich 0 setzen, so aktiviert der qRFC-Manager alle LUWs in der Eingangsqueue.

○       Wenn eine Queue gestoppt wurde, verwenden Sie diesen Aufruf und nicht  TRFC_QIN_ACTIVATE.

○       Wenn Sie den Importparameter NO_ACTIVATE auf 'X' ändern, so entsperrt der qRFC-Manager die Queue nur, aktiviert sie aber nicht.

○       Wenn Sie den Importparameter MAXTIME auf einen Wert ungleich 0 setzen (0 = der Aufruf wird zurückgeschickt sobald die Queue leer ist), so aktiviert der qRFC-Manager die Queue nur innerhalb dieser Zeit. Falls die Zeit abläuft während die letzte LUW verarbeitet wird, so wird dieser Aufruf zurückgeschickt, sobald die letzte LUW beendet ist.

○       Wenn Sie den importierenden Parameter MODE auf 'B' setzen, so aktiviert der qRFC-Manager die Queue und verarbeitet die qRFC-LUWs in einem Hintergrund-Job. Die Importparameter zum Start dieses  Hintergrund-Jobs sind optional (Voreinstellung: Sofort).

○       Wenn Sie den Importparameter MODE auf 'L' setzen, so verarbeitet der qRFC-Manager alle qRFC-LUWs in einer Queue im Kontext des Aufrufenden. Falls ein Funktionsbaustein in dieser Queue eine Ausnahme ausgibt, hat dies einen Kurzdump zur Folge, da der qRFC-Manager die Ausnahme in diesem Modus nicht abfangen kann.

○       Wenn Sie den Importparameter USERDEST auf eine "lokale" RFC-Destination in der Transaktion SM59 setzen (z.B., eine logische Destination mit NONE oder SPACE als Referenzdestination), so verarbeitet der qRFC-Manager alle qRFC-LUWs in einer Queue unter dem aktuell angemeldeten Benutzer. Falls keine Destination angegeben wurde oder der Benutzer nicht definiert wurde, wird der gerade angemeldete Benutzer verwendet.

 

Beachten sie auch RSTRFCI3.

 

TRFC_QIN_RESTART_COND

●      Verwenden Sie diesen Funktionsbaustein, wenn Sie einen Queuenamen zum erneuten Start spezifizieren (eindeutig oder generisch, wie z.B. BASIS_TEST_*), oder wenn Sie einen Queuenamen mit hoher Priorität (eindeutig oder generisch, wie z.B. BASIS_TEST_*) zum erneuten Start einer oder mehrerer Queues angeben.

○       Wenn Sie den Importparameter TILL_STOP auf SPACE ändern, so startet der qRFC-Manager eine Queue erneut, sobald diese leer ist. Andernfalls wird diese Queue erneut gestartet werden, sobald sie gestoppt wurde oder leer ist.

○       Beim Aufruf dieser Funktion mit TILL_STOP = SPACE wird die Queue automatisch zur Aufruf-Zeit stoppen, falls zuvor kein anderer STOP-Aufruf erfolgte.

 

Beachten Sie auch RSTRFCI4.

 

TRFC_QIN_SAVE_CURRENT_LUW

●      Informiert den qRFC-Manager während der Ausführung eines Funktionsbausteins, dass die aktuelle LUW nach erfolgreicher Ausführung (zur Wiederverwendung) gespeichert werden soll.

 

TRFC_QIN_STATE

●      Verwenden Sie diesen Funktionsbaustein, wenn Sie den Queuenamen und  - optional - den SAP-Mandant spezifizieren, um den Status dieser Queue anzuzeigen.

○       Eine Queue hat folgende mögliche Statusanzeigen: READY, CPICERR, SYSFAIL, STOP, WAITSTOP und WAITING.

○       Der Status SYSFAIL ergibt sich aus einem schweren Fehler und wird von einer System-Exception oder Anwendungs-Exception während der Verarbeitung der aktuellen LUW ausgelöst. In diesem Zustand ist die Queue blockiert. Ein automatischer erneuter Start ist nicht möglich. Sie können das Programm RSTRFCI0 benutzen um diese LUW zu reaktivieren, oder das Programm RSTRFCID verwenden, um diese qRFC-LUW zu löschen.

○       Im Status CPICERR steht auch kein automatischer erneuter Versuch zur Verfügung. Dieser Fehler kann nur dann vorkommen, wenn der SAP Gateway auf dem lokalen Applikationsserver außer Funktion ist. Verwenden Sie RSTRFCI0, um die Queue nach Lösung des Gatewayproblems erneut zu starten.

○       Wenn der Queuestatus WAITSTOP oder WAITING ist, so zeigt der exportierende Parameter WQNAME, auf welche Queue die aktuelle Queue wartet um verarbeitet zu werden.

 

Beachten Sie auch RSTRFCI2.

 

TRFC_QIN_STOP

●      Verwenden Sie diese Funktion wenn Sie einen Queuenamen spezifizieren, um eine oder mehrere Queues während der Verarbeitung anzuhalten (eindeutig oder generisch, wie z.B. BASIS_TEST_*)

○       Wenn Sie den mportparameter FORCE auf SPACE ändern, so verarbeitet der qRFC-Manager nur die LUWs in der Queue, die zur STOP-Time existierten. Andernfalls wird der qRFC-Manager sofort die Verarbeitung der Queue anhalten.

○       Ein STOP-Counter zählt die Anzahl der STOP-Aufrufe.

○       Sie können auch eine leere (nicht existierende) Queue anhalten. In diesem Fall werden alle zu dieser Queue zugeordneten LUWs in den qRFC-Tabellen gespeichert.

 

Beachten Sie auch das Programm RSTRFCI1.

 

TRFC_QINS_DELETE_LUW

●      Löscht eine durch den Importparameter TID definierte LUW in einer abgespeicherten Eingangsqueue.

 

TRFC_QINS_DELETE_QUEUE

●      Löscht die gesamte durch den Importparameter QNAME definierte Eingangsqueue.

 

TRFC_QINS_ERASE

●      Löscht einige oder alle LUWs, die durch die Importparameter QNAME und FROM_COUNT definiert wurden und abgespeichert sind.

 

TRFC_QINS_OVERVIEW

●      Liefert einen Überblick über die aktuell existierenden abgespeicherten Eingangsqueues.

 

TRFC_QINS_RESTORE

●      Stellt einige oder alle LUWs wieder her, die durch die Importparameter QNAME und FROM_COUNT definiert wurden und abgespeichert sind.

 

TRFC_RECEIVER_INFO

●      Liefert Informationen vom Sender einer tRFC oder qRFC-LUW, z.B. TID, Client, Benutzer, Hostname des Applikationsservers, Programmname, Transaktionscode. Sie können diesen Funktionsbaustein auch verwenden, um festzustellen, ob ein Funktionsbaustein vom tRFC oder qRFC mit Eingangsqueue aufgerufen wurde.

 

TRFC_SET_QIN_PROPERTIES

●      Übermittelt einen Ausgangsqueue-Namen, einen Eingangsqueue-Namen und – optional - einen Queuezähler an den qRFC-Manager. Diese Parameter sind nur für den nächsten Call Function In Background Task gültig. Die Ausgangsqueue und die Eingangsqueue können denselben Queuenamen besitzen.

 

Beachten Sie auch das Programm RSTRFCT5.