Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
PowerShell-Modul
Windows PowerShell® ist eine taskbasierte Befehlszeilenshell und Skriptsprache, die speziell für die Systemverwaltung entwickelt wurde. Windows PowerShell basiert auf .NET Framework und unterstützt IT-Experten und erfahrene Benutzer beim Steuern und Automatisieren der Verwaltung von Windows-Betriebssystemen sowie von Anwendungen, die unter Windows ausgeführt werden. Der DRDA-Dienst bietet PowerShell-Befehle als Teil des allgemeinen HIS 2013-PowerShell-Moduls Microsoft.HostIntegration.PowerShell, einschließlich einer Reihe von Cmdlet-Befehlen zum Hinzufügen/Abrufen/Entfernen/Festlegen MsDrdaService.exe.config Elemente und Attribute sowie Befehle zum Starten/Beenden von Listenern.
PowerShell-Cmdlets
Ein PowerShell-Cmdlet ist ein einfacher Befehl, der in der Windows PowerShell-Umgebung verwendet wird. Die Windows PowerShell Runtime ruft diese Cmdlets im Kontext von Automatisierungsskripts auf, die über die Befehlszeile bereitgestellt werden. Die Windows PowerShell Runtime ruft sie auch programmgesteuert über Windows PowerShell-APIs auf.
Die öffentlichen Eigenschaften, die die Parameter definieren, die dem Benutzer oder der Anwendung zur Verfügung stehen, die das Cmdlet ausführt. Cmdlets können über erforderliche, benannte, positionale und switch-Parameter verfügen. Ein switch-Parameter ist ein Parameter, der angegeben werden kann oder nicht, wenn der Befehl ausgeführt wird. Wenn der Parameter angegeben wird, löst die Windows PowerShell Runtime ihren Wert als true auf. Wenn der Parameter nicht angegeben wird, was in der Regel der Standardwert ist, wird der Parameterwert als false aufgelöst. Die allgemeinen Parameter werden allen Cmdlets hinzugefügt und können bei jeder Ausführung des Cmdlets aufgerufen werden.
Befehle des POWERShell-Moduls für den DRDA-Dienst
Die DRDA-Dienstkonfiguration wird in der MsDrdaService.exe.config Anwendungskonfigurationsdatei (App-Konfigurationsdatei) und den zugehörigen XML-Dateien (Fehlermeldungs- und Datentypzuordnung) gespeichert. Zur Laufzeit überwacht der DRDA-Dienst die MsDrdaService.exe.config-Datei auf Änderungen. Wenn er erkannt wird, liest und verwendet der DRDA-Dienst die geänderten Konfigurationsinformationen beim Verarbeiten neuer ingebundener Verbindungen. Der DRDA-Dienst enthält eine %SNAROOT%\System\Schemas\HostIntegrationDrdaServiceConfiguration.xsd-Datei zum Überprüfen der Anwendungskonfigurationsdatei.
IT-Experten können die DRDA-Dienstkonfiguration mithilfe des DRDA-Dienst-PowerShell-Moduls Microsoft.HostIntegration.PowerShell anpassen. Die Cmdlets werden in Konfigurations- und Vorgangssammlungen gruppiert.
Erforderliche Software
Für das PowerShell-Modul des DRDA-Diensts sind die folgenden Softwareprodukte als Featurevoraussetzungen erforderlich.
Microsoft PowerShell 3.0 (Windows Management Framework 3.0)
Starten von PowerShell
Starten Sie PowerShell mit Administratorberechtigungen, indem Sie einen dieser Befehle ausführen.
Klicken Sie auf dem Startbildschirm mit der rechten Maustaste auf die Kachel Windows PowerShell App, und klicken Sie in der App-Leiste auf Als Administrator ausführen.
Klicken Sie in Server-Manageroder desktop auf der Taskleiste mit der rechten Maustaste auf die Verknüpfung Windows PowerShell, und klicken Sie dann auf Als Administrator ausführen.
Bewegen Sie den Cursor auf dem Desktop in die obere rechte Ecke, klicken Sie auf Suchen, geben Sie PowerShell ein, klicken Sie mit der rechten Maustaste auf die Kachel Windows PowerShell App, und klicken Sie in der App-Leiste auf Als Administrator ausführen.
Geben Sie an der Windows PowerShell Eingabeaufforderung Folgendes ein:
Start-Process PowerShell -Verb RunAs
Starten von PowerShell ISE
Starten Sie PowerShell ISE (Integrated Scripting Environment) mit Administratorberechtigung, indem Sie einen dieser Befehle ausführen.
Geben Sie auf dem StartbildschirmISE ein, klicken Sie mit der rechten Maustaste auf Windows PowerShell ISE-Kachel, und klicken Sie in der App-Leiste auf Als Administrator ausführen.
Klicken Sie auf der Taskleiste mit der rechten Maustaste auf Windows PowerShell, und klicken Sie dann auf ISE als Administrator ausführen.
Wählen Sie im Menü Server-Manager Toolsdie Option Windows PowerShell ISE aus.
Geben Sie an der Windows PowerShell Eingabeaufforderung Folgendes ein:
Start-Process PowerShell_ISE -Verb RunAs
Festlegen des Modulpfads
Das POWERShell-Modul des DRDA-Diensts muss sich im Modulpfad befinden. Wenn Sie den DRDA-Dienst mithilfe des eigenständigen MsDrdaService.MSI installieren, müssen Sie den Modulpfad mithilfe von PowerShell oder PowerShell ISE manuell festlegen.
Geben Sie an der Windows PowerShell- oder PowerShell ISE-Eingabeaufforderung den folgenden Befehl ein, und klicken Sie dann auf DIE EINGABETASTE.
Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"Geben Sie den folgenden Get-Module-Befehl ein, und klicken Sie dann auf DIE EINGABETASTE.
Get-Module Microsoft.HostIntegration.PowerShellÜberprüfen Sie die folgenden Informationen.
ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Binary 9.0.1000.0 Microsoft.HostIntegration.PowerS... {Add-HisDrdaApplicationEncoding, Remove-HisDrdaApplicationEncoding, Get-HisDrdaApplicationEncoding, Add-HisDrdaCollationName...}
Abrufen von Modulbefehlen
Geben Sie an der Windows PowerShell- oder PowerShell ISE-Eingabeaufforderung den folgenden Befehl ein, und klicken Sie dann auf DIE EINGABETASTE.
Get-Command -Module Microsoft.HostIntegration.PowerShellÜberprüfen Sie die folgenden Informationen.
DRDA-Dienstbefehle
Die folgenden Microsoft.HostIntegration.PowerShell-Cmdletbefehle sind für die Verwendung mit dem DRDA-Dienst vorgesehen.
| CommandType | Name | 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 |
Tabelle 1. Liste der PowerShell-Befehle des DRDA-Diensts.
DRDA-Dienstkonnektivität und Paketbindungsverarbeitung
Die DRDA-Dienstkonnektivität und Paketbindung umfasst: (1) DRDA-Client-zu-DRDA-Dienstverbindungen, (2) DRDA-Dienst-zu-SQL Server-Verbindungen, (3) DRDA-Dienstverbindungen und (4) Verarbeitung von DRDA-Dienstpaketbindungen (einschließlich SQL-Syntaxtransformationen).
Set-HisDrdaService
Dieses Set-HisDrdaService Cmdlet konfiguriert den DRDA-Dienst für ingebundene DRDA-Clientverbindungen.
Syntax
Set-HisDrdaService [-PartnerServers-Zeichenfolge<>] [-Port<uint32>] [-IsPrimary ] [-UseSsl ] [-PingInterval<uint32>] [-EnablePerformanceCounters ] [-AllowClientIpAddresses-Zeichenfolge<>] [-SslCertificatePath-Zeichenfolge<>] [<CommonParameters>]
Parameter
Der Parameter AllowClientIpAddresses schränkt den DRDA-Dienst so ein, dass in-bound TCP/IP-Netzwerkverbindungen von einer Liste bekannter DRDA AR-Clientcomputer akzeptiert werden. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die es dem DRDA-Dienst ermöglicht, auf alle in-gebundenen Clientverbindungsanforderungen zu reagieren. Die Liste besteht aus einer TCP/IP-Adresse oder einem Alias mit Semikolontrennzeichen. Die TCP/IP-Adresse kann entweder im IPv4- oder im IPv6-Format definiert werden. Beispiel: 123.34.45.57; 123.34.45.58 definiert eine gültige Clientliste im IPv4-Netzwerkadressformat.
Der Parameter EnablePeformanceCounters weist den DRDA-Dienst an, Informationen in Leistungsindikatoren zu sammeln. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist false.
Der Parameter IsPrimary weist den DRDA-Dienst an, ob er in einer primären Rolle innerhalb einer Gruppe von Servern arbeiten soll. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert lautet true. Der primäre Server reagiert auf alle DRDA AR-Clientanforderungen, indem er EXCSAT (Exchange Server Attributes), ACCSEC (Access Security) und ACCRDB (Access Relational Database) verarbeitet, einschließlich der Rückgabe einer SRVLST (Serverliste) in der ACCRDBRM (ACCRDB Reply Message). Die Serverliste enthält eine gewichtete Prioritätsliste mit primären (höchsten gewichteten Werten) und sekundären Servern (niedrigste gewichtete Werte), um die DRDA AR-Clients darüber zu informieren, mit denen der DRDA-Dienstcomputer eine Verbindung herstellen soll.
Der Parameter PartnerServers definiert die Liste der sekundären Servercomputer. Dieser optionale Parameter ist erforderlich, wenn "Primary=false" ist und einen Zeichenfolgenwert akzeptiert. Der Standardwert ist eine leere Zeichenfolge. Die Liste besteht aus einer TCP/IP-Adresse oder einem Alias, der durch eine TCP/IP-Portnummer getrennt ist. Die TCP/IP-Adresse kann entweder im IPv4- oder im IPv6-Format definiert werden. Die Liste kann mehrere Partnerservercomputer enthalten, die semikolontrennt sind. Beispiel: 123.34.45.57:446; 123.34.45.58:446 definiert eine gültige Partnerserverliste im IPv4-Netzwerkadressenformat.
Der PingInterval-Parameter weist den DRDA-Dienst an, wie häufig die Integrität von Partnerservercomputern überwacht werden soll, indem er einen EXCSAT-Flow (Exchange Server-Attribut) ausführt und nach einem EXCSATRD (EXCSAT Reply Data) sucht. Dieser optionale Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 10.000 Millisekunden (10 Sekunden).
Der Port-Parameter definiert die TCP/IP-Portnummer, an der der DRDA-Dienst auf in-bound DRDA Application Requester-Clientverbindungsanforderungen lauschen muss. Dieser optionale Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 446.
Der Parameter SslCertificatePath gibt das SSL- oder TLS-Zertifikat Common Name (CN) an. Dieser optionale Parameter ist erforderlich, wenn useSSL=true verwendet wird, und akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Der UseSSL-Parameter weist den DRDA-Dienst an, SSL-Version 3.0 (Secure Sockets Layer) und TLS-Version 1.0 (Transport Layer Security) zu verwenden, wenn auf in-bound TCP/IP-Netzwerkverbindungen reagiert wird. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist false.
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446
Get-HisDrdaService
Dieses Get-HisDrdaService Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts für in-bound DRDA-Clientverbindungen ab.
Syntax
Get-HisDrdaService [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-HisDrdaService Cmdlet gibt ein Objekt mit eigenschaften zurück: AllowClientIpAddresses (string); IsPrimary (Boolean); PartnerServers (Zeichenfolge); EnablePerformanceCounters (Boolean); PingInterval (ganze Zahl); Port (ganzzahliger Port); SslCertificatePath (Zeichenfolge); und UseSsl (Boolean).
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte ab.
Get-HisDrdaService
AllowClientIpAddresses :
IsPrimary : True
PartnerServers :
EnablePerformanceCounters : false
PingInterval : 10000
Port : 446
SslCertificatePath :
UseSsl : false
Set-DrdaSqlServerConnection
Dieses Set-DrdaSqlServerConnection Cmdlet konfiguriert den DRDA-Dienst für out-bound SQL Server-Verbindungen.
Syntax
Set-DrdaSqlServerConnection [-MappedAuthenticationDomain<string>] [-AuthenticationLookupTimeoutDuration<string>] [-AuthenticationLookupRetryCount<uint32>] [-SecurityTokenTimeoutDuration<string>] [-RollbackTransactionOnError ] [-ClientApplicationName<ClientApplicationName>] [-DefaultCollationName<string>] [-ConnectionString string] [-ConnectionString-Zeichenfolge<>] [-StoredProcedureCallTimeout<uint32>] [-HostInitiatedAffiliateApplication<string>] [-WindowsInitiatedAffiliateApplication<string>] [-EnableArithAbort ] [<CommonParameters>]
Parameter
Der AuthenticationLookupRetryCount-Parameter weist den DRDA-Dienst an, wie oft eine Sicherheitsauthentifizierungssuche durchgeführt werden muss, bevor ein Fehler auftritt. Dieser optionale Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 3 Wiederholungen.
Der AuthenticationLookupTimeoutDuration-Parameter weist den DRDA-Dienst an, wie lange er auf eine Sicherheitsauthentifizierungssuche warten muss, bevor ein Fehler auftritt. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert , der einen XML-Dauerwert darstellt. Der Standardwert ist PT30S (Zeitraum ist 30 Sekunden). Der Dauerwert wird in der Form PnYnMnDTnHnMnS angegeben. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren SQL Server Verbindungen.
Der ClientApplicationName-Parameter weist den DRDA-Dienst an, wie die Verbindungseigenschaft sql Client Application Name festgelegt werden soll. Dieser optionale Parameter akzeptiert einen aufgezählten Zeichenfolgenwert. Der Standardwert ist leer. Geben Sie externalName an, um den DRDA-Dienst anzuweisen, bytes 1-8 des DRDA External Name (EXTNAM) zu verwenden, der den Namen des Auftrags, Vorgangs oder Prozesses des DRDA AR-Clientprogramms darstellt. Geben Sie transactionIdentifier an, um den DRDA-Dienst anzuweisen, bytes 5-8 des EXTNAM zu verwenden, die den Namen des Transaktionsbezeichners des DRDA AR-Clientprogramms bei der Ausführung in CICS für z/OS darstellen.
Der ConnectionString-Parameter definiert die Liste der Argumentnamen- und Wertpaare für die Verwendung durch den DRDA-Dienst beim Definieren eines Microsoft ADO.NET Framework-Datenanbieters für SQL Server Verbindungsobjekts. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist Data Source=; Integrierte Sicherheit=True; MultipleActiveResultSets=True. Weitere Informationen finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren SQL Server Verbindungen.
Der Parameter DefaultCollationName weist den DRDA-Dienst an, eine SQL Server COLLATE-Klausel (collation_name) hinzuzufügen, wenn eine DB2 SELECT-Anweisung mit der ORDER BY-Klausel in eine SQL Server SELECT-Anweisung mit ORDER BY-Klausel transformiert wird. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist SQL_Latin1_General_CP1_CI_AS. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren der Sortierungszuordnung.
Der Parameter EnableArithAbort weist den DRDA-Dienst an, die SET ARITHABORT-Anweisung zur Verbindungszeit auszuweisen, um SQL Server anzufordern, eine Abfrage zu beenden, wenn während der Abfrageausführung ein Überlauf- oder Divisorfehler auftritt. Dieser optionale Parameter akzeptiert einen booleschen Wert. Die Standardeinstellung ist false.
Der HostInitiatedAffiliateApplication-Parameter definiert den Namen der Partneranwendung, den der DRDA-Dienst mit Microsoft Enterprise Single Sign-On verwenden soll, um die gebundenen DRDA AR-Clientanmeldeinformationen einem Windows Active Directory-Domänenbenutzer zuzuordnen, wenn der SQL-Client die Windows-Authentifizierung verwendet. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die den DRDA-Dienst anweist, das vom Host initiierte ESSO nicht zu verwenden. Wenn Sie hostinitiiertes ESSO verwenden, müssen Sie Integrated Security=true im SQL Server Verbindungszeichenfolge angeben.
Der Parameter MappedAuthenticationDomain weist den DRDA-Dienst an, dem die Microsoft Windows Active Directory-Domäne die in-gebundenen DRDA-Clientanmeldeinformationen (Benutzername und Kennwort) zuordnen soll, wenn eine Verbindung mit SQL Server hergestellt wird, die für Windows-Authentifizierung mithilfe der integrierten SSPI (Security Support Provider Interface) konfiguriert ist, aber nicht bei Verwendung von Microsoft Enterprise Single Sign-On. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Der RollbackTransactionOnError-Parameter weist den DRDA-Dienst an, nach einem negativen datenbankfehler SQL Server einen ROLLBACK auszuführen. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert lautet true.
Der SecurityTokenTimeout-Parameter weist den DRDA-Dienst an, ein Sicherheitstoken für einen bestimmten Zeitraum beizubehalten, nach dem ein neuer Windows-Clientbezeichner (Windows Client Identifier, CID) abgerufen werden soll. Dieser optionale Parameter akzeptiert einen Wert für die Dauer . Der Standardwert ist PT8H (Zeitraum ist 8 Stunden). Der Dauerwert wird in der Form PnYnMnDTnHnMnS angegeben. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren SQL Server Verbindungen.
Der Parameter WindowsInitiatedAffiliateApplication definiert den Namen der Partneranwendung, den der DRDA-Dienst mit Microsoft Enterprise Single Sign-On verwenden soll, um den Windows Active Directory-Domänenbenutzer einem übergebundenen SQL-Client-Anmeldeinformationen zuzuordnen, wenn der SQL-Client SQL Server-Authentifizierung verwendet. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die den DRDA-Dienst anweist, das von Windows initiierte ESSO nicht zu verwenden. Wenn Sie das von Windows initiierte ESSO verwenden, müssen Sie Integrated Security=false in der SQL Server Verbindungszeichenfolge angeben.
Der Parameter StoredProcedureCallTimeout weist den DRDA-Dienst an, wie lange (in Sekunden) er wartet, bis SQL Server eine CALL-Anweisung zum Ausführen einer gespeicherten Prozedur verarbeitet, bevor der Versuch beendet und ein Fehler generiert wird. Dieser optionale Parameter akzeptiert einen ganzzahligen Wert. Gültige Werte sind größer oder gleich 0 und kleiner als oder gleich 2147483647. Der Wert 0 gibt kein Limit an (ein Versuch, einen Befehl auszuführen, wartet unbegrenzt). Der Standardwert ist 30 Sekunden.
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
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
Dieses Get-DrdaSqlServerConnection Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts für übergebundene SQL Server-Verbindungen ab.
Syntax
Get-DrdaSqlServerConnection [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-DrdaSqlServerConnection Cmdlet gibt ein Objekt mit eigenschaften zurück: ArithAbort (Boolean); AuthenticationLookupTimeout (Zeichenfolge); AuthenticationLookupRetryCount (integer); ClientApplicationName (Zeichenfolge); ConnectionString (Zeichenfolge); DefaultCollationName (Zeichenfolge); HostInitiatedAffiliateApplication (Zeichenfolge); MappedAuthenticationDomain (string); RollbackTransactionOnError (Boolean); SecurityTokenTimeoutSeconds (Zeichenfolge); StoredProcedureCallTimeoutSeconds (ganze Zahl); und WindowsInitiatedAffiliateApplication (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte ab.
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
Dieses Set-DrdaPackageBindProcessing Cmdlet konfiguriert den DRDA-Dienst für die Verarbeitung statischer DRDA-SQL-Pakete in SQL Server gespeicherten Prozeduren.
Syntax
Set-DrdaPackageBindProcessing [-CreatePackageProcedureWithCustomSqlScripts ] [-PackageProcedureSchemaList-Zeichenfolge] [-CreatePackageProcedure ] [-CreatePackageXmlXml ] [-PackageXmlFormat <PackageXmlFormat>] [-PackageXmlLocation-Zeichenfolge><] [-StoredProcedureNameSeparator-Zeichenfolge><] [-CreatePackageProcedureWithExtendedProperties ] [<CommonParameters>]<>
Parameter
Der CreatePackageProcedure-Parameter weist den DRDA-Dienst an, einen einzelnen BGNBND-Flow in eine SQL Server gespeicherte Prozedur zu verarbeiten, wobei die ursprünglichen Anweisungen gemäß den DRDA BNDSQLSTT-Flows in die entsprechende SQL Server-Syntax transformiert werden. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert lautet true.
Der Parameter CreatePackageProcedureWithCustomSqlScripts weist den DRDA-Dienst an, DRDA BGNBND und BNDSQLSTT über eine externe benutzerdefinierte Paketbindungslistenerkomponente zu verarbeiten. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist „FALSE“.
Der Parameter CreatePackageProcedureWithExtendedProperties weist den DRDA-Dienst an, die BGNBND-Paketbindungsoptionen als erweiterte Eigenschaften für die SQL Server gespeicherten Prozedur beizubehalten. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist false.
Der CreatePackageXml-Parameter weist den DRDA-Dienst an, einen einzelnen BGNBND-Flow in einer statischen SQL for DB2-Paket-XML-Datei zu verarbeiten, wobei die ursprünglichen Bindungsoptionen und -anweisungen wie in den DRDA-BNDSQLSTT-Flows definiert beibehalten werden. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist false.
PackageProcedureSchemaList weist den DRDA-Dienst an, das Ziel SQL Server gespeicherten Prozedur in alternativen Schemas zu suchen. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge. Die Zeichenfolge besteht aus einem durch Trennzeichen getrennten SQL Server Schemanamen. Der Parameter packageProcedureSchemaList ähnelt dem Speziellen Register IBM DB2 für z/OS CURRENT PACKAGESET und der SET CURRENT PACKAGESET-Anweisung.
Der Parameter PackageXmlFormat weist den DRDA-Dienst an, die statische SQL for DB2-XML-Datei entweder im v90- oder v85-Format zu schreiben. Dieser optionale Parameter akzeptiert einen enumerierten Zeichenfolgenwert von v85 oder v90. Der Standardwert ist v90.
Der Parameter PackageXmlLocation weist den DRDA-Dienst an, wo die statische SQL for DB2-Paket-XML-Datei geschrieben werden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist c:\temp.
Der Parameter StoredProcedureNameSeparator weist den DRDA-Dienst an, welches Trennzeichen beim Zuordnen eines DRDA-Paketnamens zu einem SQL Server Namen der gespeicherten Prozedur verwendet werden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist ein einzelner Unterstrich (_).
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
Set-HisDrdaPackageBindProcessing -CreatePackageProcedure -PackageXmlFormat v90 -PackageXmlLocation c:\temp -StoredProcedureNameSeparator _
Get-HisDrdaPackageBindProcessing
Dieses Get-HisDrdaPackageBindProcessing Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts für die Verarbeitung statischer DRDA-SQL-Pakete in SQL Server gespeicherten Prozeduren ab.
Syntax
Get-HisDrdaPackageBindProcessing [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-HisDrdaPackageBindProcessing Cmdlet gibt ein Objekt mit eigenschaften zurück: CreatePackageProcedure (Boolean); CreatePackageXml (Boolean); PackageXmlFormat (Zeichenfolge); PackageXmlLocation (Zeichenfolge); StoredProcedureNameSeparator (Zeichenfolge); CreatePackageProcedureWithExtendedProperties (Boolean); CreatePackageProcedureWithCustomSqlScripts (Boolean); und PackageProcedureSchemaList (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte ab.
Get-HisDrdaPackageBindProcessing
CreatePackageProcedure : true
CreatePackageXml : false
PackageXmlFormat : v90
PackageXmlLocation : c:\temp
StoredProcedureNameSeparator : _
CreatePackageProcedureWithExtendedProperties : false
CreatePackageProcedureWithCustomSqlScripts : false
PackageProcedureSchemaList :
Set-HisDrdaPackageProcedureCache
Dieses Set-HisDrdaPackageProcedureCache Cmdlet konfiguriert den DRDA-Dienst für das Zwischenspeichern von Metadaten für die gespeicherte SQL Server Prozedur, mit der der Anweisungstyp, Cursortyp, Parameterdatentypen und andere Attribute überprüft werden.
Syntax
Set-HisDrdaPackageProcedureCache -FlushTimeSpan-Zeichenfolge <> [<CommonParameters>]
Parameter
Der Parameter FlushTimeSpan weist den DRDA-Dienst an, den Paketprozedurcache nach einem angegebenen Zeitintervall zu leeren. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert , der einen XML-Dauerwert darstellt. Der Standardwert ist P1D (Zeitraum ist 1 Tag). Der Wert für die Dauer wird im Format PnYnMnDTnHnMnS angegeben. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren der Paketbindungsverarbeitung.
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D
Get-HisDrdaPackageProcedureCache
Dieses Get-HisDrdaPackageProcedureCache Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts zum Zwischenspeichern von Metadaten für die gespeicherte SQL Server Prozedur ab, mit der der Anweisungstyp, Cursortyp, Parameterdatentypen und andere Attribute überprüft werden können.
Syntax
Get-HisDrdaPackageProcedureCache [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-HisDrdaPackageProcedureCache Cmdlet gibt ein Objekt mit der Eigenschaft FlushTimeSpan (Zeichenfolge) zurück.
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte ab.
Get-HisDrdaPackageProcedureCache
FlushTimeSpan
-------------
P1D
Set-HisDrdaSqlTransform
Dieses Set-DrdaSqlTransform Cmdlet konfiguriert den DRDA-Dienst für die Verwendung interner oder externer CLR-basierter SQL-Transformationen, um die SYNTAX der DB2-Funktion in SQL Server T-SQL-Funktionssyntax zu konvertieren.
Syntax
Set-DrdaSqlTransform [-EnableUnicodeOutput] [-Type<SqlTransforms>] [<CommonParameters>]
Parameter
Der Parameter EnableUnicodeOutput weist den DRDA-Dienst an, die Ausgabe des CLR-basierten SQL-Transformators in Unicode oder ANSI zu codieren. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert ist false, wodurch der DRDA-Dienst angewiesen wird, ANSI CHAR- und VARCHAR-Zeichenfolgen auszugeben.
Der Parameter Type weist den DRDA-Dienst an, interne Dienst- oder externe CLR-basierte SQL-Transformationen zu verwenden. Dieser optionale Parameter akzeptiert den Type-WertService oder Clr. Der Standardwert ist Service.
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
Set-HisDrdaSqlTransform -Type Service
Get-HisDrdaSqlTransform
Dieses Get-HisDrdaSqlTransform Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts ab, um interne oder externe CLR-basierte SQL-Transformationen zum Konvertieren der DB2-Funktionssyntax in SQL Server T-SQL-Funktionssyntax zu verwenden.
Syntax
Get-HisDrdaSqlTransforms [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-HisDrdaSqlTransforms Cmdlet gibt ein Objekt mit eigenschaften zurück: Type (SqlTransforms); und EnableUnicodeOutput (Boolescher Wert).
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte ab.
Get-HisDrdaSqlTransform
Type
----
Service
EnableUnicodeOutput
-------------------
False
Datenbankaliaszuordnung
IBM DB2- und Microsoft SQL Server Datenbanken verwenden unterschiedliche Terminologie für die Benennung von Objekten, wie in der folgenden Tabelle zu sehen ist, die den vollqualifizierten dreiteiligen Objektbezeichner für eine Tabelle definiert. Der DRDA-Dienst kann DB2-Katalog- und Schemanamen SQL Server Katalog- und Schemanamen zuordnen. Weitere Informationen finden Sie unter Konfigurieren von Datenbankaliaszuordnungen.
Add-HisDrdaDatabaseAlias
Dieses Add-HisDrdaDatabaseAlias Cmdlet konfiguriert den DRDA-Dienst für die Zuordnung von ingebundenen Katalog- und Schemanamen zu ausgehenden Katalog- und Schemanamen für die Ausführung statischer SQL-Pakete für DB2-Befehle, die SQL Server gespeicherten Prozeduren zugeordnet sind.
Syntax
Add-HisDrdaDatabaseAlias -SourceLocation-Zeichenfolge<> -SourceCollection-Zeichenfolge<> -TargetDatabase-Zeichenfolge<> -TargetSchema-Zeichenfolge<> [<CommonParameters>]
Parameter
Der Parameter SourceLocation definiert einen in-bound DRDA RDBNAM (Relational Database Name), den der DRDA-Dienst bei der Zuordnung zu einem out-bound SQL Server Datenbanknamen verwenden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die einen beliebigen Wert angibt.
Der SourceCollection-Parameter definiert einen in-bound DRDA COLID (Sammlungsbezeichner), den der DRDA-Dienst bei der Zuordnung zu einem out-bound SQL Server Schemanamen verwenden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die einen beliebigen Wert angibt.
Der Parameter TargetDatabase definiert einen out-bound SQL Server Datenbanknamen, den der DRDA-Dienst bei der Zuordnung von einem in-bound DRDA RDBNAM-Wert verwenden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die einen beliebigen Wert angibt.
Der Parameter TargetSchema definiert einen out-bound SQL Server Schemanamen, den der DRDA-Dienst bei der Zuordnung von einem gebundenen DRDA-COLID-Wert verwenden soll. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge, die einen beliebigen Wert angibt.
Beispiel
Der folgende Beispielbefehl fügt Beispielwerte hinzu.
Add-HisDrdaDatabaseAlias -SourceCollection DSN8HC91 -SourceLocation CONTOSO -TargetDatabase ContosoRetailDW -TargetSchema DSN8910
Get-HisDrdaDatabaseAlias
Dieses Get-HisDrdaDatabaseAlias Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts zum Zuordnen von ingebundenen Katalog- und Schemanamen zu ausgehenden Katalog- und Schemanamen ab, die beim Ausführen statischer SQL-Pakete für DB2-Befehle verwendet werden, die SQL Server gespeicherten Prozeduren zugeordnet sind.
Syntax
Get-HisDrdaDatabaseAlias [<CommonParameters>]
Parameter
Keine.
Ausgaben
Dieses Get-HisDrdaDatabaseAlias Cmdlet gibt ein Objekt mit einer Auflistung von Eigenschaften zurück: SourceLocation (Zeichenfolge); SourceCollection (Zeichenfolge); TargetDatabase (Zeichenfolge); und TargetSchema (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaDatabaseAlias
SourceLocation
--------------
CONTOSO
SourceCollection
----------------
DSN8HC91
TargetDatabase
--------------
ContosoRetailDW
TargetSchema
------------
DSN8910
Konvertierungen für DATUM und Uhrzeit des DRDA-Diensts
Der DRDA-Dienst formatiert bei der Verarbeitung dynamischer und statischer SQL-Anweisungen Zeichenfolgenliterale Datums-Uhrzeitwerte aus der Quelle und in Zielformate für bestimmte Datums- und Zeichendatentypen.
Add-DrdaDatetimeFormat
Dieses Add-DrdaDatetimeFormat-Cmdlet konfiguriert den DRDA-Dienst für die Verarbeitung von Zeichenfolgenliteraldatumswerten innerhalb der Datentypen DB2 und SQL Server DATE, CHAR (10) und VARCHAR (10), um vom DB2-Datumsformat in SQL Server Datumsformat und von SQL Server Datumsformat in das DB2-Datumsformat zu konvertieren. DateMasks enthält mindestens ein dateMask-Element zum Definieren von Datumszuordnungen. Das dateMask-Element enthält ein db2ToSql- oder sqlToDb2-Element, das die Richtung angibt, sowie ein sourceFormat- und ein targetFormat-Element, die die Zuordnung angeben. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren von Datums- und Uhrzeitkonvertierungen.
Syntax
Add-DrdaDatetimeFormat -Konvertierungskonvertierung <> -DateFormat <DateFormats> [<CommonParameters>]
Add-DrdaDatetimeFormat -Konvertierungskonvertierung><-TimeFormat <TimeFormats> [<CommonParameters>]
Add-DrdaDatetimeFormat -Konvertierungskonvertierung><-DateTimeFormat <DateTimeFormats> [<CommonParameters>]
Parameter
Der Konvertierungsparameter definiert die Richtung entweder DB2-zu-SQL oder SQL-zu-DB2. Dieser erforderliche Parameter akzeptiert einen enumerierten Konvertierungswert . Geben Sie Db2toSql an, um den DRDA-Dienst zum Lesen anzuweisen, um das in-bound DateTime-Format zu konvertieren. Geben Sie SqlToDb2 an, um den DRDA-Dienst anzuweisen, zu schreiben, um das out-bound DateTime-Format zu konvertieren.
Der DateFormat-Parameter definiert den Formattyp. Dieser erforderliche Parameter akzeptiert einen enumerierten DateFormat-Wert .
Der Parameter TimeFormat definiert den Formattyp. Dieser erforderliche Parameter akzeptiert einen enumerierten TimeFormat-Wert .
Der Parameter DateTimeFormat definiert den Formattyp. Dieser erforderliche Parameter akzeptiert einen enumerierten DateTimeFormat-Wert .
Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren von Datums- und Uhrzeitkonvertierungen.
Beispiel
Der folgende Beispielbefehl legt einen Date-Beispielwert fest.
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa
Der folgende Beispielbefehl legt einen Time-Beispielwert fest.
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod
Der folgende Beispielbefehl legt einen Date-Beispielwert fest.
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat
Get-HisDrdaDatetimeFormat
Dieses Get-HisDrdaDatetimeFormat Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts zum Verarbeiten von Zeichenfolgenliteraldatumswerten innerhalb von DB2 und SQL Server DATENTYPEN DATE, CHAR (10) und VARCHAR (10) ab, um vom DB2-Datumsformat in SQL Server Datumsformat zu konvertieren und von SQL Server Datumsformat in das DB2-Datumsformat zu konvertieren.
Syntax
Get-HisDrdaDatetimeFormat -DateTime<DateTime> [<CommonParameters>]
Parameter
Der Parameter DateTime weist den DRDA-Dienst an, eine konfigurierte Formatkonvertierung zurückzugeben. Dieser erforderliche Parameter akzeptiert einen aufgezählten DateTime-Wert . Es gibt keinen Standardwert . Geben Sie Datum an, um den DRDA-Dienst anzuweisen, die konfigurierte Konvertierung des Datumsformats zurückzugeben. Geben Sie Zeit an, um den DRDA-Dienst anzuweisen, die konfigurierte Zeitformatkonvertierung zurückzugeben. Geben Sie DateTime an, um den DRDA-Dienst anzuweisen, die konfigurierte DateTime-Formatkonvertierung zurückzugeben.
Ausgaben
Dieses Get-HisDrdaDatetimeFormat Cmdlet gibt ein Objekt mit einer Auflistung von Eigenschaften zurück: Db2ToSql (Zeichenfolge); und SqlToDb2 (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl ruft die Standardwerte für Date ab.
Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
Iso
SqlToDb2
--------
Iso
Der folgende Beispielbefehl ruft die Standardwerte für Time ab.
Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
HmsColong
HmsPeriod
SqlToDb2
--------
HmsColon
Der folgende Beispielbefehl ruft die DateTime-Standardwerte ab.
Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
Db2TimestampFormat
SqlToDb2
--------
Db2TimestampFormat
Remove-HisDrdaDatetimeFormat
Dieses Remove-HisDrdaDatetimeFormat-Cmdlet entfernt mindestens eine DRDA-Dienstkonfigurationseinstellungen für die Verarbeitung von Zeichenfolgenliteraldatumswerten innerhalb von DB2 und SQL Server Datentypen DATE, CHAR (10) und VARCHAR (10), um vom DB2-Datumsformat in SQL Server Datumsformat zu konvertieren und von SQL Server Datumsformat in das DB2-Datumsformat zu konvertieren.
Syntax
Remove-HisDrdaDatetimeFormat -DateTime DateTime<> -Conversion<Conversion> -Formatzeichenfolge<> [<CommonParameters>]
Parameter
Der Parameter DateTime weist den DRDA-Dienst an, eine konfigurierte Formatkonvertierung zu entfernen. Dieser erforderliche Parameter akzeptiert einen aufgezählten DateTime-Wert . Es gibt keinen Standardwert . Geben Sie Datum an, um den DRDA-Dienst anzuweisen, die konfigurierte Konvertierung des Datumsformats zu entfernen. Geben Sie Zeit an, um den DRDA-Dienst anzuweisen, die konfigurierte Zeitformatkonvertierung zu entfernen. Geben Sie DateTime an, um den DRDA-Dienst anzuweisen, die konfigurierte DateTime-Formatkonvertierung zu entfernen.
Der Konvertierungsparameter definiert die Richtung entweder DB2-zu-SQL oder SQL-zu-DB2. Dieser erforderliche Parameter akzeptiert einen enumerierten Konvertierungswert . Geben Sie Db2toSql an, um den DRDA-Dienst zum Lesen anzuweisen, um das in-bound DateTime-Format zu konvertieren. Geben Sie SqlToDb2 an, um den DRDA-Dienst anzuweisen, zu schreiben, um das out-bound DateTime-Format zu konvertieren.
Der Format-Parameter definiert den Formattyp. Dieser erforderliche Parameter akzeptiert einen enumerierten DateFormat-, TimeFormat- oder DateTimeFormat-Wert .
Beispiel
Der folgende Beispielbefehl entfernt einen Date-Beispielwert.
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Date -Format Usa
Der folgende Beispielbefehl legt einen Time-Beispielwert fest.
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Time -Format HmsPeriod
Der folgende Beispielbefehl legt einen Date-Beispielwert fest.
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime DateTime -Format IsoTimestampFormat
DRDA-Dienstcodierungen
Der DRDA-Dienst ordnet Codepages zu und unterstützt benutzerdefinierte Codepagekonvertierungen mithilfe einer zugrunde liegenden HIS Encoder-Komponente und der Windows National Language Support (NLS)-Systemkomponenten. Mit Microsoft Windows Update können Sie zusätzliche Windows-Sprachpakete installieren, die Windows NLS-Codepagekonvertierungsbibliotheken enthalten. Optional kann der HIS-Encoder eine benutzerdefinierte NLS-Codepage laden, die auf codePage-Elementen basiert, die im codePages-Teil der MsDrdaService.exe.config-Datei definiert sind. Der HIS-Encoder kann benutzerdefinierte Codepunkte innerhalb von Standard-NLS und benutzerdefinierten NLS-Codepages basierend auf ebcdicToUnicodeConversion-Elementen zuordnen, die im codePages-Teil der MsDrdaService.exe.config-Datei definiert sind. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Konfigurieren von Dienstcodierungen.
Add-HisCustomCodePage
Dieses Add-HisCustomCodePage Cmdlet konfiguriert den DRDA-Dienst, um die HIS Encoder-Komponente anzuweisen, eine benutzerdefinierte NLS-Systemcodepage-Konvertierungsdatei (Windows National Language Support) zu laden.
Syntax
Add-HisCustomCodePage -CodePage<uint32> -Name<string> -NlsCodePage<uint32> [-Description<string>] [<CommonParameters>]
Parameter
Der CodePage-Parameter weist den HIS-Encoder an, eine nummerierte benutzerdefinierte NLS-Codepagedatei zu laden. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Parameter Name benennt die benutzerdefinierte NLS-Codepage, die vom HIS-Encoder geladen werden soll, basierend auf der definierten benutzerdefinierten NLS-Codepagenummer. Dieser erforderliche Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Der Parameter NlsCodePage definiert, welche NLS-Standardcodepagenummer vom HIS-Encoder durch die benutzerdefinierte Codepagenummer ersetzt werden soll. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Description-Parameter beschreibt die benutzerdefinierte NLS-Codepage, die der HIS-Encoder basierend auf der definierten benutzerdefinierten NLS-Codepagenummer laden soll. Dieser optionale Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"
Get-HisCustomCodePage
Dieses Get-HisCustomCodePage-Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts ab, um die HIS Encoder-Komponente anzuweisen, eine benutzerdefinierte NLS-Systemcodepage-Konvertierungsdatei (Windows National Language Support) zu laden.
Syntax
Get-HisCustomCodePage [-CodePage<uint32>] [-Name<string>] [-NlsCodePage<uint32>] [<CommonParameters>]
Parameter
Der CodePage-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser nummerierten benutzerdefinierten NLS-Codepagedatei abzurufen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Name-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieses benutzerdefinierten NLS-Codepagenamens abzurufen. Dieser optionale Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Der Parameter NlsCodePage weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser benutzerdefinierten Codepagenummer abzurufen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Ausgaben
Dieses Get-HisCustomCodePage Cmdlet gibt ein Objekt mit eigenschaften zurück: Name (Zeichenfolge); CodePage (ganze Zahl); NlsCodePage (ganze Zahl); und Beschreibung (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140
Name
----
Custom21140
CodePage
--------
21140
Description
-----------
Custom code based on 1140
NlsCodePage
1140
Remove-HisCustomCodePage
Dieses Remove-HisCustomCodePage Cmdlet entfernt die Konfigurationseinstellungen des DRDA-Diensts, um die HIS Encoder-Komponente anzuweisen, eine benutzerdefinierte NlS-Systemcodepage-Konvertierungsdatei (Windows National Language Support) zu laden.
Syntax
Remove-HisCustomCodePage [-Name] <-Zeichenfolge> [<CommonParameters>]
Parameter
Der Name-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe des benutzerdefinierten NLS-Codepagenamens zu entfernen. Dieser erforderliche Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Beispiel
Der folgende Beispielbefehl entfernt Beispielwerte.
Remove-HisCustomCodePage -Name Custom21140
Add-HisCustomConversion
Dieses Add-HisCustomConversion-Cmdlet konfiguriert den DRDA-Dienst so, dass Codepunktzuordnungen innerhalb von Standard-NLS- und benutzerdefinierten NLS-Codepages außer Kraft gesetzt werden.
Syntax
Add-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]
Add-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]
Parameter
Der CodePage-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser nummerierten NLS-Codepagedatei hinzuzufügen. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Name-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser benutzerdefinierten NLS-Codepagenamendatei hinzuzufügen. Dieser erforderliche Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Der EbcdicToUnicode-Parameter weist den HIS-Encoder an, vom angegebenen EBCDIC-Codepunkt zu konvertieren. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert in Form von "To=From", wobei "To" EBCDIC-Codepunktwert und "From" der Unicode-Hexcodepunktwert ist. Der Standardwert ist eine leere Zeichenfolge.
Der UnicodeToEbcdic-Parameter weist den HIS-Encoder an, aus dem angegebenen Unicode-Codepunkt zu konvertieren. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert in Form von "To=From", wobei "To" der Unicode-Sechsfachcodepunktwert und der "From" der EBCDIC-Sechsfachcodepunktwert ist. Der Standardwert ist eine leere Zeichenfolge.
Get-HisCustomConversion
Dieses Get-HisCustomConversion Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts zum Überschreiben von Codepunktzuordnungen innerhalb von Standard-NLS und benutzerdefinierten NLS-Codepages ab.
Syntax
Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode | UnicodeToEbcdic} -CodePage <uint32> [<CommonParameters>]
Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode | UnicodeToEbcdic} -Name <string> [<CommonParameters>]
Parameter
Der CodePage-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser nummerierten NLS-Codepagedatei abzurufen. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Name-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser benutzerdefinierten NLS-Codepagenamendatei abzurufen. Dieser erforderliche Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Der Type-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser nummerierten NLS-Codepagedatei oder der benutzerdefinierten NLS-Codepagenamendatei abzurufen. Dieser erforderliche Parameter akzeptiert einen aufgezählten Wert von EbcdicToUnicode oder UnicodeToEbcdic.
Ausgaben
Dieses Get-HisCustomConversion Cmdlet gibt ein Objekt mit Eigenschaften zurück: From (Hex); und An (Hex).
Remove-HisCustomConversion
Dieses Remove-HisCustomConversion Cmdlet entfernt die Konfigurationseinstellungen des DRDA-Diensts zum Überschreiben von Codepunktzuordnungen innerhalb von Standard-NLS und benutzerdefinierten NLS-Codepages.
Syntax
Remove-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]
Remove-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]
Parameter
Der CodePage-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser nummerierten NLS-Codepagedatei abzurufen. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 0.
Der Name-Parameter weist den DRDA-Dienst an, Konfigurationseinstellungen mithilfe dieser benutzerdefinierten NLS-Codepagenamendatei abzurufen. Dieser erforderliche Parameter akzeptiert eine Zeichenfolge. Der Standardwert ist eine leere Zeichenfolge.
Der EbcdicToUnicode-Parameter weist den HIS-Encoder an, vom angegebenen EBCDIC-Codepunkt zu konvertieren. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Der UnicodeToEbcdic-Parameter weist den HIS-Encoder an, aus dem angegebenen Unicode-Codepunkt zu konvertieren. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
DRDA-Dienstanwendungscodierungen
DER DRDA-Dienst konvertiert Basiscodeseiten und ordnet Codepunkte mithilfe einer zugrunde liegenden HIS Encoder-Komponente und der Windows National Language Support (NLS)-Systemkomponenten zu. Das applicationEncodings-Element enthält applicationEncoding-Elemente zum Angeben von Standardcodierungsschemas auf Anwendungsebene auf Datenbankbasis. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Konfigurieren von Anwendungscodierungen.
Add-HisDrdaApplicationEncoding
Dieses Add-HisDrdaApplicationEncoding Cmdlet konfiguriert den DRDA-Dienst für standardbasierte Codierungsschemas auf Anwendungsebene auf Datenbankbasis für die Verwendung durch die HIS Encoder-Komponente und die NlS-Systemkomponenten (Windows National Language Support) in Zuordnungscodepunkten innerhalb von Codepages. Weitere Informationen und eine Beschreibung der Werte finden Sie unter Konfigurieren von Anwendungscodierungen.
Syntax
Add-HisDrdaApplicationEncoding -Ccsid<uint32> -Datenbankzeichenfolge<> [-Schemazeichenfolge<>] [<CommonParameters>]
Add-HisDrdaApplicationEncoding -Datenbankzeichenfolge<> -CustomCcsid<uint32> [-Schemazeichenfolge<>] [<CommonParameters>]
Parameter
Der Ccsid-Parameter weist den DRDA-Dienst an, Ausgabeparameter- und Resultsetwerte zu codieren, indem eine CCSID (Coded Character Set Identifier) und nicht die VOM DRDA AR-Client angeforderte CCSID verwendet wird. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 1208.
Der CustomCcsid-Parameter weist den DRDA-Dienst an, Ausgabeparameter- und Resultsetwerte mithilfe einer benutzerdefinierten CCSID (Coded Character Set Identifier) zu codieren und nicht die vom DRDA AR-Client angeforderte CCSID zu codieren. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist -1.
Der Database-Parameter weist den DRDA-Dienst an, Ausgabeparameter- und Resultsetwerte nur für ein angegebenes Ziel SQL Server Datenbank mithilfe eines Außerkraftsetzungscodierungsschemas und nicht mit dem vom DRDA-AR-Client angeforderten Codierungsschema zu codieren. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Der Schemaparameter weist den DRDA-Dienst an, Ausgabeparameter- und Resultsetwerte mithilfe eines Außerkraftsetzungscodierungsschemas zu codieren und nicht das vom DRDA-AR-Client angeforderte Codierungsschema. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Die unterstützten Werte sind Ebcdic, Unicode und Ansi. Der Standardwert ist Unicode.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Add-HisDrdaApplicationEncoding -Ccsid 1140 -Database NWIND1 -Scheme Ebcdic
Der folgende Beispielbefehl legt die Standardwerte fest.
Add-HisDrdaApplicationEncoding -CustomCcsid 1234 -Database NWIND1 -Scheme Ebcdic
Get-HisDrdaApplicationEncoding
Dieses Get-HisDrdaApplicationEncoding-Cmdlet ruft die KONFIGURATIONSeinstellungen des DRDA-Diensts für Standardcodierungsschemas auf Anwendungsebene auf Datenbankbasis ab, um von der HIS Encoder-Komponente und nlS-Systemkomponenten (Windows National Language Support) in Zuordnungscodepunkten innerhalb von Codepages verwendet zu werden.
Syntax
Get-HisDrdaApplicationEncoding [-Ccsid<uint32>] [-Database<string>] [-CustomCcsid<uint32>] [<CommonParameters>]
Parameter
Der Ccsid-Parameter weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe einer CCSID (Coded Character Set Identifier) abzurufen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 1208.
Der Parameter CustomCcsid weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe einer benutzerdefinierten CCSID (Coded Character Set Identifier) abzurufen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist -1.
Der Parameter Database weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe eines angegebenen Ziels SQL Server Datenbanknamens abzurufen. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Ausgaben
Dieses Get-HisDrdaApplicationEncoding-Cmdlet gibt ein Objekt mit Eigenschaften zurück: Schema (Zeichenfolge); Ccsid (ganze Zahl); Datenbank (Zeichenfolge); und CustomCcsid (ganze Zahl).
Beispiel
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaApplicationEncoding
Scheme
------
Ebcdic
Ebcdic
Ccsid
-----
1140
Database
--------
NWIND1
NWIND1
Customccsid
-----------
1234
Remove-HisDrdaApplicationEncoding
Dieses Remove-HisDrdaApplicationEncoding Cmdlet entfernt die Konfigurationseinstellungen des DRDA-Diensts für Standardcodierungsschemas auf Anwendungsebene auf Datenbankbasis zur Verwendung durch die HIS Encoder-Komponente und nlS-Systemkomponenten (Windows National Language Support) in Zuordnungscodepunkten innerhalb von Codepages.
Syntax
Remove-HisDrdaApplicationEncoding -Ccsid<string[]> [-Database<string>] [<CommonParameters>]
Remove-HisDrdaApplicationEncoding -CustomCcsid<string[]> [-Database<string>] [<CommonParameters>]
Parameter
Der Parameter Ccsid weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe einer CCSID (Coded Character Set Identifier) zu entfernen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 1208.
Der Parameter CustomCcsid weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe einer benutzerdefinierten CCSID (Coded Character Set Identifier) zu entfernen. Dieser optionale Parameter akzeptiert eine ganze Zahl. Der Standardwert ist -1.
Der Parameter Database weist den DRDA-Dienst an, die Anwendungscodierungskonfiguration mithilfe eines angegebenen Ziels SQL Server Datenbanknamens zu entfernen. Dieser optionale Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist eine leere Zeichenfolge.
Beispiel
Der folgende Beispielbefehl entfernt Beispielwerte.
Remove-HisDrdaApplicationEncoding -Ccsid 1140
Der folgende Beispielbefehl entfernt Beispielwerte.
Remove-HisDrdaApplicationEncoding -CustomCcsid 1234
DRDA-Dienstsortierungszuordnung
Der DRDA-Dienst ordnet die Sortierungssyntax zu, um die plattformübergreifende Kompatibilität von Abfrageergebnissen zu gewährleisten. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren der Sortierungszuordnung.
Add-HisDrdaCollationName
Dieses Add-HisDrdaCollationName-Cmdlet konfiguriert den DRDA-Dienst für die Transformation einer SELECT-Anweisung aus DB2 ORDER BY COLLATION_KEY Syntax (Sortierungsname) in SQL Server T-SQL ORDER BY COLLATE-Syntax (collation_name), wobei die Zuordnung von einem DB2-Sortierungsnamenwert zu einem SQL Server collation_name-Wert erfolgt, um kompatiblere Abfrageergebnisse bereitzustellen. Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren der Sortierungszuordnung.
Syntax
Add-HisDrdaCollationName -To <string> -From <string> [<CommonParameters>]
Parameter
Der To-Parameter weist den SQL-Transformator des DRDA-Diensts an, in die angegebene collation_name Zeichenfolge innerhalb einer SQL Server SELECT ORDER BY COLLATE-Klausel zu konvertieren. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Der From-Parameter weist den DRDA Service SQL Transformer an, die angegebene Sortierungsnamenzeichenfolge innerhalb einer DB2 SELECT ORDER BY COLLATION_KEY-Klausel zu konvertieren. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS
Get-HisDrdaCollationName
Dieses Get-HisDrdaCollationName Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts zum Transformieren einer SELECT-Anweisung von DB2 ORDER BY COLLATION_KEY Syntax (Sortierungsname) in SQL Server T-SQL ORDER BY COLLATE-Syntax (collation_name) ab, wobei die Zuordnung von einem DB2-Sortierungsnamenwert zu einem SQL Server collation_name-Wert erfolgt, um kompatiblere Abfrageergebnisse bereitzustellen.
Syntax
Get-HisDrdaCollationName [-To<string>] [-From<string>] [<CommonParameters>]
Parameter
Der To-Parameter weist die Konfiguration des DRDA-Diensts zum Abrufen von Sortierungsnamen mithilfe der angegebenen collation_name Zeichenfolge an. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Der From-Parameter weist die Konfiguration des DRDA-Diensts zum Abrufen von Sortierungsnamen mithilfe der angegebenen Sortierungsnamenzeichenfolge innerhalb einer DB2 SELECT ORDER BY COLLATION_KEY-Klausel an. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Ausgaben
Dieses Get-HisDrdaCollationName-Cmdlet gibt ein Objekt mit eigenschaften zurück: An (Zeichenfolge); und From (Zeichenfolge).
Beispiel
Der folgende Beispielbefehl legt die Standardwerte fest.
Get-HisDrdaCollationName
To
--
SQL_EBCDIC037_CP1_CS_AS
From
----
UCA400R1_LEN_AN
Remove-HisDrdaCollationName
Dieses Remove-HisDrdaCollationName Cmdlet entfernt die Konfigurationseinstellungen des DRDA-Diensts, um einer ORDER BY-Klausel basierend auf einem standardmäßigen ORDER BY-Sortierungsnamen eine COLLATE-Klausel hinzuzufügen.
Syntax
Remove-HisDrdaCollationName -RemoveAll<bool> [-To<string>] [-From<string>] [<CommonParameters>]
Parameter
Der To-Parameter weist den DRDA-Dienst an, die Sortierungsnamenkonfiguration mithilfe der angegebenen collation_name Zeichenfolge zu entfernen. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Der From-Parameter weist die Konfiguration des DRDA-Diensts zum Entfernen von Sortierungsnamen mithilfe der angegebenen Sortierungsnamenzeichenfolge innerhalb einer DB2 SELECT ORDER BY COLLATION_KEY-Klausel an. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Es ist kein Standardwert vorhanden.
Beispiel
Der folgende Beispielbefehl entfernt Beispielwerte.
Remove-HisDrdaCollationName -From UCA400R1_LEN_AN
Konfigurieren von Ablaufverfolgungslistenern
Der DRDA-Dienst unterstützt mehrere gleichzeitige Ablaufverfolgungslistener, einschließlich: Textablaufverfolgungslistener, Konsolen-Ablaufverfolgungslistener, benutzerdefinierter Ablaufverfolgungslistener und ETW-Ablaufverfolgungslistener (Event Trace for Windows). Weitere Informationen und Eine Beschreibung der Werte finden Sie unter Datenintegration (Bereitstellung), DRDA-Dienst, Konfigurieren von Ablaufverfolgungslistenern.
Set-HisDrdaConsoleTraceListener
Das Cmdlet Set-HisDrdaConsoleTraceListener konfiguriert den Ablaufverfolgungslistener der DRDA-Dienstkonsole so, dass Ablaufverfolgungsdaten in ein Befehlskonsolenfenster geschrieben werden.
Syntax
Set-HisDrdaConsoleTraceListener -Level <uint32> [<CommonParameters>]
Parameter
Der Level-Parameter weist den DRDA-Dienst an, definierte Informationssammlungen von einem Minimum bis zu einer maximalen Ablaufverfolgungsebene nachzuverfolgen. Dieser erforderliche Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 0.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Gibt keine Ablaufverfolgungsmeldungen aus. |
| 1 | Ausgeben von Fehlermeldungen. |
| 2 | Gibt Warnmeldungen und Fehlermeldungen aus. |
| 3 | Ausgabeinformationsmeldungen, Warnmeldungen und Fehlermeldungen. |
| 4 | Ausgeben aller Nachrichten. |
Tabelle AUTONUM \\ Arabisch Ablaufverfolgungsebenen.*
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Set-HisDrdaConsoleTraceListener -Level 3
Set-HisDrdaEtwTraceListener
Das Cmdlet Set-HisDrdaEtwTraceListener konfiguriert den DRDA-Dienst ETW (Ereignisablaufverfolgung für Windows) als ETW-Anbieter, um Ablaufverfolgungsdaten über eine ETW-Sitzung an einen ETW-Controller des Windows-Betriebssystems auszugeben.
Syntax
Set-HisDrdaEtwTraceListener -Level <uint32> [<CommonParameters>]
Parameter
Der Level-Parameter weist den DRDA-Dienst an, definierte Informationssammlungen von einem Minimum bis zu einer maximalen Ablaufverfolgungsebene nachzuverfolgen. Dieser erforderliche Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 0.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Gibt keine Ablaufverfolgungsmeldungen aus. |
| 1 | Ausgeben von Fehlermeldungen. |
| 2 | Gibt Warnmeldungen und Fehlermeldungen aus. |
| 3 | Ausgabeinformationsmeldungen, Warnmeldungen und Fehlermeldungen. |
| 4 | Ausgeben aller Nachrichten. |
Tabelle AUTONUM \\ Arabisch Ablaufverfolgungsebenen.*
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Set-HisDrdaEtwTraceListener -Level 3
Set-HisDrdaEventLogTraceListener
Das Cmdlet Set-HisDrdaEventLogTraceListener konfiguriert den DRDA-Dienstereignisprotokolllistener, der Protokolldaten in das Windows-Ereignisprotokoll ausgibt.
Syntax
Set-HisDrdaEventLogTraceListener -InitializeData-Zeichenfolge <> [<CommonParameters>]
Parameter
Der Parameter InitializeData weist den DRDA-Dienst an, definierte Informationssammlungen zu protokollieren. Dieser erforderliche Parameter akzeptiert einen Zeichenfolgenwert . Der Standardwert ist "Fehler, Warnung, Information", der alle Ereignisprotokollebenen enthält.
| Wert | BESCHREIBUNG |
|---|---|
| Fehler | Dieser Wert weist den DRDA-Dienst an, nur die Fehlerebenendaten zu protokollieren. |
| Warnung | Dieser Wert weist den DRDA-Dienst an, nur die Warnstufendaten zu protokollieren. |
| Information | Dieser Wert weist den DRDA-Dienst an, nur die Daten der Informationsebene zu protokollieren. |
Tabelle AUTONUM \\ Arabisch Ereignisprotokollebenen.*
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Set-HisDrdaEventLogTraceListener -InitializeData Warning
Set-HisDrdaTextTraceListener
Mit dem Cmdlet Set-HisDrdaTextTraceListener wird der Textablaufverfolgungslistener des DRDA-Diensts so konfiguriert, dass Ablaufverfolgungsdaten im Textformat in eine Datenträgerdatei geschrieben werden.
Syntax
Set-HisDrdaTextTraceListener -Level <uint32> [-InitializeData <string>] [-AutoFlush <bool>] [-MaxTraceEntryCount <uint32>] [-MaxTraceFileCount <uint32>] [<CommonParameters>]
Parameter
Der Level-Parameter weist den DRDA-Dienst an, definierte Informationssammlungen von einem Minimum bis zu einer maximalen Ablaufverfolgungsebene nachzuverfolgen. Dieser erforderliche Parameter akzeptiert einen ganzzahligen Wert. Der Standardwert ist 0.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Gibt keine Ablaufverfolgungsmeldungen aus. |
| 1 | Ausgeben von Fehlermeldungen. |
| 2 | Gibt Warnmeldungen und Fehlermeldungen aus. |
| 3 | Ausgabeinformationsmeldungen, Warnmeldungen und Fehlermeldungen. |
| 4 | Ausgeben aller Nachrichten. |
Tabelle x. Ablaufverfolgungsebenen.
Der AutoFlush-Parameter weist den DRDA-Dienst an, Daten automatisch in den Ablaufverfolgungslistener zu leeren. Dieser erforderliche Parameter akzeptiert einen booleschen Wert. Die Standardeinstellung ist false.
Hinweis
Der DRDA-Dienst kann Ablaufverfolgungsdaten automatisch an die Ablaufverfolgungslistener leeren, wodurch sichergestellt wird, dass die Ablaufverfolgungsdaten erfasst werden, aber die Datenträger-E/A-Vorgänge erhöhen und die Gesamtleistung des Systems verringern. Um die Leistung zu verbessern, legen Sie AutoFlush=$False fest, um die automatische Ablaufverfolgungsleerung zu deaktivieren.
Der Parameter MaxTraceEntryCount weist den DRDA-Dienst an, bis zu einer maximalen Anzahl von Einträgen nachzuverfolgen und dann die Ablaufverfolgung zu beenden. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 1000000.
Der Parameter MaxTraceFileCount weist den DRDA-Dienst an, die Textlistener-Ablaufverfolgungsausgabe eine maximale Anzahl einzelner Ablaufverfolgungsdateien zu schreiben und dann vorhandene Ablaufverfolgungsdateien zu überschreiben. Dieser erforderliche Parameter akzeptiert eine ganze Zahl. Der Standardwert ist 10.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10
Start-HisDrdaTraceListener
Dieses Start-HisDrdaTraceListener Cmdlet weist den DRDA-Dienst an, den angegebenen Typ des Ablaufverfolgungslisteners zu starten.
Syntax
Start-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
Parameter
Der Listener-Parameter weist den DRDA-Dienst an, den angegebenen Ablaufverfolgungslistenertyp zu starten. Dieser erforderliche Parameter akzeptiert den Listenerwert Console, Text, Etw oder EventLog. Es ist kein Standardwert vorhanden.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Start-HisDrdaTraceListener -Listener Console
Der folgende Beispielbefehl legt Beispielwerte fest.
Start-HisDrdaTraceListener -Listener Text
Der folgende Beispielbefehl legt Beispielwerte fest.
Start-HisDrdaTraceListener -Listener Etw
Der folgende Beispielbefehl legt Beispielwerte fest.
Start-HisDrdaTraceListener -Listener EventLog
Get-HisDrdaTraceListener
Dieses Get-DrdaTextTraceListener Cmdlet ruft die Konfigurationseinstellungen des DRDA-Diensts für den Textablaufverfolgungslistener ab, um Ablaufverfolgungsdaten im Textformat in eine Datenträgerdatei zu schreiben.
Syntax
Get-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
Parameter
Der Listener-Parameter weist den DRDA-Dienst an, die Konfiguration für den angegebenen Ablaufverfolgungslistenertyp abzurufen. Dieser erforderliche Parameter akzeptiert den Listenerwert Console, Text, Etw oder EventLog. Es ist kein Standardwert vorhanden.
Ausgaben
Dieses Get-HisDrdaTraceListener-Cmdlet gibt eine Auflistung von Eigenschaften zurück.
Beispiel
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaTraceListener -Listener Console
Status
------
Enabled
Level
-----
3
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaTraceListener -Listener Text
InitializeData : MsDrdaService.DSTF
AutoFlush : True
MaxTraceEntries : 1000000
MaxTraceFiles : 10
Status : Enabled
Level : 3
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaTraceListener -Listener Etw
Status
------
Enabled
Level
-----
3
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaTraceListener -Listener Console
InitializeData
--------------
Warning
Status
------
Enabled
Stop-HisDrdaTraceListener
Dieses Stop-HisDrdaTraceListener Cmdlet weist den DRDA-Dienst an, den angegebenen Typ des Ablaufverfolgungslisteners zu beenden.
Syntax
Stop-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
Parameter
Der Listener-Parameter weist den DRDA-Dienst an, die Konfiguration für den angegebenen Ablaufverfolgungslistenertyp abzurufen. Dieser erforderliche Parameter akzeptiert den Listenerwert Console, Text, Etw oder EventLog. Es ist kein Standardwert vorhanden.
Beispiel
Der folgende Beispielbefehl legt Beispielwerte fest.
Get-HisDrdaTraceListener -Listener Console
Der folgende Beispielbefehl legt Beispielwerte fest.
Get-HisDrdaTraceListener -Listener Text
Der folgende Beispielbefehl legt Beispielwerte fest.
Get-HisDrdaTraceListener -Listener Etw
Der folgende Beispielbefehl legt Beispielwerte fest.
Get-HisDrdaTraceListener -Listener EventLog
DRDA-Dienstpaketbindungslistener
Der DRDA-Dienst unterstützt benutzerdefinierte Paketbinder in Form eines .NET Framework benutzerdefinierten Listeners.
Add-HisDrdaPackageBindListener
Dieses Add-HisDrdaPackageBindListener-Cmdlet fügt eine DRDA-Dienstkonfiguration zum Senden eines Bindungspakets mit ausgabe von bind SQL-Anweisung an einen optionalen benutzerdefinierten Bindungslistener hinzu.
Syntax
Add-HisDrdaPackageBindListener -TypeName-Zeichenfolge<> [-ThrowWhenNoCallback ] [<CommonParameters>]
Parameter
Der TypeName-Parameter definiert den Typ des benutzerdefinierten DRDA-Dienstbindungslisteners. Dieser obligatorische Parameter akzeptiert eine Zeichenfolge. Es ist kein Standardwert vorhanden. Der Type-Wert für das Benutzerdefinierte Paketbindungslistenerbeispiel ist "CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL".
Der ThrowWhenNoCallback-Parameter weist den DRDA-Dienst an, BGNBNDRM (Begin Bind Reply Message) an den DRDA AR-Client zurückzugeben, wenn die benutzerdefinierte Bindungslistenerkomponente keine Informationen zur Rückrufschnittstelle zurückgibt. Dieser optionale Parameter akzeptiert einen booleschen Wert. Der Standardwert lautet true.
Beispiel
Im folgenden Beispielbefehl werden Beispielwerte hinzugefügt.
Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback
Get-HisDrdaPackageBindListener
Mit diesem Get-HisDrdaPackageBindListener Cmdlet werden die Konfigurationseinstellungen des DRDA-Diensts zum Senden des Bindungspakets mit einer Ausgabe der SQL-Anweisung an einen optionalen benutzerdefinierten Bindungslistener abgerufen.
Syntax
Get-HisDrdaPackageBindListener [-Type<string>] [<CommonParameters>]
Parameter
Der Parameter Type definiert den Typ des benutzerdefinierten DRDA-Dienstbindungslisteners. Dieser obligatorische Parameter akzeptiert eine Zeichenfolge. Es ist kein Standardwert vorhanden. Der Type-Wert für das Benutzerdefinierte Paketbindungslistenerbeispiel ist "CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL".
Beispiel
Der folgende Beispielbefehl ruft Beispielwerte ab.
Get-HisDrdaPackageBindListener
PackageBindListener:
type=CustomListeners.MyPackageBindListener
errorWhenNoCallback=True
Remove-HisDrdaPackageBindListener
Dieses Remove-HisDrdaPackageBindListener Cmdlet entfernt die Konfigurationseinstellungen des DRDA-Diensts, um einen benutzerdefinierten Ablaufverfolgungslistener hinzuzufügen.
Syntax
Remove-HisDrdaPackageBindListener -TypeName-Zeichenfolge<> [<CommonParameters>]
Parameter
Der Parameter Type definiert den Typ des benutzerdefinierten DRDA-Dienstbindungslisteners. Dieser obligatorische Parameter akzeptiert eine Zeichenfolge. Es ist kein Standardwert vorhanden. Der Type-Wert für das Benutzerdefinierte Paketbindungslistenerbeispiel ist "CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL".
Beispiel
Der folgende Beispielbefehl entfernt Beispielwerte.
Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener