IBM Integration Bus, Version 9.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Befehl mqsicreateconfigurableservice

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

Mit dem IBM® Integration Explorer können Sie auch konfigurierbare Services erstellen. Der Abschnitt Konfigurierbare Services in IBM Integration 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. Weitere Informationen finden Sie im Abschnitt 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.
Bei einigen konfigurierbaren Services muss der Integrationsserver gestoppt und neu gestartet werden, damit Änderungen übernommen werden. Überprüfen Sie die Dokumentation für den jeweiligen Typ des konfigurierbaren Service.

Syntax


>>-mqsicreateconfigurableservice--Brokername-------------------->

>-- -c --konfigurierbarer_Service-- -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 konfigurierbarer_Service

(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 im Abschnitt 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 Vorlage, 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. Der Eigenschaftsname muss ein gültiger XML-Attributname sein. Beispielsweise darf ein Eigenschaftsname nicht mit einer Zahl beginnen.

Die gültigen Eigenschaftsnamen finden Sie im Abschnitt 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\".

Enthält der Parameter -v ein Semikolon, muss die gesamte Zeichenfolge auf UNIX-Systemen wie im folgenden Beispiel in Anführungszeichen gesetzt werden:

mqsicreateconfigurableservice IB9NODE -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 Berechtigungen:

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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA

JavaClassLoader-Service erstellen:

mqsicreateconfigurableservice IB9NODE -c JavaClassLoader 
-o myJavaClassLoader 
-n includedDeployedJars,sharedJarPath 
-v "jcnapp1.jar","/var/app1/jars"

JMS-Provider mit dem Namen 'MyProviderXYZ' hinzufügen:

mqsicreateconfigurableservice IB9NODE -c JMSProviders -o JMS_MyProviderXYZ

JMS-Provider mit dem Namen 'ProviderABC' mit den Standardwerten für die Ressourceneigenschaften hinzufügen:

mqsicreateconfigurableservice IB9NODE -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 IB9NODE -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 IB9NODE hinzufügen:

mqsicreateconfigurableservice IB9NODE -c MonitoringProfiles -o mp1

Konfigurierbaren PeopleSoftConnection-Service für die auf my.peoplesoft.qa.com aktive PeopleSoft-Instanz erstellen:

mqsicreateconfigurableservice IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -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 IB9NODE -c TCPIPServer -o ServerPort1452 
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15

Konfigurierbaren Service für den TCP/IP-Client erstellen:

mqsicreateconfigurableservice IB9NODE -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 IB9NODE -c Timer -o myTimerService 
-n queuePrefix,timeoutIntervalSeconds -v SET1,5

UserDefined-Service erstellen:

mqsicreateconfigurableservice IB9NODE -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 IB9NODE -c WXSServer -o xc10 
-n catalogServiceEndPoints,gridName,overrideObjectGridFile,securityIdentity 
-v "server.ibm.com:2809","myGrid","C:\Brokers\WebSphere_eXtreme_Scale\xc10\xc10Client.xml","xc10"

an37200_.htm |

Letzte Aktualisierung Monday, 27 March 2017