プロパティー・ファイルを使用して、IBM MQ キュー接続ファクトリー・プロパティーの作成または変更を行えます。
始める前に
IBM MQ キュー接続ファクトリー構成またはその構成オブジェクトに行う変更を決定します。
wsadmin スクリプト・ツールを開始します。
Jython 言語を使用して wsadmin を開始する場合は、サーバー・プロファイルの bin ディレクトリーから wsadmin -lang Jython コマンドを実行します。
このタスクについて
プロパティー・ファイルを使用して、IBM MQ キュー接続ファクトリー・オブジェクトおよびその構成プロパティーの作成、変更、削除を行えます。
wsadmin を使用して管理コマンドを実行し、
IBM MQ キュー接続ファクトリー・プロパティー・ファイルの作成または変更、プロパティーの検証、プロパティーの構成への適用を行います。
表 1. IBM MQ キュー接続ファクトリー・プロパティー・ファイルのアクション. MQ キュー接続ファクトリー構成プロパティーは作成、変更、および削除できます。アクション |
手順 |
作成 |
プロパティーを設定し、applyConfigProperties コマンドを実行します。 |
modify |
プロパティーを編集し、applyConfigProperties コマンドを実行します。 |
delete |
#DELETE=true のコメントを外し、deleteConfigProperties コマンドを実行します。 |
オプションで、以下のコマンドを使用して、対話モードを使用することができます。
AdminTask.command_name('-interactive')
手順
- IBM MQ キュー接続ファクトリーおよびそのプロパティーを作成します。
- MQQueueConnectionFactory オブジェクトのプロパティー・ファイルを作成します。
エディターを開き、IBM MQ キュー接続ファクトリー・プロパティー・ファイルを作成します。
このステップのプロパティー・ファイルの例をエディターにコピーして、プロパティーを状況に応じて変更できます。以下の例では、セル有効範囲の JMSProvider の下に
IBM MQ キュー接続ファクトリー myJndiName を定義します。
#
# Header
#
ResourceType=MQQueueConnectionFactory
ImplementingResourceType=JMSProvider
ResourceId=Cell=!{cellName}:JMSProvider=IBM MQ JMS Provider:MQQueueConnectionFactory=jndiName#myJndiName
#DELETE=true
#
#Properties
#
wmqServerSvrconnChannel=null
diagnoseConnectionUsage=false #boolean,default(false)
CCSID=null
rcvExit=null
wmqServerName=null
sslConfiguration=null
host=null
category=null
tempModel=null
replyWithRFH2=AS_REPLY_DEST #ENUM(AS_REPLY_DEST|ALWAYS),default(AS_REPLY_DEST)
secExit=null
name=myName #required
xaRecoveryAuthAlias=null
description=null
useConnectionPooling=true #boolean,default(true)
manageCachedHandles=false #boolean,default(false)
wmqServerEndpoint=null
provider=IBM MQ JMS Provider #ObjectName(JMSProvider),readonly
ccdtUrl=null
providerVersion=null
sslResetCount=0 #integer,default(0)
secExitInitData=null
pollingInterval=5000 #integer,default(5000)
msgRetention=true #boolean,default(true)
jndiName= myJndiName #required
queueManager=null
sendExit=null
authMechanismPreference=BASIC_PASSWORD #ENUM(BASIC_PASSWORD|KERBEROS),default(BASIC_PASSWORD)
sendExitInitData=null
maxBatchSize=10 #integer,default(10)
tempQueuePrefix=null
XAEnabled=true #boolean,default(true)
providerType=null #readonly
channel=null
rcvExitInitData=null
port=0 #integer,default(0)
authDataAlias=null
sslPeerName=null
rescanInterval=6000 #integer,default(5000)
compressHeaders=NONE #ENUM(SYSTEM|NONE),default(NONE)
failIfQuiesce=true #boolean,default(true)
clientID=null
localAddress=null
sslCRL=null
logMissingTransactionContext=true #boolean,default(true)
transportType=BINDINGS #ENUM(BINDINGS_THEN_CLIENT|DIRECTHTTP|BINDINGS|DIRECT|CLIENT),default(BINDINGS)
sslCipherSuite=null
compressPayload=NONE #ENUM(ZLIBHIGH|ZLIBFAST|RLE|NONE),default(NONE)
qmgrType=QMGR #ENUM(QSG|QMGR),default(QMGR)
sslType=NONE #ENUM(CENTRAL|SPECIFIC|NONE),default(NONE)
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=WASCell06
- applyConfigProperties コマンドを実行して、IBM MQ キュー接続ファクトリー構成を作成します。
applyConfigProperties コマンドを実行すると、構成にプロパティー・ファイルが適用されます。以下の Jython の例では、オプションの -reportFileName パラメーターによって report.txt という名前のレポートが作成されます。
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- 既存の IBM MQ キュー接続ファクトリーを変更します。
- 変更する IBM MQ キュー接続ファクトリーのプロパティー・ファイルを取得します。
extractConfigProperties コマンドを使用して、MQQueueConnectionFactory オブジェクトのプロパティー・ファイルを抽出することができます。
- エディターでプロパティー・ファイルを開き、必要に応じてプロパティーを変更します。
プロパティー・ファイル内の環境変数が、ご使用のシステムと一致していることを確認してください。
- applyConfigProperties コマンドを実行して、IBM MQ キュー接続ファクトリー構成を変更します。
- IBM MQ キュー接続ファクトリーがもう必要ない場合には、IBM MQ キュー接続ファクトリー・オブジェクト全体を削除することができます。
オブジェクト全体を削除する場合は、プロパティー・ファイルのヘッダー・セクションに DELETE=true を指定し、deleteConfigProperties コマンドを実行します。以下に例を示します。
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
タスクの結果
プロパティー・ファイルを使用して、IBM MQ キュー接続ファクトリー・オブジェクトを構成および管理することができます。