Sie können Eigenschaftendateien verwenden, um Eigenschaften für
IBM MQ-Warteschlangenverbindungsfactorys zu erstellen oder zu ändern.
Vorbereitende Schritte
Stellen Sie fest, welche Änderungen Sie an der Konfiguration der IBM MQ-Warteschlangenverbindungsfactory
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-Warteschlangenverbindungsfactory-Objekt
und seine Konfigurationseigenschaften
erstellen, ändern oder löschen.
Führen Sie mit
"wsadmin" Verwaltungsbefehle aus, um eine Eigenschaftendatei für eine IBM MQ-Warteschlangenverbindungsfactory
zu erstellen oder zu ändern,
die Eigenschaften auszuwerten und sie auf Ihre Konfiguration anzuwenden.
Tabelle 1. Aktionen für Eigenschaftendateien für eine IBM MQ-Warteschlangenverbindungsfactory. Sie können Konfigurationseigenschaften
der MQ-Warteschlangenverbindungsfactory 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 eine IBM MQ-Warteschlangenverbindungsfactory und ihre Eigenschaften.
- Erstellen Sie eine Eigenschaftendatei für ein Verbindungsfactory-Objekt
für MQ-Warteschlangen ("MQQueueConnectionFactory").
Öffnen Sie einen Editor und erstellen Sie eine Eigenschaftendatei für die IBM MQ-Warteschlangenverbindungsfactory.
Sie können in diesem Schritt die
Beispieleigenschaftendatei in einen Editor kopieren und die Eigenschaften entsprechend Ihrer Situation ändern.
In dem Beispiel wird eine IBM MQ-Warteschlangenverbindungsfactory mit dem Namen
myJndiName unter einem JMS-Provider auf Zellenebene definiert:
#
# Header
#
ResourceType=MQQueueConnectionFactory
ImplementingResourceType=JMSProvider
ResourceId=Cell=!{cellName}:JMSProvider=IBM MQ JMS Provider:MQQueueConnectionFactory=jndiName#myJndiName
#DELETE=true
#
#Eigenschaften
#
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
#
#
#Umgebungsvariablen
cellName=WASCell06
- Führen Sie den Befehl
"applyConfigProperties" aus, um die Konfiguration einer IBM MQ-Warteschlangenverbindungsfactory
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-Warteschlangenverbindungsfactory.
- Rufen Sie für die IBM MQ-Warteschlangenverbindungsfactory eine Eigenschaftendatei ab, die
Sie ändern möchten.
Sie können mit dem Befehl "extractConfigProperties"
eine Eigenschaftendatei für ein "MQQueueConnectionFactory"-Objekt
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-Warteschlangenverbindungsfactory
zu ändern.
- Wenn Sie eine IBM MQ-Warteschlangenverbindungsfactory
nicht mehr benötigen, können Sie das gesamte
IBM MQ-Warteschlangenverbindungsfactory-Objekt 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-Warteschlangenverbindungsfactory-Objekt
zu konfigurieren und zu verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.