Sie können Eigenschaftendateien verwenden, um Eigenschaften für
IBM MQ-Topics zu erstellen oder zu ändern.
Vorbereitende Schritte
Stellen Sie fest, welche Änderungen Sie an der Konfiguration der IBM MQ-Topics
vornehmen möchten.
Starten Sie das Scripting-Tool "wsadmin".
Zum Starten von
"wsadmin" in der Sprache Jython führen Sie im Verzeichnis bin
des Serverprofils den Befehl wsadmin -lang Jython
aus.
Informationen zu diesem Vorgang
Mit einer Eigenschaftendatei können Sie ein IBM MQ-Topicobjekt
und seine Konfigurationseigenschaften
erstellen, ändern oder löschen.
Führen Sie mit
"wsadmin" Verwaltungsbefehle aus, um eine Eigenschaftendatei für ein IBM MQ-Topic
zu erstellen oder zu ändern,
die Eigenschaften auszuwerten und sie auf Ihre Konfiguration anzuwenden.
Tabelle 1. Aktionen für Eigenschaftendateien für ein IBM MQ-Topic. Sie können Konfigurationseigenschaften für ein IBM MQ-Topic erstellen, ändern und löschen.Aktion |
Prozedur |
create |
Legen Sie Eigenschaften fest, und führen Sie dann den Befehl "applyConfigProperties" aus. |
modify |
Bearbeiten Sie Eigenschaften, und führen Sie dann den Befehl "applyConfigProperties" aus. |
delete |
Entfernen Sie die Kommentarzeichen
vor #DELETE=true, und führen Sie den Befehl
"deleteConfigProperties" aus. |
Sie können wahlweise den Dialogmodus mit den Befehlen verwenden:
AdminTask.Befehlsname('-interactive')
Vorgehensweise
- Erstellen Sie ein IBM MQ-Topic
und seine Eigenschaften.
- Erstellen Sie eine Eigenschaftendatei für ein MQ-Topicobjekt ("MQTopic").
Öffnen Sie einen Editor und erstellen Sie
eine Eigenschaftendatei für das MQ-Topic.
Sie können in diesem Schritt die
Beispieleigenschaftendatei in einen Editor kopieren und die Eigenschaften entsprechend Ihrer Situation ändern.
Nachfolgend ist ein Beispiel einer Eigenschaftendatei für ein MQ-Topicobjekt
("MQTopic") mit dem JNDI-Namen topicJndiName
unter einem JMS-Provider mit dem Namen IBM MQ JMS Provider
auf Zellenebene dargestellt:
#
# Header
#
ResourceType=MQTopic
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:JMSProvider=WebSphere MQ JMS Provider:MQTopic=jndiName#topicJndiName
#DELETE=true
#
#Eigenschaften
#
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
#
#
#Umgebungsvariablen
cellName=WASCell06
- Führen Sie den Befehl
"applyConfigProperties" aus, um eine Konfiguration des MQ-Topics
zu erstellen.
Der Befehl "applyConfigProperties"
wendet die Eigenschaftendatei auf die Konfiguration an.
In diesem Beispiel für
Jython erzeugt der optionale Parameter -reportFileName einen Bericht mit dem Namen
report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Ändern Sie ein vorhandenes IBM MQ-Topic.
- Rufen Sie für das IBM MQ-Topic
eine Eigenschaftendatei ab, die
Sie ändern möchten.
Sie können mit dem Befehl "extractConfigProperties"
eine Eigenschaftendatei für ein MQ-Topic
extrahieren.
- Öffnen Sie die Eigenschaftendatei in einem Editor, und ändern Sie die Eigenschaften in der gewünschten Weise.
Stellen Sie sicher, dass die Umgebungsvariablen in der Eigenschaftendatei mit den Umgebungsvariablen Ihres Systems übereinstimmen.
- Führen Sie den Befehl
"applyConfigProperties" aus, um die Konfiguration eines IBM MQ-Topics
zu ändern.
- Wenn Sie ein IBM MQ-Topic
nicht mehr benötigen, können Sie das gesamte
IBM MQ-Topicobjekt löschen.
Um das gesamte Objekt zu löschen,
geben Sie im Headerabschnitt der Eigenschaftendatei
DELETE=true an, und führen Sie
den Befehl "deleteConfigProperties" aus. Beispiel:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Ergebnisse
Sie können die Eigenschaftendatei verwenden, um das IBM MQ-Topicobjekt
zu konfigurieren und zu verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.