WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

mqsicreateconfigurableservice コマンド

mqsicreateconfigurableservice コマンドを使用して、ブローカー外部リソース用のオブジェクト名を作成します。

WebSphere® Message Broker Explorer を使用して、構成可能サービスを作成することもできます。 詳しくは、WebSphere Message Broker Explorer を使用した構成可能サービスの処理を参照してください。

サポートされるプラットフォーム

  • Windows.
  • Linux および UNIX システム。
  • z/OS®. BIPCRCS をカスタマイズして実行依頼することにより、このコマンドを実行します。詳しくは、ブローカー PDSE の内容を参照してください。

目的

mqsicreateconfigurableservice コマンドを使用して構成可能サービスを追加した場合には、以下のようにしてください。
  • 構成可能サービスを表示するには、mqsireportproperties コマンドを使用します。
  • 構成可能サービスに変更を加えるには、mqsichangeproperties コマンドを使用します。
  • 構成可能サービスを削除するには、mqsideleteconfigurableservice コマンドを使用します。

定義は提供されているので、mqsicreateconfigurableservice コマンドを使用して EIS プロバイダーを作成する必要はありません。 mqsichangeproperties コマンドを使用して、EIS プロバイダーを変更します。

使用上の注意

  • このコマンドを実行する前に、ブローカーが実行されていることを確認してください。
  • 構成可能サービスの一部のタイプでは、変更を有効にするために実行グループを停止してから開始する必要があります。構成可能サービス・タイプごとに資料を確認してください。

構文

構文図を読む構文図をスキップする
>>-mqsicreateconfigurableservice--BrokerName-------------------->

>-- -c --ConfigurableService-- -o--ObjectName------------------->

>--+---------------------------------------------------+-------><
   |      .-,------------.                             |   
   |      V              |                             |   
   '- -n----PropertyName-+--+------------------------+-'   
                            |      .-,-------------. |     
                            |      V               | |     
                            '- -v----PropertyValue-+-'     

パラメーター

BrokerName
(必須) 変更するブローカーの名前。 このパラメーターは、最初のパラメーターでなければなりません。
-c ConfigurableService
(必須) 外部リソースのタイプ (構成可能サービス)。 有効な値のリストを表示するには、mqsireportproperties コマンドを使用します。

有効なリソース・タイプは、構成可能サービスのプロパティーにリストされています。

-o ObjectName
(必須) プロパティーに変更を加えるオブジェクトの名前。

例えば、-c パラメーターを JDBCProviders に設定する場合、予期されるオブジェクト名は、IBM 定義の JDBC プロバイダー名か、ユーザー定義の JDBC プロバイダー名のいずれかです。 デフォルト・サービスが、JDBC Type 4 接続を使って接続できる、サポート対象のデータベースに提供されます。 このコマンドを使用してサービスを作成する場合、提供されたサービスをテンプレートとして使用してください。 デフォルトのプロバイダー名のリストを表示するには、mqsireportproperties コマンドを使用します。

-n PropertyName
(オプション) 変更されるプロパティーの名前。

有効なプロパティー名は、構成可能サービスのプロパティーにリストされています。

-v PropertyValue
(オプション、ただし -n パラメーターを指定する場合は必須) -n パラメーターで指定されるプロパティーに割り当てられる値。 分離文字としてコンマを使用して、複数のプロパティー名および対応する値を指定できます。例えば、-n Name1, Name2 -v Value1, Value2 のようにします。

プロパティーの値にコンマが含まれる場合、値を二重引用符 (¥" および ¥") で囲んでエスケープします (例えば、-n Name1,Name2 -v Value1,¥"Value21,Value22¥")。

UNIX platformUNIX システムでは、-v パラメーターにセミコロン (;) が含まれる場合、以下の例で示しているようにストリング全体を引用符で囲みます。
mqsicreateconfigurableservice MB8BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat 
-v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"

プロパティー値については、構成可能サービスのプロパティーで説明されています。

許可

プラットフォーム固有の許可について詳しくは、以下のトピックを参照してください。 ブローカー管理セキュリティーを有効に設定した場合は、管理セキュリティーのタスクと権限で説明されている権限もセットアップする必要があります。

応答

このコマンドは、以下の応答を戻します。
  • BIP8011 構成データを作成できません
  • BIP8012 システム・コンポーネントに接続できません
  • BIP8014 コンポーネントを作成できません
  • BIP8073 無効なブローカー名が指定されました
  • BIP8983 構成可能サービスはすでに存在しています
  • BIP8984 構成可能サービスが見つかりませんでした

接頭部が SYSTEM.BROKER.AGGR.SET1 でタイムアウトが 60 秒のキューの集合を使用する Aggregation 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c Aggregation -o myAggregationService 
-n queuePrefix,timeoutSeconds -v SET1,60 
tcp://test.cics.ibm.com ポート 12345 で稼働している CICS® インスタンスの CICSConnection 構成可能サービスを作成します。ブローカーは、アプリケーション ID BRKApp および修飾子 BRKQual によって識別されます。 この例では、接続タイムアウトは 10 秒であり、要求タイムアウトは 5 秒です。
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o myCICSConnectionService
-n cicsServer,clientApplid,clientQualifier,connectionTimeoutSecs,
requestTimeoutSecs -v tcp://test.cics.ibm.com:12345,BRKApp,BRKQual,10,5
接頭部が SYSTEM.BROKER.EDA.SET1 でコレクション有効期限が 60 秒のキューを使用する Collector 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c Collector -o myCollectorService 
-n queuePrefix,collectionExpirySeconds -v SET1,60 
ホスト名 9.122.17.58、ポート番号 1369 を使用して、オブジェクト test 上に Connect:Direct® サーバー 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c CDServer -o test
-n Hostname,Port -v 9.122.17.58,1369 
新規コネクター・プロバイダーをインストールするには、ConnectionFactory MyFactory を使用し、ディレクトリー C:¥temp¥jars に JAR ファイルがある MyProvider を呼び出します。
mqsicreateconfigurableservice MB8BROKER -c ConnectorProviders -o MyProvider
-n connectorClassName,jarsURL
–v com.ibm.broker.MyFactory,C:\temp\jars 

コネクター API の Javadoc を表示するには、コネクター APIを参照してください。

オブジェクト参照の場所を指定する CORBA 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
E メール・サーバーに接続するために実行時に EmailInput ノードまたはメッセージ・フローから参照できる EmailServer 構成可能サービスを作成します。 サーバーは、ポート 12345 上の pop3://test.email.server.ibm.com で稼働します。次の例では、セキュリティー ID が mySecurityIdentityObjectName で示されています。
mqsicreateconfigurableservice MB8BROKER -c EmailServer -o myEmailConfigurableServiceName
-n serverName,securityIdentity -v pop3://test.email.server.ibm.com
:12345,mySecurityIdentityObjectName
FtpServer 構成可能サービスを次のように作成します。
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,Binary,ACTIVE,secId
厳密なホスト・キー検査をせずに、SFTP を使用する FtpServer 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c FtpServer -o TEST1 
-n protocol,serverName,scanDelay,remoteDirectory,securityIdentity,cipher,compression,strictHostKeyChecking
-v  SFTP,winlnx58,30,.,chbatey,blowfish-cbc,9,no
test.ims.ibm.com ポート 9999 で実行する IMS™ インスタンス IMSA の IMSConnect 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c IMSConnect -o myIMSConnectService
-n Hostname,PortNumber,DataStoreName -v test.ims.ibm.com,9999,IMSA
JavaClassLoader サービスを次のように作成します。
mqsicreateconfigurableservice MB8BROKER -c JavaClassLoader 
-o myJavaClassLoader 
-n includedDeployedJars,sharedJarPath 
-v "jcnapp1.jar","/var/app1/jars"
「MyProviderXYZ」という名前の JMS プロバイダーを追加します。
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
リソース・プロパティーのデフォルト値を使用して、「ProviderABC」という名前の JMS プロバイダーを追加します。
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
ベンダー固有の API 呼び出しを処理するために、IBM® 提供の Java™ クラスの名前 (com.ibm.broker.apihandler.BEAWebLogicAPIHandler) を指定して、「BEAV91」という名前の JMS プロバイダーを追加します。
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 
ブローカー MB8BROKER に対して、'mp1' の名前を持つモニター・プロファイルを以下のように作成します。
mqsicreateconfigurableservice MB8BROKER -c MonitoringProfiles -o mp1
my.peoplesoft.qa.com 上で実行している PeopleSoft インスタンスの PeopleSoftConnection 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c PeopleSoftConnection 
-o myPeopleSoftAdapter.outadapter -n hostName,port -v "my.peoplesoft.qa.com",9000
接頭部が SYSTEM.BROKER.EDA.SET1 で未着メッセージのタイムアウトが 60 秒のキューの集合を使用する Resequence 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c Resequence -o myResequenceService 
-n queuePrefix,missingMessageTimeoutSeconds -v SET1,60 
SAP ホスト test.sap.ibm.com に接続し、そのサーバーへの接続にクライアント 001 を使用する、SAP アダプター mySAPAdapter.outadapter 用の SAPConnection 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c SAPConnection -o mySAPAdapter.outadapter 
-n applicationServerHost,client -v test.sap.ibm.com,001

mqsisetdbparmsコマンドを使用して、SAP アダプターのユーザー名とパスワードを設定できます。

Tivoli® Federated Identity Manager (TFIM) V6.2 を使用する WS-Trust V1.3 STS プロバイダー用のセキュリティー・プロファイルを作成します。
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
「デフォルト伝搬」プロファイルは、ID 伝搬のみを要求する事前定義プロファイルです。 WS-Trust V1.3 STS プロバイダー、LDAP、または TFIM V6.1 用セキュリティー・プロファイルを作成する方法について詳しくは、セキュリティー・プロファイルの作成を参照してください。
Siebel サーバー "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu" に接続する Siebel アダプター mySiebelAdapter.outadapter の SiebelConnection 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c SiebelConnection -o mySiebelAdapter.outadapter 
-n connectString -v "siebel://my.siebel.qa.com/SBA_80/SSEObjMgr_enu"

mqsisetdbparmsコマンドを使用して、Siebel アダプターのユーザー名とパスワードを設定できます。

TCPIPServer 構成可能サービスを次のように作成します。
mqsicreateconfigurableservice MB8BROKER -c TCPIPServer -o ServerPort1452 
-n Port,MaximumConnections,ExpireConnectionSec -v 1452,1000,15  
TCPIPClient 構成可能サービスを次のように作成します。
mqsicreateconfigurableservice MB8BROKER -c TCPIPClient 
-o ClientPort1452HostnameJsmith 
-n Port,Hostname,AlternativeAddresses,MinimumConnections,MaximumConnections 
-v 1452,jsmith.hursley.ibm.com,jones:1111;edwards,5,10  
接頭部が SYSTEM.BROKER.TIMEOUT.SET1 でタイムアウトが 5 秒のキューを使用する Timer 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c Timer -o myTimerService 
-n queuePrefix,timeoutIntervalSeconds -v SET1,5 
UserDefined サービスを次のように作成します。
mqsicreateconfigurableservice MB8BROKER -c UserDefined 
-o HTTP_Timeout -n VerifyRequestTimeout -v 60
WXSServer 構成可能サービスを作成して、WebSphere eXtreme Scale の外部グリッドへの接続を確立する方法を定義します。グリッドは、「myGrid」という名前のセキュア・グリッドです。次の例では、グリッドのカタログ・サーバーのホスト名は server.ibm.com で、サーバーはポート 2809 上にあります。指定変更ファイル xc10Client.xml が使用されています。mqsisetdbparms コマンドで作成されたセキュリティー ID の名前は「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"
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:47:50


参照トピック参照トピック | バージョン 8.0.0.5 | an37200_