アクティブなリンク情報

アクティブなリンクの情報は、以下で定義されているような 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 で保持されているアクティブなリンクに関する情報が多すぎて、提供されたバッファーに入りきらない場合は、この値の方が大きくなります。

アクティブなリンクごとに、アクティブなリンクに関する 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 はセッション アクティブ化要求 (BIND) を送信します。各ワークステーション LU でサポートできるセッションは一度に 1 つだけです。

AP_PEER_SESSION
独立 LU プロトコルの場合、LU では BIND を送信することができ、異なるパートナーへの複数のセッション、または同じパートナー LU への並列セッションを確立できます。

AP_BOTH_SESSION
接続では、従属 LU と独立 LU の両方をサポートできます。

ls_role
リンク ステーション ロールを指定します。

line_type
回線の種類。

tg_number
伝送グループ番号。

eff_capacity
サポートされている最高のビット レート伝送の実効容量。

conn_cost
このリンクを使用した接続時間あたりの相対コスト。

byte_cost
リンク経由で 1 バイトを送信する相対コスト。

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
隣接するノードに接続するためにこのリンクによって使用されるアダプター番号。 常に 0 に設定されます。

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 はセッション アクティブ化要求 (BIND) を送信します。各ワークステーション LU でサポートできるセッションは一度に 1 つだけです。

AP_PEER_SESSION
独立 LU プロトコルの場合、LU では BIND を送信することができ、異なるパートナーへの複数のセッション、または同じパートナー LU への並列セッションを確立できます。

ls_role
リンク ステーション ロールを指定します。

line_type
回線の種類。

tg_number
伝送グループ番号。 常に 0 に設定されます。

effective_capacity
サポートされている最高のビット レート伝送の実効容量。 常に 0 に設定されます。

conn_cost
このリンクを使用した接続時間あたりの相対コスト。 常に 0 に設定されます。

byte_cost
リンク経由で 1 バイトを送信する相対コスト。 常に 0 に設定されます。

propagation_delay
シグナルがリンクの長さの移動にかかる時間を示します。 このパラメーターは、常に AP_PROP_DELAY_MAXIMUM に設定されます。

user_def_1
ユーザー定義の TG の特性。 常に 0 に設定されます。

user_def_2
ユーザー定義の TG の特性。 常に 0 に設定されます。

user_def_3
ユーザー定義の TG の特性。 常に 0 に設定されます。

security
このリンクのセキュリティ値。 常に AP_SEC_NONSECURE に設定します。