MC_REQUEST_TO_SEND
Das verb MC_REQUEST_TO_SEND benachrichtigt das Partnertransaktionsprogramm (PARTNER Transaction Program, TP), dass der lokale TP Daten senden möchte.
Die folgende Struktur beschreibt den Verb-Kontrollblock (VCB), der vom MC_REQUEST_TO_SEND Verb verwendet wird.
Syntax
struct mc_request_to_send {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_id[8];
unsigned long conv_id;
};
Member
opcode
Angegebener Parameter. Gibt den Code des Verbvorgangs an, AP_M_REQUEST_TO_SEND.
opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung an, AP_MAPPED_CONVERSATION.
reserv2
Ein reserviertes Feld.
primary_rc
Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.
secondary_rc
Zurückgegebener Parameter. Gibt den sekundären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.
tp_id
Angegebener Parameter. Identifiziert den lokalen TP.
Der Wert dieses Parameters wird von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.
conv_id
Angegebener Parameter. Stellt den Unterhaltungsbezeichner bereit.
Der Wert dieses Parameters wird von MC_ALLOCATE im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.
Rückgabecodes
AP_OK
Primärer Rückgabecode; das Verb wurde erfolgreich ausgeführt.
AP_PARAMETER_CHECK
Primärer Rückgabecode; das Verb wurde aufgrund eines Parameterfehlers nicht ausgeführt.
AP_BAD_CONV_ID
Sekundärer Rückgabecode; der Wert von conv_id nicht mit einem von APPC zugewiesenen Unterhaltungsbezeichner übereinstimmt.
AP_BAD_TP_ID
Sekundärer Rückgabecode; der Wert von tp_id nicht mit einem TP-Bezeichner übereinstimmt, der von APPC zugewiesen wurde.
AP_STATE_CHECK
Primärer Rückgabecode; das Verb wurde nicht ausgeführt, da es in einem ungültigen Zustand ausgegeben wurde.
AP_R_T_S_BAD_STATE
Sekundärer Rückgabecode; die Unterhaltung befindet sich nicht in einem zulässigen Zustand, wenn der TP dieses Verb ausgestellt hat.
AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; weist darauf hin, dass eine der folgenden Bedingungen aufgetreten ist:
Der von dieser Konversation verwendete Knoten hat einen ABEND gefunden.
Die Verbindung zwischen dem TP und dem PU 2.1-Knoten wurde unterbrochen (LAN-Fehler).
SnaBase auf dem Computer des TP hat einen ABEND gefunden.
Der Systemadministrator sollte das Fehlerprotokoll untersuchen, um den Grund für den ABEND zu ermitteln.
AP_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; eine erforderliche Komponente konnte während der Verarbeitung des Verbs nicht geladen werden oder wurde beendet. Folglich konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.Wenn dieser Rückgabecode mit MC_ALLOCATE verwendet wird, kann dies darauf hindeuten, dass kein Kommunikationssystem gefunden wurde, das die lokale LU unterstützt. (Beispielsweise ist der mit TP_STARTED angegebene lokale LU-Alias falsch oder wurde nicht konfiguriert.) Wenn lu_alias oder mode_name weniger als acht Zeichen enthält, müssen Sie sicherstellen, dass diese Felder rechts mit Leerzeichen gefüllt sind. Dieser Fehler wird zurückgegeben, wenn diese Parameter nicht mit Leerzeichen gefüllt sind, da kein Knoten verfügbar ist, der die MC_ALLOCATE Anforderung erfüllen kann.
Wenn MC_ALLOCATE diesen Rückgabecode für ein Microsoft Host Integration Server-Clientsystem erzeugt, das mit mehreren Knoten konfiguriert ist, gibt es zwei sekundäre Rückgabecodes wie folgt:
0xF0000001
Sekundärer Rückgabecode; es wurden keine Knoten gestartet.
0xF0000002
Sekundärer Rückgabecode; Mindestens ein Knoten wurde gestartet, aber die lokale LU (wenn TP_STARTED ausgestellt wird) ist nicht auf aktiven Knoten konfiguriert. Das Problem kann wie folgt aussehen:
Der Knoten mit der lokalen LU wird nicht gestartet.
Die lokale LU ist nicht konfiguriert.
AP_CONVERSATION_TYPE_MIXED
Primärer Rückgabecode; der TP hat sowohl grundlegende als auch zugeordnete Konversationsverben ausgegeben. Nur ein Typ kann in einer einzelnen Unterhaltung ausgegeben werden.AP_INVALID_VERB_SEGMENT
Primärer Rückgabecode; der VCB wurde über das Ende des Datensegments hinaus erweitert.AP_STACK_TOO_SMALL
Primärer Rückgabecode; die Stapelgröße der Anwendung ist zu klein, um das Verb auszuführen. Vergrößern Sie die Stapelgröße Ihrer Anwendung.AP_CONV_BUSY
Primärer Rückgabecode; es kann nur ein herausragendes Konversationsverb gleichzeitig für jede Unterhaltung geben. Dies kann auftreten, wenn der lokale TP über mehrere Threads verfügt und mehr als ein Thread APPC-Aufrufe mit demselben conv_id ausgibt.AP_THREAD_BLOCKING
Primärer Rückgabecode; der aufrufende Thread befindet sich bereits in einem blockierenden Aufruf.AP_UNEXPECTED_DOS_ERROR
Primärer Rückgabecode; das Betriebssystem hat bei der Verarbeitung eines APPC-Aufrufs vom lokalen TP einen Fehler an APPC zurückgegeben. Der Rückgabecode des Betriebssystems wurde über secondary_rc zurückgegeben. Er wird in Intel-Bytetauschreihenfolge angezeigt. Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Systemadministrator.
Hinweise
Die Konversation kann sich in einem der folgenden Zustände befinden, wenn das TP dieses Verb ausgibt:
BESTÄTIGEN
PENDING_POST (Betriebssystem/2)
RECEIVE
Es gibt keine Zustandsänderung.
Die Anforderungs-senden-Benachrichtigung wird vom Partnerprogramm über den parameter rts_rcvd der folgenden Verben empfangen:
-
Es wird auch durch eine primary_rc von AP_OK auf MC_TEST_RTS angegeben.
Die Anforderungs-zu-Senden-Benachrichtigung wird sofort an den Partner-TP gesendet. APPC wartet nicht, bis sich der Sendepuffer füllt oder geleert wird. Folglich kann die Anforderungs-zu-Senden-Benachrichtigung außerhalb der Reihenfolge eingehen. Wenn sich das lokale TP beispielsweise im SEND-Zustand befindet und MC_PREPARE_TO_RECEIVE gefolgt von MC_REQUEST_TO_SEND ausgibt, erhält der Partner-TP im EMPFANGSzustand möglicherweise die Anforderungs-zu-Senden-Benachrichtigung, bevor er die Sendebenachrichtigung empfängt. Aus diesem Grund kann request-to-send einem TP über ein Empfangsverb gemeldet werden.
Als Reaktion auf diese Anforderung kann der Partner-TP die Unterhaltung in Folgendes ändern:
RECEIVE-Status durch Ausstellen von MC_PREPARE_TO_RECEIVE oder MC_RECEIVE_AND_WAIT.
PENDING_POST Staat, indem sie MC_RECEIVE_AND_POST.
Der Partner-TP kann auch die Anforderung zum Senden ignorieren.
Der Konversationszustand ändert sich für den lokalen TP in SEND, wenn das lokale TP einen der folgenden Werte über den what_rcvd Parameter eines nachfolgenden Empfangsverbs empfängt:
AP_CONFIRM_SEND und Antworten mit MC_CONFIRMED
AP_DATA_COMPLETE_CONFIRM_SEND und Antworten mit MC_CONFIRMED
AP_SEND
Die Empfangsverben sind MC_RECEIVE_AND_POST, MC_RECEIVE_IMMEDIATE und MC_RECEIVE_AND_WAIT.