Egy IMS
TM erőforrás-illesztő kapcsolatgyár egyéni tulajdonságait megfelelően be kell
állítani, hogy megfeleljen a cél vállalati információs rendszer (EIS) jellemzőinek.
IMS
szolgáltatás-meghatározás létrehozásakor vagy a WebSphere
Application Server kiszolgálóhoz IMS
kapcsolatgyár meghatározásakor meg kell adnia az IMS
Connector for Java
és az IMS
Connect közötti kapcsolat bizonyos tulajdonságainak értékeit.
Az alábbi lista leírja ezeket a kapcsolat-tulajdonságokat:
- HostName
- Ez az érték csak TCP/IP kapcsolatokra kötelező. Helyi beállítású
kapcsolatok esetén figyelmen kívül marad. A "myHostNm " értéket be kell
helyettesítenie a cél IMS
Connect programot futtató gép IP címével vagy hosztnevével.
- PortNumber
- Ez az érték csak TCP/IP kapcsolatokra kötelező. Helyi beállítású
kapcsolatok esetén figyelmen kívül marad. A "0" értéket be kell helyettesítenie a cél
IMS
Connect által TCP/IP kapcsolatokhoz használt port számával. Több socket
lehet megnyitva egy TCP/IP porton és az IMS
Connect beállítható több port használatára a kommunikációhoz az IMS
Connector for Java
programmal és más ügyfelekkel. A PortNumber tulajdonságról további
információk az IMS Connect útmutató és kézikönyv (SC18-9287-02) "Az IMS
Connect beállítása" fejezetében találhatók.
- CM0Dedicated
- Ez az érték elhagyható és csak TCP/IP kapcsolatokra vonatkozik.
Az alapértelmezett értéke FALSE. A FALSE érték azt jelzi, hogy a
kapcsolatgyár megosztható állandó socket kapcsolatokat fog előállítani és
az IMS
Connector for Java
hoz létre clientID ügyfélazonosítót a socket kapcsolat azonosításához. Ezeket
a kapcsolatokat 0 véglegesítési módú és 1 véglegesítési módú
interakciók használhatják. A TRUE érték azt jelzi, hogy a kapcsolatgyár
dedikált állandó socket kapcsolatokat hoz létre, amelyek felhasználó által
megadott clientID ügyfélazonosítókat igényelnek a socket kapcsolatok
azonosításához.
Minden egyes dedikált állandó socket kapcsolat egy adott clientID
azonosítóhoz fenntartott; csak 0 véglegesítési módú interakciók
megengedettek a dedikált állandó socket kapcsolatokon.
- SSLEnabled
- Ez az érték elhagyható és csak TCP/IP kapcsolatokra vonatkozik. Az
alapértelmezett értéke FALSE. A TRUE érték azt jelenti, hogy ezen
kapcsolatgyár segítségével kerülnek létrehozásra SSL socket kapcsolatok az IMS
Connect felé, a kapcsolatgyár kapcsolat tulajdonságaiban megadott HostName és PortNumber
felhasználásával. Ezt a PortNumber tulajdonságot SSL portként kell
beállítani az IMS
Connect konfigurációban. A FALSE érték azt jelzi, hogy nem kerülnek SSL
socket-ek felhasználásra a PortNumber tulajdonságban megadott portra
csatlakozáshoz.
- SSLKeyStoreName
- Ez az érték elhagyható, csak TCP/IP kapcsolatokra vonatkozik és az
SSLEnabled tulajdonságnak TRUE értékűnek kell lennie. Az SSLPrivate
magánkulcsok és a hozzájuk tartozó nyilvános kulcsú igazolások
kulcstárolóknak nevezett, jelszóval védett adatbázisokban kerülnek tárolásra. Kényelmi
okokból a megbízható igazolások szintén tárolhatók a kulcstárolóban; ekkor
a Truststore Name tulajdonság lehet üres vagy mutathat a kulcstároló fájlra. Ha
az SSLKeyStoreName / SSKeyStorePassword tulajdonság üresen marad, akkor
egy információs üzenet jön létre a kiszolgáló naplójában.
- A SSLKeyStoreName tulajdonság használható JKS kulcstároló vagy RACF
kulcscsomó megadására z/OS
platformon.
Nem z/OS platformok esetén a JKS kulcstároló fájl teljes képzésű elérési
útvonalát adja meg. z/OS
platform esetén adja meg a JKS kulcstároló fájl nevét a fentiek szerint
vagy a RACF
kulcscsomó eléréséhez szükséges információkat biztosító speciális
karaktersorozatot.
A JKS kulcstároló fájl teljes képzésű elérési útjára egy példa: c:\keystore\MyKeystore.ks.
Az RACF
kulcscsomó a következő módon kerül megadásra:
kulcstároló_típus:kulcscsomó_neve:racfid. A
kulcstároló_típus JCERACFKS értékű legyen, ha SSL szoftvertitkosítás
használt; JCE4758RACFKS értékű legyen, ha hardvertitkosítás kerül
alkalmazásra. Helyettesítse be a kulcscsomó_nevét az RACF
kulcscsomó nevével, amelyet kulcstárolóként használ; a
racfid azonosítót pedig egy RACF
azonosítóval, amely jogosult a megadott kulcscsomó elérésére. Példák az
RACF
kulcscsomó meghatározásokra: "JCERACFKS:myKeyring:kruser01"
vagy "JCE4758RACFKS:myKeyring:kruser01".
Ha z/OS
platformon az SSLKeyStoreName megfelel a fenti RACF
kulcscsomó formátumnak, akkor az IMS
Connector for Java
a megadott RACF
kulcscsomót fogja használni kulcstárolóként. Ha a megadott kulcstároló
típusa nem JCERACFKS vagy JCE4758RACFKS, akkor az IMS
Connector for Java
egy JKS kulcstároló fájl neveként próbálja meg értelmezni a megadott SSLKeyStoreName tulajdonságot.
- Megjegyzés: A JKS fájl lehet más
fájlkiterjesztésű is; nem kötelező .ks kiterjesztést kapnia.
- SSLKeyStorePassword
- Ez az érték elhagyható, csak TCP/IP kapcsolatokra vonatkozik és az
SSLEnabled tulajdonságnak TRUE értékűnek kell lennie. A kulcstárolóhoz
tartozó jelszót adja meg.
- SSLTrustStoreName
- Ez az érték elhagyható, csak TCP/IP kapcsolatokra vonatkozik és az
SSLEnabled tulajdonságnak TRUE értékűnek kell lennie. Nem z/OS platformok
esetén a JKS igazolástároló fájl teljes képzésű elérési útvonalát adja meg. z/OS
platform esetén az igazolástároló JKS nevét vagy az RACF
kulcscsomót adja meg. Az SSLKeyStoreName és az SSLTrustStoreName
tulajdonságok értékeire ugyanaz a formátum használt. Ezen formátumról a
KeyStore Name tulajdonság leírásában található bővebb magyarázat.
- Az igazolástároló fájl nyilvános kulcsok vagy igazolások tárolására
tervezett kulcs adatbázisfájl (kulcstároló). Kényelmi okok miatt a
magánkulcsok az igazolástárolóban is tárolhatók; ekkor a Keystore Name tulajdonság
lehet üres vagy mutathat az igazolástároló fájlra. Ha az SSLTrustStoreName / SSLTrustStorePassword
tulajdonság üresen marad, akkor egy információs üzenet jön létre a
kiszolgáló naplójában.
- Megjegyzés: A JKS fájl lehet más
fájlkiterjesztésű is; nem kötelező .ks kiterjesztést kapnia.
- SSLTrustStorePassword
- Ez az érték elhagyható, csak TCP/IP kapcsolatokra vonatkozik és az
SSLEnabled tulajdonságnak TRUE értékűnek kell lennie. Az
igazolástárolóhoz tartozó jelszót adja meg.
- SSLEncryptionType
- Az SSLEncryptionType tulajdonság elhagyható, értékében a kis- és
nagybetűk azonosnak számítanak. Csak TCP/IP kapcsolatokra vonatkozik; az
SSLEnabled tulajdonságnak TRUE értékűnek kell lennie. A titkosítás
típusa lehet STRONG, WEAK vagy ENULL. A STRONG és a WEAK értékek tükrözi a
rejtjelek erősségét, amely a kulcs hosszával áll kapcsolatban.
Az exportáláshoz használható rejtjelek a gyenge (weak) kategóriába
tartoznak; a többi az erős (strong) kategóriába esik. Alapértelmezésben a
titkosítás típusa WEAK. ENULL érték megadása esetén az IMS TM
erőforrás-illesztő olyan rejtjelet használ, amelynek neve a “NULL"
karaktersorozatot tartalmazza. A nulltitkosítás lehetővé teszi, hogy a
hitelesítés az SSL egyeztetési folyamat során valósuljon meg, amely
vonatkozik erre az esetre. Miután egy socket egyeztetési folyamata a
szükséges hitelesítéssel együtt befejeződött, minden üzenet azon a
socket-en keresztül fog áthaladni.
- IMSConnectName
- Ez az érték csak Helyi beállítású kapcsolatokra kötelező. Megadja a cél IMS
Connect feladatnevét. IMSConnectName megadása esetén a hosztnév, portszám
és az SSL tulajdonságok figyelmen kívül maradnak. Ha IMS Connect
név kerül megadásra egy kapcsolatgyár számára, akkor az adott kapcsolatgyár csak
Helyi beállítású kapcsolatok létrehozására használható.
- UserName
- Ez az érték elhagyható; ez a biztonsági hitelesítés szolgáltatáshoz (SAF) tartozó alapértelmezett
felhasználónév, ami a kapcsolatgyár által létrehozott kapcsolatokhoz kerül
felhasználásra, ha az alkalmazás komponens vagy a tároló a UserName
tulajdonságot nem biztosítja.
- Password
- Ez az érték elhagyható; ez a kapcsolatgyár által létrehozott
kapcsolatokhoz használt jelszó alapértelmezett felhasználónév használata esetén.
- GroupName
- Ez az érték elhagyható; ez a kapcsolatgyár által létrehozott
összes kapcsolathoz használt IMS
csoportnév alapértelmezett felhasználónév használata esetén.
Megjegyzés: A
GroupName tulajdonság csak összetevő által felügyelt EIS bejelentkezési
környezetben adható meg.
- DataStoreName
- Ez az érték kötelező; ez a cél IMS
adattároló neve.
Az alapértelmezett "myDStrNm" értéket helyettesítenie kell a cél IMS
Connect konfigurációs tagjában megadott Datastore sorának ID paraméterével. Az IMS
XCF tagneveként is használt az IMS
Connect és az IMS
OTMA közötti belső XCF kommunikáció során.
A DataStoreName tulajdonság értékéban a kis- és nagybetűk eltérőnek számítanak.
- TraceLevel
- Ez az érték elhagyható; a nyomkövetésben szereplő információk szintjét jelenti. A
nyomkövetési szintről további információkért tanulmányozza a következőt:
Naplózás és nyomkövetés az IMS TM erőforrás-illesztővel.
- TransactionResourceRegistration
- Ez az érték elhagyható; ez a tranzakció erőforrás-bejegyzés
(tranzakció besorolás) típusa. Ez a tulajdonság elavult, de a korábbi
alkalmazások kompatibilitása érdekében még támogatott. Az érvényes
értékek: STATIC (azonnali) vagy DYNAMIC (halasztott). Ha a tulajdonság
DYNAMIC értékű, akkor az erőforrás besorolása a tranzakció hatókörébe
halasztásra kerül, amíg az erőforrás első alkalommal egy interakcióhoz
felhasználásra nem kerül.
- MFS XMI lerakat azonosító
- Ez az érték elhagyható; egy egyedi név a lerakat helyének az
azonosításához. Az azonosító csak MFS tranzakciókra vonatkozik és meg kell
egyeznie az alkalmazás előállított formátumkezelőjében meghatározott lerakat
mezővel. A mező alapértelmezett értéke "default".
- MFS XMI lerakat URI
- Ez az érték elhagyható; meghatározza az XMI lerakat fizikai helyét. A
mezőre vonatkozó érvényes formátumú URI azonosítók a következők:
- file://xmi_elérési_út, ahol az
xmi_elérési_út az xmi fájlokat tartalmazó könyvtár a helyi fájlrendszeren,
például: file://c:/xmi.
- http://xmi_url, ahol az xmi_url egy
érvényes URL, amely az xmi fájlokat tartalmazó könyvtárra mutat, például:
http://sampleserver.com/xmi.
- hfs://xmi_elérési_út ahol az
xmi_elérési_út a HFS könyvtár a z/OS
hoszton. Ez a formátum csak a WebSphere
Application Server for z/OS
rendszerre támogatott.