Freigeben über

DISPLAY

  • Artikel

Das DISPLAY-Verb gibt Konfigurationsinformationen und aktuelle Betriebswerte für den SNA-Knoten zurück.

Es wird empfohlen, die Windows-Erweiterungsfunktion GetAppcConfig zu verwenden, um Systemkonfigurationsinformationen zu APPC-LUs abzurufen. Benutzer von 5250 Emulatoren sollten insbesondere die Windows-Erweiterung GetAPPCConfig verwenden.

Hinweis

Aufgrund der Art der Client/Server-Architektur enthält die Implementierung des DISPLAY-Verbs auf Host Integration Server wichtige Unterschiede von ibm Extended Services for OS/2 Version 1.0 (IBM ES for OS/2 Version 1.0), auf der sie basiert.

Hinweis

Für Anwendungen, die das Verb APPC DISPLAY im Kompatibilitätsmodus "IBM ES für OS/2 Version 1.0" verwenden und die keine Host Integration Server-Erweiterungen zum Aufzählen aller aktiven Server und Verbindungen verwenden, wählt Host Integration Server nach dem Zufallsprinzip eine DISPLAY-Standardverbindung aus, es sei denn, eine bestimmte DISPLAY-Standardverbindung wurde in SNA Manager konfiguriert. Diese Verbindung wird als Grundlage für alle DISPLAY-Anforderungen verwendet. Informationen zum Angeben der Display-Standardverbindung finden Sie unter Host Integration Server-Hilfe.

Die folgende Struktur beschreibt den vom DISPLAY-Verb verwendeten Verb-Steuerelementblock.

Syntax

  
struct display {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned long   init_sect_len;  
    unsigned long   buffer_len;  
    unsigned char FAR * buffer_ptr;  
    unsigned long  num_sections;  
    unsigned long  display_len;  
    unsigned long  area_needed;  
    unsigned char  sna_global_info;  
    unsigned char  lu62_info;  
    unsigned char  am_info;  
    unsigned char  tp_info;  
    unsigned char  sess_info;  
    unsigned char  link_info;  
    unsigned char  lu_0_3_info;  
    unsigned char  gw_info;  
    unsigned char  x25_physical_link_info;  
    unsigned char  sys_def_info;  
    unsigned char  adapter_info;  
    unsigned char  lu_def_info;  
    unsigned char  plu_def_info;  
    unsigned char  mode_def_info;  
    unsigned char  link_def_info;  
    unsigned char  ms_info;  
    struct sna_global_info_sect FAR * sna_global_info_ptr;  
    struct lu62_info_sect FAR * lu62_info_ptr;  
    struct am_info_sect FAR * am_info_ptr;  
    struct tp_info_sect FAR * tp_info_ptr;  
    struct sess_info_sect FAR * sess_info_ptr;  
    struct link_info_sect FAR * link_info_ptr;  
    struct lu_0_3_info_sect FAR * lu_0_3_info_ptr;  
    struct gw_info_sect FAR * gw_info_ptr;  
    struct x25_physical_link_info_sect FAR * x25_physical_link_info_ptr;  
    struct sys_def_info_sect FAR * sys_def_info_ptr;  
    struct adapter_info_sect FAR * adapter_info_ptr;  
    struct lu_def_info_sect FAR * lu_def_info_ptr;  
    struct plu_def_info_sect FAR * plu_def_info_ptr;  
    struct mode_def_info_sect FAR * mode_def_info_ptr;  
    struct link_def_info_sect FAR * link_def_info_ptr;  
    struct ms_info_sect FAR * ms_info_ptr;  
} DISPLAY;

Member

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

reserv2
Als reserviertes Feld muss dieser Wert auf NULL festgelegt werden.

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“.

init_sect_len
Angegebener Parameter. Gibt die Anzahl der Bytes im ersten Abschnitt des VcB bis zum Anfang der Informationszeiger an. Dieser Parameter und der parameter num_sections müssen abhängig vom angeforderten Format auf bestimmte Werte festgelegt werden. Weitere Details finden Sie in den unten stehenden Hinweisen.

buffer_len
Angegebener Parameter. Gibt die Länge (0 bis 65535 Bytes) des übergebenen Anzeigedatenpuffers an.

buffer_ptr
Angegebener Parameter. Gibt die Adresse des Anzeigedatenpuffers an, der die angeforderten Informationen enthält.

num_sections
Angegebener Parameter. Gibt die maximale Anzahl von Informationsabschnitten an, die vom Verb zurückgegeben werden können. Dieser Parameter und der parameter init_sect_len müssen abhängig vom angeforderten Format auf bestimmte Werte festgelegt werden. Weitere Details finden Sie in den unten stehenden Hinweisen.

display_len
Zurückgegebener Parameter. Gibt die Gesamtzahl der verwendeten Bytes an, die in den Anzeigedatenpuffer zurückgegeben werden.

area_needed
Zurückgegebener Parameter. Stellt die Gesamtanzahl der Bytes bereit, die für alle angezeigten Daten erforderlich sind.

sna_global_info
Angegebener Parameter. Gibt an, ob globale Informationen angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

lu62_info
Angegebener Parameter. Gibt an, ob Informationen zu allen aktiven LUs, ihren Partnern und ihren Modi angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

am_info
Angegebener Parameter. Gibt an, ob Anfügungs-Manager-Informationen zum definierten TP angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt, und dieser Parameter muss auf AP_NO festgelegt werden.

tp_info
Angegebener Parameter. Gibt an, ob Informationen zu den aktiven TPs und aktiven Unterhaltungen angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt, und dieser Parameter muss auf AP_NO festgelegt werden.

sess_info
Angegebener Parameter. Gibt an, ob Informationen zu Sitzungen angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

link_info
Angegebener Parameter. Gibt an, ob Informationen zu den aktiven logischen SNA-Zeilen angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

lu_0_3_info
Angegebener Parameter. Gibt an, ob Informationen zu logischen Einheiten vom Typ 0, 1, 2 und 3 angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

gw_info
Angegebener Parameter. Gibt an, ob Informationen zum SNA-Gateway angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

x25_physical_link_info
Angegebener Parameter. Gibt an, ob X.25-Informationen erforderlich sind. Zulässige Werte sind AP_YES und AP_NO.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt, und dieser Parameter muss auf AP_NO festgelegt werden.

sys_def_info
Angegebener Parameter. Gibt an, ob Informationen zur Standard-LU, Knotennamen und Standardparametern für eingehende und ausgehende implizite Partner angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

adapter_info
Angegebener Parameter. Gibt an, ob Informationen zu den konfigurierten Kommunikationsadaptern angefordert werden. Zulässige Werte sind AP_YES und AP_NO. Dieser Parameter muss auf AP_NO festgelegt werden, wenn das NS/2-Format angefordert wird.

lu_def_info
Angegebener Parameter. Gibt an, ob Informationen zu den definierten LUs angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

plu_def_info
Angegebener Parameter. Gibt an, ob Informationen zu den definierten Partner-LUs angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

mode_def_info
Angegebener Parameter. Gibt an, ob Informationen zu den definierten Knoten angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

link_def_info
Angegebener Parameter. Gibt an, ob Informationen zu den definierten logischen Verknüpfungen angefordert werden. Zulässige Werte sind AP_YES und AP_NO.

ms_info
Angegebener Parameter. Gibt an, ob Informationen zu Verwaltungsdiensten angefordert werden. Zulässige Werte sind AP_YES und AP_NO. Dieser Parameter muss auf AP_NO festgelegt werden, wenn das NS/2-Format angefordert wird.

sna_global_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der globalen SNA-Informationen im Datenpuffer an.

lu62_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der LU 6.2-Informationen im Datenpuffer an.

am_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Anfügen-Manager-Informationen im Datenpuffer an.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt.

tp_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der TP-Informationen im Datenpuffer an.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt.

sess_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Beginns der Sitzungsinformationen im Datenpuffer an.

link_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Linkinformationen im Datenpuffer an.

lu_0_3_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der LU-Informationen im Datenpuffer an.

gw_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Gatewayinformationen im Datenpuffer an.

x25_physical_link_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der X.25-Informationen im Datenpuffer an.

Hinweis

Diese Option wird von Host Integration Server nicht unterstützt.

sys_def_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Standardinformationen des Systems im Datenpuffer an.

adapter_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Adapterinformationen im Datenpuffer an.

lu_def_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der lokalen LU-Definitionsinformationen im Datenpuffer an.

plu_def_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Partner-LU-Definitionsinformationen im Datenpuffer an.

mode_def_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Modusdefinitionsinformationen im Datenpuffer an.

link_def_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Linkdefinitionsinformationen im Datenpuffer an.

ms_info_ptr
Zurückgegebener Parameter. Gibt die Adresse des Anfangs der Verwaltungsdienstinformationen im Datenpuffer an.

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_DISPLAY_INVALID_CONSTANT
Sekundärer Rückgabecode; Der für NUM_SECTIONS oder INIT_SEC_LEN angegebene Wert ist ungültig.

AP_STATE_CHECK
Primärer Rückgabecode; das Verb wurde nicht ausgeführt, da es in einem ungültigen Zustand ausgegeben wurde.

AP_DISPLAY_INFO_EXCEEDS_LEN
Sekundärer Rückgabecode; die zurückgegebenen DISPLAY-Informationen passten nicht in den Puffer.

AP_INVALID_DATA_SEGMENT
Sekundärer Rückgabecode; Das Segment, das den Datenpuffer enthält, ist für die angegebene Datenlänge zu klein.

AP_COMM_SUBSYSTEM_ABENDED
Primärer Rückgabecode; weist darauf hin, dass eine der folgenden Bedingungen aufgetreten ist:

Der von dieser Unterhaltung verwendete Knoten hat einen ABEND gefunden.

Die Verbindung zwischen dem TP und dem Knotentyp 2.1 wurde unterbrochen (LAN-Fehler).

Die SnaBase auf dem TPs-Computer hat einen ABEND gefunden.

AP_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; eine erforderliche Komponente konnte während der Verarbeitung des Verbs nicht geladen oder beendet werden. Folglich konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

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_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

DISPLAY identifiziert eine LU allein anhand des Alias. Wenn derselbe lokale LU-Alias mehrmals in einer Domäne (zu Sicherungs- oder anderen Zwecken) verwendet wird und dieser LU-Alias über DISPLAY angegeben wird, kann das Verb an eine andere LU als die beabsichtigte weitergeleitet werden.

Damit das DISPLAY-Verb erfolgreich zurückgegeben werden kann, muss eine bestimmte Verbindung im Dialogfeld Display Verb des SNA-Managers-Programms definiert werden. IBM hat das VERB DISPLAY ursprünglich mit dem IBM OS/2 Extended Edition-Produkt definiert, das von einer einzigen Verbindung ausging. Da Host Integration Server jedoch mehrere Verbindungen unterstützt, muss die dem VERB DISPLAY zugeordnete spezifische Verbindung konfiguriert werden.

Das Display-Verb erfordert einen vom Benutzer bereitgestellten Puffer für die Rückgabe von Systeminformationen. Wenn der Puffer nicht groß genug ist, gibt APPC den AP_DISPLAY_INFO_EXCEEDS_LEN Rückgabecode zusammen mit der Größe zurück, die zum Zeitpunkt der Anforderung tatsächlich benötigt wurde (im parameter area_needed ). Eine mögliche Strategie für die Verwendung dieses Verbs folgt:

  • Wenn der buffer_len Wert kleiner als der von APPC zurückgegebene area_needed Wert ist und die erforderliche Länge kleiner als 64 KB ist, erhöhen Sie die Größe des Anzeigepuffers auf gleich oder größer als den area_needed Wert.

  • Wenn der area_needed Wert größer als 64 KB ist, können Sie jeden Informationsabschnitt einzeln anfordern. Alternativ können Sie auch die folgenden Schritte ausführen:

    1. Verarbeiten Sie die Informationsabschnitte mit vollständigen Informationen, deren angezeigte Gesamtanzahl der tatsächlichen Gesamtzahl entspricht.

    2. Wählen Sie eine Teilmenge der angeforderten Informationsabschnitte aus, die unvollständige Informationen enthält, und führen Sie das Verb erneut aus, das diese Informationsabschnitte anfordert.

    3. Wiederholen Sie die Schritte a und b nach Bedarf.

    Hinweis

    Wenn ein einzelner Informationsabschnitt größer als 64 KB ist, können Sie nicht alle angeforderten Informationen von APPC abrufen.

    Das DISPLAY-Verb sollte nicht aus verschiedenen Threads desselben Prozesses ausgeführt werden, da es nicht threadsicher ist.

    Das DISPLAY-Verb gibt AP_DISPLAY_INVALID_CONSTANT zurück, wenn die folgenden Werte nicht für die angegebenen Parameter für init_sect_len und num_sections festgelegt sind:

NS/2-Format IBM EE-Format NS/2-Format (nur Windows) IBM EE-Format (nur Windows)
init_sect_len 50 44 52 48
num_sections 16 9 16 9

Die AP_DISPLAY_INVALID_CONSTANT wird auch zurückgegeben, wenn die folgenden Parameter nicht ordnungsgemäß festgelegt sind:

  • reserv2 muss auf NULL festgelegt werden.

  • am_info muss auf AP_NO festgelegt werden.

  • tp_info muss auf AP_NO festgelegt werden.

  • adapter_info muss auf AP_NO festgelegt werden, wenn das NS/2-Format angefordert wird.

  • ms_info muss auf AP_NO festgelegt werden, wenn das NS/2-Format angefordert wird.

Weitere Informationen

Host Integration Server-Erweiterungen
Unterschiede nach Informationstyp