콘텐츠로 이동

Interactive Mode Guide

1. 개요

Datatrans는 실행 인자 없이 시작하면 **대화형(Interactive) 모드**로 진입합니다.

Interactive 모드에서는 작업 조회, 연결, 상태 확인, 중단, 재개, 강제 종료 등 운영에 필요한 제어를 수행할 수 있습니다.

  • 기본 프롬프트: DATATRANS>
  • 특정 작업 연결 시: DATATRANS:JOBNAME>

현재 어떤 작업에 연결되어 있는지는 프롬프트에서 바로 확인할 수 있습니다.


2. 입력 방식

Interactive 명령은 아래 두 가지 방식 중 하나로 입력할 수 있습니다.

2.1 단일 명령어 방식

HELP
JOB_LIST
STATUS
START_JOB
QUIT

2.2 key=value 방식

CONTINUE_JOB=JOBNAME
STOP_JOB=JOBNAME
KILL_JOB=JOBNAME
STATUS=JOBNAME
HELP=Y
ACTIVATE=Y

3. 명령어 목록

3.1 HELP / ?

사용 가능한 실행 방법과 Interactive 명령어 목록을 출력합니다.

HELP, ?, HELP=Y는 동일하게 동작합니다.

HELP
?
HELP=Y

3.2 JOB_LIST

Datatrans가 관리 중인 작업 목록을 조회합니다.

출력 정보:

항목 설명
JOBNAME 작업 이름
상태 RUNNING, STOPPED, COMPLETED, KILL_REQUESTED
DEGREE 병렬 처리 수준
LAST_TRXN 마지막 트랜잭션
STOP / KILL 플래그 중지/종료 요청 상태
SOURCE / TARGET 연결 정보
JOB_LIST

운영 팁

상세 상태 확인은 STATUS=JOBNAME과 함께 사용하는 것을 권장합니다.


3.3 CONTINUE_JOB=JOBNAME

지정한 작업에 연결합니다.

연결에 성공하면 프롬프트가 DATATRANS:JOBNAME> 형태로 변경됩니다.

CONTINUE_JOB=SALES_MIG_01

주의사항

  • 작업이 존재하지 않으면 연결되지 않습니다.
  • 이후 STOP_JOB, START_JOB, STATUS는 현재 연결된 작업 기준으로 동작합니다.

3.4 STATUS / STATUS=JOBNAME

작업 진행 상태를 조회합니다.

  • STATUS=JOBNAME: 지정한 작업 상태 조회
  • STATUS: 현재 연결된 작업 상태 조회

전체 작업 기준 출력 정보:

  • 상태 (RUNNING, STOPPED, COMPLETED, KILL_REQUESTED)
  • 현재 병렬도
  • 남은 데이터 용량
  • 누적 완료 용량

Worker 기준 출력 정보:

  • Process Name
  • State (EXECUTING, COMPLETED)
  • Remain Data Size
STATUS=SALES_MIG_01
STATUS

권장 사항

운영에서는 STATUS=JOBNAME 형식을 우선 권장합니다. STATUS 단독 명령은 현재 연결된 작업이 있다는 전제로 동작합니다.


3.5 STOP_JOB / STOP_JOB=JOBNAME

실행 중인 작업을 일시 중단합니다.

  • 내부적으로 stop_job=True 설정
  • 새로운 작업 할당 중단
STOP_JOB=SALES_MIG_01
STOP_JOB

주의사항

  • 현재 작업에 연결되지 않은 상태에서 STOP_JOB만 입력하면 오류 메시지가 출력될 수 있습니다.
  • 안전한 중단을 위해 실행 전에 STATUS로 상태를 먼저 확인하는 것을 권장합니다.

3.6 START_JOB

중단된 작업을 재개합니다.

  • 내부적으로 stop_job=False 설정
  • Worker 할당 재개

사용 절차:

CONTINUE_JOB=SALES_MIG_01
START_JOB

중요 사항

START_JOB=JOBNAME 형식은 지원하지 않습니다. 반드시 먼저 CONTINUE_JOB=JOBNAME으로 연결한 뒤 실행해야 합니다.


3.7 KILL_JOB / KILL_JOB=JOBNAME

작업을 강제로 종료합니다.

  • kill_job=True 설정
  • 작업 및 프로세스 강제 종료
  • 연결 해제
KILL_JOB=SALES_MIG_01
KILL_JOB

주의사항

  • 강제 종료 후에는 작업 복구가 불가능할 수 있습니다.
  • 현재 작업에 연결되지 않은 상태에서 KILL_JOB만 입력하면 오류 메시지가 출력될 수 있습니다.

3.8 JOB_CLEANUP

종료된 작업 메타데이터를 정리합니다.

  • 삭제 여부 확인
  • ERASED / SKIPPED / RUNNING 상태 구분 출력
JOB_CLEANUP

사용 목적:

  • 완료된 작업 흔적 정리
  • 디스크 공간 관리

3.9 ACTIVATE / ACTIVATE=Y

라이선스 인증 절차를 실행합니다.

ACTIVATE
ACTIVATE=Y

3.10 VERSION

현재 프로그램 버전을 출력합니다.

VERSION

3.11 QUIT / EXIT

Interactive 쉘을 종료합니다.

QUIT
EXIT

주의사항

  • 작업 제어 명령이 아닙니다.
  • 실행 중인 작업을 중지하려면 STOP_JOB 또는 KILL_JOB를 사용해야 합니다.
  • Ctrl+C는 즉시 종료되지 않을 수 있습니다.

4. 권장 사용 시나리오

4.1 상태 확인

JOB_LIST
STATUS=SALES_MIG_01

4.2 작업 중단 후 재개

CONTINUE_JOB=SALES_MIG_01
STOP_JOB
START_JOB

4.3 작업 강제 종료

KILL_JOB=SALES_MIG_01

5. 주요 주의사항 요약

# 주의사항
1 STATUS 단독 사용은 현재 연결된 작업이 있어야 합니다.
2 START_JOB=JOBNAME 형식은 지원하지 않습니다.
3 QUITEXIT는 작업 종료 명령이 아니라 쉘 종료 명령입니다.
4 작업을 안전하게 멈추려면 STOP_JOB 사용을 우선 검토하고, 즉시 종료가 필요할 때만 KILL_JOB를 사용하십시오.