IKuznetsov: /* Связать заглушку */

2025-07-09T16:02:21Z

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

IKuznetsov: Новая страница: «== Настройка мониторинга CICS и IMS == Определите дополнительные параметры мониторинга для т...»

2025-07-08T08:33:44Z

Новая страница: «== Настройка мониторинга CICS и IMS == Определите дополнительные параметры мониторинга для т...»

Новая страница

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

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

=== Мониторинг транзакций ===
Определите дополнительные параметры мониторинга для транзакций '''CICS''' и '''IMS'''.
{| class="wikitable"
!Параметр
!Описание
|-
|Мониторинг всех входящих веб-запросов
|Ключ-АСТРОМ автоматически отслеживает входящие веб-запросы, когда они вызываются отслеживаемыми службами. Включите этот параметр, чтобы отслеживать все входящие веб-запросы независимо от того, вызываются ли они отслеживаемыми или неотслеживаемыми службами.

Мы рекомендуем включать его только на короткий период времени.
|-
|Группировать регионы 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, которое является значением по умолчанию. Увеличение ограничения по умолчанию может привести к увеличению расходов на обработку дополнительных данных.

Значение <code>0</code> означает неограниченное количество узлов.
|}

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

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

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

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

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

Этот показатель игнорирует транзакции, которые захватываются другим параметром в начале транзакции ('''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'''. Вы можете использовать подстановочный знак звездочки (<code>*</code>). Например, используйте <code>TN*</code> для отслеживания всех идентификаторов транзакций, начинающихся с <code>TN</code>, или используйте <code>*</code> для отслеживания всех транзакций, начинающихся на терминале.

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

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

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

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

=== Фильтры IBM MQ ===
Ключ-АСТРОМ отслеживает транзакции '''CICS''' и '''IMS''', которые исходят из очередей '''IBM MQ'''. Чтобы ограничить трассировку определенными очередями, укажите их имена в списках включения. Чтобы исключить очереди из трассировки, укажите их имена в списках исключения. Для '''IMS''' эти списки применяются к областям обработки сообщений.
{| class="wikitable"
!Параметр
!Описание
|-
|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''' к шагу связывателя, чтобы включить его в свою программу. Например:
{| class="wikitable"
|//SZDTLOAD DD DISP=SHR,DSN=_hlq_.SZDTLOAD

...

INCLUDE SZDTLOAD(DTSTUB)
|}

Операции ЕдиногоАгента на Z/OS - История изменений

IKuznetsov: /* Связать заглушку */

IKuznetsov: Новая страница: «== Настройка мониторинга CICS и IMS == Определите дополнительные параметры мониторинга для т...»