Właściwości fabryki połączeń IMS

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.

Opinie