Sie können Eigenschaftendateien verwenden, um
Eigenschaften für eine CMP-Verbindungsfactory
zu erstellen, zu ändern oder zu löschen (CMP = Container Managed Persistence).
Vorbereitende Schritte
Stellen Sie fest, welche Änderungen Sie an der Konfiguration der CMP-Verbindungsfactory
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 das Objekt einer CMP-Verbindungsfactory
erstellen, ändern oder löschen.
Führen Sie mit "wsadmin" Verwaltungsbefehle aus,
um eine Eigenschaftendatei für eine CMP-Verbindungsfactory auf Ihre Konfiguration
anzuwenden, die Eigenschaften auszuwerten oder sie zu löschen.
Tabelle 1. Aktionen für Eigenschaftendateien der CMP-Verbindungsfactory. Sie können Eigenschaften der CMP-Verbindungsfactory
erstellen, ändern und löschen.Aktion |
Prozedur |
create |
Legen Sie die erforderlichen Eigenschaften fest, und führen Sie dann den Befehl
"applyConfigProperties" aus. |
modify |
Bearbeiten Sie die erforderlichen Eigenschaften, und führen Sie dann den Befehl
"applyConfigProperties" aus. |
delete |
Zum Löschen des gesamten Objekts
"CMPConnectorFactory" entfernen Sie die Kommentarzeichen vor dem Eintrag
#DELETE=true, und führen Sie dann den Befehl
"deleteConfigProperties" aus. |
create Property |
Nicht zutreffend |
delete Property |
Nicht zutreffend |
Sie können wahlweise den Dialogmodus mit den Befehlen verwenden:
AdminTask.Befehlsname('-interactive')
Vorgehensweise
- Erstellen Sie eine Eigenschaftendatei für eine Instanz von
"CMPConnectorFactory".
- Legen Sie die gewünschten
Eigenschaften für "CMPConnectorFactory" fest.
Öffnen Sie eine Eigenschaftendatei
des Objekts "CMPConnectorFactory" in einem Editor.
Ändern Sie den Abschnitt mit den Umgebungsvariablen (EnvironmentVariablesSection)
Ihrem System entsprechend und legen Sie die Eigenschaftswerte fest, die geändert werden müssen.
Nachfolgend ist ein Beispiel einer Eigenschaftendatei für "CMPConnectorFactory"
dargestellt:
#
# Header
#
ResourceType=CMPConnectorFactory
ImplementingResourceType=J2CResourceAdapter
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:J2CResourceAdapter=myJ2CResourceAdapter:
CMPConnectorFactory=jndiName#myCFJNDI
#DELETE=true
#
#
#Eigenschaften
#
name=myCF #required
connectionDefinition=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:J2CResourceAdapter=
myJ2CResourceAdapter:Connector=:ResourceAdapter=:OutboundResourceAdapter=:ConnectionDefinition=
connectionFactoryImplClass#com.ibm.ws.rsadapter.cci.WSRdbConnectionFactoryImpl #ObjectName
(ConnectionDefinition),required
category=null
authMechanismPreference=BASIC_PASSWORD #ENUM(BASIC_PASSWORD|KERBEROS),default(BASIC_PASSWORD)
providerType=null
jndiName=myCFJNDI #required
diagnoseConnectionUsage=false #boolean,default(false)
xaRecoveryAuthAlias=null
authDataAlias=null
manageCachedHandles=false #boolean,default(false)
description=null
logMissingTransactionContext=true #boolean,default(true)
#
EnvironmentVariablesSection
#Umgebungsvariablen
cellName=myCell
nodeName=myNode
serverName=myServer
- Führen Sie den Befehl
"applyConfigProperties" aus, um eine
Konfiguration der CMP-Verbindungsfactory
zu erstellen oder zu ändern.
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 Eigenschaftendatei.
- Rufen Sie für die CMP-Verbindungsfactory
eine Eigenschaftendatei
ab, die Sie ändern möchten.
Sie können eine Eigenschaftendatei für das Objekt
"CMPConnectorFactory" mit dem Befehl
"extractConfigProperties" 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.
- Wenn Sie die CMP-Verbindungsfactory
nicht mehr benötigen, können Sie das gesamte
Objekt 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 mit der
Eigenschaftendatei das Objekt der CMP-Verbindungsfactory und seine Eigenschaften konfigurieren und verwalten.
Nächste Schritte
Speichern Sie die Änderungen in Ihrer Konfiguration.