Операции ЕдиногоАгента на Z/OS

Настройка мониторинга CICS и IMS

Определите дополнительные параметры мониторинга для транзакций CICS и IMS. Перейдите в Настройки > Мейнфрейм , чтобы найти следующие параметры меню:

• Мониторинг транзакций
• Фильтры начала транзакции
• Фильтры IBM MQ

Мониторинг транзакций

Определите дополнительные параметры мониторинга для транзакций CICS и IMS.

Параметр	Описание
Мониторинг всех входящих веб-запросов	Ключ-АСТРОМ автоматически отслеживает входящие веб-запросы, когда они вызываются отслеживаемыми службами. Включите этот параметр, чтобы отслеживать все входящие веб-запросы независимо от того, вызываются ли они отслеживаемыми или неотслеживаемыми службами. Мы рекомендуем включать его только на короткий период времени.
Группировать регионы CICS, принадлежащие одному и тому же CICSPlex	Включите этот параметр, чтобы сгруппировать регионы CICS, принадлежащие одному CICSPlex, в одну группу процессов. Если отключено, группа процессов создается для каждого региона CICS. Вы можете указать региону CICS дождаться, пока CICSPlex станет доступным, прежде чем продолжить. Этот параметр включен по умолчанию.
Создание сервисов CICS на основе идентификаторов транзакций	Включите этот параметр, чтобы создать службу CICS для каждого отслеживаемого идентификатора транзакции в группе процессов. Если отключено, служба CICS будет создана для каждого отслеживаемого региона CICS в группе процессов. Этот параметр включен по умолчанию. Мы рекомендуем включать его только тогда, когда регионы CICS сгруппированы по их CICSPlex.
Группировка регионов IMS, принадлежащих одной подсистеме	Включите этот параметр, чтобы сгруппировать регионы IMS, принадлежащие одной подсистеме, в одну группу процессов. Если отключено, группа процессов будет создана для каждого региона IMS. Этот параметр включен по умолчанию.
Создание сервисов IMS на основе идентификаторов транзакций	Включите этот параметр, чтобы создать службу IMS для каждого отслеживаемого идентификатора транзакции в группе процессов. Если отключено, служба IMS будет создана для каждого отслеживаемого региона IMS в группе процессов. Эта настройка включена по умолчанию. Мы рекомендуем включать ее только тогда, когда регионы IMS сгруппированы по их подсистемам.
Лимит распределенного узла трассировки PurePath	Максимальное количество узлов в распределенной трассировке, которая будет захвачена для одного вызова программы CICS или IMS. Мы рекомендуем ограничение в 500, которое является значением по умолчанию. Увеличение ограничения по умолчанию может привести к увеличению расходов на обработку дополнительных данных. Значение 0 означает неограниченное количество узлов.

Фильтры начала транзакции

Ключ-АСТРОМ отслеживает транзакции CICS и IMS, когда они вызываются отслеживаемыми службами. Ключ-АСТРОМ также отслеживает транзакции, когда они запускаются через поддерживаемый протокол CICS Transaction Gateway, z/OS Connect Enterprise Edition или IBM MQ (если они не ограничены фильтрами IBM MQ).

Транзакции, которые запускаются на мэйнфрейме или на терминале (например, терминале с зеленым экраном IBM 3270) или вызываются неконтролируемыми службами, должны быть явно перечислены для возможности отслеживания.

Фильтр запуска транзакции терминала CICS

Чтобы отследить транзакции CICS, начинающиеся на терминале (например, терминале с зеленым экраном IBM 3270), добавьте их идентификаторы транзакций в фильтр начала транзакций терминала CICS. Вы можете использовать подстановочный знак звездочки (*). Например, используйте TN* для отслеживания всех идентификаторов транзакций, начинающихся с TN, или используйте * для отслеживания всех транзакций, начинающихся на терминале.

Активируйте необходимую функцию ЕдиногоАгента z/OS CICS Terminal Transaction Sensor.

Фильтр начала транзакции CICS

Чтобы отслеживать транзакции CICS, которые начинаются на мэйнфрейме или вызываются неконтролируемыми службами, добавьте их идентификаторы транзакций в фильтр начала транзакций CICS. Вы можете использовать в качестве суффикса подстановочный знак звездочки (*). Например, используйте TN* для отслеживания всех идентификаторов транзакций, которые начинаются с TN.

Этот показатель игнорирует транзакции, которые захватываются другим параметром в начале транзакции (CICS Transaction Gateway и z/OS Connect Enterprise Edition, а также запросы на начало транзакции и DPL от других транзакций CICS). Он мешает транзакциям, которые распознаются позже в цепочке, поэтому, если перечисленная транзакция вызывается через IBM MQ, SOAP, JSON, HTTP или CICS/IMS SDK, для этой транзакции начнется новая трассировка, и она не будет связана с предыдущей трассировкой.

Если у вас есть какие-либо перечисленные здесь идентификаторы транзакций, принадлежащие терминалу (например, терминалу с зеленым экраном IBM 3270), мы рекомендуем вам переместить их в список фильтров запуска транзакций терминала CICS .

Фильтр запуска транзакции терминала IMS

Чтобы отследить транзакции IMS, начинающиеся на терминале (например, терминале с зеленым экраном IBM 3270), добавьте их идентификаторы транзакций в фильтр начала транзакций терминала IMS. Вы можете использовать подстановочный знак звездочки (*). Например, используйте TN* для отслеживания всех идентификаторов транзакций, начинающихся с TN, или используйте * для отслеживания всех транзакций, начинающихся на терминале.

Для отслеживания таких транзакций необходимо включить функцию ЕдиногоАгента показатель транзакций терминала z/OS IMS.

Фильтр начала транзакции IMS

Для отслеживания транзакций IMS, которые начинаются на мэйнфрейме или вызываются неконтролируемыми службами, добавьте их идентификаторы транзакций в фильтр начала транзакций IMS. Вы можете использовать в качестве суффикса подстановочный знак звездочки (*). Например, используйте TN* для отслеживания всех идентификаторов транзакций, которые начинаются с TN.

В отличие от показателя начала транзакции CICS, показатель начала транзакции IMS не будет мешать трассировке, полученной от другого датчика (MQ, SOAP, ITRA, IMS Connect и zOS Connect).

Если здесь перечислены какие-либо идентификаторы транзакций, принадлежащие терминалу (например, терминалу с зеленым экраном IBM 3270), переместите их в список фильтров запуска транзакций терминала IMS.

Фильтры IBM MQ

Ключ-АСТРОМ отслеживает транзакции CICS и IMS, которые исходят из очередей IBM MQ. Чтобы ограничить трассировку определенными очередями, укажите их имена в списках включения. Чтобы исключить очереди из трассировки, укажите их имена в списках исключения. Для IMS эти списки применяются к областям обработки сообщений.

Параметр	Описание
CICS: Included MQ queues	Список имен очередей MQ, связанных с CICS, которые могут запустить трассировку.
CICS: Excluded MQ queues	Список имен очередей MQ, связанных с CICS, которые не должны запускать трассировку.
IMS: Included MQ queues	Список имен очередей MQ, связанных с областью обработки сообщений IMS, которые могут запустить трассировку.
IMS: Excluded MQ queues	Список имен очередей MQ, связанных с областью обработки сообщений IMS, которые не должны запускать трассировку.
IMS bridge: Included transaction IDs	Чтобы отслеживать только определенные транзакции, отправленные через мост IMS, укажите их идентификаторы транзакций в списке включения.
IMS bridge: Excluded transaction IDs	Чтобы исключить из отслеживания определенные транзакции, отправленные через мост IMS, укажите их идентификаторы транзакций в списке исключений.

Используйте CICS и IMS SDK для индивидуальной трассировки

CICS и IMS SDK поддерживают распределенную трассировку, ориентированную на конкретного клиента, которая использует либо стандартные теги Ключ-АСТРОМ, либо предоставленные клиентом пользовательские теги.

• Является частью модулей CICS и IMS.
• Дополнительная лицензия не требуется.
• Поддерживает все распространённые языки z/OS.

CICS и IMS SDK также предоставляют API, которые позволяют добавлять узлы к существующей распределенной трассировке PurePath и связывать с ними аргументы и возвращать значения. Каждый API возвращает 0 для указания на успех или другое целочисленное значение, положительное или отрицательное, для указания на неудачу. См. список кодов возврата ниже.

Связать заглушку

DTSTUB обеспечивает доступ к функциям SDK. Добавьте оператор DD и INCLUDE к шагу связывателя, чтобы включить его в свою программу. Например:

//SZDTLOAD  DD  DISP=SHR,DSN=_hlq_.SZDTLOAD ...   INCLUDE SZDTLOAD(DTSTUB)