Données pour les fichiers d’hôte
Compatibilité de la plateforme
Conversions de pages de code
Le fournisseur de données prend en charge une combinaison de jeux de caractères codés sur un octet (SBCS), de jeux de caractères de largeur mixte (MBCS), de jeux de caractères codés sur deux octets (DBCS) et de jeux de caractères Unicode - UTF8 [1208], qui est un format de transformation Unicode de 8 bits.
CCSID de l'hôte
Le fournisseur de données requiert une valeur pour le CCSID (Coded Character Set Identifier) de l'hôte avec lequel exécuter des conversions de page de codes sur des données de chaîne. La valeur CCSID de l'hôte par défaut est EBCDIC – U.S./Canada [37]. En règle générale, IBM z/OS et IBM i utilisent EBCDIC (Extended Binary Coded Decimal Interchange Code).
Page de codes PC
Le fournisseur de données requiert une valeur pour la page de codes PC avec laquelle exécuter des conversions de page de codes sur des données de chaîne. La page de codes PC par défaut est ANSI – Latin I [1252]. Généralement, les consommateurs de données utilisent soit ANSI (American National Standards Institute), soit Unicode.
Traiter le binaire comme caractère
La propriété relative au traitement du binaire en tant que caractère (CCSID 65535) indique au fournisseur de données de convertir les octets de l’hôte en provenance et à destination des chaînes de caractères Windows, en fonction du CCSID de l’hôte et de la page de codes PC. La valeur par défaut est false.
Mappage de type de données
Cette rubrique décrit tous les mappages de types de données pris en charge par MsHostFileClient.
Mappage des types de données ADO.NET
Le tableau suivant définit les mappages de types de données pris en charge entre le fournisseur de données (MsHostFileClient.HostFileType), Host File Designer (System.Type), IBM COBOL et RPG.
| HostFileType | HostFileMetaType | Restrictions | Type Host File Designer | COBOL |
|---|---|---|---|---|
| HostFileType.BigInt | System.Int64 | Integer | PIC S9(n) COMP-4 | |
| HostFileType.Char | System.String | Longueur maximale : 32 765 ; 255 | String | PIC X(n) |
| HostFileType.CharForBit | System.Byte | Longueur maximale : 32 765 | Court | PIC S9(n) COMP-4 |
| HostFileType.Date | System.DateTime | Longueur : 10 | DateTime | DATE ISO uniquement au format AAAA-MM-JJ |
| HostFileType.Decimal | System.Decimal | Précision maximale : 28 | Decimal | PIC S9(n)V9(n) COMP-3 |
| HostFileType.Double | double | Double | COMP-2 | |
| HostFileType.Graphic | System.String | Longueur maximale : 16 382 ; 127 | String | PIC G(n) |
| HostFileType.Int | System.Int32 | Integer | PIC S9(n) COMP-4 | |
| HostFileType.Numeric | System.Decimal | Précision maximale : 31 | Decimal | PIC S9(n)V9(n) COMP-3 |
| HostFileType.Real | float | Unique | COMP-1 | |
| HostFileType.SmallInt | System.Int16 | Court | PIC S9(n) COMP-4 | |
| HostFileType.Time | System.TimeSpan | Longueur : 8 | DateTime | HEURE ISO uniquement au format HH.MM.SS |
| HostFileType.Timestamp | System.DateTime | Longueur : 26 | DateTime | DATE et HEURE ISO au format AAAA-MM-JJ HH.MM.SS |
| HostFileType.UDT | System.Object | Longueur maximale : 32 739 | Byte | PIC X non traduit |
| HostFileType.VarChar | System.String | Longueur maximale : 32 739 ; 4 045 | String | PIC X(n) |
| HostFileType.VarCharForBit | System.Byte | Longueur maximale : 32 739 ; 4 045 | Byte | PIC X non traduit |
| HostFileType.VarGraphic | System.String | Longueur maximale : 16 369 ; 4 045 | PIC G(n) |
Le tableau suivant définit les mappages de types de données pris en charge entre ADO.NET (System.Data.DbType), le fournisseur de données (MsHostFileClient.HostFileType), Host File Designer (System.Type), IBM COBOL et RPG.
| DbType | HostFileMetaType | HostFileType | Restrictions | Type Host File Designer | COBOL |
|---|---|---|---|---|---|
| DbType.AnsiString | System.String | HostFileType.VarChar | Longueur maximale : 32 739 ; 4 045 | String | PIC X(n) |
| DbType.AnsiStringFixedLength | System.String | HostFileType.Char | Longueur maximale : 32 765 ; 255 | String | PIC X(n) |
| DbType.Binary | System.Byte | HostFileType.VarCharForBit | Longueur maximale : 32 739 | Byte | PIC X non traduit |
| DbType.Boolean | System.Boolean | HostFileType.SmallInt | Booléen | PIC S9(4) COMP-4 | |
| DbType.Byte | System.Byte | HostFileType.SmallInt | Court | PIC S9(n) COMP-4 | |
| DbType.Currency | System.Decimal | HostFileType.Decimal | Précision maximale : 31 | Decimal | PIC S9(n)V9(n) COMP-3 |
| DbType.Date | System.DateTime | HostFileType.Date | Longueur : 10 | DateTime | DATE ISO uniquement au format AAAA-MM-JJ |
| DbType.DateTime | System.DateTime | HostFileType.Timestamp | Longueur : 26 | DateTime | DATE et HEURE ISO au format AAAA-MM-JJ HH.MM.SS |
| DbType.Decimal | System.Decimal | HostFileType.Decimal | Précision maximale : 31 | Decimal | PIC S9(n)V9(n) COMP-3 |
| DbType.Double | double | HostFileType.Double | Double | COMP-2 | |
| DbType.Guid | System.Guid | HostFileType.VarCharForBit | Longueur maximale : 32 739 | Byte | PIC X non traduit |
| DbType.Int16 | System.Int16 | HostFileType.SmallInt | Court | PIC S9(n) COMP-4 | |
| DbType.Int32 | System.Int32 | HostFileType.Int | Integer | PIC S9(n) COMP-4 | |
| DbType.Int64 | System.Int64 | HostFileType.BigInt | Integer | PIC S9(n) COMP-4 | |
| DbType.Object | System.Object | HostFileType.VarCharForBit | Longueur maximale : 32 739 | Byte | PIC X non traduit |
| DbType.SByte | SByte | HostFileType.SmallInt | Court | PIC S9(n) COMP-4 | |
| DbType.Single | float | HostFileType.Real | Unique | COMP-1 | |
| DbType.String | System.String | HostFileType.VarChar | Longueur maximale : 32 739 ; 4 045 | String | PIC X(n) |
| DbType.StringFixedLength | System.String | HostFileType.Char | Longueur maximale : 32 765 ; 255 | String | PIC X(n) |
| DbType.Time | System.TimeSpan | HostFileType.Time | Longueur : 8 | DateTime | HEURE ISO uniquement au format HH.MM.SS |
| DbType.UInt16 | System.UInt16 | HostFileType.SmallInt | Court | PIC 9(n) COMP-4 | |
| DbType.UInt32 | System.UInt32 | HostFileType.Int | Integer | PIC 9(n) COMP-4 | |
| DbType.UInt64 | System.UInt64 | HostFileType.BigInt | Integer | PIC 9(n) COMP-4 | |
| DbType.VarNumeric | System.Decimal | HostFileType.Decimal | Decimal | PIC S9(n)V9(n) COMP-3 |
Performances
Cette rubrique contient les sections suivantes, qui vous aideront à optimiser les performances liées à l’utilisation des fournisseurs de données pour Host Files.
Configuration pour optimiser le niveau de performance
Configuration pour optimiser le niveau de performance
Pour améliorer les performances, configurez les fournisseurs en suivant les instructions indiquées ci-dessous.
Regrouper les ressources du fournisseur pour réduire le temps de démarrage de la connexion
Le regroupement des connexions est une optimisation côté client qui permet de réduire le temps de démarrage de la connexion tout en réduisant l'utilisation de la mémoire sur l'ordinateur client. Le fournisseur ADO.NET et l’adaptateur BizTalk prennent en charge le regroupement de connexions. Vous pouvez spécifier le regroupement à l’aide de la chaîne de connexion ADO.NET (Connection Pooling=True). En outre, vous pouvez configurer le regroupement à l'aide de la boîte de dialogue Avancé de l'Assistant Source de données et à l'aide de l'onglet Toutes de la boîte de dialogue Liaisons de données.
Le fournisseur gère un cache de connexions sur la base d'une propriété Taille de pool max. La taille du regroupement par défaut est de 100 connexions (Max Pool Size=100) ; vous pouvez toutefois ajuster cette valeur à l'aide de la boîte de dialogue Toutes de l'Assistant Source de données ou des liaisons de données. Il n'y a aucune limite supérieure pour la propriété Taille de pool max. Si vous configurez une valeur inférieure à 0 pour la propriété Taille de pool max, la valeur par défaut 100 est utilisée.
À titre facultatif, vous pouvez spécifier un nombre de secondes afin d'indiquer au fournisseur de données d'attendre pour établir des connexions à l'aide du regroupement côté client. Lorsque toutes les connexions d'un regroupement sont en cours d'utilisation et que le délai de connexion expire, le fournisseur de données renvoie une erreur au consommateur de données (« Connexion non disponible »). La valeur par défaut est de 15 secondes (Connect Timeout=15) ; vous pouvez toutefois ajuster cette valeur à l'aide de la boîte de dialogue Toutes de l'Assistant Source de données ou des liaisons de données. Il n'y a aucune limite supérieure pour la propriété Connect Timeout. Spécifiez la valeur -1 afin d'indiquer au fournisseur de données d’attendre indéfiniment une connexion ouverte dans le regroupement de connexions côté client.
Mesure du niveau de performances
Le fournisseur de données inclut des compteurs de performances pour mesurer le niveau de performance. Par défaut, les compteurs de performances sont désactivés. Ils peuvent être activés en attribuant la valeur 1 à la clé de Registre suivante :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Host Integration Server\Data Integration\UpdateCounters = 1
Les compteurs de performances du fournisseur de données capturent les informations relatives aux connexions ouvertes, aux instructions ouvertes, aux paquets et octets envoyés/reçus, au temps de traitement moyen de l’hôte (serveur Host), aux exécutions de commandes ainsi qu’aux extractions de données.