GET_STATE

Das GET_STATE Verb gibt den Zustand einer bestimmten Konversation zurück.

Die folgende Struktur beschreibt den verb control block (VCB), 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;  
};   

Member

opcode
Angegebener Parameter. Gibt den Code des Verbvorgangs AP_GET_STATE an.

opext
Dieses Feld wird vom GET_STATE Verb nicht verwendet.

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. Gibt das lokale Transaktionsprogramm (TP) an. 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, die von diesem TP gesucht wird. Der Wert dieses Parameters wurde von MC_ALLOCATE oder ALLOCATE im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

conv_state
Zurückgegebener Parameter. Gibt den Zustand der Unterhaltung an. Der parameter conv_state kann einer der folgenden Werte sein:

AP_RESET_STATE

Die Unterhaltung befindet sich im STATUS ZURÜCKSETZEN.

AP_SEND_STATE

Die Unterhaltung befindet sich im Send-Zustand.

AP_RECEIVE_STATE

Die Unterhaltung befindet sich im Status RECEIVE.

AP_CONFIRM_STATE

Die Unterhaltung befindet sich im Status CONFIRM.

AP_CONFIRM_SEND_STATE

Die Unterhaltung befindet sich im CONFIRM_SEND Zustand.

AP_CONFIRM_DEALL_STATE

Die Unterhaltung befindet sich im CONFIRM_DEALLOCATE Zustand.

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 END_CONVERSATION Zustand.

AP_SEND_PENDING_STATE

Die Unterhaltung befindet sich im SEND_PENDING Zustand.

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 stimmte nicht mit einem von APPC zugewiesenen Konversationsbezeichner überein.

AP_BAD_TP_ID

Sekundärer Rückgabecode; Der Wert von tp_id stimmte nicht mit einem TP-Bezeichner überein, der von APPC zugewiesen wurde.

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_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 jeweils nur ein ausstehendes Konversationsverb gleichzeitig geben. Dies kann auftreten, wenn das lokale TP über mehrere Threads verfügt und mehr als ein Thread APPC-Aufrufe mit demselben conv_id ausgibt.

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

Es gibt keine Zustandsänderung.