mqsicreateconfigurableservice-Befehl

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

Mit dem WebSphere Message Broker Explorer können Sie auch konfigurierbare Services erstellen. Weitere Informationen finden Sie im Abschnitt Konfigurierbare Services im WebSphere Message Broker Explorer bearbeiten.

Unterstützte Plattformen

  • Windows.
  • Linux- und UNIX-Systeme.
  • z/OS. Führen Sie diesen Befehl aus, indem Sie BIPCRCS anpassen und übergeben (siehe Inhalt der Broker-PDSE).

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.
  • Stoppen Sie den Broker und starten Sie ihn erneut, bevor Sie neue Brokerressourcen und -eigenschaften verwenden.

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. 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.

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 beim Erstellen eines Service mithilfe dieses Befehls als Schablone. 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.
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 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.

Autorisierung

Auf allen Betriebssystemen muss die Benutzer-ID der Gruppe mqbrkrs angehö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

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 
Erstellen Sie einen konfigurierbaren CICSConnection-Service für die CICS-Instanz, die am 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 
Erstellen Sie mit einen konfigurierbaren Connect:Direct-Server-Service auf dem Objekt test mit dem Hostnamen 9.122.17.58 und dem Port 1369:
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369 
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
Erstellen Sie einen konfigurierbaren EmailServer-Service für den EmailInput-Knoten oder Nachrichtenfluss, der während der Laufzeit referenziert werden kann, um eine Verbindung zu einem E-Mail-Server herzustellen, der bei pop3://test.email.server.ibm.com Port 12345 aktiv ist. Die Sicherheitsidentität wird in diesem Beispiel von mySecurityIdentityObjectName ermittelt:
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 namens 'MyProviderXYZ' für den Broker MB8BROKER hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
JMS-Provider 'ProviderABC' für den Broker MB8BROKER mit Standardwerten für die Ressourceneigenschaften hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
JMS-Provider BEAV91 für den Broker MB8BROKER hinzufügen, unter Angabe des Namens der von IBM bereitgestellten Java-Klasse com.ibm.broker.apihandler.BEAWebLogicAPIHandler, mit der anbieterspezifische API-Aufrufe verarbeitet werden sollen:
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' im Broker MB8BROKER erstellen:
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 
Konfigurierbaren SAPConnection-Service für den SAP-Adapter mySAPAdapter.outadapter erstellen, der Verbindungen zum SAP-Host test.sap.ibm.com unter Verwendung des Benutzerclients 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 mqsisetdbparms-Befehl 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 mqsisetdbparms-Befehl 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 TCP/IP-Service erstellen, der SSL verwendet:
Konfigurierbaren Zeitgeberservice 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 
Benutzerdefinierten Service erstellen:
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:49:44


ReferenzthemaReferenzthema | Version 8.0.0.0 | an37200_