Sie können Eigenschaftendateien verwenden, um Eigenschaften für
IBM MQ-Warteschlangen zu erstellen oder
zu ändern.
Vorbereitende Schritte
Stellen Sie fest, welche Änderungen Sie an der Konfiguration der IBM MQ-Warteschlange
oder an den zugehörigen Konfigurationsobjekten 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-Warteschlangenobjekt
und seine Konfigurationseigenschaften
erstellen, ändern oder löschen.
Führen Sie mit
"wsadmin" Verwaltungsbefehle aus, um eine Eigenschaftendatei für eine IBM MQ-Warteschlange
zu extrahieren,
die Eigenschaften auszuwerten und sie auf Ihre Konfiguration anzuwenden.
Tabelle 1. Aktionen für Eigenschaftendateien für eine IBM MQ-Warteschlange. Sie können Konfigurationseigenschaften
für eine IBM MQ-Warteschlange
erstellen, ändern und löschen.Aktion |
Prozedur |
create |
Legen Sie mindestens die erforderlichen 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. |
delete Property |
Zum Löschen einer oder mehrere Eigenschaften führen Sie
den Befehl
"deleteConfigProperties" aus, wobei die Eigenschaftendatei nur die Eigenschaften enthalten darf, die gelöscht werden sollen. |
Sie können wahlweise den Dialogmodus mit den Befehlen verwenden:
AdminTask.Befehlsname('-interactive')
Vorgehensweise
- Erstellen Sie eine IBM MQ-Warteschlange und ihre Eigenschaften.
- Erstellen Sie eine Eigenschaftendatei für ein MQ-Warteschlangenobjekt ("MQQueue").
Öffnen Sie einen Editor und erstellen Sie
eine Eigenschaftendatei für die IBM MQ-Warteschlange.
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-Warteschlangenobjekt
("MQQueue") mit dem Namen myName und dem JNDI-Namen
myJndiName unter einem JMS-Provider auf Zellenebene dargestellt:
#
# Header
#
ResourceType=MQQueue
ImplementingResourceType=JMSProvider
ResourceId=Cell=!{cellName}:JMSProvider=IBM MQ JMS Provider:MQQueue=jndiName#myJndiName
#
#
#Eigenschaften
#
queueManagerPort=0 #integer,default(0)
password=null
readAhead=YES #ENUM(QUEUE_DEFINED|YES|NO),default(YES)
specifiedExpiry=0 #long,default(0)
queueManagerHost=null
baseQueueName=queueName #required
baseQueueManagerName=null
providerType=null #readonly
decimalEncoding=Normal #ENUM(Normal|Reversed),default(Normal)
serverConnectionChannelName=null
expiry=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|SPECIFIED|UNLIMITED),defaul
t(APPLICATION_DEFINED)
sendAsync=YES #ENUM(QUEUE_DEFINED|YES|NO),default(YES)
userName=null
integerEncoding=Normal #ENUM(Normal|Reversed),default(Normal)
specifiedPriority=0 #integer,default(0)
jndiName=myJndiName#required
CCSID=0 #integer,default(0)
category=null
description=null
useNativeEncoding=false #boolean,default(false)
boolean=null
targetClient=JMS #ENUM(JMS|MQ),default(JMS)
priority=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|SPECIFIED|QUEUE_DEFINED),
default(APPLICATION_DEFINED)
persistence=APPLICATION_DEFINED #ENUM(APPLICATION_DEFINED|HIGH|NONPERSISTENT|PERSISTENT|QUEUE_DEFINED),default(APPLICATION_DEFINED)
provider=IBM MQ JMS Provider #ObjectName(JMSProvider),readonly
floatingPointEncoding=IEEENormal #ENUM(IEEENormal|IEEEReversed|S390),default(IEEENormal)
readAheadClose=DELIVERALL #ENUM(DELIVERCURRENT|DELIVERALL),default(DELIVERALL)
name=myName #required
EnvironmentVariablesSection
#
#
#Umgebungsvariablen
cellName=WASCell06
- Führen Sie den Befehl
"applyConfigProperties" aus, um eine Konfiguration der MQ-Warteschlange
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 eine vorhandene IBM MQ-Warteschlange.
- Rufen Sie für die IBM MQ-Warteschlange
eine Eigenschaftendatei ab, die
Sie ändern möchten.
Sie können mit dem Befehl "extractConfigProperties"
eine Eigenschaftendatei für eine MQ-Warteschlange ("MQQueue")
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 einer IBM MQ-Warteschlange
zu ändern.
- Löschen Sie das gesamte IBM MQ-Warteschlangenobjekt oder seine Eigenschaften.
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]')
Zum Löschen einer oder mehrere Eigenschaften
geben Sie nur die Eigenschaften in der Eigenschaftendatei an, die gelöscht werden sollen, und führen
Sie den Befehl
"deleteConfigProperties" aus.
Ergebnisse
Sie können die Eigenschaftendatei verwenden, um das IBM MQ-Warteschlangenobjekt
zu konfigurieren und zu verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.