Niestandardowe właściwości fabryki połączeń adaptera zasobów IMS TM należy prawidłowo skonfigurować, aby uzyskać zgodność z parametrami docelowego systemu EIS (Enterprise
Information System).
Podczas tworzenia definicji usługi IMS lub definiowania fabryki połączeń IMS
z serwerem aplikacji WebSphere Application
Server należy podać wartości dla pewnych właściwości połączenia między produktami IMS Connector
for Java i IMS Connect.
Poniższa lista opisuje właściwości połączenia:
- HostName
- Ta wartość jest obowiązkowa jedynie dla połączeń TCP/IP. W przypadku połączeń protokołu
Local Option jest ignorowana. Wartość "myHostNm" należy zastąpić
adresem IP lub nazwą hosta komputera, na którym jest uruchomiony docelowy produkt IMS Connect.
- PortNumber
- Ta wartość jest obowiązkowa jedynie dla połączeń TCP/IP. W przypadku połączeń protokołu
Local Option jest ignorowana. Wartość "0" należy zastąpić numerem
portu używanym dla połączeń TCP/IP przez docelowy produkt IMS Connect. Na pojedynczym porcie TCP/IP można otworzyć wiele gniazd,
a produkt IMS Connect można skonfigurować tak, aby mógł korzystać z wielu portów przy komunikacji
z produktem IMS Connector for Java i innymi klientami. Dodatkowe informacje na temat właściwości PortNumber zawiera rozdział "Configuring IMS Connect"
w podręczniku IMS Connect Guide and Reference(SC18-9287-02).
- CM0Dedicated
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP.
Wartością domyślną jest FALSE. Wartość FALSE wskazuje, że fabryka połączeń
generuje współużytkowane połączenia trwałego gniazda, a produkt IMS Connector for Java
generuje wartość clientID identyfikującą połączenie gniazda. Te połączenia mogą być wykorzystane przez interakcje w trybie kontroli transakcji 0 i 1. Wartość TRUE wskazuje, że fabryka połączeń wygeneruje połączenia trwałego gniazda dedykowanego, które w celu identyfikowania połączeń gniazda wymagają wartości właściwości clientID podanych przez użytkownika.
Każde dedykowane połączenie trwałego gniazda jest zarezerwowane dla konkretnej wartości clientID
i tylko interakcje w trybie kontroli transakcji 0 są dla nich
dozwolone.
- SSLEnabled
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP.
Wartością domyślną jest FALSE. Wartość TRUE wskazuje, że ta fabryka połączeń
będzie używana do tworzenia połączeń gniazda SSL z produktem IMS Connect z zastosowaniem właściwości HostName i PortNumber określonych
w jej właściwościach połączeń. Port określony przez właściwość PortNumber musi być skonfigurowany
w produkcie IMS Connect jako port SSL. Wartość FALSE wskazuje, że
w przypadku łączenia z portem podanym we właściwości
PortNumber nie będą wykorzystywane gniazda SSL.
- SSLKeyStoreName
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP, gdy wartość właściwości SSLEnabled
jest ustawiona na TRUE. Klucze prywatne SSL i powiązane z nimi certyfikaty klucza publicznego przechowywane są
w chronionych za pomocą haseł bazach danych, nazywanych magazynami kluczy. Dla wygody zaufane certyfikaty mogą być przechowywane w magazynie kluczy, a właściwość Truststore Name może być pusta albo wskazywać na plik kluczy. Jeśli właściwość
SSLKeyStoreName/SSLKeyStorePassword pozostanie pusta, w dzienniku serwera
zostanie wygenerowany komunikat informacyjny.
- W systemie z/OS właściwość SSLKeyStoreName może zostać użyta do określenia magazynu kluczy JKS
lub pliku kluczy RACF.
Dla platform innych niż system z/OS określa w pełni kwalifikowaną nazwę ścieżki pliku kluczy
JKS. W systemie z/OS określa nazwę pliku kluczy JKS, jak wyżej,
lub specjalny łańcuch, który zawiera informacje potrzebne do uzyskania dostępu
do pliku kluczy RACF.
Przykładem w pełni kwalifikowanej nazwy pliku kluczy
JKS jest c:\keystore\mójPlikKluczy.ks.
Plik kluczy RACF określany jest
jako: typ_pliku_kluczy:nazwa_pliku_kluczy:identyfikator_racf. Typ pliku kluczy
to JCERACFKS, gdy dla protokołu SSL wykorzystywane jest szyfrowanie programowe, lub JCE4758RACFKS w przypadku szyfrowania sprzętowego. Wartość nazwa_pliku_kluczy należy zastąpić nazwą pliku kluczy
RACF, który jest wykorzystywany
jako magazyn kluczy, a wartość identyfikator_racf identyfikatorem RACF z uprawnieniami
dostępu do określonego pliku kluczy. Przykładami specyfikacji pliku kluczy RACF są wartości
"JCERACFKS:plikKluczy:uzytkownik_pliku_kluczy01" i "JCE4758RACFKS:plikKluczy:uzytkownik_pliku_kluczy01".
W systemie z/OS
jeśli wartość SSLKeyStoreName jest zgodna z podanym wyżej formatem pliku kluczy RACF, produkt IMS Connector for Java jako swojego
magazynu kluczy użyje podanego pliku kluczy RACF. Jeśli określony typ pliku kluczy jest inny niż
JCERACFKS lub JCE4758RACFKS, produkt IMS Connector for Java próbuje
zinterpretować podaną wartość SSLKeyStoreName jako nazwę pliku kluczy JKS.
- Uwaga: Plik JKS może mieć inne rozszerzenia.
Nie musi to być rozszerzenie .ks.
- SSLKeyStorePassword
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP, gdy wartość właściwości SSLEnabled
jest ustawiona na TRUE. Określa hasło do magazynu kluczy.
- SSLTrustStoreName
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP, gdy wartość właściwości SSLEnabled
jest ustawiona na TRUE. Dla platform innych niż system z/OS określa w pełni kwalifikowaną nazwę ścieżki pliku zaufanych certyfikatów JKS. W systemie z/OS określa nazwę pliku kluczy JKS lub RACF magazynu zaufanych
certyfikatów. Format wartości we właściwościach SSLKeyStoreName
i SSLTrustStoreName jest taki sam. Omówienie tego formatu zawiera opis właściwości SSLKeyStoreName.
- Plik zaufanych certyfikatów to plik bazy danych kluczy (magazyn kluczy) przeznaczony do przechowywania kluczy publicznych lub certyfikatów. Dla wygody klucze prywatne mogą być przechowywane także w magazynie zaufanych certyfikatów; wtedy
właściwość Keystore Name może być pusta lub wskazywać na plik zaufanych certyfikatów. Jeśli właściwość SSLTrustStoreName/SSLTrustStorePassword pozostanie pusta, w dzienniku serwera wygenerowany zostanie
komunikat informacyjny.
- Uwaga: Plik JKS może mieć inne rozszerzenia.
Nie musi to być rozszerzenie .ks.
- SSLTrustStorePassword
- Ta wartość jest opcjonalna i ma zastosowanie jedynie do połączeń TCP/IP, gdy wartość właściwości SSLEnabled
jest ustawiona na TRUE. Określa hasło do magazynu zaufanych certyfikatów.
- SSLEncryptionType
- We właściwości SSLEncryptionType nie jest rozróżniana wielkość liter
i jest ona opcjonalna. Ma zastosowanie jedynie do połączeń TCP/IP, gdy wartość właściwości SSLEnabled
jest ustawiona na TRUE. Dozwolone wartości typu szyfrowania to STRONG, WEAK i ENULL. Wartości STRONG (silny) i
WEAK (słaby) odnoszą się do siły szyfru, która wiąże się z długością klucza.
Wszystkie szyfry, które mogą zostać użyte do eksportowania, należą do kategorii szyfrów słabych, a
pozostałe - do kategorii szyfrów silnych. Domyślnie ustawiony jest typ szyfrowania
WEAK (słaby). Jeśli podana jest wartość ENULL, adapter zasobów IMS TM
użyje specyfikacji szyfru, której nazwa zawiera łańcuch “NULL". Szyfrowanie zerowe
umożliwia przeprowadzenie uwierzytelniania w czasie procesu uzgadniania SSL,
który aktualnie się odbywa. Gdy tylko proces uzgadniania dla gniazda zostanie zakończony,
łącznie z wymaganym uwierzytelnieniem, wszystkie komunikaty będą przepływać przez gniazdo
bez szyfrowania.
- IMSConnectName
- Ta wartość jest obowiązkowa tylko dla połączeń Local Option. Określa nazwę
zadania docelowego produktu IMS Connect. Jeśli wartość IMSConnectName jest określona, właściwości
HostName, PortNumber oraz właściwości związane z protokołem SSL zostaną zignorowane. Gdy
nazwa produktu IMS Connect
jest określona jako fabryka połączeń, ta fabryka połączeń może być używana
tylko do tworzenia połączeń Local Option.
- UserName
- Ta wartość jest opcjonalna i stanowi domyślną nazwę użytkownika narzędzia autoryzacji SAF, która
będzie wykorzystywana dla połączeń tworzonych przez tę fabrykę połączeń, jeśli
komponent aplikacji lub kontener nie udostępni wartości właściwości
UserName.
- Password
- Ta wartość jest opcjonalna i określa hasło, które będzie wykorzystywane dla połączeń
tworzonych przez tę fabrykę połączeń w przypadku użycia domyślnej nazwy użytkownika.
- GroupName
- Ta wartość jest opcjonalna i określa nazwę grupy IMS, która będzie wykorzystywana dla wszystkich połączeń
tworzonych przez tę fabrykę połączeń w przypadku użycia domyślnej nazwy
użytkownika.
Uwaga: Właściwość GroupName może być podawana tylko w środowisku z logowaniem
do systemu EIS zarządzanym przez komponent.
- DataStoreName
- Ta wartość jest obowiązkowa i określa nazwę docelowej składnicy danych IMS.
Wartość domyślna, "myDStrNm", musi zostać zastąpiona przez parametr ID instrukcji
Datastore, która została określona w elemencie konfiguracji docelowego produktu IMS Connect. Ta wartość spełnia także rolę
nazwy elementu XCF dla systemu IMS podczas wewnętrznej komunikacji XCF między produktami IMS Connect
i IMS OTMA.
W wartości podanej dla właściwości DataStoreName rozróżniana jest wielkość liter.
- TraceLevel
- Ta wartość jest opcjonalna i określa poziom informacji, które mają być śledzone. Dodatkowe informacje
na temat poziomu śledzenia można znaleźć w sekcji Rejestrowanie i śledzenie z użyciem adaptera zasobów IMS TM.
- TransactionResourceRegistration
- Ta wartość jest opcjonalna i określa typ rejestracji zasobów transakcji
(rejestracja transakcji). Ta właściwość jest nieaktualna, ale wciąż jest obsługiwana
ze względu na potrzebę zachowania zgodności ze starszymi aplikacjami. Poprawne wartości to STATIC
(natychmiastowa) i DYNAMIC (odroczona). Jeśli ta właściwość ma wartość DYNAMIC, rejestracja
zasobu w zasięgu transakcji zostanie odroczona do momentu
pierwszego użycia zasobu w interakcji.
- MFS XMI Repository ID
- Ta wartość jest opcjonalna i określa unikalną nazwę identyfikującą położenie
repozytorium. Ten identyfikator odnosi się tylko do transakcji MFS i musi być zgodny z polem repozytorium
zdefiniowanym w wygenerowanej dla aplikacji procedurze obsługi. Wartością domyślną
tego pola jest "default".
- MFS XMI Repository URI
- Ta wartość jest opcjonalna i określa fizyczne położenie repozytorium XMI. Poprawne wartości dla tego pola to:
- file://ścieżka_do_xmi, gdzie ścieżka_do_xmi to katalog w lokalnym systemie plików zawierający pliki xmi, na przykład
file://c:/xmi.
- http://adres_url_do_xmi, gdzie adres_url_do_xmi to poprawny adres url katalogu zawierającego pliki xmi, na przykład
http://przykładowy_serwer.com/xmi.
- hfs://ścieżka_do_xmi, gdzie ścieżka_do_xmi to katalog HFS na hoście z/OS. Ten format obsługiwany jest jedynie przez serwer WebSphere Application
Server for z/OS.