트랜잭션 배치 애플리케이션 설정 지시사항

이 샘플에는 EJB 프로젝트(XDCGIVTEJBs) 및 EAR 프로젝트(XDCGIVTEAR)와 연관시킬 XDCGIVT 배치 프로젝트가 포함되어 있습니다. XDCGIVT 애플리케이션은 파일을 읽고 쓰는 트랜잭션 배치 애플리케이션입니다.

시작하기 전에

  1. 다음 지원 서버 중 하나를 설치하십시오.
    • 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용 기능팩.
  2. 배치 애플리케이션을 허용하도록 WebSphere Application Server를 구성하십시오.
    팁: Modern Batch 작업 관리 콘솔을 열 수 없는 경우 애플리케이션 서버에서 아직 배치 애플리케이션을 허용할 준비가 되지 않은 것입니다. 예를 들어, 서버 보기로 이동하려는 경우 서버를 마우스 오른쪽 단추로 클릭하고 Modern Batch 작업 관리 콘솔을 선택하면 다음 오류 메시지 중 하나가 표시될 수 있습니다.
    • WebSphere Application Server V8.0 또는 V8.5의 경우:
      The webpage cannot be found
    • WebSphere Application Server V7.0 및 Modern Batch용 기능팩의 경우:
      404 error:  JSPG0036E: Failed to find resource /jmc/console.jsp
    이러한 오류 메시지가 표시되지 않도록 하려면 서버에 대해 배치 애플리케이션을 허용하도록 WebSphere Application Server 구성 태스크를 완료하고 샘플 실행에 대한 정보를 제공하는 이 페이지로 돌아오십시오.

이 태스크 정보

서버에서 샘플을 실행하려면 다음 단계를 수행하십시오.

프로시저

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

      이 명령을 실행하면 Java™ 버전 1.6 이상이 설치되어 있고 운영 체제의 PATH 경로에 포함되어 있는지 확인할 수 있습니다.

    2. CreateIVTTablesDerby.ddl 파일을 찾으십시오.
      • WebSphere Application Server V7.0 및 Modern Batch용 기능팩의 경우, CreateIVTTablesDerby.ddl 파일의 사본을 원격 컴퓨터의 다음 디렉토리에서 사용할 수 있습니다.

        Linux의 그래픽 아이콘HP-UX의 그래픽 아이콘Solari의 그래픽 아이콘AIX의 그래픽 아이콘z/OS의 그래픽 아이콘<remote_WAS_directory>/feature_packs/BATCH/longRunning

        Windows의 그래픽 아이콘 <remote_WAS_directory>\feature_packs\BATCH\longRunning

        여기서 <remote_WAS_directory>는 원격 WebSphere Application Server의 설치 디렉토리입니다.
      • 또는 워크벤치를 실행 중인 로컬 컴퓨터에서 CreateIVTTablesDerby.ddl 파일의 로컬 사본을 <workspace_directory>\XDCGIVT\data\ddl\CreateIVTTablesDerby.ddl에서 찾을 수 있습니다. 여기서 <workspace_directory>는 작업공간의 디렉토리입니다. 원격 서버와 동일한 컴퓨터에 CreateIVTTablesDerby.ddl 파일의 사본을 작성하십시오.
    3. 명령 프롬프트를 열고 Derby 데이터베이스 디렉토리로 변경하십시오.

      Linux의 그래픽 아이콘HP-UX의 그래픽 아이콘Solari의 그래픽 아이콘AIX의 그래픽 아이콘z/OS의 그래픽 아이콘<remote_WAS_directory>/derby/databases

      Windows의 그래픽 아이콘 <remote_WAS_directory>\derby\databases

    4. 다음 명령을 실행하십시오.
      Linux의 그래픽 아이콘HP-UX의 그래픽 아이콘Solari의 그래픽 아이콘AIX의 그래픽 아이콘z/OS의 그래픽 아이콘
      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
      팁: 파일 경로에 공백이 포함될 경우 파일 경로에서 공백을 이스케이프해야 합니다.
      Windows의 그래픽 아이콘
      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"
      팁: 파일 경로에 공백이 포함될 경우 따옴표로 파일 경로를 묶어야 합니다.
  5. 배치 디스크립터에서 데이터 소스를 구성하십시오.
    1. 엔터프라이즈 탐색기 보기에서 XDCGIVTEAR 프로젝트를 펼치고 배치 디스크립터: XDCGIVTEAR를 마우스 오른쪽 단추로 클릭하고 열기를 선택하십시오. 애플리케이션 배치 디스크립터 편집기가 열립니다.
    2. 배치 탭을 선택하십시오.
    3. 데이터 소스 섹션 아래의 위에서 선택한 데이터 소스에 정의된 자원 특성 목록에서 데이터베이스 이름을 선택하고 편집 단추를 클릭하십시오. 자원 특성 편집 마법사가 열립니다.
    4. 필드에서 IVTDB 데이터베이스에 대한 파일 경로를 지정하십시오. 파일 경로는 데이터베이스가 로컬 또는 원격 WebSphere Application Server용으로 작성되었는지와 서버 및 데이터베이스를 실행하는 운영 체제에 따라 달라집니다.
      로컬 WebSphere Application Server의 경우
      Linux의 그래픽 아이콘<workspace_directory>/XDCGIVT/IVTDB
      Windows의 그래픽 아이콘<workspace_directory>\XDCGIVT\IVTDB
      여기서 <workspace_directory>는 사용자 작업공간의 디렉토리입니다.
      원격 WebSphere Application Server의 경우
      Linux의 그래픽 아이콘HP-UX의 그래픽 아이콘Solari의 그래픽 아이콘AIX의 그래픽 아이콘z/OS의 그래픽 아이콘<remote_WAS_directory>/derby/databases/IVTDB
      Windows의 그래픽 아이콘<remote_WAS_directory>\derby\databases\IVTDB
      여기서 <remote_WAS_directory>는 원격 WebSphere Application Server의 설치 디렉토리입니다.
    5. 확인 단추를 클릭하십시오.
    6. Ctrl+S를 눌러 애플리케이션 배치 디스크립터 편집기의 변경사항을 저장하십시오.
  6. 샘플을 실행하려면 입력 값을 수정하십시오.
    팁: XDCGIVT 샘플에 포함된 각 배치 작업 파일에 대해 이 단계를 반복해야 합니다.
    1. 엔터프라이즈 탐색기에서 XDCGIVT > xJCL 폴더를 펼치십시오. 다음 배치 작업 파일을 찾게 됩니다.
      XDCGIVTbyte2bytexJCL.xml
      바이트 파일을 다른 바이트 파일에 복사하고 두 파일을 비교합니다.
      XDCGIVTtxt2db2txtxJCL.xml
      텍스트 파일을 데이터베이스에 복사하고 데이터베이스의 항목을 다른 텍스트 파일에 복사하고 두 파일을 비교합니다.
      XDCGIVTtxt2txtxJCL.xml
      텍스트 파일을 다른 텍스트 파일에 복사하고 두 파일을 비교합니다.
      작업은 xJCL(XML Job Control Language)이라고 하는 XML(Extensible Markup Language) 통용어를 사용하여 표현됩니다. 모든 작업에는 다음 정보가 포함됩니다.
      • 작업을 수행하는 배치 애플리케이션의 ID
      • 작업을 완료하기 위해 수행해야 할 하나 이상의 작업 단계
      • 각 작업 단계마다 논리를 제공하는 애플리케이션 내의 아티팩트 ID
      • 애플리케이션 아티팩트에 추가 컨텍스트를 제공하는 각 작업 단계의 키 및 값 쌍
      자세한 정보는 WebSphere Application Server의 Information Center에서 사용할 수 있는 배치 애플리케이션, 작업 및 작업 정의 주제를 참조하십시오.
    2. 위의 배치 작업 파일 중 하나를 마우스 오른쪽 단추로 클릭하고 열기를 선택하십시오. XJCL 편집기가 열립니다.
    3. XJCL 편집기의 디자인 탭에 있는 배치 작업 구조 섹션 아래에서 작업(XDCGIVT) > 대체 특성 노드를 펼치십시오.

      대체 특성은 기호 변수에 대한 이름 및 값 쌍을 정의합니다. xJCL 파일에서 기호 변수는 ${variable-name} 형식의 표현식이며, 이는 올바른 형식의 문서의 주석 외부에 있습니다. 기호 변수의 대체는 런타임 시 발생합니다. 런타임 시에는 ${variable-name} 문자열이 xJCL 파일 발행 시 특성 값으로 바뀝니다.

      각 배치 작업 파일에는 수정 시 필요한 두 개의 대체 특성이 있습니다(inputDataStreamoutputDataStream).
      표 1. . 다음 표에는 inputDataStreamoutputDataStream 대체 특성에 대해 지정된 기본값이 나열되어 있습니다.
        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
      위의 표에는 inputDataStreamoutputDataStream 대체 특성에 대해 지정된 기본값이 나열되어 있습니다. /data/는 읽기 및 쓰기 권한을 가진 파일 시스템의 기존 디렉토리(이 샘플 실행 시 텍스트 파일을 작성할 위치)로 대체해야 합니다(예: C:\temp\input.txt).
      팁: 텍스트 파일의 파일 이름은 작업 이름 및 작업 번호에 붙습니다. WebSphere Application Server for z/OS®의 경우, 컨텐츠를 볼 수 있도록 텍스트 파일을 EBCDIC(Extended Binary Coded Decimal Interchange Code)로 변환해야 합니다.
    4. XJCL 편집기에서 특성(inputDataStream) 노드를 선택하십시오(특성(outputDataStream)에 대해 이 단계 반복 ). 세부사항 섹션 아래의 필드에서 /data/를 파일 시스템 디렉토리의 기존 디렉토리로 바꾸십시오(예: C:\temp\input-txlist.txt).
    5. CTRL+S를 눌러 XJCL 편집기의 변경사항을 저장하십시오.
  7. 서버에서 샘플을 실행하려면 다음을 수행하십시오.
    1. 서버 보기에서 서버를 마우스 오른쪽 단추로 클릭한 후 시작을 선택하십시오. 서버 보기에서 상태와 시작됨동기화됨으로의 서버 변경 상태를 확인하여 서버 시작을 대기하십시오.
    2. 서버 보기에서 서버를 마우스 오른쪽 단추로 클릭한 후 추가 및 제거를 선택하십시오. 추가 및 제거 마법사가 열립니다. 사용 가능 목록 아래에서 XDCGIVTEAR 애플리케이션을 선택하고 추가 단추를 클릭하십시오. 추가 및 제거 마법사에서 완료 단추를 클릭하십시오. 서버 보기에서 상태와 시작됨동기화됨으로의 애플리케이션 변경 상태를 확인하여 애플리케이션 공개 및 시작을 대기하십시오.
    3. 엔터프라이즈 탐색기 보기에서 XDCGIVT > xJCL 폴더를 펼치고 XDCGIVT 배치 작업 파일 중 하나를 마우스 오른쪽 단추로 클릭하고 실행 도구 > Modern Batch 작업을 선택하십시오. 구성 실행 마법사가 열립니다.
    4. 보안이 사용으로 설정된 경우 서버가 안전하도록 서버에서 보안 사용 선택란을 선택하십시오. 사용자 ID 필드 및 비밀번호 필드에서 작업 스케줄러의 사용자 이름 및 비밀번호를 지정하십시오.
      팁: 관리 콘솔을 열어 어떤 사용자 또는 그룹이 보안 역할 lradminlrsubmitter에 맵핑되는지 찾고 시스템 관리 > 작업 스케줄러 > 사용자/그룹 맵핑에 대한 보안 역할을 선택할 수 있습니다.
    5. 구성 실행 마법사에서 실행 단추를 클릭하여 배치 작업 파일을 실행하십시오. Modern Batch 작업 관리 콘솔이 열립니다.
  8. 작업을 확인하고 Modern Batch 작업 관리 콘솔에 로그인하십시오.
    1. Modern Batch 작업 관리 콘솔에서 작업 관리 섹션 아래의 왼쪽 분할창에서 작업 보기 링크를 클릭하십시오. 제출된 작업이 나열된 작업 테이블이 표시됩니다.
      Modern Batch 작업 관리 콘솔의 화면 캡처
    2. 작업 ID 열 아래에서 XDCGIVT:<jobID> 링크를 클릭하십시오. 작업 로그가 표시됩니다. 다운로드 단추를 클릭하여 작업 로그의 사본을 열거나 복사할 수 있습니다.
      작업 로그에는 다음 정보가 포함되어 있습니다.
      • 작업을 실행하는 데 사용된 xJCL 파일의 사본(xJCL 대체 값 포함).
      • 작업에 해당하는 기본 라이프사이클 이벤트와 통신하는 시스템 메시지 세트. 작업 로그에 기록되는 시스템 이벤트의 예는 작업의 시작과 종료, 그리고 단계입니다.
      • 작업 단계 프로그램에 의해 표준 출력 및 표준 오류에 작성된 메시지 세트.
      작업 로그에 대한 자세한 정보는 WebSphere Application Server의 Information Center에서 사용할 수 있는 작업 로그 주제를 참조하십시오.

피드백