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.
  • Überprüfen Sie die Dokumentation für den jeweiligen Typ des konfigurierbaren Service: Bei einigen Typen von konfigurierbaren Services, für die dies explizit in der Dokumentation angegeben wird, müssen Sie die Ausführungsgruppe stoppen und erneut starten, damit die Änderung wirksam wird.

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 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 mehr als einen Eigenschaftsnamen und den entsprechenden Wert angeben; diese Angaben müssen durch Kommas getrennt werden (-n Name1,Name2 -v Wert1,Wert2).

Beginn der ÄnderungWenn 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\".Ende der Änderung

UNIX platform Enthä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.

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 
Beginn der ÄnderungErstellen 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 
Ende der Änderung
Beginn der ÄnderungRufen 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 
Ende der Änderung
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 für denEmailInput-Knoten oder -Nachrichtenfluss erstellen, auf den in Laufzeit verwiesen werden kann, um eine Verbindung mit einem E-Mail-Server herzustellen, der am Port 12345 von pop3://test.email.server.ibm.com ausgeführt wird. Die Sicherheitsidentität wird in diesem Beispiel über mySecurityIdentityObjectName identifiziert:
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 'MyProviderXYZ' für Broker MB8BROKER hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
JMS-Provider 'ProviderABC' für Broker MB8BROKER mit den Standardwerten für die Ressourceneigenschaften hinzufügen:
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
JMS-Provider 'BEAV91' für Broker MB8BROKER unter Angabe des Namens der von IBM bereitgestellten Java-Klasse com.ibm.broker.apihandler.BEAWebLogicAPIHandler zur Handhabung anbieterspezifischen API-Aufrufe hinzufügen:
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

Sie können Benutzername und Kennwort für einen SAP-Adapter mit dem mqsisetdbparms-Befehl setzen.

Sicherheitsprofil für einen WS-Trust V1.3 STS-Provider unter Verwendung von 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 Service für TCP/IP erstellen, der mit SSL arbeitet:
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 
UserDefined-Service erstellen:
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:21:09


ReferenzthemaReferenzthema | Version 8.0.0.1 | an37200_