Informationen zu aktiven Links
Informationen zu aktiven Links werden in der link_info_sect Struktur bereitgestellt, wie im Folgenden definiert.
link_info_sect-Syntax
typedef struct link_info_sect {
unsigned long link_init_sect_len;
unsigned short num_links;
unsigned short total_links;
} LINK_INFO_SECT;
Member
link_init_sect_len
Die Länge des ersten Abschnitts der Informationen zu aktiven Links, einschließlich dieses Parameters, bis zur ersten Linküberlagerungsgruppe. Die Länge enthält keine vorherigen Informationsabschnitte.
num_links
Die Anzahl der aktiven Links, die vom DISPLAY-Verb in den Puffer Ihres Programms zurückgegeben werden. Dies ist die Häufigkeit, mit der die Linküberlagerungsgruppe wiederholt wird.
total_links
Die Gesamtanzahl von aktiven Links. Diese Zahl entspricht der Zahl, die im num_links-Member zurückgegeben wird, außer wenn APPC mehr Informationen zu aktiven Links enthält, als im angegebenen Puffer platziert werden können. In diesem Fall ist diese Zahl größer.
Für jeden aktiven Link wird eine link_overlay-Struktur für den aktiven Link bereitgestellt, wie im Folgenden definiert.
link_overlay-Syntax
typedef struct link_overlay {
unsigned long link_entry_len;
unsigned char link_id[12];
unsigned long dlc_name[8];
unsigned char adapter_num;
unsigned char dest_addr_len;
unsigned char dest_addr[32];
unsigned char inbound_outbound;
unsigned char state;
unsigned char deact_link_flag;
unsigned char reserv3;
unsigned short num_sessions;
unsigned short ru_size;
unsigned short reserv4;
unsigned char adj_fq_cp_name[17];
unsigned char adj_node_type;
unsigned char reserv5;
unsigned char cp_cp_sess_spt;
unsigned char conn_type;
unsigned char ls_role;
unsigned char line_type;
unsigned char tg_number;
unsigned long eff_capacity;
unsigned char conn_cost;
unsigned char byte_cost;
unsigned char propagation_delay;
unsigned char user_def_1;
unsigned char user_def_2;
unsigned char user_def_3;
unsigned char security;
unsigned char reserv6;
} LINK_OVERLAY;
Definiert von IBM ES für OS/2-Version 1.0
Member
link_entry_len
Die Größe dieses Linkeintrags.
link_id
Der Name der lokalen logischen Linkstation (EBCDIC).
dlc_name
Der Name des Datenlinksteuerelements (Data Link Control, DLC), der auf einen der folgenden Werte festgelegt ist:
ETHERAND
IBMTRNET
IBMPCNET
SDLC
TWINAX (von Host Integration Server nicht unterstützt)
X25DLC
adapter_num
Die Adapternummer, die von diesem Link verwendet wird, um eine Verbindung mit dem angrenzenden Knoten herzustellen.
dest_addr_len
Die Länge der Zieladapteradresse.
dest_addr
Die Adresse des Zieladapters.
inbound_outbound
Die Richtung des Links. Mögliche Werte:
AP_OUTBOUND
Der Link ist ausgehend.
AP_INBOUND
Der Link ist eingehend.
state
Der Zustand des Links. Der Linkzustand kann einen der folgenden Werte aufweisen:
AP_CONALS_PND
Der Prozess zum Einrichten des Links wurde gestartet, aber die XID-Aushandlung wurde nicht gestartet.
AP_XID_PND
Die XID-Aushandlung wird gerade verarbeitet.
AP_CONTACT_PND
Die XID-Aushandlung wurde abgeschlossen, aber die endgültige Antwort vom DLC wurde nicht empfangen.
AP_CONTACTED
Der Link ist voll funktionsfähig.
AP_DISC_PND
Eine Anforderung zum Trennen des Links wurde an DLC ausgegeben.
AP_DISC_RQ
Der Operator hat eine Trennung des Links angefordert.
deact_link_flag
Der logische Link wird deaktiviert.
reserv3
Ein reserviertes Feld.
num_sessions
Die Anzahl der aktiven Sitzungen.
ru_size
Die RU-Größe.
reserv4
Ein reserviertes Feld.
adj_fq_cp_name
Der vollqualifizierte cp_name im angrenzenden Knoten.
adj_node_type
Der Typ des angrenzenden Knotens (NN, EN oder LEN).
cp_cp_sess_spt
Gibt an, ob der Link CP-CP-Sitzungen unterstützt.
conn_type
Gibt an, ob das Sitzungsaktivierungsprotokoll den Regeln für eine unabhängige LU oder eine abhängige LU folgt. Der Verbindungstyp kann einen der folgenden Werte aufweisen:
AP_HOST_SESSION
Bei abhängigen LU-Protokollen wird die Arbeitsstations-LU als abhängig vom Host definiert. Die Host-LU sendet die Sitzungsaktivierungsanforderung (BIND), und jede Arbeitsstations-LU kann jeweils nur eine Sitzung unterstützen.
AP_PEER_SESSION
Bei unabhängigen LU-Protokollen kann eine LU eine BIND-Anforderung senden und mehrere Sitzungen mit verschiedenen Partner oder parallele Sitzungen mit derselben Partner-LU haben.
AP_BOTH_SESSION
Verbindungen können sowohl abhängige als auch unabhängige LUs unterstützen.
ls_role
Gibt die Linkstationsrolle an.
line_type
Der Zeilentyp.
tg_number
Die Nummer der Übertragungsgruppe.
eff_capacity
Die höchste effektive Kapazität, die für Übertragungen mit der Bitrate unterstützt wird.
conn_cost
Die relativen Kosten pro Verbindungszeit über diesen Link.
byte_cost
Die relativen Kosten für die Übertragung eines Bytes über den Link.
propagation_delay
Gibt den Zeitraum an, den das Signal benötigt, um den Link vollständig zu durchlaufen. Ist auf einen der folgenden Werte festgelegt:
AP_PROP_DELAY_MINIMUM
AP_PROP_DELAY_LAN
AP_PROP_DELAY_TELEPHONE
AP_PROP_DELAY_PKT_SWITCHED_NET
AP_PROP_DELAY_SATELLITE
AP_PROP_DELAY_MAXIMUM
user_def_1
Benutzerdefinierte TG-Merkmale.
user_def_2
Benutzerdefinierte TG-Merkmale.
user_def_3
Benutzerdefinierte TG-Merkmale.
security
Der Sicherheitswert für diesen Link. Ist auf einen der folgenden Werte festgelegt:
AP_SEC_NONSECURE
AP_SEC_PUBLIC_SWITCHED_NETWORK
AP_SEC_UNDERGROUND_CABLE
AP_SEC_SECURE_CONDUIT
AP_SEC_GUARDED_CONDUIT
AP_SEC_ENCRYPTED
AP_SEC_GUARDED_RADIATION
reserv6
Ein reserviertes Feld.
Wird von Host Integration Server zurückgegeben.
Member
link_entry_len
Die Größe dieses Linkeintrags.
link_id
Der Name der Verbindung.
dlc_name
Der DLC-Name, der auf einen der folgenden Werte festgelegt ist:
IBMTRNET
SDLC
X25DLC
adapter_num
Die Adapternummer, die von diesem Link verwendet wird, um eine Verbindung mit dem angrenzenden Knoten herzustellen. Ist immer auf Null festgelegt.
dest_addr_len
Die Länge der Zieladapteradresse.
dest_addr
Die Adresse des Zieladapters.
inbound_outbound
Die Richtung des Links. Mögliche Werte:
AP_OUTBOUND
Der Link ist ausgehend.
AP_INBOUND
Der Link ist eingehend.
state
Der Zustand des Links. Der Linkzustand kann einen der folgenden Werte aufweisen:
AP_CONALS_PND
Der Prozess zum Einrichten des Links wurde gestartet, aber die XID-Aushandlung wurde nicht gestartet.
AP_XID_PND
Die XID-Aushandlung wird gerade verarbeitet.
AP_CONTACT_PND
Die XID-Aushandlung wurde abgeschlossen, aber die endgültige Antwort vom DLC wurde nicht empfangen.
AP_CONTACTED
Der Link ist voll funktionsfähig.
AP_DISC_PND
Eine Anforderung zum Trennen des Links wurde an DLC ausgegeben.
AP_DISC_RQ
Der Operator hat eine Trennung des Links angefordert.
deact_link_flag
Der logische Link wird deaktiviert.
num_sessions
Die Anzahl der aktiven Sitzungen.
ru_size
Die RU-Größe.
adj_fq_cp_name
Der vollqualifizierte cp_name im angrenzenden Knoten. Ist immer auf EBCDIC-Leerräume festgelegt.
adj_node_type
Der Typ des angrenzenden Knotens. Ist immer auf AP_LEN festgelegt.
cp_cp_sess_spt
Gibt an, ob der Link CP-CP-Sitzungen unterstützt. Ist immer auf AP_NO festgelegt.
conn_type
Gibt an, ob das Sitzungsaktivierungsprotokoll den Regeln für eine unabhängige LU oder eine abhängige LU folgt. Der Verbindungstyp kann einen der folgenden Werte aufweisen:
AP_HOST_SESSION
Bei abhängigen LU-Protokollen wird die Arbeitsstations-LU als abhängig vom Host definiert. Die Host-LU sendet die Sitzungsaktivierungsanforderung (BIND), und jede Arbeitsstations-LU kann jeweils nur eine Sitzung unterstützen.
AP_PEER_SESSION
Bei unabhängigen LU-Protokollen kann eine LU eine BIND-Anforderung senden und mehrere Sitzungen mit verschiedenen Partner oder parallele Sitzungen mit derselben Partner-LU haben.
ls_role
Gibt die Linkstationsrolle an.
line_type
Der Zeilentyp.
tg_number
Die Nummer der Übertragungsgruppe. Ist immer auf Null festgelegt.
effective_capacity
Die höchste effektive Kapazität, die für Übertragungen mit der Bitrate unterstützt wird. Ist immer auf Null festgelegt.
conn_cost
Die relativen Kosten pro Verbindungszeit über diesen Link. Ist immer auf Null festgelegt.
byte_cost
Die relativen Kosten für die Übertragung eines Bytes über den Link. Ist immer auf Null festgelegt.
propagation_delay
Gibt den Zeitraum an, den das Signal benötigt, um den Link vollständig zu durchlaufen. Dieser Parameter ist immer auf AP_PROP_DELAY_MAXIMUM festgelegt.
user_def_1
Benutzerdefinierte TG-Merkmale. Ist immer auf Null festgelegt.
user_def_2
Benutzerdefinierte TG-Merkmale. Ist immer auf Null festgelegt.
user_def_3
Benutzerdefinierte TG-Merkmale. Ist immer auf Null festgelegt.
security
Der Sicherheitswert für diesen Link. Ist immer auf AP_SEC_NONSECURE festgelegt.