Hinzufügen eines entfernten Warteschlangenmanagers zu IBM MQ Console über die Befehlszeile

Sie können einen fernen Warteschlangenmanager zur IBM® MQ Console hinzufügen, indem Sie den Befehl setmqweb remote in der Befehlszeile verwenden.

Vorbereitungen

Bevor Sie mit dieser Aufgabe beginnen, müssen Sie die folgenden Schritte in der IBM MQ Console durchführen: Hinzufügen eines Remote-Warteschlangenmanagers.

Verfahren

Erstellen Sie eine JSON-CCDT-Datei, die die Verbindungsinformationen für den entfernten Warteschlangenmanager enthält:
- Generieren Sie eine CCDT-Datei, indem Sie die IBM MQ Console verwenden, die derselben Installation wie der Warteschlangenmanager zugeordnet ist, zu dem Sie über Fernzugriff eine Verbindung herstellen wollen.
  Klicken Sie auf der Startseite auf die Kachel Verbindungsdatei herunterladen.
- Erstellen Sie eine CCDT-Datei im JSON-Format, die die Verbindung definiert. Weitere Informationen zum Erstellen einer CCDT im JSON-Format finden Sie unter CCDT im JSON-Format konfigurieren.
  Die CCDT-Datei muss die Informationen zu name, clientConnectionund type enthalten. Optional können Sie zusätzliche Informationen wie z. B. zu transmissionSecurity hinzufügen. Weitere Informationen zu allen CCDT-Kanalattributdefinitionen finden Sie unter Vollständige Liste der CCDT-Kanalattributdefinitionen.
  
  Das folgende Beispiel zeigt eine einfache JSON-CCDT-Datei für eine Remote-Warteschlangenmanager-Verbindung:
```
{
  "channel": [{
      "name": "QM1.SVRCONN",
      "clientConnection": {
        "connection": [{
            "host": "example.com",
            "port": 1414
          }],
        "queueManager": "QM1"
      },
      "type": "clientConnection"
    }]
}
```
Kopieren Sie die JSON-CCDT-Datei auf das System, auf dem IBM MQ Console ausgeführt wird.
Verwenden Sie in der Installation, in der IBM MQ Consoleausgeführt wird, den setmqweb remote -Befehl, um die Informationen zum fernen WS-Manager zur IBM MQ Console -Konfiguration hinzuzufügen.
Um einen entfernten Warteschlangenmanager zu IBM MQ Console hinzuzufügen, müssen Sie mindestens die folgenden Angaben machen:
- Gibt den Namen des Warteschlangenmanagers an.
- Ein eindeutiger Name für den Warteschlangenmanager. Dieser eindeutige Name unterscheidet diesen Warteschlangenmanager von anderen entfernten Warteschlangenmanagern, die möglicherweise denselben Namen haben. Der eindeutige Name ist der Name, der auf IBM MQ Console angezeigt wird. Geben Sie also einen Namen an, der deutlich macht, dass es sich bei dem Warteschlangenmanager um einen entfernten Warteschlangenmanager handelt, z. B. "remote-QM2".
- Das CCDT URL für den Warteschlangenmanager.
Sie können verschiedene andere Optionen angeben, z. B. den Benutzernamen und das Kennwort, die für die Verbindung mit dem entfernten Warteschlangenmanager verwendet werden sollen, oder Details zum Truststore und Keystore. Eine vollständige Liste der Parameter, die mit dem Befehl setmqweb remote angegeben werden können, finden Sie unter setmqweb remote.
Um z. B. den entfernten Warteschlangenmanager QM1 hinzuzufügen, geben Sie unter Verwendung der CCDT-Beispieldatei den folgenden Befehl ein:
```
setmqweb remote add -uniqueName "MACHINEAQM1" -qmgrName "QM1" -ccdtURL "c:\myccdts\ccdt.json"
```

Ergebnisse

Der ferne Warteschlangenmanager wird in der Liste ferner Warteschlangenmanager in der IBM MQ Console angezeigt, wenn die Liste ferner Verbindungen das nächste Mal aktualisiert wird. wenn die Verbindung erfolgreich ist, können Sie die Objekte des entfernten Queue-Managers auf die gleiche Weise verwalten, wie Sie mit den Objekten eines lokalen Queue-Managers arbeiten.

Beispiel

Im folgenden Beispiel wird die ferne Warteschlangenmanagerverbindung für einen Warteschlangenmanager QM1eingerichtet. Die IBM MQ Console ist berechtigt, den Queue Manager zu verwalten, basierend auf der Berechtigung, die dem Benutzer exampleUser erteilt wurde. Die Anmeldedaten dieses Benutzers werden IBM MQ Console mitgeteilt, wenn der Befehl setmqweb remote zur Konfiguration der Verbindungsinformationen für den entfernten Warteschlangenmanager verwendet wird.

Auf dem System, auf dem sich der ferne Warteschlangenmanager QM1 befindet, werden ein Serververbindungskanal und ein Listener erstellt. Der Listener wird gestartet und der Benutzer exampleUser erhält die Berechtigung, den Warteschlangenmanager zu verwalten. Führen Sie unter AIX®, Linux®, and Windowsbeispielsweise die folgenden Befehle aus:
```
runmqsc QM1
#Define the server connection channel that will accept connections from the Console
DEFINE CHANNEL(QM1.SVRCONN) CHLTYPE(SVRCONN) TRPTYPE(TCP)
# Define the listener to use for the connection from the Console
DEFINE LISTENER(REMOTE.LISTENER) TRPTYPE(TCP) PORT(1414)
# Start the listener
START LISTENER(REMOTE.LISTENER)
end

#Set mq authorization for exampleUser to access the queue manager
setmqaut -m QM1 -t qmgr -p exampleUser +connect +inq +setall +dsp
```
Hinweis: Der IBM MQ Appliance unterstützt den setmqaut Befehl nicht. Wenn Sie eine Verbindung zu einem Remote-Queue-Manager auf einem Gerät herstellen, verwenden Sie den Befehl MQSC SET AUTHREC , um die Autorisierung festzulegen.

Auf dem System, auf dem IBM MQ Console ausgeführt wird, wird eine Datei QM1_ccdt.json mit den folgenden Verbindungsinformationen erstellt:

{
  "channel": [{
      "name": "QM1.SVRCONN",
      "clientConnection": {
        "connection": [{
            "host": "example.com",
            "port": 1414
          }],
        "queueManager": "QM1"
      },
      "type": "clientConnection"
    }]
}

Auf dem System, auf dem IBM MQ Console ausgeführt wird, werden die Verbindungsinformationen für den entfernten Warteschlangenmanager QM1 zum mqweb-Server hinzugefügt. Die Berechtigungsnachweise für exampleUser sind in den Verbindungsinformationen enthalten:
```
setmqweb remote add -uniqueName "remote-QM1" -qmgrName "QM1" -ccdtURL "c:\myccdts\QM1_ccdt.json" -username "exampleUser" -password "password"
```
IBM MQ Console zeigt den fernen Warteschlangenmanager QM1.