共用方式為


連結定義資訊

鏈接定義資訊會在 link_def_info_sect 結構中提供,如下所示。

語法

typedef struct link_def_info_sect {  
    unsigned long  link_def_init_sect_len;  
    unsigned short num_link_def;  
    unsigned short total_link_def;  
} LINK_DEF_INFO_SECT;  

成員

link_def_init_sect_len
初始連結定義資訊區段的長度,包括此參數,直到第一個連結定義重疊群組。 長度不包含任何先前的資訊區段。

num_link_def
DISPLAY 動詞在程序緩衝區傳回的連結定義數目。 這是反覆出現的連結定義覆疊次數。

total_link_def
連結定義的總數。 這個數字與num_link_def成員中傳回的數字相同,除了當APPC擁有比提供的緩衝區可容納更多的連結定義資訊時,這個數字會比較大。

針對每個連結定義,會提供連結定義的 link_def_overlay 結構,如下所示。

typedef struct link_def_overlay {  
    unsigned long  link_def_entry_len;  
    unsigned char  link_name[8];  
    unsigned char  adj_fq_cp_name[17];  
    unsigned char  adj_node_type;  
    unsigned long  dlc_name[8];  
    unsigned char  adapter_num;  
    unsigned char  dest_addr_len;  
    unsigned char  dest_addr[32];  
    unsigned char  preferred_nn_server;  
    unsigned char  auto_act_link;  
    unsigned char  tg_number;  
    unsigned char  lim_res;  
    unsigned char  solicit_sscp_session;  
    unsigned char  initself;  
    unsigned char  bind_support;  
    unsigned char  ls_role;  
    unsigned char  line_type;  
    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  reserv;  
 } LINK_OVERLAY;  

由IBM ES for OS/2 1.0 版定義

IBM ES for OS/2 1.0 版所定義的 link_def_overlay 結構包含下列成員:

link_def_entry_len
此連結定義條目的大小。

link_name
本地邏輯鏈路站名稱(EBCDIC)。

dlc_name
資料連結控制(DLC)名稱設定為以下其中一項:

  • ETHERAND
  • IBMTRNET
  • IBMPCNET
  • 軟體開發生命週期 (SDLC)
  • TWINAX (主機整合伺服器不支援)
  • X25DLC

adj_fq_cp_name
cp_name 完全合格於相鄰節點中。

adj_node_type
相鄰的節點類型(AP_ADJACENT_NN、AP_LEARN或AP_LEN)。

adapter_num
此連結所使用的 DLC 配接器號碼。

dest_addr_len
目的地配接器地址的長度。

dest_addr 目的地配接器位址。

cp_cp_sess_spt
指定連結是否支援 CP-CP 工作階段。

preferred_nn_server
指示這是否為慣用的 NN 伺服器。

auto_act_link
指出是否應該自動啟用連結。

tg_number
傳輸組號。

lim_res 指出這是有限的資源。

solicit_sscp_session
表示是否要發起 SSCP 會話。

initself
指出節點是否支援透過此連結接收INIT_SELF。

bind_support
指出是否提供 BIND 支援。

ls_role
指定連結月臺角色。

line_type
行類型。

eff_capacity
支援最高的比特率傳輸有效容量。

conn_cost
使用此連結之每個連線時間的相對成本。

byte_cost
傳輸一個位元組通過鏈路的成本相對值。

傳播延遲
指示訊號沿著鏈路傳輸所需的時間。 設定為下列其中一項:

  • AP_屬性_延遲_最小值
  • AP_PROP_DELAY_LAN
  • 通訊延遲電話
  • AP_PROP_DELAY_PKT_SWITCHED_NET
  • AP_PROP_延遲衛星
  • AP_PROP_DELAY_MAXIMUM

user_def_1
用戶定義的 TG 特性。

user_def_2
用戶定義的 TG 特性。

user_def_3
用戶定義的 TG 特性。

安全
此連結的安全性值。 設定為下列其中一項:

  • AP_SEC_NONSECURE
  • AP_SEC_PUBLIC_SWITCHED_NETWORK
  • AP_次級_地下電纜
  • AP_SEC_SECURE_CONDUIT
  • 安全受保護管道
  • AP_SEC_ENCRYPTED(加密的安全標識)
  • 保護輻射區域級別AP_SEC

由主機整合伺服器傳回

Host Integration Server 傳回的 link_def_overlay 結構包含下列成員:

link_def_entry_len
此連結定義條目的大小。

link_name
本地邏輯鏈路站名稱(EBCDIC)。

dlc_name
資料連結控制(DLC)名稱設定為以下其中一項:

  • IBMTRNET
  • 軟體開發生命週期 (SDLC)
  • X25DLC

adj_fq_cp_name
cp_name 完全合格於相鄰節點中。 一律設定為 EBCDIC 空格。

adj_node_type
相鄰的節點類型。 一律設定為 AP_LEN。

adapter_num
此連結所使用的 DLC 配接器號碼。 一律設定為零。

dest_addr_len
目的地配接器地址的長度。

dest_addr
目的地配接器位址。

cp_cp_sess_spt
指定連結是否支援 CP-CP 工作階段。 一律設定為 AP_NO。

preferred_nn_server
指示這是否為慣用的 NN 伺服器。

auto_act_link
指出是否應該自動啟用連結。

tg_number
傳輸組號。 一律設定為零。

lim_res
指出這是否是有限的資源。

solicit_sscp_session
表示是否要發起 SSCP 會話。

initself
指出節點是否支援透過此連結接收INIT_SELF。

bind_support
指出是否提供 BIND 支援。

ls_role
指定連結月臺角色。

line_type
行類型。

effective_capacity
支援最高的比特率傳輸有效容量。 一律設定為零。

conn_cost
使用此連結之每個連線時間的相對成本。 一律設定為零。

byte_cost
傳輸一個位元組通過鏈路的成本相對值。 一律設定為零。

傳播延遲
指示訊號沿著鏈路傳輸所需的時間。 設定為下列其中一項:一律設定為 AP_PROP_DELAY_MAXIMUM。

user_def_1
用戶自定義的 TG 特性。 一律設定為零。

user_def_2
用戶定義的 TG 特性。 一律設定為零。

user_def_3
用戶定義的 TG 特性。 一律設定為零。

安全
此連結的安全性值。 一律設定為 AP_SEC_NONSECURE。