Freigeben über

GET_ATTRIBUTES

  • Artikel

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

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

Member

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

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung an, AP_BASIC_CONVERSATION.

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 wird von TP_STARTED beim Aufrufen von 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 aufrufenden 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 der Daten anfordern und den Empfang der Daten bestätigen können.

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

  • AP_CONFIRM_SYNC_LEVEL gibt an, dass TPs die Bestätigungsverarbeitung in dieser Unterhaltung verwenden können.

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

    mode_name
    Zurückgegebener Parameter. Gibt den Namen einer Gruppe von Netzwerkmerkmalen an. Es handelt sich um eine Zeichenfolge vom Typ A EBCDIC.

    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 eine Zeichenfolge vom Typ A EBCDIC.

    lu_name
    Zurückgegebener Parameter. Gibt den Namen der lokalen LU an.

    lu_alias
    Zurückgegebener Parameter. Stellt den Alias bereit, unter 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, unter dem die Partner-LU dem lokalen TP bekannt ist. Es handelt sich um eine ASCII-Zeichenfolge.

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

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

    User_id
    Zurückgegebener Parameter. Gibt die Benutzer-ID an, die vom aufruften TP über ALLOCATE gesendet wird, um auf den aufgerufenen TP zuzugreifen (falls zutreffend). Es handelt sich um eine Zeichenfolge vom Typ AE EBCDIC. Das Feld enthält die Benutzer-ID, wenn die folgenden Bedingungen erfüllt sind:

  • Für das aufgerufene TP ist Konversationssicherheit erforderlich.

  • 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 zugeordnet wurde. Dies wird auch für ALLOCATE und RECEIVE_ALLOCATE zurückgegeben.

    conv_corr_len
    Zurückgegebener Parameter. Gibt die Länge des zurückgegebenen Konversationskorrelatorbezeichners an.

    conv_corr
    Zurückgegebener Parameter. Gibt den Konversationskorrelatorbezeichner (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 high bit of opext set(opext & AP_EXTD_VCB) != 0.These fields are only when using Sync Point Level 2 support.

luw_id
Bezeichner der logischen Arbeitseinheit.

sess_id
Sitzungsbezeichner.

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_CONVERSATION_TYPE_MIXED
    Primärer Rückgabecode; der TP hat sowohl grundlegende als auch zugeordnete Konversationsverben ausgegeben. In einer einzelnen Unterhaltung kann nur ein Typ ausgegeben werden.

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

Es gibt keine Zustandsänderung.