Informations sur un lien actif
Les informations sur une liaison active sont fournies dans la structure link_info_sect, comme indiqué ci-dessous.
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;
Membres
link_init_sect_len
Longueur de la section d’informations de liaison active initiale, y compris ce paramètre, jusqu’au premier groupe de superposition de liaison. La longueur n’inclut pas les sections d’informations précédentes.
num_links
Nombre de liaisons actives retournées par le verbe DISPLAY dans la mémoire tampon de votre programme. Il s’agit du nombre de fois où le groupe de superposition de liaison est répété.
total_links
Le nombre total de liaisons actives. Ce nombre est le même que le nombre renvoyé dans le membre num_links, sauf lorsque APPC contient plus d’informations sur les liaisons actives qu’il ne peut placer dans la mémoire tampon fournie, auquel cas ce nombre est plus grand.
Pour chaque liaison active, une structure link_overlay pour la liaison active est fournie comme indiqué ci-dessous.
Syntaxe de link_overlay
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;
Défini par IBM ES pour OS/2 version 1.0
Membres
link_entry_len
Taille de cette entrée de liaison.
link_id
Nom de la station de liaison logique locale (EBCDIC).
dlc_name
Le nom DLC (Data Link Control) est défini sur l’un des éléments suivants :
ETHERAND
IBMTRNET
IBMPCNET
SDLC
TWINAX (non pris en charge par Host Integration Server)
X25DLC
adapter_num
Numéro d’adaptateur utilisé par cette liaison pour se connecter au nœud adjacent.
dest_addr_len
Longueur de l’adresse de l’adaptateur de destination.
dest_addr
L’adresse de l’adaptateur de destination.
inbound_outbound
La direction de la liaison. Les valeurs peuvent être les suivantes :
AP_OUTBOUND
La liaison est sortante.
AP_INBOUND
Le lien est entrant.
state
État de la liaison. L’état de la liaison peut être l’un des suivants :
AP_CONALS_PND
Le processus d’activation de la liaison a démarré, mais la négociation XID n’a pas démarré.
AP_XID_PND
La négociation XID est en cours.
AP_CONTACT_PND
La négociation XID s’est terminée, mais la réponse finale du DLC n’a pas été reçue.
AP_CONTACTED
La liaison fonctionne entièrement.
AP_DISC_PND
une requête de déconnexion de la liaison a été envoyée au DLC.
AP_DISC_RQ
L’opérateur a demandé que la liaison soit déconnectée.
deact_link_flag
Désactivez la liaison logique.
reserv3
Un champ réservé.
num_sessions
Nombre de sessions actives.
ru_size
Taille du RU.
reserv4
Un champ réservé.
adj_fq_cp_name
cp_name complet dans le nœud adjacent.
adj_node_type
Type de nœud adjacent (NN, EN ou LEN).
cp_cp_sess_spt
Spécifie si la liaison prend en charge les sessions CP-CP.
conn_type
Indique si le protocole d’activation de session suit les règles pour un LU indépendant ou un LU dépendant. Le type de connexion peut être l’un des suivants :
AP_HOST_SESSION
Pour les protocoles d’unité logique dépendants, l’unité logique de station de travail est définie comme dépendant de l’hôte, l’unité logique hôte envoie la requête d’activation de session (BIND) et chaque unité logique de station de travail ne peut prendre en charge qu’une seule session à la fois.
AP_PEER_SESSION
Pour les protocoles d’unité logique indépendants, une unité logique peut envoyer une liaison et peut avoir plusieurs sessions vers différents partenaires, ou des sessions parallèles vers la même unité logique partenaire.
AP_BOTH_SESSION
Les connexions peuvent prendre en charge des LU dépendantes et indépendantes.
ls_role
Spécifie le rôle de la station de liaison.
line_type
Le type de ligne.
tg_number
Numéro du groupe de transmission.
eff_capacity
Capacité de transmission effective la plus élevée prise en charge.
conn_cost
Coût relatif par heure de connexion à l’aide de cette liaison.
byte_cost
Coût relatif de la transmission d’un octet sur la liaison.
propagation_delay
Indique la durée de la liaison du signal au trajet. Défini sur l’une des valeurs suivantes :
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
Caractéristiques TG définies par l’utilisateur.
user_def_2
Caractéristiques TG définies par l’utilisateur.
user_def_3
Caractéristiques TG définies par l’utilisateur.
security
Valeur de sécurité pour cette liaison. Défini sur l’une des valeurs suivantes :
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
Un champ réservé.
Retourné par Host Integration Server
Membres
link_entry_len
Taille de cette entrée de liaison.
link_id
Nom de la connexion.
dlc_name
Nom DLC défini sur l’un des éléments suivants :
IBMTRNET
SDLC
X25DLC
adapter_num
Numéro d’adaptateur utilisé par cette liaison pour se connecter au nœud adjacent. Toujours défini sur zéro.
dest_addr_len
Longueur de l’adresse de l’adaptateur de destination.
dest_addr
L’adresse de l’adaptateur de destination.
inbound_outbound
La direction de la liaison. Les valeurs peuvent être les suivantes :
AP_OUTBOUND
La liaison est sortante.
AP_INBOUND
Le lien est entrant.
state
État de la liaison. L’état de la liaison peut être l’un des suivants :
AP_CONALS_PND
Le processus d’activation de la liaison a démarré, mais la négociation XID n’a pas démarré.
AP_XID_PND
La négociation XID est en cours.
AP_CONTACT_PND
La négociation XID s’est terminée, mais la réponse finale du DLC n’a pas été reçue.
AP_CONTACTED
La liaison fonctionne entièrement.
AP_DISC_PND
une requête de déconnexion de la liaison a été envoyée au DLC.
AP_DISC_RQ
L’opérateur a demandé que la liaison soit déconnectée.
deact_link_flag
Désactivez la liaison logique.
num_sessions
Nombre de sessions actives.
ru_size
Taille du RU.
adj_fq_cp_name
cp_name complet dans le nœud adjacent. Toujours défini sur les espaces EBCDIC.
adj_node_type
Type de nœud adjacent. Toujours défini sur AP_LEN.
cp_cp_sess_spt
Spécifie si la liaison prend en charge les sessions CP-CP. Toujours défini sur AP_NO.
conn_type
Indique si le protocole d’activation de session suit les règles pour un LU indépendant ou un LU dépendant. Le type de connexion peut être l’un des suivants :
AP_HOST_SESSION
Pour les protocoles d’unité logique dépendants, l’unité logique de station de travail est définie comme dépendant de l’hôte, l’unité logique hôte envoie la requête d’activation de session (BIND) et chaque unité logique de station de travail ne peut prendre en charge qu’une seule session à la fois.
AP_PEER_SESSION
Pour les protocoles LU indépendants, un LU peut envoyer une liaison et peut avoir plusieurs sessions vers différents partenaires, ou des sessions parallèles vers la même LU partenaire.
ls_role
Spécifie le rôle de la station de liaison.
line_type
Le type de ligne.
tg_number
Numéro du groupe de transmission. Toujours défini sur zéro.
effective_capacity
Capacité de transmission effective la plus élevée prise en charge. Toujours défini sur zéro.
conn_cost
Coût relatif par heure de connexion à l’aide de cette liaison. Toujours défini sur zéro.
byte_cost
Coût relatif de la transmission d’un octet sur la liaison. Toujours défini sur zéro.
propagation_delay
Indique la durée de la liaison du signal au trajet. Ce paramètre est toujours défini sur AP_PROP_DELAY_MAXIMUMUMUM.
user_def_1
Caractéristiques TG définies par l’utilisateur. Toujours défini sur zéro.
user_def_2
Caractéristiques TG définies par l’utilisateur. Toujours défini sur zéro.
user_def_3
Caractéristiques TG définies par l’utilisateur. Toujours défini sur zéro.
security
Valeur de sécurité pour cette liaison. Toujours défini sur AP_SEC_NONSECURE.