Перейти к основному содержимому Перейти к дополнительному содержимому
Ресурсы Qlik

Управление процессом CDC

Data Movement Gateway использует структуры памяти ECSA (так называемые службы R4Z CDC), которые формируются во время обработки CDC. Каждый логический раздел z/OS может содержать несколько таких служб R4Z CDC. Для формирования служб R4Z CDC предусмотрена специальная служебная программа, R4ZCTL.

Эта программа также позволяет управлять состоянием обработки CDC и уровнем трафика на стороне z/OS.

Программа управления R4Z (R4ZCTL) необходима для следующих задач: проверка CDC и сообщение данных о состоянии службы CDC, приостановка обработки CDC, возобновление CDC после приостановки и завершение процесса CDC в обычном или принудительном порядке.

Ниже перечислены параметры команды, доступные при выполнении программы R4ZCTL:

Примечание к информации

Если команда выполняется без параметров, она возвращает текущее состояние службы CDC.

  • CHECKCONFIG — проверяет допустимость параметров конфигурации
  • PAUSE_TASK — останавливает службу конкретной задачи CDC
  • PAUSE_CDC — прекращает всю активность службы CDC
  • RESUME_TASK — позволяет возобновить выполнение приостановленной задачи
  • RESUME_CDC — позволяет возобновить работу приостановленной службы CDC
  • TERMINATE — останавливает службу CDC, а затем освобождает все используемые ресурсы
  • FORCE — то же, что TERMINATE, когда задача, использующая ресурсы «зависает»

Так как программа R4ZCTL требует авторизацию APF, для всех библиотек в STEPLIB должна выполняться авторизация APF.

При выполнении R4ZCTL без параметра соответствующий код завершения устанавливается в зависимости от того, является среда инициализированной (CC=0) или неинициализированной (CC=1).

Синтаксис вызова программы управления

Программа R4ZCTL вызывается как шаг задания, то есть EXEC PGM=R4ZCTL, и принимает инструкции через параметр вызова шага задания.

Параметр вызова R4ZCTL — это строка, которая может содержать дополнительные субпараметры, разделенные запятой, как показано ниже:

[SERVICE=CDC-service-qualifier,][MSGLVL={0 | 1},][action]

Примечание к информации

Порядок субпараметров в строке не имеет значения.

Где:

SERVICE=CDC-service-qualifier обозначает логическую область действия Data Movement Gateway, которую охватывает программа управления.

MSGLVL={0 | 1 | 2} обозначает уровень уведомлений для отображения в файле сообщения во время работы программы управления.

  • 0 = без уведомлений
  • 1 = умеренный
  • 2 = максимальный

action-verb может быть одним из следующих:

  • PAUSE_TASK(*|ALL|task-qualifier)

    Приостанавливает извлечение CDC для задач, указанных в круглых скобках.

  • PAUSE_CDC

    Приостанавливает извлечение CDC для всей службы CDC. Задачи репликации, которые остаются приостановленным дольше определенного времени, останавливаются, предпринимается несколько попыток возобновления. Новые задачи обслуживаться не будут.

  • RESUME_TASK(*|ALL|task-qualifier)

    Возобновляет извлечение CDC для задачи, указанной в task-qualifier.

  • RESUME_CDC

    Возобновляет извлечение CDC для всех экземпляров, соответствующих квалификатору session-limits.

  • DUMP_TASK(*|ALL|task-qualifier)

    Запрашивает форматированный дамп данных управления в структурах резидентной памяти. ALL указывает все сеансы; SUMMARYONLY указывает только привязку.

  • TERMINATE

    Освобождает все структуры резидентной памяти R4Z, завершает работу всех активных экземпляров и удаляет связанные ресурсы. С этого момента все запросы CDC будут возвращать неактивное состояние, пока служба CDC не будет автоматически активирована входящим вызовом UDF средства чтения CDC.

Справочник по элементам синтаксиса

Ниже приводятся элементы, используемые в описаниях синтаксиса выше:

  • CDC-service-qualifier

    4-значное имя (первый символ буквенный, остальные буквенно-цифровые), идентифицирующее службу CDC.

    Служба CDC — это группа ресурсов, включая структуры памяти, пользовательскую табличную функцию (UDTF), определенную в DB2 и среду приложения (APPLENV), определенную в политике WLM. R4Z позволяет задать свойства — пределы памяти и пороги обработки — для каждой службы CDC. Также может потребоваться управлять несколькими службами CDC и по другой причине: а именно, указание нескольких выпусков Data Movement Gateway, используемых в одном логическом разделе, при этом каждый выпуск имеет собственные структуры памяти, независимые от остальных.

  • task-qualifier

    Четырехзначный идентификатор, назначаемый после инициации задачи. Этот идентификатор предназначен, главным образом, для контроля и отслеживания трафика CDC конкретной задачи. Он формирует CORRID (идентификатор корреляции) службы CDC, обрабатывающей потоки DB2 и занимает в нем биты 9–12.

Коды завершения программы управления

  • 0 — штатное завершение
  • 1 — среда не выходит из квалификатора session-limits (когда не указано action )
  • 4 — предупреждение
  • 8 — ошибка

Образцы заданий (в библиотеке INSTALL)

IV1CHECK — проверяет конфигурацию всех служб CDC

XMDUMP — сохраняет дамп всех сеансов

XMPAUSE — приостанавливает сеанс

XMRESUME — возобновляет сеанс

XMTERMIN — прекращает все сеансы

Включение процесса CDC (автоматическая активация)

Чтобы обеспечить работу функции UDTF средства чтения CDC, эта функция должна иметь возможность распределять и предварительно форматировать структуры памяти в ECSA при вызове UDTF и в первый раз после запуска системы z/OS. Ей также требуется доступ к конфигурациям, заданным для службы CDC, предоставляемой посредством UDTF (или конфигурации «по умолчанию» для значений, не заданных на уровне службы CDC).

С этой целью в процессе установки обеспечивается следующее:

  1. Специальная функция UDTF создается для предоставления службы CDC. К названию созданной функции UDTF добавляется суффикс с двойным знаком подчеркивания («__») и CDC-service-qualifier, в результате чего имя выглядит подобным образом: <schema>.R4Z_UDTF__<CDC-service-qualifier>.
  2. Среда приложения WLM APPLENV создается для осуществления вызовов перечисленных выше UDTF. К имени созданной среды APPLENV также может добавляться суффикс с квалификатором службы CDC, чтобы обеспечить его уникальность в соответствии с рекомендациями. Однако несколько функций UDTF могут использовать одну среду APPLENV.
  3. Процедура JCL создается для «размещения» выполнений WLM APPLENV. Эта процедура JCL отличается от обычных процедур WLM STC тем, что необходимо указать специальное имя DDNAME — R4ZCNFG, его DSN, должен ссылаться на библиотеку CONFIG продукта R4Z. В этой библиотеке уже ДОЛЖЕН существовать элемент с именем CDCS, который задает конфигурации службы CDC по умолчанию. Также МОЖЕТ существовать элемент с именем CDCS<CDC-service-qualifier>, содержащий значения конфигурации, которые требуется применить для этой службы CDC.

  4. Содержимое каждого элемента CDCS* в библиотеке CONFIG представляет собой список операторов назначения, по одному на карту, в формате «ключевое слово=значение». Оператор может следовать за пробелами и иметь пробелы в конце. Внутри оператора пробелов быть не должно. Карты, которые начинаются с дефиса («-») обрабатываются как карты комментариев; содержимое после конечного пробела также рассматривается как комментарий.

    Ключевые слова, максимальные значения, минимальные значения и значения по умолчанию
    Ключевое слово Описание Минимум Максимум По умолчанию

    MAXSESSIONS

    Максимальное количество сеансов CDC.

    1

    128

    32

    SESSIONTIMEOUTSECS

    Количество секунд, по истечении которого наступает тайм-аут сеанса.

    300

    7200

    900

    MAXIFIBUFKBYTES

    Максимальный размер буфера, разрешенный для чтения IFI, в килобайтах.

    64

    1024

    256

    MAXRESULTSETMBYTES

    Максимальный размер в мегабайтах для совокупного набора результатов, который может быть достигнут. По достижении этого размера набор результатов возвращается.

    1

    2048

    4

    MAXRESULTSETSECS

    Максимальный интервал времени в секундах для накопления набора результатов. По истечении этого времени набор результатов возвращается.

    1

    120

    30

    Учреждение служб R4Z CDC

    Принятие решений о необходимых службах CDC: На основе прогнозируемой потребности независимых процессов репликации (для использования разных версий, для обеспечения достаточной памяти ECSA, для учета разных допустимых задержек и т. д.) определите, какие службы R4Z CDC должны существовать в каждом логическом разделе. Для каждой службы CDC выберите квалификаторы (4 символа). Также необходимо определить, должна ли каждая служба CDC иметь собственную среду приложения WLM APPLENV или для предоставления всех служб CDC может использоваться одна среда APPLENV.

    Необходимо задать переменной DEFWLMAE (DEFine WLM Applic. Env.) в элементе DFSYMLST значение PER (первый вариант) или ONE (второй вариант). После настройки можно продолжать установку:

    Примечание к информации

    • Если для DEFWLMAE выбрано значение ONE, задания DO2* и DO3SRVTF должны выполняться один раз. Если выбрано значение PER, эти задания должны выполняться для каждой службы после того, как переменной CDCSRV в JCL SET задается квалификатор службы CDC.

    • Задание DO3SRVDF создает библиотеку CONFIG и размещает элемент под именем CDCS, который служит в качестве файла конфигурации по умолчанию. После выполнения задания DO3SRVTF библиотека будет содержать конфигурацию всех служб CDC, что делает возможным их редактирование в целом, а также изменение конфигураций для конкретной службы CDC.

    • Если параметру DEFWLMAE задано значение ONE, то значения по умолчанию для продукта используются вместо элементов библиотеки CONFIG.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь