기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기
Qlik 리소스

CDC 프로세스 제어

Data Movement gateway는 CDC 처리 중에 형성되는 R4Z CDC 서비스라고 하는 ECSA 메모리 구조를 사용합니다. 각 z/OS LPAR에는 이러한 여러 R4Z CDC 서비스가 포함될 수 있습니다. R4Z CDC 서비스를 형성하기 위해 특수 유틸리티 프로그램인 R4ZCTL이 제공됩니다.

이 프로그램은 z/OS 측의 트래픽 수준뿐만 아니라 CDC 처리 상태를 관리하는 데에도 사용할 수 있습니다.

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)

    task-qualifier로 지정된 작업에 대한 CDC 검색을 재개합니다.

  • RESUME_CDC

    session-limits 한정자와 일치하는 모든 인스턴스에 대해 CDC 검색을 재개합니다.

  • DUMP_TASK(*|ALL|task-qualifier)

    상주 메모리 구조에서 제어 정보의 서식이 지정된 덤프를 요청합니다. ALL 은 모든 세션을 지정하고 SUMMARYONLY 는 앵커만 지정합니다.

  • TERMINATE

    모든 R4Z 상주 메모리 구조를 해제하고 모든 활성 인스턴스를 종료하며 연결된 리소스를 삭제합니다. 이 시점부터 모든 CDC 요청은 CDC 읽기 프로그램 UDF에 대한 수신 호출에 의해 CDC 서비스가 자동 활성화될 때까지 비활성 상태를 반환합니다.

구문 요소 참조

위의 구문 설명에 사용된 요소는 다음과 같습니다.

  • CDC-service-qualifier

    CDC 서비스를 지정하는 4자 이름(첫 문자 알파벳, 나머지 영숫자).

    "CDC 서비스"는 메모리 구조, DB2에 정의된 사용자 정의 테이블 함수(UDTF) 및 WLM 정책에 정의된 응용 프로그램 환경(APPLENV)과 같은 리소스 그룹을 나타냅니다. R4Z를 사용하면 각 CDC 서비스별로 속성(메모리 제한 및 처리 임계값)을 지정할 수 있습니다. 또 다른 이유로 여러 CDC 서비스를 관리해야 할 수도 있습니다. 즉, 단일 LPAR에서 둘 이상의 Data Movement gateway 릴리스를 사용할 수 있으며 각 릴리스는 서로 독립적으로 메모리 구조를 유지합니다.

  • task-qualifier

    작업 시작 시 할당되는 4자리 식별자입니다. 이 식별자는 주로 특정 작업의 CDC 트래픽을 제어하고 추적하는 데 사용됩니다. CDC를 제공하는 DB2 스레드의 CORRID(상관 관계 ID)를 형성합니다. 여기서 바이트 9~12를 차지합니다.

제어 프로그램 완료 코드

  • 0 – 정상 완료
  • 1 – 환경이 session-limits 한정자를 종료하지 않음(action이 지정되지 않은 경우)
  • 4 – 경고
  • 8 – 오류

샘플 작업(INSTALL 라이브러리에 있음)

IV1CHECK – 모든 CDC 서비스의 구성 확인

XMDUMP – 모든 세션 덤프

XMPAUSE – 세션 일시 중지

XMRESUME – 세션 재개

XMTERMIN – 모든 세션 종료

CDC 프로세스 활성화(자동 활성화)

CDC 읽기 프로그램 UDTF 함수가 작동하려면 이 함수가 UDTF가 호출되고 z/OS 시스템이 시작된 후 처음으로 ECSA에서 메모리 구조를 할당하고 사전 서식화할 수 있어야 합니다. 또한 UDTF가 제공하는 CDC 서비스에 대해 설정된 구성(CDC 서비스 수준에서 지정되지 않은 값의 경우 "기본" 구성)에 액세스해야 합니다.

이를 설명하기 위해 설치 프로세스는 다음을 확인합니다.

  1. CDC 서비스를 제공하기 위해 특수 UDTF가 만들어집니다. 만들어진 UDTF는 이름에 밑줄 두 개("__")가 붙은 뒤에 CDC-service-qualifier가 붙으며 <schema>.R4Z_UDTF__<CDC-service-qualifier>와 같은 이름이 됩니다.
  2. 위의 UDTF 호출을 실행하기 위해 WLM APPLENV가 만들어집니다. 만들어진 APPLENV는 또한 APPLENV 이름의 고유성을 보장하기 위해 CDC 서비스 한정자가 접미사로 붙을 수 있습니다. 이는 권장 사항이지만 여러 UDTF가 단일 APPLENV를 사용할 수 있습니다.
  3. WLM APPLENV 실행을 "호스트"하기 위해 JCL 프로시저가 만들어집니다. 이 JCL 프로시저는 특수 DDNAME인 R4ZCNFG가 지정되어야 하고 해당 DSN이 R4Z 제품의 CONFIG 라이브러리를 참조한다는 점에서 일반적인 WLM STC 프로시저와 다릅니다. 이 라이브러리에는 기본 CDC 서비스 구성을 지정하는 "CDCS"라는 기존 구성원이 있어야 합니다. 이 CDC 서비스에 적용하려는 구성 값을 가진 "CDCS<CDC-service-qualifier>"라는 구성원도 존재할 수 있습니다.

  4. CONFIG 라이브러리에 있는 각 CDCS* 구성원의 콘텐츠는 "키워드=값" 서식으로 카드당 하나씩 할당 문 목록입니다. 이 문은 공백 뒤에 올 수 있고 공백으로 종료되며, 이 문에는 공백이 허용되지 않습니다. 하이픈('-')으로 시작하는 카드는 주석 카드로 처리되며 종료 공백 뒤에 오는 콘텐츠도 주석으로 처리됩니다.

    키워드, 최댓값, 최솟값 및 기본값
    키워드 설명 Minimum Maximum 기본값

    MAXSESSIONS

    최대 CDC 세션 수입니다.

    1

    128

    32

    SESSIONTIMEOUTSECS

    세션이 시간 초과된 후의 시간(초)입니다.

    300

    7200

    900

    MAXIFIBUFKBYTES

    IFI 읽기에 허용되는 최대 버퍼 크기(KB)입니다.

    64

    1024

    256

    MAXRESULTSETMBYTES

    누적 결과 집합이 도달할 최대 크기(MB)입니다. 이 값에 도달하면 결과 집합이 반환됩니다.

    1

    2048

    4

    MAXRESULTSETSECS

    결과 집합을 누적하기 위한 최대 시간 간격(초)입니다. 이 값에 도달하면 결과 집합이 반환됩니다.

    1

    120

    30

    R4Z CDC 서비스 설정

    CDC 서비스 확인: 독립적인 복제 프로세스의 필요성 예측(다른 버전 허용, 충분한 ECSA 메모리 보장, 허용되는 지연 설명 등)을 기반으로 각 LPAR에 존재해야 하는 R4Z CDC 서비스를 확인합니다. 각 서비스에 대해 CDC 서비스 한정자(4자)를 선택합니다. 또한 각 CDC 서비스가 자체 WLM APPLENV(응용 프로그램 환경)를 가질 것인지 아니면 모든 CDC 서비스를 제공하기 위한 단일 APPLENV를 가질 것인지 결정해야 합니다.

    DFSYMLST 구성원의 변수 DEFWLMAE(DEFine WLM Applic. Env.)를 PER(첫 번째 옵션) 또는 ONE(두 번째 옵션)으로 설정해야 합니다. 설정이 완료되면 다음과 같이 설치를 진행할 수 있습니다.

    정보 메모

    • DEFWLMAE에 대해 ONE을 선택하면 DO2* 및 DO3SRVTF 작업이 한 번 실행되어야 합니다. PER을 선택하면 JCL SET 변수 CDCSRV가 CDC 서비스의 한정자로 설정된 후 각 CDC 서비스에 대해 이러한 작업을 실행해야 합니다.

    • 작업 DO3SRVDF는 CONFIG 라이브러리를 만들고 기본 구성 파일 역할을 하는 "CDCS"라는 구성원을 배치합니다. DO3SRVTF 작업을 실행한 후 라이브러리에는 모든 CDC 서비스의 구성이 포함되어 이를 편집하고 특정 CDC 서비스의 구성을 변경할 수 있습니다.

    • ONE이 DEFWLMAE에 사용되면 CONFIG 라이브러리 구성원 대신 제품 기본값이 사용됩니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!

여기에 피드백을 남겨주십시오.