WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

mqsicreateconfigurableservice-Befehl

Mit dem Befehl mqsicreateconfigurableservice können Sie einen Objektnamen für eine externe Brokerressource erstellen.

Mit dem WebSphere Message Broker Explorer können Sie auch konfigurierbare Services erstellen. Der Abschnitt Konfigurierbare Services im WebSphere Message Broker Explorer bearbeiten enthält weitere Informationen hierzu.

Unterstützte Plattformen

  • Windows.
  • Linux- und UNIX-Systeme.
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPCRCS anpassen und übergeben. Der Abschnitt Inhalt der Broker-PDSE enthält weitere Informationen hierzu.

Zweck

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 Provider des unternehmensweiten Informationssystems (EIS) nicht mit dem Befehl mqsicreateconfigurableservice erstellen, da diese bereits definiert sind. Mit dem Befehl mqsichangeproperties können Sie EIS-Provider ändern.

Hinweise zur Nutzung

  • Stellen Sie vor Ausführung dieses Befehls sicher, dass der Broker aktiv ist.
  • Bei einigen konfigurierbaren Services muss die Ausführungsgruppe gestoppt und neu gestartet werden, damit Änderungen übernommen werden. Überprüfen Sie die Dokumentation für den jeweiligen Typ des konfigurierbaren Service.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsicreateconfigurableservice--Brokername-------------------->

>-- -c --KonfigurierbarerService-- -o--Objektname--------------->

>--+----------------------------------------------------------+-><
   |      .-,----------------.                                |   
   |      V                  |                                |   
   '- -n----Eigenschaftsname-+--+---------------------------+-'   
                                |      .-,----------------. |     
                                |      V                  | |     
                                '- -v----Eigenschaftswert-+-'     

Parameter

Brokername
(Erforderlich) Der Name des zu ändernden Brokers. Dieser Parameter muss der erste Parameter sein.
-c KonfigurierbarerService
(Erforderlich) Der Typ der externen Ressource (konfigurierbarer Service). Mit dem Befehl mqsireportproperties können Sie eine Liste der gültigen Werte aufrufen.

Die gültigen Ressourcentypen finden Sie unter Eigenschaften von konfigurierbaren Services.

-o Objektname
(Erforderlich) Der Name des Objekts, dessen Eigenschaften Sie ändern möchten.

Ist der Parameter -c beispielsweise auf 'DBCProviders' gesetzt, wird als Objektname der Name eines von IBM definierten oder eines benutzerdefinierten JDBC-Providers 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 als Schablone, wenn Sie mit diesem Befehl einen Service erstellen möchten. Mit dem Befehl mqsireportproperties können Sie eine Liste der standardmäßigen Providernamen aufrufen.

-n Eigenschaftsname
(Optional) Der Name der zu ändernden Eigenschaft.

Die gültigen Eigenschaftsnamen finden Sie unter Eigenschaften von konfigurierbaren Services.

-v Eigenschaftswert
(Optional, jedoch erforderlich, wenn der Parameter -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.

Wenn der Eigenschaftswert ein Komma enthält, schließen Sie den Wert in Anführungszeichen ein, denen ein Escapezeichen (\" und \") vorangestellt ist, z. B. -n Name1,Name2 -v Wert1,\"Wert21,Wert22\".

UNIX platformEnthält der Parameter -v ein Semikolon, muss die gesamte Zeichenfolge auf UNIX-Systemen wie im folgenden Beispiel in Anführungszeichen gesetzt werden:
mqsicreateconfigurableservice MB8BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];"

Die Eigenschaftswerte werden unter Eigenschaften von konfigurierbaren Services beschrieben.

Berechtigung

In den folgenden Abschnitten finden Sie Informationen zu plattformspezifischen Autorisierungen: Wenn Sie die Brokerverwaltungssicherheit aktiviert haben, müssen Sie auch die Berechtigung einrichten. Ausführliche Informationen hierzu finden Sie im Abschnitt Tasks und Berechtigungen für Verwaltungssicherheit.

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

Konfigurierbaren Aggregationsservice erstellen, der eine Reihe von Warteschlangen mit dem Präfix SYSTEM.BROKER.AGGR.SET1 und einem Zeitlimit von 60 Sekunden verwendet:
mqsicreateconfigurableservice MB8BROKER -c Aggregation -o myAggregationService 
-n queuePrefix,timeoutSeconds -v SET1,60 
Konfigurierbaren CICSConnection-Service für die CICS-Instanz erstellen, die an Port 12345 von tcp://test.cics.ibm.com ausgeführt wird. Der Broker wird über die Anwendungs-ID BRKApp und das Qualifikationsmerkmal BRKQual identifiziert. In diesem Beispiel beträgt das Verbindungszeitlimit 10 Sekunden und das Anforderungszeitlimit 5 Sekunden:
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
Konfigurierbaren Collector-Service erstellen, der Warteschlangen mit dem Präfix SYSTEM.BROKER.EDA.SET1 und einem Objektgruppenablauf von 60 Sekunden verwendet:
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService 
-n queuePrefix,collectionExpirySeconds -v SET1,60 
Für das Objekt test einen konfigurierbaren Connect:Direct-Server-Service mit dem Hostnamen 9.122.17.58 und der Portnummer 1369 erstellen:
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369 
Rufen Sie zum Installieren eines neuen Verbindungsproviders MyProvider auf, der die Verbindungsfactory MyFactory verwendet und dessen JAR-Dateien sich im Verzeichnis C:\temp\jars befinden:
mqsicreateconfigurableservice MB8BROKER -c ConnectorProviders -o MyProvider
-n connectorClassName,jarsURL
–v com.ibm.broker.MyFactory,C:\temp\jars 

Sie finden eine Ansicht der Javadoc für die Connector-API im Abschnitt Connector-API.

Konfigurierbaren CORBA-Service zur Angabe der Position des Objektverweises erstellen:
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
Konfigurierbaren EmailServer-Service erstellen, auf den der EmailInput-Knoten oder der Nachrichtenfluss während der Laufzeit verweisen kann, um eine Verbindung mit einem E-Mail-Server herzustellen. Der Server wird unter pop3://test.email.server.ibm.com an Port 12345 ausgeführt. Die Sicherheitsidentität wird in diesem Beispiel durch mySecurityIdentityObjectName bestimmt.
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o myEmailConfigurableServiceName
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,mySecurityIdentityObjectName
Konfigurierbaren Service für einen FTP-Server erstellen:
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
Konfigurierbaren Service für einen FTP-Server erstellen, um SFTP ohne strenge Prüfung des Hostschlüssels nutzen zu können:
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o TEST1 
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v  SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
Konfigurierbaren IMSConnect-Service für die IMS-Instanz IMSA erstellen, die an Port 9999 auf test.ims.ibm.com aktiv ist:
mqsicreateconfigurableservice MB8BROKER -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
JavaClassLoader-Service erstellen:
mqsicreateconfigurableservice MB8BROKER -c JavaClassLoader 
-o myJavaClassLoader 
-n includedDeployedJars,sharedJarPath 
-v "jcnapp1.jar","/var/app1/jars"
JMS-Provider mit dem Namen 'MyProviderXYZ' hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
JMS-Provider mit dem Namen 'ProviderABC' mit den Standardwerten für die Ressourceneigenschaften hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
JMS-Provider mit dem Namen 'BEAV91' hinzufügen, unter Angabe der von IBM® bereitgestellten Java™-Klasse com.ibm.broker.apihandler.BEAWebLogicAPIHandler zur Verarbeitung von anbieterspezifischen API-Aufrufen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o BEAV91 
-n proprietaryAPIHandler,proprietaryAPIAttr1,proprietaryAPIAttr2,proprietaryAPIAttr3
–v com.ibm.broker.apihandler.BEAWebLogicAPIHandler,weblogic.jndi.WLInitialContextFactory,
t3://19.21.194.126:7001,BEAServerName 
Überwachungsprofil 'mp1' zu Broker MB8BROKER hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c MonitoringProfiles -o mp1
Konfigurierbaren PeopleSoftConnection-Service für die auf my.peoplesoft.qa.com aktive PeopleSoft-Instanz erstellen:
mqsicreateconfigurableservice MB8BROKER -c PeopleSoftConnection 
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
Konfigurierbaren Resequence-Service erstellen, der eine Reihe von Warteschlangen mit dem Präfix SYSTEM.BROKER.EDA.SET1 und ein Zeitlimit von 60 Sekunden für fehlende Nachrichten verwendet:
mqsicreateconfigurableservice MB8BROKER -c Resequence -o myResequenceService 
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60 
Erstellen Sie einen konfigurierbaren SAPConnection-Service für den SAP-Adapter mySAPAdapter.outadapter, der Verbindungen zum SAP-Host test.sap.ibm.com unter Verwendung des Clients 001 herstellt.
mqsicreateconfigurableservice MB8BROKER -c SAPConnection -o mySAPAdapter.outadapter 
-n applicationServerHost,client -v test.sap.ibm.com,001

Den Benutzernamen und das Kennwort für einen SAP-Adapter können Sie mit dem Befehl mqsisetdbparms einrichten.

Sicherheitsprofil für einen WS-Trust V1.3 STS-Provider mit Tivoli Federated Identity Manager (TFIM) V6.2 erstellen:
mqsicreateconfigurableservice MB8BROKER -c SecurityProfiles -o myWSTrustTFIMv62Profile 
-n authentication,mapping,authorization,propagation,mappingConfig 
-v "WS-Trust v1.3 STS","WS-Trust v1.3 STS","WS-Trust v1.3 STS",TRUE,
http://wstrusthost1.ibm.com:9080/TrustServerWST13/services/RequestSecurityToken
Das Profil 'Standardweitergabe' ist ein vordefiniertes Profil, das nur eine Weitergabe von Identitäten erfordert. Weitere Informationen zum Erstellen eines Sicherheitsprofils für einen WS-Trust V1.3 STS-Provider, LDAP oder TFIM V6.1 finden Sie im Abschnitt Sicherheitsprofil erstellen.
Konfigurierbaren SiebelConnection-Service für den Siebel-Adapter mySiebelAdapter.outadapter erstellen, der eine Verbindung zum Siebel-Server "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu" herstellt:
mqsicreateconfigurableservice MB8BROKER -c SiebelConnection -o mySiebelAdapter.outadapter 
-n connectString -v "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu"

Den Benutzernamen und das Kennwort für einen Siebel-Adapter können Sie mit dem Befehl mqsisetdbparms einrichten.

Konfigurierbaren Service für den TCP/IP-Server erstellen:
mqsicreateconfigurableservice MB8BROKER -c TCPIPServer -o ServerPort1452 
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15  
Konfigurierbaren Service für den TCP/IP-Client erstellen:
mqsicreateconfigurableservice MB8BROKER -c TCPIPClient 
-o ClientPort1452HostnameJsmith 
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections 
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10  
Konfigurierbaren Service für TCP/IP erstellen, der mit SSL arbeitet:
Konfigurierbaren Timer-Service erstellen, der eine Warteschlange mit dem Präfix SYSTEM.BROKER.TIMEOUT.SET1 und einem Zeitlimit von 5 Sekunden verwendet:
mqsicreateconfigurableservice MB8BROKER -c Timer -o myTimerService 
-n queuePrefix,timeoutIntervalSeconds -v SET1,5 
UserDefined-Service erstellen:
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
Konfigurierbaren WXSServer-Service erstellen, um festzulegen, wie eine Verbindung zu einem externen WebSphere eXtreme Scale-Grid hergestellt wird. Das Grid ist ein sicheres Grid mit dem Namen 'myGrid'. Der Katalogserver für das Grid hat in diesem Beispiel den Hostnamen server.ibm.com und wird an Port 2809 ausgeführt. Außerdem wird die Überschreibungsdatei 'xc10Client.xml' verwendet. Der Name der mit dem Befehl mqsisetdbparms erstellten Sicherheitsidentität lautet 'xc10'.
mqsicreateconfigurableservice MB8BROKER -c WXSServer -o xc10 
-n catalogServiceEndPoints,gridName,overrideObjectGridFile,securityIdentity 
-v "server.ibm.com:2809","myGrid","C:\Brokers\WebSphere_eXtreme_Scale\xc10\xc10Client.xml","xc10"
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:51


ReferenzthemaReferenzthema | Version 8.0.0.5 | an37200_