Freigeben über

GET_STATE

Das GET_STATE Verb gibt den Status einer bestimmten Unterhaltung zurück.

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

Syntax

  
struct get_state {  
    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;  
    unsigned char    conv_state;  
};

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_GET_STATE an.

opext
Dieses Feld wird vom verb GET_STATE nicht 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. Identifies the local transaction program (TP). Der Wert dieses Parameters wurde von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

conv_id
Angegebener Parameter. Stellt den Bezeichner für die Unterhaltung bereit, über die dieser TP gefragt ist. Der Wert dieses Parameters wurde von MC_ALLOCATE oder ZUWEISEN im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

conv_state
Zurückgegebener Parameter. Gibt den Status der Unterhaltung an. Der conv_state-Parameter kann einen der folgenden Werte aufweisen:

AP_RESET_STATE

Die Unterhaltung befindet sich im ZUSTAND RESET.

AP_SEND_STATE

Die Unterhaltung befindet sich im STATUS SEND.

AP_RECEIVE_STATE

Die Unterhaltung befindet sich im STATUS EMPFANGEN.

AP_CONFIRM_STATE

Die Unterhaltung befindet sich im Status "BESTÄTIGEN".

AP_CONFIRM_SEND_STATE

Die Unterhaltung befindet sich im zustand CONFIRM_SEND.

AP_CONFIRM_DEALL_STATE

Die Unterhaltung befindet sich im zustand CONFIRM_DEALLOCATE.

AP_PEND_POST_STATE

Die Unterhaltung hat ein POST-Verb ausstehend.

AP_PEND_DEALL_STATE

Die Unterhaltung hat ein DEALLOCATE-Verb ausstehend.

AP_END_CONV_STATE

Die Unterhaltung befindet sich im zustand END_CONVERSATION.

AP_SEND_PENDING_STATE

Die Unterhaltung befindet sich im zustand SEND_PENDING.

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_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_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_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 beliebigen Zustand befinden, wenn das TP dieses Verb ausgibt.

Es gibt keine Zustandsänderung.

  • Last updated on