Свойства спецификации активации

Свойства спецификации активации содержат информацию о конфигурации обработки входящих событий для конечной точки сообщений. Их можно задать с помощью мастера поиска служб предприятия или административной консоли WebSphere Process Server.

Свойства спецификации активации J2C (также называемые свойствами сообщений и конечной точки) соответствуют интерфейсу ActivationSpec архитектуры коннекторов J2EE. Эти свойства относятся к работе с интерфейсом ALE, так как спецификация активации используется во время активации конечной точки. Активация конечной точки - это процесс уведомления адаптера подходящих обработчиков событий. При обработке входящих запросов эти обработчики используются адаптером для приема событий от SAP перед их передачей в конечную точку (объект, управляемый сообщениями).

При настройке адаптера можно задать свойства спецификации активации, перечисленные ниже.

Табл. 1. Свойства спецификации активации
Имя свойства в мастере поиска служб предприятия Имя свойства в административной консоли Тип Описание Значение по умолч.
Код сбоя Ale aleFailureCode Строка Задает код состояния для сбоя при передаче. Для того чтобы адаптер обновлял код неудачи SAP после извлечения адаптером объекта IDoc для обработки события, для этого свойства необходимо задать значение (68 или 58). SAP преобразует это значение в 40. Нет
Описание сбоя Ale aleFailureText Строка Задает описание сбоя при передаче. Указывать значение для этого свойства не обязательно, даже если для свойства AleUpdateStatus задано значение true. Нет
Выборочное обновление Ale aleSelectiveUpdate Строка Указывает, какие комбинации IDocType и MessageType должны обновляться, если адаптер настроен на обновление стандартного кода состояния SAP. Значения этого свойства можно задавать только в том случае, если для свойства AleUpdateStatus указано значение true.

Синтаксис этого свойства следующий: IDocType: MessageType [;IDocType: MessageType [;...]], где косая черта (/) отделяет IDocType от MessageType, а точка с запятой (;) используется в качестве разделителя записей в наборе.

Рассмотрим пример с двумя наборами. MATMAS03 и DEBMAS03 - это структуры IDoc, а MATMAS и DEBMAS - типы сообщений:

MATMAS03/MATMAS;DEBMAS03/DEBMAS

 
Код сообщения о состоянии Ale aleStatusMsgCode Строка Если требуется, задает код сообщения для использования при передаче адаптером сообщения ALEAUD Message IDoc (ALEAUD01). Настройте этот код сообщения в принимающем профайле партнера. Значение этого свойства можно указывать только в том случае, если для свойства AleUpdateStatus задано значение true. Нет
Код успеха Ale aleSuccessCode Строка Задает код успеха для переданного документа приложения. Для того чтобы адаптер обновлял код успеха SAP после извлечения интерфейсом объекта IDoc для обработки события, для этого свойства необходимо задать значение (52 или 53). SAP преобразует это значение в состояние 41 (Документ приложения создан в принимающей системе). Нет
Текст успеха Ale aleSuccessText Строка Задает текст описания для успешной передачи документа приложения. Указывать значение для этого свойства не обязательно, даже если для свойства AleUpdateStatus задано значение true. Нет
Состояние обновления Ale aleUpdateStatus Булевское значение Указывает, требуется ли контрольный журнал для всех типов сообщений. Если требуется, чтобы адаптер обновлял стандартный код состояния SAP после извлечения им объекта IDoc для обработки событий, установите для этого свойства значение true. False
Хост сервера приложений applicationServerHost Строка Если адаптер настроен для работы без распределения нагрузки, то это свойство содержит IP-адрес или имя сервера приложений, на который входит адаптер. Независимо от того, настроен адаптер для работы с распределением или нет, он предполагает, что имя хоста шлюза совпадает со значением, указанным в этом свойстве. Нет
Гарантированная однократная доставка события assuredOnceDelivery Булевское значение Если значение этого свойства равно true, то адаптер пытается сохранить информацию XID в хранилище событий. Если значение равно false, то адаптер не пытается сохранить эту информацию. Значение true обеспечивает гарантированную однократную доставку события. Значение false не обеспечивает гарантированную однократную доставку события, однако повышает быстродействие. Это свойство используется только в том случае, если MDB поддерживает транзакции. Если нет, то вне зависимости от конфигурации транзакции использовать нельзя. True
Автоматическое создание таблицы событий EP_CreateTable Булевское значение Флаг, указывающий, должна ли таблица восстановления событий автоматически создаваться адаптером, если она не существует. True
Клиент client Строка Номер клиента SAP, под котором адаптер входит в систему. Обычно равен 100. 100
Номер кодовой страницы codepage Integer Устанавливает соединение на подходящем языке. Значение этого свойства должно соответствовать значению, указанному в свойстве Язык.

Например, если для свойства Язык указано значение JA (японский язык), то для свойства Номер кодовой страницы необходимо указать значение 8000, как предписывается приложением SAP.

Точные значения этих свойств приведены в документации по SAP.

 
Имя схемы базы данных EP_SchemaName Строка Схема, применяемая для автоматического создания таблицы восстановления событий. Нет
Специальный формат BiDi для имени источника данных biDiContext_EDTDatasource BiDiSpecialFormat Строка Управляет форматом двунаправленного текста для всех свойств EP.  
Формат BiDi EIS biDiContextEIS Строка Формат двунаправленного текста, применяемый системой SAP для своей деловой информации.  
Специальный формат BiDi EIS biDiContextSpecialFormat Строка Указывает категорию значений, подлежащих специальной обработке во время вызова преобразования двунаправленного текста; тем самым гарантируется точное преобразование данной категории значений. Категории являются стандартными (например, FTP, URL и электронные адреса).  
Интервал повтора установления соединения с EIS retryInterval Integer Задает продолжительность задержки перед попыткой перезапуска обработчиков событий ALE. Значение указывается в миллисекундах.  
Ограничение на число попыток перезапуска соединения с EIS retryLimit Integer Указывает число попыток перезапуска обработчиков событий ALE адаптером. Значение 0 соответствует бесконечному числу повторов. 0
Формат BiDi хранилища событий biDiContext_EDTTablenameEIS Строка Задает формат двунаправленного текста для свойства Хранилище событий. ILYNN
Имя (JNDI) источника данных восстановления событий EP_DataSource_JNDIName Строка Имя JNDI источника данных, настроенного для восстановления событий. Нет
Имя таблицы восстановления событий EP_TableName Строка Имя таблицы восстановления событий.  
Хост шлюза gatewayHost Строка Хост шлюза SAP, на котором запущена служба шлюза. Нет
Служба шлюза gatewayService Строка Идентификатор сервера шлюза. Обычно равен sapgw00. 00 - системный номер сервера, на котором запущен шлюз SAP (обычно это сервер приложений). Если серверов несколько, вместо 00 следует указать другой номер. sapgw00
Группа входа в систему logonGroup Строка Если адаптер настроен для работы в режиме с распределением нагрузки, то это свойство задает имя группы входа в систему, которая представляет собой группу серверов приложений. Нет
Игнорировать ошибки пакета IDoc ignoreIDocPacketErrors Булевское значение Если при обработке пакета IDoc адаптер обнаруживает ошибку, то его дальнейшее поведение определяется значением данного свойства.

Если значение равно false, адаптер прекращает обработку остальных структур IDoc в пакете и отправляет в в систему SAP сообщение об ошибке.

Если значение равно true, адаптер заносит ошибку в протокол и продолжает обработку оставшихся в этом пакете структур IDoc.

Для отдельных IDoc и для неделимых пакетов IDoc это свойство не используется.

 
Язык language Строка Язык, с которым адаптер входит в систему. E (для англ. языка)
Хост сервера сообщений messageServerHost Строка Если адаптер настроен для работы в режиме с распределением нагрузки, то это свойство задает имя сервера сообщений. Нет
Формат BiDi для метаданных biDiContextMetadata Строка Задает формат двунаправленного текста для метаданных конфигурации.  
Число обработчиков событий numberofListeners Integer Указывает число обработчиков событий, которые должны быть запущены. 1
Кодировка партнера partnerCharset Строка Задает кодировку PartnerCharset. Применяется указанная кодировка; если кодировка не указана, то применяется кодировка по умолчанию. Нет
Пароль password Строка Пароль учетной записи пользователя для адаптера в системе SAP.  
Формат BiDi для пароля biDiContext_PasswordEIS Строка Задает формат двунаправленного текста для пароля. ILYNN
Пароль для подключения к источнику данных событий EP_Password Строка Пароль пользователя для подключения к базе данных. Нет
ИД программы RFC rfcProgramID Строка Идентификатор программы, с которым регистрируется программа сервера RFC. Нет
Включить трассировку RFC RFCTraceOn Булевское значение Указывает, должен ли создаваться текстовый файл с подробным описанием операции RFC для каждого обработчика событий. Возможные значения: true или false. Значение true включает трассировку, в результате которой создается текстовый файл. Такие файлы рекомендуется создавать только в среде разработки, так как они могут быстро увеличиваться в размере. False
ИД системы SAP SAPSystemID Строка Если адаптер настроен для работы в режиме с распределением нагрузки, то это свойство задает логическое имя системы (известное также как имяR3). Нет
Пропустить преобразование BiDi biDiContextSkip Строка Управляет вызовом преобразования двунаправленного текста. Возможные значения: true или false. Пустое значение вызывает механизм поиска.  
Пропустить преобразование BiDi для имени источника данных biDiContext_EDTDatasourceEIS Булевское значение Управляет вызовом преобразования двунаправленного текста для свойства Пароль. True
Пропустить преобразование BiDi для хранилища событий biDiContext_EDTTablenameSkip Булевское значение Управляет вызовом преобразования двунаправленного текста для свойства Хранилище событий. True
Пропустить преобразование BiDi для пароля biDiContext_PasswordSkip Булевское значение Управляет вызовом преобразования двунаправленного текста для свойства Пароль. True
Пропустить преобразование BiDi для имени пользователя biDiContext_UserNameSkip Булевское значение Управляет вызовом преобразования двунаправленного текста для свойства Имя пользователя. True
Системный номер systemNumber Строка Системный номер сервера приложений. Значение этого свойства представляет собой двузначное число, обычно - 00. 00
Имя пользователя userName Строка Имя учетной записи пользователя адаптера в системе SAP. Нет
Формат BiDi для имени пользователя biDiContext_UserNameEIS Строка Задает формат двунаправленного текста для свойства Имя пользователя ILYNN
Имя пользователя для подключения к источнику данных событий EP_UserName Строка Имя пользователя для подключения к базе данных. Нет
Ссылки, связанные с данной
Свойства соединения для поиска служб предприятия
Свойства адаптера ресурсов
Свойства фабрики управляемых соединений (J2C)
Параметры, управляющие преобразованием двунаправленного текста

Условия использования |


(c) Copyright IBM Corporation 2005, 2006.
Данная справочная система Information Center создана на основе технологии Eclipse (http://www.eclipse.org)