活动链接信息

项目
07/21/2023

活动链路信息在 link_info_sect 结构中提供，如下文所定义。

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;

成员

link_init_sect_len
初始活动链路信息节的长度，包括此参数直至第一个链路覆盖组。该长度不包括前面的任何信息节。

num_links
DISPLAY 谓词在程序的缓冲区中返回的活动链路数。这是链路覆盖组的重复次数。

total_links
活动链路的总数。此数字与 num_links 成员中返回的数字相同，但当 APPC 提供的活动链路相关信息比 APPC 能够在提供的缓冲区中放置的信息更多时除外，在这种情况下，此数字更大。

对于每个活动链路，为活动链路提供 link_overlay 结构，如下文所定义。

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;

由 IBM ES for OS/2 版本 1.0 定义

成员

link_entry_len
此链路条目的大小。

link_id
本地逻辑链路站名称 (EBCDIC)。

dlc_name
数据链路控制 (DLC) 名称，设置为以下值之一：

ETHERAND
IBMTRNET
IBMPCNET
SDLC
TWINAX（不受 Host Integration Server 支持）
X25DLC
adapter_num
此链路用于连接到相邻节点的适配器号。

dest_addr_len
目标适配器地址的长度。

dest_addr
目标适配器地址。

inbound_outbound
链路的方向。值可以是：

AP_OUTBOUND
链路为出站。

AP_INBOUND
链路为入站。

state
链路的状态。链路状态可为以下值之一：

AP_CONALS_PND
启动链路的过程已启动，但 XID 协商尚未开始。

AP_XID_PND
XID 协商正在进行。

AP_CONTACT_PND
XID 协商已完成，但尚未收到来自 DLC 的最终响应。

AP_CONTACTED
该链路完全正常运行。

AP_DISC_PND
已向 DLC 发出断开链路连接的请求。

AP_DISC_RQ
操作员已请求断开链路的连接。

deact_link_flag
停用逻辑链路。

reserv3
保留字段。

num_sessions
活动会话的数目。

ru_size
RU 大小。

reserv4
保留字段。

adj_fq_cp_name
相邻节点中的完全限定 cp_name。

adj_node_type
相邻节点类型（NN、EN 或 LEN）。

cp_cp_sess_spt
指定链路是否支持 CP-CP 会话。

conn_type
指示会话激活协议遵循的是用于独立 LU 的规则还是用于依赖 LU 的规则。连接类型可以是下列其中一项：

AP_HOST_SESSION
对于依赖 LU 协议，工作站 LU 在主机上定义为依赖 LU，主机 LU 将发送会话激活请求 (BIND)，每个工作站 LU 每次只能支持一个会话。

AP_PEER_SESSION
对于独立 LU 协议，LU 可以发送 BIND，并且可以与不同伙伴建立多个会话，或者与同一个合作伙伴 LU 建立并行会话。

AP_BOTH_SESSION
连接能够支持依赖 LU 和独立 LU。

ls_role
指定链路站角色。

line_type
线路类型。

tg_number
传输组编号。

eff_capacity
支持的最高比特率传输有效容量。

conn_cost
使用此链路时每次连接产生的相对成本。

byte_cost
通过链路传输一个字节所产生的相对成本。

propagation_delay
指示信号穿越整个链路长度所花费的时间。设置为以下值之一：

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
用户定义的 TG 特征。

user_def_2
用户定义的 TG 特征。

user_def_3
用户定义的 TG 特征。

security
此链路的安全值。设置为以下值之一：

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
保留字段。

由 Host Integration Server 返回

成员

link_entry_len
此链路条目的大小。

link_id
连接名称。

dlc_name
设置为以下值之一的 DLC 名称：

IBMTRNET
SDLC
X25DLC
adapter_num
此链路用于连接到相邻节点的适配器号。始终设置为零。

dest_addr_len
目标适配器地址的长度。

dest_addr
目标适配器地址。

inbound_outbound
链路的方向。值可以是：

AP_OUTBOUND
链路为出站。

AP_INBOUND
链路为入站。

state
链路的状态。链路状态可为以下值之一：

AP_CONALS_PND
启动链路的过程已启动，但 XID 协商尚未开始。

AP_XID_PND
XID 协商正在进行。

AP_CONTACT_PND
XID 协商已完成，但尚未收到来自 DLC 的最终响应。

AP_CONTACTED
该链路完全正常运行。

AP_DISC_PND
已向 DLC 发出断开链路连接的请求。

AP_DISC_RQ
操作员已请求断开链路的连接。

deact_link_flag
停用逻辑链路。

num_sessions
活动会话的数目。

ru_size
RU 大小。

adj_fq_cp_name
相邻节点中的完全限定 cp_name。始终设置为 EBCDIC 空格。

adj_node_type
相邻节点的类型。始终设置为 AP_LEN。

cp_cp_sess_spt
指定链路是否支持 CP-CP 会话。始终设置为 AP_NO。

conn_type
指示会话激活协议遵循的是用于独立 LU 的规则还是用于依赖 LU 的规则。连接类型可以是下列其中一项：

AP_HOST_SESSION
对于依赖 LU 协议，工作站 LU 在主机上定义为依赖 LU，主机 LU 将发送会话激活请求 (BIND)，每个工作站 LU 每次只能支持一个会话。

AP_PEER_SESSION
对于独立 LU 协议，LU 可以发送 BIND，并且可以与不同伙伴建立多个会话，或者与同一个合作伙伴 LU 建立并行会话。

ls_role
指定链路站角色。

line_type
线路类型。

tg_number
传输组编号。始终设置为零。

effective_capacity
支持的最高比特率传输有效容量。始终设置为零。

conn_cost
使用此链路时每次连接产生的相对成本。始终设置为零。

byte_cost
通过链路传输一个字节所产生的相对成本。始终设置为零。

propagation_delay
指示信号穿越整个链路长度所花费的时间。此参数始终设置为 AP_PROP_DELAY_MAXIMUM。

user_def_1
用户定义的 TG 特征。始终设置为零。

user_def_2
用户定义的 TG 特征。始终设置为零。

user_def_3
用户定义的 TG 特征。始终设置为零。

security
此链路的安全值。始终设置为 AP_SEC_NONSECURE。

通过

活动链接信息

link_info_sect 语法

成员

link_overlay 语法

由 IBM ES for OS/2 版本 1.0 定义

成员

由 Host Integration Server 返回

成员

其他资源