Freigeben über

REQUEST_TO_SEND

Das verb REQUEST_TO_SEND benachrichtigt das Partnertransaktionsprogramm (PARTNER Transaction Program, TP), dass die lokale TP Daten senden möchte.

In der folgenden Struktur wird der verbsteuerungsblock (VCB) beschrieben, der vom REQUEST_TO_SEND Verb verwendet wird.

Syntax

  
struct 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;  
};

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_B_REQUEST_TO_SEND an.

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung AP_BASIC_CONVERSATION an.

reserv2
Ein reserviertes Feld.

primary_rc
Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC am Ende des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

secondary_rc
Zurückgegebener Parameter. Gibt den von APPC festgelegten sekundären Rückgabecode am Ende des Verbs an. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

tp_id
Angegebener Parameter. Identifiziert das lokale 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 ALLOCATE im aufgerufenen TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

Rückgabecodes

AP_OK
Primärer Rückgabecode; das Verb erfolgreich ausgeführt wurde.

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 Unterhaltungsbezeichner übereinstimmt, der von APPC zugewiesen wurde.

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, weil 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 ausgegeben hat.

AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; gibt eine der folgenden Bedingungen an:

  • Der von dieser Unterhaltung verwendete Knoten hat einen ABEND gefunden.

  • Die Verbindung zwischen dem TP und dem PU 2.1-Knoten wurde unterbrochen (LAN-Fehler).

  • Die SnaBase auf dem Computer des TP ist ein ABEND aufgetreten.

    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 nicht geladen oder beendet werden, während das Verb verarbeitet wird. So konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

    Wenn dieser Rückgabecode mit ALLOCATE verwendet wird, kann es darauf hindeuten, dass kein Kommunikationssystem gefunden werden konnte, um die lokale logische Einheit (LU) zu unterstützen. (Der mit TP_STARTED angegebene lokale LU-Alias ist beispielsweise falsch oder wurde nicht konfiguriert.) Wenn lu_alias oder mode_name weniger als acht Zeichen enthält, müssen Sie sicherstellen, dass diese Felder mit Leerzeichen rechts 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 ALLOCATE-Anforderung erfüllen kann.

    Wenn 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 ausgegeben wird) ist für keine aktiven Knoten konfiguriert. Das Problem könnte eine der folgenden sein:

  • Der Knoten mit der lokalen LU wird nicht gestartet.

  • Die lokale LU ist nicht konfiguriert.

    AP_CONVERSATION_TYPE_MIXED
    Primärer Rückgabecode; das TP sowohl grundlegende als auch zugeordnete Unterhaltungsverben ausgestellt hat. In einer einzigen Unterhaltung kann nur ein Typ ausgegeben werden.

    AP_INVALID_VERB_SEGMENT
    Primärer Rückgabecode; die VCB über das Ende des Datensegments hinaus erweitert wurde.

    AP_STACK_TOO_SMALL
    Primärer Rückgabecode; Die Stapelgröße der Anwendung ist zu klein, um das Verb auszuführen. Erhöhen Sie die Stapelgröße Ihrer Anwendung.

    AP_CONV_BUSY
    Primärer Rückgabecode; es kann jeweils nur ein herausragendes Unterhaltungsverb für jede Unterhaltung vorhanden sein. Dies kann auftreten, wenn der lokale TP über mehrere Threads verfügt und mehrere Threads APPC-Aufrufe mit demselben conv_id ausgeben.

    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 beim Verarbeiten eines APPC-Aufrufs vom lokalen TP einen Fehler an APPC zurückgegeben. Der Rückgabecode des Betriebssystems wird über die secondary_rc zurückgegeben. Es wird in intel byte-getauschter Reihenfolge angezeigt. Wenn das Problem weiterhin besteht, wenden Sie sich an den Systemadministrator.

Bemerkungen

Die Unterhaltung kann sich in einem der folgenden Zustände befinden, wenn das TP dieses Verb ausgibt:

BESTÄTIGEN

PENDING_POST (Betriebssystem/2)

EMPFANGEN

Es gibt keine Zustandsänderung.

Die Anforderungs-zu-Senden-Benachrichtigung wird vom Partnerprogramm über den parameter rts_rcvd der folgenden Verben empfangen:

  • BESTÄTIGEN

  • RECEIVE_AND_POST

  • RECEIVE_AND_WAIT

  • RECEIVE_IMMEDIATE

  • SEND_DATA

  • SEND_ERROR

    Sie wird auch durch eine primary_rc von AP_OK auf TEST_RTS angegeben.

    Anforderungs-zu-Senden-Benachrichtigung wird sofort an den Partner TP gesendet; APPC wartet nicht, bis der Sendepuffer gefüllt oder geleert wird. Folglich kann die Anforderungs-zu-Senden-Benachrichtigung nicht mehr sequenziert werden. Wenn sich z. B. der lokale TP im SEND-Zustand befindet und PREPARE_TO_RECEIVE gefolgt von REQUEST_TO_SEND ausgibt, kann der Partner-TP die Anforderungs-zu-Senden-Benachrichtigung empfangen, bevor sie die Sendebenachrichtigung empfängt. Aus diesem Grund kann anforderungs-to-send über ein Empfangsverb an einen TP gemeldet werden.

    Als Reaktion auf diese Anforderung kann der Partner TP die Unterhaltung wie folgt ändern:

  • RECEIVE state by issuing PREPARE_TO_RECEIVE or RECEIVE_AND_WAIT.

  • PENDING_POST Staat, indem RECEIVE_AND_POST ausgestellt wird.

    Der Partner-TP kann auch die Anforderung zum Senden ignorieren.

    Der Unterhaltungszustand ändert sich in SEND für den lokalen TP, wenn der lokale TP einen der folgenden Werte über den what_rcvd Parameter eines nachfolgenden Empfangsverb empfängt:

  • AP_CONFIRM_SEND und Antworten mit BESTÄTIGT

  • AP_DATA_COMPLETE_CONFIRM_SEND und Antworten mit BESTÄTIGT

  • AP_DATA_CONFIRM_SEND und Antworten mit BESTÄTIGT

  • AP_SEND

    Die empfangenen Verben sind RECEIVE_AND_POST, RECEIVE_IMMEDIATE und RECEIVE_AND_WAIT.

  • Last updated on