일괄처리 작업을 위한 명령행 인터페이스
명령행 인터페이스는 작업 스케줄러와 상호 작용하여 일괄처리 작업를 제출하고 조작합니다. app_server_root/bin 디렉토리에 lrcmd.sh or lrcmd.bat 스크립트로 존재하며 WebSphere® 셀의 임의 위치에서 시작할 수 있습니다.
lrcmd 스크립트를 사용하여 다음 명령을 수행할 수 있습니다.
명령 | 인수 | 설명 | 추가 정보 |
---|---|---|---|
lrcmd에 대한 사용법 정보를 표시하십시오. | 없음 | 이 명령은 lrcmd 명령에 대한 사용법 정보를 표시합니다. | 예제: lrcmd |
작업 스케줄러에 작업을 제출합니다. |
|
xJCL(XML Job Control Language) 파일이 지정되면, -xJCL=<xjcl_filename>은
파일 시스템에서 제출되고 선택적으로 저장할 xJCL의 경로를 지정합니다. 선택적 인수:
명령의 두 변형은 제출된 작업의 작업 ID를 리턴합니다. |
예제:
|
이전에 제출한 작업을 취소하십시오. |
|
이 명령은 이전에 제출된 작업의 시작을
취소하거나 실행 중인 작업의 실행을 취소합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. 선택적
인수:
|
예:
lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
작업을 다시 시작하십시오. |
|
이 명령은 취소된 작업을 다시 시작합니다. 다시 시작 가능한
상태의 작업만 다시 시작할 수 있습니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. 선택적
인수:
|
일괄처리 애플리케이션과 연관된 일괄처리 작업만
다시 시작할 수 있습니다. -cmd=cancel 명령을 사용하여 일괄처리
작업을 취소하면 해당 상태가 다시 시작 가능으로 변경됩니다. 작업이 다시 시작되면 마지막으로 커미트된 체크포인트부터 처리가 재개됩니다. 예: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
작업 정보를 제거하십시오. |
|
이 명령은 작업 스케줄러 및 눈금 엔드포인트에서 작업 정보를 제거합니다. 작업 스케줄러는 작업이 완료된 이후에 작업에 대한 정보를 유지보수합니다. 제거 명령은 작업 스케줄러 및 그리드 엔드포인트 데이터베이스에서 작업 정보를 영구적으로 삭제합니다. 이 명령은 작업의 작업 로그도 제거합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. 선택적
인수:
|
작업 스케줄러는
작업이 완료된 이후에 작업에 대한 정보를 유지보수합니다. purge 명령은
작업 스케줄러 및 눈금 엔드포인트 데이터베이스에서 작업 정보를 영구적으로 삭제합니다.
이 명령은 작업의 작업 로그도 제거합니다. 예: lrcmd -cmd=purge -jobid=myjob:2 |
작업 저장소로 xJCL을 저장하십시오. |
|
이 명령은 장래 -cmd=submit
명령이 사용할 작업 저장소에 xJCL 문서를 저장합니다.
선택적 인수:
|
예제:
|
작업 저장소에서 작업을 제거하십시오. |
|
이 명령은 이전에 저장된 xJCL 문서를 작업 저장소에서
제거합니다. -job=<job_name>을 사용하여 이전에 작업 저장소에 파일을 저장한 경우 작업에 지정된 이름을 지정합니다.
|
예:
lrcmd -cmd=remove -jobid=myjob:2 -host=myhost -port=9083 |
일괄처리 작업의 상태를 표시하십시오. |
or
|
이 명령은
작업 스케줄러 데이터베이스에 있는 하나 이상의 작업에 대한 상태 정보를 표시합니다. 선택적 인수: -job=<jobid>를 지정하면 지정된 작업에 대한 작업 정보만 표시됨을 나타냅니다. |
예제:
|
작업을 일시중단하십시오. |
|
이 명령은 지정된 시간(초) 동안 그리드
일괄처리 작업의 시작을 일시중지합니다. 수동으로 재개(예: lrcmd -cmd=resume 사용)하지 않은 경우,
지정된 시간(초)이 경과하면 작업이 자동으로 재개됩니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. 선택적 인수: -seconds=<seconds>를 사용하여 작업 시작이 일시중지되는 시간(초)을 나타냅니다. 지정되지 않은 경우 기본값으로 15초를 설정합니다. -seconds=0을 지정하면 수동으로 재개할 때까지 작업이 시작되지 않습니다.
|
예제: lrcmd -cmd=submit -xJCL=myxjcl.xml(작업 ID myjob:23 리턴). myjob:23 작업의 실행이 시작된 후, 예를 들어 lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 -port=81 -host=myODRHost를 사용하면 5분 동안 일시중지됩니다. 5분이 경과하기 전에 lrcmd -cmd=resume -jobid=myjob:23을 사용하면 작업 실행이 재개됩니다. |
이전에 일시중단한 작업의 시작을 재개하십시오. |
|
이 명령은 이전에 일시중단한 일괄처리 작업의
시작을 재개합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. |
-cmd=suspend에 대한 설명을 참조하십시오. |
작업에 대한 출력을 표시하십시오. |
|
지정된 작업이 실행되는 동안 작업 스케줄러 및 눈금 엔드포인트에서 생성한
출력을 표시합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. |
(없음) |
일괄처리 작업의 리턴 코드를 표시하십시오. |
|
그리드 일괄처리 작업에서 생성한
전체 리턴 코드를 표시합니다. -jobid=<jobid>를
작업 스케줄러가 작업에 지정한 ID로 사용합니다. 작업 ID는
lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를
식별하는 데에도 사용할 수 있습니다.
|
(없음) |
작업 스케줄러에 반복 작업 요청을 제출하십시오. |
or
|
작업 스케줄러에 반복 작업 요청을 제출하십시오.
작업 스케줄러가 인수로 표시된 간격으로 지정된 xJCL에 대해
일괄처리 작업를 제출합니다.
선택적
인수:
|
예제:
|
기존의 반복 작업 요청을 수정하십시오. |
|
Arguments:
선택적 인수:
|
예제: lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -xJCL=C:\\myNewXJCL -port=80 lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\myFebXJCL -port=80 |
명령 | 인수 | 설명 | 추가 정보 |
---|---|---|---|
lrcmd에 대한 사용법 정보를 표시하십시오. | 없음 | 이 명령은 lrcmd 명령에 대한 사용법 정보를 표시합니다. | 예제: lrcmd |
이전에 제출한 작업의 실행을 중지하십시오. |
|
이 명령은 체크포인트가 발생한 경우 이전에 제출한
작업의 실행을 중지합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 선택적
인수:
|
예제:
|
작업 정의 xJCL에 참조되는 기호 변수를 표시합니다. |
|
이 명령은 작업 정의 xJCL에 참조되는
기호 변수를 표시합니다. -jobid=<jobid>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 선택적
인수:
|
예제:
|
작업 로그를 저장하십시오. |
|
이 명령은 요청된 작업 ID와 연관된 작업 로그를
로컬 파일 시스템에 저장합니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -fileName=<fileName>을 사용하여 압축 작업 로그 데이터가 저장되는 로컬 파일 시스템에서 파일의 이름을 나타냅니다. 이 파일은 존재할 경우 바뀝니다. 파일 이름 <fileName>에 삽입된 공백이 포함되지 않을 수 있습니다. 선택적 인수:
|
예제:
|
작업 로그를 가져오십시오. |
|
요청된 작업 ID와 연관된 작업 로그를
표시합니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. 선택적 인수:
|
예제:
|
작업 로그를 제거하십시오. |
|
요청된 작업 ID 및 로그 시간소인과 연관된
작업 로그를 제거합니다. 작업 로그 항목은 유지됩니다(예:
/opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log).
이 항목은 작업 로그가 제거된 이유를 추적합니다.
|
예제:
|
요청된 작업 ID에 대한 작업 로그 메타데이터를 표시하십시오. |
|
작업 로그 메타데이터는 요청된 작업 ID와 연관된
로그 시간소인을 표시합니다. 메타데이터 또는 시간소인은
작업의 고유한 인스턴스를 식별합니다. 작업 번호가 동일한 서로
다른 여러 작업의 로그가 존재할 수 있습니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. |
예제:
|
작업 로그 파트 목록을 표시하십시오. |
|
요청된 작업 ID 및 로그 시간소인과 연관된
작업 로그 파트 목록을 표시합니다. getLogMetaData 명령을 사용하여
-logTimeStamp=<timestamp>에 사용할 시간소인을 리턴합니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. |
예제:
|
작업 로그 파트를 표시하십시오. |
|
요청된 작업 ID, 로그 시간소인 및 로그 파트와 연관된
작업 로그 파트를 표시합니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -logTimeStamp=<logTimeStamp>를 사용하여 파트 목록 정보가 리턴되는 작업 로그를 식별하는 시간소인(서브디렉토리 이름)을 나타냅니다. 시간소인은 -cmd=getLogMetaData가 리턴합니다. -logPart=<logPart>를 사용하여 요청된 작업 ID 및 시간소인과 연관된 작업 로그에서 리턴되는 부분을 나타냅니다. 로그 파트 정보는 -cmd=getLogPartList에 의해 리턴됩니다. |
예제:
|
요청된 작업 ID와 연관된 작업 로그 크기를 표시하십시오. |
|
이 명령은 작업 로그인의 크기(바이트)를 리턴합니다. -jobid=<job_id>를 작업 스케줄러가 작업에 지정한 작업 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -logTimeStamp=<logTimeStamp>를 사용하여 파트 목록 정보가 리턴되는 작업 로그를 식별하는 시간소인(즉, 서브디렉토리 이름)을 나타냅니다. 시간소인은 -cmd=getLogMetaData가 리턴합니다. |
예제:
|
작업 로그가 마지막으로 수정된 이후의 작업 로그 유효 기간(초)을 리턴합니다. |
|
요청된 작업 ID와 연관된 작업 로그의
-jobid=<jobid>를 작업 스케줄러가 작업에 지정한 ID로 사용합니다. 작업 ID는 lrcmd -cmd=submit 명령으로 초기에 작업을 제출할 때 리턴된 값입니다. -cmd=status 명령은 특정 작업의 작업 ID를 식별하는 데에도 사용할 수 있습니다. -logTimeStamp=<logTimeStamp>를 사용하여 파트 목록 정보가 리턴되는 작업 로그를 식별하는 시간소인(즉, 서브디렉토리 이름)을 나타냅니다. 시간소인은 -cmd=getLogMetaData가 리턴합니다. |
예제:
|
일괄처리 작업 출력 검색의 예:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
예 결과:
CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63
CWLRB5000I: Wed Jun 15 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : response to output
CWLRB1740I: [Wed Jun 15 17:55:36 EDT 2005] Job [mybatchjob:63] is in job setup.
CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] is submitted for execution.
CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step setup.
CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is dispatched.
CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step breakdown.
CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] completed normally rc=0.
CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step setup.
CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is dispatched.
CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step breakdown.
CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] completed normally rc=4.
End