Freigeben über

GET_ATTRIBUTES

Das GET_ATTRIBUTES Verb gibt die Attribute der Unterhaltung zurück.

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

Syntax

  
struct get_attributes {  
    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    reserv3;  
    unsigned char    sync_level;  
    unsigned char    mode_name[8];  
    unsigned char    net_name[8];  
    unsigned char    lu_name[8];  
    unsigned char    lu_alias[8];  
    unsigned char    plu_alias[8];  
    unsigned char    plu_un_name[8];  
    unsigned char    reserv4[2];  
    unsigned char    fqplu_name[17];  
    unsigned char    reserv5;  
    unsigned char    user_id[10];  
    unsigned long    conv_group_id;  
    unsigned char    conv_corr_len;  
    unsigned char    conv_corr[8];  
    unsigned char    reserv6[13];  
NOTE: The following fields are present when the high bit of opext is set (opext & AP_EXTD_VCB) != 0.   
    unsigned char    luw_id[26];  
    unsigned char    sess_id[8];  
};

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_B_GET_ATTRIBUTES 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. Identifies the local transaction program (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.

sync_level
Zurückgegebener Parameter. Gibt die Ebene der Synchronisierungsverarbeitung für die Unterhaltung an. Dieser Parameter bestimmt, ob die TPs die Bestätigung des Empfangs von Daten anfordern und den Empfang von Daten bestätigen können.

  • AP_NONE gibt an, dass die Bestätigungsverarbeitung in dieser Unterhaltung nicht verwendet wird.

  • AP_CONFIRM_SYNC_LEVEL weist darauf hin, dass TPs die Bestätigungsverarbeitung in dieser Unterhaltung verwenden können.

  • AP_SYNCPT gibt an, dass TPs die Bestätigungsverarbeitung der Synchronisierungspunktebene 2 in dieser Unterhaltung verwenden können.

    mode_name
    Zurückgegebener Parameter. Gibt den Namen einer Reihe von Netzwerkmerkmalen an. Es handelt sich um einen Typ einer EBCDIC-Zeichenfolge.

    net_name
    Zurückgegebener Parameter. Gibt den Namen des SNA-Netzwerks an, das die lokale logische Einheit (LU) enthält, die von diesem TP verwendet wird. Es handelt sich um einen Typ einer EBCDIC-Zeichenfolge.

    lu_name
    Zurückgegebener Parameter. Stellt den Namen der lokalen LU bereit.

    lu_alias
    Zurückgegebener Parameter. Stellt den Alias bereit, mit dem die lokale LU dem lokalen TP bekannt ist. Es handelt sich um eine ASCII-Zeichenfolge.

    plu_alias
    Zurückgegebener Parameter. Stellt den Alias bereit, mit dem die Partner-LU dem lokalen TP bekannt ist. Es handelt sich um eine ASCII-Zeichenfolge.

    plu_un_name
    Zurückgegebener Parameter. Gibt den nicht interpretierten Namen der Partner-LU an– den Namen der Partner-LU, wie sie für den Systemdienste-Kontrollpunkt (System Services Control Point, SSCP) definiert ist. Es handelt sich um einen Typ AE EBCDIC-Zeichenfolge. Dieser Parameter wird nur zurückgegeben, wenn die lokale LU abhängig ist.

    fqplu_name
    Zurückgegebener Parameter. Stellt den vollqualifizierten Namen der Partner-LU bereit. Es handelt sich um einen Typ einer EBCDIC-Zeichenfolge. Das Feld enthält den Netzwerknamen, einen EBCDIC-Zeitraum und den Partner-LU-Namen.

    user_id
    Zurückgegebener Parameter. Gibt den Benutzerbezeichner an, der vom aufrufenden TP über ALLOCATE gesendet wird, um auf das aufgerufene TP zuzugreifen (falls zutreffend). Es handelt sich um einen Typ AE EBCDIC-Zeichenfolge. Das Feld enthält den Benutzerbezeichner, wenn die folgenden Bedingungen erfüllt sind:

  • Das aufgerufene TP erfordert Unterhaltungssicherheit.

  • GET_ATTRIBUTES wurde vom aufgerufenen TP ausgegeben.

    Andernfalls enthält das Feld Leerzeichen.

    conv_group_id
    Zurückgegebener Parameter. Gibt den Unterhaltungsgruppenbezeichner für die Sitzung an, der die Unterhaltung zugewiesen wurde. Dies wird auch für ZUWEISUNG und RECEIVE_ALLOCATE zurückgegeben.

    conv_corr_len
    Zurückgegebener Parameter. Gibt die Länge des Unterhaltungskorrelelatorbezeichners an, der zurückgegeben wird.

    conv_corr
    Zurückgegebener Parameter. Gibt den Unterhaltungskorrelelatorbezeichner (falls vorhanden) an, den die Quell-LU zur Identifizierung der Unterhaltung zuweist, die für das Quell-/Partner-LU-Paar eindeutig ist. Sie wird von der Quell-LU für die Zuordnungsanforderung gesendet.

Hinweis

Die folgenden Felder sind vorhanden, wenn das hohe Bit von opext auf "set(opext & AP_EXTD_VCB) != 0.Diese Felder sind nur vorhanden, wenn die Unterstützung von Sync Point Level 2 verwendet wird.

luw_id
Logischer Arbeitseinheitsbezeichner.

sess_id
Sitzungsbezeichner.

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_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_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, mit Ausnahme von RESET, wenn das TP dieses Verb ausgibt.

Es gibt keine Zustandsänderung.

  • Last updated on