Información de vínculo activo
Se proporciona información sobre vínculos activos en la estructura link_info_sect, tal y como se define a continuación.
Sintaxis de link_info_sect
typedef struct link_info_sect {
unsigned long link_init_sect_len;
unsigned short num_links;
unsigned short total_links;
} LINK_INFO_SECT;
Miembros
link_init_sect_len
La longitud de la sección de información sobre vínculos activos inicial, incluido este parámetro, hasta el primer grupo de superposición de vínculos. La longitud no incluye ninguna sección de información anterior.
num_links
Número de vínculos activos que devuelve el verbo DISPLAY en el búfer del programa. Este es el número de veces que se repite el grupo de superposición.
total_links
El número total de vínculos activos. Este número es el mismo que el que se devuelve en el miembro num_links, excepto cuando APPC tiene más información sobre los vínculos activos de la que puede colocar en el búfer proporcionado, en cuyo caso este número es mayor.
Para cada vínculo activo, se proporciona una estructura link_overlay del vínculo activo, tal como se define a continuación.
Sintaxis 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;
Definida por IBM ES para la versión 1.0 de OS/2
Miembros
link_entry_len
Tamaño de esta entrada de vínculo.
link_id
Nombre de la estación de vínculo lógico local (EBCDIC).
dlc_name
Nombre del control de vínculos de datos (DLC) establecido en una de las opciones siguientes:
ETHERAND
IBMTRNET
IBMPCNET
SDLC
TWINAX (no compatible con Host Integration Server)
X25DLC
adapter_num
Número de adaptador utilizado por este vínculo para conectarse al nodo adyacente.
dest_addr_len
Longitud de la dirección del adaptador de destino.
dest_addr
Dirección del adaptador de destino.
inbound_outbound
Dirección del vínculo. Los valores pueden ser:
AP_OUTBOUND
El vínculo es saliente.
AP_INBOUND
El vínculo es entrante.
state
Estado del vínculo. El estado del vínculo puede ser uno de los siguientes:
AP_CONALS_PND
Se ha iniciado el proceso para mostrar el vínculo, pero no se ha iniciado la negociación XID.
AP_XID_PND
La negociación XID está en proceso.
AP_CONTACT_PND
Se ha completado la negociación XID, pero no se ha recibido la respuesta final del DLC.
AP_CONTACTED
El vínculo funciona totalmente.
AP_DISC_PND
Se ha emitido una solicitud para desconectar el vínculo al DLC.
AP_DISC_RQ
El operador ha solicitado que se desconecte el vínculo.
deact_link_flag
Desactiva el vínculo lógico.
reserv3
Campo reservado.
num_sessions
Número de sesiones activas.
ru_size
Tamaño de RU.
reserv4
Campo reservado.
adj_fq_cp_name
Valor cp_name completo en el nodo adyacente.
adj_node_type
Tipo de nodo adyacente (NN, EN o LEN).
cp_cp_sess_spt
Especifica si el vínculo admite sesiones CP-CP.
conn_type
Indica si el protocolo de activación de la sesión sigue las reglas para una unidad lógica independiente o una unidad lógica dependiente. El tipo de sesión puede ser uno de los siguientes:
AP_HOST_SESSION
En el caso de los protocolos de unidad lógica dependientes, la unidad lógica de estación de trabajo se define como dependiente en el host, la unidad lógica de host envía la solicitud de activación de la sesión (BIND) y cada unidad lógica de estación de trabajo solo puede admitir una sesión al mismo tiempo.
AP_PEER_SESSION
En el caso de los protocolos de unidad lógica independientes, una unidad lógica puede enviar una solicitud BIND y puede tener varias sesiones para diferentes asociados, o sesiones paralelas para la misma unidad lógica del asociado.
AP_BOTH_SESSION
Las conexiones pueden admitir tanto las unidades lógicas dependientes como las independientes.
ls_role
Especifica el rol de estación de vínculo.
line_type
Tipo de línea.
tg_number
Número del grupo de transmisión.
eff_capacity
Capacidad efectiva de transmisión de velocidad de bits más alta que se admite.
conn_cost
Costo relativo por tiempo de conexión con este vínculo.
byte_cost
Costo relativo de transmisión de un byte a través del vínculo.
propagation_delay
Indica la cantidad de tiempo que la señal tarda en propagarse a través del vínculo. Establezca uno de los valores siguientes:
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
Características de TG definidas por el usuario.
user_def_2
Características de TG definidas por el usuario.
user_def_3
Características de TG definidas por el usuario.
security
Valor de seguridad del vínculo. Establezca uno de los valores siguientes:
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
Campo reservado.
Devuelta por Host Integration Server
Miembros
link_entry_len
Tamaño de esta entrada de vínculo.
link_id
Nombre de la conexión.
dlc_name
El nombre de DLC se establece en una de las opciones siguientes:
IBMTRNET
SDLC
X25DLC
adapter_num
Número de adaptador utilizado por este vínculo para conectarse al nodo adyacente. Siempre se estable en cero.
dest_addr_len
Longitud de la dirección del adaptador de destino.
dest_addr
Dirección del adaptador de destino.
inbound_outbound
Dirección del vínculo. Los valores pueden ser:
AP_OUTBOUND
El vínculo es saliente.
AP_INBOUND
El vínculo es entrante.
state
Estado del vínculo. El estado del vínculo puede ser uno de los siguientes:
AP_CONALS_PND
Se ha iniciado el proceso para mostrar el vínculo, pero no se ha iniciado la negociación XID.
AP_XID_PND
La negociación XID está en proceso.
AP_CONTACT_PND
Se ha completado la negociación XID, pero no se ha recibido la respuesta final del DLC.
AP_CONTACTED
El vínculo funciona totalmente.
AP_DISC_PND
Se ha emitido una solicitud para desconectar el vínculo al DLC.
AP_DISC_RQ
El operador ha solicitado que se desconecte el vínculo.
deact_link_flag
Desactiva el vínculo lógico.
num_sessions
Número de sesiones activas.
ru_size
Tamaño de RU.
adj_fq_cp_name
Valor cp_name completo en el nodo adyacente. Siempre se establece en espacios EBCDIC.
adj_node_type
Tipo de nodo adyacente. Siempre se establece en AP_LEN.
cp_cp_sess_spt
Especifica si el vínculo admite sesiones CP-CP. Siempre se establece en AP_NO.
conn_type
Indica si el protocolo de activación de la sesión sigue las reglas para una unidad lógica independiente o una unidad lógica dependiente. El tipo de sesión puede ser uno de los siguientes:
AP_HOST_SESSION
En el caso de los protocolos de unidad lógica dependientes, la unidad lógica de estación de trabajo se define como dependiente en el host, la unidad lógica de host envía la solicitud de activación de la sesión (BIND) y cada unidad lógica de estación de trabajo solo puede admitir una sesión al mismo tiempo.
AP_PEER_SESSION
En el caso de los protocolos de unidad lógica independientes, una unidad lógica puede enviar una solicitud BIND y puede tener varias sesiones para diferentes asociados, o sesiones paralelas para la misma unidad lógica del asociado.
ls_role
Especifica el rol de estación de vínculo.
line_type
Tipo de línea.
tg_number
Número del grupo de transmisión. Siempre se estable en cero.
effective_capacity
Capacidad efectiva de transmisión de velocidad de bits más alta que se admite. Siempre se estable en cero.
conn_cost
Costo relativo por tiempo de conexión con este vínculo. Siempre se estable en cero.
byte_cost
Costo relativo de transmisión de un byte a través del vínculo. Siempre se estable en cero.
propagation_delay
Indica la cantidad de tiempo que la señal tarda en propagarse a través del vínculo. Este parámetro siempre se establece en AP_PROP_DELAY_MAXIMUM.
user_def_1
Características de TG definidas por el usuario. Siempre se estable en cero.
user_def_2
Características de TG definidas por el usuario. Siempre se estable en cero.
user_def_3
Características de TG definidas por el usuario. Siempre se estable en cero.
security
Valor de seguridad del vínculo. Siempre se establece en AP_SEC_NONSECURE.