プロパティー・ファイルを使用して、IBM MQ トピック・プロパティーの作成または変更を行えます。
始める前に
IBM MQ トピック構成に行う変更を決定します。
wsadmin スクリプト・ツールを開始します。
Jython 言語を使用して wsadmin を開始する場合は、サーバー・プロファイルの bin ディレクトリーから wsadmin -lang Jython コマンドを実行します。
このタスクについて
プロパティー・ファイルを使用して、IBM MQ トピック・オブジェクトおよびその構成プロパティーの作成、変更、削除を行えます。
wsadmin を使用して管理コマンドを実行し、
IBM MQ トピック・プロパティー・ファイルの作成または変更、プロパティーの検証、プロパティーの構成への適用を行います。
表 1. IBM MQ トピック・プロパティー・ファイルのアクション. IBM MQ トピック構成プロパティーは作成、変更、および削除できます。アクション |
手順 |
作成 |
プロパティーを設定し、applyConfigProperties コマンドを実行します。 |
modify |
プロパティーを編集し、applyConfigProperties コマンドを実行します。 |
delete |
#DELETE=true のコメントを外し、deleteConfigProperties コマンドを実行します。 |
オプションで、以下のコマンドを使用して、対話モードを使用することができます。
AdminTask.command_name('-interactive')
手順
- IBM MQ トピックおよびそのプロパティーを作成します。
- MQTopic オブジェクトのプロパティー・ファイルを作成します。
エディターを開き、MQ トピック・プロパティー・ファイルを作成します。
このステップのプロパティー・ファイルの例をエディターにコピーして、プロパティーを状況に応じて変更できます。
以下は、セル有効範囲の IBM MQ JMS Provider という名前の JMSProvider の下にある、
JNDI 名が topicJndiName である MQTopic オブジェクトのプロパティー・ファイルの例です。
#
# Header
#
ResourceType=MQTopic
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:JMSProvider=WebSphere MQ JMS Provider:MQTopic=jndiName#topicJndiName
#DELETE=true
#
#Properties
#
wildcardFormat=topicWildcards #ENUM(characterWildcards|allWildcards|topicWildcards),default(topicWildcards)
readAhead=YES #ENUM(QUEUE_DEFINED|YES|NO),default(YES)
specifiedExpiry=0 #long,default(0)
baseTopicName=topicBaseTopicName #required
brokerPubQmgr=null
providerType=null #readonly
decimalEncoding=Normal #ENUM(Normal|Reversed),default(Normal)
expiry=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|SPECIFIED|UNLIMITED),default(APPLICATION_DEFINED)
sendAsync=YES #ENUM(QUEUE_DEFINED|YES|NO),default(YES)
integerEncoding=Normal #ENUM(Normal|Reversed),default(Normal)
brokerPubQueue=null
specifiedPriority=0 #integer,default(0)
jndiName=topicJndiName #required
CCSID=0 #integer,default(0)
category=null
description=null
brokerVersion=V1 #ENUM(V2|V1),default(V1)
brokerCCDurSubQueue=null
brokerDurSubQueue=null
boolean=null
targetClient=JMS #ENUM(JMS|MQ),default(JMS)
priority=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|SPECIFIED|QUEUE_DEFINED),default(APPLICATION_DEFINED)
provider=IBM MQ JMS Provider #ObjectName(JMSProvider),readonly
persistence=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|HIGH|NONPERSISTENT|PERSISTENT|QUEUE_DEFINED),default(APPLICATION_DEFINED)
floatingPointEncoding=IEEENormal #ENUM(IEEENormal|IEEEReversed|S390),default(IEEENormal)
readAheadClose=DELIVERALL #ENUM(DELIVERCURRENT|DELIVERALL),default(DELIVERALL)
multicast=AS_CF #ENUM(AS_CF|DISABLED|NOT_RELIABLE|RELIABLE|ENABLED),default(AS_CF)
name=topicName #required
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=WASCell06
- applyConfigProperties コマンドを実行して、MQTopic 構成を作成します。
applyConfigProperties コマンドを実行すると、構成にプロパティー・ファイルが適用されます。以下の Jython の例では、オプションの -reportFileName パラメーターによって report.txt という名前のレポートが作成されます。
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- 既存の IBM MQ トピックを変更します。
- 変更する IBM MQ トピックのプロパティー・ファイルを取得します。
extractConfigProperties コマンドを使用して、MQTopic のプロパティー・ファイルを抽出することができます。
- エディターでプロパティー・ファイルを開き、必要に応じてプロパティーを変更します。
プロパティー・ファイル内の環境変数が、ご使用のシステムと一致していることを確認してください。
- applyConfigProperties コマンドを実行して、IBM MQ トピック構成を変更します。
- IBM MQ トピックがもう必要ない場合には、IBM MQ トピック・オブジェクト全体を削除することができます。
オブジェクト全体を削除する場合は、プロパティー・ファイルのヘッダー・セクションに DELETE=true を指定し、deleteConfigProperties コマンドを実行します。以下に例を示します。
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
タスクの結果
プロパティー・ファイルを使用して、IBM MQ トピック・オブジェクトを構成および管理することができます。