Applets de commande et commandes du module PowerShell

PowerShell Module

Windows PowerShell® est un interpréteur de commandes basé sur des tâches et un langage de script conçu spécialement pour l’administration du système. Basé sur le .NET Framework, Windows PowerShell aide les professionnels de l’informatique et power users à contrôler et automatiser l’administration du système d’exploitation Windows et des applications qui s’exécutent sur Windows. Le service DRDA propose des commandes PowerShell dans le cadre d’un module PowerShell HIS 2013 commun, Microsoft.HostIntegration.PowerShell, y compris un certain nombre de commandes d’applet de commande pour ajouter/get/remove/set MsDrdaService.exe.config éléments et attributs, ainsi que des commandes pour démarrer/arrêter les écouteurs.

Applets de commande Powershell

Une applet de commande PowerShell est une commande légère utilisée dans l’environnement Windows PowerShell. Le runtime Windows PowerShell appelle ces applets de commande dans le contexte des scripts d’automatisation fournis à la ligne de commande. Le runtime Windows PowerShell les appelle également par programmation via les API Windows PowerShell.

Propriétés publiques qui définissent les paramètres disponibles pour l’utilisateur ou l’application qui exécute l’applet de commande. Les applets de commande peuvent avoir des paramètres obligatoires, nommés, positionnels et switch. Un paramètre de commutateur est un paramètre qui peut, ou non, être spécifié lors de l’exécution de la commande. Si le paramètre est spécifié, le runtime Windows PowerShell résout sa valeur comme true. Si le paramètre n’est pas spécifié, qui est généralement la valeur par défaut, la valeur du paramètre est résolue comme false. Les paramètres communs sont ajoutés à toutes les applets de commande et sont accessibles chaque fois que l’applet de commande est exécutée.

Commandes des applets de commande du module PowerShell du service DRDA

La configuration du service DRDA est stockée dans le fichier de configuration d’application (configuration d’application) MsDrdaService.exe.config et les fichiers XML associés (mappage de messages d’erreur et mappage de type de données). Au moment de l’exécution, le service DRDA surveille le fichier MsDrdaService.exe.config pour les modifications. Lorsqu’il est détecté, le service DRDA lit et utilise les informations de configuration modifiées lors du traitement de nouvelles connexions liées. Le service DRDA inclut un fichier %SNAROOT%\System\Schemas\HostIntegrationDrdaServiceConfiguration.xsd pour valider le fichier de configuration de l’application.

Les professionnels de l’informatique peuvent personnaliser la configuration du service DRDA à l’aide du module PowerShell du service DRDA Microsoft.HostIntegration.PowerShell. Les applets de commande sont regroupées en regroupements de configuration et d’opérations.

Logiciels requis

Le module PowerShell du service DRDA nécessite les produits logiciels suivants en tant que conditions préalables aux fonctionnalités.

Microsoft PowerShell 3.0 (Windows Management Framework 3.0)
- https://www.microsoft.com/download/details.aspx?id=34595

Démarrer PowerShell

Démarrez PowerShell avec des autorisations d’administrateur en exécutant l’une de ces commandes.

Dans l’écran de démarrage , cliquez avec le bouton droit sur la vignette de l’application Windows PowerShell , puis, dans la barre de l’application, cliquez sur Exécuter en tant qu’administrateur.
Dans le Gestionnaire de serveur ou le Bureau dans la barre des tâches, cliquez avec le bouton droit sur le raccourci Windows PowerShell , puis cliquez sur Exécuter en tant qu’administrateur.
Sur le Bureau, déplacez le curseur dans le coin supérieur droit, cliquez sur Rechercher, tapez PowerShell, cliquez avec le bouton droit sur la vignette de l’application Windows PowerShell , puis, dans la barre d’application, cliquez sur Exécuter en tant qu’administrateur.
À l’invite de commandes Windows PowerShell, tapez :
```
Start-Process PowerShell -Verb RunAs
```

Démarrer PowerShell ISE

Démarrez PowerShell ISE (environnement de script intégré) avec l’autorisation Administrateur en exécutant l’une de ces commandes.

Dans l’écran d’accueil , tapez ISE, cliquez avec le bouton droit sur la vignette Windows PowerShell ISE , puis, dans la barre d’application, cliquez sur Exécuter en tant qu’administrateur.
Dans la barre des tâches, cliquez avec le bouton droit sur Windows PowerShell , puis cliquez sur Exécuter ISE en tant qu’administrateur.
Dans le menu Outils du Gestionnaire de serveur, sélectionnez Windows PowerShell ISE.
À l’invite de commandes Windows PowerShell, tapez :
```
Start-Process PowerShell_ISE -Verb RunAs
```

Définir le chemin du module

Le module PowerShell du service DRDA doit se trouver dans le chemin du module. Lors de l’installation du service DRDA à l’aide de l’MsDrdaService.MSI autonome, vous devez définir manuellement le chemin du module à l’aide de PowerShell ou de PowerShell ISE.

À l’invite de commandes Windows PowerShell ou PowerShell ISE , tapez la commande suivante, puis cliquez sur Entrée.

Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"

Tapez la commande Get-Module suivante, puis cliquez sur Entrée.
```
Get-Module Microsoft.HostIntegration.PowerShell
```

Vérifiez les informations suivantes.

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     9.0.1000.0 Microsoft.HostIntegration.PowerS... {Add-HisDrdaApplicationEncoding, Remove-HisDrdaApplicationEncoding, Get-HisDrdaApplicationEncoding, Add-HisDrdaCollationName...}

Obtenir des commandes de module

À l’invite de commandes Windows PowerShell ou PowerShell ISE, tapez la commande suivante, puis cliquez sur Entrée.
```
Get-Command -Module Microsoft.HostIntegration.PowerShell
```
Vérifiez les informations suivantes.

Commandes du service DRDA

Les commandes d’applet de commande Microsoft.HostIntegration.PowerShell suivantes sont à utiliser avec le service DRDA.

Type de Commande	Nom	ModuleName
Cmdlet	Add-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageBindProcessing	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageProcedureCache	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaService	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaSqlServerConnection	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaSqlTransform	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaConsoleTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaEtwTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaEventLogTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaPackageBindProcessing	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaPackageProcedureCache	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaService	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaSqlServerConnection	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaSqlTransform	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaTextTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Start-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Stop-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell

Tableau 1. Liste des commandes PowerShell du service DRDA.

Traitement de liaison de service DRDA et de liaison de package

La connectivité du service DRDA et la liaison de package comprennent : (1) Connexions de service DRDA à DRDA, (2) Connexions de service à SQL Server DRDA, (3) connexions de service DRDA à service DRDA et (4) traitement de liaison de package de service DRDA (y compris les transformations de syntaxe SQL).

Set-HisDrdaService

Cette applet de commande Set-HisDrdaService configure le service DRDA pour les connexions client DRDA liées.

Syntaxe

Set-HisDrdaService [-PartnerServers<string>] [-Port<uint32>] [-IsPrimary ] [-UseSsl ] [-PingInterval<uint32>] [-EnablePerformanceCounters ] [-AllowClientIpAddresses<string>] [-SslCertificatePath<string>] [<CommonParameters>]

Paramètres

Le paramètre AllowClientIpAddresses limite le service DRDA à accepter les connexions réseau TCP/IP liées à partir d’une liste d’ordinateurs clients DRDA AR connus. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui permet au service DRDA de répondre à toutes les demandes de connexion clientes liées. La liste est composée d’une adresse TCP/IP ou d’un alias délimité par des points-virgules. L’adresse TCP/IP peut être définie au format IPv4 ou IPv6. Par exemple, 123.34.45.57 ; 123.34.45.58 définit une liste de clients valide au format d’adresse réseau IPv4.

Le paramètre EnablePeformanceCounters indique au service DRDA de collecter des informations dans des compteurs de performances. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

Le paramètre IsPrimary indique au service DRDA s’il doit fonctionner dans un rôle principal au sein d’un groupe de serveurs. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est true. Le serveur principal répond à toutes les demandes du client AR DRDA en traitant EXCSAT (attributs Exchange Server), ACCSEC (sécurité d’accès) et ACCRDB (base de données relationnelle Access), y compris le renvoi d’un SRVLST (liste de serveurs) sur le ACCRDBRM (message de réponse ACCRDB). La liste des serveurs contient une liste de priorité pondérée des serveurs principaux (valeur pondérée la plus élevée) et des serveurs secondaires (valeurs pondérées les plus faibles), pour informer les clients AR DRDA auxquels l’ordinateur de service DRDA doit se connecter

Le paramètre PartnerServers définit la liste des ordinateurs serveurs secondaires. Ce paramètre facultatif est requis quand isPrimary=false et accepte une valeur de chaîne . La valeur par défaut est une chaîne vide. La liste est composée d’une adresse TCP/IP ou d’un signe deux-points séparés par un numéro de port TCP/IP. L’adresse TCP/IP peut être définie au format IPv4 ou IPv6. La liste peut contenir plusieurs ordinateurs serveur partenaires délimités par des points-virgules. Par exemple, 123.34.45.57:446 ; 123.34.45.58:446 définit une liste de serveurs partenaires valide au format d’adresse réseau IPv4.

Le paramètre PingInterval indique au service DRDA la fréquence à laquelle surveiller l’intégrité des ordinateurs serveurs partenaires, en exécutant un flux EXCSAT (attribut Exchange Server) et en vérifiant un EXCSATRD (données de réponse EXCSAT). Ce paramètre facultatif accepte une valeur entière . La valeur par défaut est de 1 0000 millisecondes (10 secondes).

Le paramètre de port définit le numéro de port TCP/IP sur lequel le service DRDA doit écouter les demandes de connexion client de demandeur d’application DRDA liées. Ce paramètre facultatif accepte une valeur entière . La valeur par défaut est 446.

Le paramètre SslCertificatePath spécifie le nom commun du certificat SSL ou TLS (CN). Ce paramètre facultatif est obligatoire lorsque vous utilisezSSL=true et accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Le paramètre UseSSL indique au service DRDA d’utiliser ssl (Secure Sockets Layer) version 3.0 et TLS (Transport Layer Security) version 1.0 lors de la réponse aux connexions réseau TCP/IP liées. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446

Get-HisDrdaService

Cette applet de commande Get-HisDrdaService obtient les paramètres de configuration du service DRDA pour les connexions clientes DRDA liées.

Syntaxe

Get-HisDrdaService [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-HisDrdaService retourne un objet avec des propriétés : AllowClientIpAddresses (chaîne) ; IsPrimary (booléen) ; PartnerServers (chaîne) ; EnablePerformanceCounters (booléen) ; PingInterval (entier) ; Port (entier) ; SslCertificatePath (chaîne) ; et UseSsl (booléen).

Exemple

L’exemple de commande suivant obtient les valeurs par défaut.

Get-HisDrdaService

AllowClientIpAddresses    :
IsPrimary                 : True
PartnerServers            :
EnablePerformanceCounters : false
PingInterval              : 10000
Port                      : 446
SslCertificatePath        :
UseSsl                    : false

Set-DrdaSqlServerConnection

Cette applet de commande Set-DrdaSqlServerConnection configure le service DRDA pour les connexions SQL Server hors limites.

Syntaxe

Set-DrdaSqlServerConnection [-MappedAuthenticationDomain<string>] [-AuthenticationLookupTimeoutDuration<string>] [-AuthenticationLookupRetryCount<uint32>] [-SecurityTokenTimeoutDuration<string>] [-RollbackTransactionOnError] [-ClientApplicationName<ClientApplicationName] [-DefaultCollationName<> string>] [-ConnectionString <string>] [-StoredProcedureCallTimeout<uint32>] [-HostInitiatedAffiliateApplication<string>] [-WindowsInitiatedAffiliateApplication<string>] [-EnableArithAbort ] [<CommonParameters>]

Paramètres

Le paramètre AuthenticationLookupRetryCount indique au service DRDA le nombre de tentatives de demande de recherche d’authentification de sécurité avant d’échouer. Ce paramètre facultatif accepte une valeur entière . La valeur par défaut est 3 nouvelles tentatives

Le paramètre AuthenticationLookupTimeoutDuration indique au service DRDA la durée d’attente d’une demande de recherche d’authentification de sécurité avant d’échouer. Ce paramètre facultatif accepte une valeur de chaîne représentant une valeur de durée XML. La valeur par défaut est PT30S (Période de temps est de 30 secondes). La valeur de durée est spécifiée sous la forme PnYnMnDTnHnMnS. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration des connexions SQL Server.

Le paramètre ClientApplicationName indique au service DRDA comment définir la propriété de connexion nom de l’application cliente SQL. Ce paramètre facultatif accepte une valeur de chaîne énumérée. La valeur par défaut est vide. Spécifiez externalName pour indiquer au service DRDA d’utiliser les octets 1-8 du nom externe DRDA (EXTNAM) représentant le nom du travail, de la tâche ou du processus du programme client AR DRDA. Spécifiez transactionIdentifier pour indiquer au service DRDA d’utiliser les octets 5-8 de l’EXTNAM représentant le nom de l’identificateur de transaction du programme client AR DRDA lors de l’exécution dans CICS pour z/OS.

Le paramètre ConnectionString définit la liste des paires nom et valeur d’argument à utiliser par le service DRDA dans la définition d’un fournisseur de données Microsoft ADO.NET Framework pour l’objet de connexion SQL Server. Ce paramètre obligatoire accepte une valeur de chaîne . La valeur par défaut est Data Source= ; Security=True intégré ; MultipleActiveResultSets=True. Pour plus d’informations, consultez Intégration des données (déploiement), Service DRDA, Configuration des connexions SQL Server.

Le paramètre DefaultCollationName indique au service DRDA d’ajouter une clause SQL Server COLLATE (collation_name), lors de la transformation d’une instruction DB2 SELECT avec la clause ORDER BY en instruction SQL Server SELECT avec la clause ORDER BY. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est SQL_Latin1_General_CP1_CI_AS. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration du mappage des classements.

Le paramètre EnableArithAbort indique au service DRDA de émettre l’instruction SET ARITHABORT au moment de la connexion, de demander à SQL Server d’arrêter une requête lorsqu’une erreur de dépassement de capacité ou de division par zéro se produit pendant l’exécution de la requête. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

Le paramètre HostInitiatedAffiliateApplication définit le nom de l’application affiliée que le service DRDA doit utiliser avec Microsoft Enterprise Single Sign-On pour mapper les informations d’identification client DRDA AR liées à un utilisateur de domaine Windows Active Directory, lorsque le client SQL utilise l’authentification Windows. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui indique au service DRDA de ne pas utiliser l’authentification ESSO initiée par l’hôte. Lorsque vous utilisez l’authentification ESSO initiée par l’hôte, vous devez spécifier Integrated Security=true dans la chaîne de connexion SQL Server.

Le paramètre MapAuthenticationDomain indique au service DRDA auquel le domaine Microsoft Windows Active Directory doit mapper les informations d’identification du client DRDA liées (nom d’utilisateur et mot de passe), lors de la connexion à SQL Server configurée pour l’authentification Windows à l’aide de l’interface SSPI (Security Support Provider Interface) intégrée, mais pas lors de l’utilisation de l’authentification unique Microsoft Enterprise. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Le paramètre RollbackTransactionOnError indique au service DRDA d’exécuter un ROLLBACK en suivant une erreur de base de données SQL Server négative. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est true.

Le paramètre SecurityTokenTimeout indique au service DRDA de conserver un jeton de sécurité pendant une durée donnée, après quoi obtenir un nouvel identificateur client Windows (CID). Ce paramètre facultatif accepte une valeur de durée . La valeur par défaut est PT8H (période de temps est de 8 heures). La valeur de durée est spécifiée sous la forme PnYnMnDTnHnMnS. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration des connexions SQL Server.

Le paramètre WindowsInitiatedAffiliateApplication définit le nom de l’application affiliée que le service DRDA doit utiliser avec Microsoft Enterprise Single Sign-On pour mapper l’utilisateur de domaine Windows Active Directory à des informations d’identification SQL Client hors limites, lorsque le client SQL utilise l’authentification SQL Server. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui indique au service DRDA de ne pas utiliser l’authentification ESSO lancée par Windows. Lorsque vous utilisez l’authentification ESSO lancée par Windows, vous devez spécifier Integrated Security=false dans la chaîne de connexion SQL Server.

Le paramètre StoredProcedureCallTimeout indique au service DRDA la durée (en secondes) d’attendre que SQL Server traite une instruction CALL pour exécuter une procédure stockée, avant de terminer la tentative et de générer une erreur. Ce paramètre facultatif accepte une valeur entière . Les valeurs valides sont supérieures ou égales à 0 et inférieures ou égales à 2147483647. La valeur 0 indique aucune limite (une tentative d’exécution d’une commande attend indéfiniment). La valeur par défaut est de 30 secondes.

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Avertissement

Cet exemple ou conseils référence des informations sensibles, telles qu’une chaîne de connexion ou un nom d’utilisateur et un mot de passe. Ne codez jamais en dur ces valeurs dans votre code et veillez à protéger les données confidentielles à l’aide de l’authentification la plus sécurisée disponible. Pour plus d’informations, consultez la documentation suivante :

Set-HisDrdaSqlServerConnection -AuthenticationLookupRetryCount 3 -AuthenticationLookupTimeoutDuration PT30S -ClientApplicationName empty -ConnectionString "Data Source=localhost; Integrated Security=True; MultipleActiveResultSets=True" -DefaultCollationName SQL_Latin1_General_CP1_CI_AS -RollbackTransactionOnError -SecurityTokenTimeoutDuration PT8H -StoredProcedureCallTimeout 30

Get-DrdaSqlServerConnection

Cette applet de commande Get-DrdaSqlServerConnection obtient les paramètres de configuration du service DRDA pour les connexions SQL Server hors limites.

Syntaxe

Get-DrdaSqlServerConnection [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-DrdaSqlServerConnection retourne un objet avec des propriétés : ArithAbort (booléen) ; AuthenticationLookupTimeout (chaîne) ; AuthenticationLookupRetryCount (entier) ; ClientApplicationName (chaîne) ; ConnectionString (chaîne) ; DefaultCollationName (chaîne) ; HostInitiatedAffiliateApplication (string) ; MapAuthenticationDomain (chaîne) ; RollbackTransactionOnError (booléen) ; SecurityTokenTimeoutSeconds (chaîne) ; StoredProcedureCallTimeoutSeconds (integer) ; et WindowsInitiatedAffiliateApplication (chaîne).

Exemple

L’exemple de commande suivant obtient les valeurs par défaut.

Get-HisDrdaSqlServerConnection

ArithAbort                           :
AuthenticationLookupTimeout          : PT30S
AuthenticationLookupRetryCount       : 3
ClientApplicationName                :
ConnectionString                     : Data Source=localhost;Integrated Security=True;MultipleActiveResultSets=True
DefaultCollationName                 : SQL_Latin1_General_CP1_CI_AS
HostInitiatedAffiliateApplication    :
MappedAuthenticationDomain           :
RollbackTransactionOnError           : true
SecurityTokenTimeoutSeconds          : PT8H
StoredProcedureCallTimeoutSeconds    : 30
WindowsInitiatedAffiliateApplication :

Set-DrdaPackageBindProcessing

Cette applet de commande Set-DrdaPackageBindProcessing configure le service DRDA pour le traitement des packages SQL statiques DRDA dans des procédures stockées SQL Server.

Syntaxe

Set-DrdaPackageBindProcessing [-CreatePackageProcedureWithCustomSqlScripts ] [-PackageProcedureSchemaList <string>] [-CreatePackageProcedure ] [-CreatePackageXmlXml ] [-PackageXmlFormat <PackageXmlFormat>] [-PackageXmlLocation <string>] [-StoredProcedureNameSeparator <string>] [-CreatePackageProcedureWithExtendededProperties ] [<CommonParameters>]

Paramètres

Le paramètre CreatePackageProcedure indique au service DRDA de traiter un flux BGNBND unique en une procédure stockée SQL Server, en transformant les instructions d’origine définies par le DRDA BNDSQLSTT dans la syntaxe SQL Server correspondante. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est true.

Le paramètre CreatePackageProcedureWithCustomSqlScripts indique au service DRDA de traiter DRDA BGNBND et BNDSQLSTT via un composant d’écouteur de liaison de package personnalisé externe. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

Le paramètre CreatePackageProcedureWithExtendedProperties indique au service DRDA de conserver les options de liaison de package BGNBND en tant que propriétés étendues sur la procédure stockée SQL Server. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

Le paramètre CreatePackageXml indique au service DRDA de traiter un flux BGNBND unique dans un fichier XML de package SQL statique pour DB2, en conservant les options et instructions de liaison d’origine définies par les flux BNDSQLSTT DRDA. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false.

PackageProcedureSchemaList indique au service DRDA de localiser la procédure stockée SQL Server cible dans d’autres schémas. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide. La chaîne est composée d’un nom de schéma SQL Server séparé par des virgules. Le paramètre packageProcedureSchemaList est similaire à l’instruction IBM DB2 for z/OS CURRENT PACKAGESET et à l’instruction SET CURRENT PACKAGESET.

Le paramètre PackageXmlFormat indique au service DRDA d’écrire le fichier SQL statique pour DB2 XML au format v90 ou v85. Ce paramètre facultatif accepte une valeur de chaîne énumérée de v85 ou v90. La valeur par défaut est v90.

Le paramètre PackageXmlLocation indique au service DRDA où écrire le fichier XML de package SQL statique pour DB2. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est c :\temp.

Le paramètre StoredProcedureNameSeparator indique au service DRDA quel caractère de séparation utiliser lors du mappage d’un nom de package DRDA à un nom de procédure stockée SQL Server. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est un caractère de trait de soulignement (_).

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Set-HisDrdaPackageBindProcessing -CreatePackageProcedure -PackageXmlFormat v90 -PackageXmlLocation c:\temp -StoredProcedureNameSeparator _

Get-HisDrdaPackageBindProcessing

Cette applet de commande Get-HisDrdaPackageBindProcessing obtient les paramètres de configuration du service DRDA pour le traitement des packages SQL statiques DRDA dans des procédures stockées SQL Server.

Syntaxe

Get-HisDrdaPackageBindProcessing [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-HisDrdaPackageBindProcessing retourne un objet avec des propriétés : CreatePackageProcedure (booléen) ; CreatePackageXml (booléen) ; PackageXmlFormat (chaîne) ; PackageXmlLocation (chaîne) ; StoredProcedureNameSeparator (string) ; CreatePackageProcedureWithExtendedProperties (Boolean) ; CreatePackageProcedureWithCustomSqlScripts (booléen) ; et PackageProcedureSchemaList (chaîne).

Exemple

L’exemple de commande suivant obtient les valeurs par défaut.

Get-HisDrdaPackageBindProcessing

CreatePackageProcedure                       : true
CreatePackageXml                             : false
PackageXmlFormat                             : v90
PackageXmlLocation                           : c:\temp
StoredProcedureNameSeparator                 : _
CreatePackageProcedureWithExtendedProperties : false
CreatePackageProcedureWithCustomSqlScripts   : false
PackageProcedureSchemaList                   :

Set-HisDrdaPackageProcedureCache

Cette applet de commande Set-HisDrdaPackageProcedureCache configure le service DRDA pour la mise en cache des métadonnées pour la procédure stockée SQL Server avec laquelle vérifier le type d’instruction, le type de curseur, les types de données de paramètre et d’autres attributs.

Syntaxe

<chaîne> Set-HisDrdaPackageProcedureCache -FlushTimeSpan [<CommonParameters>]

Paramètres

Le paramètre FlushTimeSpan indique au service DRDA de vider le cache de procédure de package après un intervalle de temps spécifié. Ce paramètre facultatif accepte une valeur de chaîne représentant une valeur de durée XML. La valeur par défaut est P1D (période de temps est de 1 jour). La valeur de durée est spécifiée sous la forme PnYnMnDTnHnMnS. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration du traitement de liaison de package.

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D

Get-HisDrdaPackageProcedureCache

Cette applet de commande Get-HisDrdaPackageProcedureCache obtient les paramètres de configuration du service DRDA pour mettre en cache les métadonnées de la procédure stockée SQL Server avec laquelle vérifier le type d’instruction, le type de curseur, les types de données de paramètre et d’autres attributs.

Syntaxe

Get-HisDrdaPackageProcedureCache [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-HisDrdaPackageProcedureCache retourne un objet avec la propriété : FlushTimeSpan (chaîne).

Exemple

L’exemple de commande suivant obtient les valeurs par défaut.

Get-HisDrdaPackageProcedureCache

FlushTimeSpan
-------------
P1D

Set-HisDrdaSqlTransform

Cette applet de commande Set-DrdaSqlTransform configure le service DRDA pour utiliser des transformations SQL internes ou externes basées sur CLR pour convertir la syntaxe de fonction DB2 en syntaxe de fonction T-SQL SQL SQL Server.

Syntaxe

Set-DrdaSqlTransform [-EnableUnicodeOutput] [-Type<SqlTransforms>] [<CommonParameters>]

Paramètres

Le paramètre EnableUnicodeOutput indique au service DRDA d’encoder la sortie du transformateur SQL CLR dans Unicode ou ANSI. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est false, ce qui indique au service DRDA de générer des chaînes ANSI CHAR et VARCHAR.

Le paramètre Type indique au service DRDA d’utiliser des transformations SQL internes ou CLR externes. Ce paramètre facultatif accepte une valeur type de service ou clr. La valeur par défaut est Service.

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Set-HisDrdaSqlTransform -Type Service

Get-HisDrdaSqlTransform

Cette applet de commande Get-HisDrdaSqlTransform obtient les paramètres de configuration du service DRDA pour utiliser des transformations SQL internes ou externes basées sur CLR pour convertir la syntaxe de fonction DB2 en syntaxe de fonction T-SQL SQL SQL Server.

Syntaxe

Get-HisDrdaSqlTransforms [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-HisDrdaSqlTransforms retourne un objet avec des propriétés : Type (SqlTransforms) ; et EnableUnicodeOutput (booléen).

Exemple

L’exemple de commande suivant obtient les valeurs par défaut.

Get-HisDrdaSqlTransform

Type
----
Service

EnableUnicodeOutput
-------------------
False

Mappage d’alias de base de données

Les bases de données IBM DB2 et Microsoft SQL Server utilisent une terminologie différente pour les objets de nommage, comme indiqué dans le tableau suivant définissant l’identificateur d’objet en trois parties complet pour une table. Le service DRDA peut mapper des noms de catalogue et de schéma DB2 aux noms de catalogue et de schéma SQL Server. Pour plus d’informations, consultez Configuration des mappages d’alias de base de données.

Add-HisDrdaDatabaseAlias

Cette applet de commande Add-HisDrdaDatabaseAlias configure le service DRDA pour le mappage des noms de catalogue et de schémas entrants aux noms de catalogue et de schéma sortants, à utiliser lors de l’exécution de packages SQL statiques pour les commandes DB2 mappées aux procédures stockées SQL Server.

Syntaxe

Add-HisDrdaDatabaseAlias -SourceLocation<string> -SourceCollection<string> -TargetDatabase<string> -TargetSchema<string> [<CommonParameters>]

Paramètres

Le paramètre SourceLocation définit un RDBNAM DRDA lié (nom de la base de données relationnelle) que le service DRDA doit utiliser lors du mappage à un nom de base de données SQL Server hors limites. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui désigne n’importe quelle valeur.

Le paramètre SourceCollection définit un DRDA COLID (Identificateur de collection) lié que le service DRDA doit utiliser lors du mappage à un nom de schéma SQL Server sortant. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui désigne n’importe quelle valeur.

Le paramètre TargetDatabase définit un nom de base de données SQL Server sortant que le service DRDA doit utiliser lors du mappage à partir d’une valeur RDBNAM DRDA liée. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui désigne n’importe quelle valeur.

Le paramètre TargetSchema définit un nom de schéma SQL Server sortant que le service DRDA doit utiliser lors du mappage à partir d’une valeur DRDA COLID liée. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide, qui désigne n’importe quelle valeur.

Exemple

L’exemple de commande suivant ajoute des exemples de valeurs.

Add-HisDrdaDatabaseAlias -SourceCollection DSN8HC91 -SourceLocation CONTOSO -TargetDatabase ContosoRetailDW -TargetSchema DSN8910

Get-HisDrdaDatabaseAlias

Cette applet de commande Get-HisDrdaDatabaseAlias obtient les paramètres de configuration du service DRDA pour mapper les noms de catalogue et de schémas entrants aux noms de catalogue et de schéma sortants, à utiliser lors de l’exécution de packages SQL statiques pour les commandes DB2 mappées aux procédures stockées SQL Server.

Syntaxe

Get-HisDrdaDatabaseAlias [<CommonParameters>]

Paramètres

Aucun.

Sorties

Cette applet de commande Get-HisDrdaDatabaseAlias retourne un objet avec une collection de propriétés : SourceLocation (chaîne) ; SourceCollection (chaîne) ; TargetDatabase (chaîne) ; et TargetSchema (chaîne).

Exemple

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaDatabaseAlias

SourceLocation
--------------
CONTOSO

SourceCollection
----------------
DSN8HC91

TargetDatabase
--------------
ContosoRetailDW

TargetSchema
------------
DSN8910

Conversions de date et d’heure du service DRDA

Le service DRDA met en forme des valeurs d’heure de date littérale de chaîne à partir de la source et dans les formats cibles lors du traitement d’instructions SQL dynamiques et statiques, pour des types de données de date et de caractères spécifiques.

Add-DrdaDatetimeFormat

Cette applet de commande Add-DrdaDatetimeFormat configure le service DRDA pour le traitement des valeurs de date littérales de chaîne dans DB2 et SQL Server DATE, CHAR (10) et les types de données VARCHAR (10), à convertir du format de date DB2 au format de date SQL Server et à convertir du format de date SQL Server au format de date DB2. DateMasks contient un ou plusieurs éléments dateMask pour définir des mappages de dates. L’élément dateMask contient une base de données db2ToSql ou sqlToDb2 pour indiquer la direction, ainsi qu’une sourceFormat et un targetFormat pour spécifier le mappage. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration des conversions de date et d’heure.

Syntaxe

<conversion> Add-DrdaDatetimeFormat -Conversion -DateFormat <DateFormats> [<CommonParameters>]

< > conversion Add-DrdaDatetimeFormat -Conversion -TimeFormat <TimeFormats> [<CommonParameters>]

<conversion> Add-DrdaDatetimeFormat -Conversion -DateTimeFormat <DateTimeFormats> [<CommonParameters>]

Paramètres

Le paramètre conversion définit la direction DB2-to-SQL ou SQL-to-DB2. Ce paramètre requis accepte une valeur de conversion énumérée . Spécifiez Db2toSql pour indiquer au service DRDA de lire pour convertir le format DateTime lié. Spécifiez SqlToDb2 pour indiquer au service DRDA d’écrire pour convertir le format DateTime sortant.

Le paramètre DateFormat définit le type de format. Ce paramètre obligatoire accepte une valeur DateFormat énumérée.

Le paramètre TimeFormat définit le type de format. Ce paramètre obligatoire accepte une valeur TimeFormat énumérée.

Le paramètre DateTimeFormat définit le type de format. Ce paramètre obligatoire accepte une valeur DateTimeFormat énumérée.

Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration des conversions de date et d’heure.

Exemple

L’exemple de commande suivant définit un exemple de valeur Date.

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa

L’exemple de commande suivant définit un exemple de valeur Time.

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod

L’exemple de commande suivant définit un exemple de valeur Date.

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat

Get-HisDrdaDatetimeFormat

Cette applet de commande Get-HisDrdaDatetimeFormat obtient les paramètres de configuration du service DRDA pour le traitement des valeurs de date littérale de chaîne dans DB2 et SQL Server DATE, CHAR (10) et les types de données VARCHAR (10), pour passer du format de date DB2 au format de date SQL Server et à convertir du format de date SQL Server au format de date DB2.

Syntaxe

Get-HisDrdaDatetimeFormat -DateTime<DateTime> [<CommonParameters>]

Paramètres

Le paramètre DateTime indique au service DRDA de retourner une conversion de format configurée. Ce paramètre obligatoire accepte une valeur DateTime énumérée . Il n’existe aucune valeur par défaut . Spécifiez Date pour indiquer au service DRDA de retourner la conversion de format Date configurée. Spécifiez time to instruct the DRDA Service to return the configure Time format conversion. Spécifiez DateTime pour indiquer au service DRDA de retourner la conversion de format DateTime configurée.

Sorties

Cette applet de commande Get-HisDrdaDatetimeFormat retourne un objet avec une collection de propriétés : Db2ToSql (chaîne) ; et SqlToDb2 (chaîne).

Exemple

L’exemple de commande suivant obtient les valeurs Date par défaut.

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
Iso

SqlToDb2
--------
Iso

L’exemple de commande suivant obtient les valeurs time par défaut.

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
HmsColong
HmsPeriod

SqlToDb2
--------
HmsColon

L’exemple de commande suivant obtient les valeurs DateTime par défaut.

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
Db2TimestampFormat

SqlToDb2
--------
Db2TimestampFormat

Remove-HisDrdaDatetimeFormat

Cette applet de commande Remove-HisDrdaDatetimeFormat supprime un ou plusieurs paramètres de configuration du service DRDA pour le traitement des valeurs de date littérale de chaîne dans DB2 et SQL Server DATE, CHAR (10) et les types de données VARCHAR (10), pour convertir du format de date DB2 au format de date SQL Server et pour convertir du format de date SQL Server au format de date DB2.

Syntaxe

Remove-HisDrdaDatetimeFormat -DateTime<DateTime> -Conversion<conversion> -Chaîne de format<> [<CommonParameters>]

Paramètres

Le paramètre DateTime indique au service DRDA de supprimer une conversion de format configurée. Ce paramètre obligatoire accepte une valeur DateTime énumérée . Il n’existe aucune valeur par défaut . Spécifiez Date pour indiquer au service DRDA de supprimer la conversion de format Date configurée. Spécifiez time to instruct the DRDA Service to remove the configure Time format conversion. Spécifiez DateTime pour indiquer au service DRDA de supprimer la conversion de format DateTime configurée.

Le paramètre Format définit le type de format. Ce paramètre obligatoire accepte une valeur DateFormat, TimeFormat ou DateTimeFormat énumérée.

Exemple

L’exemple de commande suivant supprime un exemple de valeur Date.

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Date -Format Usa

L’exemple de commande suivant définit un exemple de valeur Time.

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Time -Format HmsPeriod

L’exemple de commande suivant définit un exemple de valeur Date.

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime DateTime -Format IsoTimestampFormat

Encodages de service DRDA

Le service DRDA mappe les pages de codes et prend en charge les conversions de pages de codes personnalisées à l’aide d’un composant HIS Encoder sous-jacent et des composants système NLS (National Language Support). À l’aide de Microsoft Windows Update, vous pouvez installer des modules linguistiques Windows supplémentaires qui incluent des bibliothèques de conversion de pages de codes NLS Windows. Si vous le souhaitez, l’encodeur HIS peut charger une page de codes NLS personnalisée en fonction des éléments codePage définis dans la partie codePages du fichier MsDrdaService.exe.config. L’encodeur HIS peut personnaliser les points de code de carte dans les pages de code NLS standard et NLS personnalisées basées sur les éléments ebcdicToUnicodeConversion définis dans la partie codePages du fichier MsDrdaService.exe.config. Pour plus d’informations et la description des valeurs, consultez Configuration des encodages de service.

Add-HisCustomCodePage

Cette applet de commande Add-HisCustomCodePage configure le service DRDA pour indiquer au composant HIS Encoder de charger un fichier de conversion de page de codes système NLS (Windows National Language Support) personnalisé.

Syntaxe

Add-HisCustomCodePage -CodePage<uint32> -Name<string> -NlsCodePage<uint32> [-Description<string>] [<CommonParameters>]

Paramètres

Le paramètre CodePage indique à l’encodeur HIS de charger un fichier de page de codes NLS personnalisé numéroté. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 0.

Le paramètre Name nomme la page de codes NLS personnalisée que l’encodeur HIS doit charger en fonction du numéro de page de codes NLS personnalisé défini. Ce paramètre obligatoire accepte une chaîne. La valeur par défaut est une chaîne vide.

Le paramètre NlsCodePage définit le numéro de page de codes NLS standard que l’encodeur HIS doit remplacer par le numéro de page de codes personnalisé. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 0.

Le paramètre Description décrit la page de codes NLS personnalisée que l’encodeur HIS doit charger en fonction du numéro de page de codes NLS personnalisé défini. Ce paramètre facultatif accepte une chaîne. La valeur par défaut est une chaîne vide.

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"

Get-HisCustomCodePage

Cette applet de commande Get-HisCustomCodePage obtient les paramètres de configuration du service DRDA pour indiquer au composant HIS Encoder de charger un fichier de conversion de page de codes système NLS (Windows National Language Support) personnalisé.

Syntaxe

Get-HisCustomCodePage [-CodePage<uint32>] [-Name<string>] [-NlsCodePage<uint32>] [<CommonParameters>]

Paramètres

Le paramètre CodePage indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce fichier de page de codes NLS personnalisé numéroté. Ce paramètre facultatif accepte un entier. La valeur par défaut est 0.

Le paramètre Name indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce nom de page de codes NLS personnalisé. Ce paramètre facultatif accepte une chaîne. La valeur par défaut est une chaîne vide.

Le paramètre NlsCodePage indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce numéro de page de codes personnalisé. Ce paramètre facultatif accepte un entier. La valeur par défaut est 0.

Sorties

Cette applet de commande Get-HisCustomCodePage retourne un objet avec des propriétés : Name (chaîne) ; CodePage (entier) ; NlsCodePage (entier) ; et Description (chaîne).

Exemple

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140

Name
----
Custom21140

CodePage
--------
21140

Description
-----------
Custom code based on 1140

NlsCodePage
1140

Remove-HisCustomCodePage

Cette applet de commande Remove-HisCustomCodePage supprime les paramètres de configuration du service DRDA pour demander au composant HIS Encoder de charger un fichier de conversion de page de codes système NLS (Windows National Language Support) personnalisé.

Syntaxe

chaîne> Remove-HisCustomCodePage [-Name] <[<CommonParameters>]

Paramètres

Le paramètre Name indique au service DRDA de supprimer les paramètres de configuration à l’aide du nom de page de codes NLS personnalisé. Ce paramètre obligatoire accepte une chaîne. La valeur par défaut est une chaîne vide.

Exemple

L’exemple de commande suivant supprime des exemples de valeurs.

Remove-HisCustomCodePage -Name Custom21140

Add-HisCustomConversion

Cette applet de commande Add-HisCustomConversion configure le service DRDA pour remplacer les mappages de points de code dans les pages de codes NLS standard et NLS personnalisées.

Syntaxe

Add-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Add-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Paramètres

Le paramètre CodePage indique au service DRDA d’ajouter des paramètres de configuration à l’aide de ce fichier de page de codes NLS numéroté. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 0.

Le paramètre Name indique au service DRDA d’ajouter des paramètres de configuration à l’aide de ce fichier de nom de page de codes NLS personnalisé. Ce paramètre obligatoire accepte une chaîne. La valeur par défaut est une chaîne vide.

Le paramètre EbcdicToUnicode indique à l’encodeur HIS de convertir à partir du point de code EBCDIC spécifié. Ce paramètre facultatif accepte une valeur de chaîne , sous la forme « To=From », où le « To » est la valeur du point de code hexadécimal EBCDIC et la valeur « From » est la valeur de point de code hexadécimal Unicode. La valeur par défaut est une chaîne vide.

Le paramètre UnicodeToEbcdic indique à l’encodeur HIS de convertir à partir du point de code Unicode spécifié. Ce paramètre facultatif accepte une valeur de chaîne , sous la forme « To=From », où « To » est la valeur de point de code hexadécimal Unicode et « From » est la valeur du point de code hexadécimal EBCDIC. La valeur par défaut est une chaîne vide.

Get-HisCustomConversion

Cette applet de commande Get-HisCustomConversion obtient les paramètres de configuration du service DRDA pour remplacer les mappages de points de code dans les pages de codes NLS standard et NLS personnalisées.

Syntaxe

Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode | UnicodeToEbcdic} -CodePage <uint32> [<CommonParameters>]

Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode | Chaîne> -Name <UnicodeToEbcdic} [<CommonParameters>]

Paramètres

Le paramètre CodePage indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce fichier de page de codes NLS numéroté. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 0.

Le paramètre Name indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce fichier de nom de page de codes NLS personnalisé. Ce paramètre obligatoire accepte une chaîne. La valeur par défaut est une chaîne vide.

Le paramètre Type indique au service DRDA d’obtenir les paramètres de configuration à l’aide de ce fichier de page de codes NLS numéroté ou du fichier de nom de page de codes NLS personnalisé. Ce paramètre obligatoire accepte une valeur énumérée d’EbcdicToUnicode ou UnicodeToEbcdic.

Sorties

Cette applet de commande Get-HisCustomConversion retourne un objet avec des propriétés : From (hexadécimal) ; et À (hexadécimal).

Remove-HisCustomConversion

Cette applet de commande Remove-HisCustomConversion supprime les paramètres de configuration du service DRDA pour remplacer les mappages de points de code dans les pages de codes NLS standard et NLS personnalisées.

Syntaxe

Remove-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Remove-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Paramètres

Le paramètre EbcdicToUnicode indique à l’encodeur HIS de convertir à partir du point de code EBCDIC spécifié. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Le paramètre UnicodeToEbcdic indique à l’encodeur HIS de convertir à partir du point de code Unicode spécifié. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Encodages d’application de service DRDA

Le service DRDA convertit les pages de code de base et mappe les points de code à l’aide d’un composant HIS Encoder sous-jacent et des composants système NLS (Windows National Language Support). L’élément applicationEncodings contient des éléments applicationEncoding pour spécifier des schémas d’encodage au niveau de l’application par défaut par base de données. Pour plus d’informations et la description des valeurs, consultez Configuration des encodages d’application.

Add-HisDrdaApplicationEncoding

Cette applet de commande Add-HisDrdaApplicationEncoding configure le service DRDA pour les schémas d’encodage au niveau de l’application par défaut par base de données, pour une utilisation par le composant HIS Encoder et les composants système NLS (National Language Support) windows dans les points de code de mappage dans les pages de code. Pour plus d’informations et la description des valeurs, consultez Configuration des encodages d’application pour plus d’informations.

Syntaxe

Add-HisDrdaApplicationEncoding -Ccsid<uint32> -Database<string> [-Scheme<string>] [<CommonParameters>]

Add-HisDrdaApplicationEncoding -Chaîne de base de données<> -CustomCcsid<uint32> [-Scheme<string>] [<CommonParameters>]

Paramètres

Le paramètre Ccsid indique au service DRDA d’encoder les valeurs du paramètre de sortie et du jeu de résultats à l’aide d’un CCSID de remplacement (identificateur codé de jeu de caractères), et non du CCSID demandé par le client DRDA AR. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 1208.

Le paramètre CustomCcsid indique au service DRDA d’encoder les valeurs du paramètre de sortie et du jeu de résultats à l’aide d’un CCSID personnalisé de remplacement (identificateur codé de jeu de caractères), et non du CCSID demandé par le client DRDA AR. Ce paramètre obligatoire accepte un entier. La valeur par défaut est -1.

Le paramètre de base de données indique au service DRDA d’encoder les valeurs de paramètre de sortie et de jeu de résultats à l’aide d’un schéma d’encodage de remplacement, et non le schéma d’encodage demandé par le client DRDA, pour une base de données SQL Server cible spécifiée uniquement. Ce paramètre obligatoire accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Le paramètre Scheme indique au service DRDA d’encoder les valeurs de paramètre de sortie et de jeu de résultats à l’aide d’un schéma d’encodage de remplacement, et non le schéma d’encodage demandé par le client DRDA AR. Ce paramètre facultatif accepte une valeur de chaîne . Les valeurs prises en charge sont Ebcdic, Unicode et Ansi. La valeur par défaut est Unicode.

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Add-HisDrdaApplicationEncoding -Ccsid 1140 -Database NWIND1 -Scheme Ebcdic

L’exemple de commande suivant définit les valeurs par défaut.

Add-HisDrdaApplicationEncoding -CustomCcsid 1234 -Database NWIND1 -Scheme Ebcdic

Get-HisDrdaApplicationEncoding

Cette applet de commande Get-HisDrdaApplicationEncoding obtient les paramètres de configuration du service DRDA pour les schémas d’encodage au niveau de l’application par défaut par base de données, pour une utilisation par le composant HIS Encoder et les composants système NLS (National Language Support) windows dans les points de code de mappage dans les pages de code.

Syntaxe

Get-HisDrdaApplicationEncoding [-Ccsid<uint32>] [-Database<string>] [-CustomCcsid<uint32>] [<CommonParameters>]

Paramètres

Le paramètre Ccsid indique au service DRDA d’obtenir la configuration d’encodage d’application à l’aide d’un CCSID de remplacement (identificateur codé de jeu de caractères). Ce paramètre facultatif accepte un entier. La valeur par défaut est 1208.

Le paramètre CustomCcsid indique au service DRDA d’obtenir la configuration d’encodage d’application à l’aide d’un CCSID personnalisé (identificateur codé de jeu de caractères). Ce paramètre facultatif accepte un entier. La valeur par défaut est -1.

Le paramètre de base de données indique au service DRDA d’obtenir la configuration d’encodage d’application à l’aide d’un nom de base de données SQL Server cible spécifié. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Sorties

Cette applet de commande Get-HisDrdaApplicationEncoding retourne un objet avec des propriétés : Scheme (chaîne) ; Ccsid (entier) ; Base de données (chaîne) ; et CustomCcsid (entier).

Exemple

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaApplicationEncoding

Scheme
------
Ebcdic
Ebcdic

Ccsid
-----
1140

Database
--------
NWIND1
NWIND1

Customccsid
-----------

1234

Remove-HisDrdaApplicationEncoding

Cette applet de commande Remove-HisDrdaApplicationEncoding supprime les paramètres de configuration du service DRDA pour les schémas d’encodage au niveau de l’application par défaut par base de données, pour une utilisation par le composant HIS Encoder et les composants système NLS (National Language Support) windows dans les points de code de mappage dans les pages de code.

Syntaxe

Remove-HisDrdaApplicationEncoding -Ccsid<string[]> [-Database<string>] [<CommonParameters>]

Remove-HisDrdaApplicationEncoding -CustomCcsid<string[]> [-Database<string>] [<CommonParameters>]

Paramètres

Le paramètre Ccsid indique au service DRDA de supprimer la configuration d’encodage d’application à l’aide d’un CCSID de remplacement (identificateur codé de jeu de caractères). Ce paramètre facultatif accepte un entier. La valeur par défaut est 1208.

Le paramètre CustomCcsid indique au service DRDA de supprimer la configuration d’encodage d’application à l’aide d’un CCSID personnalisé (identificateur codé de jeu de caractères). Ce paramètre facultatif accepte un entier. La valeur par défaut est -1.

Le paramètre de base de données indique au service DRDA de supprimer la configuration d’encodage d’application à l’aide d’un nom de base de données SQL Server cible spécifié. Ce paramètre facultatif accepte une valeur de chaîne . La valeur par défaut est une chaîne vide.

Exemple

L’exemple de commande suivant supprime des exemples de valeurs.

Remove-HisDrdaApplicationEncoding -Ccsid 1140

L’exemple de commande suivant supprime des exemples de valeurs.

Remove-HisDrdaApplicationEncoding -CustomCcsid 1234

Mappage des classements de service DRDA

Le service DRDA mappe la syntaxe de classement pour assurer la compatibilité multiplateforme des résultats de requête. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration du mappage des classements.

Add-HisDrdaCollationName

Cette applet de commande Add-HisDrdaCollationName configure le service DRDA pour transformer une instruction SELECT à partir de la syntaxe DB2 ORDER BY COLLATION_KEY (classement-name) en syntaxe SQL Server T-SQL ORDER BY COLLATE (collation_name), en mappant d’une valeur de nom de classement DB2 à une valeur sql Server collation_name, pour fournir des résultats de requête plus compatibles. Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration du mappage des classements.

Syntaxe

<chaîne Add-HisDrdaCollationName -To chaîne> -From <chaîne> [<CommonParameters>]

Paramètres

Le paramètre To indique au transformateur SQL du service DRDA de convertir en chaîne de collation_name spécifiée dans une clause SQL Server SELECT ORDER BY COLLATE. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Le paramètre From indique au transformateur SQL du service DRDA de convertir à partir de la chaîne de nom de classement spécifiée dans une clause DB2 SELECT ORDER BY COLLATION_KEY. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS

Get-HisDrdaCollationName

Cette applet de commande Get-HisDrdaCollationName obtient les paramètres de configuration du service DRDA pour transformer une instruction SELECT à partir de la syntaxe DB2 ORDER BY COLLATION_KEY (nom de classement) en syntaxe SQL Server T-SQL ORDER BY COLLATE (collation_name), en mappant d’une valeur de nom de classement DB2 à une valeur sql Server collation_name, pour fournir des résultats de requête plus compatibles.

Syntaxe

Get-HisDrdaCollationName [-To<string>] [-From<string>] [<CommonParameters>]

Paramètres

Le paramètre To indique à la configuration du nom de classement du service DRDA à l’aide de la chaîne de collation_name spécifiée. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Le paramètre From indique à la configuration du nom de classement d’obtention du service DRDA à l’aide de la chaîne de nom de classement spécifiée dans une clause DB2 SELECT ORDER BY COLLATION_KEY. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Sorties

Cette applet de commande Get-HisDrdaCollationName retourne un objet avec des propriétés : To (chaîne) ; et From (chaîne).

Exemple

L’exemple de commande suivant définit les valeurs par défaut.

Get-HisDrdaCollationName

To
--
SQL_EBCDIC037_CP1_CS_AS

From
----
UCA400R1_LEN_AN

Remove-HisDrdaCollationName

Cette applet de commande Remove-HisDrdaCollationName supprime les paramètres de configuration du service DRDA pour ajouter une clause COLLATE à une clause ORDER BY, en fonction d’un nom de classement ORDER BY par défaut.

Syntaxe

Remove-HisDrdaCollationName -RemoveAll<bool> [-To<string>] [-From<string>] [<CommonParameters>]

Paramètres

Le paramètre To indique au service DRDA de supprimer la configuration du nom de classement à l’aide de la chaîne collation_name spécifiée. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Le paramètre From indique au service DRDA de supprimer la configuration du nom de classement à l’aide de la chaîne de nom de classement spécifiée dans une clause DB2 SELECT ORDER BY COLLATION_KEY. Ce paramètre obligatoire accepte une valeur de chaîne . Il n’existe aucune valeur par défaut.

Exemple

L’exemple de commande suivant supprime des exemples de valeurs.

Remove-HisDrdaCollationName -From UCA400R1_LEN_AN

Configuration des écouteurs de trace

Le service DRDA prend en charge plusieurs écouteurs de suivi simultanés, notamment : écouteur de suivi de texte, écouteur de trace de console, écouteur de trace personnalisé et écouteur de trace d’événements pour Windows (ETW). Pour plus d’informations et la description des valeurs, consultez Intégration des données (déploiement), Service DRDA, Configuration des écouteurs de trace.

Set-HisDrdaConsoleTraceListener

L’applet de commande Set-HisDrdaConsoleTraceListener configure l’écouteur de trace de la console de service DRDA pour écrire des données de trace dans une fenêtre de console de commande.

Syntaxe

<Set-HisDrdaConsoleTraceListener -Level uint32> [<CommonParameters>]

Paramètres

Le paramètre Level indique au service DRDA de suivre les collections d’informations définies, d’un minimum à un niveau maximal de suivi. Ce paramètre obligatoire accepte une valeur entière . La valeur par défaut est 0.

Valeur	Description
0	Sortie aucun message de suivi.
1	Messages d’erreur de sortie.
2	Sortie des messages d’avertissement et des messages d’erreur.
3	Affichez des messages d’informations, des messages d’avertissement et des messages d’erreur.
4	Affichez tous les messages.

Tableau AUTONUM \\ Arabe Niveaux de trace.*

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Set-HisDrdaConsoleTraceListener -Level 3

Set-HisDrdaEtwTraceListener

L’applet de commande Set-HisDrdaEtwTraceListener configure le service DRDA ETW (Suivi d’événements pour Windows) en tant que fournisseur ETW pour générer des données de trace via une session ETW vers un contrôleur ETW du système d’exploitation Windows.

Syntaxe

<Set-HisDrdaEtwTraceListener -Level uint32> [<CommonParameters>]

Paramètres

Valeur	Description
0	Sortie aucun message de suivi.
1	Messages d’erreur de sortie.
2	Sortie des messages d’avertissement et des messages d’erreur.
3	Affichez des messages d’informations, des messages d’avertissement et des messages d’erreur.
4	Affichez tous les messages.

Tableau AUTONUM \\ Arabe Niveaux de trace.*

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Set-HisDrdaEtwTraceListener -Level 3

Set-HisDrdaEventLogTraceListener

L’applet de commande Set-HisDrdaEventLogTraceListener configure l’écouteur du journal des événements du service DRDA génère des données de journal dans le journal des événements Windows.

Syntaxe

<chaîne> Set-HisDrdaEventLogTraceListener -InitializeData [<CommonParameters>]

Paramètres

Le paramètre InitializeData indique au service DRDA de consigner les collections d’informations définies. Ce paramètre obligatoire accepte une valeur de chaîne . La valeur par défaut est « Error,Warning, Information », qui inclut tous les niveaux du journal des événements.

Valeur	Description
Error	Cette valeur indique au service DRDA de consigner uniquement les données de niveau d’erreur.
Avertissement	Cette valeur indique au service DRDA de consigner uniquement les données au niveau d’avertissement.
Informations	Cette valeur indique au service DRDA de consigner uniquement les données au niveau des informations

Tableau AUTONUM \\ Arabe Niveaux du journal des événements.*

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Set-HisDrdaEventLogTraceListener -InitializeData Warning

Set-HisDrdaTextTraceListener

L’applet de commande Set-HisDrdaTextTraceListener configure l’écouteur de suivi de texte du service DRDA pour écrire des données de trace dans un fichier de disque au format texte.

Syntaxe

<Set-HisDrdaTextTraceListener -Level uint32> [-InitializeData <string>] [-AutoFlush <bool>] [-MaxTraceEntryCount <uint32>] [-MaxTraceFileCount <uint32>] [<CommonParameters>]

Paramètres

Valeur	Description
0	Sortie aucun message de suivi.
1	Messages d’erreur de sortie.
2	Sortie des messages d’avertissement et des messages d’erreur.
3	Affichez des messages d’informations, des messages d’avertissement et des messages d’erreur.
4	Affichez tous les messages.

Tableau x. Niveaux de trace.

Le paramètre AutoFlush indique au service DRDA de vider automatiquement les données de l’écouteur de trace. Ce paramètre obligatoire accepte une valeur booléenne . La valeur par défaut est false.

Note

Le service DRDA peut vider automatiquement les données de trace sur les écouteurs de trace, ce qui garantit que les données de trace sont capturées, mais augmentent les E/S de disque et réduisent les performances globales du système. Pour améliorer les performances, définissez AutoFlush=$False pour désactiver le vidage automatique des traces.

Le paramètre MaxTraceEntryCount indique au service DRDA de tracer jusqu’à un nombre maximal d’entrées, puis d’arrêter le suivi. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 10000000.

Le paramètre MaxTraceFileCount indique au service DRDA d’écrire la sortie de trace de l’écouteur de texte un nombre maximal de fichiers de trace individuels, puis de remplacer les fichiers de trace existants. Ce paramètre obligatoire accepte un entier. La valeur par défaut est 10.

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10

Start-HisDrdaTraceListener

Cette applet de commande Start-HisDrdaTraceListener demande au service DRDA de démarrer le type spécifié d’écouteur de trace.

Syntaxe

Start-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

Paramètres

Le paramètre Écouteur indique au service DRDA de démarrer le type d’écouteur de trace spécifié. Ce paramètre obligatoire accepte une valeur d’écouteur de console, de texte, d’etw ou d’EventLog. Il n’existe aucune valeur par défaut.

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Start-HisDrdaTraceListener -Listener Console

L’exemple de commande suivant définit des exemples de valeurs.

Start-HisDrdaTraceListener -Listener Text

L’exemple de commande suivant définit des exemples de valeurs.

Start-HisDrdaTraceListener -Listener Etw

L’exemple de commande suivant définit des exemples de valeurs.

Start-HisDrdaTraceListener -Listener EventLog

Get-HisDrdaTraceListener

Cette applet de commande Get-DrdaTextTraceListener obtient les paramètres de configuration du service DRDA pour l’écouteur de suivi de texte afin d’écrire des données de trace dans un fichier disque au format texte.

Syntaxe

Get-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

Paramètres

Le paramètre d’écouteur indique au service DRDA d’obtenir la configuration du type d’écouteur de trace spécifié. Ce paramètre obligatoire accepte une valeur d’écouteur de console, de texte, d’etw ou d’EventLog. Il n’existe aucune valeur par défaut.

Sorties

Cette applet de commande Get-HisDrdaTraceListener retourne une collection de propriétés.

Exemple

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Console

Status
------
Enabled

Level
-----
3

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Text

InitializeData  : MsDrdaService.DSTF
AutoFlush       : True
MaxTraceEntries : 1000000
MaxTraceFiles   : 10
Status          : Enabled
Level           : 3

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Etw

Status
------
Enabled

Level
-----
3

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Console

InitializeData
--------------
Warning

Status
------
Enabled

Stop-HisDrdaTraceListener

Cette applet de commande Stop-HisDrdaTraceListener indique au service DRDA d’arrêter le type spécifié d’écouteur de trace.

Syntaxe

Stop-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

Paramètres

Exemple

L’exemple de commande suivant définit des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Console

L’exemple de commande suivant définit des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Text

L’exemple de commande suivant définit des exemples de valeurs.

Get-HisDrdaTraceListener -Listener Etw

L’exemple de commande suivant définit des exemples de valeurs.

Get-HisDrdaTraceListener -Listener EventLog

Écouteur de liaison de package de service DRDA

Le service DRDA prend en charge les classeurs de packages personnalisés sous la forme d’un écouteur personnalisé .NET Framework.

Add-HisDrdaPackageBindListener

Cette applet de commande Add-HisDrdaPackageBindListener ajoute une configuration de service DRDA pour l’envoi d’un package de liaison avec la sortie d’instruction SQL de liaison à un écouteur de liaison personnalisé facultatif.

Syntaxe

Add-HisDrdaPackageBindListener -TypeName<string> [-ThrowWhenNoCallback ] [<CommonParameters>]

Paramètres

Le paramètre TypeName définit le type de l’écouteur de liaison personnalisé du service DRDA. Ce paramètre obligatoire accepte une chaîne. Il n’existe aucune valeur par défaut. La valeur type de l’exemple d’écouteur de liaison de package personnalisé est « CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL ».

Le paramètre ThrowWhenNoCallback indique au service DRDA de renvoyer BGNBNDRM (Begin Bind Reply Message) au client AR DRDA, lorsque le composant d’écouteur de liaison personnalisé ne retourne aucune information sur l’interface de rappel. Ce paramètre facultatif accepte une valeur booléenne . La valeur par défaut est true.

Exemple

L’exemple de commande suivant ajoute des exemples de valeurs.

Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback

Get-HisDrdaPackageBindListener

Cette applet de commande Get-HisDrdaPackageBindListener obtient les paramètres de configuration du service DRDA pour l’envoi d’un package de liaison avec la sortie d’instruction SQL de liaison à un écouteur de liaison personnalisé facultatif.

Syntaxe

Get-HisDrdaPackageBindListener [-Type<string>] [<CommonParameters>]

Paramètres

Le paramètre Type définit le type de l’écouteur de liaison personnalisé du service DRDA. Ce paramètre obligatoire accepte une chaîne. Il n’existe aucune valeur par défaut. La valeur type de l’exemple d’écouteur de liaison de package personnalisé est « CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL ».

Exemple

L’exemple de commande suivant obtient des exemples de valeurs.

Get-HisDrdaPackageBindListener
PackageBindListener:
type=CustomListeners.MyPackageBindListener
errorWhenNoCallback=True

Remove-HisDrdaPackageBindListener

Cette applet de commande Remove-HisDrdaPackageBindListener supprime les paramètres de configuration du service DRDA pour ajouter un écouteur de trace personnalisé.

Syntaxe

Remove-HisDrdaPackageBindListener -TypeName<string> [<CommonParameters>]

Paramètres

Exemple

L’exemple de commande suivant supprime des exemples de valeurs.

Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener

Last updated on 2023-07-21