MsSna_Connection, classe
Classe de base pour la connexion SNA.
La syntaxe suivante est simplifiée à partir du code MOF.
Syntaxe
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;
}
Propriétés
Service
Type de données : Qualificateurs de chaîne : MAXLEN(20) Type d’accès : Read-Only
Service SNA auquel cette connexion appartient.
Nom
Type de données : Qualificateurs de chaîne : clé, MAXLEN(8) Type d’accès : Read-ONly
Nom de la connexion.
Commentaire
Type de données : Qualificateurs de chaîne : MAXLEN(25) Type d’accès : Lecture/écriture
Champ de commentaire facultatif.
Adaptateur
Type de données : Qualificateurs de chaîne : MAXLEN(8) Type d’accès : Lecture/écriture
Service de liaison à utiliser par cette connexion.
RemoteEnd
Type de données : sint32 Type d’accès : lecture/écriture
Extrémité distante. Le tableau suivant décrit les valeurs possibles de RemoteEnd.
| Valeur | Description |
|---|---|
| 0 | Host |
| 1 | Homologue |
| 2 | En aval |
| 3 | PassThrough |
Pour l’accès 3270 ou LUA, veillez à définir RemoteEnd sur Hôte.
PeerRole
Type de données : chaîne Type d’accès : lecture/écriture
Rôle d’homologue. Le tableau suivant décrit les valeurs possibles de PeerRole.
| Valeur | Description |
|---|---|
| 0 | Principal |
| 1 | Secondary |
| 2 | Négociable |
| -1 | Non valide |
PeerRole s’applique uniquement aux connexions avec RemoteEnd défini sur Peer ou Passthrough.
Activation
Type de données : sint16 Type d’accès : lecture/écriture
Paramètre d’activation. Applicable uniquement si les appels sortants sont inclus dans les instructions autorisées. Le tableau suivant décrit les valeurs possibles pour Activation.
| Valeur | Description |
|---|---|
| 0 | Initial |
| 1 | OnDemand |
| 2 | Administrateur |
| 3 | Entrant |
AllowIncoming
Type de données : booléen type d’accès : lecture/écriture
true pour indiquer que les appels entrants sont autorisés ; sinon, false.
DynamicLuDef
Type de données : booléen type d’accès : lecture/écriture
true pour configurer automatiquement les LU distantes APPC lorsque les utilisateurs les demandent ; sinon, false. DynamicLuDef nécessite qu’un nœud de fin APPN ou un nœud net soit disponible sur la connexion.
PartnerConnectionName
Type de données : Qualificateurs de chaîne : MAXLEN(8), Type d’accès TOUPPERCASE : En lecture-écriture
Nom du partenaire de connexion. Valide uniquement si RemoteEnd est de passthrough.
BlockId
Type de données : Qualificateurs de chaîne : MAXLEN(3), Type d’accès TOUPPERCASE : En lecture-écriture
ID du bloc.
NodeId
Type de données : Qualificateurs de chaîne : MAXLEN(5), type d’accès TOUPPERCASE : lecture-écriture
ID de nœud local. Applicable uniquement aux connexions qui utilisent une ligne SDLC commutée (ligne téléphonique standard) pour se connecter à un système hôte.
RemoteNetName
Type de données : Qualificateurs de chaîne : MAXLEN(8), Type d’accès TOUPPERCASE : En lecture-écriture
Nom réseau du système distant. Applicable si vous utilisez des XID de format 3.
RemoteControlPoint
Type de données : Qualificateurs de chaîne : MAXLEN(8), Type d’accès TOUPPERCASE : En lecture-écriture
Point de contrôle du système de réomote. Applicable si vous utilisez des XID de format 3.
RemoteBlockId
Type de données : Qualificateurs de chaîne : MAXLEN(3), Type d’accès TOUPPERCASE : En lecture-écriture
ID de bloc distant.
RemoteNodeId
Type de données : Qualificateurs de chaîne : MAXLEN(5), type d’accès TOUPPERCASE : lecture-écriture
ID de nœud distant.
XIDFormat
Type de données : sint16 Type d’accès : lecture/écriture
Type XID. Le tableau suivant décrit les valeurs possibles pour XIDFormat.
| Valeur | Description |
|---|---|
| 0 | Format 0 |
| 3 | Format 3 |
La plupart des systèmes utilisent le format 3.
LocalNetName
Type de données : Qualificateurs de chaîne : MAXLEN(8), Type d’accès TOUPPERCASE : En lecture-écriture
Nom du réseau qui, avec LocalControlPoint, identifie un système.
LocalControlPoint
Type de données : Qualificateurs de chaîne : MAXLEN(8), Type d’accès TOUPPERCASE : En lecture-écriture
Point de contrôle qui, avec LocalNetName, identifie un système.
CompressionLevel
Type de données : sint16 Type d’accès : lecture/écriture
Type de compression utilisé par cette connexion. Le tableau suivant décrit les valeurs possibles pour CompressionLevel.
| Valeur | Description |
|---|---|
| 0 | Aucune |
| 1 | RLE |
| 2 | LZ9 |
| 3 | LZ10 |
| 4 | LZ12 |
RetryLimit
Type de données : sint16 Qualificateurs : MINVALUE(0), MAXVALUE(255) Type d’accès : En lecture-écriture
Nombre de fois où le système local tente d’envoyer des données au système distant en l’absence de réponse.
RetryDelay
Type de données : Qualificateurs de chaîne : MINVALUE(0), MAXVALUE(255), UNITS(« s ») Type d’accès : lecture-écriture
Durée pendant laquelle le système local attend une réponse à une transmission avant de réessayer.
StatusText
Type de données : Type d’accès chaîne : Read-Only
Status actuelle de la connexion. Le tableau suivant décrit les valeurs possibles de StatusText.
| Valeur | Description |
|---|---|
| 0 | Non configuré |
| 1 | Inactif |
| 2 | Entrant |
| 3 | OnDemand |
| 4 | OnDemand/Incoming |
| 5 | Pending |
| 6 | En cours d’arrêt |
| 7 | Actif |
| 8 | Error |
| 9 |
Nom
Type de données : Qualificateurs de chaîne : Type d’accès à quelque chose : lecture/écriture
Le nom de la connexion.
Méthodes
| Méthode | Description |
|---|---|
| Start | Démarre la connexion. |
| Stop | Arrête la connexion. |
| ExchangePassthroughLus | Retourne une valeur qui détermine si deux LU font partie d’une paire de connexions directes. |
Remarques
MsSna_Connection appartient à un service SNA et peut posséder 3270 unités de service.
Configuration requise
Plateformes : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 et Windows 10
Voir aussi
Classes du fournisseur WMI WMISNA
Administration et gestion - Guide du programmeur