이 샘플에는 EJB 프로젝트(XDCGIVTEJBs) 및 EAR 프로젝트(XDCGIVTEAR)와 연관시킬
XDCGIVT 배치 프로젝트가 포함되어 있습니다. XDCGIVT 애플리케이션은 파일을 읽고 쓰는 트랜잭션
배치 애플리케이션입니다.
시작하기 전에
- 다음 지원 서버 중 하나를 설치하십시오.
- WebSphere® Application
Server V8.5
- WebSphere Application Server V8.0
- WebSphere Application Server V8.0 및 WebSphere Extended Deployment Compute Grid V8.0
- WebSphere Application
Server V7.0 및 Modern Batch용 기능팩.
- 배치 애플리케이션을 허용하도록 WebSphere Application Server를
구성하십시오.
팁: Modern Batch 작업 관리 콘솔을 열 수 없는 경우 애플리케이션 서버에서
아직 배치 애플리케이션을 허용할 준비가 되지 않은 것입니다. 예를 들어,
서버 보기로
이동하려는 경우 서버를 마우스 오른쪽 단추로 클릭하고
Modern Batch 작업 관리 콘솔을
선택하면 다음 오류 메시지 중 하나가 표시될 수 있습니다.
이러한 오류 메시지가
표시되지 않도록 하려면 서버에 대해
배치 애플리케이션을 허용하도록 WebSphere Application Server 구성 태스크를 완료하고
샘플 실행에 대한 정보를 제공하는 이 페이지로 돌아오십시오.
이 태스크 정보
서버에서 샘플을 실행하려면 다음 단계를 수행하십시오.
프로시저
- 서버 보기에서 서버를 추가하여 다음 중에서 이 샘플을 실행할 서버의 지원 버전을
판별하십시오.
- WebSphere Application
Server V7.0
- WebSphere Application
Server V8.0
- WebSphere Application
Server V8.5
- 서버 보기를 열려면 도구 모음으로 이동하여 를 선택하십시오.
- 서버 항목을 추가하려면 서버 보기에서 마우스 오른쪽 단추를 클릭하고 를
선택하십시오. 새 서버 마법사의 지시사항에 따라 WebSphere Application
Server V7.0, WebSphere Application Server V8.0 또는 WebSphere Application Server V8.5 중 하나를
선택하십시오. 자세한 정보는 WebSphere Application Server 작성 주제를 참조하십시오.
- 샘플을 작업공간으로 가져오십시오.
- 제품의 도움말 시스템에서 이 샘플 가져오기 링크를 클릭하여 트랜잭션 배치 애플리케이션 샘플을 작업공간으로
가져오십시오.
- 가져오기 마법사에서 기본 설정을 승인하고 완료를 클릭하십시오.
- WebSphere Application Server V8.0 또는 V8.5에서 이 샘플을 실행하려는 경우 대상 런타임 환경에 대한
기본 설정을 변경해야 합니다. 이 샘플에 대한 기본 환경은 WebSphere Application Server V7.0으로
설정되어 있습니다. 샘플 런타임 대상 설정 마법사는 워크벤치에 WebSphere Application Server V7.0 런타임 환경이
포함되어 있지 않은 경우에만 열립니다.
- 샘플 런타임 대상 설정 마법사가 열리면 워크벤치에 WebSphere Application Server V7.0 런타임
환경이 포함되어 있지 않은 것입니다.
- 샘플을 가져온 후 호환 가능한 런타임 또는 스텁 수동으로 설치 옵션을 선택하고
완료를 클릭하십시오.
- 작업공간 마이그레이션 페이지에서 다음을 클릭하십시오.
- 마이그레이션이 필요한 작업공간 프로젝트 페이지에서 다음을 클릭하십시오.
- 마이그레이션 프로젝트 자원 페이지에서 다음을 클릭하십시오.
- 정의되지 않은 서버 런타임 페이지의 서버 런타임 목록에서 was.base.v7 항목에 대해
새 서버 런타임 열에서 WebSphere Application Server v8.0 또는 WebSphere Application Server v8.5를
선택하십시오. 다음을 클릭하십시오.
- 마이그레이션 시작 완료 페이지에서 완료를 클릭하십시오.
- 마이그레이션 유효성 검증 창에서 확인을 클릭하십시오.
- 샘플 런타임 대상 설정 마법사가 열리지 않으면 워크벤치에 WebSphere Application Server V7.0 런타임
환경이 포함되어 있는 것입니다.
- 엔터프라이즈 탐색기 보기에서 SimpleCIEAR 프로젝트를 마우스 오른쪽 단추로 클릭하고
을 선택하십시오.
- WebSphere Application Server V8.0 또는 WebSphere Application Server V8.5 선택란을 선택하고
확인을 클릭하십시오.
- 가져오기가 완료되면 엔터프라이즈 탐색기 보기에 다음 프로젝트가 표시됩니다.
- 로컬 WebSphere Application Server의 경우 로컬 Derby 데이터베이스에 대한
데이터베이스 연결을 작성하십시오.
중요사항: WebSphere Application Server가 개발 워크벤치와 동일한 컴퓨터에 있는 경우에만
이 단계를 완료하십시오. 원격 WebSphere Application Server의 경우 원격 서버와 동일한 컴퓨터에서
IVTDB 데이터베이스를 작성할 것이므로 로컬 Derby 데이터베이스 연결을 작성하는
이 단계를 건너뛰어야 합니다.
- 데이터 소스 탐색기 보기의 데이터베이스 연결 폴더에서 마우스 오른쪽 단추를 클릭하고
새로 작성을 선택하십시오. 새 연결 마법사가 열립니다.
- 데이터베이스 관리자 선택 목록에서 Derby를 선택하십시오.
- JDBC 드라이버 목록에서 Derby 10.2 - 임베디드 JDBC 드라이버 기본값을 선택하십시오.
- 드라이버 정의 편집(
) 단추를 클릭하십시오. Jar 목록 편집 마법사가 열립니다.
- 드라이버 파일 목록에서 derby.jar 항목을 선택하고
JAR/Zip 제거 단추를 클릭하십시오. 이제 드라이버 파일 목록은 비어 있게 됩니다.
- JAR/Zip 추가 단추를 사용하여 <WAS_directory>\derby\lib 디렉토리에서
다음 네 가지 JAR 파일을 추가하십시오. 여기서 <WAS_directory>는 로컬 WebSphere Application Server에 대한 설치 디렉토리입니다.
그런 다음 확인을 클릭하십시오.
- derby.jar
- derbyclient.jar
- derbynet.jar
- derbytools.jar
Derby JDBC 드라이버 파일을 Jar 목록 편집 마법사에 추가하는 화면 캡처의 예입니다.
- 새 연결 대화 상자에서 데이터베이스 위치 필드의 특성 아래에
<workspace_directory>/XDCGIVT/IVTDB 디렉토리를 지정하십시오. 여기서 <workspace_directory>는
사용자 작업공간의 디렉토리입니다. 완료를 클릭하십시오.
- 데이터 소스 탐색기 보기에서
데이터베이스 연결 폴더를 펼치고 IVTDB를 마우스 오른쪽 단추로 클릭하고 연결 끊기를 선택하십시오.
- 원격 WebSphere Application Server의 경우 원격 서버와 동일한 컴퓨터에서 IVTDB 데이터베이스를
작성하십시오.
중요사항: WebSphere Application Server가 개발 워크벤치가 아닌 원격 컴퓨터에 있는 경우에만 이 단계를
완료하십시오. 로컬 WebSphere Application Server의 경우 이 단계를 건너뛰고 다음 단계로 진행하십시오.
- java –version 명령을 실행하십시오.
이 명령을 실행하면 Java™ 버전 1.6 이상이 설치되어 있고 운영 체제의 PATH 경로에 포함되어 있는지 확인할 수 있습니다.
- CreateIVTTablesDerby.ddl 파일을 찾으십시오.
- 명령 프롬프트를 열고 Derby 데이터베이스 디렉토리로 변경하십시오.




<remote_WAS_directory>/derby/databases
<remote_WAS_directory>\derby\databases
- 다음 명령을 실행하십시오.





java -Djava.ext.dirs=<remote_WAS_directory>/derby/lib
-Dij.protocol=jdbc:derby: org.apache.derby.tools.ij
<path>/CreateIVTTablesDerby.ddl
여기서
<remote_WAS_directory>는
원격 WebSphere Application Server의 설치 디렉토리이고, <
path>는 원격 서버와 동일한 컴퓨터에 있는
CreateIVTTablesDerby.ddl 파일에 대한 디렉토리 경로입니다.
예를 들어, 다음과 같습니다.
java -Djava.ext.dirs=/opt/IBM/WebSphere/AppServer/derby/lib
-Dij.protocol=jdbc:derby: org.apache.derby.tools.ij
/opt/IBM/WebSphere/AppServer/feature_packs/BATCH/longRunning/CreateIVTTablesDerby.ddl
팁: 파일 경로에 공백이 포함될 경우
파일 경로에서 공백을 이스케이프해야 합니다.
java -Djava.ext.dirs=<remote_WAS_directory>\derby\lib
-Dij.protocol=jdbc:derby: org.apache.derby.tools.ij
<remote_WAS_directory>\feature_packs\BATCH\longRunning\CreateIVTTablesDerby.ddl
여기서
<remote_WAS_directory>는 원격 WebSphere Application Server의
설치 디렉토리입니다.
예를 들어, 다음과 같습니다.
java -Djava.ext.dirs="C:\Program Files\IBM\WebSphere\AppServer\derby\lib"
-Dij.protocol=jdbc:derby: org.apache.derby.tools.ij
"C:\Program Files\IBM\WebSphere\AppServer\feature_packs\BATCH\longRunning\CreateIVTTablesDerby.ddl"
팁: 파일 경로에 공백이 포함될 경우
따옴표로 파일 경로를 묶어야 합니다.
- 배치 디스크립터에서 데이터 소스를 구성하십시오.
- 엔터프라이즈 탐색기 보기에서 XDCGIVTEAR 프로젝트를 펼치고
배치 디스크립터: XDCGIVTEAR를 마우스 오른쪽 단추로 클릭하고 열기를
선택하십시오. 애플리케이션 배치 디스크립터 편집기가 열립니다.
- 배치 탭을 선택하십시오.
- 데이터 소스 섹션 아래의 위에서 선택한 데이터 소스에 정의된 자원 특성 목록에서
데이터베이스 이름을 선택하고 편집 단추를 클릭하십시오. 자원 특성
편집 마법사가 열립니다.
- 값 필드에서 IVTDB 데이터베이스에 대한 파일 경로를
지정하십시오. 파일 경로는 데이터베이스가 로컬 또는 원격 WebSphere Application Server용으로 작성되었는지와
서버 및 데이터베이스를 실행하는 운영 체제에 따라 달라집니다.
- 로컬 WebSphere Application Server의 경우
<workspace_directory>/XDCGIVT/IVTDB
<workspace_directory>\XDCGIVT\IVTDB
- 여기서 <workspace_directory>는 사용자 작업공간의 디렉토리입니다.
- 원격 WebSphere Application Server의 경우




<remote_WAS_directory>/derby/databases/IVTDB
<remote_WAS_directory>\derby\databases\IVTDB
- 여기서 <remote_WAS_directory>는 원격 WebSphere Application Server의
설치 디렉토리입니다.
- 확인 단추를 클릭하십시오.
- Ctrl+S를 눌러 애플리케이션 배치 디스크립터 편집기의 변경사항을 저장하십시오.
- 샘플을 실행하려면 입력 값을 수정하십시오.
팁: XDCGIVT 샘플에 포함된 각 배치 작업 파일에 대해 이 단계를
반복해야 합니다.
- 엔터프라이즈 탐색기에서 폴더를 펼치십시오. 다음 배치 작업 파일을 찾게 됩니다.
- XDCGIVTbyte2bytexJCL.xml
- 바이트 파일을 다른 바이트 파일에 복사하고 두 파일을 비교합니다.
- XDCGIVTtxt2db2txtxJCL.xml
- 텍스트 파일을 데이터베이스에 복사하고 데이터베이스의 항목을 다른 텍스트 파일에
복사하고 두 파일을 비교합니다.
- XDCGIVTtxt2txtxJCL.xml
- 텍스트 파일을 다른 텍스트 파일에 복사하고 두 파일을 비교합니다.
작업은 xJCL(XML Job Control Language)이라고 하는 XML(Extensible Markup Language) 통용어를
사용하여 표현됩니다. 모든 작업에는 다음 정보가 포함됩니다.
- 작업을 수행하는 배치 애플리케이션의 ID
- 작업을 완료하기 위해 수행해야 할 하나 이상의 작업 단계
- 각 작업 단계마다 논리를 제공하는 애플리케이션 내의 아티팩트 ID
- 애플리케이션 아티팩트에 추가 컨텍스트를 제공하는
각 작업 단계의 키 및 값 쌍
자세한 정보는 WebSphere Application Server의 Information Center에서 사용할 수 있는
배치 애플리케이션, 작업 및 작업 정의 주제를 참조하십시오.
- 위의 배치 작업 파일 중 하나를 마우스 오른쪽 단추로 클릭하고 열기를 선택하십시오. XJCL 편집기가 열립니다.
- XJCL 편집기의 디자인 탭에 있는 배치 작업 구조 섹션 아래에서
노드를 펼치십시오.
대체 특성은 기호 변수에 대한 이름 및 값 쌍을 정의합니다. xJCL 파일에서 기호 변수는
${variable-name} 형식의 표현식이며, 이는 올바른 형식의 문서의 주석 외부에
있습니다. 기호 변수의 대체는 런타임 시 발생합니다. 런타임 시에는 ${variable-name} 문자열이
xJCL 파일 발행 시 특성 값으로 바뀝니다.
각 배치 작업 파일에는 수정 시 필요한 두 개의 대체 특성이 있습니다(
inputDataStream 및
outputDataStream).
표 1. . 다음 표에는 inputDataStream 및 outputDataStream 대체 특성에 대해 지정된 기본값이 나열되어 있습니다.| |
inputDataStream |
outputDataStream |
| XDCGIVTbyte2bytexJCL.xml |
/data/input-txlist.txt |
/data/output-txlist.txt |
| XDCGIVTtxt2db2txtxJCL.xml |
/data/input.txt |
/data/output.txt |
| XDCGIVTtxt2txtxJCL.xml |
/data/input-text.txt |
/data/output-text.txt |
위의 표에는
inputDataStream 및
outputDataStream 대체 특성에 대해 지정된
기본값이 나열되어 있습니다.
/data/는 읽기 및 쓰기 권한을 가진 파일 시스템의
기존 디렉토리(이 샘플 실행 시 텍스트 파일을 작성할 위치)로 대체해야 합니다(예:
C:\temp\input.txt).
팁: 텍스트 파일의 파일 이름은 작업 이름 및 작업 번호에
붙습니다. WebSphere Application Server for z/OS®의 경우, 컨텐츠를 볼 수 있도록
텍스트 파일을 EBCDIC(Extended Binary Coded Decimal Interchange Code)로 변환해야 합니다.
- XJCL 편집기에서 특성(inputDataStream) 노드를 선택하십시오(특성(outputDataStream)에 대해
이 단계 반복 ). 세부사항 섹션 아래의 값 필드에서 /data/를
파일 시스템 디렉토리의 기존 디렉토리로 바꾸십시오(예: C:\temp\input-txlist.txt).
- CTRL+S를 눌러 XJCL 편집기의 변경사항을 저장하십시오.
- 서버에서 샘플을 실행하려면 다음을 수행하십시오.
- 서버 보기에서 서버를 마우스 오른쪽 단추로 클릭한 후 시작을 선택하십시오. 서버 보기에서 상태와 시작됨 및 동기화됨으로의 서버 변경 상태를
확인하여 서버 시작을 대기하십시오.
- 서버 보기에서 서버를 마우스 오른쪽 단추로 클릭한 후 추가 및 제거를
선택하십시오. 추가 및 제거 마법사가 열립니다. 사용 가능 목록 아래에서
XDCGIVTEAR 애플리케이션을 선택하고 추가 단추를
클릭하십시오. 추가 및 제거 마법사에서 완료 단추를 클릭하십시오. 서버 보기에서 상태와 시작됨 및 동기화됨으로의 애플리케이션 변경 상태를
확인하여 애플리케이션 공개 및 시작을 대기하십시오.
- 엔터프라이즈 탐색기 보기에서 폴더를 펼치고 XDCGIVT 배치 작업 파일 중 하나를
마우스 오른쪽 단추로 클릭하고 을 선택하십시오. 구성 실행 마법사가 열립니다.
- 보안이 사용으로 설정된 경우 서버가 안전하도록 서버에서 보안 사용 선택란을
선택하십시오. 사용자 ID 필드 및 비밀번호 필드에서 작업 스케줄러의
사용자 이름 및 비밀번호를 지정하십시오.
팁: 관리 콘솔을 열어 어떤 사용자 또는 그룹이 보안 역할 lradmin 및 lrsubmitter에
맵핑되는지 찾고 을
선택할 수 있습니다.
- 구성 실행 마법사에서 실행 단추를 클릭하여 배치 작업 파일을 실행하십시오. Modern Batch
작업 관리 콘솔이 열립니다.
- 작업을 확인하고 Modern Batch 작업 관리 콘솔에 로그인하십시오.
- Modern Batch 작업 관리 콘솔에서 작업 관리 섹션 아래의 왼쪽 분할창에서
작업 보기 링크를 클릭하십시오. 제출된 작업이 나열된 작업 테이블이 표시됩니다.
- 작업 ID 열 아래에서 XDCGIVT:<jobID> 링크를
클릭하십시오. 작업 로그가 표시됩니다. 다운로드 단추를 클릭하여 작업 로그의 사본을 열거나 복사할 수 있습니다.
작업 로그에는 다음 정보가 포함되어 있습니다.
- 작업을 실행하는 데 사용된 xJCL 파일의 사본(xJCL 대체 값 포함).
- 작업에 해당하는 기본 라이프사이클 이벤트와 통신하는 시스템 메시지
세트. 작업 로그에 기록되는 시스템 이벤트의 예는 작업의 시작과 종료, 그리고
단계입니다.
- 작업 단계 프로그램에 의해 표준 출력 및 표준 오류에 작성된
메시지 세트.
작업 로그에 대한 자세한 정보는 WebSphere Application
Server의 Information Center에서 사용할 수 있는
작업 로그 주제를 참조하십시오.