Interactive Mode Guide¶
1. 개요¶
Datatrans는 실행 인자 없이 시작하면 **대화형(Interactive) 모드**로 진입합니다.
Interactive 모드에서는 작업 조회, 연결, 상태 확인, 중단, 재개, 강제 종료 등 운영에 필요한 제어를 수행할 수 있습니다.
- 기본 프롬프트:
DATATRANS> - 특정 작업 연결 시:
DATATRANS:JOBNAME>
현재 어떤 작업에 연결되어 있는지는 프롬프트에서 바로 확인할 수 있습니다.
2. 입력 방식¶
Interactive 명령은 아래 두 가지 방식 중 하나로 입력할 수 있습니다.
2.1 단일 명령어 방식¶
2.2 key=value 방식¶
3. 명령어 목록¶
3.1 HELP / ?¶
사용 가능한 실행 방법과 Interactive 명령어 목록을 출력합니다.
HELP, ?, HELP=Y는 동일하게 동작합니다.
3.2 JOB_LIST¶
Datatrans가 관리 중인 작업 목록을 조회합니다.
출력 정보:
| 항목 | 설명 |
|---|---|
| JOBNAME | 작업 이름 |
| 상태 | RUNNING, STOPPED, COMPLETED, KILL_REQUESTED |
| DEGREE | 병렬 처리 수준 |
| LAST_TRXN | 마지막 트랜잭션 |
| STOP / KILL 플래그 | 중지/종료 요청 상태 |
| SOURCE / TARGET | 연결 정보 |
운영 팁
상세 상태 확인은 STATUS=JOBNAME과 함께 사용하는 것을 권장합니다.
3.3 CONTINUE_JOB=JOBNAME¶
지정한 작업에 연결합니다.
연결에 성공하면 프롬프트가 DATATRANS:JOBNAME> 형태로 변경됩니다.
주의사항
- 작업이 존재하지 않으면 연결되지 않습니다.
- 이후
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=JOBNAME 형식을 우선 권장합니다. STATUS 단독 명령은 현재 연결된 작업이 있다는 전제로 동작합니다.
3.5 STOP_JOB / STOP_JOB=JOBNAME¶
실행 중인 작업을 일시 중단합니다.
- 내부적으로
stop_job=True설정 - 새로운 작업 할당 중단
주의사항
- 현재 작업에 연결되지 않은 상태에서
STOP_JOB만 입력하면 오류 메시지가 출력될 수 있습니다. - 안전한 중단을 위해 실행 전에
STATUS로 상태를 먼저 확인하는 것을 권장합니다.
3.6 START_JOB¶
중단된 작업을 재개합니다.
- 내부적으로
stop_job=False설정 - Worker 할당 재개
사용 절차:
중요 사항
START_JOB=JOBNAME 형식은 지원하지 않습니다. 반드시 먼저 CONTINUE_JOB=JOBNAME으로 연결한 뒤 실행해야 합니다.
3.7 KILL_JOB / KILL_JOB=JOBNAME¶
작업을 강제로 종료합니다.
kill_job=True설정- 작업 및 프로세스 강제 종료
- 연결 해제
주의사항
- 강제 종료 후에는 작업 복구가 불가능할 수 있습니다.
- 현재 작업에 연결되지 않은 상태에서
KILL_JOB만 입력하면 오류 메시지가 출력될 수 있습니다.
3.8 JOB_CLEANUP¶
종료된 작업 메타데이터를 정리합니다.
- 삭제 여부 확인
- ERASED / SKIPPED / RUNNING 상태 구분 출력
사용 목적:
- 완료된 작업 흔적 정리
- 디스크 공간 관리
3.9 ACTIVATE / ACTIVATE=Y¶
라이선스 인증 절차를 실행합니다.
3.10 VERSION¶
현재 프로그램 버전을 출력합니다.
3.11 QUIT / EXIT¶
Interactive 쉘을 종료합니다.
주의사항
- 작업 제어 명령이 아닙니다.
- 실행 중인 작업을 중지하려면
STOP_JOB또는KILL_JOB를 사용해야 합니다. Ctrl+C는 즉시 종료되지 않을 수 있습니다.
4. 권장 사용 시나리오¶
4.1 상태 확인¶
4.2 작업 중단 후 재개¶
4.3 작업 강제 종료¶
5. 주요 주의사항 요약¶
| # | 주의사항 |
|---|---|
| 1 | STATUS 단독 사용은 현재 연결된 작업이 있어야 합니다. |
| 2 | START_JOB=JOBNAME 형식은 지원하지 않습니다. |
| 3 | QUIT과 EXIT는 작업 종료 명령이 아니라 쉘 종료 명령입니다. |
| 4 | 작업을 안전하게 멈추려면 STOP_JOB 사용을 우선 검토하고, 즉시 종료가 필요할 때만 KILL_JOB를 사용하십시오. |