Die optimierten lokalen Adapter für die z/OS-RAR-Datei (Ressourcenadapterarchiv) muss auf dem lokalen
z/OS-Knoten installiert sein. Wenn Sie eine andere Plattform als z/OS verwenden, kommuniziert die OLA-RAR-Datei (Optimized
Local Adapters, optimierte lokale Adapter) über Remote Method Invocation
over Internet Inter-ORB Protocol (RMI-IIOP) mit einer Instanz der OLA-EAR-Daei (Unternehmensarchiv) auf einem fernen
z/OS-Knoten.
Vorbereitende Schritte
Weitere Informationen zu optimierten lokalen Adaptern im Entwicklungsmodus finden Sie im gleichnamigen Artikel.
Informationen zu diesem Vorgang
Wenn eine OLA-Verbindungsfactory auf dem lokalen Knoten erstellt wird, müssen verschiedene Eigenschaften definiert werden, um diese Kommunikation
zu ermöglichen:
- RemoteHostname
- Der Hostname des fernen z/OS-Knotens.
- RemotePort
- Der RMI-Port auf dem fernen z/OS-Knoten.
Das kann der RMI-Port für eine bestimmte Instanz von
WebSphere Application Server for z/OS oder den lokalen Knoten sein.
- RemoteJNDIName
- Der JNDI-Name (Java™ Naming and Directory Interface), unter dem die OLA-Proxy-EAR-Datei
in JNDI auf dem fernen Knoten gefunden wurde.
Die JNDI-Suche (Lookup) wird mit einem JNDI-InitialContext ausgeführt, der über die Eigenschaften "RemoteHostname" und "RemotePort"
und durch Anfordern des Namensbereichs "NameSpaceServerRoot" abgerufen wird.
- RemoteJNDIUsername
- Der Benutzername, der verwendet werden soll, wenn der JNDI-Namenskontext vom fernen Knoten abgerufen wird.
- RemoteJNDIPassword
- Das Kennwort, das verwendet werden soll, wenn der JNDI-Namenskontext vom fernen Knoten abgerufen wird.
- RemoteJNDIRealm
- Der Realmname, der verwendet werden soll, wenn der JNDI-Namenskontext vom fernen Knoten abgerufen wird. Möglicherweise müssen Sie
den Realmnamen angeben, wenn sowohl der lokale als auch der ferne Knoten die WebSphere-Sicherheit
verwenden, sich jedoch in verschiedenen Realms befinden.
Vorgehensweise
- Die OLA-RAR-Datei auf dem lokalen Knoten ruft eine Referenz auf die OLA-Proxy-EAR-Datei ab, indem sie eine JNDI-Suche durchführt. Mit
dem URL corbaloc:iiop:<RemoteHostname>:<RemotePort>/NameSpaceServerRoot wird ein Namenskontext abgerufen.
Wenn dieser Kontext abgerufen ist, wird eine Suche mit RemoteJNDIName ausgeführt. Wenn die OLA-Proxy-EAR-Datei auf einem fernen z/OS-Knoten mit der standardmäßig verwendeten
JNDI-Bindungsposition installiert wurde, kann die OLA-RAR-Datei auf dem lokalen Knoten durch Angabe des RMI-Ports der Zielinstanz von
WebSphere Application Server for z/OS und des
RemoteJNDIName com.ibm.ws390.ola.jca.ProxyEJBRemote, der die Standardbindung für die ferne OLA-Proxy-Schnittstelle ist, installiert werden.
- Sie können andere Eigenschaften der OLA-RAR-Verbindungsfactory, wie z. B. registerName, festlegen, indem Sie sie
in den Attributen der Verbindungsfactory für den Ressourcenadapter angeben.
Diese Werte werden auf dem fernen z/OS-Knoten berücksichtigt.
- Der lokale Knoten und der ferne z/OS-Knoten verwenden möglicherweise verschiedene Benutzerregistrys.
In der OLA-RAR-Verbindungsfactory sind zwei weitere Eigenschaften verfügbar, damit für die Anforderung eine Anmeldung durchgeführt und
eine Benutzer-ID für die OLA-Interaktion festgelegt werden kann:
- Username
- Der Benutzername, der verwendet werden soll, wenn die OLA-Interaktion ausgeführt wird.
- Password
- Das Kennwort, das für die Eigenschaft "Username" verwendet werden soll.
Wenn Benutzername und Kennwort festgelegt werden, wird unmittelbar vor Ausführung der OLA-Interaktion eine Anmeldung durchgeführt.
Bei erfolgreicher Anmeldung wird die z/OS-Benutzer-ID, die dem Benutzernamen entspricht, mit der OLA-Anforderung gesendet. Gegenwärtig wird
die z/OS-Benutzer-ID bei der Kommunikation mit CICS über den OLA-Link-Server verwendet. Die CICS-Zieltransaktion nur mit der
z/OS-Benutzer-ID gestartet, wenn der Link-Server mit dem Parameter SEC=YES und die CICS-Region mit SEC=YES ausgeführt wird. Für IMS wird diese Benutzer-ID
nur weitergegeben und zugesichert, wenn die Option SYNC-TO-THREAD auf dem Server von WebSphere Application Server for z/OS aktiviert und der
Parameter OTMASE=FULL OTMA gesetzt ist.
Es kann auch ein J2C-JAAS-Aliasname für die Angabe
des Benutzernamens und des Kennworts verwendet werden. Klicken Sie zum Verwenden eines J2C-JAAS-Aliasnamens in der Administrationskonsole auf
Ressourcen > Ressourcenadapter > J2C-Verbindungsfactorys > Name_der_Verbindungsfactory >
JAAS-J2C-Authentifizierungsdaten > Aliasname, und geben Sie die Benutzer-ID und das Kennwort ein. Der Ressourcenadapter
ruft die Benutzer-ID und das Kennwort über diese Einstellung ab. Wenn auch ein JAAS-Aliasname für die Angabe des Benutzernamens und des Kennworts
in der Verbindungsfactory verwendet wird, haben der Benutzername und das Kennwort in der Verbindungsfactory Vorrang.
Die Methoden "setUserid()" und "setPassword()" in ConnectionSpecImpl haben Vorrang vor beiden diesen anderen Methoden.