GET_TYPE

Das GET_TYPE Verb gibt den Konversationstyp (einfach oder zugeordnet) einer bestimmten Unterhaltung zurück, damit das Transaktionsprogramm (TP) entscheiden kann, ob einfache oder zugeordnete Konversationsverben verwendet werden sollen.

Die folgende Struktur beschreibt den Verb-Steuerelementblock (VCB), der vom GET_TYPE Verb verwendet wird.

Syntax

  
struct get_type {  
    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_type;  
};   

Member

opcode
Angegebener Parameter. Gibt den Code des Verbvorgangs an, AP_GET_TYPE.

opext
Dieses Feld wird vom Verb GET_TYPE 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. Identifiziert den lokalen 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, zu der dieser TP nachfraget. Der Wert dieses Parameters wurde von MC_ALLOCATE oder ALLOCATE im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

conv_type
Zurückgegebener Parameter. Stellt die Art der Unterhaltung bereit, entweder AP_BASIC_CONVERSATION oder AP_MAPPED_CONVERSATION.

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_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 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_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 Unterhaltung kann sich in einem beliebigen Zustand befinden, mit Ausnahme von RESET, wenn das TP dieses Verb ausgibt.

Es gibt keine Zustandsänderung.