mqsicreateconfigurableservice-Befehl

Mit dem Befehl mqsicreateconfigurableservice können Sie einen neuen Objektnamen für eine brokerexterne Ressource erstellen, z. B. einen JMS-Provider, JDBC-Provider oder FTP-Server.

Unterstützte Plattformen

  • Windows-Systeme
  • Linux- und UNIX-Systeme
  • z/OS Führen Sie diesen Befehl aus, indem Sie BIPCRCS anpassen und übergeben; weitere Informationen erhalten Sie unter Inhalt der Broker-PDSE

Zweck

Mit diesem Befehl können Sie einen vordefinierten IBM Ressourcentyp hinzufügen.

Für konfigurierbare Services, die mit dem Befehl mqsicreateconfigurableservice hinzugefügt werden, gilt Folgendes:
  • Verwenden Sie den Befehl mqsireportproperties, um die konfigurierbaren Services anzuzeigen.
  • Verwenden Sie den Befehl mqsichangeproperties, um die konfigurierbaren Services zu ändern.
  • Verwenden Sie den Befehl mqsideleteconfigurableservice, um die konfigurierbaren Services zu löschen.

Sie müssen EIS-Provider nicht mit dem Befehl mqsicreateconfigurableservice erstellen, da diese bereits definiert sind. Verwenden Sie den Befehl mqsichangeproperties, um sie zu ändern.

Hinweise zur Nutzung

  • Stellen Sie vor Ausführung dieses Befehls sicher, dass der Broker aktiv ist.
  • Stoppen Sie den Broker, und starten Sie ihn erneut, bevor Sie neue Brokerressourcen und -eigenschaften verwenden.

Syntax

Parameter

Brokername
(Erforderlich) Der Name des zu ändernden Brokers. Bei diesem Parameter muss es sich um den ersten Parameter handeln.
-c KonfigurierbarerService
(Erforderlich) Der Typ der externen Ressource (konfigurierbarer Service). Mit dem Befehl mqsireportproperties können Sie eine Liste der gültigen Werte aufrufen.
Gültige Ressourcentypen sind:
  • JMSProviders
  • JDBCProviders
  • SecurityProfiles
  • FtpServer
-o Objektname
(Erforderlich) Der Name des Objekts, dessen Eigenschaften Sie ändern möchten.

Wenn der Parameter -c auf 'JMSProviders' gesetzt ist, wird als Objektname entweder ein IBM definierter JMS-Providername oder ein benutzerdefinierter JMS-Providername erwartet.

Wenn der Parameter -c auf JDBCProviders gesetzt ist, wird als Objektname entweder ein IBM definierter JDBC-Providername oder ein benutzerdefinierter JDBC-Providername erwartet. Für die unterstützten Datenbanken, für die Sie eine Verbindung über JDBC-Verbindungen vom Typ 4 herstellen können, werden Standardservices bereitgestellt. Verwenden Sie die bereitgestellten Services beim Erstellen eines neuen Service mit Hilfe dieses Befehls als Schablone. Mit dem Befehl mqsireportproperties können Sie eine Liste der standardmäßigen Providernamen aufrufen.

Wird der Parameter -c auf 'SecurityProfiles' gesetzt, wird als Objektname der Namen eines neuen Sicherheitsprofils für den Broker erwartet.

Wird der Parameter -c auf 'FtpServer' gesetzt, wird als Objektname der Name eines FTP-Servers verwendet, der als Eigenschaft auf der Registerkarte FTP des FileInput- oder FileOutput-Knotens angegeben ist. Es handelt sich um einen benutzerdefinierten Namen, der den fernen FTP-Server und die hier definierte Eigenschaftenreihe identifiziert.

-n Eigenschaftsname
(Optional) Der Name der zu ändernden Eigenschaft. Für eine JMSProviders-Ressource sind folgende Eigenschaftsnamen zulässig:
  • jarsURL
  • nativeLibs
Für eine JDBCProviders-Ressource sind folgende Eigenschaftsnamen zulässig:
  • databaseType
  • databaseVersion
  • type4DriverClassName
  • connectionUrlFormat
  • connectionUrlFormat Attr1-5
  • databaseName
  • description
  • jarsURL
  • portNumber
  • serverName
  • securityIdentity
Für eine SecurityProfiles-Ressource sind folgende Eigenschaftsnamen zulässig:
  • authentication = {NONE, LDAP, TFIM}
  • authenticationConfig = string
  • mapping = {NONE, TFIM}
  • mappingConfig = string
  • authorization = {NONE, LDAP, TFIM}
  • authorizationConfig = string
  • propagation = {TRUE, FALSE}
  • passwordValue = {PLAIN, MASK, OBFUSCATE}
Für eine FtpServer-Ressource sind folgende Eigenschaftsnamen zulässig:
  • serverName (erforderlich, wenn der Parameter -c auf 'FtpServer' gesetzt ist)
  • securityIdentity
  • accountInfo
  • remoteDirectory
  • connectionType
  • scanDelay
  • transferMode
Weitere Informationen zu diesen Eigenschaftsnamen finden Sie unter Konfigurierbare Serviceeigenschaften für den FTP-Server.
-v Eigenschaftswert
(Optional, jedoch erforderlich, wenn -n angegeben wird) Der Wert, der der Eigenschaft zugeordnet ist, die über den Parameter -n angegeben wird. Sie können mehrere Eigenschaftsnamen und die zugehörigen Werte angeben, indem Sie diese durch Kommas voneinander trennen; Beispiel: -n Name1, Name2 -v Wert1, Wert2.
UNIX platform Falls der Parameter -v unter UNIX ein Semikolon (;) enthält, müssen Sie die gesamte Zeichenfolge wie im folgenden Beispiel gezeigt in Anführungszeichen setzen:
mqsicreateconfigurableservice WBRK_BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];"

Wenn Sie den Parameter -c auf 'JMS-Providers' und den Parameter -n auf 'jarsURL' setzen, wird eine URL erwartet, die die Dateiadresse der JAR-Dateien des JMS-Providers angibt, wobei 'file://' in der URL übergangen wird. Wenn Sie den Parameter -n nicht angeben, wird das Verzeichnis für gemeinsam genutzte Klassen des Brokers als Standardposition für die JAR-Dateien des JMS-Providers verwendet.

Wenn Sie den Parameter -c auf 'JMSProviders' und den Parameter -n auf 'nativeLibs' setzen, wird eine Dateiadresse einer nativen Bibliothek eines JMS-Providers erwartet. Wenn Sie den Parameter -n nicht angeben, wird als Standardposition für die native Bibliothek eines JMS-Providers der LIL-Pfad (LilPath) des Brokers verwendet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authentication' setzen, kann der Eigenschaftswert NONE, LDAP oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authenticationConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'mapping' setzen, kann der Eigenschaftswert NONE oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'mappingConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authorization' setzen, kann der Eigenschaftswert NONE, LDAP oder TFIM lauten oder ein benutzerdefinierter Wert zur Angabe einer Alternative sein.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'authorizationConfig' setzen, wird als Eigenschaftswert eine providerspezifische Konfigurationszeichenfolge erwartet.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'propagation' setzen, kann der Eigenschaftswert entweder TRUE oder FALSE lauten.

Wenn Sie den Parameter -c auf 'SecurityProfiles' und den Parameter -n auf 'passwordValue' setzen, kann der Eigenschaftswert entweder PLAIN, MASK oder OBFUSCATE lauten.

Weitere Informationen zu den Werten, die Sie für die Eigenschaften eines konfigurierbaren Service für den FTP-Server festlegen können, finden Sie unter sKonfigurierbare Serviceeigenschaften für den FTP-Server.

Autorisierung

Sie muss zur Gruppe mqbrkrs gehören.

Antworten

Dieser Befehl gibt die folgenden Antworten zurück:
  • BIP8011 Die Konfigurationsdaten konnten nicht erstellt werden
  • BIP8012 Es kann keine Verbindung zu Systemkomponenten hergestellt werden
  • BIP8014 Komponente kann nicht erstellt werden
  • BIP8073 Ungültiger Brokername
  • BIP8983 Konfigurierbarer Service bereits vorhanden
  • BIP8984 Konfigurierbarer Service wurde nicht gefunden

Beispiele

Hinzufügen eines JMS-Providers namens MyProviderXYZ für den Broker WBRK6_DEFAULT_BROKER:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_MyProviderXYZ
Hinzufügen eines JMS-Providers namens ProviderABC für den Broker WBRK6_DEFAULT_BROKER mit Standardwerten für die Ressourceneigenschaften:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_ProviderABC
Hinzufügen eines JMS-Providers namens ProviderABC für den Broker WBRK6_DEFAULT_BROKER unter Angabe einer Speicherposition für die JAR-Dateien des Providers sowie eines Bibliothekspfads für die nativen Bibliotheken, die diesen JAR-Dateien zugeordnet sind:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c JMSProviders -o JMS_ProviderABC 
-n jarsURL,nativeLibs -v file://D:\ProviderABC\java,D:\ProviderABC\libs
Erstellen eines Sicherheitsprofils zur TFIM-Nutzung:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c SecurityProfiles -o TFIM -n authentication,mapping,authorization,propagation,mappingConfig -v TFIM,TFIM,TFIM,TRUE,http://tfimhost1.ibm.com:9080
Erstellen Sie einen konfigurierbaren Service für einen FTP-Server:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c FtpServer -o Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,ACTIVE,secId
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
an37200_