Zusammenfassung von APPC-Verben

In diesem Abschnitt werden die einzelnen APPC-Verbs kurz beschrieben, gruppiert nach Funktion.

Verben zum Starten von Unterhaltungen

ALLOCATEoder MC_ALLOCATE
Vom lokalen Transaktionsprogramm (TP) ausgestellt. Dieses Verb weist eine Sitzung zwischen der lokalen logischen Einheit (LU) und einer Partner-LU zu und stellt eine Konversation zwischen dem lokalen TP und dem Partner-TP her.

ALLOCATE kann entweder eine einfache oder eine zugeordnete Konversation einrichten. MC_ALLOCATE kann nur eine zugeordnete Unterhaltung starten. Nachdem die Konversation zugeordnet wurde, verwendet APPC dieses Verb, um einen Konversationsbezeichner (conv_id) zurückzugeben.

RECEIVE_ALLOCATE
Ausgestellt vom Partner-TP. Dieses Verb bestätigt, dass der Partner-TP bereit ist, eine Konversation mit dem lokalen TP zu beginnen, der ALLOCATE oder MC_ALLOCATE ausgestellt hat. Nach erfolgreicher Ausführung gibt dieses Verb einen TP-Bezeichner (tp_id) für das Partner-TP und die conv_id zurück.

TP_STARTED
Ausgestellt vom lokalen TP. Dieses Verb benachrichtigt APPC, dass der lokale TP gestartet wird. Nach erfolgreicher Ausführung gibt dieses Verb eine tp_id für den lokalen TP zurück.

Verben zum Senden von Daten

BESTÄTIGENoder MC_CONFIRM
Sendet den Inhalt des Sendepuffers der lokalen LU und eine Bestätigungsanforderung an den Partner-TP.

FLUSHoder MC_FLUSH
Leert den Sendepuffer der lokalen LU, und sendet den Inhalt des Puffers an die Partner-LU und tp. Wenn der Sendepuffer leer ist, wird keine Aktion ausgeführt.

PREPARE_TO_RECEIVEoder MC_PREPARE_TO_RECEIVE
Ändert den Zustand der Unterhaltung von SEND in RECEIVE. Vor dem Ändern des Unterhaltungszustands führt dieses Verb das Äquivalent zu FLUSH, MC_FLUSH, CONFIRM oder MC_CONFIRM aus. Nachdem dieses Verb erfolgreich ausgeführt wurde, kann der lokale TP Daten empfangen.

REQUEST_TO_SENDoder MC_REQUEST_TO_SEND
Informiert den Partner-TP darüber, dass der lokale TP Daten senden möchte. Der lokale TP muss warten, bis der Partner-TP PREPARE_TO_RECEIVE, MC_PREPARE_TO_RECEIVE, RECEIVE_AND_WAIT oder MC_RECEIVE_AND_WAIT ausgibt und sich der Unterhaltungszustand in RECEIVE für den Partner-TP ändert, bevor der lokale TP mit dem Senden von Daten beginnt.

SEND_DATAoder MC_SEND_DATA
Fügt Daten in den Sendepuffer der lokalen LU für die Übertragung an den Partner-TP ein.

Die im Sendepuffer der lokalen LU gesammelten Daten werden an die Partner-LU und partner TP übertragen, wenn einer der folgenden Auftritte auftritt:

• Der Sendepuffer füllt sich.

• Der lokale TP gibt FLUSH, MC_FLUSH, CONFIRM, MC_CONFIRM, DEALLOCATE, MC_DEALLOCATE oder ein anderes Verb aus, das den Sendepuffer der lokalen LU leert.

Verben für den Empfang von Daten

POST_ON_RECEIPT oder MC_POST_ON_RECEIPT
Wenn Sie dieses Verb ausgeben, kann sich die Anwendung registrieren, um eine Benachrichtigung zu erhalten, wenn Daten oder status bei der lokalen LU eintreffen, ohne sie tatsächlich zur gleichen Zeit zu erhalten. Dieses Verb kann nur im RECEIVE-Zustand ausgegeben werden und führt nie zu einer Änderung des Konversationszustands.

Wenn der TP dieses Verb ausgibt, gibt APPC sofort die Steuerung an den TP zurück. Wenn die angegebenen Bedingungen erfüllt sind, wird das als Parameter angegebene Win32-Ereignis® signalisiert, und das Verb wird abgeschlossen. Anschließend untersucht der TP den Rückgabecode im Verbsteuerungsblock, um zu ermitteln, ob Daten oder status Benachrichtigungen bei der lokalen LU eingegangen sind, und gibt ein RECEIVE_IMMEDIATE oder RECEIVE_AND_WAIT Verb aus, um die Daten tatsächlich zu empfangen oder status Benachrichtigung zu erhalten.

RECEIVE_AND_POSToder MC_RECEIVE_AND_POST
Durch Das Ausgeben dieses Verbs, während sich die Unterhaltung im RECEIVE-Zustand befindet, ändert sich der Unterhaltungszustand in PENDING_POST und bewirkt, dass der lokale TP Daten asynchron empfängt. Dadurch kann der lokale TP mit der Verarbeitung fortfahren, während die Daten noch an der lokalen LU ankommen.

Wenn Sie dieses Verb ausgeben, während sich die Unterhaltung im SEND-Zustand befindet, wird der Sendepuffer der LU geleert und der Unterhaltungszustand in PENDING_POST geändert. Der lokale TP beginnt dann, Daten asynchron zu empfangen.

RECEIVE_AND_WAIToder MC_RECEIVE_AND_WAIT
Das Ausgeben dieses Verbs, während sich die Konversation im RECEIVE-Zustand befindet, bewirkt, dass der lokale TP alle Daten empfängt, die derzeit vom Partner-TP verfügbar sind. Wenn keine Daten verfügbar sind, wartet der lokale TP auf das Eintreffen der Daten.

Wenn Sie dieses Verb ausgeben, während sich die Unterhaltung im SEND-Zustand befindet, wird der Sendepuffer der LU geleert und der Unterhaltungszustand in RECEIVE geändert. Der lokale TP beginnt dann, Daten zu empfangen.

RECEIVE_IMMEDIATEoder MC_RECEIVE_IMMEDIATE
Empfängt alle Daten, die derzeit vom Partner-TP verfügbar sind. Wenn keine Daten verfügbar sind, wartet der lokale TP nicht.

TEST_RTSoder MC_TEST_RTS
Bestimmt, ob ein REQUEST_TO_SEND oder MC_REQUEST_TO_SEND oder eine Benachrichtigung empfangen wurde.

Verben zum Bestätigen von Daten oder Melden von Fehlern

BESTÄTIGToder MC_CONFIRMED
Antwortet auf eine Bestätigungsanforderung des Partner-TP. Sie informiert den Partner-TP darüber, dass der lokale TP die Daten ohne Fehler empfangen und verarbeitet hat.

RECEIVE_LOG_DATAoder MC_RECEIVE_LOG_DATA
Das Ausgeben dieses Verbs ermöglicht es dem Benutzer, sich zu registrieren, um die Protokolldaten zu erhalten, die einem FMH7-Fehlerbericht (Inbound Function Management Header 7) zugeordnet sind. Das Verb übergibt einen Puffer an APPC, und alle empfangenen Protokolldaten werden in diesem Puffer platziert. APPC verwendet diesen Puffer weiterhin als aufeinanderfolgende FMH7-Dateien, bis er mit einem anderen Puffer bereitgestellt wird (d. h. bis der TP einen anderen RECEIVE_LOG_DATA oder MC_RECEIVE_LOG_DATA einen anderen Puffer oder überhaupt keinen Puffer angibt).

SEND_CONVERSATIONoder MC_SEND_CONVERSATION
Dieses Verb wird vom aufrufenden TP ausgegeben und weist eine Sitzung zwischen der lokalen LU und der Partner-LU zu, sendet Daten zur Sitzung und verwaltet dann die Zuordnung der Sitzung.

SEND_ERRORoder MC_SEND_ERROR
Benachrichtigt den Partner-TP, dass beim lokalen TP ein Fehler auf Anwendungsebene aufgetreten ist.

Verben zum Abrufen und Festlegen von Informationen

GET_ATTRIBUTESoder MC_GET_ATTRIBUTES
Wird von einem TP verwendet, um die Attribute der Unterhaltung abzurufen.

GET_LU_STATUS
Wird verwendet, um die status einer bestimmten Remote-LU zu melden.

GET_STATE
Wird von einem TP verwendet, um den Zustand einer bestimmten Unterhaltung abzufragen.

GET_TP_PROPERTIES
Gibt Attribute des TP und der aktuellen Transaktion zurück.

GET_TYPE
Wird von einem TP verwendet, um den Konversationstyp (einfach oder zugeordnet) einer bestimmten Unterhaltung zu bestimmen. Mit diesen Informationen kann der TP entscheiden, ob grundlegende oder zugeordnete Konversationsverben ausstellen sollen.

SET_TP_PROPERTIES
Wird verwendet, um die Attribute des TP und der aktuellen Transaktion festzulegen.

Verben, die Verwaltungsfunktionen bereitstellen

ACTIVATE_SESSION
Aktiviert eine Sitzung zwischen der lokalen LU und einer angegebenen Partner-LU unter Verwendung eines angegebenen Modus.

CNOS(Anzahl der Sitzungen ändern)
Legt APPC LU 6.2-Sitzungslimits fest.

DEACTIVATE_SESSION
Deaktiviert eine bestimmte Sitzung oder alle Sitzungen in einem bestimmten Modus.

DISPLAY
Gibt Konfigurationsinformationen und aktuelle Betriebswerte für den SNA-Knoten zurück.

Verben zum Beenden von Unterhaltungen

DEALLOCATEor MC_DEALLOCATE
Es wird eine Konversation zwischen zwei TPs zugeordnet. Vor der Zuordnung der Konversation führt dieses Verb das Äquivalent zu FLUSH, MC_FLUSH, CONFIRM oder MC_CONFIRM aus.

TP_ENDED
Ausgestellt von den lokalen und Partner-TPs. Appc wird benachrichtigt, dass das Tp beendet wird. Durch das Ausgeben dieses Verbs werden auch alle aktiven Unterhaltungen beendet.