Свойства фабрики соединений IMS

Пользовательские свойства фабрики ресурсов адаптера соединений IMS TM необходимо настраивать правильно - они должны соответствовать характеристикам целевой Информационной системы предприятия.

При определении службы IMS или фабрики соединений IMS для WebSphere Application Server требуется указывать значения некоторых свойств соединения между IMS Connector for Java и IMS Connect. Ниже приведены описания этих свойств:

HostName
Обязательно только для соединений TCP/IP. Для соединений Local Option игнорируется. Необходимо заменить значение "myHostNm " IP-адресом или именем хоста системы, в которой выполняется целевой IMS Connect.
PortNumber
Обязательно только для соединений TCP/IP. Для соединений Local Option игнорируется. Необходимо заменить значение "0 " номером порта, который используется целевым IMS Connect для соединений TCP/IP. Если открыть несколько сокетов на одном порте TCP/IP и настроить IMS Connect, то для обмена данными между IMS Connector for Java и другими клиентами можно будет использовать несколько портов. За дополнительной информацией о свойстве PortNumber обратитесь к разделу "Configuring IMS Connect" книги IMS Connect Guide and Reference (SC18-9287-02).
CM0Dedicated
Необязательное значение; относится только к соединениям TCP/IP. Стандартное значение - FALSE. При значении FALSE фабрика соединений создаёт соединение с общим постоянным сокетом, а IMS Connector for Java генерирует для него ИД клиента. Такие соединения можно использовать для взаимодействий в режимах фиксации 0 и 1. При значении TRUE фабрика соединений создает соединения с выделенным постоянным сокетом, для идентификации которых применяется указанный пользователем ИД клиента. Каждое соединение с выделенным постоянным сокетом резервируется для определенного ИД клиента и доступно только для взаимодействий с режимом фиксации 0.
SSLEnabled
Необязательное значение; относится только к соединениям TCP/IP. Стандартное значение - FALSE. Если значение равно TRUE, то данная фабрика соединений создает соединения с SSL сокетами для IMS Connect, используя имя хоста и номер порта, указанные в соответствующих свойствах. Указанный номер порта должен быть определён как порт SSL в конфигурации IMS Connect. Если значение равно FALSE, то сокеты SSL не применяются для подключения к порту, заданному в свойстве PortNumber.
SSLKeyStoreName
Необязательное значение; относится только к соединениям TCP/IP. Для SSLEnabled должно быть задано значение TRUE. Ключи SSLPrivate и соответствующие им общие ключи хранятся в защищённых паролями базах данных, называемых хранилищами ключей. Для удобства в эти хранилища также можно помещать надежные сертификаты. Тогда значение свойства Truststore Name может быть пустым или указывать на файл хранилища ключей. Если значение SSLKeyStoreName / SSKeyStorePassword property пустое, в протокол сервера заносится соответствующее информационное сообщение.
В свойстве SSLKeyStoreName можно указать хранилище ключей JKS или набор ключей RACF (только для z/OS). Для платформ, отличных от z/OS, в этом свойстве задается полный путь к файлу хранилища ключей JKS. В системе z/OS, укажите имя файла набора ключей JKS или введите особую строку с информацией для доступа к набору ключей RACF. Пример полного имени файла JKS: c:\keystore\MyKeystore.ks. Формат имени набора ключей RACF: keystore_type:keyring_name:racfid. Вместо компонента тип-хранилища следует подставить JCERACFKS, если для SSL используется программное шифрование, или JCE4758RACFKS, если используется аппаратное шифрование. Замените набор-ключей на имя набора ключей RACF, а racfid - на ИД RACF с правом доступа к указанному набору ключей. Примеры спецификаций наборов ключей RACF: "JCERACFKS:myKeyring:kruser01" или "JCE4758RACFKS:myKeyring:kruser01". Для z/OS: Если SSLKeyStoreName задано в указанном выше формате хранилища ключей RACF, то IMS Connector for Java использует в качестве хранилища ключей соответствующий набор ключей RACF. Если тип хранилища ключей отличен от JCERACFKS и JCE4758RACFKS, IMS Connector for Java постарается интерпретировать указанное SSLKeyStoreName как имя файла хранилища ключей JKS.
Примечание: Файл JKS может иметь любое расширение, хотя обычно оно и равно .ks.
SSLKeyStorePassword
Необязательное значение; относится только к соединениям TCP/IP. Для SSLEnabled должно быть задано значение TRUE. Пароль хранилища ключей.
SSLTrustStoreName
Необязательное значение; относится только к соединениям TCP/IP. Для SSLEnabled должно быть задано значение TRUE. Полное имя файла хранилища надежных сертификатов JKS. В случае z/OS, укажите имя файла JKS или хранилище ключей RACF хранилища доверенных сертификатов. Формат этого значения такой же, как у значений свойств SSLKeyStoreName и SSLTrustStoreName. См. описание свойства KeyStore Name.
Хранилище надежных сертификатов - это база данных ключей (хранилище ключей), предназначенная для хранения общих ключей или сертификатов. Для удобства в это хранилище можно помещать и личные ключи. Тогда значение свойства Keystore Name может быть пустым или указывать на файл хранилища надежных сертификатов. Если значение SSLTrustStoreName / SSLTrustStorePassword пустое, в протокол сервера заносится соответствующее информационное сообщение.
Примечание: Файл JKS может иметь любое расширение, хотя обычно оно и равно .ks.
SSLTrustStorePassword
Необязательное значение; относится только к соединениям TCP/IP. Для SSLEnabled должно быть задано значение TRUE. Пароль хранилища надежных сертификатов.
SSLEncryptionType
Необязательное значение; регистр не учитывается. Относится только к соединениям TCP/IP. Для SSLEnabled должно быть задано значение TRUE. Выберите тип шифрования - STRONG, WEAK или ENULL. STRONG и WEAK - это характеристики надежности шифра, которая определяется длиной ключа. Все шифры, которые можно использовать для экспорта, считаются "weak", а остальные - "strong". По умолчанию выбран тип шифрования WEAK. При выборе ENULL адаптер ресурсов IMS TM испльзует шифр со строкой “NULL" в названии. Если выбран тип шифрования Null, идентификация происходит во время SSL квитирования, именно так сейчас и организован процесс. По завершении процесса квитирования (с необходимой идентификацией) для сокета все сообщения сбрасываются через этот сокет.
IMSConnectName
Обязательно только для соединений Local Option. Укажите имя задания целевого экземпляра IMS Connect. Если значение этого свойства указано, то свойства Host name, Port number и свойства, связанные с SSL, игнорируются. Если указано имя IMS Connect для фабрики соединений, то для создания соединений Local Option может быть использована только эта фабрика соединений.
UserName
Необязательное значение; имя пользователя SAF, которое будет использоваться для соединений, создаваемых фабрикой соединений в случае, если свойство UserName не задано компонентом приложения или контейнером.
Password
Необязательное значение; пароль, который будет использоваться для соединений, создаваемых фабрикой соединений в случае, если используется имя пользователя по умолчанию.
GroupName
Необязательное значение; имя группы IMS, которое будет использоваться для всех соединений, создаваемых фабрикой соединений в случае, если используется имя пользователя по умолчанию.
Прим.: Свойство GroupName может указываться только для среды, где входом в систему EIS управляют компоненты.
DataStoreName
Обязательное значение; имя целевого хранилища данных IMS. Необходимо заменить стандартное значение "myDStrNm" параметром ID оператора Datastore в целевом элементе конфигурации IMS Connect. Также применяется в качестве имени элемента XCF для IMS во внутренних соединениях XCF между IMS Connect и IMS OTMA. Регистр символов в значении учитывается.
TraceLevel
Необязательное значение; объём информации, сохраняемой в записях трассировки. Дополнительная информация об объеме трассировки приведена в разделе Ведение протоколов и трассировка при работе с адаптером ресурсов IMS TM.
TransactionResourceRegistration
Необязательное значение; тип регистрации ресурса транзакции (задействование соединения в транзакции). Свойство уже не используется, но пока поддерживается в целях совместимости со старыми приложениями. Допустимые значения: STATIC (немедленная регистрация) и DYNAMIC (отложенная регистрация). Если задано значение DYNAMIC, регистрация ресурса в области транзакции откладывается до первого использования ресурса при взаимодействии.
MFS XMI Repository ID
Необязательное значение; уникальное имя, идентифицирующее расположение хранилища. Этот ИД относится только к транзакциям MFS; должен совпадать с соответствующим полем, определённым в сгенерированном обработчике формата вашего приложения. Стандартное значение - "default".
MFS XMI Repository URI
Необязательное значение; задает физическое расположение хранилища XMI. URI использует допустимые форматы:
  • file://путь-к-xmi, где путь-к-xmi - это каталог локальной файловой системы с файлами xmi, например file://c:/xmi.
  • http://адрес-каталога-xmi, где адрес-каталога-xmi - это адрес каталога с файлами xmi, например http://sampleserver.com/xmi.
  • hfs://путь-к-xmi, где путь-к-xmi - каталог HFS в системе z/OS. Поддерживается только для WebSphere Application Server for z/OS.

Комментарии