© Copyright International Business Machines Corporation 2000, 2006. Все права защищены. Ограниченные права пользователей государственных учреждений США - Использование, копирование или обнародование регламентируется Контрактом GSA ADP с IBM Corp.
Дополнительная информация об Общем адаптере протокола TPTP доступна на Информация о выпуске TPTP V4.2.
Когда Общий адаптер протокола непрерывно отслеживает файл протокола, он не обрабатывает последнюю запись, если не указан шаблон конца. Последняя запись будет обработана только при выключении Общего адаптера протокола.
Для того чтобы обеспечить обработку последней записи в процессе отслеживания, предоставьте шаблон конца в файле конфигурации Общего адаптера протокола.
Когда Общий адаптер протокола используется для синтаксического анализа двоичных операций или служебных протоколов WebSphere(R) Application Server в системе UNIXTM, пользователь должен иметь равные или более высокие права доступа, чем программа установки WebSphere Application Server.
Для того чтобы обойти эту проблему, переместите двоичные операции или служебные протоколы в каталог с такими же правами доступа, которые имеет пользователь Общего адаптера протокола, перед выполнением синтаксического анализа протоколов.
Когда Общий адаптер протокола используется для синтаксического анализа протоколов ошибок WebSphere MQ в системе UNIX, пользователь должен иметь равные или более высокие права доступа, чем программа установки WebSphere MQ.
Для того чтобы обойти эту проблему, переместите протоколы ошибок MQ в каталог с такими же правами доступа, которые имеет пользователь Общего адаптера протокола, перед выполнением синтаксического анализа протоколов.
При попытке использования файла runregex_showlog_example.bat или runregex_showlog_example.sh для выполнения синтаксического анализа протокола операций WebSphere Application Server не удается найти утилиту просмотра протокола WebSphere Application.
Для того чтобы обойти эту проблему, измените regex_showlog_example.adapter для файла в редакторе правил, а также измените свойство Sensor Converter, чтобы оно указывало на расположение каталога WebSphere Application Server.
Общий адаптер протокола будет генерировать неверный элемент extendedDataElements События общего формата для записи протокола, если не существует правила, соответствующего или имени, или типу. Элемент extendedDataElement не должен генерироваться, если не существует имени или типа в записи протокола, но Общий адаптер протокола будет его генерировать только с полем значения.
Для того чтобы обойти эту проблему, предоставьте правила, соответствующие всем трем полям элемента extendedDataElement - имени, значению и типу.
Когда Общий адаптер протокола выполняется в автономном режиме, вне среды Eclipse, он заносит ошибки и сообщения протокола в файл hgla.log в текущем рабочем каталоге. Если файл hgla.log уже существует в текущем рабочем каталоге, то создается новый файл hgla.nnnnnnnn.log, где nnnnnnnn - это уникальный номер. Когда Общий адаптер протокола выполняется как часть операции импорта протокола, сообщения об ошибках, которые он вносит в протокол, показываются в окне диалога ошибки а Анализаторе трассировки и протокола.
При выполнении в среде Eclipse в проекции Общий адаптер протокола, сообщения и ошибки, которые вносятся в протокол Общим адаптером протокола, показываются на панели Неполадки.
Общий адаптер протокола вносит в протокол события, имеющие уровни ведения протокола 5, 10, 20, 30, 50 и 60, в зависимости от значения loggingLevel для Контекстов и Компонентов в файле конфигурации адаптера. Файл hgla.log может быть импортирован в Анализатор трассировок и протоколов как файл типа XML События общего формата для диагностики неполадок, обнаруженных Общим адаптером протокола при синтаксическом анализе файла протокола.
Общий адаптер протокола не выполняет проверки, соответствует ли тип анализируемого файла протокола конфигурации файла адаптера. Например, если файл протокола, указанный в конфигурации детектора в файле адаптера, имеет тип, отличный от того, для которого предназначена конфигурация приемника и правила подстановки в конфигурации анализатора, то это может привести к непредсказуемым результатам. Синтаксический анализ может закончиться без ошибок, но результирующие данные События общего формата будут неверными. Синтаксический анализ может также завершиться с сообщениями об ошибках, указывающих на обнаружение неверных данных.
Для того чтобы обойти эту проблему, укажите в конфигурации компонента детектора файл протокола правильного типа.
При выполнении синтаксического анализа файлов протокола действий WebSphere Application Server с помощью runregex_showlog_example.bat/sh в не-английских системах данные записи протокола не будут успешно преобразованы в Событие общего формата. Вместо этого, данные записи протокола могут появится в неверном поле События общего формата.
При синтаксическом анализе файлов протокола, которые содержат временные метки в локали, отличной от той локали, в которой выполняется Общий адаптер протокола, использующий основанный на правилах файл адаптера, настроенный для использования атрибута Формат времени в правиле подстановки для creationTime, временная метка и другие данные записи протокола могут неверно анализироваться. Например, значения creationTime в результирующих Событиях общего формата могут быть равными нулю, а поле msg События общего формата может оказаться пустым.
Для того чтобы обойти эту проблему, убедитесь в том, что значения атрибутов кода языка ISO и кода страны ISO Экземпляра контекста в файле адаптера, основанном на правилах, соответствуют локали временных меток в анализируемом файле протокола.
При выполнении преобразования файлов протокола, в которых используются неуникальные трехбуквенные символы часового пояса, в Событие общего формата, использующее Общий адаптер протокола, может возникнуть неверное время создания событий протокола. Например, трехбуквенный символ "IST" может быть интерпретирован как Israeli Standard Time, Indian Standard Time, Iran Standard Time или Irish Summer Time.
При анализе протокола IBM(R) DB2(R) Express Diagnostic с адаптерами в % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, результирующее Событие общего формата, записанное в файл вывода, нарушает спецификацию События общего формата. Это обусловлено ошибкой в утилите db2diag.exe, которая используется для преобразования протоколов DB2 Diagnostic в События общего формата. Во всем остальном это не влияет на синтаксический анализ. Не известно обходных путей, кроме исправления db2diag.exe.
Синтаксический анализ файла протокола с помощью файла адаптера, созданного в предыдущей версии Редактора конфигурации адаптера, может привести к следующему сообщению об ошибке в файле протокола Общего адаптера протокола hgla.log:
IWAT0383E Ошибка проверки адаптера: cvc-complex-type.4: Атрибут 'lineBreakSymbol' должен присутствовать в элементе 'ex:Extractor'.
Прежние версии Редактора конфигурации адаптера создавали файлы адаптера без обязательного атрибута Приемника lineBreakSymbol. Этот атрибут должен присутствовать в элементе Приемника, даже если он имеет нулевое значение. Общий адаптер протокола теперь проверяет соответствие файла адаптера схеме Общего адаптера протокола перед его использованием, а атрибут lineBreakSymbol является обязательным в схеме.
Для того чтобы обойти эту проблему, откройте файл адаптера в Редакторе конфигурации адаптера, добавьте непустое значение в поле lineBreakSymbol элемента Приемника, сохраните файл адаптера, а затем удалите это значение, если оно не требуется, и сохраните файл снова. Теперь файл адаптера будет содержать атрибут lineBreakSymbol в элементе Приемник.
Синтаксический анализ файла протокола с помощью файла адаптера, созданного в предыдущей версии Редактора конфигурации адаптера, может привести к следующему сообщению об ошибке в файле протокола Общего адаптера протокола hgla.log:
IWAT0438E Программа форматирования События общего формата N76D20B0042411D98000E0362B33D6F0 не может создать CommmonBaseEvent, потому что отсутствует обязательное свойство sourceComponentId.
Это сообщение указывает на то, что компонент программы форматирования События общего формата не может создать Событие общего формата, потому что отсутствует обязательное свойство sourceComponentId События общего формата. Общий адаптер протокола теперь проверяет наличие всех обязательных свойств в Событии общего формата, и в случае их отсутствия Событие общего формата не возвращается. Файл адаптера не может иметь правила синтаксического анализа для свойств, указанных в сообщениях, или неверные правила синтаксического анализа.
Для того чтобы обойти эту проблему, добавьте к файлу адаптера правила синтаксического анализатора для отсутствующих обязательных свойств События общего формата или проверьте правильность существующих правил.
При синтаксическом анализе протоколов на консоли могут появиться следующие сообщения об ошибках:
IWAT0310E Общий адаптер протокола не может быть запущен из-за неполадок конфигурации. IWAT0317E Ошибка при компоновке компонента AdapterLogSensor. IWAT0319E Невозможно создать экземпляр класса org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor. Exception = org/eclipse/emf/ecore/EObjectДля того чтобы обойти эту проблему, измените опцию -classpath в файлах сценариев выполнения gla.bat и gla.sh:
Эта информация была разработана для продуктов и служб, предлагаемых в США.
IBM не может предлагать продукты, службы и компоненты, которые обсуждаются в этой документации, в других странах. Информацию о продуктах и услугах, предоставляемых в вашей стране, можно получить в местном представительстве IBM. Любые упоминания о продуктах, программах и службах IBM не утверждают и не предполагают, что только эти продукты, программы и службы IBM могут быть использованы. Вместо них можно использовать любые другие функционально эквивалентные продукты, программы или услуги, не нарушающие прав IBM на интеллектуальную собственность. Однако в этом случае ответственность за проверку работы этих продуктов, программ и услуг возлагается на пользователя.
У IBM могут быть патенты или решения о выдаче патентов, относящихся к предмету обсуждения этого документа. Предоставление этого документа не означает предоставления какой-либо лицензии на эти патенты. Запросы на приобретение лицензий вы можете отправлять по следующему адресу:
IBM Director of Licensing
Запросы на лицензии, связанные с информацией DBCS, следует направлять в отдел интеллектуальной собственности в местном представительстве IBM или в письменном виде по следующему адресу:
IBM World Trade Asia Corporation
В данной публикации могут встретиться технические неточности и типографские опечатки. В информацию периодически вносятся изменения, которые будут учтены во всех последующих изданиях настоящей публикации. IBM оставляет за собой право в любое время и без дополнительного уведомления исправлять и обновлять продукты и программы, упоминаемые в настоящей публикации.
Все встречающиеся в настоящей публикации ссылки на Web-сайты других компаний предоставлены исключительно для удобства пользователей и не являются рекламой этих Web-сайтов. Материалы, размещенные на этих Web-сайтах, не являются частью материалов для настоящего продукта IBM и ответственность за их применение лежит на пользователе.IBM может использовать или распространять предоставленную вами информацию любым способом, который она считает подходящим, не беря на себя никаких обязательств перед вами.
Обладателям лицензии на данную программу, желающим получить информацию о ней с целью обеспечения: (i) обмена информацией между независимо создаваемыми программами и прочими программами (включая настоящую) и (ii) совместного использования информации, полученной в результате обмена, следует обращаться по следующему адресу:
IBM CorporationВ некоторых случаях такая информация может быть предоставлена на особых условиях, в том числе - за дополнительную плату.
Лицензионная программа, описанная в этом документе, и все доступные для нее лицензионные материалы предоставляются фирмой IBM в соответствии с условиями Соглашения с заказчиком IBM, Лицензионного соглашения международной программы IBM и всех аналогичных соглашений между нами.
Все содержащиеся здесь статистические данные были определены в управляемой среде. Поэтому, результаты, полученные в других операционных средах, могут значительно отличаться. Некоторые измерения могли быть проведены в системах уровня разработки, и нет гарантии, что эти измерения будут такими же в общедоступных системах. Кроме того, некоторые измерения были получены путем экстраполяции. Фактические результаты могут отличаться. Пользователи этого документа должны проверить применяемые данные в своей собственной среде.
Информация, относящаяся к продуктам других фирм, были получена от поставщиков этих продуктов, из опубликованных ими объявлений или из других общедоступных источников. IBM не выполняла тестирование этих продуктов и не может гарантировать точность каких-либо сведений о производительности, совместимости или о других параметрах продуктов других поставщиков. Вопросы о совместимости продуктов других поставщиков следует направлять поставщикам этих продуктов.
ЛИЦЕНЗИЯ АВТОРСКОГО ПРАВА:Эта информация содержит примеры приложений на исходном языке, которые иллюстрируют приемы программирования на различных платформах. Вы можете копировать, изменять и распространять эти примеры программ любым способом, не платя IBM, в целях разработки, использования и продвижения на рынке приложений, соответствующих программному интерфейсу приложений для операционных платформ, для которых написаны эти примеры. Эти примеры не были полностью протестированы для всех условий. Поэтому, IBM не гарантирует и не подразумевает надежность, удобство обслуживания и функциональность этих программ.
Каждая копия или любая часть этих примеров программ или любая производная работа должны содержать следующее указание на авторские права:(C) (имя вашей компании) (год). Часть этого исходного кода произведена от IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2006. Все права защищены.
При просмотре электронной копии этой информации, фотографии и цветные иллюстрации могут отсутствовать.
Информация о программном интерфейсе предназначена для помощи в создании программного обеспечения, использующего эту программу.
Программный интерфейс общего назначения позволяет создавать программное обеспечение приложения, которое использует средства этой программы.
Однако, эта информация может также содержать сведения о диагностике, модификации и настройке. Информация о диагностике, модификации и настройке предоставляется для помощи в отладке программного обеспечения приложения.
Предупреждение: Не используйте эту информацию о диагностике, модификации и настройке в качестве программного интерфейса, потому что она может меняться.
Java и все товарные знаки, основанные на Java, являются товарными знаками фирмы Sun Microsystems, Inc. в США и других странах.
Microsoft, Windows, Windows NT и логотип Windows являются товарными знаками фирмы Microsoft Corporation в США и других странах.
Intel, Intel Xeon и Pentium являются товарными знаками или зарегистрированными товарными знаками фирмы Intel Corporation или ее дочерних фирм в США и других странах.
UNIX является зарегистрированным товарным знаком The Open Group в США и других странах.
Linux является зарегистрированным товарным знаком Линуса Торвальдса в США и других странах.
Другие кампании, продукты и сервисные знаки могут быть товарными или сервисными знаками других компаний.
(C) Copyright IBM Corporation 2000, 2006. Все права защищены.