mqsisetdbparms-Befehl

Mit dem Befehl mqsisetdbparms können einem Datenquellennamen (Data Source Name, DSN), auf den aus einem Nachrichtenfluss zugegriffen wird, eine bestimmte Benutzer-ID und ein Kennwort zugeordnet werden.

Unterstützte Plattformen

  • Windows
  • Linux- und UNIX-Systeme
  • z/OS Führen Sie diesen Befehl aus, indem Sie BIPSDBP anpassen und übergeben.

Zweck

Verwenden Sie den Befehl mqsisetdbparms, um die Benutzer-ID/Kennwort-Paare, die dem angegebenen Datenquellennamen (DSN) zugeordnet sind, zu erstellen, zu ändern oder zu löschen.

Datenquellennamen werden in folgenden Knoten verwendet:
  • Compute
  • Datenbank
  • DatabaseRetrieve
  • DatabaseRoute
  • DataDelete
  • DataInsert
  • DataUpdate
  • FileInput
  • FileOutput
  • Filter
  • Zuordnung
  • Warehouse
Wenn Sie denselben DSN in mehreren Knoten verwenden, um auf dieselbe Datenbankinstanz zu verweisen, wird überall dasselbe Benutzer-ID/Kennwort-Paar verwendet.

Datenquellennamen dienen auch dazu, einer JDBC-Verbindung des Typs 4 Benutzer-ID/Kennwort-Paare zuzuordnen. Geben Sie den DSN an, der in diesem Befehl als Parameter -n securityIdentity für den Befehl mqsicreateconfigurableservice oder mqsichangeproperties verwendet wird.

Das Benutzer-ID/Kennwort-Paar wird im DSN-Ordner unter dem Registrierungsordner des Brokers erstellt.

Wenn der Broker aktiv ist, kann dieser Befehl nicht ausgeführt werden. Deshalb müssen Sie den Broker stoppen, bevor Sie diesen Befehl ausführen.

Der Befehl mqsisetdbparms kann nicht für das Konfigurationsrepository oder die Brokerdatenbank ausgeführt werden. Dieser Befehl kann zwar erfolgreich ausgegeben werden, um den Datenquellennamen anzugeben, der vom Broker für den Zugriff auf seine Datenbank verwendet wird. Er hat aber keine Auswirkung auf die Benutzer-ID, die für den Zugriff auf Datenbanken verwendet wird, einschließlich Benutzerdatenbanken, auf die vom betreffenden Datenquellennamen verwiesen wird.

Syntax

Erstellen

Ändern

Löschen

Parameter

Brokername
(Erforderlich) Der Name des Brokers, für den die Einstellungen erstellt, geändert oder gelöscht werden sollen.
-n DataSourceName
(Erforderlich) Dieser Parameter identifiziert eine der folgenden Ressourcen:
  • Die Datenquelle, für die das Benutzer-ID/Kennwort-Paar erstellt oder geändert werden soll.
  • Der Name der Sicherheitsidentität, die zur Authentifizierung einer Verbindung zu einem FTP-Server verwendet wird. Der Datenquellenname hat das Format ftp::secId, wobei secId als der Wert der Eigenschaft Sicherheitsidentität des FileInput- oder FileOutput-Knotens bzw. in der Eigenschaft securityIdentity der Definition des konfigurierbaren FtpServer-Service angegeben ist.
  • Der Name der Sicherheitsidentität, die zur Authentifizierung einer JDBC-Verbindung des Typs 4 verwendet wird. Sie müssen den Befehl mqsichangeproperties ausführen, um die Eigenschaft securityIdentity zu zugeordneten konfigurierbaren JDBCProvider-Service so zu ändern, dass er mit dem in diesem Befehl angegebenen Datenquellennamen übereinstimmt.
-u DataSourceUserId
(Erforderlich für die Erstellung, optional bei Änderungen) Die Benutzer-ID, die dieser Datenquelle zugeordnet werden soll.
-p DataSourcePassword
(Erforderlich für die Erstellung und für Änderungen) Das Kennwort, das dieser Datenquelle zugeordnet werden soll.

Um die Kompatibilität mit vorhandenen Systemen sicherzustellen, kann nach wie vor noch <Kennwort> angegeben werden. Wird jedoch bei Ausführung des Befehls kein Kennwort für diesen Parameter angegeben, werden Sie beim Aufrufen des Befehls dazu aufgefordert, eines anzugeben und dieses anschließend noch ein zweites Mal einzugeben, um sicherzustellen, dass es korrekt eingegeben wurde.

-d
(Erforderlich für Löschvorgänge) Dieser Parameter löscht das Benutzer-ID/Kennwort-Paar für diese Datenquelle aus der Registrierung.

Autorisierung

Windows platform Auf Windows-Systemen muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, auf dem lokalen System über die Administratorberechtigung verfügen.

Linux platform UNIX platform Unter Linux und UNIX-Systeme muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, zur Gruppe mqbrkrs gehören.

z/OS platform Unter z/OS muss die Benutzer-ID, mit der dieser Befehl aufgerufen wird, zu einer Gruppe gehören, die Lese- und Schreibzugriff (READ und WRITE) auf das Komponentenverzeichnis hat.

Stellen Sie sicher, dass die Registrierungsdatenbank ausreichend gegen unbefugte Zugriffe geschützt ist. mqsisetdbparms ist für den ordnungsgemäßen Betrieb des Brokers nicht erforderlich. Wenn der Brokeradministrator allerdings bestimmten Datenquellen keine festen Benutzer-IDs und Kennwörter zugeordnet hat, wird die Benutzer-ID (und unter Windows und auf UNIX-Systemen auch das Kennwort) des Brokers verwendet. Das Kennwort wird im Dateisystem nicht als Klartext gespeichert.

Beispiele

Die folgenden Beispiele demonstrieren die Nutzung des Befehls ohne dem zusätzlichen Uniform-Resource-Identifier (URI):
mqsisetdbparms WBRK_BROKER -n MQBroker1 -u MQUserId -p password
mqsisetdbparms WBRK_BROKER -n MQBroker1 -d

Die folgenden Beispiele zeigen die Verwendung des Befehls, wenn der URI für einen JMS- (Java Message Service) oder JNDI-Ressourcennamen (Java Naming and Directory Interface) an Stelle von DataSourceName verwendet wird, das dem Parameter -n zugeordnet ist.

Für eine JMS-Ressource lautet das Präfix "jms::", für JNDI lautet es "jndi::", und für einen JDBC-Provider lautet es "jdbc::".

Wenn unter Linux und UNIX-Systeme die Parameterzeichenfolge ein Backslash-Zeichen (\) enthält, müssen Sie bei der Eingabe des Befehls mqsisetdbparms ein zweites Backslash-Zeichen (\\) als Escape-Zeichen angeben.

Beispiel: Um eine Benutzer-ID myuserid und das Kennwort secret für JMS-Thema-Verbindungsfactory tcf1 im Broker MyBroker1 anzugeben, müssen Sie die folgende Syntax anwenden:
mqsisetdbparms MyBroker1 -n jms::tcf1 -u myuserid -p secret
Um die gleiche Sicherheit für einen JNDI-Ausgangskontext com.sun.jndi.fscontext.RefFSContextFactory anzugeben, muss entsprechend der folgende Befehl eingegeben werden:
mqsisetdbparms MyBroker1 -n jndi::com.sun.jndi.fscontext.RefFSContextFactory 
     -u myuserid -p secret

Die obigen Beispiele beschreiben, wie die Sicherheit für JMS- und JNDI-Ressourcen für alle JMS-Knoten konfiguriert werden, die diese Ressourcen in einem Broker verwenden.

Um den Kontrollgrad zur Sicherheit von JMS-Knoten zu erhöhen, können Sie die Ressource mit einem Accountnamen verknüpfen. Der Accountname selbst besteht aus dem Namen des Nachrichtenflusses und dessen Verknüpfung mit der Knotenbezeichnung mit Hilfe des Unterstreichungszeichens "_":
            Name des Nachrichtenflusses_Knotenbezeichnung
Beispiel: Wenn der Name des Nachrichtenflusses MyJMSFlow1 lautet und Sie eine bestimmte Benutzer-ID und ein Kennwort für den JMSInput- Knoten MyJMSInput1 benötigen, ergibt sich daraus folgender Accountname:
             MyJMSFlow1_MyJMSInput1
Anschließend können Sie die Zeichenfolge Accountname in der Option Datenquelle des Befehls mqsisetdbparms verwenden, indem Sie Ressourcentyp als Präfix von Accountname angeben und Accountname mit dem At-Zeichen (@) gefolgt vom Ressourcennamen verketten:
            <Ressourcentyp><Accountname>@<Ressourcenname>
Wenn ein JMS-Ressourcenname tcf1 vorausgesetzt wird, der von dem JMSInput-Knoten MyJMSInput1 im Nachrichtenfluss MyJMSFlow1 verwendet wird, wird der folgende Datenquellenname verwendet:
            jms::MyJMSFlow1_MyJMSInput1@tcf1
Bei Eingabe einer Benutzer-ID myuserid, des Kennworts secret, des Brokernamens MyBroker1 und des aus dem Accountnamen erstellten Datenquellennamens (wie oben beschrieben) muss die folgende Syntax verwendet werden:
mqsisetdbparms MyBroker1 -n jms::MyJMSFlow1_MyJMSInput1@tcf1
                 -u myuserid -p secret
Geben Sie folgenden Befehl ein, um eine Sicherheitsidentität für eine sichere JDBC-Datenquelle zu konfigurieren. myDBID ist eine Sicherheitsidentität für eine JDBC-Datenquelle. Dabei handelt es sich um eine Eigenschaft, die für einen JDBCProvider konfiguriert ist, der in den konfigurierbaren Broker-Services definiert ist. Die Benutzer-ID und das Kennwort werden für die sichere JDBC-Datenquelle konfiguriert.
mqsisetdbparms MyBroker1 -n jdbc::myDBID -u myUserID -p myPassword      
Sie können den Befehl mqsisetdbparms in folgendem Format verwenden, um einen Accountnamen mit einem Benutzernamen und Kennwort für die WebSphere-Adapter zu konfigurieren.
mqsisetdbparms
Brokername -n Adaptername -u Benutzername
-p Kennwort
Beispiel:
mqsisetdbparms BRK1 -n SAPCustomerInbound.inadapter -u sapuid -p ********
mqsisetdbparms BRK1 -n TwineballInbound.inadapter -u mqbroker -p ********
Mit dem Befehl mqsisetdbparms können Sie einer JDBC-Verbindung des Typs 4 ein Benutzer-ID/Kennwort-Paar zuordnen. Der Wert, den Sie für -n Datenquellenname angeben, muss mit dem Wert der Eigenschaft securityIdentity des zugeordneten konfigurierbaren JDBCProvider-Service übereinstimmen.
mqsisetdbparms Brokername -n Datenquellenname
			-u Benutzer-ID -p Kennwort
Beispiel:
mqsisetdbparms BROKER1 -n OracleXADataSource1 -u myuserid -p secretpw
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an09155_