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

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

許可

すべてのオペレーティング・システムで、ユーザー ID は mqbrkrs グループのメンバーでなければなりません。

応答

このコマンドは、以下の応答を戻します。
  • 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 
変更の終わり
オブジェクト参照の場所を指定する CORBA 構成可能サービスを作成します。
mqsicreateconfigurableservice MB8BROKER -c CORBA -o myCORBAService
-n namingService,objectReferenceName -v localhost:2809,Europe.region/Market.object
実行時に参照する、EmailInput ノードまたはメッセージ・フローの EmailServer 構成可能サービスを作成して、pop3://test.email.server.ibm.com ポート 12345 で実行されている E メール・サーバーに接続します。次の例ではセキュリティー 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"
ブローカー MB8BROKER に関する、MyProviderXYZ という JMS プロバイダーを追加します。
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_MyProviderXYZ
リソース・プロパティーのデフォルト値を使用して、ブローカー MB8BROKER に関する ProviderABC という JMS プロバイダーを追加します。
mqsicreateconfigurableservice MB8BROKER -c JMSProviders -o JMS_ProviderABC
ベンダー固有の API 呼び出しを処理する com.ibm.broker.apihandler.BEAWebLogicAPIHandler という IBM 提供の Java クラスの名前を指定して、ブローカー MB8BROKER に関する 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
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
最終更新

        最終更新 : 2012-07-13 15:43:36


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