Просмотр кода страницы Установка ЕдиногоАгента на Z/OS

== Установка модуля zRemote ==
Модуль '''zRemote''' обрабатывает данные мониторинга, полученные от '''zLocal''', и направляет эти данные, сжатые и зашифрованные, через свой локальный АктивныйШлюз в Ключ-АСТРОМ. Таким образом, модуль '''zRemote''' выгружает большую часть работы по обработке из модулей кода '''CICS''', '''IMS''' и '''z/OS''' '''Java''', выполняемой в подсистемах и приложениях инструментирования, в открытую систему.

Вы можете настроить модуль '''zRemote''', чтобы включить дополнительные функции, такие как группы хостов и выборку операторов '''SQL Db2''' .

=== Требования к оборудованию ===
Требования к оборудованию машины, на которой работает модуль '''zRemote''', зависят от ожидаемого количества транзакций '''CICS''' и '''IMS''', которые необходимо отслеживать в секунду. См. '''требования к оборудованию для машин с архитектурой x86-64 и s390''' (ниже).

* Для сред разработки '''CICS''' и '''IMS''': машина небольшого или среднего размера.
* Для производственных сред '''CICS''' и '''IMS''': большая или очень большая машина.
* Для сред '''z/OS Java''': машина небольшого или среднего размера.

{| class="wikitable"
!Требования к оборудованию
!Маленький (DEV)
!Средний (DEV)
!Большой (PROD)
!Очень большой (PROD)
|-
|Ожидаемое количество отслеживаемых транзакций CICS/IMS в секунду
|4000
|7500
|15000
|30000
|-
|Требуемые ядра ЦП на архитектуре x86-64 (серия Xeon E5-2600)
|2
|4
|8
|16
|-
|Требуемые [https://www.ibm.com/products/integrated-facility-for-linux процессоры IFL] на архитектуре s390
|1
|1
|1
|2
|-
|Требуемая память
|4ГБ
|6ГБ
|8ГБ
|16 ГБ
|-
|Необходимое дисковое пространство
|20ГБ
|20ГБ
|20ГБ
|20ГБ
|}

* Требования к оборудованию указаны для случая, когда модуль '''zRemote''' и его АктивныйШлюз используются только для мониторинга мэйнфрейма.
* К одному '''zRemote''' можно подключить несколько подсистем '''zDC''' , если количество отслеживаемых транзакций соответствует требованиям к оборудованию.

=== Системные требования ===
Мы рекомендуем установить модуль '''zRemote''' на мэйнфрейм '''IBM Z''' или '''LinuxONE''', на поддерживаемой операционной системе '''Linux''' для '''s390'''. Применяются следующие системные требования:

* Подсистема '''zDC''' и модуль '''zRemote''', к которому она подключается, должны располагаться в одном центре обработки данных, чтобы избежать проблем с производительностью и безопасностью.
** '''zRemote''' запишет предупреждение в свои логи после задержки соединения в 3 секунды.
** '''zRemote''' разорвет соединение после задержки соединения в 10 секунд.
* '''zRemote''' поддерживает только установку АктивногоШлюза на основе хоста, настроенную для одной среды.
* Мониторинг хоста, на котором запущен '''zRemote''' с ЕдинымАгентом, поддерживается только в режиме мониторинга полного стека.

==== Поддерживаемые операционные системы ====
Вы можете установить модуль zRemote в любой из перечисленных ниже операционных систем Linux и Windows.
{| class="wikitable"
!Дистрибутив
!Версии
!Архитектура ЦП
|-
|Oracle Linux
|8.10, 9.5
|ARM64 (AArch64), x86-64
|-
|Red Hat Enterprise Linux
|8.8, 8.10, 9.2, 9.4, 9.5
|s390, x86-64
|-
|Red Hat Enterprise Linux
|8.10, 9.4, 9.5
|ARM64 (AArch64)
|-
|Rocky Linux
|8.10, 9.5
|ARM64 (AArch64), x86-64
|-
|SUSE Enterprise Linux
|15.6
|ARM64 (AArch64), s390, x86-64
|-
|Ubuntu
|16.04, 18.04, 20.04, 22.04, 24.04
|x86-64
|-
|Ubuntu
|20.04, 22.04, 24.04
|ARM64 (AArch64), s390
|-
|Windows
|10, 11
|x86-64
|-
|Windows Server
|2016, 2019, 2022, 2025
|x86-64
|}

=== Обзор установщика ===
Обзор описывает ключевые компоненты приложения '''zRemote''', конфигурацию '''zRemote''' и их установочные директории по умолчанию. Непостоянные директории заменяются во время обновлений и удаления.

==== Директории приложений и установок zRemote ====
Linux - <code>/opt/Astromkey/zremote</code>

Windows - <code>C:/Program Files/Astromkey/zremote</code>

Все следующие директории не сохраняются в случае обновления или удаления '''zRemote'''. Если вы внесете изменения здесь, они будут перезаписаны или удалены.
{| class="wikitable"
!Директория
!Компонент
!Описание
|-
|<code>agent/lib64</code>
|noneagentz
|Двоичный файл zRemote
|-
|<code>agent/lib64</code>
|oneagentzwatchdog
|Двоичный файл, который обеспечивает возможности сервиса zRemote и управляет ограничениями ресурсов.
|-
|<code>agent/lib64</code>
|oneagentdumpproc
|Двоичный файл, поддерживающий создание дампов при сбое основного приложения.
|-
|<code>agent/lib64/zos-s390-64/<version></code>
|dtzagent
|Двоичный файл, развернутый в UNIX-части мэйнфрейма для поддержки коммуникаций OneAget. Для получения более подробной информации см. Установка подсистемы zDC
|-
|<code>agent/lib64/zos-s390-64/<version></code>
|libdtzagent.so
|Двоичный файл, развернутый в UNIX-части мэйнфрейма для поддержки агентских коммуникаций. Для получения более подробной информации см. Установка подсистемы zDC
|-
|<code>agent/conf</code>
|ruxitagent.conf
|Файл конфигурации zRemote по умолчанию
|-
|<code>agent/conf</code>
|oneagentzwatchdog.ini
|Файл конфигурации сторожевого таймера по умолчанию
|-
|<code>agent/conf</code>
|.pem
|Сертификаты приложений
|-
|<code>agent</code>
|installer.version
|Установочная версия двоичного файла zRemote, которая обычно совпадает с версией zRemote
|-
|<code>agent</code>
|zremote
|<code>только для Linux</code> Скрипт сервиса для запуска приложения zRemote
|-
|
|uninstallation.sh
|<code>только для Linux</code> Скрипт службы для удаления приложения zRemote.

Он удаляет все, кроме постоянной конфигурации пользователя и файлов журналов.
|}

==== Конфигурация и директории установки zRemote ====
Linux - <code>/var/lib/Astromkey/zremote</code>

Windows - <code>C:/Program Files/Astromkey/zremote</code>

Все следующие директории не сохраняются в случае обновления или удаления '''zRemote'''. Если вы внесете изменения здесь, они будут перезаписаны или удалены.
{| class="wikitable"
!Директория
!Компонент
!Описание
|-
|<code>agent</code>
|runtime
|Содержит сведения о подключении, указанные в вашей среде Ключ-АСТРОМ.
|-
|<code>config</code>
|instance.properties
|Содержит идентификатор текущего зарегистрированного экземпляра.
|-
|<code>config</code>
|version.properties
|Содержит полный номер версии модуля zRemote.
|-
|
|state
|Содержит адрес последнего успешного подключения к серверу для указания правильно установленного соединения.
|}
Следующие директории сохраняются в случае обновления или удаления. Вы можете внести изменения здесь. Для получения более подробной информации см. раздел '''Настройка модуля zRemote''' (ниже).
{| class="wikitable"
!Директория
!Компонент
!Описание
|-
|<code>agent/conf</code>
|zremoteagentuserconfig.conf
|Файл конфигурации для настройки модуля zRemote
|-
|<code>agent/conf</code>
|watchdoguserconfig.conf
|Файл конфигурации для настройки watchdog таймера
|}

=== Установка ===
Модуль '''zRemote''' загружается и устанавливается автоматически во время процедуры установки АктивногоШлюза в '''Linux''' или '''Windows'''.

# Войдите в Ключ-АСТРОМ. Выберите '''АктивныйШлюз > Настроить'''.
# На странице '''Установка среды АктивногоШлюза''' выберите '''Linux''' или '''Windows'''.
# <code>только для Linux</code> Выберите тип установщика '''s390''' (рекомендуется) или '''x86/64'''.
# Выберите цель '''Установить модуль zRemote для мониторинга z/OS''' , загрузите установщик и запустите процедуру установки.
# '''необязательный''' Настройте выбор порта.  По умолчанию модуль '''zRemote''' проверяет порт '''8898''' на предмет подключений от '''zLocal''', работающего как часть '''zDC'''. Чтобы проверить другой порт, задайте параметру <code>zdclistenerport</code> ваш порт в файле <code>zremoteagentuserconfig.conf</code>. Убедитесь, что этот порт не заблокирован брандмауэром.

Подробную информацию о параметрах установки по умолчанию см. в разделе Параметры установки АктивногоШлюза по умолчанию для [[Установка АктивногоШлюза на Linux|Linux]] или [[Установка АктивногоШлюза на Windows|Windows]].

Подробную информацию о настройке установки см. в разделе Настройка установки АктивногоШлюза в [[Установка АктивногоШлюза на Linux|Linux]] или [[Установка АктивногоШлюза на Windows|Windows]].

=== Ведение логов ===
Логи '''zRemote''' создаются на машине, где установлен модуль '''zRemote''', в директориях по умолчанию для '''Linux''' и '''Windows'''. Вы можете просматривать логи '''zRemote''' либо непосредственно на машине, на которой размещен '''zRemote''', либо запросив их из Ключ-АСТРОМ через рабочий процесс диагностики ЕдиногоАгента.

Фактический лог '''zRemote''' должен содержать следующие сообщения:

* Регистрация сообщений, отправляемых всеми модулями кода '''CICS/IMS''' и '''zDC'''.
* Регистрация сообщений, отправляемых из '''zLocal'''.

=== Обновление и обслуживание ===
Чтобы оставаться в курсе событий, вы можете автоматически обновить модуль '''zRemote''' до более новой версии, используя процедуру автоматического обновления АктивногоШлюза.

Чтобы вручную обновить модуль '''zRemote'''

==== Для Linux ====
Для выполнения этих команд вам потребуются права '''root'''.

Чтобы запросить текущий статус модуля '''zRemote''':
{| class="wikitable"
|service zremote status
|}
Чтобы остановить, запустить или перезапустить модуль '''zRemote''':
{| class="wikitable"
|<nowiki>service zremote stop|start|restart|forcestop</nowiki>
|}
Разница между <code>stop</code> и <code>forcestop</code> заключается в том, что команда <code>stop</code> позволяет выполнить процедуру контролируемого завершения работы, а команда <code>forcestop</code> принудительно завершает работу процесса.

==== Для Windows ====
Для выполнения этих команд вам потребуются права администратора.

В '''Windows''' модуль '''zRemote''' можно обслуживать с помощью вкладки '''Службы''' диспетчера задач '''Windows'''. Вы также можете использовать следующую команду:
{| class="wikitable"
|<nowiki>sc stop|start|restart "Astromkey zRemote"</nowiki>
|}
Команда <code>sc</code> асинхронная, поэтому вам необходимо запросить состояние службы, чтобы определить, когда она полностью остановилась:
{| class="wikitable"
|sc query "Astromkey zRemote"
|}

== Настройка модуля zRemote ==
Вы можете настроить модуль '''zRemote''', чтобы включить дополнительные функции и оптимизировать его производительность.

=== Файлы конфигурации пользователя ===
Следующие файлы конфигурации сохраняются в случае обновления или удаления '''zRemote'''. Вы можете внести изменения здесь.

Для применения новых настроек необходимо перезапустить службу '''zRemote'''.

==== Конфигурация пользователя модуля zRemote ====
Файл конфигурации пользователя модуля '''zRemote''' (<code>zremoteagentuserconfig.conf</code>) позволяет переопределить конфигурацию по умолчанию, определенную в <code>ruxitagent.conf</code>.

===== Для Linux =====
<code>/var/lib/Astromkey/zremote/agent/conf/zremoteagentuserconfig.conf</code>

===== Для Windows =====
<code>C:/ProgramData/Astromkey/zremote/agent/conf/zremoteagentuserconfig.conf</code>

==== Конфигурация пользователя Watchdog ====
'''Ключ-АСТРОМ версии 1.277+'''

Файл конфигурации пользователя '''watchdog''' (<code>watchdoguserconfig.conf</code>) позволяет переопределить конфигурацию по умолчанию, определенную в <code>oneagentzwatchdog.ini</code>.

===== Для Linux =====
<code>/var/lib/Astromkey/zremote/agent/conf/watchdoguserconfig.conf</code>

===== Для Windows =====
<code>C:/ProgramData/Astromkey/zremote/agent/conf/watchdoguserconfig.conf</code>

Доступные параметры для настройки:
{| class="wikitable"
!Параметр
!Единица измерения
!Значение по умолчанию
!Описание
|-
|<nowiki>-healthcheck.heartbeat.timeout</nowiki>
|Секунды
|900
|Время ожидания соединения между службой zRemote и вашей средой Ключ-АСТРОМ
|-
|<nowiki>-healthcheck.memory.limit_absolute</nowiki>
|МБ
|500
|Абсолютный ввод для лимита вычислений памяти дочернего процесса
|-
|<nowiki>-healthcheck.memory.limit_percentage</nowiki>
|%
|20
|Процентный ввод для лимита вычисления памяти дочернего процесса
|}
Расчет эффективного лимита памяти

Эффективный лимит = процентный лимит × доступная физическая память в системе + абсолютный лимит

'''Например:'''

0,2 × 5 ГБ + 500 МБ = 1,5 ГБ эффективного лимита памяти

=== Организация LPAR по группам хостов ===
Группы хостов полезны, когда вы хотите организовать несколько '''LPAR''', подключенных к одному модулю '''zRemote'''. '''LPAR''' можно назначить группе хостов, установив атрибут <code>[HostGroup]</code> в файле <code>zremoteagentuserconfig.conf</code>. '''LPAR''' может принадлежать только одной группе хостов.

Чтобы назначить '''LPAR''' группе хостов, укажите имя группы между парой атрибутов <code>[HostGroup]</code>. Пара атрибутов <code>[HostGroup]</code> может находиться в любом месте файла <code>zremoteagentuserconfig.conf</code>.
{| class="wikitable"
|[HostGroup]

<LPAR_Name1>=<HostGroupName>

<LPAR_Name2>=<HostGroupName>

[HostGroup]
|}
Имя '''LPAR''' — это 8-символьное имя логического раздела, определенное <code>LPARNAME()</code> в параметре <code>IEASYMxx</code> member в z/OS.
{| class="wikitable"
|Имя LPAR также отображается в разделе на экране хоста <code>Properties and tags</code>.
|}
К строке <code><HostGroupName></code> предъявляются следующие требования :

* Может содержать только буквенно-цифровые символы, дефисы (<code>-</code>), подчеркивания (<code>_</code>) и точки (<code>.</code>)
* Не должно начинаться с <code>dt.</code>
* Максимальная длина — 100 символов.

==== Объединение трех LPAR в одну группу хостов ====
В этом примере мы добавляем три '''LPAR''' — <code>LPARA</code>, <code>LPARB</code>, и <code>LPARC</code> в одну группу хостов <code>TEST_HOST</code>.
{| class="wikitable"
|[HostGroup]

LPARA=TEST_HOST

LPARB=TEST_HOST

LPARC=TEST_HOST

[HostGroup]
|}

==== Назначение трех LPAR разным группам хостов ====
В этом примере мы назначаем каждый '''LPAR''' отдельной группе хостов.
{| class="wikitable"
|[HostGroup]

LPARA=TEST_HOST

LPARB=PROD_HOST

LPARC=PERF_HOST

[HostGroup]
|}

* В настройках хоста для группы хостов '''z/OS''' применимы только меню '''Общие''' , '''Мониторинг''' и '''Обнаруженные процессы'''.
* Сохраняйте настройки группы хостов только в файле <code>zremoteagentuserconfig.conf</code> и переносите настройки группы хостов из файла <code>ruxitagent.conf</code>.
* Настройки группы хостов вступают в силу во время запуска '''zRemote'''. После определения группы хостов в файле необходимо перезапустить модуль '''zRemote''' <code>zremoteagentuserconfig.conf</code>.

=== Извлечение полных SQL-выражений из баз данных Db2 ===
Ключ-АСТРОМ может предоставить информацию об операторах '''SQL''' на основе трассировки вызовов баз данных '''Db2''' и '''DL/I'''. Эти операторы '''SQL''' отображаются в Ключ-АСТРОМ, например, как:

* FETCH (PROGNAME;165;3)
* CLOSE (PROGNAME;441;2)

Строка представляет собой имя программы (имя '''DBRM'''), номер строки и номер раздела.

'''Модуль zRemote версии 1.241+''' Ключ-АСТРОМ может обеспечить более глубокое понимание вызовов базы данных '''Db2''', извлекая полные операторы '''SQL''' из директории '''Db2'''. При включенной функции извлечения операторов '''SQL''' операторы '''SQL''' отображаются в Ключ-АСТРОМ, например, как:

* FETCH (GETTAB INTO : H , : H , : H , : H , : H)
* CLOSE (GETTAB)

==== Включение выборки SQL-выражений ====
Функция выборки SQL-выражений по умолчанию отключена. Чтобы включить ее

1. Установите и настройте '''IBM Data Server Driver''' для программного обеспечения '''ODBC''' и '''CLI''' на [https://www.ibm.com/docs/en/db2/11.5.x?topic=dsd-installing-data-server-driver-odbc-cli-software-linux-unix-operating-systems Linux] или [https://www.ibm.com/docs/en/db2/11.5.x?topic=dsd-installing-data-server-driver-odbc-cli-software-windows-operating-systems Windows] . 

Дополнительные материалы: [https://www.ibm.com/support/pages/db2-odbc-cli-driver-download-and-installation-information Информация о загрузке и установке драйвера IBM Db2 ODBC CLI].

На этапе установки обратите внимание на расположение библиотеки драйвера '''CLI''':

* <code>libdb2.so</code> для '''Linux'''
* <code>db2app64.dll</code> для '''Windows'''

Перед настройкой драйвера может потребоваться обратиться к администратору базы данных с запросом информации о подключении к базе данных (такой как учетные данные базы данных, местоположение, IP и порт). На этапе настройки обратите внимание на псевдонимы '''Db2''' (или '''DSN''').

Оба эти условия потребуются на следующих этапах.
{| class="wikitable"
|
* Модуль '''zRemote''' поддерживает только 64-битный драйвер '''CLI'''.
* Мы настоятельно рекомендуем вам установить тайм-аут соединения для каждого '''BD''', например, <code>ConnectTimeout=2</code> на две секунды в <code>db2cli.ini</code> на '''Linux'''.
* Обязательно протестируйте конфигурацию драйвера '''CLI''', чтобы обеспечить хорошее соединение с '''DB2''', например:

{| class="wikitable"
|\<cli-driver-path\>/bin/db2cli validate -connect -database \<db-location\>:\<ip\>:\<port\> -user \<id\> -passwd \<pw\>

\<cli-driver-path\>/bin/db2cli validate -connect -dsn \<db-alias\>
|}

* Для настройки драйвера '''CLI''' вам потребуются учетные данные '''Db2''', которые предоставляют доступ к соединениям '''Db2''' (из распределенных с использованием '''DDF/DRDA''') и права выбора в <code>CATALOG</code>, в частности в <code>SYSPACKSTMT</code>.
|}
2. В файле модуля '''zRemote''' <code>zremoteagentuserconfig.conf</code> определите библиотеку драйвера '''CLI''' и группу псевдонимов '''Db2''' (аналогично определению групп хостов), например:
{| class="wikitable"
|# Linux

cli_driver_lib=/opt/IBM/CLIDRIVER/lib/libdb2.so

<nowiki>#</nowiki> ... or Windows

cli_driver_lib=C:/IBM/CLIDRIVER/bin/db2app64.dll

[DbAlias]

dbHost1.dbName1=alias1

dbHost2.dbName2=alias2

dbHostN.dbNameN=aliasN

[DbAlias]

<nowiki>#</nowiki> Beginning with zRemote 1.279 it is possible to set the new flag sqlStmtExtended, if

<nowiki>#</nowiki> true the full (fetched) SQL statement is appended with its old (unfetched) format,

<nowiki>#</nowiki> for example, from an example above "FETCH (GETTAB INTO : H , : H , : H , : H , : H)"

<nowiki>#</nowiki> would be shown as "FETCH (GETTAB INTO : H , : H , : H , : H , : H) (PROGNAME;165;3)".

<nowiki>#</nowiki> The default is false. Note: if enabled this setting would affect the aggregation count.

sqlStmtExtended=false
|}
где <code>dbHost</code>— идентификатор '''SMF z/OS''', а <code>dbName</code>— имя подсистемы '''Db2'''. Все регистрозависимо.

3. '''необязательно''' Определите <code>sqlStmtCacheFileName=/tmp/sqlStmtCacheFileName</code>, например, для кэширования извлеченных '''SQL'''-выражений в файл и использования его при перезапуске модуля '''zRemote''', тем самым уменьшая взаимодействие с '''Db2'''. Обязательно используйте соответствующее полное имя файла.

4. Перезапустите модуль '''zRemote'''.
{| class="wikitable"
|
* Модуль '''zRemote''' включит функцию выборки '''SQL'''-операторов только в том случае, если драйвер '''CLI''' может быть успешно загружен и определен хотя бы один псевдоним '''DB2'''.
* Если впоследствии выяснится, что псевдоним '''Db2''' недействителен, функция будет отключена.
|}

=== Включение безопасного соединение zLocal-zRemote ===
'''Модуль zRemote версии 1.267+'''

По умолчанию '''zLocal''' и '''zRemote''' используют фирменный протокол связи через простые сокеты. Вы можете настроить их для связи через '''TLS''', настроив '''AT-TLS''' для '''zLocal''' и установив флаги '''SSL''' для '''zRemote''', как показано ниже.

==== Конфигурация AT-TLS для zLocal ====
В зависимости от ваших требований существуют различные способы настройки '''AT-TLS''' для '''zLocal'''. Более подробную информацию см. в разделе [https://www.ibm.com/docs/en/zos/2.5.0?topic=applications-application-transparent-transport-layer-security-data-protection Application Transparent Transport Layer Security data protection] в документации '''IBM'''. Вы можете использовать пример конфигурации '''AT-TLS''' ниже в качестве шаблона.

===== Пример конфигурации AT-TLS =====
{| class="wikitable"
|TTLSRule                       <client-rule>

{

    RemoteAddr                 <ALL | specific-ip-addr>

    RemotePortRange            <zdclistenerport>

    Direction                  Outbound

    TTLSGroupActionRef         <group-action>

    TTLSEnvironmentActionRef   <environment-action>

    TTLSConnectionActionRef    <connection-action>

}

TTLSGroupAction                <group-action>

{

    TTLSEnabled                On

   Trace                       <trace-level>

}

TTLSEnvironmentAction          <environment-action>

{

    HandshakeRole              Client

    TTLSKeyringParmsRef        <keyring-parms>

    TTLSCipherParmsRef         <cipher-parms>

}

TTLSKeyringParms               <keyring-parms>

{

<nowiki>#</nowiki>   A certificate matches that of the zRemote's certificate

<nowiki>#</nowiki>   must be loaded into RACF and connected to the Keyring here.

    Keyring                    <pub-key-or-certificate>

}

TTLSCipherParms                <cipher-parms>

{

    ...

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    V3CipherSuites             TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    ...

}

TTLSConnectionAction           <connection-action>

{

    TTLSConnectionAdvancedParmsRef  <connection-advanced-parms>

}

TTLSConnectionAdvancedParms    <connection-advanced-parms>

{

    SSLv2                      Off

    SSLv3                      Off

    TLSv1                      Off

    TLSv1.1                    Off

    TLSv1.2                    On

    TLSv1.3                    On

}
|}
Убедитесь, что '''userId''', используемый в '''zDC''', совпадает с тем, который в сертификате. В противном случае подключение к '''TSL''' не будет выполнено (с ошибкой '''SSL accept -1''' и кодом '''5''').

==== Настройки SSL/TLS для zRemote ====
Чтобы включить '''SSL/TLS''' для '''zRemote'''

# Откройте файл <code>zremoteagentuserconfig.conf</code>.
# Установите <code>sslEnabled</code> на <code>true</code>.
# Укажите абсолютные пути к файлам '''PEM''' вашего закрытого ключа (<code>sslPrivateKey</code>) и сертификата (<code>sslCertificate</code>).
# '''необязательный''' Определите конкретные наборы шифров '''TLS'''. Для получения информации о разрешенных именах наборов шифров и их строковом формате обратитесь к документации [https://docs.openssl.org/1.1.1/man1/ciphers/ OpenSSL].

===== Шаблон конфигурации =====
{| class="wikitable"
|# Must be true to enable secure connection; all other SSL settings are ignored if false

sslEnabled=true

<nowiki>#</nowiki> Absolute paths to your private key (with the pass-phrase stripped) and certificate PEM files.

<nowiki>#</nowiki> Beginning with zRemote module version 1.301.0, multiple private-key/certificate pairs delimited

<nowiki>#</nowiki> by a semicolon can be specified. For example:

<nowiki>#</nowiki> sslPrivateKey=<private-key-1.pem; private-key-2.pem; ...; private-key-n.pem>

<nowiki>#</nowiki> sslCertificate=<certificate-1.pem; certificate-2.pem; ...; certificate-n.pem>

sslPrivateKey=<private-key.pem>

sslCertificate=<certificate.pem>

<nowiki>#</nowiki> Optional: TLS cipher suites allowed according to OpenSSL

<nowiki>#</nowiki> Example: sslCiphers=ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384

sslCiphers=<cipher-suites>
|}

=== Игнорирование недействительных попыток подключения ===
Если определенный процесс регулярно пингует модуль '''zRemote''', чтобы определить его доступность, и эти пинги достигают порта '''zRemote''', модуль '''zRemote''' регистрирует недопустимую попытку подключения. Эти недопустимые попытки подключения со временем увеличивают размер логов '''zRemote'''.

Чтобы игнорировать попытки подключения от определенных процессов, перечислите их '''IP-адреса''' (через точку с запятой) в файле, например <code>zremoteagentuserconfig.conf</code>:
{| class="wikitable"
|ignoreHandshakeEndpoints=192.168.0.1;10.0.0.2
|}

=== Отказ от нового расчета идентификатора процесса IMS MPR ===
'''Модуль zRemote версии 1.253+'''

Идентификаторы процессов области обработки сообщений '''IMS''' ('''MPR''') могут измениться, что приведет к появлению новых процессов и объектов служб в Ключ-АСТРОМ. Чтобы предотвратить изменение идентификатора процесса, мы ввели более стабильный расчет идентификатора, в результате чего все процессы и объекты служб '''IMS MPR''' изменятся один раз, и затем останутся стабильными после обновления модуля '''zRemote''' до версии '''1.253'''.

Чтобы отказаться от расчета нового идентификатора процесса '''IMS MPR''', установите флаг <code>useOldImsPgiCalc</code> в файле <code>zremoteagentuserconfig.conf</code> на <code>true</code>.
{| class="wikitable"
|useOldImsPgiCalc=true
|}

== Установка z/OSMF workflow ==
Фреймворк '''z/OSMF''' — [https://www.ibm.com/products/zos/management-facility IBM z/OS Management Facility] — повышает производительность труда программистов систем '''z/OS''' за счет использования упрощенных, оптимизированных и автоматизированных рабочих процессов.

Вы можете установить Ключ-АСТРОМ Мониторинг на '''z/OS''' с помощью настраимовой установки '''z/OSMF''' workflow для модулей '''zDC''', '''CICS''' и '''IMS''', а затем использовать '''z/OSMF''' для поддержки Ключ-АСТРОМ Мониторинг.

=== Предустановка ===

* <code>z/OS версии 2.5+</code> с активным '''z/OSMF'''
* <code>zRemote версии 1.287+</code> установлен и подключен к вашей среде Ключ-АСТРОМ
* <code>zlocal версия 1.1+</code> установлен и подключен к '''zRemote'''

=== Загрузка файла ===
Файл определения '''z/OSMF''' workflow автоматически развертывается в вашей среде '''USS''' при загрузке '''zLocal'''. Убедитесь, что '''zRemote''' содержит файл определения '''z/OSMF''' workflow. Либо вы можете вручную скопировать его в '''USS'''.

Чтобы найти файл определения '''z/OSMF''' workflow, перейдите в следующую директорию '''zRemote''':

Linux - <code>/opt/Astromkey/zremote/agent/lib64/zos-installer/AstromkeyInstallWorkflow.xml</code>

Windows - <code>C:/Program Files/Astromkey/zremote/agent/lib64/zos-installer/AstromkeyInstallWorkflow.xml</code>

== Установка файла ==
Чтобы установить файл определения '''z/OSMF''' workflow

# Откройте '''Workflows''' и выберите '''Actions > Create Workflow'''.
# Укажите путь к файлу определения workflow и нажмите '''Далее'''.
# Определите идентификатор пользователя-владельца и систему, затем нажмите '''Готово'''.

Файл определения успешно загружен, когда в списке workflow отобразится workflow '''Установка Ключ-АСТРОМ Мониторинг'''.

== Запуск workflow ==
Подготовка установки '''z/OSMF''' workflow

# Выберите workflow '''Установка Ключ-АСТРОМ Мониторинг''' и активируйте интересующие вас шаги.
# Чтобы добавить исполнителей для всех активированных шагов, выберите '''Действия > Назначение и владение > Добавить исполнителей'''.
# Добавьте доступных исполнителей и нажмите '''ОК'''.
# Выберите '''Действия > Принять''' для назначенных вам шагов.

Установка workflow Ключ-АСТРОМ Мониторинг теперь готова. Следуйте шагам workflow, пока установка Ключ-АСТРОМ Мониторинг не будет завершена.

== Загрузка датасетов продуктов z/OS ==
Вы можете загрузить файл '''PAX''', содержащий модули '''CICS''', '''IMS''', '''z/OS Java''' и '''zDC''' двумя способами:

* <code>Ключ-АСТРОМ версии 1.272+</code> Загрузка через API развертывания.
* <code>Ключ-АСТРОМ версии 1.276+</code> Загрузка через веб-интерфейс.

{| class="wikitable"
|Начиная с версии <code>ЕдиногоАгента 1.275</code>, файл '''PAX''' больше не будет публиковаться на нашем '''FTP-сервере'''.
|}

=== Загрузка PAX-файла ===
Вы можете загрузить последнюю или конкретную версию файла '''PAX''' через веб-интерфейс или '''API''' развертывания ЕдиногоАгента.
{| class="wikitable"
|Версия файла '''PAX''' должна быть меньше или равна версии модуля '''zRemote'''.
|}

==== Загрузите последнюю версию через веб-интерфейс ====

# В меню Ключ-АСТРОМ перейдите в раздел '''Развертывание''' и выберите '''Начать установку'''.
# Выберите '''z/OS''' и загрузите наборы данных продуктов '''z/OS''', чтобы загрузить последнюю версию файла '''PAX'''.

Имя файла <code>Astromkey-zos-1.nnn.m.pax</code> включает основную <code>nnn</code> и <code>m</code> второстепенную версии релиза.

==== Загрузите определенную версию через веб-интерфейс ====
Вы можете загрузить определенную версию файла '''PAX''' через веб-интерфейс следующим образом:

# Перейдите в '''Настройки > Мониторинг > Обзор мониторинга'''.
# Выберите '''Скачать установщик ЕдиногоАгента или АктивногоШлюза''' и укажите предпочтительную версию:
## Установщик: <code>ЕдиныйАгент - z/OS</code>
## Сборка: выберите предпочтительную основную версию
## Ревизия: выберите предпочтительную второстепенную версию [[Файл:Image2001.png|граница|849x849пкс]]
# Выберите '''Продолжить''' и '''Загрузить наборы данных продуктов z/OS''', чтобы загрузить определенную вами версию файла '''PAX'''.  Имя файла <code>Astromkey-zos-1.nnn.m.pax</code>включает основную <code>nnn</code> и <code>m</code> второстепенную версии релиза.

=== Загрузите последнюю версию через API развертывания ===
Вы можете загрузить последнюю версию файла '''PAX''' через '''API''' развертывания следующим образом:

# Сгенерируйте токен доступа с помощью интеграции '''PaaS''' - загрузка установщика (<code>InstallerDownload</code>).
# Загрузите последнюю версию файла '''PAX''' через '''API''' развертывания — Загрузите последнюю версию ЕдиногоАгента :

{| class="wikitable"
!HTPP-метод
!Среда Ключ-АСТРОМ
!Конечная точка
|-
|GET
|SaaS
|<nowiki>https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/latest</nowiki>
|-
|GET
|Managed
|<nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/latest</nowiki>
|}
Ниже приведен пример <code>curl</code> команды для среды '''SaaS''', которая использует '''API''' развертывания для загрузки последней версии файла '''PAX''':
{| class="wikitable"
|curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/latest" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output Astromkey-zos.pax
|}
Замените <code><environment></code> на идентификатор вашей среды Ключ-АСТРОМ и сгенерированный вами токен доступа <code><accessToken></code>.

=== Загрузите определенную версию через API развертывания ===
Вы можете загрузить определенную версию файла '''PAX''' через '''API''' развертывания следующим образом:

1. Сгенерируйте токен доступа с помощью интеграции '''PaaS''' - загрузка установщика (<code>InstallerDownload</code>).

2. Список всех доступных версий '''PAX-файлов''' через '''API''' развертывания — список доступных версий ЕдиногоАгента.
{| class="wikitable"
!HTPP-метод
!Среда Ключ-АСТРОМ
!Конечная точка
|-
|GET
|SaaS
|<nowiki>https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/versions/zos/mainframe</nowiki>
|-
|GET
|Managed
|<nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/versions/zos/mainframe</nowiki>
|}
Ниже приведен пример <code>curl</code> команды для среды '''SaaS''', которая использует '''API''' развертывания для вывода списка всех доступных версий файла '''PAX''':
{| class="wikitable"
|curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/versions/zos/mainframe" -H "accept: */*" -H "Authorization: Api-Token <accessToken>"
|}
Замените <code><environment></code> на идентификатор вашей среды Ключ-АСТРОМ и сгенерированный вами токен доступа <code><accessToken></code>.

3. Загрузите определенную версию файла '''PAX''' через '''API''' развертывания — загрузите ЕдиныйАгент определенной версии :
{| class="wikitable"
!HTPP-метод
!Среда Ключ-АСТРОМ
!Конечная точка
|-
|GET
|SaaS
|<nowiki>https://{your-environment-id}.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/version/{version}</nowiki>
|-
|GET
|Managed
|<nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/deployment/installer/agent/zos/mainframe/version/{version}</nowiki>
|}
Ниже приведен пример <code>curl</code> команды для среды '''SaaS''', которая использует '''API''' развертывания для загрузки определенной версии файла '''PAX''':
{| class="wikitable"
|curl -X GET "https://<environment>.live.Astromkey.com/api/v1/deployment/installer/agent/zos/mainframe/version/<version>" -H "accept: */*" -H "Authorization: Api-Token <accessToken>" --output Astromkey-zos.pax
|}
Замените <code><environment></code> на идентификатор вашей среды Ключ-АСТРОМ, <code><version></code> на выбранную вами версию файла '''PAX''' и сгенерированный вами токен доступа <code><accessToken></code>.

=== Извлечение датасетов продукта ===
Вы можете извлечь наборы данных о продуктах из файла '''PAX''' следующим образом:

# Перенесите файл '''PAX''' в '''z/OS USS''' в двоичном режиме.
# Переименуйте файл '''PAX''' из <code>Astromkey-zos-1.nnn.m.pax</code> в <code>Astromkey-zos.pax</code>.
# Используйте <code>EXTRACT</code> ниже для извлечения датасетов продукта из установочных файлов. Перед запуском задания измените следующее:
## Определите желаемый высокоуровневый квалификатор для имен датасетов установки и задайте переменную <code>HLQ</code> соответствующим образом.
## Установите путь к директории '''z/OS USS''' <code>MYUSS</code>, куда вы поместили файл <code>Astromkey-zos.pax</code>. Если путь к директории превышает '''42''' символа, это может привести к ошибке в работе <code>STEP3</code>. В таком случае вам необходимо изменить '''JCL''', чтобы учесть символ продолжения.
## Измените серийный номер тома <code>VOLSER</code> в соответствии со стандартами сайта.

===== EXTRACT job =====
{| class="wikitable"
|//EXTRACT JOB ('ACCTINFO'),'User name or comment',NOTIFY=&SYSUID,

//             MSGLEVEL=(1,1),CLASS=A,MSGCLASS=X,REGION=0M,

//             COND=(0,NE)

//*

//* !!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

//*

//* When upgrading the zDC to version 1.213+ while

//* the CICS code module is enabled, it is important to follow

//* the below steps in the given sequence.

//*

//* 1. Stop the zDC

//* 2. Wait for 15 minutes for the CICS code module to

//*    reset/cleanup the control blocks

//* 3. Upgrade the zDC to newer version

//* 4. Start the zDC

//*

//* !!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

//*

//* This job extracts the product installation datasets from

//* the installation files at <MYUSS>/GIMZIP to

//* <hlq>.<rel>.SZDT* libraries.

//*

//* Change the JOB card and the SET statements below to meet              

//* site standards.

//*

//* Verify if the SMPCPATH and SMPJHOME DD below points to the

//* correct PATH to meet site standards.

//*

//* WARNING!

//* This JCL must be in mixed case and sequence numbers are not allowed

//*

// EXPORT SYMLIST=*

// SET HLQ='DT'             <== HLQ of the target PDS datasets

// SET REL='R12770'         <== Release number

// SET VOLSER='NSM001'      <== Volume of the target PDS datasets

// SET MYUSS='/u/dt'        <== USS work directory

//*

//*

//STEP1   EXEC PGM=IKJEFT01,DYNAMNBR=10

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH rm -Rf &MYUSS/GIMZIP

BPXBATCH SH cd &MYUSS &&  +

         pax -rvf Astromkey-zos.pax GIMZIP

//*

//*

//STEP2    EXEC PGM=GIMUNZIP,PARM='HASH=YES'

//SMPDIR   DD PATH='&MYUSS/GIMZIP/',PATHDISP=KEEP

//SMPCPATH DD PATH='/usr/lpp/smp/classes/',PATHDISP=KEEP

//SMPJHOME DD PATH='/usr/lpp/java/J8.0/',PATHDISP=KEEP

//SMPOUT   DD SYSOUT=*

//SYSPRINT DD SYSOUT=*

//SYSUT3   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))

//SYSUT4   DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))

//SYSIN    DD *,SYMBOLS=EXECSYS

<GIMUNZIP>

  <ARCHDEF archid="AUTHLIB"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTAUTH">

  </ARCHDEF>

  <ARCHDEF archid="LOAD"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTLOAD">

  </ARCHDEF>

  <ARCHDEF archid="SAMPLE"

           replace="YES"

           volume="&VOLSER"

           newname="&HLQ..&REL..SZDTSAMP">

  </ARCHDEF>

</GIMUNZIP>

/*

//*

//STEP3   EXEC PGM=IKJEFT01,DYNAMNBR=10

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH export ussdir=&MYUSS &&+

            cp ${ussdir}/GIMZIP/Astromkey-oneagent-zos-java.jar +

            ${ussdir}/Astromkey-oneagent-zos-java.jar

//*

//*

//STEP4   EXEC PGM=IKJEFT01,DYNAMNBR=55

//SYSPRINT DD SYSOUT=*

//SYSTSPRT DD SYSOUT=*

//STDOUT   DD SYSOUT=*

//STDERR   DD SYSOUT=*

//SYSIN    DD DUMMY

//SYSTSIN  DD *,SYMBOLS=EXECSYS

BPXBATCH SH rm -Rf &MYUSS/GIMZIP

//
|}
Если работа завершается с кодом возврата <code>0</code>, извлечение прошло успешно.

'''необязательный''' Удалите <code>Astromkey-zos.pax</code> и <code>Astromkey-oneagent-zos-java.jar</code> (если не нужно) и освободите место на диске.

==== Датасеты продуктов ====
В процессе извлечения создаются следующие датасеты продуктов (имена указаны для высокоуровневого квалификатора по умолчанию и версии выпуска <code>R1nnnx</code>):

* <code>DT.R1nnnx.SZDTAUTH</code>: Содержит подсистему '''zDC''' и модуль '''IMS''', включая '''IMS Connect'''
* <code>DT.R1nnnx.SZDTLOAD</code>: Содержит модуль '''CICS'''
* <code>DT.R1nnnx.SZDTSAMP</code>: Включает примеры определений '''JCL''' и '''CICS RDO'''

===== Использование дискового пространства датасетами продуктов =====
{| class="wikitable"
|Dsname                Tracks(3390) %Used

<nowiki>---------------------------------------</nowiki>

DT.R1nnnm.SZDTAUTH      893          5

DT.R1nnnm.SZDTLOAD       61         27

DT.R1nnnm.SZDTSAMP     1221         24
|}
{| class="wikitable"
|./GIMZIP/                      8K

./Astromkey-zos-1.nnn.m.pax    5M
|}

==== Определение псевдонимов ====
Мы рекомендуем определять <code>ALIAS</code> без номера версии для датасетов продукта. Используйте <code>ALIAS</code> в работах по внедрению модулей '''zDC''', '''CICS''' и '''IMS'''. Затем вы можете выполнять обслуживание без обновления работ.

Например:
{| class="wikitable"
|DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R12770.SZDTAUTH'))

DEFINE ALIAS(NAME('DT.DYNTRC.SZDTLOAD') RELATE('DT.R12770.SZDTLOAD'))
|}

== Установка подсистемы zDC ==
Подсистема '''z/OS Data Collection (zDC)''' взаимодействует с модулями '''CICS, IMS''' и '''z/OS Java''' через объект общей памяти ('''SMO''') на '''LPAR'''. Подсистема '''zDC''' поддерживает этот '''SMO''', и модули записывают в него свои данные мониторинга.

'''zLocal''' (<code>libdtzagent.so</code>), размещенный в среде '''z/OS''' [https://www.ibm.com/docs/en/zos/2.5.0?topic=zos-unix-system-services Unix System Services] ('''USS'''), работает как часть '''zDC'''. Он управляет подключением сокета '''TCP/IP''' к модулю '''zRemote''', считывает данные мониторинга из '''SMO''' и передает эти данные в '''zRemote'''.

Загрузчик (<code>dtzagent</code>), размещенный в среде '''z/OS USS''', работает как часть '''zDC'''. Он управляет процессом обновления '''zLocal'''.

Когда '''zDC''' инициализируется (запуск системы или ручной запуск), он запускает загрузчик, а загрузчик запускает '''zLocal'''. Когда '''zDC''' завершает работу, '''zLocal''' и загрузчик останавливаются.

=== Безопасность системы ===
'''zDC''' ('''zLocal''') использует соединения сокетов '''TCP/IP''', поэтому может потребоваться обновить правила доступа вашей системы безопасности, если они настроены на запрет доступа по протоколу '''TCP/IP''' по умолчанию.

'''zDC''' не ограничивает идентификаторы пользователей, которые могут вводить команды оператора.

Вы можете контролировать разрешения, назначаемые файлам, созданным '''zLocal''' и загрузчиком, установив <code>DT_UMASK</code>. Значение по умолчанию — <code>umask(022)</code>.

=== Установка ===
'''zDC''' работает как авторизованный процесс '''z/OS''' (обычно как системная задача). Это означает, что программы должны находиться в авторизованной библиотеке. Он предназначен для автоматического запуска в качестве запущенной задачи в системной '''IPL'''. Это обеспечивает '''zDC''' постоянную доступность для сбора данных мониторинга из модулей.

'''zDC''' также может быть запущен, как пакетное задание. Класс обслуживания '''zDC''' должен быть достаточно высоким, чтобы он всегда был доступен для сообщений '''keep-alive''' от '''zRemote'''. '''zDC''' должен иметь приоритет, равный или превышающий приоритет контролируемых регионов '''CICS''' и '''IMS'''.

Подсистема '''zDC''' должна быть установлена на каждом '''LPAR''', который вы хотите отслеживать.

1. Загрузите наборы данных продуктов '''z/OS'''. Запишите высокоуровневый квалификатор, используемый в процедуре загрузки.

2. Создайте идентификатор пользователя '''RACF''' для процесса '''zDC'''. Этот идентификатор должен иметь сегмент '''z/OS USS'''. Рекомендуемое имя домашней директории — <code>/u/dt</code>.

Если задана домашняя директории, отличная от <code>/u/dt</code>, измените путь к загрузчику на шаге 8, которая по умолчанию равна <code>/u/dt/agent/lib64/dtzagent</code>. Имена домашней директории ниже не могут быть изменены.

Домашняя директория или заменяющий ее квалификатор высокого уровня должны быть доступны для записи процессом '''zDC'''.

* Он записывает двоичный файл '''zLocal''' в <code>/u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so</code>, где <code>a.b.c.d</code>— версия '''zLocal''' (т. е. '''1.0.1.0''').
* Он записывает логи '''zDC''' и '''zLocal''' в <code>/u/dt/log/dtxxx.log</code>.

В случае сбоя записи процессы '''zDC''' используют директорию <code>/tmp/Astromkey</code>.

Если '''zDC''' запускается, как запущенная задача, идентификатор должен соответствовать запущенной задаче '''zDC''' и иметь доступ к указанному выше пути '''USS'''.

3. Измените высокоуровневый квалификатор датасетов, представленный в элементе '''<hlq>''', <code>COPYAGNT</code> на значение <code>SZDTSAMP</code>, которое вы использовали в процедуре загрузки наборов данных продуктов '''z/OS'''.

4. Запустите работу <code>COPYAGNT</code>, чтобы создать необходимые поддиректории '''z/OS USS''' в домашней директории запущенной работы '''zDC'''.

5. Скопируйте двоичный файл <code>dtzagent</code> и сделайте его исполняемым <code>SZDTSAMP</code>.

Если вы используете домашнюю директорию по умолчанию <code>/u/dt</code>, то результирующий путь будет <code>/u/dt/agent/lib64/dtzagent</code>.

Если используется домашняя директория, отличная от <code>/u/dt</code>, путь в этой работе должен быть изменен соответствующим образом. Имена файлов и директорий чувствительны к регистру. Имена путей ниже домашней директории не могут быть изменены.

Работа <code>COPYAGNT</code> должна выполняться под идентификатором пользователя, который был создан для процесса '''zDC''', так что этот идентификатор пользователя владеет двоичным файлом <code>dtzagent</code>. Если это неудобно, вы также можете использовать команды <code>chown</code> и <code>chgrp</code> для сброса пользователя-владельца и группы для двоичного файла <code>dtzagent</code> после запуска <code>COPYAGNT</code>.

6. Разрешите <code><hlq>.SZDTAUTH</code>, где <code><hlq></code> значение высокоуровневого квалификатора, которое вы использовали в процедуре загрузки датасетов продуктов '''z/OS'''.

Например, создайте элемент с именем, <code>SYS1.PARMLIB(PROGDT)</code> содержащим:
{| class="wikitable"
|APF FORMAT(DYNAMIC)

APF ADD DSNAME(<hlq>.SZDTAUTH) VOLUME(XXXXXX)
|}
Затем введите консольную команду:
{| class="wikitable"
|SET PROG=DT
|}
7. Скопируйте образец запущенной задачи '''zDC PROC''' <code>ZDCMEPC</code> из системной '''PROCLIB''' <code>SZDTSAMP</code>, используемой для запущенных задач.

Имя по умолчанию для '''PROC''' — <code>MEPC</code>. Настройте его по мере необходимости для местных стандартов. Если выбрано другое имя подсистемы, измените параметр <code>SUBSYSTEM_ID()</code> в параметрах '''SYSIN''' для соответствия.
{| class="wikitable"
|//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

SUBSYSTEM_ID(MEPC)
|}
Элементы '''PROC''' и '''JCL SYSIN''' <code>ZDCSYSIN</code> и <code>ZDCMEPCA</code>, которые они используют, содержат имена датасетов, которые необходимо отредактировать, заменив <code><hlq>.</code> соответствующими высокоуровневыми квалификаторами.

8. Обновите параметр SYSIN <code>DTAGTCMD()</code>, чтобы он отражал ваши определения.
{| class="wikitable"
|//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTAGTCMD(/u/dt/agent/lib64/dtzagent

nobootstrap=false

zremoteagent=<ipaddress>[:port])
|}

* <code>/u/dt/agent/lib64/dtzagent</code> задает путь к загрузчику. Имя домашней директории по умолчанию — <code>/u/dt</code>. Если вы задали другую домашнюю директорию на шаге 2, измените ее соответствующим образом.
* <code>nobootstrap=false</code> позволяет загрузчику автоматически обновлять '''zLocal''', как только становится доступна более новая версия. По умолчанию '''zLocal''' получает автоматические обновления. Установите значение на <code>true</code> для отключения автоматических обновлений и вручную обновите '''zLocal''' .
* <code>zremoteagent=<ipaddress>[:port]</code> установите IP-адрес и порт установленного модуля '''zRemote'''. IP-адрес обязателен, порт необязателен и по умолчанию равен '''8898'''.

9. Убедитесь, что выход '''SMF U86''' активен.

* '''необходимый''' Вам необходимо использовать '''z/OS 2.3''' или более позднюю версию.
* '''необходимый''' Выход '''U86''' необходим для отчета об использовании '''LPAR''' для метрик '''DPS''' и выставления счетов. Ключ-АСТРОМ может приостановить трассировку без метрик '''DPS'''.

{| class="wikitable"
|Начиная с версии ЕдиногоАгента 1.315, трассировка будет автоматически приостановлена, если метрика <code>host.zos.msu_hours</code> не будет получена в течение 12 часов подряд.

Когда это происходит, в логах '''zRemote''' регистрируется следующее сообщение:

<code>Tracing has been disabled. The LPAR[LPAR] has not sent valid billing metrics.</code>

Отслеживание будет автоматически возобновлено после повторного получения действительных показателей <code>host.zos.msu_hours</code>.
|}
Чтобы проверить активность выхода '''SMF U86''', выполните следующую команду:
{| class="wikitable"
|D SMF,O
|}
Найдите в выводе команды <code>(EXITS(IEFU86))</code>.

* Если вы это нашли, выход '''SMF U86''' активен. Переходите к следующему шагу.
* Если вы его не нашли, вам необходимо добавить его в '''parmlib SMFPRMxx'''.

{| class="wikitable"
|SUBSYS(STC,EXITS(IEFU86)
|}
Затем включите его.
{| class="wikitable"
|D PROG,EXIT,EN=SYS.IEFU86,DIAG
|}
10. '''необязательный''' Добавьте команду в автозагрузку системы для автоматического запуска подсистемы '''zDC''' при '''IPL'''.

11. Используйте <code>ZDCIVP</code> '''PROC''' <code>SZDTSAMP</code> для проверки установки '''zDC''' и подключения '''zRemote'''.

Хороший тест на подключение '''zRemote''' возвращает <code>Connection timeout</code>, так как '''zRemote''' не поддерживает протокол '''FTP'''. Если существует проблема подключения '''zRemote''', это обозначается <code>EDC8128I Connection refused</code>. Это означает, что '''zRemote''' не прослушивает ожидаемый порт.

=== Проверка установки ===
После завершения установки проверьте ее правильность.

==== Убедитесь, что zDC запущен правильно ====
Убедитесь, что '''zDC''' запустил правильную версию, успешно инициализировался и запустил '''zLocal'''. Найдите следующие сообщения в <code>zDC SYSPRINT DD</code>.
{| class="wikitable"
|ZDC000I INITIALIZATION STARTED FOR zDC  VER 1.195.00

ZDC052I zDC IS RUNNING ON Z/OS RELEASE 02.02.00

ZDC053I LPAR NAME IBMSYS1    CVTSNAME S0W1

.

.

.

.

ZDC955L Astromkey connection being processed ZDC-Job/ID:AFVBZ021/Z021

ZDC958L Astromkey INIT completed, ZDC AgentId received ZDC-Job/ID:AFVBZ021/Z021

ZDC993I Opn1RFD:0008  /u/labuser/adcdk/ci/7.2build/log/dt_Z021_Z021_33620108.0.log

ZDC955I Astromkey connection being processed ZDC-Job/ID:AFVBZ021/Z021
|}
Если в логах работы '''zDC''' появляется следующее сообщение <code>SUBSYSTEM_ID</code> (имя вашей подсистемы может отличаться от <code>MEPC</code>), перезапустите '''zDC''' с другими параметрами '''SYSIN'''.
{| class="wikitable"
|11:55:30.419083 ZDC006E SUBSYSTEM MEPC ALREADY EXISTS AND IS ACTIVE
|}

==== Убедитесь, что zLocal правильно запущен и подключен к zRemote. ====
'''zLocal''' записывает сообщения логов в '''zDC SYSPRINT DD''' в дополнение к среде '''z/OS USS''' <code>/u/dt/log</code>. Логи '''zLocal''' содержат информацию, касающуюся запуска '''zLocal''', управления версиями и подключения к '''zRemote'''.

Чтобы убедиться, что все каналы в '''zLocal''' подключены к '''zRemote''', найдите следующие сообщения в '''SYSPRINT''':
{| class="wikitable"
|info    [native] Astromkey z Remote Agent data channel connected successfully, performing handshake.

info    [native] Astromkey z Remote Agent client handshake performed.

info    [native] Astromkey z Remote Agent data channel handshake successful, version[rr.rr.rr.bbbb].

info    [native] Astromkey z Remote Agent control channel connected successfully, performing handshake

info    [native] Astromkey z Remote Agent handshakes are complete, all channels are fully operational.
|}
Используйте команду '''z/OS MODIFY''' ниже, чтобы указать '''zDC''' на необходимость отображения статуса '''zLocal''' и поиска путей к файлам логов '''zLocal''' и '''zRemote'''.
{| class="wikitable"
|MODIFY <zdc-jobname>,DT1 STDO
|}
После того, как файл логов '''zLocal''' найден, вы можете получить к нему доступ, используя стандартные методы. Используйте '''OMVS, ssh/telnet''' или просмотрите его в веб-интерфейсе Ключ-АСТРОМ, как обычный файл логов ЕдиногоАгента.

Также найдите следующие сообщения в соответствующем файле логов '''zRemote''' (значения в скобках должны отражать ваши текущие данные).
{| class="wikitable"
|info    [native] Astromkey z Local Agent handshakes are complete, all channels are fully operational, version[rr.rr.rr.bbbb].

info    [native] Data client socket listener thread started

info    [native] ASID[48], smfID[S0W1], sysid[Z208], jobName[AF71Z208], subagentid[da57ff16] smfID.JobID[S0W1    .JOB92014], zDC release 65 was successfully initialized with protocol version=6.5.0

info    [native] zDC[Z208] SMO is initialized with size=10M.

info    [native] Registering the zdc[48]
|}

==== Проверьте уровень обслуживания модуля нагрузки zLocal ====
Просмотрите библиотеку установки <code><hlq>.R1nnnxx.SZDTAUTH</code>, где <code><hlq></code> находится высокоуровневый квалификатор набора данных продукта, чтобы найти загрузочный модуль для '''zLocal''' <code>ZDCDTAGT</code>.

В примере заголовка ниже вы можете увидеть <code>1.nnn.00</code>, что указывает на то, что это версия загрузочного модуля без какого-либо обслуживания. Когда применяется обслуживание, поле содержит номер подверсии, например <code>1.nnn.01</code>. Даты меняются со временем.
{| class="wikitable"
|ZDCDTAGT 00000000 YYYYMMDD HH.MM VER 1.nnn.00 COPYRIGHT (C)...
|}
Загрузочный модуль <code>ZDCDTAGT</code> может выдавать диагностические сообщения в следующем формате:
{| class="wikitable"
|ZDC99<n><nowiki><i></nowiki>
|}
Где <code>n</code> - уровень логов, а <code>i</code> где — приоритет.

==== Сообщение о недостаточности прав доступа при запуске zDC ====
Если в логах заданий '''zDC''' появляются следующие сообщения (или что-то похожее):
{| class="wikitable"
|H408I USER(xxxxxxxx) GROUP(xxxx) NAME(STARTED TASK )

BPX.FILEATTR.PROGCTL CL(FACILITY)

INSUFFICIENT ACCESS AUTHORITY

ACCESS INTENT(READ ) ACCESS ALLOWED(NONE )
|}
А соответствующие сообщения появляются в файле логов '''zLocal''':
{| class="wikitable"
|JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Server requests us to use Agent

dTMajor.dTMinorVersion.0.dTBuild with a hash of 0317af199c1ab1a03dda2cee90c2ea61

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Requesting Agent library from Server

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Error setting Agent library program

controlled: EDC5139I Operation not permitted.

JJJJ-MM-DD HH:MM:SS  3f8bbe02¨ info  native¨ Loading Agent

/dt/Astromkey-<dTMajor.dTMinorVersion.0>/agent/downloads/<dTMajor.dTMinorVersion.0.dTBuild>

/native/zos-s390-64/libdtzagent.so
|}
Их можно игнорировать.

После первоначальной загрузки '''zLocal''' операционная система пытается установить флаг для загруженной библиотеки, которая необходима в определенных обстоятельствах. Флаг не устанавливается во время второго запуска, поскольку библиотека больше не будет загружена, если она уже существует.

=== Набор данных SYSIN ===
Все значения, которые настраивают выполнение '''zDC''', находятся в датасетах, на который указывает <code>DDNAME SYSIN</code>. Образец запущенной задачи '''PROC''' <code>ZDCMEPC</code> ссылается на '''JCL SYSIN''' <code>ZDCSYSINSZDTSAMP</code>, как показано ниже: 
{| class="wikitable"
|//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)
|}
Датасет должен содержать '''80''' записей символов, кратных '''80''' байтам.
{| class="wikitable"
|При внесении любых изменений в набор данных SYSIN необходимо перезапустить процесс zDC, чтобы изменения вступили в силу.
|}

==== Параметры SYSIN ====
Позиции с 1 по 71 каждого оператора могут содержать значения параметров. Позиции с 72 по 80 игнорируются и могут опционально содержать порядковый номер.

Каждый параметр использует формат <code>KEYWORD(value)</code>. Каждое ключевое слово и требования к связанным с ним значениям задокументированы в '''JCL''' <code>ZDCSYSIN</code> '''SYSIN''' <code>SZDTSAMP</code>.

Если значение параметра занимает несколько строк, укажите значение до позиции 71 и продолжите значение в следующем операторе, начиная с позиции 1.

===== Как добавить комментарий к выражению =====
Если вы хотите использовать комментарий, укажите это, поставить звездочку в позицию 1 утверждения. Все утверждение считается частью комментария.
{| class="wikitable"
|/* This is a comment. */
|}
Комментарий можно заключить между косой чертой и звездочкой, и звездочкой и косой чертой.
{| class="wikitable"
!Параметр (значение по умолчанию)
!Описание
|-
|DTAGTCMD(/u/dt/agent/lib64/dtzagent)
|Устанавливает путь к загрузчику <code>dtzagent</code>.

Дополнительные параметры:

* <code>nobootstrap=false</code> позволяет загрузчику автоматически обновлять '''zLocal''', как только становится доступна более новая версия. Установите значение на <code>true</code> для отключения автоматических обновлений.
* <code>zremoteagent=<ipaddress>[:port]</code> устанавливает IP-адрес и порт установленного модуля '''zRemote'''. IP-адрес обязателен, порт необязателен и по умолчанию равен '''8898'''.
* <code>name=zlocal_<lpar></code> определяет имя '''zLocal''' для файлов логов. Имя должно отражать, что это '''zLocal'''. Оно может включать идентификатор '''SMF''' обслуживаемого '''LPAR'''.
* <code>loglevel=<value></code> устанавливает уровень логов '''zLocal'''. Значения уровня логов включают <code>FINEST</code>, <code>FINER</code>, <code>FINE</code>, <code>CONFIG</code>, <code>INFO</code>, <code>WARNING</code>, <code>SEVERE</code>, <code>DEBUG</code>, <code>NONE</code>). Значение по умолчанию отсутствует.
|-
|SUBSYSTEM_ID(MEPC)
|Определяет имя подсистемы '''zDC'''. Оно должно состоять из четырех непустых символов:

* Первый символ должен быть заглавной буквой (A:Z).
* Последние три символа — заглавные буквы или цифры (#,$,@,A:Z,0-9).
|-
|DEFAULT(YES)
|Определяет подсистему '''zDC,''' как подсистему по умолчанию. Данные мониторинга собираются подсистемой '''zDC''' по умолчанию, которая определяет <code>DEFAULT(YES)</code>. Если вы запускаете несколько подсистем '''zDC''' на одном '''LPAR''', вам необходимо указать <code>DEFAULT(NO)</code> для каждой дополнительной '''zDC''', в противном случае они не будут инициализированы.
|-
|DISPLAY_NAME()
|Определяет отображаемое имя для этой подсистемы '''zDC''' для ее идентификации в определенных сообщениях логов.
|-
|DTLOGLEVEL(3)
|Устанавливает уровень логов '''zDC'''. Диапазон значений уровня логов от <code>0</code> до <code>8</code>. Установите значение <code>4</code> для подавления информационных сообщений. Значения ниже <code>3</code> следует использовать только для диагностической отладки.
|-
|DTMSG_SMOSIZE(1)
|Устанавливает максимальный объем хранилища (МБ) для сообщений, которые могут быть поставлены в очередь в объекте общей памяти '''zDC''' при ожидании записи в модули '''z/OS'''. Значение по умолчанию 1 МБ должно быть достаточным в большинстве случаев, когда включена буферизация транзакций. Если буферизация транзакций отключена (не рекомендуется), установите размер '''SMO''' на 10 МБ, если отслеживаются очень большие объемы транзакций.
|-
|DTCHDIR(/u/dt)
|Изменяет текущую директорию '''z/OS USS''', в котором загрузчик <code>dtzagent</code> создает временные файлы для <code>stdin</code>, <code>stdout</code>, и <code>stderr</code>. По умолчанию используется домашняя директория соответствующего идентификатора пользователя.
|-
|DTMSG_TRANBUFSIZE(n,m)
|Переопределяет количество и размер буферов транзакций по умолчанию. Буферы транзакций обеспечивают лучшую производительность для модулей '''CICS''' и '''IMS''', помещая сообщения о событиях, связанные с каждой распределенной трассировкой, в выделенные буферы. Вместо того чтобы отправлять отдельные сообщения о событиях для каждой распределенной трассировки по мере их возникновения, они блокируются в одном или нескольких буферах и отправляются вместе. Кроме того, буфер связанных сообщений обрабатывается '''zRemote''' более эффективно.

Параметр <code>n</code>— это количество буферов в тысячах. Например, 2 = 2000 буферов. Нулевое значение отключает буферы транзакций. Параметр <code>m</code> должен быть либо <code>2</code> или <code>4</code> для указания размера буфера 2 КБ или 4 КБ. Мы рекомендуем размер буфера 4 КБ, если потребление хранилища не является существенной проблемой. Минимальное неотключаемое значение — <code>1,2</code>. Максимальное — <code>126,4</code> или <code>248,2</code>, что соответствует общему размеру 512 МБ. Верхняя граница количества буферов, которые могут потребоваться, — один для каждой области сообщений '''IMS''' и '''MAXTASK''', умноженное на количество областей '''CICS''', но фактические требования, вероятно, будут значительно меньше.
|}

=== Ведение логов ===
Уровень логов '''zDC''' устанавливается параметром <code>DTLOGLEVEL()</code> в параметрах '''SYSIN'''. Вы можете динамически изменять этот уровень логов, выполнив команду '''z/OS MODIFY'''.
{| class="wikitable"
|//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTLOGLEVEL(3)

MODIFY <jobName>,DT1 LOG=1
|}
Просмотр выходных сообщений логов в очереди работы '''zDC'''. Очередь заданий помогает определить ошибки, которые могут возникнуть во время запуска '''zDC''' или при подключении к '''zRemote'''. После успешного подключения '''zDC''' к '''zRemote''' сообщения об ошибках из подсистемы '''zDC''' и модулей '''CICS''' и '''IMS''' направляются в '''zRemote'''.

Уровень логов '''zLocal''' задается параметром <code>DTAGTCMD(loglevel=INFO)</code> в параметрах '''SYSIN'''. Вы можете динамически изменять этот уровень логов, выполнив команду '''z/OS MODIFY'''. <code>DTAGTCMD(name=zlocal_<lpar>)</code> определяет имя '''zLocal''' для файлов логов. Имя должно отражать, что это '''zLocal'''. Оно может включать идентификатор '''SMF''' обслуживаемого '''LPAR'''.
{| class="wikitable"
|//SYSIN DD DISP=SHR,DSN=<hlq>.SZDTSAMP(ZDCSYSIN)

DTAGTCMD(loglevel=INFO name=zlocal_<lpar>)

MODIFY <jobname>,DT1 ZLALOGLEVEL=FINE
|}
Для '''zLocal''' создано два набора логов. Оба они создаются в файловой системе '''OMVS'''. Один набор — это временный набор логов, действительный только для текущего выполнения '''zDC''', и местоположение этих логов по умолчанию — домашняя директория идентификатора пользователя '''zDC'''. Вы можете переопределить местоположение, используя параметр <code>DTCHDIR()</code> в параметрах '''SYSIN'''.

'''ZLocal''' также создает стандартный набор логов, один для загрузчика и один для самого '''zLocal'''. Эти логи находятся в стандартных местах логов Ключ-АСТРОМ в файловой системе '''OMVS'''.

=== Обновление и обслуживание ===

# Загрузите датасеты продуктов '''z/OS''' и извлеките их.
# Обновите работу '''zDC''', чтобы оно указывало на новый <code><hlq>.SZDTAUTH</code>. Если вы определили псевдоним, переопределите его. Например:

{| class="wikitable"
|DELETE 'DT.DYNTRC.SZDTAUTH' NOSCRATCH

DEFINE ALIAS(NAME('DT.DYNTRC.SZDTAUTH') RELATE('DT.R12710.SZDTAUTH'))
|}

==== Обновление подсистемы zDC с версии 1.211 или более ранней ====
Требуется специальная обработка, чтобы избежать аварийных ситуаций в регионах '''CICS''', которые вы отслеживаете при обновлении подсистемы '''zDC''' с версии '''1.211''' или более ранней.

# Остановите '''zDC.'''
# Подождите '''15 минут''', пока модуль '''CICS''' перезагрузится и очистит блоки управления.
# Обновите '''zDC''' до новой версии.
# Запустите '''zDC'''.

==== zLocal ====
По умолчанию '''zLocal''' получает автоматические обновления, если <code>DTAGTCMD(nobootstrap=false)</code> установлено в параметрах '''SYSIN'''. При каждом запуске '''zDC''' загрузчик запрашивает модуль '''zRemote''' на наличие доступных обновлений. Последняя версия '''zLocal''' устанавливается как часть установки '''zRemote'''. Если доступно обновление, '''zLocal''' будет автоматически загружен из '''zRemote''' и обновлен.

===== Примеры сообщений логов в выходных данных задания zDC в случае автоматических обновлений =====
{| class="wikitable"
|info    (native) The bootstrap channel connected successfully, requesting version: a.b.c.d

info    (native) Interprocess lock acquired for /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so

info    (native) Fetching agent binary succeeded for /u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so
|}

==== Обновление zLocal вручную ====

* Не используйте ручной процесс обновления '''zLocal''' при первом подключении к среде Ключ-АСТРОМ, поскольку '''zDC''' не запустится успешно.
* Модуль '''zRemote''' должен быть запущен при первом запуске '''zDC''', чтобы избежать <code>U103</code> аварийного завершения работы пользователем .

Предположим, вы не хотите получать автоматические обновления для '''zLocal''', установленные <code>DTAGTCMD(nobootstrap=true)</code> в параметрах '''SYSIN'''. Для ручного процесса обновления двоичный файл '''zLocal''' <code>libdtzagent.so</code> должен присутствовать на '''LPAR''' в директории <code>/u/dt/agent/lib64</code>.

Чтобы достичь этого:

# Запустите загрузчик <code>dtzagent</code> хотя бы один раз в производственном '''LPAR-разделе''' или в непроизводственном '''LPAR-разделе'''.
# Копируйте двоичный файл '''zLocal''' в целевой '''LPAR'''. В датасете <code>SZDTSAMP</code> участник <code>OCOPYAGT</code>— это работа, которое копирует двоичный файл '''zLocal''' <code>libdtzagent.so</code> в директории <code>/u/dt/agent/lib64</code>.
# Выполните инструкции по запуску '''zDC''' и подключите его к среде Ключ-АСТРОМ.
# Если '''zDC''' успешно подключается к Ключ-АСТРОМ, <code>libdtzagent.so</code> копируется в директорию <code>/u/dt/agent/downloads/native/a.b.c.d/zos-s390-64/libdtzagent.so</code>, где находится версия '''zLocal''' <code>a.b.c.d</code> (т.е. 1.0.1.0)

===== Примеры сообщений логов в выходных данных работ zDC в случае ручных обновлений =====
{| class="wikitable"
|info    (native) Configured to not download module - loading local module

info    (native) Start loading local agent binary

info    (native) Successfully loaded agent binary /u/dt/agent/lib64/libdtzagent.so
|}

=== Пользователь завершает работу zDC ===
'''ZDC''' может завершиться с пользовательским аварийным завершением из-за внутренних ошибок и сбоев инициализации. Все пользовательские аварийные завершения, за исключением <code>U103</code> и <code>U106</code>, создают файл дампа. См. '''список возможных пользовательских аварийных завершений''' ниже.
{| class="wikitable"
!Abend
!Описание
|-
|U100
|Произошла внутренняя ошибка из-за сбоя инициализации '''zDC'''.
|-
|U101
|Инициализация '''zDC''' не удалась, и сообщение об ошибке не отображается.
|-
|U102
|Хранилище '''ECSA''' недоступно для '''zDC'''.
|-
|U103
|Возникла проблема во время операции '''RETRY''' из процедуры выхода из режима восстановления.
|-
|U104
|Задача очереди завершилась ненормально. Это аварийное завершение сопровождается сообщением <code>ZDC066E</code> в '''SYSLOG'''.
|-
|U105
|Задача очереди завершилась аварийно, когда выключение НЕ выполнялось.
|-
|U106
|Произошла фатальная ошибка в процедуре '''TCPSP'''.
|-
|U110
|Это аварийное завершение может произойти по разным причинам внутренних ошибок. Оно сопровождается одним из следующих сообщений об ошибках '''zDC''' в '''SYSLOG''':

* <code>ZDC988E</code>
* <code>ZDC987E</code>
* <code>ZDC985E</code>
* <code>ZDC984E</code>
* <code>ZDC983E</code>
* <code>ZDC982E</code>
* <code>ZDC981E</code>
* <code>ZDC988E</code>
* <code>ZDC982E</code>
* <code>ZDC981E</code>
* <code>ZDC979E</code>
* <code>ZDC978E</code>
|-
|U111
|Произошла внутренняя ошибка в одном из модулей '''zDC'''. Аварийное завершение сопровождается одним из следующих сообщений об ошибке в '''SYSLOG''':

* <code>AgtSt:DqrIErr-Get Token/Name for FML failed</code>
* <code>AgtSt:DqrILod LOAD failed</code>
* <code>AgtSt:Waiting for Que Data Space failed-Abort</code>
|-
|U205
|'''zDC''' не может открыть '''SYSPRINT''' или '''SYSPRIN3 DD''' для отображения сообщений логов.
|-
|U222
|Произошла внутренняя ошибка в одном из модулей '''zDC'''. Аварийное завершение сопровождается одним из следующих сообщений в '''SYSLOG''':

* <code>066E IEAVRLS Error limit!</code>
* <code>066E Freed dead TBC Error-Abend222</code>
|}