Freigeben über

TP_ENDED

Das TP_ENDED Verb wird sowohl vom aufrufenden als auch vom aufgerufenen Transaktionsprogramm (TP) ausgegeben und benachrichtigt APPC, dass das TP endet.

Für Microsoft® Windows®, Version 3. x system, it is recommended that you use the WinAsyncAPPC function rather the blocking version of this call.

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

Syntax

  
struct tp_ended {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned char   type;  
};

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_TP_ENDED an.

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung an. Dieses Feld wird nicht vom verb TP_ENDED verwendet.

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 wurde von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

Typ
Angegebener Parameter. Gibt den Typ der Beendigung an, die ausgeführt werden soll. Im Folgenden sind zulässige Werte aufgeführt:

  • AP_HARD gibt an, dass alle aktiven Verben für das TP beendet werden; die von den Unterhaltungen verwendeten Sitzungen werden beendet. Sowohl der lokale TP als auch der Partner-TP können Rückgabecodes für Unterhaltungsfehler empfangen (AP_DEALLOC_ABEND für zugeordnete Unterhaltungen und AP_DEALLOC_ABEND_PROG für grundlegende Unterhaltungen).

  • AP_SOFT gibt an, dass der TP auf den Abschluss aller aktiven Verben wartet; die sitzung, die von der Unterhaltung verwendet wird, bleibt aktiv.

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_TP_ID

Sekundärer Rückgabecode; APPC hat die tp_id nicht als zugewiesener TP-Bezeichner erkannt.

AP_BAD_TYPE

Sekundärer Rückgabecode; der angegebene Typwert wurde von APPC nicht erkannt.

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 beim Verarbeiten des Verbs nicht geladen oder beendet werden. So konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

    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_TP_BUSY
    Primärer Rückgabecode; Der lokale TP hat einen Aufruf an APPC ausgegeben, während APPC einen anderen Aufruf für dasselbe TP verarbeitet hat. Dies kann auftreten, wenn das lokale TP über mehrere Threads verfügt und mehrere Threads APPC-Aufrufe mit demselben tp_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

Als Reaktion auf TP_ENDED gibt APPC die vom TP verwendeten Ressourcen frei. Nachdem dieses Verb ausgeführt wurde, ist der TP-Bezeichner nicht mehr gültig. der TP kann keine weiteren APPC-Unterhaltungsverben ausgeben.

Die Unterhaltung kann sich in einem beliebigen Zustand befinden, wenn das TP dieses Verb ausgibt.

Wenn sich die Unterhaltung im SEND-Zustand befindet, führt TP_ENDED die Funktion von DEALLOCATE oder MC_DEALLOCATE aus, wobei dealloc_type auf AP_FLUSH festgelegt ist.

Wenn sich die Unterhaltung in einem anderen Zustand als RESET oder SEND befindet, führt TP_ENDED die Funktion von DEALLOCATE oder MC_DEALLOCATE aus, wobei dealloc_type auf AP_ABEND (für eine zugeordnete Unterhaltung) oder AP_ABEND_PROG (für eine einfache Unterhaltung) festgelegt ist.

Nach erfolgreicher Ausführung (primary_rc ist AP_OK), gibt es keinen APPC-Zustand.

  • Last updated on