MsSna_Connection 類別

SNA 連線的基類。

下列語法是從 MOF 程式碼簡化的。

語法

  
class MsSna_Connection : MsSna_Config  
{  
   String Service;  
   String Name;  
   String Comment;  
   String Adapter;  
   sint32 RemoteEnd;  
   sint16 PeerRole;  
   sint16 Activation;  
   boolean AllowIncoming;  
   boolean DynamicLuDef;  
   String PartnerConnectionName;  
   String BlockId;  
   String NodeId;  
   String RemoteNetName;  
   String RemoteControlPoint;  
   String RemoteBlockId;  
   String RemoteNodeId;  
   sint16 XIDFormat;  
   String LocalNetName;  
   String LocalControlPoint;  
   sint16 CompressionLevel;  
   sint16 RetryLimit;  
   sint16 RetryDelay;  
   String StatusText;  
}  

屬性

服務
資料類型： 字串 限定詞： MAXLEN (20) 存取類型：Read-Only

此連線所屬的 SNA 服務。

名稱
資料類型： 字串 限定詞： 索引鍵、MAXLEN (8) 存取類型：Read-ONly

連接名稱。

註解
資料類型： 字串 限定詞： MAXLEN (25) 存取類型：讀取/寫入

選擇性批註欄位。

配接器
資料類型： 字串 限定詞： MAXLEN (8) 存取類型：讀取/寫入

此連線要使用的連結服務。

RemoteEnd
資料類型： sint32 存取類型：讀取/寫入

遠端端。 下表描述 RemoteEnd的可能值。

值	描述
0	Host
1	對等
2	下游
3	通道

針對 3270 或 LUA 存取，請務必將 RemoteEnd 設定為 [主機]。

PeerRole
資料類型： 字串 存取類型：讀取/寫入

對等角色。 下表描述 PeerRole的可能值。

值	描述
0	主要
1	次要
2	面議
-1	無效

PeerRole 僅適用于 RemoteEnd 設定為 Peer 或 Passthrough 的連線。

啟用
資料類型： sint16 存取類型：讀取/寫入

啟用設定。 只有在允許的指示中包含外寄通話時，才適用。 下表描述 Activation 的可能值。

值	描述
0	Initial
1	OnDemand
2	系統管理員
3	正在傳入

AllowIncoming
資料類型： 布林 存取類型：讀取/寫入

true 表示允許來電;否則為 false。

DynamicLuDef
資料類型： 布林 存取類型：讀取/寫入

true 表示當使用者要求 APPC 遠端 RU 時自動設定;否則為 false。 DynamicLuDef 要求連線上可以使用 APPN 結束節點或 Net 節點。

PartnerConnectionName
資料類型： 字串 限定詞： MAXLEN (8) 、TOUPPERCASE 存取類型：讀取/寫入

連接夥伴的名稱。 只有在 RemoteEnd 是 傳遞時才有效。

BlockId
資料類型： 字串 限定詞： MAXLEN (3) 、TOUPPERCASE 存取類型：讀取/寫入

區塊識別碼。

NodeId
資料類型： 字串 限定詞： MAXLEN (5) 、TOUPPERCASE 存取類型：讀取/寫入

本機節點識別碼。 僅適用于使用已切換 SDLC 線路的連線， (標準電話線路) 連線到主機系統。

RemoteNetName
資料類型： 字串 限定詞： MAXLEN (8) 、TOUPPERCASE 存取類型：讀取/寫入

遠端系統的網路名稱。 如果您使用格式 3 XID，則適用。

RemoteControlPoint
資料類型： 字串 限定詞： MAXLEN (8) 、TOUPPERCASE 存取類型：讀取/寫入

移轉系統的控制點。 如果您使用格式 3 XID，則適用。

RemoteBlockId
資料類型： 字串 限定詞： MAXLEN (3) 、TOUPPERCASE 存取類型：讀取/寫入

遠端區塊識別碼。

RemoteNodeId
資料類型： 字串 限定詞： MAXLEN (5) 、TOUPPERCASE 存取類型：讀取/寫入

遠端節點識別碼。

XIDFormat
資料類型： sint16 存取類型：讀取/寫入

XID 類型。 下表描述 XIDFormat的可能值。

值	描述
0	格式 0
3	格式 3

大部分的系統都使用格式 3。

LocalNetName
資料類型： 字串 限定詞： MAXLEN (8) 、TOUPPERCASE 存取類型：讀取/寫入

網路名稱以及 LocalControlPoint會識別系統。

LocalControlPoint
資料類型： 字串 限定詞： MAXLEN (8) 、TOUPPERCASE 存取類型：讀取/寫入

與 LocalNetName一起識別系統的控制點。

CompressionLevel
資料類型： sint16 存取類型：讀取/寫入

此連線所使用的壓縮類型。 下表描述 CompressionLevel的可能值。

值	描述
0	無
1	Rle
2	LZ9
3	LZ10
4	LZ12

RetryLimit
資料類型： sint16 限定詞： MINVALUE (0) 、MAXVALUE (255) 存取類型：讀取/寫入

如果沒有回應，本機系統會嘗試將資料傳送至遠端系統的次數。

RetryDelay
資料類型： 字串 限定詞： MINVALUE (0) 、MAXVALUE (255) 、UNITS (「sec」) Access Type：讀取/寫入

本機系統在重試前等候傳輸回應的時間長度。

StatusText
資料類型： 字串 存取類型：Read-Only

連線的目前狀態。 下表描述 StatusText的可能值。

值	描述
0	未設定
1	非使用中
2	正在傳入
3	OnDemand
4	OnDemand/Incoming
5	暫止
6	停止中
7	使用中
8	錯誤
9

名稱
資料類型： 字串 限定詞： 存取 類型：讀取/寫入

連線的名稱。

方法

方法	描述
開始	啟動連線。
停止	停止連線。
ExchangePassthroughLus	傳回值，判斷兩個 RU 是否屬於傳遞連線組的一部分。

備註

MsSna_Connection 屬於 SNA 服務，而且可能擁有 3270 RU。

規格需求

平臺：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11和Windows 10

另請參閱

WMISNA WMI 提供者類別
系統管理和管理程式設計指南