설치 및 이주 안내서

본 설치 및 이주 안내서에는 다음과 같은 내용이 실려 있습니다.

본 안내서의 PDF 버전도 pdf 디렉토리에서 사용할 수 있습니다. pdf 디렉토리의 위치는 VisualAge for Java, Professional Edition 제품 CD와 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있습니다. 

VisualAge for Java 제품 정보 위치

이 파일에는 VisualAge for Java의 특정 컴포넌트 및 기능에 대한 자세한 정보는 들어 있지 않습니다. 자세한 내용은 시작 > 프로그램 > Windows용 IBM VisualAge for Java 버전 4.0> 릴리스 정보를 선택하여 액세스할 수 있는 제품의 릴리스 정보를 참조하십시오. 모든 언어에 대한 릴리스 정보는 제품 CD(설치 후 사용할 수 있음)와 다음 웹 사이트 http://www.ibm.com/vadd에 있습니다.  

이 파일에는 VisualAge for Java 사용에 대한 정보는 들어 있지 않습니다. 시작하기 전에 안내서 및 해당 정보에 대한 온라인 도움말을 참조하십시오. 온라인 도움말의 일부는 Adobe Acrobat Reader(http://www.adobe.com/)를 사용하여 보고 인쇄할 수 있는 PDF 문서로 통합되어 있습니다. 모든 PDF가 모든 언어로 사용할 수 있는 것은 아닙니다. PDF 파일은 pdf 디렉토리에서 입수할 수 있습니다. pdf 디렉토리의 위치는 VisualAge for Java, Professional Edition 제품 CD 및 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

각 PDF 파일에 들어 있는 내용에 대해 알려면 PDF 색인(시작하기 전에 안내서)을 참조하십시오. 온라인 도움말에는 인터넷에서 사용할 수 있는 VisualAge 자원에 대한 링크를 포함하는 "웹 자원" 절도 들어 있습니다.

VADD(VisualAge Developer Domain) 웹 사이트는 VisualAge for Java에 대한 지원 및 제품 갱신에 대한 쉬운 액세스와 함께 기술 기사, 해설서, 샘플 및 FAQ를 제공합니다. 이 사이트에서 애플릿 및 Servlet 개발을 보완할 재사용가능 빈, 마법사 및 툴킷뿐 아니라 VisualAge for Java 개발 도구를 다운로드할 수 있습니다. http://www.ibm.com/vadd를 참조하십시오. 이 사이트를 사용하여 다음에 공개될 VisualAge for Java의 기능을 요청할 수도 있습니다.

이미 VADD(VisualAge Developers Domain)에 신청을 했으면 다시 등록할 필요는 없습니다. 현재 ID 및 암호를 사용하여 현재의 정보 및 코드 갱신을 확보할 수 있습니다. 새로운 사용일 경우 배달된 박스(또는 미디어 킷)에서 신청 번호를 찾으십시오. VisualAge for Java를 구입했으나 신청 번호가 없을 경우 IBM 영업대표에 문의하십시오.

VisualAge for Java의 제품 홈 페이지는 http://www.ibm.com/software/ad/vajava에 있습니다.

목차

파트 A: VisualAge for Java, Professional Edition

1.0 필수 요구사항
2.0 설치
      2.1 VisualAge for Java, 버전 4.0 설치
      2.2 차후에 추가 컴포넌트 설치
      2.3 Windows 2000에 대한 설치 고려사항
      2.4 IBM Developer Kit, Java Technology Edition, v1.2.2 설치
3.0 VisualAge for Java 이전 버전으로부터 이주
      3.1 VisualAge for Java 버전 3.5 또는 버전 3.5.3으로부터 이주
      3.2  VisualAge for Java 버전 2.0, 3.0x 또는 3.0x Early Adopters로부터 이주
4.0 알려진 문제점 및 제한사항
      4.1 설치시 알려진 문제점 및 제한사항
      4.2 설치 해제시 알려진 문제점 및 제한사항

파트 B: VisualAge for Java, Enterprise Edition

1.0 필수 요구사항
      1.1 일반적인 필수 요구사항
      1.2 컴포넌트별 필수 요구사항
2.0 설치
      2.1 VisualAge for Java, 버전 4.0 설치
      2.2 차후에 추가 컴포넌트 설치
      2.3 VisualAge for Java 팀 클라이언트 설치
      2.4 독립형 저장소가 있는 클라이언트 설치
      2.5 Windows 2000에 대한 설치 및 사용 고려사항
      2.6 IBM Developer Kit, Java Technology Edition, 버전 1.2.2 설치
3.0 VisualAge for Java 이전 버전으로부터 이주
      3.1 VisualAge for Java 이전 버전으로부터 공유 저장소 이주
4.0 알려진 문제점 및 제한사항
      4.1 설치시 알려진 문제점 및 제한사항
      4.2 설치 해제시 알려진 문제점 및 제한사항

파트 C: 팀 저장소 서버(EMSRV)

1.0 필수 요구사항
      1.1 지원되는 플랫폼
      1.2 TCP/IP
      1.3 NetWare 4.x에서 EMSRV 실행에 필요한 Novell 패치
      1.4 Solaris에서 EMSRV 실행에 필요한 Solaris 패치     
      1.5 지원되는 파일 시스템   
2.0 설치
     2.1 Windows용 EMSRV 설치
             2.1.1 Windows 레지스트리에 서비스로 EMSRV 설치
     2.2 NetWare용 EMSRV 설치 
     2.3 OS/2 Warp용 EMSRV 설치
     2.4 AIX용 EMSRV 설치
     2.5 HP-UX/Solaris용 EMSRV 설치
     2.6 Linux용 EMSRV 설치
3.0 이주
      3.1 EMSRV 버전 6.x/7.0에서 버전 7.1로 이주
4.0 팀 개발 준비
      4.1 팀 서버 준비
      4.2 클라이언트 연결 테스트
      4.3 저장소 사용자 목록에 사용자 추가
5.0 제한사항 및 알려진 문제점
      5.1 저대역폭, 고지연 네트워크 연결의 성능
      5.2 TCP/IP 연결 제한사항 
      5.3 예상치 않게 드롭된 연결 발견
      5.4 다른 EMSRV 및 EMSRV 유틸리티 버전 교환
      5.5 PAM 제한사항
      5.6 ASCII가 아닌 문자로 된 암호는 EMSRV를 인증하는 데 사용할 수 없음
      5.7 일본어 NetWare에서 수행시 메뉴와 창에 손상된 문자
      5.8 저장된 자원 디렉토리를 복사하지 않는 EMADMIN

파트 D: 컴포넌트 지정 이주 정보

1.0 CICS 트랜잭션 서버 *+
2.0 데이터 액세스 빈
3.0 데이터 액세스 빌더 * +
4.0 EJB 개발 환경 +
5.0 엔터프라이즈 액세스 빌더 및 e-connectors +
6.0 AS/400용 엔터프라이즈 툴킷 +
7.0 OS/390용 엔터프라이즈 툴킷 +
8.0 워크스테이션용 엔터프라이즈 툴킷 * +
9.0 외부 버전 제어
10.0 IDL 개발 환경 +
11.0 통합 개발 환경
 12.0 JSP/Servlet 개발 환경
13.0 Migration Assistant *
14.0 Persistence 빌더 +
15.0 RMI 액세스 빌더 * +
16.0 비주얼 컴포지션 편집기
17.0 Servlet 빌더 및 Servlet 실행기  * +
18.0 Swing 클래스
19.0 XMI 툴킷 +

* 이 컴포넌트는 VisualAge for Java, 버전 4.0에서 지원되지 않습니다.

+ Enterprise Edition 전용

파트 E: 일반 정보

1.0 프로젝트 자원 및 자원 관리 처리
2.0 OS/2 및 AIX로부터 이주
3.0 J2SDK v.1.2.2의 새로운 보안 제안사항
4.0 새 외부 버전 제어 도구(외부 SCM 도구를 대체함)
5.0 VisualAge for Java에서 타사 ORB에 대한 작업
6.0 추가 기능 CD의 내용

부록

부록 A: 데이터 액세스 컴포넌트 비교

파트 A VisualAge for Java, Professional Edition

A.1.0 필수 요구사항

VisualAge for Java, 버전 4.0 개정판에는 다음과 같은 하드웨어 및 소프트웨어 필수 요구사항이 있습니다.

DB2 및 VisualAge for Java와 동시에 Websphere Application Server를 실행할 경우, 최소 512MB가 권장됩니다.

* 주: VisualAge for Java는 Logitech 화면 이동 마우스를 지원하지 않습니다. 화면 이동 조치를 마우스에 다시 맵핑하는 드라이버가 있는 Logitech 마우스를 사용하여 화면 이동할 경우 시스템 오류가 발생합니다. 

A.2.0 설치

이 절에는 VisualAge for Java, 버전 4.0 설치에 관한 정보가 들어 있습니다. 중요사항: VisualAge for Java 이전 버전에서 이주할 경우 버전 4.0을 설치하기 전에 3.0 절을 참조하십시오. Windows 2000에 설치할 때 필요한 특수한 정보는 2.3 절을 참조하십시오.

최근에 알려진 문제점과 제한사항에 대해서는 README(제품 CD의 README 디렉토리에 있음)도 참조하십시오. 

A.2.1 VisualAge for Java, 버전 4.0 설치

제품을 설치하기 전에 다음 항목을 점검하십시오.

VisualAge for Java를 Windows, Millennium 개정판에 설치하려고 하면, 환경 공간을 늘리라는 메시지가 표시됩니다. 설치하기 전에 아래에 요약되어 있는 단계를 수행해야 합니다. 그렇지 않으면, VisualAge for Java 도움말 시스템이 제대로 작동되지 않습니다. 환경 공간을 늘리려면 다음 단계를 수행하십시오.

  1. 설치 화면을 종료하십시오.
  2. Windows 탐색기를 여십시오. Windows 디렉토리를 찾으십시오(예를 들어, C:\Windows).
  3. Command.com을 마우스 오른쪽 단추로 클릭한 다음, 팝업 메뉴에서 특성을 클릭하십시오. 메모리 탭을 클릭하십시오.
  4. 초기 환경 박스에서 초기 환경의 크기를 4,096바이트로 설정하십시오. 확인을 클릭하십시오.
  5. Windows 탐색기를 닫으십시오.
  6. 시스템을 다시 부트하십시오.
  7. VisualAge for Java 설치를 다시 시작하십시오.

A.2.1.1 제품 CD에서 VisualAge for Java, 버전 4.0 설치

  1. CD 드라이브에 CD-ROM을 삽입하십시오. 이전 버전의 VisualAge for Java에서 이주하는 경우, 설치 프로시저를 계속하기 전에 "이전 버전의 Visual Age for Java에서 이주"(이 문서의 3.0 절)를 읽어주십시오.
  2. 시스템에서 자동 실행이 되지 않으면, CD 드라이브의 루트에서 setup.exe를 실행하십시오.
  3. 제품 설치를 선택하십시오. VisualAge for Java의 설치를 시작하려면 VisualAge for Java 설치를 선택하십시오. VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하거나 별도 시스템에서 수행 중인 프로그램을 디버그하려면 A.2.1.1.1 Distributed Debugger 설치 정보에 대한 절을 참조하십시오.
  4. 화면에 표시된 지시사항을 따르십시오.
  5. VisualAge for Java IDE를 시작하십시오.

자동 설치
VisualAge for Java, 버전 4.0을 자동으로 설치하려면 ivj40\setup 디렉토리에서 다음 명령을 호출하십시오.

setup /s /v/qn

VisualAge for Java가 c:\Program Files\IBM\VisualAge for Java 기본 디렉토리에 자동으로 설치됩니다.

자동으로 다른 디렉토리(예: d:\IBMVJava40)에 설치하려면, ivj40\setup 디렉토리에서 다음 명령을 호출하십시오.

setup /s /v"INSTALLDIR=\"d:\IBMVJava40\" /qn"

여기서 d:\IBMVJava40은 설치 대상 디렉토리입니다.

A.2.1.1.1 제품 CD에서 Distributed Debugger 설치
VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하려거나 별도 시스템에서 수행 중인 프로그램을 디버그하려면 Distributed Debugger를 설치해야 합니다. Distributed Debugger는 Windows, AIX, OS/2, HP-UX, Solaris, Linux 및 Linux/390 운영 체제에서 지원됩니다. 각 운영 체제에 대한 설치 지시사항은 아래에서 제공됩니다. Distributed Debugger 파일은 모두 제품 CD의 디버거 디렉토리에 있습니다.

 Windows용 Distributed Debugger

  1. setup.exe를 수행하고 제품 설치를 선택하십시오. 그 다음 Distributed Debugger 설치를 선택하여 디버거를 설치하십시오.
AIX용 Distributed Debugger  
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 설치 미디어에서 스크래치 디렉토리로 idebug.tar.Z를 복사하십시오.
  3. 디렉토리를 스크래치 디렉토리로 변경하십시오.
  4. uncompress idebug.tar.Z 명령을 실행하여 idebug.tar.Z 파일을 압축 해제하십시오.
  5. tar -xvf idebug.tar 명령을 실행하여 idebug.tar에서 설치 이미지를 추출하십시오.
  6. 루트에서 installp -ac -X -V2 -g -N -d idebug 명령을 실행하십시오.
  7. 또한 smitty install_latest 명령으로 SMIT를 사용할 수도 있습니다.

OS/2용 Distributed Debugger

제품 CD의 Debugger\OS2에 있는 README_install.txt 파일의 지시사항을 따르십시오.

HP-UX용 Distributed Debugger

필수 요구사항: 
설치 및 Java 디버깅에 Java 버전 1.3이 필요합니다.

  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. install.class를 스크래치 디렉토리로 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면, cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. 루트에서 java install.class 명령을 입력하십시오.
Solaris용 Distributed Debugger  
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 스크래치 디렉토리로 dbgsetup 및 idebug.pkg를 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면 cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. chmod +x dbgsetup 명령을 실행하여 "dbgsetup"을 실행 가능하게 하십시오.
  5. 루트에서 ./dbgsetup idebug.pkg 명령을 입력하여 디버거를 설치하십시오.

Linux용 Distributed Debugger 

루트에서 rpm -Uvh DERJPICL-9-1.i386.rpm 명령을 입력하여 디버거를 설치하십시오.

Linux/390용 Distributed Debugger 

루트에서 rpm -Uvh DERJPICL-9-1.s390.rpm 명령을 입력하여 디버거를 설치하십시오.

OS/390용 Distributed Debugger

  1. Windows용 Distributed Debugger를 설치하십시오.
  2. Windows의 기본 설치 디렉토리에 있는 README_install.txt의 지시사항을 따르십시오.

A.2.1.2 VisualAge for Java, 버전 4.0의 전자 이미지에서 설치
다운로드 시간을 줄이기 위해 Windows용 Professional Edition, VisualAge for Java, 버전 4.0의 전자 이미지는 여러 파트로 나뉘어져 있습니다.

A.2.1.2.1 IDE
통합 개발 환경에 대한 9개의 다운로드 가능한 파트가 있습니다. 9개의 파트 모두 자동 압축 해제 아카이브입니다. 처음 두 파트는 반드시 설치해야 하며 나머지는 선택적입니다. 각 아카이브의 내용에 대해서는 다음 목록을 참조하십시오.

처음 두 개의 파트와 원하는 선택적 파일을 다운로드했으면, 각 자동 압축 해제 아카이브를 실행하고 각각이 동일한 임시 디렉토리로 추출되었는지 확인하십시오. 모든 파일이 추출되었으면, 임시 디렉토리로 가서 setup.exe를 실행하십시오. 화면에 표시되는 지시사항에 따라 IDE를 시작하십시오.

영어 이외의 언어로 작업하려면 setup.exe를 실행하기 전에 정확한 파트를 다운로드하여 그 언어에 대한 자동 압축 해제 아카이브를 수행해야 합니다. VisualAge for Java를 설치한 후에는 언어를 변경하거나 추가할 수 없습니다.

VisualAge for Java의 전자 이미지로 작업 중인 경우, 프로그램 추가/제거 대화 상자(시작 > 설정 >제어판 > 프로그램 추가/제거)를 사용하여 사용자의 초기 설치 이후에 추가적인 VisualAge for Java 컴포넌트를 설치할 수 없습니다. 그렇게 하려는 경우에는 오류 메시지를 받게 되며 추가적인 컴포넌트를 설치할 수 없게 됩니다. VisualAge for Java에 추가 컴포넌트를 추가하려면 다운로드된 파트를 추출하는 경로에서 setup.exe를 수행해야 합니다.

다음은 각 아카이브 파트에 대한 설명입니다.

A.2.1.2.2 Distributed Debugger
Distributed Debugger에서 지원하는 각 대상 운영 체제에 대해 별도로 다운로드가 가능한 파트가 있습니다. VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하거나 별도 시스템에서 수행 중인 프로그램을 디버그하려는 경우, Distributed Debugger를 다운로드해서 설치해야 합니다. 각 운영 체제에 대한 설치 지시사항은 아래에서 제공됩니다. 이 지시사항 및 라이센스 계약 관련 정보는 각 파트에 포함된 readme.txt 파일에도 있습니다.

VisualAge for Java - Windows용 Distributed Debugger에는 사용자 인터페이스 및 Windows용 디버그 엔진이 들어 있습니다. 이 파트는 자동 압축 해제 아카이브입니다. 설치하려면 다음 단계를 따르십시오.

  1. VisualAge for Java를 다운로드하고 압축 해제했으면 setup.exe를 실행하고 제품 설치를 선택하십시오. 그 다음 Distributed Debugger 설치를 선택하십시오. 
  2. VisualAge for Java 없이 Distributed Debugger를 설치하려면, 명령 프롬프트에서 DebugDirectory\windows 디렉토리 (DebugDirectory 디렉토리는 Distributed Debugger를 압축 해제시켜 보낸 곳임)를 열고 setup.bat 명령을 실행하십시오.
VisualAge for Java - AIX용 Distributed Debugger에는 AIX 디버그 엔진이 들어 있습니다. 설치하려면 다음 단계를 따르십시오.
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 설치 미디어에서 스크래치 디렉토리로 idebug.tar.Z를 복사하십시오.
  3. 디렉토리를 스크래치 디렉토리로 변경하십시오.
  4. uncompress idebug.tar.Z 명령을 실행하여 idebug.tar.Z 파일을 압축 해제하십시오.
  5. tar -xvf idebug.tar 명령을 실행하여 idebug.tar에서 설치 이미지를 추출하십시오.
  6. 루트에서 installp -ac -X -V2 -g -N -d idebug 명령을 실행하십시오.
  7. 또한 smitty install_latest 명령으로 SMIT를 사용할 수도 있습니다.
VisualAge for Java - OS/2용 Distributed Debugger에는 OS/2 디버그 엔진이 들어 있습니다. 설치하려면 (OS/2용 Distributed Debugger 파트에 포함되어 있는) README_install.txt의 지시사항을 따르십시오.

VisualAge for Java - HP-UX용 Distributed Debugger에는 HP-UX용 디버그 엔진이 들어 있습니다.

필수 요구사항: 
설치 및 Java 디버깅에는 Java 버전 1.3이 필요합니다.

설치하려면 파일을 untar하고 다음 지시사항을 따르십시오.

  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. install.class를 스크래치 디렉토리로 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면, cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. 루트에서 java install.class 명령을 입력하십시오.
VisualAge for Java - Solaris용 Distributed Debugger에는 Solaris용 운영 환경에 대한 디버그 엔진이 들어 있습니다. 설치하려면 파일을 untar하고 다음 지시사항을 따르십시오.
  1. chmod +x dbgsetup 명령을 실행하여 "dbgsetup"을 실행 가능하게 하십시오.
  2. 루트에서 ./dbgsetup idebug.pkg 명령을 입력하여 디버거를 설치하십시오.

VisualAge for Java - Linux용 Distributed Debugger에는 Linux용 디버그 엔진이 들어 있습니다. 이를 설치하려면 파일을 untar하고 다음 지시사항에 따라 디버거를 설치하십시오.

루트에서 rpm -Uvh DERJPICL-9-1.i386.rpm 명령을 입력하십시오.

VisualAge for Java - Linux/390용 Distributed Debugger에는 Linux/390용 디버그 엔진이 들어 있습니다. 이를 설치하려면 파일을 untar하고 다음 지시사항에 따라 디버거를 설치하십시오.

루트에서 rpm -Uvh DERJPICL-9-1.s390.rpm 명령을 입력하십시오.

OS/390용 Distributed Debugger

  1. Windows용 Distributed Debugger를 설치하십시오.
  2. Windows의 기본 설치 디렉토리에 있는 README_install.txt의 지시사항을 따르십시오.

A.2.1.2.3 IBM Developer Kit 1.2.2
VisualAge for Java - IBM Developer Kit 1.2.2에는 Windows 플랫폼용의 IBM Developer Kit, Java Technology Edition, v 1.2.2, PTF 9가 들어 있습니다.  이 제품은 자동 압축 해제 아카이브입니다. 이를 설치하려면, 이 파일(아카이브에서 추출되어 설치 프로그램을 자동으로 시작함)을 수행하고 지시사항을 따르십시오.

A.2.2 차후에 추가 컴포넌트 설치

초기 설치 이후 언제라도 추가 VisualAge for Java 컴포넌트를 설치하려면, CD 드라이브에 CD-ROM을 삽입한 후 VisualAge for Java 설치를 선택하고 프로그램 유지보수 화면에서 수정을 선택하십시오. 시스템에서 자동 실행이 되지 않으면, CD 드라이브의 루트에서 setup.exe를 실행하십시오. VisualAge for Java 전자 버전을 갖고 있으면, 수동으로 setup.exe를 실행한 후 동일한 단계를 반복하십시오.

모든 컴포넌트는 현재 설치 상태 표시와 함께 편집 기능 창에 나열됩니다. 빨간색 'X'는 현재 컴포넌트가 설치되지 않았음을 나타냅니다. 이 컴포넌트를 설치하도록 선택할 수 있습니다. 빨간색 'X'가 표시되지 않은 컴포넌트는 이미 설치되어 있으므로 선택하지 마십시오. 

VisualAge for Java, 버전 4.0의 두번째 인스턴스는 설치할 수 없습니다. 제품을 먼저 설치 해제하지 않으면 설치 언어를 변경할 수 없습니다.

A.2.3 Windows 2000에 대한 설치 고려사항  

VisualAge for Java의 이번 릴리스에서는 Windows용 조정 지원(Microsoft에 의해 정의됨)을 계속 제공합니다.

기본 설치 디렉토리는 <Program Files>\IBM\VisualAge for Java입니다. Windows 2000에서는 기본적으로 오직 관리자 및 표준(파워) 사용자만 <Program Files>로 설치할 수 있습니다. 정규(제한) 사용자는 이 위치로 쓰기를 할 수 없습니다.

VisualAge for Java의 현재 설계 때문에, 제품을 이 위치에 설치하고 정규(제한) 사용자가 사용하는 경우, <Program Files>에서 정규 사용자의 쓰기 액세스를 허용하도록 IBM 또는 IBM\VisualAge for Java 디렉토리에 대한 보안 설정을 변경하십시오. 이 작업이 실패하면 IDE 시작이 실패할 수 있습니다.

A.2.4 IBM Developer Kit, Java Technology Edition, 버전 1.2.2, PTF 9 설치  

제품 CD에서 VisualAge for Java를 설치한 경우, IBM Developer Kit 디렉토리에서 install.exe를 실행하여 IBM Developer Kit, Java Technology Edition, 버전 1.2.2, PTF 9를 설치해야 합니다. 이 디렉토리는 제품 CD에 있습니다. VisualAge for Java의 전자 버전이 있는 경우, 이 디렉토리는 임시 디렉토리(파트를 추출한 대상 디렉토리)에 위치하지만 설치 프로그램이 다운로드된 IBM Developer Kit 아카이브로부터 추출 후 자동으로 시작되므로 install.exe를 실행할 필요가 없습니다.

IBM Developer Kit에 관한 자세한 내용은 IBM Developer Kit 디렉토리의 README 파일을 참조하십시오.

A.3.0 VisualAge for Java 이전 버전으로부터 이주

이주 프로세스를 시작하기 전에 컴포넌트 특정 및 일반 정보에 대해서는 파트 D 및 파트 E를 참조하십시오.

버전 3.5 또는 버전 3.5.3으로부터 자동으로 이주할 수 있습니다. 버전 4.0이  버전 3.5 또는 버전 3.5.3의 맨 위에 설치됩니다. VisualAge for Java 버전 3.5 또는 버전 3.5.3으로부터의 이주에 대한 정보는 3.1 절을 참조하십시오.

3.0x, Early Adopters로부터는 수동으로 이주해야 합니다.  VisualAge for Java, 3.0x, Early Adopters로부터의 이주에 대한 정보는 3.2 절을 참조하십시오.

현재 JDK 1.1.x가 지원되는 VisualAge for Java, 버전 2.0, 3.0 또는 3.02를 사용 중이면 VisualAge for Java, 버전 4.0으로 자동으로 이주할 수 없습니다. 이 버전의 VisualAge for Java는 VisualAge for Java, 버전 4.0과 공존할 수 있습니다. VisualAge for Java의 버전 2.0 또는 3.0x로부터 저장소 내용 및 자원 파일을 이주하는 방법에 대해서는 3.2 절을 참조하십시오.

VisualAge for Java, 버전 3.5, Entry Enterprise Edition 또는 VisualAge for Java, 버전 3.5 또는 버전 3.5.3 Enterprise Edition으로부터 VisualAge for Java, 버전 4.0, Professional Edition으로는 이주할 수 없습니다. 버전 4.0, Enterprise Edition으로 이주해야 합니다.

주: VisualAge for Java, 버전 3.5 또는 버전 3.5.3으로부터 버전 4.0으로 이주할 때, 설치 프로세스가 멈춘 것처럼 나타날 수 있습니다. 이런 현상이 발생하는 이유는 (3.5 또는 3.5.3 버전 파일과 4.0 버전 파일을 비교하는) "DoCosting" 기능을 실행하는데 3분 가량이 소요되어 마치 설치 프로세스가 멈춘 것처럼 보이기 때문입니다.

A.3.1 버전 3.5 또는 버전 3.5.3으로부터 이주

VisualAge for Java, 버전 3.5 또는 버전 3.5.3으로부터의 이주는 자동입니다. 버전 4.0 설치 프로그램이 이미 설치된 버전 3.5 또는 버전 3.5.3 제품을 버전 4.0으로 자동으로 업그레이드합니다.

자동 이주

  1. 다음 단계를 수행하여 사용자 데이터를 백업하십시오. 이주 중에 문제점이 발생할 경우를 대비하여 저장소 및 자원 파일의 백업 사본을 작성하십시오.
    1. 프로젝트 및 패키지를 버전화하십시오. 버전화된 프로젝트 및 패키지만이 VisualAge for Java, 버전 4.0 저장소로 반입됩니다. 버전화 지시사항은 VisualAge for Java 온라인 도움말을 참조하십시오.
    2. VisualAge for Java 디렉토리 트리 외부의 새 위치에 저장소를 저장하십시오. 저장소의 파일명 및 경로는 x:\IBMVJava\ide\repository\ivj.dat이며, 여기서 x:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.
      주: 버전 3.5 또는 버전 3.5.3으로부터 이주하는 경우, 저장소에는 프로젝트 자원 파일의 버전화된 사본도 포함됩니다. 자원 파일의 위치는 x:\IBMVJava\ide\repository\ivj.dat.pr 디렉토리입니다. VisualAge for Java 디렉토리 트리 외부에 ivj.dat.pr 디렉토리의 사본을 저장해야 합니다.  
  2. VisualAge for Java, 버전 4.0을 설치하려면, 2.1 절의 설치 지시사항을 참조하십시오.
  3. 현재 설치를 업그레이드하도록 선택하십시오. 버전 3.5 또는 버전 3.5.3이 자동으로 버전 4.0으로 업그레이드되므로 설치 해제할 필요가 없습니다.  버전 4.0은 버전 3.5 또는 버전 3.5.3이 설치되어 있는 디렉토리에 자동으로 설치됩니다.
  4. 업그레이드 설치가 성공적으로 완료되면, 모든 프로젝트 자원 및 저장소 데이터는 버전 4.0 IDE를 처음 시작할 때 버전 4.0으로 자동으로 이주됩니다. 

설치 실패가 발생하는 이벤트에서는 수동으로 사용자 데이터를 이주해야 합니다. IDE가 시작되지 않거나 IDE가 사용자 데이터를 이주하는 중에 오류가 발생할 경우에도 수동으로 사용자 데이터를 이주해야 합니다. 

수동 이주

  1. VisualAge for Java 디렉토리 트리 외부에 저장소 데이터(즉, 저장소 및 버전 3.5 또는 버전 3.5.3에서 이주하려는 경우, ivj.dat.pr 디렉토리)와 자원 파일을 저장했는지 검증하십시오.
  2. 제품을 완전히 설치 해제하십시오. 모든 버전 3.5 또는 버전 3.5.3 서브디렉토리 및 파일을 삭제해야 합니다.
  3. 재부트한 후 버전 4.0을 설치하십시오.
  4. IDE를 시작하십시오.
  5. 이제 이전 저장소로부터 새 저장소로 패키지와 프로젝트를 반입할 수 있습니다. Workbench에서 파일 > 가져오기를 선택하고 저장소 라디오 단추를 선택한 후 다음을 클릭하십시오. 저장소 이름 필드에 ivj.dat의 백업 사본 경로를 입력하십시오. 그런 다음, 반입할 프로젝트와 패키지를 선택하십시오. 버전화되지 않은 프로젝트 및 패키지는 반입할 수 없습니다. 주: 이전 버전의 VisualAge for Java에서 시스템 프로젝트를 반입해서는 안됩니다.
  6. 자동으로 선택된 프로젝트를 작업영역에 추가하려면, 가장 최근의 프로젝트 개정판을 작업영역에 추가 선택란을 선택하십시오. 이 선택란은 프로젝트 라디오 단추가 선택되었을 때만 사용할 수 있습니다.
  7. 완료를 클릭하십시오.
  8. 자원 파일의 백업 사본을 x:\IBMVJava\ide\project_resources\project 서브디렉토리로 복사하십시오. 여기서 x:\IBMVJava는 VisualAge for Java, 버전 4.0 설치 디렉토리이고 project는 자원이 연관된 프로젝트 이름입니다.
    버전 3.5 또는 버전 3.5.3 프로젝트를 저장소에 반입하면, 프로젝트 자원(ivj.dat.pr 디렉토리에 들어 있음)의 모든 버전화된 사본이 자동으로 저장소에 추가됩니다. 

A.3.2 VisualAge for Java 버전 2.0, 3.0x 또는 3.0x Early Adopters 로부터 이주

VisualAge for Java 버전 2.0, 버전 3.0x, 3.0x, Early Adopters로부터 저장소의 내용 및 자원 파일을 수동으로 이주할 수 있습니다. 손상 복구에 대한 정보는 온라인 도움말 파일 "클래스 및 패키지 복구 참조서"를 참조하십시오.

2.0 또는 3.0x 버전은 VisualAge for Java, 버전 4.0과 같이 사용할 수 있으므로 설치 해제하지 않아도 됩니다.

버전 2.0, 3.0x 또는 3.0x Early Adopters Environment for Java 2 Platform, Standard Edition, v1.2 저장소 및 자원 파일을 버전 4.0으로 반입하려면 버전 2.0, 3.0x 또는 3.0x, Early Adopters를 설치 해제하기 전에 다음 모든 단계를 수행하십시오.  버전 2.0, 3.0x 또는 3.0x, Early Adopters를 설치 해제하지 않는 경우 2, 3, 4, 8 단계는 수행하지 않아도 되지만 다른 모든 단계는 수행해야 합니다.

  1. 프로젝트 및 패키지를 버전화하십시오. 버전화된 프로젝트 및 패키지만이 이 VisualAge for Java 버전으로 반입됩니다. 버전화 지시사항에 대해서는 VisualAge for Java 온라인 도움말을 참조하십시오. 
  2. 저장소를 VisualAge for Java 디렉토리 트리 외부의 새 위치에 저장하십시오. 저장소의 파일명 및 경로는 x:\IBMVJava\ide\repository\ivj.dat이며, 여기서 x:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.
  3. Java 응용프로그램에 의해 사용되는 자원 파일(예: 이미지 또는 사운드 파일)을 VisualAge for Java 디렉토리 트리 외부의 디렉토리로 복사하십시오. 기본적으로, 각각의 VisualAge for Java 프로젝트에 대한 자원 파일은 x:\IBMVJava\ide\project_resources\project라는 서브디렉토리에 위치하며, 여기서 x:\IBMVJava는 VisualAge for Java 설치 디렉토리이고 project는 자원이 연관된 프로젝트의 이름입니다.
  4. 이제 2.0, 3.0x 또는 3.0x, Early Adopters 버전을 설치 해제한 후, 버전 4.0을 설치할 수 있습니다. 버전 2.0, 3.0x 또는 3.0x, Early Adopters는 VisualAge for Java, 버전 4.0과 같이 사용할 수 있으므로 설치 해제하지 않아도 됩니다.
  5. VisualAge for Java 버전 4.0을 설치하고(2.1절 참조) 버전 4.0 IDE를 시작하십시오. 
  6. 이전 저장소에서 새 저장소로 패키지 및 프로젝트를 반입하는 방법에 대해서는 온라인 도움말을 참조하십시오. 버전화되지 않은 프로젝트 및 패키지는 반입할 수 없습니다. 주: 이전 버전의 VisualAge for Java에서 시스템 프로젝트를 반입해서는 안됩니다.
  7. 자원 파일의 백업 사본을 x:\IBMVJava\ide\project_resources\project 서브디렉토리로 복사하십시오(또는 2.0/3.0x 또는 3.0x, Early Adopters를 설치 해제하지 않은 경우 현재 2.0/3.0x 또는 3.0x, Early Adopters 설치로부터 자원 파일의 사본을 작성한 후 복사하십시오 ). 여기서 x:\IBMVJava는 VisualAge for Java, 버전 4.0 설치 디렉토리이고 project는 자원이 연관된 프로젝트의 이름입니다.
  8. 수동 이주가 성공적인지를 검증했으면 단계 2와 3에서 작성된 백업 사본을 삭제할 수 있습니다.

A.4.0 알려진 문제점 및 제한사항

최근에 알려진 문제점과 제한사항에 대해서는 README(CD의 README 디렉토리에 있음)도 참조하십시오. 

A.4.1 설치시 알려진 문제점 및 제한사항

다음은 설치 중에 알아야 할 사항의 목록입니다.

A.4.1.1 디스크 제한사항

A.4.1.2 사용자 인증

A.4.1.3 TCP/IP 고려사항

A.4.1.4 쉘 확장(Windows NT)

설치 프로그램이 Windows NT용 쉘 확장을 발견했음을 나타내는 메시지가 표시되면 설치를 계속할 수 없습니다. 이런 경우 다음을 수행해야 합니다.

  1. 긴급 복구 디스크가 있는지 확인하십시오. 디스크 작성에 필요한 지시사항은 Windows 도움말 문서에서 사용할 수 있습니다.
  2. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  3. 레지스트리 편집기에서 키를 확장하십시오.
    \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
  4. 위의 키에 대해 이름-데이터 쌍에서 쉘 이름을 선택하십시오.
    중요사항: 이 이름에 대해 기록된 데이터를 적어 두십시오. IBM VisualAge for Java를 설치한 후에 필요합니다.
  5. 쉘 이름-데이터 쌍에 대해 메뉴 막대에서 편집 > 수정을 선택하십시오.
  6. 쉘 이름 값을 Explorer.exe로 설정하십시오. 확인을 클릭하십시오.
  7. 메뉴 막대에서 레지스트리 > 종료를 선택하십시오.
  8. 재시작해서 IBM VisualAge for Java 설치를 완료하십시오.
  9. 설치가 완료되면 다음과 같이 이전 레지스트리 항목을 복원하십시오.
    a. 명령 프롬프트에서 regedit.exe를 입력하십시오.
    b. 레지스트리 편집기에서 \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon 키를 확장하십시오.
    c. 위의 키에 대해 이름-데이터 쌍에서 쉘 이름을 선택하십시오.
    d. 쉘 이름-데이터 쌍에 대해 메뉴 막대에서 편집 > 수정을 선택하십시오.
    e. 쉘 이름의 값을 단계 4에서 기록한 값으로 복원하고 확인을 클릭하십시오.
    f. 메뉴 막대에서 레지스트리 > 편집을 선택하십시오.

A.4.1.5 실패한 설치 복구

설치에 실패하면, 설치된 버전 4.0 파일을 제거해야 합니다. VisualAge for Java를 설치하고자 하는 디렉토리가 비어 있는 경우, 설치 프로세스가 구간 복원되고 설치된 파일이 제거됩니다. 원할 경우 빈 디렉토리를 제거할 수 있으나 반드시 그럴 필요는 없습니다. 그러나, 디렉토리에 파일이 들어 있는 경우 설치 프로세스를 다시 시작해야 합니다. 파일은 유지관리 모드로 열리며 제품을 다시 설치하기 전에 일부만 설치된 버전 4.0을 제거하도록 선택해야 합니다.

레지스트리 항목도 삭제해야 합니다.

\\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\VisualAge for Java for Windows

  1. 긴급 복구 디스크가 있는지 확인하십시오. 디스크 작성에 필요한 지시사항은 Windows 도움말 문서에서 사용할 수 있습니다.
  2. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  3. 레지스트리 편집기에서 키를 확장하고 선택하십시오.
    \\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\VisualAge for Java for Windows\4.0
  4. 이 키에 대해 메뉴 막대에서 편집 > 삭제를 선택하십시오.
  5. 키 삭제를 확정하도록 요청되면 예를 선택하십시오.
  6. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.

설치에 실패하기 전에 NetQuestion 파일이 설치되어 있었으면, 이것도 삭제해야 합니다.

  1. 새로운 명령 프롬프트를 여십시오. 방금 연 명령 프롬프트에서 다음과 같이 입력하여 NetQuestion 파일이 설치되었는지 확인하십시오. set imninstsrv. 이 명령은 NetQuestion이 시스템에 설치된 위치를 제공합니다. 예를 들면, 다음과 같습니다.

    IMNINSTSRV=C:\imnnq_nt

    VisualAge for Java를 설치한 드라이브와 사용 중인 운영 체제에 따라, NetQuestion 디렉토리 위치가 다르게 표시될 수도 있습니다. 변수가 설정된 경우(즉, NetQuestion이 설치된 위치가 제공된 경우), 2 단계를 계속 진행하십시오. 

    "환경 변수 imninstsrv가 정의되지 않음"과 같은 오류 메시지를 수신한 경우, NetQuestion 파일이 설치되지 않았거나 NetQuestion 설치가 성공적으로 완료되지 않은 것입니다. 이런 오류가 발생하면 시작 > 찾기 > 파일 또는 폴더를 선택하고 시스템에서 vahelp.cfg 파일을 탐색합니다. 이름이 "imnnq"로 시작하는(예를 들어, imnnq_NT 또는 imnnq_98) 디렉토리에서 이 파일을 찾으면, 파일을 삭제하십시오. 2 단계와 3 단계는 수행할 필요가 없습니다.  

  2. NetQuestion 디렉토리(IMNINSTSRV= 뒤에 나오는 정보)로 가십시오.
  3. vahcfg remove /p vj32를 입력하십시오.

이 조치는 VisualAge for Java가 설치된 모든 NetQuestion 파일을 제거합니다. 다른 제품(예를 들어, DB2)에서 설치한 NetQuestion 파일에는 영향을 미치지 않습니다.

아직 이와 같이 하지 않은 경우, 저장소와 자원 파일을 백업하십시오. 그 수행 방법에 대해서는 파트 A 3.1 절을 참조하십시오. 

이들 단계를 모두 수행한 후에 다시 부팅하고 제품을 재설치하십시오. VisualAge for Java를 재설치한 후에 도움말이 표시되지 않으면 도움말 실패 복구에 관한 추가 정보에 대해 문제점 해결 안내서를 참조하십시오. 문제점 해결 안내서(trshoot.htm)의 위치는 제품 CD의 VisualAge for Java, Professional Edition 및 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java를 설치한 후에도 안내서는 X:\IBMVJava에 위치하는데 여기서 X:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.

A.4.1.6 Windows 설치 프로그램 오류

다음은 설치 과정에서 사용자가 알아야 할 Windows 설치 프로그램 오류의 목록입니다.

오류 1603 (Windows NT 4.0 전용)

VisualAge for Java 설치 중에 1603 오류 메시지가 표시되면 이는 Windows 설치 프로그램 초기화에 실패했음을 표시하며 설치를 계속할 수 없습니다. 

어떤 제품은 (Symantec의 VisualCafe처럼) Windows 플랫폼에 설치될 경우에는 sfc.dll라는 파일을 자동으로 설치합니다. 이 파일은 Windows 2000에서만 사용되는데 여기서 Windows 설치 프로그램은 그 파일을 안전 처리용으로 호출합니다.  

이 이름의 파일이 Windows NT 4.0의 경로에 상주하면 비록 sfc.dll이 Windows 2000에만 적용된다 할 지라도 Windows 설치 프로그램은 이를 로드하려 할 것입니다. 그리고 Windows 설치 프로그램은 로드에 실패합니다. 

이 문제를 해결하려면 다음 단계를 따르십시오.

  1. 사용자 시스템에서 시작 > 찾기 > 파일 또는 폴더를 선택하고 sfc.dll 파일을 탐색하십시오.
  2. (Windows NT 4.0 경로에 상주하는 버전) sfc.dll 파일의 이름을 일시적으로 sfc.old로 변경하십시오.
  3. VisualAge for Java를 설치하십시오.
  4. VisualAge for Java를 성공적으로 설치한 다음에 sfc.old를 sfc.dll로 이름을 바꾸십시오.

치명적인 LoadLibrary() 오류

치명적인 LoadLibrary() 오류는 Windows 설치 프로그램이 하나 이상의 VisualAge for Java 설치 커널(IKernels)을 제대로 등록하지 못했기 때문에 발생합니다. 이 문제점을 해결하려면 IKernel 파일이 상주하는 InstallShield 디렉토리를 삭제한 후에 다음의 단계대로 VisualAge for Java를 재설치해야 합니다.

  1. 필요하면 설치를 종료하십시오.
  2. x:\Program Files\Common Files\InstallShield 디렉토리를 삭제하십시오. 여기서 x는 VisualAge for Java를 설치하려는 드라이브입니다.
  3. 제품을 재설치하십시오. 

오류 1631 또는 내부 오류 2755(Windows NT 4.0 전용)

Windows NT 4.0에 VisualAge for Java를 설치할 경우 다음의 오류 메시지 중 하나가 나타날 것입니다.

이 오류 메시지 중 하나가 표시되면 레지스트리 키가 null 값일 것입니다. VisualAge for Java 설치를 시작할 때 userenv.dll 파일은 다양한 레지스트리 키의 구문 분석을 시도하며 null 값을 가진 키가 있으면 위 오류 메시지 중 하나를 표시하며 설치는 실패합니다.

이런 작동을 해결하려면 VisualAge for Java를 설치하기 전에 null 환경 변수를 제거하거나 이를 수정(값을 null에서 유효한 값으로 변경)해야 합니다. VisualAge for Java를 설치한 후에 이를 원래 값으로 리턴할 수 있습니다.

주의: null 변수를 조심해서 제거하거나 수정하십시오. 그것들을 제거하거나 수정하기 전에 발생할 수 있는 잠재적인 충격을 고려해야 합니다.

내부 오류 2381, 1303, 1310, 1313(Windows NT 전용)

VisualAge for Java를 설치하려 하고 다음 조건 중 일부나 전부가 참이라면,

다음 오류 메시지 중 하나 이상이 표시됩니다.

이 문제점은 다음 폴더에 대해 읽기 권한만 있는 경우에 발생한다고 보고되었습니다.

\Program Files\IBM\VisualAge for Java
\WinNT\Installer

이 문제점을 해결하려면 사용자가 드라이버 또는 디렉토리에서 필요한 권한을 가지고 있음을 확인하십시오. 이렇게 하려면 다음 단계를 따르십시오.

  1. Windows 탐색기에서, 적절한 드라이브 또는 디렉토리를 선택하십시오.
  2. 폴더를 오른쪽 클릭한 다음 팝업 메뉴에서 등록 정보를 선택하십시오.
  3. 보안 탭을 선택하십시오. 사용 권한을 클릭하십시오.
  4. Everyone을 선택하십시오. 액세스 유형 드롭다운 메뉴에서 모든 권한을 선택하십시오.
  5. 서브디렉토리에서 사용 권한 바꾸기 선택란을 선택하십시오.
  6. 확인을 클릭하십시오.
  7. 모든 서브디렉토리에서 사용 권한을 대체하려는지를 확인하는 메시지가 나타나면 예를 클릭하십시오.
  8. 확인을 클릭하십시오.
  9. VisualAge for Java를 설치하십시오.

내부 오류 2735 엔진 작동 개시

오류 2735가 표시되면, 다음 단계를 수행하여 이를 해결하십시오.

  1. 사용자의 Windows 32 시스템 디렉토리에서 다음 파일을 검색하십시오.
  2. shd401lc.dll을 shd401lc.old로 이름을 바꾸십시오.
  3. shdoclc.dll을 shdoclc.old로 이름을 바꾸십시오.
  4. 시작 > 수행을 선택하여 수행 대화 상자를 여십시오. 다음 명령을 수행하여 .dll 파일을 등록 해제하십시오. 
  5. 수행 대화 상자에서 다음 명령을 수행하여 이 dll을 등록하십시오.
  6. VisualAge for Java를 설치하십시오.

오류 1606/내부 오류 2707

다음 오류 메시지가 표시되면 공용 관리 도구 레지스트리 파일 값이 잘못된 것입니다.

오류 1606. 네트워크 위치 \Profiles\AllUsers\StartMenu\Programs\Administrative Tools\를 액세스할 수 없음.
내부 오류 2707. INSTALLDIR.

VisualAge for Java를 설치하기 전에 공용 관리 도구 레지스트리 파일 값을 편집해야 합니다. 그렇게 하려면 다음 단계를 따르십시오.

  1. 명령 프롬프트에서 regedit.exe를 실행하십시오.
  2. 확장한 후 키를 선택하십시오.
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folder
  3. 공용 관리 도구를 선택하십시오.
  4. 편집 > 수정을 선택하십시오.
  5. 값 데이터 필드에 다음을 입력하십시오. %SystemRoot%\Profiles\AllUsers\StartMenu\Programs\Administrative Tools
  6. 확인을 클릭하십시오.
  7. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.
  8. VisualAge for Java를 설치하십시오.

A.4.2 설치 해제시 알려진 문제점 및 제한사항

다음은 설치 해제 중에 알아야 할 사항의 목록입니다.

A.4.2.1 디스크 공간

Windows 시스템 드라이브에는 최소한 2MB의 여유 공간이 있어야 하며, 환경 변수 TEMP 또는 TMP는 5MB의 여유 공간이 있는 유효한 임시 디렉토리를 지정해야 합니다.

A.4.2.2 Distributed Debugger 설치 해제

VisualAge for Java 설치의 일부로 Distributed Debugger를 설치한 경우에는 Distributed Debugger를 설치 해제하기 전에 VisualAge for Java를 설치 해제해야 합니다. VisualAge for Java를 설치 해제한 후 디버거 설치 디렉토리로 가서 설체 해제 프로그램을 실행하여 Distributed Debugger를 설치 해제하십시오.

VisualAge for Java를 설치 해제한 후 Distributed Debugger를 설치 해제할 수 없으면, 다음 레지스트리 키를 삭제하십시오.

HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/ParentProducts/Visual Age for Java

디버거를 다시 설치 해제하십시오. Distributed Debugger를 다른 제품과 함께 사용하는 경우에는 이 단계를 따르지 마십시오. 레지스트리 키를 삭제한 다음에는 디버거를 더 이상 사용할 수 없기 때문입니다.

다음 단계를 수행하십시오.

  1. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  2. 레지스트리 편집기에서 키를 확장하고 선택하십시오.
    HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/ParentProducts/Visual Age for Java
  3. 이 키에 대해 메뉴 막대에서 편집 > 삭제를 선택하십시오
  4. 키 삭제를 확정하도록 요청되면 예를 선택하십시오.
  5. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.

물론 다음의 레지스트리 키 값도 1로 설정해야 합니다.

HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/refcount

A.4.2.3 환경 변수(Windows 98)

Windows 98에서 VisualAge for Java를 설치 해제하면 autoexec.bat 파일에 몇 가지 환경 항목이 남게 됩니다. 보통은 이런 잔존 항목은 아무 문제도 야기하기 않지만 제품을 여러번 설치 및 설치 해제하면 두 가지 문제점이 발생합니다. 경로 명령문이 상충되어 온라인 도움말이 작동되지 않을 수 있고 또는 경로 공간이 부족하여 제품 재설치를 방해할 수 있습니다.

문제점을 해결하려면 다음을 수행하십시오.

  1. autoexec.bat 파일의 백업 사본을 작성하십시오.
  2. 다음 단계를 수행하여 시스템에 HTML 탐색 엔진이 필요한 다른 프로그램(예: DB2)이 있는지 확인하십시오.
    a) VisualAge for Java를 설치 해제하고 시스템을 다시 부트하십시오.
    b) 명령 프롬프트에서 regedit.exe을 입력하고, 레지스트리 편집기에서 HKEY_LOCAL_MACHINE\SOFTWARE\ 트리를 확장하십시오. 이 트리에 IBM 디렉토리가 있으면, 이를 확장하여 NetQuestion 디렉토리가 있는지 확인하십시오. 이 디렉토리가 보인다면 사용자는 아마도 다른 IBM 제품과 함께 탐색 엔진을 사용하고 있을 것입니다.
  3. 다른 제품용 HTML 엔진을 사용하지 않고 있다면, VisualAge for Java를 재설치하기 전에 사용자의 autoexec.bat 파일에 있는 모든 IMN 또는 IMQ 항목을 제거하십시오.
  4. 다른 제품에 대해 HTML 탐색 엔진을 사용하고 있으면 autoexec.bat 파일에서 다음의 중복된 항목을 삭제하십시오.
    IMNINST
    IMNINSTSRV
    IMNNQ
    IMNNQ_95
    IMQCONFIGCL
    IMQCONFIGSRV
    또한 IF EXIST X:\IMNNQ_95\IMNENV.BAT CALL IMNEV.BAT 행의 중복된 항목도 삭제하십시오.
  5. 중복된 항목을 제거할 때 원래의 항목을 제거하지 않도록 하십시오. 어느 항목이 원래 항목인지 확실하지 않으면 시스템이 구상하는 NetQuestion이 설치 위치를 결정해야 합니다. 다음 단계를 수행하십시오.
    1. 명령 프롬프트에서 regedit.exe를 입력하십시오.
    2. 레지스트리 편집기에서 키를 확장하십시오.
      \\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\Installation Directory
    3. 이 키 내부의 디렉토리 값이 NetQuestion이 설치된 경로를 보여 줍니다. NetQuestion이 제대로 작동하려면 특정 환경 변수 값의 일부에 이 디렉토리가 들어 있어야 합니다.

      위의 환경 변수 중에, 값의 일부로 레지스트리에 들어 있는 것과 다른 디렉토리를 포함하는 변수가 있으면 해당 변수를 삭제하십시오.

A.4.2.4 NetQuestion 설치 해제

VisualAge for Java를 설치 해제할 때 NetQuestion이 설치 해제되지 않을 수 있습니다. NetQuestion이 설치 해제되지 않았는데 차후에 제품을 다시 설치하려 하면 문제가 발생할 수 있습니다. 

VisualAge for Java에서 설치한 NetQuestion 파일을 제거하려면, 다음의 단계를 수행하십시오. 다른 제품(예를 들어, DB2)에서 설치한 NetQuestion 파일에는 영향을 미치지 않습니다.

  1. NetQuestion 디렉토리를 찾으려면, 명령 프롬프트에 다음과 같이 입력하십시오: set imninstsrv. 이 명령은 NetQuestion이 시스템에 설치된 위치를 제공합니다. 예를 들면, 다음과 같습니다.

    IMNINSTSRV=C:\imnnq_nt

    VisualAge for Java를 설치한 드라이브와 사용 중인 운영 체제에 따라, NetQuestion 디렉토리 위치가 다르게 표시될 수도 있습니다. "환경 변수 imninstsrv가 정의되지 않음"과 같은 오류 메시지를 수신한 경우, 모든 NetQuestion 파일이 설치 해제된 것입니다.

  2. NetQuestion 디렉토리(IMNINSTSRV= 뒤에 나오는 정보)로 가십시오.
  3. vahcfg remove /p vj32를 입력하십시오.

VisualAge for Java가 설치한 모든 NetQuestion 파일이 제거됩니다. 

나중에 VisualAge for Java를 재설치한 후 도움말이 표시되지 않을 경우에 도움말 실패 복구에 관한 자세한 내용은 문제점 해결 안내서(Troubleshooting Guide)를 참조하십시오. 문제점 해결 안내서(trshoot.htm)의 위치는 제품 CD의 VisualAge for Java, Professional Edition 및 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java를설치한 후에도 안내서는 X:\IBMVJava에 위치하는데 여기서 X:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.

파트 B: VisualAge for Java, Enterprise Edition

B.1.0 필수 요구사항

B.1.1 일반적인 필수 요구사항

VisualAge for Java, 버전 4.0 개정판에는 다음과 같은 하드웨어 및 소프트웨어 필수 요구사항이 있습니다.

DB2 및 VisualAge for Java에서 동시에 Websphere Application Server를 실행할 경우에는 최소 512MB를 권장합니다.

팀 환경에서 작업할 경우 EMSRV, 버전 7.1을 사용해야 합니다. 버전 6.x 또는 7.0에서 버전 7.1로 이주에 관한 내용은 파트 C를 참조하십시오. 

* 주: VisualAge for Java는 Logitech 화면 이동 마우스를 지원하지 않습니다. 화면 이동 조치를 마우스에 다시 맵핑하는 드라이버가 있는 Logitech 마우스를 사용하여 화면 이동할 경우 시스템 오류가 발생합니다.

B.1.2 컴포넌트별 필수 요구사항

특정 컴포넌트에는 특정한 필수 요구사항이 필요합니다.

B.2.0 설치

이 절에는 VisualAge for Java, 버전 4.0 설치에 관한 정보가 들어 있습니다. 중요사항: VisualAge for Java의 이전 버전에서 이주할 경우, VisualAge for Java, 버전 4.0을 설치하기 전에 3.0 절을 참조하십시오. Windows 2000에 설치하는 데 대한 정보는 2.5 절을 참조하십시오.

최근에 알려진 문제점과 제한사항에 대해서는 README(제품 CD의 루트 디렉토리에 있음)도 참조하십시오.

중요사항 : Windows 98에서의 CD-ROM 파일 시스템(CDFS) 지원의 제한사항 때문에, 사용자가 선택한 커넥터에 따라 CD-ROM에서 특정 e-business 커넥터 파일의 설치가 실패할 수 있으며 하나 이상의 다음과 같은 오류 대화 상자를 표시할 수 있습니다.

설치되지 않은 모든 파일은 제품 CD의 루트에 위치한 zip 파일(econnfix.zip)에 저장됩니다. Windows 98에 VisualAge for Java를 설치하려고 시도 중이며 위의 메시지 중 하나를 받은 경우, 제품이 설치된 디렉토리로 econnfix.zip을 unzip해야 합니다(예를 들어, 명령 unzip econnfix.zip -d c:\Program Files\IBM\VisualAge for Java\. 여기서 c:\Program Files\IBM\VisualAge for Java\는 제품 설치 디렉토리임). 이 파일이 위치되면, 커넥터가 제대로 기능합니다.

B.2.1 VisualAge for Java, 버전 4.0, Enterprise Edition 설치

제품을 설치하기 전에 다음 항목을 점검하십시오.

VisualAge for Java를 Windows, Millennium 개정판에 설치하려고 하면, 환경 공간을 늘리라는 메시지가 표시됩니다. 설치하기 전에 아래에 요약되어 있는 단계를 수행해야 합니다. 그렇지 않으면, VisualAge for Java 도움말 시스템이 제대로 작동되지 않습니다. 환경 공간을 늘리려면 다음 단계를 수행하십시오.

  1. 설치 화면을 종료하십시오.
  2. Windows 탐색기를 여십시오. Windows 디렉토리를 찾으십시오(예를 들어, C:\Windows).
  3. Command.com을 마우스 오른쪽 단추로 클릭한 다음, 팝업 메뉴에서 특성을 클릭하십시오. 메모리 탭을 클릭하십시오.
  4. 초기 환경 박스에서 초기 환경의 크기를 4,096바이트로 설정하십시오. 확인을 클릭하십시오.
  5. Windows 탐색기를 닫으십시오.
  6. 시스템을 다시 부트하십시오.
  7. VisualAge for Java 설치를 다시 시작하십시오.

VisualAge for Java 팀 클라이언트를 설치하는지 또는 국지 저장소를 갖는 클라이언트를 설치하는지에 관계없이 다음을 수행해야 합니다. 팀 클라이언트 설치에 대한 자세한 내용은 2.3 절을 참조하거나 국지 저장소 설치에 대한 자세한 내용은 2.4 절을 참조하십시오.

B.2.1.1 제품 CD에서 VisualAge for Java, 버전 4.0 설치

  1. VisualAge for Java의 이전 버전으로부터 이주할 경우에는 설치 절차를 계속하기 전에 이 문서의 3.0 절, "이전 VisualAge for Java로부터 이주"를 참조하십시오.
  2. CD 드라이브에 CD-ROM을 삽입하십시오.  
  3. 시스템에서 자동 실행이 되지 않으면, CD 드라이브의 루트에서 setup.exe를 실행하십시오.
  4. 제품 설치를 선택하십시오. VisualAge for Java의 설치를 시작하려면 VisualAge for Java 설치를 선택하십시오. VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하려거나 별도 시스템에서 수행 중인 프로그램을 디버그하려면 B.2.1.1.1 Distributed Debugger 설치 정보에 대한 절을 참조하십시오.  
  5. 화면에 표시된 지시사항을 따르십시오.
  6. VisualAge for Java IDE를 시작하십시오.

자동 설치
VisualAge for Java, 버전 4.0을 자동으로 설치하려면 ivj40\setup 디렉토리에서 다음 명령을 호출하십시오.

setup /s /v/qn

VisualAge for Java가 c:\Program Files\IBM\VisualAge for Java 기본 디렉토리에 자동으로 설치됩니다.

다른 디렉토리(예: d:\IBMVJava40)로 자동 설치하려면, ivj40\setup 디렉토리에서 다음 명령을 호출하십시오.

setup /s /v"INSTALLDIR=\"d:\IBMVJava40\" /qn"

여기서 d:\IBMVJava40은 설치 대상 디렉토리입니다.

주: 자동으로 VisualAge for Java를 설치할 때에는 공유 저장소에 연결할 수 없고, 자동으로 설치할 때에는 국지 저장소에만 연결할 수 있습니다. 자동으로 설치하면서 팀 환경에서 작업하기를 원하는 경우, 국지적으로 설치한 다음 제품을 설치하고 IDE를 시작한 후 공유 저장소에 연결해야 합니다. 팀 환경에서의 작업을 제외한 국지적 설치 방법에 관한 지시사항에 대해서는 pdf 디렉토리에 있는 team.pdf 파일을 참조하십시오. pdf 디렉토리는 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

B.2.1.1.1 제품 CD에서 DistributedDebugger 설치
VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하려거나 별도 시스템에서 수행 중인 프로그램을 디버그하려면 Distributed Debugger를 설치해야 합니다 Distributed Debugger는 Windows, AIX, OS/2, HP-UX, Solaris, Linux 및 Linux/390 운영 체제에서 지원됩니다. 각 운영 체제에 대한 설치 지시사항은 아래 준비되어 있습니다. Distributed Debugger 파일은 모두 추가 기능 CD에 있습니다.

 Windows용 Distributed Debugger

  1. 추가 기능 CD에서 Distributed Debugger를 설치할 수 있습니다. 추가 기능 설치 화면에서 제품 설치를 선택한 다음 Distributed Debugger 설치를 선택하십시오.
AIX용 Distributed Debugger  
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 설치 미디어에서 스크래치 디렉토리로 idebug.tar.Z를 복사하십시오.
  3. 디렉토리를 스크래치 디렉토리로 변경하십시오.
  4. uncompress idebug.tar.Z 명령을 실행하여 idebug.tar.Z 파일을 압축 해제하십시오.
  5. tar -xvf idebug.tar 명령을 실행하여 idebug.tar에서 설치 이미지를 추출하십시오.
  6. 루트에서 installp -ac -X -V2 -g -N -d idebug 명령을 실행하십시오.
  7. 또한 smitty install_latest 명령으로 SMIT를 사용할 수도 있습니다.

OS/2용 Distributed Debugger

추가 기능 CD의 Debugger\OS2 서브디렉토리에 있는 README_install.txt 파일의 지시사항을 따르십시오.

HP-UX용 Distributed Debugger

필수 요구사항: 
설치 및 Java 디버깅에 Java 버전 1.3이 필요합니다.

  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. install.class를 스크래치 디렉토리로 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면, cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. 루트에서 java install.class 명령을 입력하십시오.
Solaris용 Distributed Debugger  
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 스크래치 디렉토리로 dbgsetup 및 idebug.pkg를 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면 cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. chmod +x dbgsetup 명령을 실행하여 "dbgsetup"을 실행 가능하게 하십시오.
  5. 루트에서 ./dbgsetup idebug.pkg 명령을 입력하여 디버거를 설치하십시오.

Linux용 Distributed Debugger 

루트에서 rpm -Uvh DERJPICL-9-1.i386.rpm 명령을 입력하여 디버거를 설치하십시오.

Linux/390용 Distributed Debugger 

루트에서 rpm -Uvh DERJPICL-9-1.s390.rpm 명령을 입력하여 디버거를 설치하십시오.

OS/390용 Distributed Debugger

  1. Windows용 Distributed Debugger를 설치하십시오.
  2. 제품 CD의 Debugger\OS390 서브디렉토리에 있는 README_install.txt 파일의 지시사항을 따르십시오.

B.2.1.1.2 J2EE 컴포넌트의 베타 버전 설치 
VisualAge for Java의 이번 릴리스에는 Java 2 플랫폼, Enterprise Edition의 몇 가지 컴포넌트의 베타 버전이 있습니다(J2EE). Sun Microsystems Inc.는 공식적으로 J2EE 컴포넌트를 릴리스한 적이 없습니다. 특히 VisualAge for Java의 이번 릴리스에는 다음 J2EE 컴포넌트의 베타 버전이 있습니다.

베타 버전 컴포넌트의 위치는 추가 기능 CD에 있는 extras\BetaJ2EEConnectors 서브디렉토리입니다. 베타 버전을 사용하려면 컴포넌트에 대한 설치 지시사항이 있는 BetaJ2EEConnectors 서브디렉토리의 README 파일을 참조하십시오. 

B.2.1.2. VisualAge for Java, 버전 4.0의 전자 이미지에서 설치
다운로드 시간을 줄이기 위해 Windows용 Enterprise Edition, VisualAge for Java의 전자 이미지는 여러 파트로 나뉘어져 있습니다.

B.2.1.2.1 IDE
통합 개발 환경에 대해 14개의 다운로드 가능한 파트가 있습니다. 14개 파트 모두가 자동 압축 해제 아카이브입니다. 처음 두 파트는 반드시 설치해야 하며 나머지는 선택적입니다. 각 아카이브의 내용에 대해서는 다음 목록을 참조하십시오.

처음 두 개의 파트와 원하는 선택적 파일을 다운로드했으면, 각 자동 압축 해제 아카이브를 실행하고 각각이 동일한 임시 디렉토리로 추출되었는지 확인하십시오. 모든 파일이 추출되었으면, 임시 디렉토리로 가서 setup.exe를 실행하십시오. 화면에 표시되는 지시사항에 따라 IDE를 시작하십시오.

영어 이외의 언어로 작업하려면 setup.exe를 실행하기 전에 정확한 파트를 다운로드하여 그 언어에 대한 자동 압축 해제 아카이브를 수행해야 합니다. VisualAge for Java를 설치한 후에는 언어를 변경하거나 추가할 수 없습니다.

VisualAge for Java의 전자 이미지로 작업 중인 경우, 프로그램 추가/제거 대화 상자(시작 > 설정 >제어판 > 프로그램 추가/제거)를 사용하여 사용자의 초기 설치 이후에 추가적인 VisualAge for Java 컴포넌트를 설치할 수 없습니다. 그렇게 하려는 경우에는 오류 메시지를 받게 되며 추가적인 컴포넌트를 설치할 수 없습니다. VisualAge for Java에 추가 컴포넌트를 추가하려면 다운로드된 파트를 추출하는 경로에서 setup.exe를 수행해야 합니다.

다음은 각 파트에 대한 설명입니다.

B.2.1.2.2. Distributed Debugger
Distributed Debugger에서 지원하는 각 대상 운영 체제에 대해 별도로 다운로드가 가능한 파트가 있습니다 VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하거나 별도 시스템에서 수행 중인 프로그램을 디버그하려는 경우, Distributed Debugger를 다운로드해서 설치해야 합니다. 각 운영 체제에 대한 설치 지시사항은 아래에서 제공됩니다. 이 지시사항 및 라이센스 계약 관련 정보는 각 파트에 포함된 readme-1st.txt 파일에도 있습니다.

VisualAge for Java - Windows용 Distributed Debugger에는 사용자 인터페이스 및 Windows용 디버그 엔진이 들어 있습니다. 이 파트는 자동 압축 해제 아카이브입니다. 설치하려면 다음 단계를 따르십시오.

  1. VisualAge for Java를 다운로드하고 압축 해제했으면 setup.exe를 실행하고 제품 설치를 선택하십시오. 그 다음 Distributed Debugger 설치를 선택하십시오. 
  2. VisualAge for Java 없이 Distributed Debugger를 설치하려면, 명령 프롬프트에서 DebugDirectory\windows 디렉토리 (DebugDirectory 디렉토리는 Distributed Debugger를 압축 해제시켜 보낸 곳임)를 열고 setup.bat 명령을 실행하십시오.
VisualAge for Java - AIX용 Distributed Debugger에는 AIX 디버그 엔진이 들어 있습니다. 설치하려면 다음 단계를 따르십시오.
  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. 설치 미디어에서 스크래치 디렉토리로 idebug.tar.Z를 복사하십시오.
  3. 디렉토리를 스크래치 디렉토리로 변경하십시오.
  4. uncompress idebug.tar.Z 명령을 실행하여 idebug.tar.Z 파일을 압축 해제하십시오.
  5. tar -xvf idebug.tar 명령을 실행하여 idebug.tar에서 설치 이미지를 추출하십시오.
  6. 루트에서 installp -ac -X -V2 -g -N -d idebug 명령을 실행하십시오.
  7. 또한 smitty install_latest 명령으로 SMIT를 사용할 수도 있습니다.

VisualAge for Java - OS/2용 Distributed Debugger에는 OS/2 디버그 엔진이 들어 있습니다. 설치하려면 (OS/2용 Distributed Debugger 파트에 포함되어 있는) README_install.txt의 지시사항을 따르십시오.

VisualAge for Java - HP-UX용 Distributed Debugger에는 HP-UX용 디버그 엔진이 들어 있습니다.

필수 요구사항: 
설치 및 Java 디버깅에 Java 버전 1.3이 필요합니다.

설치하려면 파일을 untar하고 다음 지시사항을 따르십시오.

  1. 스크래치 디렉토리(예: /tmp/idebug)를 작성하십시오.
  2. install.class를 스크래치 디렉토리로 복사하십시오.
  3. 명령 프롬프트에서 스크래치 디렉토리를 여십시오. 스크래치 디렉토리가 /tmp/idebug이면, cd /tmp/idebug 명령을 실행하여 이를 여십시오.
  4. 루트에서 java install.class 명령을 입력하십시오.
VisualAge for Java - Solaris용 Distributed Debugger에는 Solaris용 운영 환경에 대한 디버그 엔진이 들어 있습니다. 설치하려면 파일을 untar하고 다음 지시사항을 따르십시오.
  1. chmod +x dbgsetup 명령을 실행하여 "dbgsetup"을 실행 가능하게 하십시오.
  2. 루트에서 ./dbgsetup idebug.pkg 명령을 입력하여 디버거를 설치하십시오.

VisualAge for Java - Linux용 Distributed Debugger에는 Linux용 디버그 엔진이 들어 있습니다. 이를 설치하려면 파일을 untar하고 다음 지시 사항에 따라 디버거를 설치하십시오.

루트에서 rpm -Uvh DERJPICL-9-1.i386.rpm 명령을 입력하십시오.

VisualAge for Java - Linux/390용 Distributed Debugger에는 Linux/390용 디버그 엔진이 들어 있습니다. 이를 설치하려면 파일을 untar하고 다음 지시 사항에 따라 디버거를 설치하십시오.

루트에서 rpm -Uvh DERJPICL-9-1.s390.rpm 명령을 입력하십시오.

OS/390용 Distributed Debugger

  1. Windows용 Distributed Debugger를 설치하십시오.
  2. Windows의 기본 설치 디렉토리에 있는 README_install.txt의 지시사항을 따르십시오.

B.2.1.2.3 EMSRV(팀 서버)
VisualAge for Java - EMSRV 7.1에는 팀 개발 환경에 대한 저장소 서버 프로그램이 들어 있습니다. 단일 아카이브 파트에 Windows, AIX, OS/2, NetWare, HP-UX, Linux 및 Solaris에 대한 서버 코드가 ZIP 파일 형식으로 들어 있습니다. 설치하려면 이 파트를 압축 해제하고 instmigr.htm의 지시사항을 따르십시오.

B.2.1.2.4 IBM Developer Kit 1.2.2 
VisualAge for Java - IBM Developer Kit 1.2.2에는 Windows 플랫폼용 IBM Developer Kit, Java Technology Edition, v 1.2.2, PTF 9가 들어 있습니다.  이 제품은 자동 압축 해제 아카이브입니다. 설치하려면, 이 파일을 실행(그러면, 아카이브로부터 추출된 후 자동으로 설치 프로그램을 시작함)하고 지시사항을 수행하십시오.

B.2.2 차후에 추가 컴포넌트 설치

초기 설치 이후 언제라도 추가 VisualAge for Java 컴포넌트를 설치하려면, CD 드라이브에 CD-ROM을 삽입한 후 VisualAge for Java 설치를 선택하고 프로그램 유지보수 화면에서 수정을 선택하십시오. 시스템에서 자동 실행이 되지 않으면, CD 드라이브의 루트에서 setup.exe를 실행하십시오. VisualAge for Java 전자 버전을 갖고 있으면, 수동으로 setup.exe를 실행한 후 동일한 단계를 반복하십시오.

모든 컴포넌트는 현재 설치 상태 표시와 함께 편집 창에 나열됩니다. 빨간색 'X'는 현재 컴포넌트가 설치되지 않았음을 나타냅니다. 이 컴포넌트를 설치하도록 선택할 수 있습니다. 빨간색 'X'가 표시되지 않은 컴포넌트는 이미 설치되어 있으므로 선택하지 마십시오. 

VisualAge for Java, 버전 4.0의 두번째 인스턴스는 설치할 수 없습니다. 제품을 먼저 설치 해제하지 않으면 설치 언어를 변경할 수 없습니다.

B.2.3 VisualAge for Java 팀 클라이언트 설치

각각의 개발 팀 구성원이 다음 단계를 따르기 전에 EMSRV 관리자는 서버를 설치 및 시작하고 클라이언트 연결을 테스트하며 팀 개발자를 저장소 사용자 목록에 추가해 놓아야 합니다. 그 수행 방법에 대해서는 이 안내서의 파트 C를 참조하십시오. 파트 C에는 팀 저장소 이주에 대한 정보가 들어 있습니다.

다음 지시사항에서는 서버에 설치된 공유 저장소가 ivj.dat라고 가정합니다. EMSRV, 버전 7.1이 서버에 설치되어 있어야 합니다. 이전 버전의 EMSRV에 연결하려고 하면 오류 메시지가 수신됩니다.

  1. VisualAge for Java, 버전 4.0을 설치하기 전에, 관리자에게 다음 정보를 요청하십시오.
  2. VisualAge for Java, 버전 4.0 설치를 시작하십시오. 설치에 대한 자세한 정보는 2.0 절을 참조하십시오. 이전 버전의 VisualAge for Java에서 이주하는 경우, 이주 프로세스에 대한 자세한 내용은 3.0 절을 참조하십시오.
  3. 설치 프로그램이 프롬프트하면 서버에 상주하는 저장소를 사용할 것인지를 지정하십시오. 항상 공유 저장소에 연결된 클라이언트로 작동하는 대신, 독립 모드로 작동하기 위해 사용자 워크스테이션에 국지 저장소를 갖고자 하는 경우, 2.4 절 아래 대안을 참조하십시오. 관리자로부터 제공받은 것과 같이, 서버의 TCP/IP 호스트 이름(또는 IP 주소) 및 저장소의 이름을 제공하십시오. EMSRV 프로그램을 시작할 때 관리자가 작업 디렉토리를 지정하지 않았으면, 해당 파일에 대한 서버의 경로 정보를 사용하여 저장소의 이름을 완전히 규정해야 합니다. 설치 프로그램은 자동으로 클라이언트의 ide.ini 파일에 서버 주소 및 저장소 정보를 삽입해야 합니다.
  4. 관리자가 설정한 저장소 사용자 목록에서 작업영역 소유자 이름을 선택하도록 요청됩니다. 사용자 이름을 선택하십시오. 암호 보호가 작동되고 있으면 사용자 암호를 제공해야 합니다.

    진행 막대는 작업영역이 저장소에 연결 중임을 나타냅니다. 사용자 목록 대신 복구불가능한 오류가 발생했음을 나타내는 오류 메시지가 나타나면, 다음 상황 중 하나가 발생한 것입니다.
    1. 서버가 활동 중이 아닙니다.
    2. 워크스테이션에 VisualAge for Java를 설치할 때 잘못된 서버 이름을 지정했습니다.
    3. 설치 중에 잘못된 저장소를 지정했습니다.

    팀 클라이언트에서 ide.ini 파일을 편집하여 서버 또는 저장소를 수정할 수 있습니다.

B.2.4 독립형 저장소가 있는 클라이언트 설치

공유 저장소에 연결되지 않았을 때 사용하기 위해 워크스테이션에 VisualAge for Java 소스 코드 저장소를 두고자 할 수 있습니다. 이런 경우, 워크스테이션에 VisualAge for Java, 버전 4.0을 설치할 때 저장소를 서버가 아닌 국지 시스템에 있도록 지정하십시오. 설치 프로그램에서 저장소를 작성합니다.

팀 서버에서 공유 저장소를 사용하려면, 온라인 도움말이나 team.pdf 파일을 참조하십시오. team.pdf 파일은 pdf 디렉토리에 있습니다. pdf 디렉토리의 위치는 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

B.2.5 Windows 2000에 대한 설치 및 사용 고려사항  

VisualAge for Java의 이번 릴리스에서는 Windows 2000용 조정 지원(Microsoft에 의해 정의됨)을 계속 제공합니다. 

기본 설치 디렉토리는 <Program Files>\IBM\VisualAge for Java입니다. Windows 2000에서는 기본적으로 오직 관리자 및 표준(파워) 사용자만 <Program Files>로 설치할 수 있습니다. 정규(제한) 사용자는 이 위치로 쓰기를 할 수 없습니다.

VisualAge for Java의 현재 설계 때문에, 제품을 이 위치에 설치하고 정규(제한) 사용자가 사용하는 경우, <ProgramFiles>에서 정규 사용자의 쓰기 액세스를 허용하도록 IBM 또는 IBM\VisualAge for Java 디렉토리에 대한 보안 설정을 변경해야 합니다. 이 작업이 실패하면 IDE를 시작하거나 IDE 내에서 일부 VisualAge for Java 도구를 사용하는 동안에 실패가 발생할 수 있습니다.

AS/400 엔터프라이즈 툴킷에 대한 서버 목록은 "<ProgramFiles>\IBM\shared files\fvdctcp.txt"로 저장됩니다. 다시 말해, 기본값으로 이 위치는 보호되며 일반 사용자에 의해 대체될 수 없습니다. 충분한 권한이 없는 사용자가 AS/400 SmartGuides의 서버 목록 추가/수정 단추를 사용하여 서버 목록을 작성하거나 갱신하려 하면, 파일 작성 또는 갱신은 Java 코드 내의 입출력 오류와 함께 실패하여 로그 또는 콘솔에 표시될 수도 있고 표시되지 않을 수도 있습니다.

시스템 관리자는 이 위치에 대해 일반 사용자에게 쓰기 액세스를 부여할 것인지 아니면 보호 상태를 유지하여 파일을 수동으로 로드함으로써 권한이 없는 사용자가 파일을 갱신하는 것을 막을 것인지를 결정해야 합니다.

B.2.6 IBM Developer Kit, Java Technology Edition, v1.2.2, PTF 9 설치 

제품 CD에서 VisualAge for Java를 설치한 경우, IBM Developer Kit 디렉토리에서 install.exe를 실행하여 IBM Developer Kit, Java Technology Edition 버전 1.2.2, PTF 9를 설치해야 합니다. 이 디렉토리의 위치는 추가 기능 CD에 있습니다. VisualAge for Java의 전자 버전이 있으면 이 디렉토리의 위치는 임시 디렉토리(파트를 추출해 보낸)지만 instrall.exe를 실행할 필요가 없는데, 그 이유는 설치 프로그램이 다운로드된 IBM Developer Kit 아카이브로부터 압축 해제된 후 자동으로 시작되기 때문입니다. 

IBM Developer Kit에 관한 자세한 내용은 IBM Developer Kit 디렉토리의 README 파일을 참조하십시오.

B.3.0 VisualAge for Java 이전 버전으로부터 이주  

이주 프로세스를 시작하기 전에 컴포넌트 특정 및 일반 정보에 대해서는 파트 D 및 파트 E를 참조하십시오.

VisualAge for Java, 버전 4.0 업그레이드에서는 저장소의 시스템 클래스 라이브러리를 올바른 릴리스 레벨로 가져오기 위해 설치 중에 저장소 갱신을 수행하게 됩니다. 그러기 위해서는 업그레이드하는 동안 저장소가 읽기-쓰기 액세스가 가능해야 합니다. 이 작업 중에는 사용자 코드가 수정되지 않습니다.

VisualAge for Java, Enterprise Edition의 이전 버전으로부터 이주할 경우, 팀 환경이 아닌 독립형 환경에서 작업 중이고 독립형 환경에서 작업을 계속하려면, 이 문서의 파트 A에 있는 Professional Edition에 대한 이주 지시사항을 수행하십시오.

주: VisualAge for Java, 버전 3.5 또는 버전 3.5.3으로부터 버전 4.0으로 이주할 때, 설치 프로세스가 멈춘 것처럼 나타날 수 있습니다. 이런 현상이 발생하는 이유는 (3.5 버전 파일과 4.0 버전 파일을 비교하는) "DoCosting" 기능을 실행하는데 3분 가량이 소요되어 마치 설치 프로세스가 멈춘 것처럼 보이기 때문입니다.

팀 환경으로부터 또는 팀 환경으로 이주할 경우, 이주 프로세스를 시작하기 전에 다음 문제점을 고려하십시오.

이주할 때 수행해야 하는 단계는 상황과 위의 질문에 대한 회신에 따라 달라집니다.

다음의 이주 시나리오는 가장 복잡한 상황 중 하나입니다. 이 시나리오에서는, 버전 3.5 또는 버전 3.5.3 국지 저장소에 하나 이상의 공유 저장소와 N명의 개발자가 있습니다. 새로운 버전 4.0 저장소를 사용하면서, 기존의 공유 저장소에 있는 모든 데이터도 사용하기를 원합니다. 

주: 이 시나리오는 JDK 1.1.x 국지 저장소가 아닌 버전 3.5 또는 버전 3.5.3(Java 2) 국지 저장소에 대해 다루고 있습니다. JDK 1.1.x 국지 저장소 정보를 버전 4.0 저장소로 반입하려는 경우, 파트 A의 3.2 절에 있는 지시사항을 따르십시오. 

  1. EMSRV를 버전 7.1로 업그레이드하십시오. 팀 관리자는 EMSRV, 버전 7.1을 설치해야 합니다. 이 타스크의 수행 방법에 대해서는 파트 C의 2 절을 참조하십시오. 
  2. 사용자 데이터의 백업 사본을 작성하십시오.
    1. 프로젝트 및 패키지를 버전화하십시오. 버전화된 프로젝트 및 패키지만이 VisualAge for Java, 버전 4.0 저장소로 반입됩니다. 버전화 지시사항은 VisualAge for Java 온라인 도움말을 참조하십시오.
    2. VisualAge for Java 디렉토리 트리 외부의 새 위치에 저장소를 저장하십시오. 저장소의 파일명 및 경로는 x:\IBMVJava\ide\repository\ivj.dat이며, 여기서 x:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다. 
      주: 버전 3.5 또는 버전 3.5.3으로부터 이주하는 경우, 저장소에는 프로젝트 자원 파일의 버전화된 사본도 포함됩니다. 자원 파일의 위치는 x:\IBMVJava\ide\repository\ivj.dat.pr 디렉토리입니다. VisualAge for Java 디렉토리 트리 외부에 ivj.dat.pr 디렉토리의 사본을 저장해야 합니다.
  3. 팀 관리자는 국지 저장소를 포함하여 VisualAge for Java, 버전 4.0의 전체 설치를 수행합니다. 관리자는 국지 저장소의 전체 내용을 모든 공유 저장소로 반출합니다. 이 타스크의 수행 방법에 대해서는 파트 B, 3.1 절을 참조하십시오.
  4. 모든 버전 3.5 또는 버전 3.5.3 사용자는 버전 4.0을 국지적으로 설치하며, 이 때 N개의 국지 저장소를 자동으로 업그레이드합니다.

이제 이주 프로세스는 완료되었으며 사용자는 국지 저장소 또는 공유 저장소 간에 원하는 대로 전환할 수 있습니다. 주: 팀 환경으로부터 국지 환경으로 이주할 경우, 기존 공유 저장소를 국지 저장소로 수작업으로 반출해야 합니다. 또한 국지 저장소가 있으면, 기존 국지 저장소에서 사용할 프로젝트를 새로운 버전 4.0 국지 저장소로 반입해야 합니다.

B.3.1 VisualAge for Java 이전 버전으로부터 공유 저장소 이주

다음의 단계를 수행하기 전에 먼저 EMSRV 7.1로 업그레이드해야 합니다. C.3.1 절에 이 타스크 수행 방법에 관한 지시사항이 있습니다 

VisualAge for Java, 버전 4.0에 대한 작업을 할 수 있도록 버전 2.0 또는 3.0x(JDK 1.1 기반) 또는 3.0x, Early Adopters 또는 3.5(JDK 1.2 기반) 공유 저장소를 업그레이드할 수 있습니다. 아래 단계에서 팀 관리자는 국지 저장소를 사용하여 VisualAge for Java, 버전 4.0을 전체 설치합니다. 관리자는 국지 저장소의 전체 내용을 모든 공유 저장소로 반출합니다.

서버의 기존 저장소를 VisualAge for Java, 버전 4.0과 작업할 수 있도록 업그레이드하려면, 다음 단계를 수행하십시오.

  1. 국지 저장소를 포함하여 VisualAge for Java, 버전 4.0의 전체 설치를 수행하십시오. 이 타스크의 수행 방법에 대해서는 파트 B의 2.0 절을 참조하십시오.
  2. 버전 4.0 IDE를 시작하십시오. 국지 저장소에 연결됩니다.
  3. Workbench에서 파일 > 반출을 선택한 후, 저장소 라디오 단추를 누르고 다음을 클릭하십시오. EMSRV 서버가 있는 공유 저장소를 선택하십시오. EMSRV 서버 주소가 있는 공유 저장소 필드에 서버의 IP 주소 또는 서버의 이름을 입력하십시오.
  4. 검색을 눌러 공유 저장소를 찾거나 저장소 이름 필드에 공유 저장소의 이름 및 파일명을 입력하십시오.
  5. 프로젝트를 선택하십시오. 세부사항을 눌러 소스 저장소로부터 반출될 수 있는 버전화된 프로젝트 목록을 참조하십시오. 
  6. 모든 프로젝트 개정판을 선택하고 이를 반출하십시오.
  7. 완료를 클릭하십시오

모든 프로젝트가 공유 저장소로 복사됩니다. 프로젝트 자원 파일이 반출됩니다. 반출할 저장소가 sample.dat이면, 프로젝트 자원이 sample.dat.pr이라는 폴더로 반출됩니다.

B.4.0 알려진 문제점 및 제한사항

또한 최근에 알려진 문제점과 제한사항에 대해서는 README(CD의 README 디렉토리에 있음)를 참조하십시오. 

B.4.1 설치시 알려진 문제점 및 제한사항  

다음은 VisualAge for Java 설치 중에 알아야 할 항목의 목록입니다.

B.4.1.1 디스크 제한사항

B.4.1.2 사용자 인증

B.4.1.3 TCP/IP 고려사항

B.4.1.4 쉘 확장(Windows NT)

설치 프로그램이 Windows NT용 쉘 확장을 발견했음을 나타내는 메시지를 받으면 설치를 계속할 수 없습니다. 이런 경우 다음을 수행해야 합니다.

  1. 긴급 복구 디스크가 있는지 확인하십시오. 디스크 작성에 필요한 지시사항은 Windows 도움말 문서에서 사용할 수 있습니다.
  2. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  3. 레지스트리 편집기에서 키를 확장하십시오.
    \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
  4. 위의 키에 대해 이름-데이터 쌍에서 쉘 이름을 선택하십시오.
    중요사항: 이 이름에 대해 기록된 데이터를 적어 두십시오. IBM VisualAge for Java를 설치한 후에 필요합니다.
  5. 쉘 이름-데이터 쌍에 대해 메뉴 막대에서 편집 > 수정을 선택하십시오.
  6. 쉘 이름 값을 Explorer.exe로 설정하십시오. 확인을 클릭하십시오.
  7. 메뉴 막대에서 레지스트리 > 종료를 선택하십시오.
  8. IBM VisualAge for Java 설치를 재시작한 후 완료하십시오.
  9. 설치가 완료되면 다음과 같이 이전 레지스트리 항목을 복원하십시오.
    a. 명령 프롬프트에서 regedit.exe을 입력하십시오.
    b. 레지스트리 편집기에서 \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon 키를 확장하십시오.
    c. 위의 키에 대해 이름-데이터 쌍에서 쉘 이름을 선택하십시오.
    d. 쉘 이름-데이터 쌍에 대해 메뉴 막대에서 편집 > 수정을 선택하십시오.
    e. 쉘 이름의 값을 단계 4에서 기록한 값으로 복원하고 확인을 클릭하십시오.
    f. 메뉴 막대에서 레지스트리 > 편집을 선택하십시오.

B.4.1.5 실패한 설치 복구

설치에 실패하면, 설치된 버전 4.0 파일을 제거해야 합니다. VisualAge for Java를 설치하고자 하는 디렉토리가 비어 있는 경우, 설치 프로세스가 구간 복원되고 설치된 파일이 제거됩니다. 원할 경우 빈 디렉토리를 제거할 수 있으나 반드시 그럴 필요는 없습니다. 그러나, 디렉토리에 파일이 들어 있는 경우 설치 프로세스를 다시 시작해야 합니다. 파일은 유지관리 모드로 열리며 제품을 다시 설치하기 전에 일부만 설치된 버전 4.0을 제거하도록 선택해야 합니다.

레지스트리 항목도 삭제해야 합니다.

\\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\VisualAge for Java for Windows

  1. 긴급 복구 디스크가 있는지 확인하십시오. 디스크 작성에 필요한 지시사항은 Windows 도움말 문서에서 사용할 수 있습니다.
  2. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  3. 레지스트리 편집기에서 키를 확장하고 선택하십시오.
    \\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\VisualAge for Java for Windows\4.0
  4. 이 키에 대해 메뉴 막대에서 편집 > 삭제를 선택하십시오.
  5. 키 삭제를 확정하도록 요청되면 예를 선택하십시오.
  6. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.

설치에 실패하기 전에 NetQuestion 파일이 설치되어 있었으면, 이것도 삭제해야 합니다.

  1. 새로운 명령 프롬프트를 여십시오. 방금 연 명령 프롬프트에서 다음과 같이 입력하여 NetQuestion 파일이 설치되었는지 확인하십시오. set imninstsrv. 이 명령은 NetQuestion이 시스템에 설치된 위치를 제공합니다. 예를 들면, 다음과 같습니다.

    IMNINSTSRV=C:\imnnq_nt

    VisualAge for Java를 설치한 드라이브와 사용 중인 운영 체제에 따라, NetQuestion 디렉토리 위치가 다르게 표시될 수도 있습니다. 변수가 설정된 경우(즉, NetQuestion이 설치된 위치가 제공된 경우), 2 단계를 계속 진행하십시오. 

    "환경 변수 imninstsrv가 정의되지 않음"과 같은 오류 메시지를 수신한 경우, NetQuestion 파일이 설치되지 않았거나 NetQuestion 설치가 성공적으로 완료되지 않은 것입니다. 이 때, 시작 > 찾기 > 파일 또는 폴더를 선택한 후 시스템에서 다음과 같은 파일을 탐색하십시오. vahelp.cfg. 이름이 "imnnq"로 시작하는(예를 들어, imnnq_NT 또는 imnnq_98) 디렉토리에서 이 파일을 찾으면, 파일을 삭제하십시오. 2 단계와 3 단계는 수행할 필요가 없습니다.  

  2. NetQuestion 디렉토리(IMNINSTSRV= 뒤에 나오는 정보)로 가십시오.
  3. vahcfg remove /p vj32를 입력하십시오.

VisualAge for Java가 설치한 모든 NetQuestion 파일이 제거됩니다. 다른 제품(예를 들어, DB2)에서 설치한 NetQuestion 파일에는 영향을 미치지 않습니다.

아직 이와 같이 하지 않은 경우, 저장소와 자원 파일을 백업하십시오. 이 타스크의 수행 방법에 대해서는 파트 B, 3.0 절을 참조하십시오.  

이들 단계를 모두 수행하였으면 재부트한 후 제품을 다시 설치하십시오. VisualAge for Java를 재설치한 후 도움말이 표시되지 않을 경우, 문제점 해결 안내서에서 도움말 실패 복구에 관한 정보를 참조하십시오. 문제점 해결 안내서(trshoot.htm)의 위치는 제품 CD의 VisualAge for Java, Professional Edition 및 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java를설치한 후에도 안내서는 X:\IBMVJava에 위치하는데 여기서 X:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.

B.4.1.6 CICS 트랜잭션 게이트웨이

VisualAge for Java를 설치할 때 CICS 트랜잭션 게이트웨이가 설치되어 있으면, VisualAge는 VisualAge 대신 이 버전을 사용합니다.

B.4.1.7 Windows 설치 프로그램 오류

다음은 설치 과정에서 사용자가 알아야 할 Windows 설치 프로그램 오류의 목록입니다.

오류 1603 (Windows NT 4.0 전용)

VisualAge for Java 설치 중에 1603 오류 메시지가 표시되면 이는 Windows 설치 프로그램 초기화에 실패했음을 표시하며 설치를 계속할 수 없습니다. 

어떤 제품은 (Symantec의 VisualCafe처럼) Windows 플랫폼에 설치될 경우에는 sfc.dll이라는 파일을 자동으로 설치합니다. 그러나 이 파일은 Windows 2000에서만 사용되는데 여기서 Windows 설치 프로그램은 그 파일을 안전 처리용으로 호출합니다.  

이 이름의 파일이 Windows NT 4.0의 경로에 상주하면 비록 sfc.dll이 Windows 2000에만 적용된다 할 지라도 Windows 설치 프로그램은 이를 로드하려 할 것입니다. 그리고 Windows 설치 프로그램은 로드에 실패합니다. 

이 문제를 해결하려면 다음 단계를 따르십시오.

  1. 사용자 시스템에서 시작 > 찾기 > 파일 또는 폴더를 선택하고 sfc.dll 파일을 탐색하십시오.
  2. (Windows NT 4.0 경로에 상주하는 버전) sfc.dll 파일의 이름을 일시적으로 sfc.old로 변경하십시오.
  3. VisualAge for Java를 설치하십시오.
  4. VisualAge for Java를 성공적으로 설치한 다음에 sfc.old를 sfc.dll로 이름을 바꾸십시오.

치명적인 LoadLibrary() 오류

치명적인 LoadLibrary() 오류는 Windows 설치 프로그램이 하나 이상의 VisualAge for Java 설치 커널(IKernels)을 제대로 등록하지 못했기 때문에 발생합니다. 이 문제점을 해결하려면 IKernel 파일이 상주하는 InstallShield 디렉토리를 삭제한 후에 다음의 단계대로 VisualAge for Java를 재설치해야 합니다.

  1. 필요하면 설치를 종료하십시오.
  2. x:\Program Files\Common Files\InstallShield 디렉토리를 삭제하십시오. 여기서 x는 VisualAge for Java를 설치하려는 드라이브입니다.
  3. 제품을 재설치하십시오. 

오류 1631 또는 내부 오류 2755(Windows NT 4.0 전용)

Windows NT 4.0에 VisualAge for Java를 설치할 경우 다음의 오류 메시지 중 하나가 나타날 것입니다.

이 오류 메시지 중 하나가 표시되면 레지스트리 키가 null 값일 것입니다. VisualAge for Java 설치를 시작할 때 userenv.dll 파일은 다양한 레지스트리 키의 구문 분석을 시도하며 null 값을 가진 키가 있으면 위 오류 메시지 중 하나를 표시하며 설치는 실패합니다.

이런 작동을 해결하려면 VisualAge for Java를 설치하기 전에 null 환경 변수를 제거하거나 이를 수정(값을 null에서 유효한 값으로 변경)해야 합니다. VisualAge for Java를 설치한 후에 이를 원래 값으로 리턴할 수 있습니다.

주의: null 변수를 조심해서 제거하거나 수정하십시오. 그것들을 제거하거나 수정하기 전에 발생할 수 있는 잠재적인 충격을 고려해야 합니다.

내부 오류 2381, 1303, 1310, 1313(Windows NT 전용)

VisualAge for Java를 설치하려 하고 다음 조건 중 일부나 전부가 참이라면,

다음 오류 메시지 중 하나 이상이 표시됩니다.

이 문제점은 다음 폴더에 대해 읽기 권한만 있는 경우에 발생한다고 보고되었습니다.

\Program Files\IBM\VisualAge for Java
\WinNT\Installer

이 문제점을 해결하려면 사용자가 드라이버 또는 디렉토리에서 필요한 권한을 가지고 있음을 확인하십시오. 이렇게 하려면 다음 단계를 따르십시오.

  1. Windows 탐색기에서, 적절한 드라이브 또는 디렉토리를 선택하십시오.
  2. 폴더를 오른쪽 클릭한 다음 그 팝업 메뉴에서 등록 정보를 선택하십시오.
  3. 보안 탭을 선택하십시오. 사용 권한을 클릭하십시오.
  4. Everyone을 선택하십시오. 액세스 유형 드롭다운 메뉴에서 모든 권한을 선택하십시오.
  5. 서브디렉토리에서 사용 권한 바꾸기 선택란을 선택하십시오.
  6. 확인을 클릭하십시오.
  7. 모든 서브디렉토리에서 사용 권한을 대체하려는지를 확인하는 메시지가 나타나면 예를 클릭하십시오.
  8. 확인을 클릭하십시오.
  9. VisualAge for Java를 설치하십시오.

내부 오류 2735 엔진 작동 개시

오류 2735가 표시되면, 다음 단계를 수행하여 이를 해결하십시오.

  1. 사용자의 Windows 32 시스템 디렉토리에서 다음 파일을 검색하십시오.
  2. shd401lc.dll을 shd401lc.old로 이름을 바꾸십시오.
  3. shdoclc.dll을 shdoclc.old로 이름을 바꾸십시오.
  4. 시작 > 수행을 선택하여 수행 대화 상자를 여십시오. 다음 명령을 수행하여 .dll 파일을 등록 해제하십시오. 
  5. 수행 대화 상자에서 다음 명령을 수행하여 이 dll을 등록하십시오.
  6. VisualAge for Java를 설치하십시오.

오류 1606/내부 오류 2707

다음 오류 메시지가 표시되면 공용 관리 도구 레지스트리 파일 값이 잘못된 것입니다.

오류 1606. 네트워크 위치 \Profiles\AllUsers\StartMenu\Programs\Administrative Tools\를 액세스할 수 없음.
내부 오류 2707. INSTALLDIR.

VisualAge for Java를 설치하기 전에 공용 관리 도구 레지스트리 파일 값을 편집해야 합니다. 그렇게 하려면 다음 단계를 따르십시오.

  1. 명령 프롬프트에서 regedit.exe를 실행하십시오.
  2. 확장한 후 키를 선택하십시오.
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folder
  3. 공용 관리 도구를 선택하십시오.
  4. 편집 > 수정을 선택하십시오.
  5. 값 데이터 필드에 다음을 입력하십시오. %SystemRoot%\Profiles\AllUsers\StartMenu\Programs\Administrative Tools
  6. 확인을 클릭하십시오.
  7. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.
  8. VisualAge for Java를 설치하십시오.

B.4.2 설치 해제시 알려진 문제점 및 제한사항 

다음은 설치 해제시 유의해야 할 항목입니다.

B.4.2.1 디스크 공간

Windows 시스템 드라이브에는 최소한 2MB의 여유 공간이 있어야 하며, 환경 변수 TEMP 또는 TMP는 5MB의 여유 공간이 있는 유효한 임시 디렉토리를 지정해야 합니다.

B.4.2.2 Distributed Debugger 설치 해제

Distributed Debugger를 VisualAge for Java의 일부로 설치한 경우, Distributed Debugger를 설치 해제하기 전에 VisualAge for Java를 설치 해제해야 합니다. VisualAge for Java를 설치 해제한 후 디버거 설치 디렉토리로 가서 설체 해제 프로그램을 실행하여 Distributed Debugger를 설치 해제하십시오.

VisualAge for Java를 설치 해제한 후 Distributed Debugger를 설치 해제할 수 없으면, 다음 레지스트리 키를 삭제하십시오.

HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/ParentProducts/Visual Age for Java

디버거를 다시 설치 해제하십시오. Distributed Debugger를 다른 제품과 함께 사용하는 경우에는 이 단계를 따르지 마십시오. 레지스트리 키를 삭제한 다음에는 디버거를 더 이상 사용할 수 없기 때문입니다.

다음 단계를 수행하십시오.

  1. 명령 프롬프트에서 regedit.exe를 입력하십시오.
  2. 레지스트리 편집기에서 키를 확장하고 선택하십시오.
    HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/ParentProducts/Visual Age for Java
  3. 이 키에 대해 메뉴 막대에서 편집 > 삭제를 선택하십시오
  4. 키 삭제를 확정하도록 요청되면 예를 선택하십시오.
  5. 메뉴 막대에서 레지스트리> 편집을 선택하십시오.

물론 다음의 레지스트리 키 값도 1로 설정해야 합니다.

HKEY_LOCAL_MACHINE/SOFTWARE/IBM/IBM Distributed Debugger/CurrentVersion/install/refcount

B.4.2.3 환경 변수(Windows 98)

Windows 98에서 VisualAge for Java를 설치 해제한 후 일부 환경 항목이 autoexec.bat 파일에 남아 있을 수 있습니다. 일반적으로 남아 있는 항목이 문제점을 유발하지는 않으나 여러번 설치 해제 및 재설치를 수행할 때 두 가지 문제점이 발생할 수 있습니다. PATH 명령문이 상충되어 온라인 도움말이 작동하지 못하거나 경로 공간을 모두 사용하여 제품이 성공적으로 재설치되지 못하는 경우가 발생할 수 있습니다.

문제점을 해결하려면 다음을 수행하십시오.

  1. autoexec.bat 파일의 백업 사본을 작성하십시오.
  2. 다음 단계를 수행하여 시스템에 HTML 탐색 엔진이 필요한 다른 프로그램(예: DB2)이 있는지 확인하십시오.
    a) VisualAge for Java를 설치 해제하고 시스템을 다시 부트하십시오.
    b) 명령 프롬프트에서 regedit.exe을 입력하고, 레지스트리 편집기에서 HKEY_LOCAL_MACHINE\SOFTWARE\ 트리를 확장하십시오. 이 트리에 IBM 디렉토리가 있으면, 이를 확장하여 NetQuestion 디렉토리가 있는지 확인하십시오. 이 디렉토리가 있으면 다른 IBM 제품과 함께 탐색 엔진을 사용하고 있을 수 있습니다.
  3. 다른 제품에 대해 HTML 탐색 엔진을 사용하고 있지 않으면, VisualAge for Java를 다시 설치하기 전에 autoexec.bat 파일에 있는 IMN 또는 IMQ 항목을 제거하십시오.
  4. 다른 제품에 대해 HTML 탐색 엔진을 사용하고 있으면 autoexec.bat 파일에서 다음의 중복된 항목을 삭제하십시오.

    IMNINST
    IMNINSTSRV
    IMNNQ
    IMNNQ_95
    IMQCONFIGCL
    IMQCONFIGSRV
    또한 IF EXIST X:\IMNNQ_95\IMNENV.BAT CALL IMNEV.BAT 행의 중복된 항목도 삭제하십시오.
  5. 중복된 항목을 제거할 때 원래의 항목을 제거하지 않도록 하십시오. 어느 항목이 원래 항목인지 알 수 없으면, 시스템이 어디에 NetQuestion을 설치했는지를 생각해 보십시오. 다음 단계를 수행하십시오.
    1. 명령 프롬프트에서 regedit.exe를 입력하십시오.
    2. 레지스트리 편집기에서 \\HKEY_LOCAL_MACHINE\SOFTWARE\IBM\NetQuestion\Installation 디렉토리 키를 확장하십시오.
    3. 이 키의 디렉토리 값에 NetQuestion이 설치된 디렉토리가 나와 있습니다 . NetQuestion이 제대로 작동하려면 특정 환경 변수 값의 일부에 이 디렉토리가 들어 있어야 합니다.

      위의 환경 변수 중에, 값의 일부로 레지스트리에 들어 있는 것과 다른 디렉토리를 포함하는 변수가 있으면 해당 변수를 삭제하십시오.

B.4.2.4 NetQuestion 설치 해제

VisualAge for Java를 설치 해제할 때 NetQuestion이 설치 해제되지 않을 수 있습니다. NetQuestion이 설치 해제되지 않았는데 차후에 제품을 다시 설치하려 하면 문제가 발생할 수 있습니다. 

VisualAge for Java에서 설치한 NetQuestion 파일을 제거하려면, 다음의 단계를 수행하십시오. 다른 제품(예를 들어, DB2)에서 설치한 NetQuestion 파일에는 영향을 미치지 않습니다.

  1. NetQuestion 디렉토리를 찾으려면, 명령 프롬프트에 다음과 같이 입력하십시오: set imninstsrv. 이 명령은 NetQuestion이 시스템에 설치된 위치를 제공합니다. 예를 들면, 다음과 같습니다.

    IMNINSTSRV=C:\imnnq_nt

    VisualAge for Java를 설치한 드라이브와 사용 중인 운영 체제에 따라, NetQuestion 디렉토리 위치가 다르게 표시될 수도 있습니다. "환경 변수 imninstsrv가 정의되지 않음"과 같은 오류 메시지를 수신한 경우, 모든 NetQuestion 파일이 설치 해제된 것입니다.

  2. NetQuestion 디렉토리(IMNINSTSRV= 뒤에 나오는 정보)로 가십시오.
  3. vahcfg remove /p vj32를 입력하십시오.

VisualAge for Java가 설치한 모든 NetQuestion 파일이 제거됩니다. 

나중에 VisualAge for Java를 재설치한 후 도움말이 표시되지 않으면, 문제점 해결 안내서에서 도움말 실패 복구에 관한 정보를 참조하십시오. 문제점 해결 안내서(trshoot.htm)의 위치는 제품 CD의 VisualAge for Java, Professional Edition 및 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java를설치한 후에도 안내서는 X:\IBMVJava에 위치하는데 여기서 X:\IBMVJava는 VisualAge for Java 설치 디렉토리입니다.

파트 C: EMSRV

VisualAge for Java 클라이언트를 설치에 대한 정보는 이 안내서의 파트 B를 참조하십시오. 서버 설정 및 관리에 대한 정보는 "서버 설정 및 관리" 파일, emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오. 이 파일은 추가 기능 CD의 TeamServer\docs 디렉토리에 있거나 또는 VisualAge for Java의 전자 버전이 있는 경우에는 (파트를 추출시켜 보낸) 임시 디렉토리에 있습니다.

VisualAge for Java, Enterprise Edition으로 팀 환경에서 작업할 경우 EMSRV, 버전 7.0을 사용해야 합니다. 그렇지 않으면 프로젝트 자원을 버전화할 수 없습니다.

EMSRV 파일 위치는 모두 추가 기능 CD에 있습니다.

C.1.0 필수 요구사항

EMSRV를 설치하기 전에 파트 C의 끝에 나오는 "알려진 문제점 및 제한사항"을 참조하십시오.

C.1.1 지원되는 플랫폼

EMSRV 서버는 다음과 같은 운영 체제 플랫폼에 대해 지원됩니다.

* 주: HP-UX는 700 클래스 워크스테이션 시스템에서만 지원됩니다. 이는 HP-UX 9000/715/60 시스템과 HP-UX 9000/782/200+ 시스템에서 테스트되었습니다. 800 클래스(서버) 시스템은 다른 구조를 갖기 때문에 다른 2진이 필요하며 EMSRV는 800 클래스 시스템에서는 지원되지 않습니다.

+ 이 패치의 확보에 대해서는 C.1.4 절을 참조하십시오.

IBM은 더 이상 Netware 4.11 또는 Netware 5.0에서 EMSRV를 지원하지 않지만, EMSRV.NLM이 로드되기 전에 CLIBAUX.NLM이 로드된 경우 이 플랫폼에서 EMSRV를 수행할 수 있습니다. CLIBAUX.NLM은 Novell 지원 팩 8a에 포함되어 있으나 다음 위치에 있는 CLIBAUX1.EXE 파일에서 Novell과 별도로 사용할 수 있습니다.

http://support.novell.com/cgi-bin/search/download?/pub/updates/nw/nw42/clibaux1.exe

SMP 하드웨어에 대한 지원 철회

** 중요사항: 둘 이상의 프로세서가 있는 시스템에서 Windows NT/2000용 EMSRV를 실행하면 저장소를 손상시킬 수 있습니다.

EMSRV는 SMP 하드웨어(둘 이상의 프로세서가 있는 시스템)에서 실행되는 Windows NT/2000 서버에서는 지원되지 않습니다. SMP 하드웨어에 대한 지원을 철회키로 한 결정의 원인은 Windows 서버 및 SMP 하드웨어와 함께 저장소 손상에 관한 잦은 보고 때문입니다. EMSRV는 다른 모든 운영 체제에서는 계속 SMP 하드웨어를 지원합니다.

IBM은 SMP 하드웨어에서 실행되는 Windows NT/2000 서버의 EMSRV를 사용하여 생긴 사용자의 피해에 대해서는 책임을 지지 않습니다. 여기에는 제3자의 청구에 근거한 사용자의 피해 보상 청구도 포함합니다. 여하한 경우에도 IBM과 그의 부품 제조업자, 에이전트 및 직원은 SMP 하드웨어에서 실행되는 Windows NT/2000 서버의 EMSRV 사용으로 야기될 수 있는 모든 간접적, 특별적, 원인 결과적, 전형적 또는 필연적 피해에 대한 책임이 없습니다.

SMP 하드웨어에서 실행되는 서버의 EMSRV를 사용하려면 EMSRV를 시작할 때 -mp 매개변수를 사용해야 합니다. 이것은 SMP 하드웨어에 대한 점검을 생략합니다. 이렇게 해서 사용자는 지원되지 않는 플랫폼에서 EMSRV를 실행하게 되고 그 결과로 저장소가 손상되면 모든 책임을 져야합니다(IBM에게는 어떤 유형의 책임이나 의무도 없습니다).

EMSRV는 프로세서 범위가 아닌 입력/출력 목적의 프로세스이므로 추가 프로세서를 활용하지 않습니다. 따라서 EMSRV의 성능이 사용자 서버의 프로세서 수에 의해 영향받지는 않습니다.

C.1.2 TCP/IP

TCP/IP는 서버에 설치되어 구성되어 있어야 합니다.

C.1.3 EMSRV 실행에 필요한 Novell 패치

NetWare 최소 패치 목록을 확보하여 적용하는 것이 좋습니다. 이러한 패치 파일은 http://support.novell.com/misc/patlst.htm에서 사용할 수 있습니다. 사용 중인 NetWare 버전에 적당한 패치를 선택하여 사용하십시오.

C.1.4 Solaris에서 EMSRV 실행에 필요한 패치

Solaris, 버전 2.6에서 PAM 구현시 EMSRV가 제대로 작동하지 못하는 오류가 발생합니다.  Solaris 버전 2.6에서 EMSRV를 사용할 때에는 패치 106257-05를 적용해야 합니다. 패치는 다음 웹 사이트에서 사용할 수 있습니다.

http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fpatches%2F106257&zone_32=PAM

이 패치가 수정하는 특정 오류는 다음과 같습니다.

4092227 pam_conv appdata_ptr 구성원이 문서에 있는 대로 conv() 기능으로 전달되지 않습니다.

Solaris 버전 7.0에서 작업할 경우에는 패치가 필요하지 않습니다.

C.1.5 지원되는 파일 시스템

EMSRV는 다음과 같은 파일 시스템에서 테스트되어 인증되었습니다.

NetWare

OS/2

Windows NT 및 Windows 2000

Solaris

HP-UX

AIX

Linux

EMSRV는 국지적으로 마운트된 파일 시스템만을 지원합니다.

C.2.0 설치

이 절에는 EMSRV 저장소 서버 프로그램 및 공유 저장소 설치에 대한 지시사항이 있습니다. 서버 시작에 대한 지시사항에 대해서는 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일, emsrv71.htm(영어 외의 언어용으로는 emsrv70.htm)을 참조하십시오.

C.2.1 Windows용 EMSRV 설치

Windows용 EMSRV 설치
Windows에 EMSRV를 설치하기 전에, 파일 유형에 대해 다음 사실을 주의해야 합니다.

Windows에 EMSRV 설치
Windows NT 또는 Windows 2000 서버에 EMSRV 저장소 서버 프로그램 및 저장소 서버를 설치하려면, 다음 단계를 수행하십시오.

  1. 추가 기능 CD의 TeamServer/Windows 디렉토리에서 setup.exe를 수행하십시오.
  2. 화면에 표시된 지시사항을 따르십시오. 설치 디렉토리를 선택하라고 프롬프트되면, PATH의 일부분인 서브디렉토리를 선택하거나 서브디렉토리를 작성한 다음 PATH에 이를 추가하십시오. 그것들을 빈 공간이 많은 위치에 두기를 제안하는 이유는 emsrv.log 파일이 사용자가 선택한 서브디렉토리에 쓰여질 것이기 때문입니다.
  3. ide.zip 파일에서 원하는 디렉토리로 다음과 같은 파일을 추출하십시오.  

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

이 디렉토리는 공유 자원 코드 저장소를 저장할 곳입니다. 나중에 서버를 시작할 때, -W EMSRV 시동 매개변수를 사용하여 이 서브디렉토리를 EMSRV 작업 디렉토리로 지정하게 됩니다.

EMSRV는 ivj.dat.pr 디렉토리의 전체 디렉토리 트리를 읽고 쓰며, 탐색할 모든 권한을 가져야 합니다. ivj.dat.pr 디렉토리는 항상 ivj.dat와 동일한 디렉토리에 복사해야 합니다. 그렇지 않으면, 프로젝트 자원에 액세스할 수 없습니다.

team1.dat와 같이 저장소 파일의 이름을 변경하도록 선택할 수 있습니다. 저장소를 서버로 복사한 후 이름을 변경한 경우에는 프로젝트 자원 디렉토리의 이름도 변경해야 합니다. 예를 들어, 저장소를 team1.dat로 변경한 경우 프로젝트 자원 디렉토리의 이름도 team1.dat.pr로 변경해야 합니다.

팀 구성원은 VisualAge for Java 클라이언트 코드를 설치할 때 저장소 파일명도 지정해야 합니다. 서버 시스템에 대한 경로도 지정해야 합니다.

  1. passwd.dat 파일을 사용하여 암호를 점검하도록 할 경우, TeamServer 디렉토리의 passwd.dat 파일을 ivj.dat를 복사한 디렉토리와 동일한 디렉토리로 복사하십시오. 사용할 수 있는 암호 점검 유형에 대한 자세한 내용은 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.
  2. TCP/IP가 설치되어 제대로 LAN 어댑터로 바인드되었는지 확인하십시오. ping 명령(예: ping IP 주소/호스트명)을 사용하여 바인딩을 검증하여 LAN에 있는 워크스테이션으로부터 서버와 통신할 수 있습니다.
  3. Windows NT 레지스트리에 EMSRV 설치를 계속하고(선택사항임) EMSRV 사용자에게 권한을 부여한 후 EMSRV를 시작하십시오. 이 주제는 "서버 설정 및 관리" 파일인 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)에 설명되어 있습니다.
C.2.1.1 Windows 레지스트리에 서비스로 EMSRV 설치

EMSRV를 명령 프롬프트에서 시작하지 않고 서비스로 시작하기를 선호하면 Windows 레지스트리에 EMSRV를 설치할 수 있습니다. EMSRV를 서비스로 설치하면 두 가지 장점이 있습니다.

팁: EMSRV가 서비스로 시작될 경우, 기본 EMSRV 작업 디렉토리는 Windows NT 또는 Windows 2000 system32\directory입니다. Windows NT 또는 Windows 2000 레지스트리에 EMSRV를 서비스로 설치할 때 -W 매개변수를 사용하여 이 기본값을 변경하는 것이 좋습니다.

중요사항: EMSRV는 SMP 하드웨어(프로세서가 둘 이상인 시스템)에서 수행되는 Windows NT/2000에서는 더 이상 지원되지 않습니다. SMP 하드웨어에 대한 지원을 철회키고한 결정의 원인은 Windows 서버 및 SMP 하드웨어와 함께 저장소 손상에 관한 잦은 보고 때문입니다.  EMSRV는 다른 모든 운영 체제에서는 SMP 하드웨어를 계속 지원합니다.

IBM은 SMP 하드웨어에서 실행되는 Windows NT/2000 서버의 EMSRV를 사용하여 생긴 사용자의 피해에 대해서는 책임을 지지 않습니다. 여기에는 제3자의 청구에 근거한 사용자의 피해 보상 청구도 포함합니다. 여하한 경우에도 IBM과 그의 부품 제조업자, 에이전트 및 직원은 SMP 하드웨어에서 실행되는 Windows NT/2000 서버의 EMSRV 사용으로 야기될 수 있는 모든 간접적, 특별적, 원인 결과적, 전형적 또는 필연적 피해에 대한 책임이 없습니다.

EMSRV을 SMP 하드웨어에서 Windows NT/2000 서비스로 설치하고 시작하려면 -mp 매개변수를 사용하는 서비스를 설치해야 합니다. 이것은 SMP 하드웨어에 대한 점검을 생략합니다. 이렇게 해서 사용자는 지원되지 않는 플랫폼에서 EMSRV를 실행하게 되고 그 결과로 저장소가 손상되면 모든 책임을 져야합니다(IBM에게는 어떤 유형의 책임이나 의무도 없습니다).

-mp 매개변수를 사용하는 서비스를 설치하지 않으면 서비스는 시작되지 않고 다음 오류 메시지가 표시됩니다.

\\호스트에서 EMSRV 서비스를 시작할 수 없습니다.
오류 2140: 내부 Windows NT 오류가 발생했습니다.

다시 서비스로서 EMSRV를 설치하려하면(예를 들어, -mp 매개변수를 추가해서), 서비스는 성공적으로 설치되겠지만 다음의 오류 메시지가 표시될 것입니다.

메시지 파일 emsrvmsg.dll을 C:\WINNT\System32\emsrvmsg.dll로 복사할 수 없습니다.

--- OS 오류 1224: 요청된 작동을 사용자 맵핑된 절이 열린 파일에서는 수행할 수 없습니다. DLL이 EMSRV.EXE처럼 같은 디렉토리에 있음을 확인하십시오.

이 오류 메시지는 무시해도 됩니다. 이전에 서비스를 설치할 때 DLL이 이미 설치되었기 때문입니다.

EMSRV를 서비스로 설치하려면 다음을 수행하십시오.

  1. 명령행 프롬프트에서 EMSRV 실행 프로그램이 설치된 디렉토리로 변경하십시오.
  2. emsrv -install [parameter2] [parameter3] ... 명령을 실행하십시오.  첫번째 매개변수는 -install이어야 합니다. 나머지는 환경에 대해 선택한 EMSRV 시동 매개변수입니다.

    다음은 이 명령의 예제입니다.

    emsrv -install -u joe -p donttell -W j:\sharedrep -rn

    이 예제에서는 EMSRV를 Windows 레지스트리에 서비스로 설치하는데, joe는 EMSRV 사용자 이름이고 donttell은 Joe의 암호입니다. 기본적으로 EMSRV 작업 디렉토리는 j:\sharedrep이며 고유 암호 유효성 검사는 강제로 실행됩니다.

    메시지로 EMSRV가 설치되었음을 확인할 수 있습니다.
  3. Windows NT 및 Windows 2000에서 단계 a 및 b는 약간 다릅니다.
    a) Windows NT 제어판에서 서비스를 두 번 클릭하십시오. 서비스 대화 상자가 나타납니다. 서비스 목록에서 EMSRV를 선택하십시오.  
    b) Windows 2000 제어판에서 관리 도구를 두 번 클릭하십시오. 서비스를 두 번 클릭하십시오. EMSRV를 두 번 클릭하십시오.
    여기서 수동으로 시작할 수 있습니다. EMSRV는 이제 레지스트리에 서비스로서 설치되며 필수 DLL은 시스템 디렉토리로 복사됩니다.
  4. 시동 매개변수 텍스트 상자에 사용할 EMSRV 시동 매개변수를 입력하십시오. 사용할 EMSRV의 작업 디렉토리를 지정할 경우, 경로에 있는 각 백슬래시에 대해 백슬래시를 하나 더 붙여 주어야 합니다. 예를 들면, 다음과 같습니다.

    -u emsrvacc -p secret -W d:\\javateam
  5. 시작을 클릭하십시오. EMSRV가 시작됨을 알려주는 메시지가 나타납니다.

서버 시작에 대한 자세한 내용은 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일, emsrv71.htm(영어 외의 언어용으로는 emsrv70.htm)을 참조하십시오.

기본값으로, EMSRV가 시작될 때마다 제공한 매개변수가 사용됩니다. Windows 제어판의 서비스 아이콘에서 수동으로 EMSRV를 시작한 경우, 이 매개변수를 재정의하거나 추가할 수 있습니다.

C.2.2 NetWare용 EMSRV 설치

Netware용 EMSRV 설치
Netware에 EMSRV를 설치하기 전에 다음 제한사항을 주의해야 합니다.

Netware에 EMSRV 설치
Netware에 EMSRV 저장소 서버 프로그램과 공유 저장소를 설치하려면, 다음의 단계를 수행하십시오.

  1. TeamServer\Netware 디렉토리에서 다음의 프로그램 파일을 서버에 있는 SYS:\SYSTEM 디렉토리로 복사하십시오.
  2. ide.zip 파일에서 다음 파일을 서버에서 원하는 디렉토리로 추출하십시오.

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

나중에 서버를 시작할 때, -W EMSRV 시작 매개변수를 사용하여 이 서브디렉토리를 EMSRV 작업 디렉토리로 지정하게 됩니다. EMSRV는 ivj.dat.pr 디렉토리의 전체 디렉토리 트리를 읽고 쓰며, 탐색할 모든 권한을 가져야 합니다. ivj.dat.pr 디렉토리는 항상 ivj.dat와 동일한 디렉토리에 복사해야 합니다. 그렇지 않으면, 프로젝트 자원에 액세스할 수 없습니다.

Team1.dat와 같이 저장소 파일의 이름을 변경하도록 선택할 수 있습니다. 저장소를 서버로 복사한 후 이름을 변경한 경우에는 프로젝트 자원 디렉토리의 이름도 변경해야 합니다. 예를 들어, 저장소를 team1.dat로 변경한 경우 프로젝트 자원 디렉토리의 이름도 team1.dat.pr로 변경해야 합니다.

팀 구성원은 VisualAge for Java 클라이언트 코드를 설치할 때 저장소 파일명 및 위치도 지정해야 합니다.

  1. 샘플 암호 파일, passwd.dat를 TeamServer 디렉토리에서 ivj.dat를 복사한 동일한 디렉토리로 복사하십시오. 
  2. NetWare TCPIP.NLM가 로드되어 LAN 어댑터에 바인드되었는지 확인하십시오. ping 명령(예를 들어, ping IP 주소/호스트명) 유틸리티를 사용하여 바인딩을 검증하여 LAN에 있는 워크스테이션으로부터 제품과 통신할 수 있습니다.
  3. EMSRV를 조회할 때 호스트명이 표시되게 하려면, 리버스 DNS 조회를 사용 가능하게 하도록 해결자가 제대로 설정되었는지 점검하십시오. 또한 RESOLV.CFG 파일(sys:\etc에 위치한)이 제대로 설정되었는지 점검하십시오. 다음은 파일 설정에 대한 샘플입니다.  
    domain javadev.com
    nameserver 192.168.73.150
  4. 제품 시작에 대한 지시사항은 TeamServer\docs 디렉토리의 "서버 설정 및 관리" 파일인 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.

C.2.3 OS/2 Warp용 EMSRV 설치

주: OS/2는 더 이상 개발 플랫폼으로서 지원되지 않습니다. 자세한 내용은 파트 E를 참조하십시오.

OS/2용 EMSRV 설치
Netware에 EMSRV를 설치하기 전에 다음을 주의해야 합니다.

OS/2에 EMSRV 설치 
OS/2 서버에 EMSRV 저장소 서버 프로그램과 공유 저장소를 설치하려면, 다음의 단계를 수행하십시오.

  1. 다음의 세 파일을 TeamServer 디렉토리에서 OS/2 컴퓨터상의 원하는 디렉토리로 복사하십시오.

    PATH의 일부분인 서브디렉토리에 이 파일을 배치하거나 서브디렉토리를 작성하여 이를 PATH에 추가하십시오. emsrv.log 파일은 이 파일을 배치하는 서브디렉토리에 기록되기 때문에 여유 공간이 많은 위치에 배치하는 것이 좋습니다.

  2. ide.zip 파일에서 다음 파일을 단계 1에서 복사한 파일을 배치한 서브디렉토리로 추출하십시오.

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

    이 서브디렉토리는 공유 자원 코드 저장소를 저장할 곳입니다. 나중에 서버를 시작할 때 -W EMSRV 시작 매개변수를 사용하여 이 서브디렉토리를 EMSRV 작업 디렉토리로 지정하게 됩니다.

    EMSRV는 ivj.dat.pr 디렉토리의 전체 디렉토리 트리를 읽고 쓰며, 탐색할 모든 권한을 가져야 합니다. ivj.dat.pr 디렉토리는 항상 ivj.dat와 동일한 디렉토리에 복사해야 합니다. 그렇지 않으면, 프로젝트 자원에 액세스할 수 없습니다.

    team1.dat와 같이 저장소 파일의 이름을 변경하도록 선택할 수 있습니다. 저장소를 서버로 복사한 후 이름을 변경한 경우에는 프로젝트 자원 디렉토리의 이름도 변경해야 합니다. 예를 들어, 저장소를 team1.dat로 변경한 경우 프로젝트 자원 디렉토리의 이름도 team1.dat.pr로 변경해야 합니다.

    팀 구성원은 VisualAge for Java 클라이언트 코드를 설치할 때 저장소 파일명도 지정해야 합니다.

  3. passwd.dat 파일을 사용하여 암호를 점검하도록 할 경우, TeamServer 디렉토리의 passwd.dat 파일을 ivj.dat를 복사한 디렉토리와 동일한 디렉토리로 복사하십시오. 사용할 수 있는 암호 점검 유형에 대한 자세한 내용은 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.
  4. TCP/IP가 설치되어 제대로 LAN 어댑터로 바인드되었는지 확인하십시오. ping 명령(예: ping IP 주소/호스트명)을 사용하여 바인딩을 검증하여 LAN에 있는 워크스테이션으로부터 서버와 통신할 수 있습니다.
  5. 서버를 시작하려면, "서버 설정 및 관리" 파일인 emsrv70.htm에 있는 OS/2에서 EMSRV 시작 지시사항을 참조하십시오.

C.2.4 AIX용 EMSRV 설치

AIX용 EMSRV 설치
AIX에 EMSRV를 설치하기 전에, 다음 특성을 주의해야 합니다.

AIX에 EMSRV 설치
아래 단계에서, "EMSRV 사용자"는 EMSRV 프로그램을 시작하는 사용자를 의미합니다.

TeamServer 디렉토리에서 다음 파일을 시스템으로 복사하십시오.

PATH의 일부분인 서브디렉토리에 이 파일을 배치하거나 서브디렉토리를 작성하여 이를 PATH에 추가하십시오. emsrv.log 파일은 이 파일을 배치하는 서브디렉토리에 기록되기 때문에 여유 공간이 많은 위치에 배치하는 것이 좋습니다.

AIX 시스템에 EMSRV를 설정하기 위한 다음 단계를 수행하십시오.

  1. EMSRV 사용자 또는 시스템 관리자(루트)는 저장소를 저장할 디스크 공간을 따로 설정합니다.
  2. 초기 저장소는 다음 파일을 ide.zip 파일에서 단계 1에 있는 별도의 디스크 공간 세트로 추출함으로써 설정될 수 있습니다.

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

    EMSRV는 ivj.dat.pr 디렉토리의 전체 디렉토리 트리를 읽고 쓰며, 탐색할 모든 권한을 가져야 합니다. ivj.dat.pr 디렉토리는 항상 ivj.dat와 동일한 디렉토리에 복사해야 합니다. 그렇지 않으면, 프로젝트 자원에 액세스할 수 없습니다. 디렉토리에 EMSRV 사용자에 대해 rw 및 x(탐색)가 설정되어 있어야 합니다.

  3. 파일 소유자를 EMSRV 사용자 또는 시스템 관리자로 변경하십시오. 저장소가 여러 개이면, 다른 이름을 사용하여 ivj.dat의 사본을 작성하십시오(접미어는 모두 .dat이어야 함). 중복하여 저장소의 사본을 작성할 경우, ivj.dat.pr 디렉토리의 사본을 중복하여 작성한 다음 연관된 저장소와 일치되게 이름을 변경하십시오. 예를 들어, "team.dat"라는 중복된 사본을 작성할 경우 "team.dat.pr"로 중복된 프로젝트 자원 디렉토리도 작성해야 합니다.
    EMSRV 사용자 또는 시스템 관리자는 저장소가 저장된 디렉토리로 변경한 후 적당한 플래그를 사용하여 EMSRV 프로그램을 시작해야 합니다. EMSRV 플래그에 대해서는 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.
  4. EMSRV 사용자 또는 시스템 관리자가 팀 구성원에게 팀 저장소의 위치 및 이름을 알려줍니다. 이 정보는 팀 구성원이 클라이언트 코드를 설치할 때 필요합니다.
  5. 서버를 시작하려면, "서버 설정 및 관리" 파일인 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)에 있는 지시사항을 참조하십시오.

사용자를 인증하기 위해서는 UNIX 플랫폼에 대한 루트 액세스가 필요합니다. 이를 수행하기 위해 루트 사용자가 EMSRV를 시작해서는 안됩니다. 그렇게 하면 보안이 위태롭게 되는데 그 이유는 EMSRV가 모든 파일 시스템에 대해 완전한 액세스를 갖게 되기 때문입니다.

대신, EMSRV 실행 파일의 소유자를 '루트'로 변경하고 실행 파일의 SUID 비트를 설정하십시오. 이는 다음과 같은 방법으로 실행될 수 있습니다.

chown root emsrv
chmod u+s emsrv

EMSRV가 사용자를 인증할 경우, EMSRV는 일시적으로 실행 중인 EMSRV 프로세스의 권한을 실행 파일 소유자의 권한으로 변경합니다. 인증이 완료되면, 실행 중인 EMSRV 프로세스의 권한은 EMSRV를 시작한 사용자의 권한으로 다시 변경됩니다. 이는 클라이언트가 인증되는 동안 클라이언트가 임시로 루트 액세스 권한을 갖고 있는 프로세스에 한해 프로세스 단위(클라이언트 단위)로 이루어집니다.

EMSRV가 실제로 인증을 구현하는 방법에 관계없이 인증에 대한 루트 액세스가 필요합니다. PAM과 같은 인터페이스는 공통 API만을 제공하여 복수의 인증 메소드를 지원하는 응용프로그램을 허용하며, 인증의 각 메소드에 특정한 구성은 계속해서 수정되어야 합니다.  

C.2.5 HP-UX 또는 Solaris용 EMSRV

C.2.5.1 HP-UX 또는 Solaris용 EMSRV 설치
Solaris 또는 HP-UX에 EMSRV를 설치하기 전에 다음 요구사항을 주의해야 합니다.

Solaris의 경우

HP-UX의 경우 

C.2.5.2 HP-UX 또는 Solaris용 EMSRV 설치
아래 단계에서, "EMSRV 사용자"는 EMSRV 프로그램을 시작하는 사용자를 의미합니다.

TeamServer 디렉토리에서 다음 파일을 시스템으로 복사하십시오.

HP-UX:

Solaris:

PATH의 일부분인 서브디렉토리에 이 파일을 배치하거나 서브디렉토리를 작성하여 이를 PATH에 추가하십시오. emsrv.log 파일은 이 파일을 배치하는 서브디렉토리에 기록되기 때문에 여유 공간이 많은 위치에 배치하는 것이 좋습니다.

Solaris 또는 HP-UX 시스템에 EMSRV를 설정하려면 다음 단계를 수행하십시오.

  1. EMSRV 사용자 또는 시스템 관리자(루트)는 저장소를 저장할 디스크 공간을 따로 설정합니다.
  2. 초기 저장소는 다음 파일을 ide.zip 파일에서 단계 1에 있는 별도의 디스크 공간 세트로 추출함으로써 설정될 수 있습니다.

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

    EMSRV는 ivj.dat.pr에 있는 모든 디렉토리 트리를 읽고 쓰며 탐색하는 모든 권한을 가져야 합니다. ivj.dat.pr은 항상 ivj.dat와 동일한 디렉토리로 복사되어야 하며, 그렇지 않으면 프로젝트 자원에 액세스할 수 없게 됩니다. 디렉토리에 EMSRV 사용자에 대해 rw 및 x(탐색)가 설정되어 있어야 합니다.

  3. 파일 소유자를 EMSRV 사용자 또는 시스템 관리자로 변경하십시오. 저장소가 여러 개이면, 다른 이름을 사용하여 ivj.dat의 사본을 작성하십시오(접미어는 모두 .dat이어야 함). 중복하여 저장소의 사본을 작성할 경우, ivj.dat.pr 디렉토리의 사본을 중복하여 작성한 다음 연관된 저장소와 일치되게 이름을 변경하십시오. 예를 들어, "team.dat"라는 중복된 사본을 작성할 경우 "team.dat.pr"로 중복된 프로젝트 자원 디렉토리도 작성해야 합니다.
    EMSRV 사용자 또는 시스템 관리자는 저장소가 저장된 디렉토리로 변경한 후 적당한 플래그를 사용하여 EMSRV 프로그램을 시작해야 합니다. EMSRV 플래그에 대해서는 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.
  4. EMSRV 사용자 또는 시스템 관리자가 팀 구성원에게 팀 저장소의 위치 및 이름을 알려줍니다. 이 정보는 팀 구성원이 클라이언트 코드를 설치할 때 필요합니다.
  5. 서버를 시작하려면, "서버 설정 및 관리" 파일인 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)에 있는 지시사항을 참조하십시오.

사용자를 인증하기 위해서는 UNIX 플랫폼에 대한 루트 액세스가 필요합니다. 이를 수행하기 위해 루트 사용자가 EMSRV를 시작해서는 안됩니다. 그렇게 하면 보안이 위태롭게 되는데 그 이유는 EMSRV가 모든 파일 시스템에 대해 완전한 액세스를 갖게 되기 때문입니다.

대신, EMSRV 실행 파일의 소유자를 '루트'로 변경하고 실행 파일의 SUID 비트를 설정하십시오. 이는 다음과 같은 방법으로 실행될 수 있습니다.

chown root emsrv
chmod u+s emsrv

EMSRV가 사용자를 인증할 경우, EMSRV는 일시적으로 실행 중인 EMSRV 프로세스의 권한을 실행 파일 소유자의 권한으로 변경합니다. 인증이 완료되면, 실행 중인 EMSRV 프로세스의 권한은 EMSRV를 시작한 사용자의 권한으로 다시 변경됩니다. 이는 클라이언트가 인증되는 동안 클라이언트가 임시로 루트 액세스 권한을 갖고 있는 프로세스에 한해 프로세스 단위(클라이언트 단위)로 이루어집니다.

EMSRV가 실제로 인증을 구현하는 방법에 관계없이 인증에 대한 루트 액세스가 필요합니다. PAM과 같은 인터페이스는 공통 API만을 제공하여 복수의 인증 메소드를 지원하는 응용프로그램을 허용하며, 인증의 각 메소드에 특정한 구성은 계속해서 수정되어야 합니다.  

C.2.6 Linux용 EMSRV

C.2.6.1 Linux용 EMSRV 설정
Linux에 EMSRV를 설치하기 전에 다음 정보에 주의해야 합니다.

C.2.6.2 Linux용 EMSRV 설치
아래 단계에서 "EMSRV 사용자"는 EMSRV 프로그램을 시작하는 사용자를 의미합니다.

TeamServer 디렉토리에서 다음 파일을 시스템으로 복사하십시오.

PATH의 일부분인 서브디렉토리에 이 파일을 배치하거나 서브디렉토리를 작성하여 이를 PATH에 추가하십시오. emsrv.log 파일은 이 파일을 배치하는 서브디렉토리에 기록되기 때문에 여유 공간이 많은 위치에 배치하는 것이 좋습니다.

Linux 시스템에 EMSRV를 설정하려면 다음 단계를 수행하십시오.

  1. EMSRV 사용자 또는 시스템 관리자(루트)는 저장소를 저장할 디스크 공간을 따로 설정합니다.
  2. 초기 저장소는 다음 파일을 ide.zip 파일에서 단계 1에 있는 별도의 디스크 공간 세트로 추출함으로써 설정될 수 있습니다.

    ide.zip 파일은 VisualAge for Java, Enterprise Edition, 추가 기능 CD에 있는 ivj40\backup 디렉토리에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다.

    EMSRV는 ivj.dat.pr 디렉토리의 전체 디렉토리 트리를 읽고 쓰며, 탐색할 모든 권한을 가져야 합니다. ivj.dat.pr 디렉토리는 항상 ivj.dat와 동일한 디렉토리에 복사해야 합니다. 그렇지 않으면, 프로젝트 자원에 액세스할 수 없습니다. 디렉토리에 EMSRV 사용자에 대해 rw 및 x(탐색)가 설정되어 있어야 합니다.

  3. 파일 소유자를 EMSRV 사용자 또는 시스템 관리자로 변경하십시오. 저장소가 여러 개이면, 다른 이름을 사용하여 ivj.dat의 사본을 작성하십시오(접미어는 모두 .dat이어야 함). 중복하여 저장소의 사본을 작성할 경우, ivj.dat.pr 디렉토리의 사본을 중복하여 작성한 다음 연관된 저장소와 일치되게 이름을 변경하십시오. 예를 들어, "team.dat"라는 중복된 사본을 작성할 경우 "team.dat.pr"로 중복된 프로젝트 자원 디렉토리도 작성해야 합니다.
    EMSRV 사용자 또는 시스템 관리자는 저장소가 저장된 디렉토리로 변경한 후 적당한 플래그를 사용하여 EMSRV 프로그램을 시작해야 합니다. EMSRV 플래그에 대해서는 TeamServer\docs 디렉토리에 있는 "서버 설정 및 관리" 파일 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)을 참조하십시오.
  4. EMSRV 사용자 또는 시스템 관리자가 팀 구성원에게 팀 저장소의 위치 및 이름을 알려줍니다. 이 정보는 팀 구성원이 클라이언트 코드를 설치할 때 필요합니다.
  5. 서버를 시작하려면, "서버 설정 및 관리" 파일인 emsrv71.htm(영어 이외의 모든 언어의 경우 emsrv70.htm)에 있는 지시사항을 참조하십시오.

사용자를 인증하기 위해서는 UNIX 플랫폼에 대한 루트 액세스가 필요합니다. 이를 수행하기 위해 루트 사용자가 EMSRV를 시작해서는 안됩니다. 그렇게 하면 보안이 위태롭게 되는데 그 이유는 EMSRV가 모든 파일 시스템에 대해 완전한 액세스를 갖게 되기 때문입니다.

대신, EMSRV 실행 파일의 소유자를 '루트'로 변경하고 실행 파일의 SUID 비트를 설정하십시오. 이는 다음과 같은 방법으로 실행될 수 있습니다.

chown root emsrv
chmod u+s emsrv

EMSRV가 사용자를 인증할 경우, EMSRV는 일시적으로 실행 중인 EMSRV 프로세스의 권한을 실행 파일 소유자의 권한으로 변경합니다. 인증이 완료되면, 실행 중인 EMSRV 프로세스의 권한은 EMSRV를 시작한 사용자의 권한으로 다시 변경됩니다. 이는 클라이언트가 인증되는 동안 클라이언트가 임시로 루트 액세스 권한을 갖고 있는 프로세스에 한해 프로세스 단위(클라이언트 단위)로 이루어집니다.

EMSRV가 실제로 인증을 구현하는 방법에 관계없이 인증에 대한 루트 액세스가 필요합니다. PAM과 같은 인터페이스는 공통 API만을 제공하여 복수의 인증 메소드를 지원하는 응용프로그램을 허용하며, 인증의 각 메소드에 특정한 구성은 계속해서 수정되어야 합니다.  

C.3.0 이주 

C.3.1 EMSRV 버전 6.x 또는 버전 7.0에서 버전 7.1로 이주

현재 EMSRV의 버전 6.x 또는 7.0이 설치되어 있고 EMSRV 버전 7.1을 설치하고자 하는 경우, EMSRV 버전 6.x/7.0을 설치 해제하고 버전 7.1을 설치하거나 이전의 EMSRV 버전을 그대로 둔 채 EMSRV 7.1을 설치할 수 있습니다.

VisualAge for Java, 버전 4.0에 대해 작업하려면 버전 7.1을 설치해야 합니다. 

EMSRV, 버전 6.x/7.0에서 EMSRV, 버전 7.1로 이주하려면, 다음 단계를 수행하십시오.

  1. 저장소를 백업하십시오.
  2. EMSRV 6.x/7.0을 종료하십시오.
  3. EMSRV 7.1을 설치하십시오.
  4. EMSRV 7.1을 시작하십시오. 

EMSRV 7.1은 EMSRV 6.x/7.0과 호환 가능합니다. 예를 들어, VisualAge for Java의 이전 개정판(EMSRV 6.x/7.0을 사용)에서 작업할 경우, 이전 버전에서 EMSRV 7.1을 실행하는 공유 저장소로 연결할 수 있습니다. 

C.4.0 팀 개발 준비  

현재 저장소 서버 프로그램과 공유 소스 코드 저장소가 이미 설치되어 있습니다. 팀 개발 환경 설정을 완료하려면, 서버를 시작하고 VisualAge for Java 클라이언트로부터 서버에 연결한 다음, 사용자를 저장소 사용자 목록에 추가해야 합니다.

워크스테이션에 이미 VisualAge for Java 클라이언트가 설치되어 있는 경우, 팀 개발 환경 설정에 대한 자세한 내용은 온라인 도움말 또는 pdf 디렉토리에서 team.pdf를 참조하십시오. pdf 디렉토리의 위치는 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

다음 지시사항에서는 서버에 설치된 공유 저장소가 ivj.dat라고 가정합니다. 저장소 서버 프로그램을 시작할 때 관리자는 ivj.dat 파일의 경로를 EMSRV 작업 디렉토리로서 제공해야 합니다.

C.4.1 팀 서버 준비

팀 개발자가 공유 저장소를 다룰 수 있으려면, 먼저 관리자가 VisualAge for Java 서버를 설정하고 EMSRV 저장소 서버 프로그램을 시작해야 합니다. 일부 개발자가 서버가 준비되기 전에 VisualAge for Java, 버전 4.0을 사용하기를 원한다면, 먼저 독립형 사용자로 설치한 후에 공유 저장소에 연결할 수 있습니다.

C.4.2 클라이언트 연결 테스트

서버가 시작되었는지 확인하려면, 관리자는 VisualAge for Java, Enterprise Edition, 버전 4.0 클라이언트에서 공유 저장소로 연결해야 합니다. 이 조치는 서버의 TCP/IP 연결이 제대로 작동하는지, EMSRV가 올바른 매개변수와 함께 시작되었는지 및 관리자가 클라이언트 설치 중에 제공된 정보가 무엇인지를 알고 있는지를 확인합니다.  

공유 저장소 연결에 대한 정보는 VisualAge for Java 온라인 도움말 또는 team.pdf 파일의 "공유 저장소에 연결"을 참조하십시오. team.pdf 파일은 pdf 디렉토리에 있습니다. pdf 디렉토리의 위치는 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

C.4.3 저장소 사용자 목록에 사용자 추가

클라이언트가 맨 처음 공유 저장소에 연결하면, 작업영역 소유자 이름을 입력하도록 프롬프트됩니다. 사용자는 저장소 사용자 목록에서 유효한 작업영역 소유자 이름을 선택하지 않으면 IDE를 시작할 수 없습니다.

기본적으로, VisualAge for Java, 버전 4.0의 저장소 사용자 목록에는 관리자라고 하는 사용자가 있습니다. 초기에 각 사용자는 관리자를 작업영역 소유자로 선택할 수 있었습니다. 그러나, 모든 사용자는 서버에 연결할 때 즉시 고유한 이름을 제공하도록 강력하게 권장됩니다. VisualAge for Java 팀 개발 환경에서, 제어 변경은 정의된 사용자 역할을 토대로 하며 이는 각 개발자가 고유하게 식별되어야 함을 의미합니다. 이러한 목적을 만족시키기 위해 관리자는 모든 사용자를 저장소 사용자 목록에 추가해야 합니다(이름을 저장소 사용자 목록에 추가할 수 있는 VisualAge for Java 사용자는 관리자뿐입니다). 고유 암호 검증이 사용될 경우, 각 사용자에 속한 고유한 이름은 시스템 사용자 이름에 해당됩니다.

저장소 목록에 사용자를 추가하는 방법에 대해서는 VisualAge for Java 팀 온라인 도움말 또는 PDF 디렉토리에 있는 team.pdf 파일을 참조하십시오. pdf 디렉토리의 위치는 추가 기능 CD의 VisualAge for Java, Enterprise Edition에 있습니다. VisualAge for Java의 전자 버전이 있다면 이는 임시 디렉토리(사용자 파트를 추출해 보낸)에서 찾을 수 있습니다. PDF를 포함한 파트를 다운로드하지 않은 경우에는 이 디렉토리가 없습니다.

이제 서버가 설정 및 준비가 완료되어 VisualAge for Java 클라이언트 설치를 계속합니다. VisualAge for Java 팀 클라이언트 설치에 대한 내용이 이 안내서의 파트 B에 나와 있습니다.

C.5.0 제한사항 및 알려진 문제점(EMSRV) 

C.5.1 저대역폭, 고지연 네트워크 연결의 성능

EMSRV 클라이언트와 EMSRV간에 사용되는 프로토콜은 일반적으로 빠른 속도로 패킷을 서버에 전송합니다. 이는 대부분의 처리가 클라이언트에서 이루어진다는 사실 때문입니다. EMRSV가 처리하는 요청의 대부분은 I/O 요청입니다(예를 들면, 레코드 잠금, 읽기 및 쓰기 요청).

이러한 구조의 결과로, 클라이언트 측에서 측정되는 성능은 네트워크 대기 시간에 매우 민감합니다. 5 ms 미만의 대기 시간(왕복 또는 'ping' 패킷 시간으로 측정됨)이면 만족스러운 성능을 기대할 수 있습니다. LAN 지연은 일반적으로 1ms 미만이지만 WAN 연결 또는 전화 회선상의 전화 접속 모뎀 연결에서는 지연이 500ms와 같이 높을 수도 있습니다. 고속 DSL, 케이블, 프레임 릴레이 또는 ISDN 연결에서도, 지연은 두 지점간의 거리에 대한 함수입니다.

일반적으로, 전화 회선을 통한 전화 접속 모뎀 연결에서의 성능은 만족할만한 성능을 생성하지 못하는데 그 이유는 그런 유형의 연결에서는 대기 시간이 200ms 이상이기 때문입니다. 고속 연결에서도 클라이언트와 서버간의 거리가 수백 킬로미터 이하가 아니라면 만족할 수 있는 성능을 생성하지 못합니다.

EMSRV 프로토콜은 특별히 대역폭의 영향을 받지 않으며 대역폭 사용도는 연결을 동시에 사용 중인 클라이언트 수에 대한 함수입니다.

C.5.2 TCP/IP 연결 제한사항

EMSRV로의 클라이언트 연결에 대한 기본 한계는 512입니다. 이 한계는 EMSRV를 시작할 때 -M command-line 옵션을 사용하여 변경할 수 있습니다.

숫자는 1차적으로 메모리에 의해 바인드되지만, 일부 TCP/IP 스택은 메모리 한계에 도달하기 전에 이미 스트림 소켓이 부족하게 됩니다. 일반적으로 이 숫자는 100보다 크지만 각 스택에 따라 값이 변합니다.

C.5.3 예상치 않게 드롭된 연결 발견

EMSRV는 TCP/IP KEEPALIVE 타이머를 사용하여 클라이언트가 파손되거나 다시 부트되었을 때 예상치 않게 드롭된 연결을 발견합니다. 일부 TCP/IP 스택에서는 KEEPALIVE 시간 종료 값을 변경할 수 있습니다. 일반적으로, 기본 설정은 120분입니다.

EMADMIN은 연결을 나열하고 마지막 요청 시간까지 오랜 시간 동안 서버와 상호 작용하지 않은 연결을 식별하는 데 사용될 수 있습니다. EMADMIN STOP 명령과 -k 옵션을 사용하여 이러한 연결을 닫을 수 있습니다.

C.5.4 서로 다른 EMSRV 및 EMSRV 유틸리티 버전 교환

VisualAge for Java, 버전 4.0에는 EMSRV 버전 7.1과 EMADMIN 유틸리티 버전 7.0이 들어 있습니다.

EMSRV 7.1과 함께 EMADMIN 7.0을 사용해야 합니다. EMADMIN 7.0은 EMSRV 7.0 이전 릴리스와는 제대로 작동하지 않습니다.

C.5.5 PAM 제한사항

Linux 및 Solaris 플랫폼에서 인증은 PAM(Password Authentication Module)을 사용하여 구현됩니다. 이론상으로는 관련 PAM 구성 파일을 변경하여 EMSRV에서 PAM(모듈)을 사용하는 것이 가능하나 실제로는 불가능합니다.

EMSRV는 전적으로 PAM 아키텍처와 호환되는 방식으로 클라이언트와 대화하지 않습니다. 결과적으로, EMSRV 인증은 모듈이 초기에 텍스트 암호를 프롬프트하는 곳(초기에 클라이언트에 의해 지원됨)에서만 작동합니다.

C.5.6 ASCII가 아닌 문자로 된 암호는 EMSRV를 인증하는 데 사용할 수 없음 

Microsoft C 런타임 라이브러리의 버그로 인해,

'EMSRV를 시작한 사용자의 암호를 입력하십시오'

프롬프트에 대한 응답으로 입력되는 ASCII 이외의 문자를 포함하는 암호는 정확하게 해석되지 않습니다. 이를 해결하려면 EMADMIN 수행시 -p 옵션과 함께 암호를 제공하십시오.

C.5.7 일본어 NetWare에서 수행시 메뉴와 창에 손상된 문자

NetWare용 EMSRV NLM은 Novell의 NLM 사용자 인터페이스 개발자 컴포넌트(NWSNUT)를 사용합니다. 일본어 NetWare에서 수행할 경우, NWSNUT 메뉴와 창에 사용되는 그래픽 문자는 사용할 수 없으며 손상된 문자로 표시됩니다. 이는 EMSRV NLM 또는 NetWare에서의 버그 때문이 아니라, Shift-JIS 코드 페이지의 제한 때문입니다.

C.5.8 저장된 자원 디렉토리를 복사하지 않는 EMADMIN  

EMADMIN 7.0을 사용하여 VisualAge for Java 4.0 저장소를 복사할 경우, 해당하는 저장 프로젝트 자원 디렉토리는 복사되지 않습니다. 공유 프로젝트 자원 디렉토리를 수동으로 복사해야 합니다.

파트 D. 컴포넌트 지정 이주 정보

중요한 Swing 클래스 이주 정보는 18.0 절을 참조하십시오.

D.1.0 CICS 트랜잭션 서버(CICS TS)

이 VisualAge for Java 버전은 CICS 트랜잭션 서버를 지원하지 않습니다. CICS TS 1.3 이하 버전을 지원하는 데 필요한 클래스는 이 버전에 포함되어 있지 않습니다. 이전 VisualAge for Java 버전으로부터 이주하고자 하는 CICS TS 응용프로그램은 버전 4.0에서는 작동하지 않으므로 버전 4.0 작업영역 및 저장소에서 삭제해야 합니다.

CICS TS 1.3 이하 버전을 다루려면, 이전(3.02 이하) 버전의 VisualAge for Java를 계속 사용해야 합니다. 당분간 JCICS 인터페이스를 사용하거나 IIOP에 대한 CICS 지원이 필요하면 이전(3.02 이하) 버전의 VisualAge for Java를 사용해야 합니다. CICS 트랜잭션 서버는 JDK 1.1.x에 기초하고 있으므로 이 서버는 지원하지 않습니다.

D.2.0 데이터 액세스 빈

D.2.1. VisualAge for Java 2.0 또는 3.0x 버전으로부터 이주

데이터 액세스 빈은 Swing 컴포넌트 및 인터페이스를 사용합니다. 빈을 사용하는 모든 응용프로그램을 기존 JDK 1.1.x Swing 패키지로부터 새로운 J2SDK v.1.2.2 Swing 패키지로 이주해야 합니다.  이를 수행하려면 VisualAge for Java, 버전 4.0을 설치한 후 영향을 받은 클래스 및 패키지를 선택하고, 수정/이주 SmartGuide를 연 다음 JDK1.2 이름이 바뀐 패키지 포함 선택란을 선택하십시오. 이는 Swing에 대해 적절한 출발/도착 항목을 추가하고 Swing 참조를 Java 2 SDK로 자동으로 이주할 수 있게 사용자에게 능력을 줍니다. 사용자가 이주 중일 때 발생하는 오류는 로그 창에 기록될 것입니다.

응용프로그램의 적절한 이주 방법에 대한 추가 정보에 대해서는 비주얼 컴포지션 편집기 온라인 도움말 파일인 "클래스 또는 패키지용 수정/이주 기준 참조" 및 관련된 타스크 파일인 "클래스 또는 패키지 복구 참조"를 참조하십시오.

D.2.2. VisualAge for Java, 버전 3.5로부터 이주

버전 3.5의 데이터 액세스 빈이 J2SDK v.1.2.2 Swing 패키지를 사용하였기 때문에, VisualAge for Java, 버전 3.5에서 이주한 경우 데이터 액세스 빈을 이주하기 위한 별도의 단계를 수행할 필요가 없습니다.

D.3.0 데이터 액세스 빌더

데이터 액세스 빌더는 이제 VisualAge for Java에 포함되어 있지 않습니다. 데이터 액세스 빌더를 사용하려면 VisualAge for Java의 이전 버전에서 작업을 계속해야 합니다.

VisualAge for Java, 버전 4.0에는 이전에 데이터 액세스 빌더가 제공했던 기능을 직접 대체하는 새 기능은 없지만 VisualAge for Java에는 유사한 기능을 제공하는 세 가지 컴포넌트, 즉, 데이터 액세스 빈, Persistence 빌더 및 EJB(Enterprise JavaBeans) 개발 환경이 있습니다. 각 기능마다 다른 데이터 액세스 클래스 작성 방법을 제공합니다.  

VisualAge for Java, 버전 4.0으로 코드를 이주할 수는 없으나 이러한 도구에서 재사용할 수는 있습니다. 버전 4.0에서 사용하려면 응용프로그램을 재작성해야 합니다. 코드 개발의 주요 목적과 응용프로그램이 수행하는 내용에 가장 적합한 기능을 사용하십시오.

이 안내서의 부록으로 데이터 액세스 빌더, 데이터 액세스 빈 및 Persistence 빌더의 비교가 제공됩니다. 

D.4.0 EJB 개발 환경

D.4.1 VisualAge for Java, 버전 2.0, Enterprise Update에서 엔터프라이즈 빈 이주

VisualAge for Java, 버전 2.0, Enterprise Update에서 엔터프라이즈 빈을 작성하고 이를 VisualAge for Java, 버전 4.0에서 사용하려면, 현재 버전인 VisualAge for Java, 버전 2.0, Enterprise Update에서 다음 활동을 완료해야 합니다.

  1. 스키마 브라우저에서 저장되지 않은 스키마를 모두 저장하십시오.
  2. 맵핑 브라우저에서 저장되지 않은 맵핑을 모두 저장하십시오.
  3. 전개 코드를 마지막으로 생성한 후에 스키마에 최신 변경을 한 적이 있으면 전개 코드를 삭제한 다음 다시 생성하고 생성한 것을 테스트하십시오.
  4. 패키지(패키지 및 맵핑 패키지 포함) 및 프로젝트에 버전 번호를 매긴 다음 프로젝트를 .dat 형식으로 반출하십시오.

VisualAge for Java, 버전 4.0에서 엔터프라이즈 빈 코드 이주를 완료하기 위해서는 저장소(권장 사항) 또는 JAR 파일 중 어디에서 반입하는지에 따라, 아래의 시나리오 1 또는 시나리오 2 중 하나의 단계를 수행하십시오.

시나리오 1 - 저장소로부터 반입
저장소로부터 빈을 반입 중이면 이 단계를 따르십시오.

  1. 엔터프라이즈 빈, 스키마, 맵이 들어 있는 프로젝트를 저장소에서 작업영역으로 추가합니다. 오류 아이콘이 로드된 일부 클래스 옆에 표시됩니다.
  2. 각 프로젝트의 개방판을 작성하십시오. 이전에 생성된 클래스를 담고 있는 패키지의 개방판도 작성하십시오.
  3. 스키마 브라우저 및 맵 브라우저를 사용하여 모든 사용가능한 스키마와 맵을 작업영역으로 로드한 다음, 전개된 클래스를 다시 생성하십시오.
  4. 스키마와 맵을 작성하거나 저장하지 않은 경우, 기본 스키마와 맵을 작성한 후 전개된 코드를 다시 생성하십시오.
  5. 버전 4.0에서 독자적으로 작업하려면, 이전에 버전 2.0 Enterprise Update의 EJB 개발 환경을 사용하여 생성했던 프로젝트 페이지에 있는 기존의 EJB 테스트 클라이언트 클래스를 모두 삭제하십시오. 이 클래스에는 오류가 있으며 버전 4.0에서는 작동하지 않는데 그 이유는 EJB 테스트 클라이언트는 생성된 클래스를 더이상 사용하지 않기 때문입니다. (테스트 클라이언트 클래스는 삭제되기 전에는 EJB 페이지의 EJB 유형 분할영역에 나타나지 않으므로 프로젝트 페이지를 점검하여 삭제할 것이 있는지를 판단할 필요가 있음을 주의하십시오.)

EJB 개발 환경에 대한 VisualAge for Java 온라인 도움말에서 이 단계의 수행 방법에 대한 자세한 정보를 얻을 수 있습니다.

시나리오 2 - JAR 파일로부터 반입
JAR 파일로 엔터프라이즈 빈을 반출하려면, 다음의 단계를 수행하십시오.

  1. EJB 페이지에서 EJB > Enterprise Beans 반입을 선택하여 JAR 파일을 사용자의 VisualAge for Java, 버전 4.0 작업영역으로 반입하십시오.
  2. JAR 파일에 필수 맵이 들어 있지 않기 때문에 반입된 여러 클래스 옆에 오류 아이콘이 표시됩니다.
  3. 스키마, 맵, 전개된 클래스 및 갖고 있는 테스트 클라이언트를 다시 생성하십시오.
  4. 버전 4.0에서 독자적으로 작업하려면, 이전에 버전 2.0 Enterprise Update의 EJB 개발 환경을 사용하여 생성했던 프로젝트 페이지에 있는 기존의 EJB 테스트 클라이언트 클래스를 모두 삭제하십시오. 이 클래스에는 오류가 있으며 버전 4.0에서는 작동하지 않는데 그 이유는 EJB 테스트 클라이언트는 생성된 클래스를 더이상 사용하지 않기 때문입니다. (테스트 클라이언트 클래스는 삭제되기 전에는 EJB 페이지의 EJB 유형 분할영역에 나타나지 않으므로 프로젝트 페이지를 점검하여 삭제할 것이 있는지를 판단할 필요가 있음을 주의하십시오.)

EJB 개발 환경에 대한 VisualAge for Java 온라인 도움말에서 이 단계의 수행 방법에 대한 자세한 정보를 얻을 수 있습니다.

D.4.2 VisualAge for Java, 버전 3.0 또는 3.02로부터 엔터프라이즈 빈 이주

VisualAge for Java, 버전 3.0 또는 3.02 중 하나를 사용하여 생생된 전개 코드를 가진 기존의 엔터프라이즈 빈이 있고 이제 그 엔터프라이즈 빈을 VisualAge for Java, 버전 4.0을 사용하여 작업하려면 엔터프라이즈 빈을 버전 4.0으로 이주한 다음 전개 코드를 확실히 삭제하고 다시 생성해야 합니다.

그러나 엔터프라이즈 빈 코드를 버전 4.0으로 이주하기 전에 현재 VisualAge for Java 현재 버전(버전 3.0 또는 버전 3.02)에서 다음 활동을 완료해야 합니다.

  1. 스키마 브라우저에서 저장되지 않은 스키마를 모두 저장하십시오.
  2. 맵핑 브라우저에서 저장되지 않은 맵핑을 모두 저장하십시오.
  3. 전개 코드를 마지막으로 생성한 후에 스키마에 최신 변경을 한 적이 있으면 전개 코드를 삭제한 다음 다시 생성하고 생성한 것을 테스트하십시오.
  4. 패키지(패키지 및 맵핑 패키지 포함) 및 프로젝트에 버전 번호를 매긴 다음 프로젝트를 .dat 형식으로 반출하십시오.

엔터프라이즈 빈 코드를 이주한 다음 전개 코드를 다시 생성하기 위해서는 VisualAge for Java, 버전 4.0에서 표시된 것과 똑같은 순서로 다음 단계를 완료하십시오.

  1. 프로젝트 저장소를 작업영역으로 반입하십시오.
  2. 프로젝트의 각 개방판을 작성하십시오. 또한 삭제하려는 전개 코드를 포함한 패키지의 개방판도 작성하십시오.
  3. Workbench에서 EJB 탭을 클릭하십시오.
  4. 엔터프라이즈 빈 분할영역에서 전개 코드를 삭제할 엔터프라이즈 빈 또는 그룹을 선택하십시오.
  5. EJB > 삭제를 선택하십시오.
  6. 전개 코드를 클릭하여 전개된 코드를 삭제하십시오.
  7. D.4.3 절(버전 3.0에서 이주하는 경우)의 지시사항을 따르고 D.4.4 절(버전 3/02에서 이주하는 경우)의 지시사항에 따라 사용자의 연관 사항도 (있을 경우) 이주하십시오.
  8. 사용자의 빈 클래스 및 상위 빈 클래스에 아무 오류도 없음을 확인하십시오.
  9. 다음 단계를 완료하여 EJB 액세스 빈을 (있을 경우) 다시 생성하십시오.
    1. Workbench의 EJB 페이지에서, 이주하려는 액세스 빈과 연관된 엔터프라이즈 빈을 선택하십시오.
    2. EJB 메뉴에서, 추가 > 액세스 빈을 선택하여 액세스 빈 작성 SmartGuide를 연 다음, 완료 단추를 클릭하십시오. 액세스 빈에 필요한 모든 이주 변경 사항이  자동적으로 만들어 집니다.
  10. 전개 코드를 다시 생성하십시오.
  11. 버전 4.0에서 독자적으로 작업하려면, 이전에 3.0 또는 3.02 버전의 EJB 개발 환경을 사용하여 생성했던 프로젝트 페이지에 있는 기존의 EJB 테스트 클라이언트 클래스를 모두 삭제하십시오. 이 클래스에는 오류가 있으며 버전 4.0에서는 작동하지 않는데 그 이유는 EJB 테스트 클라이언트는 생성된 클래스를 더이상 사용하지 않기 때문입니다. (테스트 클라이언트 클래스는 삭제되기 전에는 EJB 페이지의 EJB 유형 분할영역에 나타나지 않으므로 프로젝트 페이지를 점검하여 삭제할 것이 있는지를 판단할 필요가 있음을 주의하십시오.)
  12. 이전에 VisualAge for Java, 버전 3.0, 3.02 또는 3.5에서 클라이언트 JAR 파일을 작성한 경우, VisualAge for Java, 버전 4.0에서 클라이언트 JAR 파일을 재작성해야 합니다.

D.4.3 VisualAge for Java, 버전 3.0에서 EJB 연관 이주

버전 3.0에서 작성된 EJB 그룹에 연관을 추가, 편집 또는 삭제할 경우, VisualAge for Java는 자동으로 EJB 그룹의 모든 연관을 새로운 연관 형식으로 변환합니다. 이주 프로세스를 완료하려면, 다음을 수동으로 변경하십시오.

사용자가 이 메소드에 수정을 가했을 가능성이 많기 때문에 이 메소드는 자동으로 변환되지 않습니다. VisualAge for Java는 버전 4.0에 새로운 빈이 작성될 때 자동으로 호출을 추가합니다.

버전 3.0 이전의 CMP 개체 빈을 연관이 이미 이주된 EJB로 반입하여 CMP 개체 빈으로부터 메소드를 상속하는 새로운 빈을 추가한 경우, 새로운 빈의 클래스는 여러 메소드에 빨간색 x를 표시합니다. 이는 반입된 빈의 빈 클래스에 _initLinks, _getLinks 및 _removeLinks 메소드가 누락되었기 때문입니다. 사용자는 수동으로 반입된 빈의 빈 클래스에 이 메소드를 추가해야 합니다.    

제품 응용프로그램 서버에 엔터프라이즈 빈 코드를 전개할 준비가 되었으면, 연관 및 액세스 빈이 필요로 하는 런타임 코드를 포함하는 새 런타임 JAR 파일도 전개했는지 확인해야 합니다. 이 JAR 파일은 응용프로그램 서버에 전개되며, 응용프로그램 서버의 클래스 경로에 포함됩니다. 런타임 JAR 파일에 대한 자세한 내용은 EJB 개발 환경 온라인 도움말에 나와 있습니다.

D.4.4 VisualAge for Java 3.02에서 연관 이주

맨 처음 VisualAge for Java 3.02에서 작성된 연관을 사용하여 EJB 그룹을 열면, 그룹은 생성된 링크 클래스 옆에 오류 아이콘을 포함합니다. 이러한 유형의 EJB 그룹에서 연관을 추가, 편집 또는 삭제할 때, VisualAge for Java는 EJB 그룹에 있는 모든 연관의 링크 클래스를 자동으로 복구합니다.  연관을 변경할 계획이 없더라도, EJB 페이지의 특성 분할영역에서 연관을 선택해야 하며 팝업 메뉴에서 편집을 선택하여 연관 편집기를 열어야 합니다. 그런 후 확인을 클릭하여 이주 프로세스를 완료해야 합니다.

VisualAge for Java는 자동으로 VisualAge for Java 3.02에서 생성된 일부 연관 관련 메소드를 제거합니다. 제거되는 메소드는 연관의 특성이 부여되기는 했으나, 버전 4.0에서는 제대로 작동하지 않는 메소드입니다. 예를 들어, 역할이 기본 키의 일부분일 경우, 해당 역할에 대한 설정 메소드는 유효하지 않습니다. 메소드는 버전 3.02에서는 자동으로 생성되나 버전 4.0에서는 생성되지 않습니다.

D.5.0 엔터프라이즈 액세스 빌더(EAB) 및 e-connectors  

D.5.1 엔터프라이즈 액세스 빌더

D.5.1.1 새로운 커넥터 지원
이제 엔터프라이즈 액세스 빌더는 Common Connector Framework (CCF) 및 Java 2, Enterprise Edition (J2EE) Connector Architecture 커넥터를 모두 지원합니다. 엔터프라이즈 액세스 빌더에는 EAB 레코드, 명령, 네비게이터 및 세션 빈을 CCF 형식으로부터 J2EE Connector Architecture 형식으로 이주하는 새로운 도구가 있습니다. 더우기 다음의 SmartGuides 및 편집기도 갱신되어 J2EE Connector Architecture에 대해 새로운 지원을 반영합니다.

IBM Connectors and Tools for J2EE(TM) - 베타 버전 및 새로운 EAB Migrators에 대한 새로운 지원에 대한 자세한 내용은 엔터프라이즈 액세스 빌더 온라인 도움말을 참조하십시오.

D.5.1.2 레코드 및 명령 재생성과 편집
EAB 응용프로그램을 VisualAge for Java의 이전 버전에서 버전 4.0으로 이주할 때, 레코드 및 명령을 다시 생성하고자 할 수 있습니다. 이를 재생성하면 버전 4.0에서 더 잘 수행됩니다. 

이전에 "Inner 클래스"를 선택하지 않고 "Direct"와 "Shorten names"을 선택하면 생성된 레코드 이름이
필요 이상으로 커지는 경우가 있었습니다. 그 결과 Windows 파일명 제한 길이인 255자를 초과하는 이름이 생성되기도 했습니다. 이제 위 옵션을 선택하면 레코드 유형 SmartGuide의 레코드 작성이 가능한 한 짧은 이름을 생성하도록 최적화되었습니다. 그러나, 이러한 옵션으로 다시 생성할 경우 레코드 이름이 변경될 수 있으므로 응용프로그램에 영향을 미칠 수 있습니다.

EAB 명령을 2.0x 버전에서 작성하지 않은 경우, 명령 편집기에서 이를 편집할 수 없습니다. 그러나 비주얼 컴포지션 편집기에서는 이를 편집할 수 있습니다. 런타임 환경의 현재 버전이 역호환이 가능하면 2.0x 버전 명령을 수행할 수 있습니다.

D.5.1.3 응용프로그램 전개
버전 4.0은 엔터프라이즈 액세스 빌더(EAB)의 전환 릴리스입니다. EAB의 기반이었던 기존의 공용 커넥터 프레임워크(CCF) 구조는 새로운 J2EE Connector 구조로 이동 중입니다. EAB 문서는 이 전환 및 전환 전후 사이의 차이점을 설명합니다. 이번 릴리스는 양쪽 구조를 모두 지원합니다. 이는 전개에 몇 가지 차이점이 있음을 의미합니다. 세부사항에 대해서는 EAB 문서의 전개 절에서 읽어 보십시오. 다음 단락은 전개의 단순한 개요입니다.

기존 응용프로그램에 대해서는 과거처럼 계속할 수 있습니다. 응용프로그램을 런타임시 커넥터가 요구하는 eab\runtime30\eablib.jar, ccf.jar, recjava.jar 및 JAR 파일과 함께 전개하십시오. J2EE 구조를 사용하는 레코드와 명령처럼 약간의 J2EE Connector 구조관련 컴포넌트를 추가한 새 응용프로그램에 대해서는 eab\runtime35\eablib.jar와 함께 응용프로그램을 전개하십시오. 이는 두 구조를 모두 지원한다는 뜻으로 바이모달(bimodal)이라 합니다. 게다가 J2EE에만 관련된 다른 JAR 파일이 필요할텐데 이는 EAB 문서의 전개 절에서 지정된 것입니다.

D.5.2 E-connector

다음 절에는 IMS 연결, CICS 커넥터 및 e-connector 이주에 관한 정보가 들어 있습니다.

중요사항 : Windows 98에서의 CD-ROM 파일 시스템(CDFS) 지원의 제한사항 때문에, 사용자가 선택한 커넥터에 따라 CD-ROM에서 특정 e-business 커넥터 파일의 설치가 실패할 수 있으며 하나 이상의 다음과 같은 오류 대화 상자를 표시할 수 있습니다.

설치되지 않은 모든 파일은 제품 CD의 루트에 위치한 zip 파일(econnfix.zip)에 저장됩니다. Windows 98에 VisualAge for Java를 설치하려고 시도 중이며 위의 메시지 중 하나를 받은 경우, 제품이 설치된 디렉토리로 econnfix.zip을 unzip해야 합니다(예를 들어, 명령 unzip econnfix.zip -d c:\Program Files\IBM\VisualAge for Java\. 여기서 c:\Program Files\IBM\VisualAge for Java\는 제품 설치 디렉토리임). 이 파일이 위치되면, 커넥터가 제대로 기능합니다.

D.5.2.1 IMS 연결
IMS TCP/IP OTMA 연결(IMS TOC)에 대한 지원은 2001년 3월에 일시 중단될 것입니다. 사용자는 IMS TOC에서 IMS 연결로 이주하고 이를 IMS TOC 대신 사용할 것을 권장합니다.

IMS 연결은 IMS에 액세스할 때 VisualAge for Java IMS 커넥터와 함께 사용할 수 있는 별도록 구입할 수 있는(VisualAge for Java에 포함되지 않음) SMP 설치 가능 IBM 제품입니다. IMS TOC에서 IMS 연결로 이주한 후에도 모든 Java 프로그램용 IMS 커넥터를 계속 사용할 수 있습니다(그것들을 변경 또는 갱신할 필요가 없습니다).

D.5.2.2 CICS 커넥터
ECIInteractionSpec에서 CICSELUW 플래그의 작동이 CCF 커넥터 구조를 올바르게 모델화하도록 수정되었습니다. 이전 릴리스에서, 이 플래그는 생성자에서 기본값이 FALSE였으며 실제 조정자 존재 여부에 관계없이 항상 LUW 확장 여부를 결정하였습니다.

이번 릴리스에서, CICSELUW 플래그의 기본값은 실제 CCF 조정자(예를 들어, JavaCoordinator)가 존재할 경우 ECIInteractionSpec 생성자에서 TRUE입니다. 기존 VisualAge for Java 코드에서 이 특성을 명확히 설정하지 않은 경우, 일단 VisualAge for Java, 버전 4.0으로 이주하면 기존 코드의 CICSELUW 특성의 기본값은 이제 TRUE가 됩니다.

실제 조정자가 없으면, 이 플래그는 무시되며 모든 응용프로그램(기존 응용프로그램 및 VisualAge for Java, 버전 4.0에서 작성한 새 응용프로그램 모두)은 CICSELUW 플래그가 FALSE인 것처럼 작동합니다. 그러므로 사용자 환경에서 실제 조정자를 채택하지 않으면 이 플래그의 명백한 설정도 영향을 미치지 못합니다.

D.5.2.3 E-connector 이주
VisualAge for Java 이전 버전의 대부분은 버전 4.0과 함께 사용될 수 있으나 다른 e-connector 레벨과는 같이 사용될 수 없습니다.

VisualAge for Java, 버전 3.0x 또는 버전 3.5.x로부터 이주

e-connector가 설치되어 있는 경우, VisualAge for Java, 버전 3.0x 또는 버전 3.5.x에서 버전 4.0으로 이주하기 위해서는 다음 두 가지 이주 시나리오 중 하나를 수행해야 합니다.

두 이주 시나리오의 차이점은 커넥터가 이주되는 단계입니다.

시나리오 1에서, 커넥터는 초기 설치 프로세스 중에 이주됩니다. 이 시나리오의 단계를 완료하면, 커넥터 없는 VisualAge for Java, 버전 3.0x 또는 버전 3.5.x와 커넥터가 있는 VisualAge for Java, 버전 4.0이 공존하게 됩니다.

시나리오 2에서, 커넥터는 초기 이주 프로세스 다음에 이주됩니다. 이 시나리오의 단계를 완료하면, 커넥터 없는 VisualAge for Java, 버전 4.0이 커넥터가 있는 VisualAge for Java, 버전 3.0x 또는 버전 3.5.x와 공존하게 됩니다.  나중에 버전 3.0x 또는 버전 3.5.x 커넥터를 설치 해제하고 버전 4.0 커넥터를 설치할 수 있습니다.

이주 시나리오 1

  1. 커넥터 또는 EAB 코드를 포함하는 모든 버전 3.0x 또는 버전 3.5.x 프로젝트를 버전화하십시오.
  2. 이 프로젝트 및 관련 자원을 VisualAge for Java 설치 트리 외부의 디렉토리로 복사하십시오.
  3. 3.0x 또는 3.5.x 작업영역에서 모든 프로젝트를 제거하십시오.
  4. 작업영역에서 모든 CICS, Host-On-Demand, IBM 엔터프라이즈 액세스 빌더, Encina, IMS 및 MQSeries 기능을 제거하십시오.
  5. 버전 3.0x 또는 3.5.x IDE를 종료하십시오.
  6. 다음 단계를 수행하여 VisualAge for Java 버전 3.0x 또는 3.5.x에 대한 커넥터를 설치 해제하십시오.
    1. Windows 시작 메뉴에서, 시작 > 설정 > 제어판을 선택하십시오.
    2. 프로그램 추가/제거를 두 번 클릭하십시오. 설치/설치 해제 탭을 선택하십시오.
    3. IBM Connectors 를 선택하십시오. 추가/제거를 클릭하십시오.
    4. 커넥터 및 관련 컴포넌트를 설치 해제하도록 확인하십시오.
    5. 프로그램 제거 창에서 확인을 클릭하십시오.

  7. 나중에 커넥터를 설치할 때 충돌 및 오류를 방지하려면, 환경 변수에 제거된 커넥터에 대한 참조가 들어 있어서는 안됩니다. 환경 변수를 편집하려면 다음을 수행하십시오.

    Windows NT 및 Windows 2000

    1. 시작 메뉴에서 설정 > 제어판을 선택하십시오
    2. 시스템 아이콘을 두 번 클릭하십시오. 환경 탭을 선택하십시오.
    3. CLASSPATH, PATH 및 NLS PATH에서 IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.

    Windows 98

    1. c:\autoexec.bat 파일을 백업하십시오.
    2. 명령 프롬프트에서, edit c:\ autoexec.bat 를 입력하십시오.
    3. SET CLASSPATH, SET PATH 및 SET NLS PATH 명령문에서, IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.
  8. VisualAge for Java, 버전 4.0을 설치하십시오.
  9. 원하는 CICS, Host-On-Demand, IBM 엔터프라이즈 액세스 빌더, Encina, IMS 및 MQSeries 기능을 버전 4.0 작업영역에 추가하십시오.
  10. 1.1.x 코드 이주를 완료하려면 버전 4.0 작업영역으로 프로젝트를 반입하십시오. SAP R/3 액세스 빌더 및 커넥터를 사용하려면 이 단계의 끝에 있는 주를 참조하십시오.
  11. 보존하고자 하는 모든 코드를 VisualAge for Java 4.0으로 이주했으면 VisualAge for Java, 버전 3.0x 또는 버전 3.5.x를 설치 해제할 수 있습니다. 
SAP 커넥터를 사용할 경우 VisualAge for Java, 버전 3.0x 또는 3.5.x를 사용하여 생성된 클래스를 재생성해야 합니다.

SAP R/3용 액세스 빌더 및 커넥터는 Swing 1.0.3에 기초한 일부 유틸리티 클래스(예: LogonBean)도 제공합니다. 이들 클래스는 Swing 1.1 기반 클래스로 대체됩니다. 버전 3.0x 또는 버전 3.5.x에서 버전 4.0으로 이주할 때, SAP R/3용 액세스 빌더 및 커넥터에서 제공하는 유틸리티 클래스를 계속 사용하려면 사용자 소유의 Swing 1.0.3 기반 클래스를 1.1 레벨로 이주해야 합니다. 이 프로세스에 대해 IDE 수정/이주 도구를 사용할 수 있습니다.

이주 시나리오 2

  1. 트랜잭션용 엔터프라이즈 액세스 빌더를 설치하지 않은 상태에서 VisualAge for Java 버전 4.0을 설치하십시오.
    1. VisualAge for Java, 버전 4.0을 설치하십시오. 화면에 표시된 지시사항을 따르십시오.
    2. 설정 유형 페이지에서, 조정을 선택하십시오. 다음을 클릭하십시오.
    3. 설치할 모든 컴포넌트를 선택하고 트랜잭션 액세스 빌더는 선택하지 마십시오. 설치할 컴포넌트의 선택을 마쳤으면 다음을 클릭하십시오. 트랜잭션 액세스 빌더 설치를 시도한 후 설치 화면으로 되돌아 왔는데 커넥터 설치를 원치 않으면, 트랜잭션 액세스 빌더 선택란을 지우고 다음을 클릭하십시오.
    4. 설치를 계속하려면 화면에 표시되는 지시사항을 계속 수행하십시오.
      VisualAge for Java, 버전 3.0x 또는 버전 3.5.x용 커넥터에 대한 작업을 계속할 수 있습니다.

VisualAge for Java, 버전 4.0 커넥터를 설치하려면, 이주 시나리오 1에 요약된 단계를 수행하여 버전 3.0x/3.5.x를 설치 해제하거나  3.0x/3.5.x 커넥터를 설치 해제해야 합니다. 버전 3.0x/3.5.x 커넥터 또는 VisualAge for Java, 버전 3.0x/3.5.x를 설치 해제했으면, 이제 다음 단계를 수행하여 버전 4.0용 커넥터를 설치할 수 있습니다.

  1. VisualAge for Java, 버전 4.0을 설치하십시오. 화면에 표시된 지시사항을 따르십시오.
  2. 프로그램 유지관리 페이지에서 수정을 선택하십시오. 다음을 클릭하십시오.
  3. 트랜잭션 액세스 빌더를 선택하십시오. 다음을 클릭하고 화면에 표시된 지시사항을 수행하여 컴포넌트를 설치하십시오.
  4. VisualAge for Java IDE에 커넥터를 추가하십시오. 그 수행 방법에 대해서는 온라인 도움말을 참조하십시오.

VisualAge for Java, 버전 3.5 또는 버전 3.5.3으로부터 이주

VisualAge for Java, 버전 3.5 또는 3.5.3에서 VisualAge for Java, 버전 4.0으로 이주할 때, VisualAge for Java 4.0에 올바른 IBM Connectors 버전이 설치되게 하려면 VisualAge for Java 3.5 또는 3.5.3에 설치된 IBM Connectors를 우선 설치 해제해야 합니다.

버전 3.5 또는 3.5.3 IBM Connectors를 제거하기 전에 VisualAge for Java, 버전 4.0을 설치하려 하면, 버전 4.0의 설치를 계속하기 전에 IBM Connectors를 사용하는 모든 응용프로그램을 먼저 이주해야 함을 설명하는 대화 상자가 표시됩니다.

응용프로그램을 이주하고, 버전 3.5 또는 3.5.3 IBM Connectors를 설치 해제하려면 다음 단계를 수행하십시오.

  1. 커넥터 또는 EAB 코드를 포함하는 모든 버전 3.5 또는 버전 3.5.3 프로젝트를 버전화하십시오.
  2. 이 프로젝트 및 관련 자원을 VisualAge for Java 설치 트리 외부의 디렉토리로 복사하십시오.
  3. 3.5 또는 3.5.3 작업영역에서 모든 프로젝트를 제거하십시오.
  4. 작업영역에서 모든 CICS, Host-On-Demand, IBM 엔터프라이즈 액세스 빌더, Encina, IMS 및 MQSeries 기능을 제거하십시오.
  5. 버전 3.5 또는 3.5.3 IDE를 종료하십시오.
  6. 다음 단계를 수행하여 VisualAge for Java 버전 3.5 또는 3.5.3에 대한 커넥터를 설치 해제하십시오.
    1. Windows 시작 메뉴에서, 시작 > 설정 > 제어판을 선택하십시오.
    2. 프로그램 추가/제거를 두 번 클릭하십시오. 설치/설치 해제 탭을 선택하십시오.
    3. IBM Connectors를 선택하십시오. 추가/제거를 클릭하십시오
    4. 커넥터 및 관련 컴포넌트를 설치 해제하도록 확인하십시오.
    5. 프로그램 제거 창에서 확인을 클릭하십시오.

  7. 나중에 커넥터를 설치할 때 충돌 및 오류를 방지하려면, 환경 변수에 제거된 커넥터에 대한 참조가 들어 있어서는 안됩니다. 환경 변수를 편집하려면 다음을 수행하십시오.

    Windows NT 및 Windows 2000

    1. 시작 메뉴에서 설정 > 제어판을 선택하십시오
    2. 시스템 아이콘을 두 번 클릭하십시오. 환경 탭을 선택하십시오.
    3. CLASSPATH, PATH 및 NLS PATH에서 IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.

    Windows 98

    1. c:\autoexec.bat 파일을 백업하십시오.
    2. 명령 프롬프트에서, edit c:\ autoexec.bat 를 입력하십시오.
    3. SET CLASSPATH, SET PATH 및 SET NLS PATH 명령문에서, IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.
  8. VisualAge for Java, 버전 4.0을 설치하십시오.
  9. 원하는 CICS, Host-On-Demand, IBM 엔터프라이즈 액세스 빌더, Encina, IMS 및 MQSeries 기능을 버전 4.0 작업영역에 추가하십시오.

커넥터 설치 해제

VisualAge for Java, 버전 4.0을 설치 해제하면, 커넥터가 자동으로 설치 해제됩니다. 나중에 커넥터를 설치할 때 충돌 및 오류를 방지하려면, 환경 변수에 제거된 커넥터에 대한 참조가 들어 있어서는 안됩니다. 환경 변수를 편집하려면 아래의 적절한 단계를 수행하십시오.

Windows NT 및 Windows 2000

  1. 시작 메뉴에서 설정 > 제어판을 선택하십시오
  2. 시스템 아이콘을 두 번 클릭하십시오. 환경 탭을 선택하십시오.
  3. CLASSPATH, PATH 및 NLS PATH에서 IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.

Windows 98

  1. c:\autoexec.bat 파일을 백업하십시오.
  2. 명령 프롬프트에서 edit c:\ autoexec.bat를 입력하십시오.
  3. SET CLASSPATH, SET PATH 및 SET NLS PATH 명령문에서, IBM Connectors 또는 IBM\Connectors에 대한 참조를 삭제하십시오.

Windows 98 전용: VisualAge for Java를 설치 해제한 후에 수동으로 e-connectors 디렉토리(이는 기본값으로 C:\IBM Connectors에 있음)를 삭제해야 할 수도 있습니다. 

D.6.0 AS/400용 엔터프라이즈 툴킷(ET/400)

D.6.1 VisualAge for Java, 버전 2.0에서 이주

VisualAge for Java, 버전 2.0에서 AS/400용 엔터프라이즈 툴킷을 사용하여 생성된 클래스는 VisualAge for Java, 버전 4.0에서 AS/400용 엔터프라이즈 툴킷을 사용하여 생성된 Java 클래스와는 호환되지 않습니다. 이와 같이 호환이 되지 않는 이유는 버전 2.0 ET/400 Java 클래스는 AWT(Abstract Windowing Toolkit)를 사용하였고 버전 4.0 Java ET/400 클래스는 Java 2 SDK Swing을 사용하기 때문입니다.

그러나, 버전 2.0에 제공된 클래스는 VisualAge for Java, 버전 4.0에서 제공되는 com.ibm.ivj.et400.util.awt 패키지에 들어 있습니다. VisualAge for Java, 버전 4.0에서 버전 2.0에서 생성된 클래스를 사용하려는 경우, com.ibm.ivj.et400.util 패키지의 버전 2.0 클래스에 있는 모든 참조를 com.ibm.ivj.et400.util.awt 패키지로 변경해야 합니다. 이는 VisualAge for Java에 제공되는 수정/이주 SmartGuide를 사용하여 수행할 수 있습니다. 이주하는 동안에 발생한 모든 오류는 로그 창에 로그됩니다. SmartGuide 사용에 대한 내용은 온라인 도움말을 참조하십시오.

D.6.2 VisualAge for Java, 버전 3.0 또는 3.02에서 이주

VisualAge for Java, 버전 3.0 또는 3.02에서 ET/400 변환 표시 파일 SmartGuide를 사용하여 Java 클래스를 생성한 경우, 이는 VisualAge for Java, 버전 4.0 ET/400 표시 변환 파일 SmartGuide를 사용하여 생성된 Java 클래스와 호환되지 않습니다.  

호환되지 않는 이유는 버전 3.0 및 3.02에서 생성된 코드는 AS400SVisualTextField 및 Subfile 클래스와 같은 deprecated 클래스를 사용하는 반면, 버전 4.0에서 생성된 코드는 JFormatted 빈을 사용하기 때문입니다. 모든 deprecated 클래스는 VisualAge for Java, 버전 4.0에 들어 있는 com.ibm.ivj.et400.util 패키지에서 찾을 수 있습니다. 버전 3.0 또는 3.02에서 생성된 클래스를 사용하려면, 이들이 새 Java 2 SDK Swing 패키지 이름을 사용하도록 수정/이주 도구를 사용하여 모든 이주된 클래스를 변환해야 합니다. 이는 적용되는 클래스를 선택하고, 수정/이주 도구를 연 다음, JDK 1.2 이름이 바뀐 패키지 포함 선택란을 선택함으로써 수행할 수 있고 Swing 참조를 Java 2 SDK로 자동으로 이주합니다. 이 타스크에 대한 자세한 내용은 온라인 도움말을 참조하십시오. 이주하는 동안에 발생한 모든 오류는 로그 창에 로그됩니다.

서브파일 작성 SmartGuide는 VisualAge for Java, 버전 4.0에 포함되어 있지 않습니다. 보다 강력한 DFU 빈 및 JFormattedTable 빈으로 대체되었습니다. 코드 생성을 위해 서브파일 작성 SmartGuide를 계속 사용하려면 이전 버전(3.02 이하)의 VisualAge for Java로 작업을 계속해야 합니다. 생성된 코드에 필요한 클래스는 계속 지원되므로 버전 3.0 또는 3.02에서 서브파일 작성 SmartGuide로 생성된 코드는 버전 4.0으로 이주될 수 있으며, com.ibm.ivj.et400.util 패키지에 있습니다. 코드를 이주하려면 이전 단락에 있는 것과 동일한 단계를 수행해야 합니다. 

D.7.0 OS/390용 엔터프라이즈 툴킷(ET/390)

OS/390 응용프로그램을 개발할 때 사용하는 ET/390 버전은 OS/390 시스템이나 미들웨어 응용프로그램에서 사용할 수 있는 SDK 레벨과 VisualAge for Java에서 지원하는 SDK 레벨(ET/390 포함)에 따라 달라집니다.

OS/390 시스템과 미들웨어 응용프로그램에서는 다음 테이블에서 보여주는 것처럼 두 레벨의 SDK를 사용할 수 있습니다.

시스템 또는 미들웨어 응용프로그램 SDK 레벨
OS/390 SDK 1.1.8, 1.3.0
WebSphere Application Server, 버전 3.0 SDK 1.1.8
CICS Transaction Server, 버전 1.3 해석된 트랜잭션 및 컴파일된 트랜잭션에 사용되는 SDK 1.1.8
DB2 Universal Database, 버전 5 및 6 컴파일된 저장 프로시저에만 사용되는 SDK 1.1.8

VisualAge for Java에서는 다음 테이블에서 보여주는 것처럼 다른 버전의 제품이 다른 SDK 레벨을 지원합니다.

VisualAge for Java SDK 레벨
버전 3.5, 3.5.3 및 4.0 SDK 1.2.2
버전 3.02 SDK 1.1.8

다음 절에서는 서로 다른 버전의 ET/390을 사용하여 개발할 수 있는 OS/390 응용프로그램 유형에 대해 설명합니다.

VisualAge for Java, 버전 3.5, 3.5.3 및 4.0

VisualAge for Java, 버전 3.5, 3.5.3 및 4.0의 ET/390은 주로 다음 유형의 응용프로그램을 대상으로 합니다.

WebSphere Application Server, 버전 3.0에서 수행되는 해석된 응용프로그램의 경우, SDK1.1.8레벨의 Java API를 다루도록 응용프로그램 클래스를 작성해야 합니다. 응용프로그램 클래스가 작성되면 NFS 장착 드라이브로 클래스를 반출하여 OS/390 시스템에서 사용할 수 있습니다. 그런 다음, VisualAge for Java IDE에서 main 수행 및 main 디버그 메뉴 항목을 클릭하여 응용프로그램을 실행하고 디버그할 수 있습니다.

OS/390 시스템에서 수행되는 독립형의 해석된 응용프로그램의 경우에는 SDK 1.3.0 레벨의 Java API를 다루도록 응용프로그램 클래스를 작성해야 합니다. 응용프로그램 클래스가 작성되면 NFS 장착 드라이브로 클래스를 반출하여 OS/390 시스템에서 사용할 수 있습니다. 그런 다음, VisualAge for Java IDE에서 main 수행 메뉴 항목을 클릭하여 응용프로그램을 실행할 수 있습니다.

해석된 응용프로그램의 빌드, 반출, 실행 및 디버그에 관한 자세한 내용은 ET/390용 온라인 도움말을 참조하십시오.

VisualAge for Java, 버전 3.02

VisualAge for Java, 버전 3.02의 ET/390은 주로 다음 유형의 응용프로그램을 대상으로 합니다.

D.8.0 워크스테이션용 엔터프라이즈 툴킷(ET/WS)

워크스테이션용 엔터프라이즈 툴킷(ET/WS) 및 고성능 컴파일러(HPJ)는 VisualAge for Java의 이번 릴리스에는 포함되어 있지 않습니다. 워크스테이션용 엔터프라이즈 툴킷을 계속 사용하려면 이전 버전(3.02 또는 그 이전)의 VisualAge for Java에서 작업을 계속해야 합니다.

VisualAge for Java, 버전 4.0에는 이전에 ET/WS에서 제공하던 기능을 대체할 새 기능이 없습니다. ET/WS에 포함된 것과 유사한 기능을 Java 가상 시스템(JVM)의 일부인 "Just-in-time" 컴파일러에서 찾을 수 있습니다. Java 가상 시스템은 IBM Developer Kit, Java Technology Edition, v1.2.2, PTF 9에 들어 있습니다.

JIT 컴파일러는 바이트코드를 읽어 이를 직접 실행 코드로 컴파일한 다음, 프로그램을 실행합니다. 바이트코드는 보존되어 아직 이식 가능하지만 코드(JIT에 의해 컴파일된 후)는 더욱 빠르게 수행됩니다. 자세한 내용은 Sun 웹 사이트 http://java.sun.com를 참조하십시오.

D.9.0 외부 버전 제어 

VisualAge for Java, 버전 3.5에서 버전 4.0으로 이주하면, 버전 3.5에서 사용하던 프로젝트에 대해 외부 버전 제어를 계속 사용할 수 있습니다. 외부 버전 제어 아이콘이 처음에 표시되지 않을 경우, 도구 > 외부 버전 제어 > 프로젝트 갱신 조치를 수행하면 표시됩니다.

옵션 대화 상자에서 수행할 수 있는, Tool API로의 원격 액세스를 재시작해야 합니다. Windows > 옵션을 선택하여 옵션 대화 상자를 여십시오. Tool API로의 원격 액세스를 선택한 다음 Tool API로의 원격 액세스 단추를 클릭하여 시작하십시오.

D.10.0 IDL 개발 환경

IBM 컴포넌트 브로커 시리즈나 CICS IIOP 서버 지원 기능에서 제공하는 IDL-to-Java 컴파일러를 사용하고 있는 경우, 다음 대화 상자에서 IDL-to-Java 컴파일러 호출 문자열을 수동으로 정의해야 합니다.

옵션 대화 상자의 IDL-to-Java 컴파일 페이지(Windows 메뉴에서 사용가능). 명령 필드의 문자열을 수정하십시오.

IDL-to-Java 컴파일 옵션 변경 대화 상자. IDL 페이지에서, IDL > 컴파일 옵션 변경을 선택하십시오. 명령 필드에서 문자열을 수정하십시오.

문자열을 수정하고 IDL 페이지를 여는 데 대한 내용은 IDL 개발 환경용 온라인 문서를 참조하십시오.

CICS IIOP 지원에 대한 내용은 파트 D의 1.0 절을 참조하십시오.

D.11.0 통합 개발 환경

버전 3.5 이후 JDK 레벨이 변경되었습니다(지금은 JDK 1.2.2 PTF 9임).

패키지나 클래스를 대체하거나 패키지와 클래스를 추가하여 VisualAge for Java, 버전 3.5 Java 클래스 라이브러리를 수정한 경우, 이주한 후에 이러한 수정사항은 버전 4.0 Java 클래스 라이브러리에서 자동으로 재생성되지 않기 때문에 Java 클래스 라이브러리를 수동으로 다시 수정해야 합니다. 

버전 3.5 이전에 Java 클래스 라이브러리는 VisualAge for Java에서 완전히 읽기 전용이었습니다.

D.12.0 JSP/Servlet 개발 환경

VisualAge for Java의 이전 버전에서 VisualAge for Java, 버전 4.0으로 이주할 경우, 다음 두 개의 파일이 새 버전으로 대체되며 사용자가 작성한 변경사항은 유실됩니다.

버전 4.0으로 이주하기 전에 이 파일의 백업 사본을 작성하고 VisualAge for Java, 버전 4.0으로 이주를 완료한 후에 기존 변경사항을 파일의 새 버전에 추가하려고 할 수 있습니다. 새 버전에는  이 파일의 기존 버전에 없는 정보가 들어 있으므로 단순히 파일의 새 버전에 파일의 이전 버전을 복사해서는 안 됩니다.

D.13.0 Migration Assistant for ActiveX

Migration Assistant for ActiveX은 이 VisualAge for Java에는 포함되어 있지 않습니다. B 파트에서 설명된 일반적인 이주 단계를 수행하여 이전 버전(3.02 또는 그 이전)의 VisualAge for Java에서 Migration Assistant로 작성한 코드를 버전 4.0으로 이주할 수 있습니다. VisualAge for Java, 버전 4.0에는 ActiveX용 Migration Assistant가 이전에 제공했던 기능을 대체할 새로운 기능이 없습니다. 

D.14.0 Persistence 빌더  

주: Persistence Builder FixPak 3.5.1 또는 FixPak 3.5.2(VADD에서 사용할 수 있음)를 VisualAge for Java, 버전 4.0에 적용할 필요가 없습니다. 이 수정 내용은 버전 4.0 코드에 이미 통합되었습니다.

VisualAge for Java를 사용하여 Persistence 빌더의 모든 이전 릴리스로부터 코드를 재생성할 수 있습니다.

D.14.1 특히 버전 2.0으로부터 업그레이드

VisualAge for Java, 버전 2.0으로부터 업그레이드할 경우, 다음과 같은 이주 문제점이 있습니다.

  1. Persistence 빌더 응용프로그램에 관련된 모든 프로젝트를 버전화하십시오.
  2. 코드를 VisualAge for Java, 버전 4.0으로 이주한 후, 프로젝트를 버전 4.0 작업영역에 추가하십시오. 특정 변환기가 VisualAge for Java에 포함되어 있지 않기 때문에 서비스 클래스에서 문제점이 발생합니다. 이 문제점을 수정하기 위해 객체 모델에 대해 "데이터 서비스 클래스 및 인터페이스"를 생성하면 코드 생성 서비스에 의해 문제점이 해결됩니다.  
  3. 변환기에 대한 최상위 클래스가 VisualAge Persistence Common Runtime 프로젝트로 이동되었습니다. 작성기의 최상위 클래스를 com.ibm.vap.converters.VapAbstractConverter로 변경해야 합니다.
  4. 작성기 최상위 클래스도 새 프로젝트로 이동되었습니다. 작성기의 최상위 클래스를 com.ibm.vap.composers.VapAttributeComposer로 변경해야 합니다.

이 단계 수행에 대한 자세한 내용은 Persistence 빌더에 대한 온라인 문서를 참조하십시오.

D.14.2 모든 이전 버전(버전 2.0 포함)에서 업그레이드 

모델 브라우저로부터 사용할 수 있는 모델, 맵 또는 스키마를 로드할 경우, 메타데이터 내부가 변경됩니다. 릴리스 레벨이 버전 4.0 이하인 작업영역으로는 제대로 메타데이터를 로드할 수 없습니다. 모델, 맵 또는 스키마가 비정상적으로 나타납니다. 모델, 맵 또는 스키마를 저장하십시오.

주: VisualAge for Java 2.0 또는 3.0x 버전으로부터 이주할 경우 다음과 같은 정보가 적용됩니다. 버전 3.5로부터 이주할 경우에는 적용되지 않습니다.

이전 릴리스에서 조정 조회에 대해 작성된 클래스에 오류가 있습니다. 조정 조회 프레임워크는 오류 객체를 사용하여 조정 정의가 호출될 때 오류 예외를 포착할 수 있게 합니다. 결과적으로, 모든 기존의 조정 정의는 오류 예외를 처리할 수 없기 때문에 해결할 수 없는 오류(빨간색 X가 표시됨)가 포함되는 대로 IDE에 표시됩니다. 이러한 문제점을 수정하려면, 조정 정의에서 예외를 만들거나 예외를 직접 찾으십시오.

Visual for Java 온라인 도움말에서 오류 처리 방법에 대한 정보를 얻을 수 있습니다.

런타임 지원에 대한 변경사항 
Persistence 빌더 런타임의 필수 요구사항 javax 패키지를 포함하는 프로젝트의 이름이 변경되었습니다. 다음을 수행하여 Persistence 빌더를 사용하는 프로그램 요소의 프로젝트 경로를 다시 계산하도록 요구할 수 있습니다.

  1. 클래스를 선택하십시오.
  2. 선택 메뉴 또는 클래스의 팝업 메뉴에서, 실행 > 클래스 경로 선택을 선택하십시오.
  3. 프로젝트 경로 선택란 옆의 지금 계산 단추를 클릭하십시오.
  4. 재계산된 경로 설정을 저장하려면 저장소에 (기본값으로) 저장 선택란을 선택하십시오. 설정을 저장할 경우, 클래스의 새 개정판이 작성됩니다.
  5. OK를 선택하십시오.

D.15.0 RMI 액세스 빌더

RMI 액세스 빌더는 VisualAge for Java, 버전 4.0에 포함되어 있지 않습니다. 기존의 생성 클래스 및 런타임 라이브러리 프로젝트를 버전 4.0 작업영역으로 반입할 수는 있지만 원격 객체 호출 관리 프로그램(ROIM)이 포함되어 있지 않으므로 이를 수행할 수는 없습니다. 새 Java 2 플랫폼 보안 모델 및 그 제한사항이 RMI 액세스 빌더 응용프로그램에 영향을 미치는 방법에 대해 익숙해져야 합니다.

사용자 작업영역에 RMI 액세스 빌더 런타임 라이브러리 추가
VisualAge for Java, 버전 3.0x에서 RMI 액세스 빌더 런타임 라이브러리를 반입하여 이를 작업영역에 추가해야 합니다. 이것이 없으면 VisualAge for Java, 버전 4.0에서 RMI 액세스 빌더 응용프로그램을 실행할 수 없습니다.

  1. 파일 > 반입을 선택하십시오. 
  2. Jar 파일 라디오 단추를 선택하십시오. 
  3. 런타임의 경로 및 이름을 입력하십시오. 이는 x:\IBMJava\eab\runtime\ivjrmi.zip인데 여기서 x:\IBMJava\는 3.0x 버전 설치 디렉토리입니다.
  4. .class 선택란을 선택하십시오. 자원 선택란을 선택한 경우, 지우십시오.  
  5. 프로젝트 필드에서, IBM 엔터프라이즈 RMI 액세스 빌더 라이브러리를 입력하십시오.
  6. 완료를 클릭하십시오. 
  7. IBM 엔터프라이즈 RMI 액세스 빌더 라이브러리 프로젝터가 존재하지 않을 경우, 작성하도록 프롬프트가 표시됩니다.
  8. 프로젝트가 작업영역에 추가되었는지 확인하십시오. 작업영역에 나타나지 않으면, 저장소 탐색기로 가서 추가하도록 선택하십시오.

RMI 액세스 빌더 응용프로그램 이주
RMI 응용프로그램이 아직 버전 4.0 저장소에 없으면, 다음의 단계를 따라 작업영역으로 반입하십시오.

  1. VisualAge for Java 이전 버전에서 RMI 액세스 빌더 클래스와 런타임 라이브러리 프로젝트를 버전화하십시오. 원한다면 클래스를 .java 클래스처럼 간략하게 유지 관리할 수 있습니다. 
  2. 다음 단계를 수행하여 VisualAge for Java, 버전 4.0 IDE로 반입하십시오.

임의의 서버 객체를 수행하고자 하는 경우, 먼저 서버 main 라인을 작성해야 합니다. 예를 들어, 서버측 서버 프록시, Reverse1S 및 ServerObj2S가 있는 경우, 서버 객체에 대한 인스턴스를 작성하려면 서버 main을 작성해야 합니다.

import...;
public class Servermain {
    public static void main(String arg[]) {
        try{
            Reverse1S myserver = new Reverse1S();
            ServerOvj2S obj2 = new ServerObj2S();
}
catch (Exception e) {
    e.printStackTrace();
    }
System.out.print ln("Server Objects Started.");
    }
}

또한, 엄격한 보안 제한사항 때문에 서버 및 클라이언트에 대한 policy 파일을 정의해야 합니다. 예를 들어, "My policy"라고 하는 policy 파일을 정의할 수 있습니다.

grant {
//Grant all permissions
permission java.security.AllPermission;
};

아니면, 모든 사용자가 제한이 없는 포트를 청취할 수 있게 하는 policy를 정의할 수 있습니다.

grant { 
// allows anyone to listen on un-privileged ports
permission java.net.SocketPermission "localhost:1024-", "listen";
permission java.net.SocketPermission "localhost:1024-", "resolve"; 
permission java.net.SocketPermission "pathfinder:1000-4000", "listen";
permission java.net.SocketPermission "pathfinder:1000-4000", "connect";
permission java.net.SocketPermission "pathfinder:1000-4000", "resolve";
};

여기서, pathfinder는 사용자의 시스템 이름입니다.

클라이언트를 시작할 때 클라이언트가 제대로 시작되게 하려면, 다음과 유사한 명령을 실행해야 합니다.

java-Djava.security.policy=<myPolicy.file> 

예를 들어, IDE 내에서 main()를 실행할 경우, "실행" 메뉴 항목을 선택할 때 특성 섹션에서 java.security.policy= 를 지정합니다.

이전 버전의 VisualAge for Java에서 코드를 유지 관리해야만 코드를 계속해서 개발하거나 재생성할 수 있습니다.

D.16.0 비주얼 컴포지션 편집기

비주얼 컴포지트의 메타데이터를 복구하려면 IDE 이주 도구를 사용해야 합니다. 클래스를 J2SDK v.1.2.2로 이주하거나 조정 프로그램 요소의 이름을 변경하여 손상된 클래스 및 패키지 참조를 복구하는 방법에 대해서는 "클래스 또는 패키지 참조에 대한 수정/이주 안내서" 온라인 주제를 참조하십시오.

VisualAge for Java는 이주되는 클래스 간의 종속관계에 대한 추적을 보관하지 않습니다. 클래스에서 참조되나 아직 이주되지 않은 클래스는 클래스 초기화에 문제가 있거나 잘못 내성될 수 있습니다.

이주하는 동안에 발생한 모든 오류는 로그 창에 로그됩니다. 예를 들어, Sample.Samp이라는 클래스를 이주하는 동안에 로그 창에 다음 메시지가 표시되었다고 가정합시다.

클래스 이주: Sample.Samp

클래스를 이주할 수 없음:<Pkg>X::Y

Sample.Samp는 X::Y를 참조합니다. VisualAge for Java가 클래스 Y를 로드할 때 문제점이 발생했습니다. Y가 이주되지 않았거나 누락되었습니다(비주얼 컴포지션 편집기에서 클래스 Y는 문제가 있는 클래스로 표시됩니다). 이를 수정하려면 Y를 먼저 이주하거나, Y가 누락된 경우 Y를 대신할 클래스를 찾으십시오. VisualAge for Java의 이전 버전에서 Samp 또는 Y를 열어 빈 또는 특성을 재설정함으로써 이주가 계속되게 할 수도 있습니다.

일부 경우, VCE에서 클래스를 열면 클래스 참조 분석 대화 상자가 열립니다. 이 대화 상자에 VCE에 있는 문제점이 있는 클래스가 표시됩니다. 대화 상자의 분석되지 않은 클래스 참조는 임시 대체 클래스로 사용된 VisualAge for Java 클래스를 지정하고 다음과 같이 나타납니다.

com.ibm.uvm.abt.edit.DeletedClassView(X)

괄호 안에 표시된 X는 문제점이 있는 클래스 이름입니다. 이것을 보면, 현재 클래스 다음에 X가 올바르게 이주된 것 같습니다. 이를 수정하려면, 수정할 행을 선택한 후 바꾸기 단추를 클릭하십시오. "유효한 클래스 선택" 대화 상자에서 대체 클래스로서 클래스 X를 선택하십시오. 해결되지 않은 모든 클래스에 대해 이를 수행하고 OK를 클릭하십시오.

D.17.0 Servlet 빌더 및 Servlet 실행기

Servlet 빌더 및 Servlet 실행기는 VisualAge for Java, 버전 4.0에 포함되어 있지 않습니다. 버전 4.0과 호환되는 Servlet 빌더 런타임 JAR 파일은 http://www.ibm.com/vadd에서 사용할 수 있습니다. "다운로드" 링크를 클릭하십시오.  

VisualAge for Java, 버전 4.0에는 이전에 Servlet 실행기에서 제공하던 기능을 직접 대체하는 새 기능은 없습니다. Servlet을 테스트하려면, 웹 브라우저에 URL을 입력하여 Servlet을 명시적으로 시작하거나 HTML 또는 JSP 페이지를 작성하여 이를 호출할 수 있습니다. 새 Servlet 개발시, Servlet을 시작할 HTML 페이지를 작성하는 새 Servlet SmartGuide를 사용할 수 있습니다.

런타임 파일을 사용하는 데에는 두 가지 옵션이 있습니다.

시나리오 1

이 시나리오에서, 코드를 반출하기 전에, Servlet 빌더를 사용하여 VisualAge for Java의 이전 개정판에서 코드를 편집하십시오.  

  1. 응용프로그램 코드를 VisualAge for Java의 이전 개정판에서 설치 트리 외부의 디렉토리 또는 저장소로 반출하십시오.  
  2. WoodenChair "Utility+ JDK Standard Edition"과 같은 유틸리티를 사용하여 Java 코드를 J2SDK v1.2.2로 반출하십시오(패키지의 이름을 바꾸고 종속관계의 변경사항을 처리하십시오). 이 제품과 해당 기능에 대한 자세한 정보는 WoodenChair의 웹 사이트 http://www.woodenchair.com/를 참조하십시오.
  3. J2SDK v1.2.2를 사용하여 .java 클래스 파일 및 JAR 파일 각각을 컴파일하십시오. Servlet 빌더 4.0 런타임 JAR 파일은 반드시 컴파일 클래스 경로에 있어야 합니다. 
  4. 코드를 Websphere Application Server로 전개하십시오. Servlet 빌더 4.0 런타임 JAR 파일은 반드시 WebSphere Application Server 문서 루트 디렉토리나 또는 서버의 클래스 경로에 있어야 합니다.
  5. 추가 수정이 필요한 경우, 단계 1로 돌아가서 필요한 다른 단계를 반복하십시오.

시나리오 2

이 시나리오에서, VisualAge for Java 내에서 Servlet 빌더 코드를 편집하여 WebSphere Unit 테스트 환경에서 이를 테스트하십시오.

다음 단계를 수행하십시오.

  1. Servlet 빌더 4.0 런타임 JAR 파일을 VisualAge for Java 버전 4.0으로 반입하십시오.
  2. 작업할 프로젝트를 VisualAge for Java, 버전 4.0 작업영역으로 반입하십시오.
  3. 수정/이주 SmartGuide를 사용하여 코드 내의 손상된 참조를 복구하십시오.
  4. 원하는 대로 직접 코드를 수정한 후 WebSphere Unit 테스트 환경에서 컴파일하여 테스트하십시오.
  5. 프로젝트를 JAR 파일로 반출하십시오.
  6. 코드를 Websphere Application Server로 전개하십시오. Servlet 빌더 4.0 런타임 JAR 파일은 반드시 WebSphere Application Server 문서 루트 디렉토리 또는 서버의 클래스 경로에 있어야 합니다.

VisualAge for Java 온라인 도움말에서 이 단계를 수행하는 방법에 대한 정보를 얻을 수 있습니다.

VisualAge for Java의 이전 릴리스에서 사용할 수 있었던 Servlet 빌더 기능은 HTML 사용자 인터페이스를 직접 생성한 Servlet을 작성했습니다. 이 기능은 신속하게 응용프로그램을 개발하는 데 유용하나 응용프로그램의 비니지스 논리를 사용자 인터페이스와 결합해야 하는 단점이 있습니다. 사용자 인터페이스에 변경이 필요하면 Servlet을 수정해야 합니다. 유지관리를 쉽게 하기 위해서는 JSP(JavaServer Pages) 기술을 사용하여 비니지스 논리와 사용자 인터페이스를 분리하는 것이 좋습니다.

JSP 페이지는 동적으로 생성된 내용을 포함하는 HTML 템플리트입니다. JSP 페이지는 IBM WebSphere Studio의 PageDesigner 기능과 같은 HTML 편집 도구를 사용하여 수정할 수 있습니다. IBM WebSphere 프로그래밍 모델에서, Servlet은 계속해서 웹 대화에 사용되나 비지니스 논리는 Java 빈에 위임되고 사용자 논리는 JSP에 위임됩니다. 이 프로그래밍 모델에서, Servlet 및 빈은 Java 도구를 사용하여 개발되고 JSP 페이지는 HTML 도구를 사용하여 개발됩니다.

비지니스 논리와 사용자 인터페이스를 분리함으로써, 개발 책임을 숙련된 기술과 도구를 가진 팀 구성원에게 할당하여 쉽게 유지관리가 되도록 이끌 수 있습니다.

WebSphere 프로그램밍 모델에서, Servlet 빌더에 의해 제공된 기능은 VisualAge for Java의 Java 도구와 WebSphere Studio의 HTML 도구로 대체됩니다. VisualAge for Java, 버전 4.0은 WebSphere 모델을 따르는 웹 응용프로그램을 작성할 수 있는 새 SmartGuide(마법사)를 제공합니다. Servlet 작성 SmartGuide를 사용하여 비지니스 논리에 대한 빈과 사용자 인터페이스에 대한 JSP 페이지를 호출할 수 있습니다. SmartGuide는 Servlet을 테스트하는 데 사용할 수 있는 HTML 양식도 생성합니다. Servlet은 즉시 VisualAge for Java의 WebSphere 테스트 환경에서 테스트되어 IDE에서 수정할 수 있습니다. JSP 및 HTML 파일은 WebSphere Studio 또는 다른 HTML 도구를 사용하여 다시 편집할 수 있습니다.

Servlet 작성 SmartGuide는 WebSphere Studio의 JavaBean 마법사에 모델화되어 있습니다. 여기에는 Java 프로그래머에게 필요한 추가 기능이 들어 있습니다. 이미 HTML 문서에 WebSphere Studio를 사용하고 있으면, SmartGuide가 해당 도구와 VisualAge for Java 간의 작업 흐름을 단순화시키고 있음을 알게 됩니다. 개발 단계는 다음과 같습니다.

  1. 응용프로그램의 비지니스 논리에 대한 Java 빈을 작성하십시오.
  2. SmartGuide를 사용하여 Servlet, JSP 및 HTML 양식을 생성하십시오.
  3. VisualAge for Java에서 Servlet을 테스트하십시오.
  4. VisualAge for Java에서 Servlet 개발을 계속하십시오.
  5. WebSphere Studio 또는 이와 동등한 도구에서 JSP 및 HTML 파일을 수정하십시오.  

D.18.0 Swing 클래스

Swing 클래스는 JDK v1.1.x용이던 때와 달리 J2SDK v1.2.2의 다른 패키지에 있습니다. Swing 클래스에 대한 참조를 갱신해야 할 경우에는 수정/이주 SmartGuide를 사용할 수 있습니다.

응용프로그램을 이주하려면, 관련된 클래스와 패키지를 선택하고, 수정/이주 SmartGuide를 연 다음(패키지나 클래스를 오른쪽 클릭한 다음 재구성 > 수정/이주 선택), JDK1.2 이름이 바뀐 패키지 포함 선택란을 선택하여 자동으로 Swing 참조를 J2SDK v1.2.2로 이주해야 합니다.이것이 Swing에 대해 적절한 출발/도착 항목을 추가합니다. 이주하는 동안에 발생한 모든 오류는 로그 창에 로그됩니다.

적절한 응용프로그램 이주 방법에 대한 자세한 내용은 온라인 도움말 주제 중에서 "클래스 또는 패키지에 대한 수정/이주 기준 참조" 및 "클래스 또는 패키지 복구 참조"를 참조하십시오.  

Swing의 1.03과 1.1.1 버전 사이에 일련화가 변경되어, 비주얼 컴포지션 편집기를 사용하여 모든 Swing 특성을 JDK 1.1.7에서 Java 2로 이주할 수 없을 수 있습니다. 코드를 VisualAge for Java, 버전 4.0으로 이주한 후, VCE에서 일부 Swing 응용프로그램 클래스를 열지 못할 수도 있습니다. 이는 Javabean의 특성을 Swing 객체로 설정하기 위해 VCE 특성 시트를 사용한 경우에만 발생합니다.

이 문제를 해결하려면 다음 단계를 따르십시오.

  1. (VCE에서) 이전 버전의 VisualAge for Java에서 클래스를 다시 여십시오.
  2. 클래스의 특성 시트에서 재설정 단추를 클릭하십시오. 사용자가 수정한 빈 특성을 모두 나열하는 창이 열립니다. Swing 객체로 설정된 특성을 이의 기본 설정으로 재설정해야 합니다.
  3. 클래스를 저장하고 이를 버전 4.0 IDE로 재반입하십시오.

D.19.0 XMI 툴킷  

XMI 툴킷의 베타 1.2 버전에서 이주하는데 대한 자세한 내용은 XMI 툴킷 릴리스 정보를 참조하십시오.

XMI 툴킷의 3.5 버전을 제외한 다른 릴리스(예: 기술 검토, alphaWorks 릴리스 또는 이전 베타 버전)를 사용한 경우, XMI 툴킷의 이 릴리스를 사용하기 전에 설치 해제하고 설치 중 수행한 환경 갱신을 제거해야 합니다. 이주 지시사항은 1.2 릴리스에 대해서만 제공됩니다.

Beta 1.2 및 Beta 이전 1.2 릴리스 모두로부터 생성된 zip 파일 및 XMI 파일은 XMI Toolkit의 3.5 또는 3.5.x 릴리스와 호환되지 않습니다.

파트 E: 일반 정보

E.1.0 프로젝트 자원 및 자원 관리 처리

VisualAge for Java의 버전 4.0에서, 프로젝트 자원 파일을 버전화 및 릴리스화할 수 있습니다. 새 기능에 대한 자세한 정보는 IDE 및 팀 온라인 도움말을 참조하십시오.

VisualAge for Java의 2.0 또는 3.0x에서 VisualAge for Java 버전 4.0으로 프로젝트를 이주한 경우, 이주 프로세스를 완료한 후 이 단계를 수행할 수 있습니다. 이주를 완료한 후 즉시 이들 단계를 수행할 필요는 없지만, 이 단계를 수행할 때까지 프로젝트 자원은 저장소에서 버전화되지 않습니다. 
주: 버전 3.5에서 프로젝트를 이주한 경우 이들 단계를 수행할 필요가 없습니다.

  1. 모든 이전 프로젝트 자원을 버전 4.0 프로젝트 자원 디렉토리로 복사했는지 확인하십시오.
  2. 프로젝트를 저장소에서 사용자의 작업영역에 추가하십시오.
  3. 각 프로젝트의 새 개방판을 작성하십시오. 개방판을 작성할 때까지는 새 자원을 프로젝트에 추가할 수 없습니다.
  4. 프로젝트를 버전화하십시오. 그러면 모든 자원이 릴리스화됩니다.  

VisualAge for Java, Enterprise Edition의 팀 환경에서 작업하려면 EMSRV 버전 7.1을 사용해야 합니다. 

E.2.0 OS/2 및 AIX로부터 이주

OS/2 및 AIX는 VisualAge for Java, 버전 4.0의 개발 플랫폼으로는 지원되지 않습니다. VisualAge for Java, 버전 4.0만을 Windows NT, Windows 98 및 Windows 2000에 클라이언트로 설치할 수 있습니다. OS/2 및 AIX 저장소에서 버전 4.0을 사용하려면, 버전 4.0 IDE로부터 해당 저장소에 연결해야 합니다. 그 수행 방법에 대한 자세한 내용은 온라인 도움말을 참조하십시오.  

플랫폼 특정 코드를 작성할 경우, Windows에서 작동하도록 하려면 다시 작성해야 합니다.

두 가지 시나리오 

주: 동일 시스템에 AIX와 Windows가 함께 있을 수 없으므로 시나리오 1의 단계는 오직 OS/2용으로만 사용할 수 있습니다.

시나리오 1

ivj.dat OS/2 저장소가 Windows 클라이언트와 동일한 시스템에 있다면,

  1. 기존 ivj.dat를 백업하십시오. 저장소는 Windows 98, Windows NT 또는 Windows 2000 및 VisualAge for Java 버전 4.0을 설치한 후에 복원될 것입니다. 저장소가 OS/2에서 관리하는 FAT 파티션에 상주하고 같은 시스템에 Windows 98/NT/2000을 설치하여 FAT 파티션을 보존하려는 경우, 저장소를 백업할 필요가 없습니다. 그러나 Windows를 설치할 때 문제가 발생한 경우에는 저장소를 꼭 백업하도록 권장합니다. 
  2. Windows 98, Windows NT 또는 Windows 2000을 설치하십시오. 시스템이 OS/2를 실행 중이면 기존 OS/2 설치를 유지하도록 이중 부트 옵션을 사용하여 동일 시스템에 Windows 98/NT/2000을 설치할 수 있습니다.
  3. VisualAge for Java, 버전 4.0을 설치하십시오. 
  4. 새로운 Windows 설치로써 액세스할 수 있는 국지 하드 디스크에 있는 파티션에 저장소를 복원하십시오. 저장소가 이전에 OS/2에서 관리하는 FAT 파티션에 상주하였고 파티션이 아직 존재할 경우, 저장소를 복원할 필요가 없습니다.  
  5. 기존의 저장소(Enterprise)에 연결하거나 기존의 저장소(Professional)로부터 반입하십시오. 기존의 프로젝트 자원을 버전 4.0 프로젝트 자원 디렉토리로 복사해야 합니다.

시나리오 2

ivj.dat OS/2 또는 AIX 저장소는 Windows 클라이언트와 다른 시스템에 있습니다.

  1. OS/2 또는 AIX 시스템에 VisualAge for Java, 버전 4.0에서 제공하는 EMSRV 저장소 프로그램(버전 7.1)이 수행되고 있어야 합니다. VisualAge for Java의 3.02 이전 버전에 사용되던 저장소에 연결할 수 있지만, 버전 4.0에서 이전 저장소에 연결하려면 EMSRV의 버전 7.1이 설치되어 있어야 합니다.
  2. Windows 클라이언트에 VisualAge for Java, 버전 4.0이 수행 중이며, 필요에 따라 OS/2 또는 AIX 서버에 연결됩니다. 기존의 프로젝트 자원을 버전 4.0 프로젝트 자원 디렉토리로 복사해야 합니다.

E.3.0 J2SDK v1.2.2의 새로운 보안 제한사항  

Java 2 플랫폼 v1.2.2에서 실행 중인 애플릿에 대한 보안 정책 변경 때문에 애플릿은 더 이상 국지 자원에 액세스할 수 없습니다. 

이러한 제한사항 때문에 VisualAge for Java의 이전 버전에서 사용할 수 있었던 여러 샘플이 VisualAge for Java, 버전 4.0에는 포함되어 있지 않습니다. 또한 포함된 일부 샘플은 오직 응용프로그램으로서만 수행될 수 있고 그렇지 않으면 제대로 작동하지 않을 것입니다. 샘플을 제대로 수행시키는 방법에 대한 지시사항에 대해서는 온라인 문서를 참조하십시오.

-Djava.security.policy=someURL 매개변수를 사용하여 자신의 java.policy 파일을 작성한 후 AppletViewer를 시작하여 기본 보안 policy를 변경할 수 있습니다.

여기서, someURL 은 새로운 policy 파일의 위치입니다. Java에서의 일반 보안에 대한 자세한 내용은 http://java.sun.com/security를 참조하십시오.
Java 2 및 policy 파일 구문에 대한 특정 내용은 http://java.sun.com/products/jdk/1.2/docs/guide/security를 참조하십시오.

E.4.0 새 외부 버전 제어 도구(외부 SCM 도구를 대체함)

VisualAge for Java, 버전 3.5에 소개된 외부 버전 제어 도구를 이용하면 ClearCase, PVCS Version Manager, TeamConnection 및 VisualAge for Java의 SourceSafe와 같은 외부 소스 코드 관리(SCM) 제공자에 연결할 수 있습니다. 이 도구를 사용하면 클래스를 SCM 제공자에 추가하고, 클래스 및 자원 파일 SCM 시스템에 체크인 및 체크 아웃하며, SCM 시스템으로부터 가장 최근에 체크인된 클래스 버전을 반입할 수 있습니다.

이 도구는 이전의 외부 SCM 도구를 대체하며 향상된 기능을 제공합니다.

E. 5.0 VisualAge for Java에서 타사 ORB에 대한 작업

J2SDK v1.2.2에서 호환될 경우 타사 ORB(Object Request Broker)를 다룰 수 있습니다. 작업을 하기 전에 ORB 클래스를 IDE로 반입해야 합니다.

Java 클래스를 IDE로 반입하면, ORB 확장 클래스를 Java 클래스 라이브러리에 추가할 수 있습니다. J2SDK v1.2.2 핵심 클래스의 일부가 아닌 이상 기존의 Java 클래스 라이브러리에 있는 ORB 확장 클래스 중 일부를 대체할 수도 있습니다.

버전 3.5.x에서 타사 ORB에 대한 작업에 대한 자세한 정보는 다음 웹 사이트를 참조하십시오.

http://www.ibm.com/software/vadd/Data/Document2175

이 사이트에는 VisualAge for Java에서 CORBA(Common Object Request Broker Architecture) 및 ORB 응용프로그램 개발에 관한 포괄적인 정보가 들어 있습니다.

타사 ORB가 VisualAge for Java에 반입되면 특정 Java 클래스 라이브러리 클래스를 대체할 수도 있습니다. 버전 3.5용 패치 2는 (가변 패키지에 포함된) 특정 불변 클래스를 VisualAge for Java에 반입하도록 잘못 허용한 버그를 수정합니다. 패치 2를 VisualAge for Java, 버전 3.5에 적용한 후 타사 ORB를 반입할 때 로그 창에서 새로운 또는 추가 경고를 수신할 수도 있습니다. 이러한 경로는 불변 클래스를 VisualAge for Java에 반입할 수 없기 때문에 발생하지만, 패치 2를 적용한 후에는 무시할 수 있습니다.

E.6.0 추가 기능 CD의 내용

VisualAge for Java 추가 기능 CD에 다음 항목이 있습니다.

설치 및 이주 안내서와 제품 README는 추가 기능 CD와 기본 제품 CD에 모두 있습니다.

주: 추가 기능 CD는 오직 VisualAge for Java, Enterprise Edition에만 포함되어 있습니다. 그러나 다음 항목은 제품 CD의 VisualAge for Java, Professional Edition에 포함되어 있습니다.

설치 및 이주 안내서와 제품 README는 VisualAge for Java, Professional Edition 제품 CD에 있습니다.

IBM J2EE Connectors and Tools for J2EE(TM) - 베타 버전

이번 릴리스의 VisualAge for Java에는 Sun Microsystems Inc.는 공식적으로 릴리스하지 않은 Java 2 Platform, Enterprise Edition (J2EE)의 몇 가지 컴포넌트의 베타 버전이 포함되어 있습니다. 그것이 다음 항목입니다.

베타 버전 컴포넌트의 위치는 extras\BetaJ2EEConnectors 서브디렉토리입니다. 베타 버전 컴포넌트를 사용하려면 컴포넌트용 설치 지시사항에 대한 BetaJ2EEConnectors 서브디렉토리에 있는 README 파일을 참조하십시오.

주: VisualAge for Java, 버전 4.0과 함께 선적된 컴포넌트는 Windows NT 및 Windows 2000에서만 지원됩니다. 모든 J2EE 런타임 파일이 Windows 2000에서 지원되지는 않습니다. J2EE 컴포넌트에 대한 자세한 내용은 엔터프라이즈 액세스 빌더 온라인 도움말과 릴리스 정보를 참조하십시오.

팀 서버(EMSRV) 

추가 기능 CD에 있는 팀 서버 디렉토리에는 EMSRV 저장소 서버 프로그램 및 "서버 설정 및 관리" 파일(emsrv71.htm 또는 영어 이외의 언어용 emsrv70.htm)이 있습니다. EMSRV 설치에 관한 지시사항에 대해서는 파트 C를 참조하고 서버 시작 정보에 대해서는  "서버 설정 및 관리"(TeamServer\docs에 위치함)를 참조하십시오. 

분산 가능한 런타임

VisualAge for Java로 빌드된 애플릿이나 응용프로그램을 반출하고 전개할 때, 코드를 작성했던 기능용 런타임 라이브러리를 전개해야 하며 클래스 경로에 전개된 런타임 JAR 파일이나 Zip 파일을 입력해야 합니다.

일반적으로 JAR 파일은 압축되어 있고 서버에서 작동 중인 애플릿을 끌 때 사용됩니다. Zip 파일은 압축 해제되어 있고 응용프로그램을 국지적으로 수행하기 위해 시스템 전개의 클래스 경로에 있어야 있어야 합니다.

VisualAge for Java 런타임 라이브러리는 exras/runtime30 및 extras/runtime35 디렉토리에 포함되어 있습니다. 사용자가 VisualAge for Java의 어느 기능을 설치했는가에 따라 일부 또는 전체 런타임 라이브러리가 사용자 설치 이미지의 eab/runtime35 또는 runtime30 디렉토리에 제공됩니다. 주: J2EE 런타임 라이브러리는 추가 기능 CD에 포함되지 않습니다. 베타 컴포넌트를 설치한 후에 J2EE Connector에 대한 런타임 파일은 eab\runtime 35와 IBM Connectors\classes에 위치하게 됩니다.  

런타임 라이브러리 설치 및 사용에 대한 자세한 내용은 온라인 도움말을 참조하십시오.

IBM Developer Kit 1.2.2 (Windows용)

IBM Developer Kit 디렉토리에 위치한 IBM Developer Kit, Java Technology Edition v 1.2.2, PTF 9는 100% 순수 Java 스펙과 일치하는 독립형 Java 응용프로그램 및 애플릿 개발을 지원하는 Java 개발 환경입니다.

이는 Java 응용프로그램 및 애플릿 개발용 도구를 포함하는데 그 중 일부는 다음과 같습니다. 

Java 컴파일러 
Java 소스 코드를 Java 바이트코드로 변환합니다. Java 바이트코드는 나중에 Java 번역기와 함께 실행됩니다.
Java 클래스 라이브러리 
모든 표준 Java 클래스를 제공하여 사용자의 Java 응용프로그램이 기존 Java 객체를 작성하고 확장할 수 있게 허용합니다. 
Java 애플릿 열람기 
명령 프롬프트로부터 애플릿 수행 방법을 제공합니다. 
Java 문서 생성 프로그램 
절절히 주석된 Java 프로그램으로부터 Toolkit의 응용프로그램 프로그래밍 인터페이스(API)를 생성합니다. 

IBM Developer Kit을 설치하려면 IBM Developer Kit 디렉토리에서 install.exe를 수행하십시오. IBM Developer Kit에 대한 상세한 세부정보는 IBM Developer Kit 디렉토리에 있는 README 파일을 참조하십시오.

Oracle 및 Microsoft SQLServer용 Merant DataDirect SequeLink Java Edition 버전 5.1

VisualAge for Java, 버전 4.0은 Microsoft SQL 서버 및 Oracle 데이터베이스 액세스에 필요한 Merant's DataDirect SequeLink Java Edition 버전 5.1 드라이버를 지원합니다.

주: VisualAge for Java, 버전 4.0과 함께 선적된 Merant DataDirect SequeLink Java Edition 버전 5.1 서버는 Windows NT 및 Windows 2000에서만 지원됩니다.

SequeLink는 최신 JDBC 표준에 대해 Oracle, Miscrosoft SQL 서버 및 본체 데이터와 같은 다양한 데이터베이스로 데이터 연결을 제공하는 미들웨어 데이터 액세스 컴포넌트입니다. SequeLink의 클라이언트 컴포넌트는 데이터베이스에 대해 독립적이어서 하부구조에 새 데이터베이스가 추가되어도 변경이 필요하지 않습니다. 브랜드된 SequeLink 클라이언트가 WebSphere 테스트 환경에 포함되어 있습니다.

주: SequeLink 클라이언트는 브랜드 되기 때문에 WebSphere 테스트 환경이나 WebSphere Application Server와 함께 클라이언트를 사용하는 동안에 사용자는 오직 Merant DataDirect Sequelink Java Edition 버전 5.1 서버와만 통신할 수 있습니다. Merant DataDirect SequeLink Java Edition 버전 5.1 서버는 완전히 사용 허가된 서버는 아니므로, 브랜드된 Sequelink 클라이언트와 작업하는 것 외의 다른 목적으로는 이를 사용할 수 없습니다. 완전히 사용 허가된 Merant DataDirect SequeLink Java Edition 버전 5.1 서버가 있을 경우, 브랜드된 Sequelink 클라이언트도 그 서버와 함께 작업할 수 있습니다.

해당 SequeLink 서버는 키 없는(즉, 설치시에 화면에서 등록 키를 묻지 않음) 설치로서 사용할 수 있습니다. 서버는 추가 기능 CD의 Merant\SequeLinkServer 서브디렉토리에서 설치할 수 있습니다.

드라이버 설정 및 설치 방법은 드라이버와 함께 사용하려는 컴포넌트에 따라 변합니다. 특정 설치 및 설정 정보(WebSphere 테스트 환경에 포함된 SequeLink 클라이언트 구성 정보 포함)에 대해서는 릴리스 정보를 참조하십시오.

Distributed Debugger

VisualAge for Java IDE 외부에서 개발된 클래스를 디버그하려거나 별도 시스템에서 수행 중인 프로그램을 디버그하려면 Distributed Debugger를 설치해야 합니다

Distributed Debugger는 Windows, AIX, OS/2, HP-UX, Solaris, Linux 및 Linux/390 운영 체제에서 지원됩니다. 모든 디버거 파일은 추가 기능 CD의 디버거 디렉토리에 있습니다. 설치 지시사항은 파트 B, 2.1.1.1. 절을 참조하십시오.  

기술 미리보기

추가 기능 CD에는 두 가지의 기술 미리보기가 있습니다. 즉, 엔터프라이즈 JavaBeans용 IBM 저장 프로시저 통합 도구 및 XMI 브릿지가 그것입니다.

엔터프라이즈 JavaBeans용 IBM 저장 프로시저 통합 도구

데이터베이스 저장 프로시저를 추가하는 방법으로 상태 비저장 세션 EJB을 강화하기 위해 엔터프라이즈 JavaBeans용 IBM 저장 프로시저 통합 도구(EJB용 SP 통합 도구)를 사용할 수 있습니다. 저장 프로시저 작성 호출 메소드 SmartGuide를 사용하여 사용자의 메소드를 정의할 수 있고 그 후에 상태 비저장 세션 빈에 새 메소드를 생성할 수 있습니다.

EJB용 SP 통합 도구를 사용하여 EJB 환경 내의 기존 저장 프로시저에 포함되어 있던 비지니스 논리를 증폭시킬 수 있습니다. EJB 개발 노력을 최소화하고 EJB 서버 및 데이터베이스 관리 시스템(DBMS)에서 중복되는 비지니스 논리를 회피할 수 있습니다. 또한 저장 프로시저는 EJB 서버와 EBMS 사이의 네트워크 소통량이 감소되도록 도울 수 있으므로 생산 응용프로그램의 성능을 개선할 수 있습니다.

EJB용 SP 통합 도구의 위치는 extras\spt 서브디렉토리에 있습니다. 기술 미리보기의 설치 및 사용에 관한 자세한 내용은 spt 디렉토리의 EJB_SPTool.PDF 파일을 참조하십시오. EJB에 대한 SP 통합 도구를 설치하고나면, EJB_SPTool.PDF 파일도 다음 디렉토리 x:\ibmvjava\ide\tools\com-ibm-ivj-sptools에 위치하게 됩니다. 여기서 x:\ibmvjava는 사용자의 제품 설치 디렉토리입니다.

XMI 브릿지

XMI 브릿지는 Persistence 빌더 및 엔터프라이즈 JavaBeans에 대한 기술 미리보기입니다. 여기서 엔터프라이즈 JavaBeans는 Rational Rose 모델 파일이나 XMI 문서를 Persistence 빌더 모델 또는 EJB 그룹으로 반입할 수 있게 합니다.

XMI 브릿지의 위치는 extras\xmib 디렉토리입니다. XMI 브릿지를 다루기 전에 작업영역에 XMI 툴킷을 추가해 두어야 합니다. 기술 미리보기 설치와 사용에 관한 자세한 내용은 xmib 디렉토리에 있는 README 파일을 참조하십시오.

인쇄할 수 있는 문서

온라인 도움말의 일부는 Adobe Acrobat Reader(http://www.adobe.com/)를 사용하여 보고 인쇄할 수 있는 PDF 문서로 통합되어 있습니다. 모든 PDF가 모든 언어로 사용할 수 있는 것은 아닙니다. PDF 파일은 pdf 디렉토리에서 사용할 수 있습니다. 

각 PDF 파일에 들어 있는 내용에 대해 알려면 PDF 색인(시작하기 전에 안내서)을 참조하십시오.

도움말 시스템 문제점 해결 안내서

도움말 실패 복구하기에 관한 자세한 내용은 도움말 시스템 문제점 해결 안내서를 참조하십시오. 안내서의 위치는 추가 기능 CD의 Troubleshoot 디렉토리에 있으며 모든 언어로 사용할 수 있습니다.

저장소 및 자원

ivj40 디렉토리에는 두 개의 zip 파일, 즉 ide.zip 및 wte_resources.zip이 있습니다. ide.zip 파일에는 저장소 사본(ivj.dat), 프로젝트 자원 디렉토리(ivj.dat.pr), 작업영역 파일(ide.icx)이 있습니다. wte_resources.zip 파일에는 WTE 기능에 대한 프로젝트 자원의 백업 사본이 있습니다.

부록 A: 데이터 액세스 컴포넌트 비교 

다음은 데이터 액세스 빌더, 데이터 액세스 빈 및 Persistence 빌더를 비교한 것입니다. EJB 개발 환경에 대한 설명은 포함되어 있으나 이 컴포넌트는 비교에는 포함되어 있지 않습니다.

데이터 액세스 빈 기능은 상관적 데이터를 시각적으로 액세스하는 신속한 방법을 제공합니다. 이 기능은 다시 사용이 가능한 객체 모델이 필요하지 않은 응용프로그램에 사용됩니다. 데이터 액세스 빈을 사용하여 대상 데이터베이스 내의 테이블을 직접 열람하는 비주얼 응용프로그램을 작성하도록 도울 수 있습니다. 또한 수동으로 데이터 액세스 빈을 사용자 코드에 통합시킬 수도 있습니다.

EJB 개발 환경을 사용하여 Sun Microsystems' Enterprise JavaBeans(EJB) 프로그래밍 스펙을 구현하는 빈을 개발할 수 있습니다. EJB 개발 환경은 IBM WebSphere Application Server에 대한 모든 필수 런타임 지원을 제공합니다. 증분 일관성 점검 프로그램은 엔터프라이즈 빈이 EJB 프로그래밍 스펙을 준수하는지를 확인하고 불일치를 수정하기 위해 변경이 필요한지 여부를 나타냅니다. EJB 개발 환경에 대해서는 온라인 도움말을 참조하십시오.

Persistence 빌더는 객체 모델에 대해 조정 가능한 영속 지원을 제공하며 여러 고객에 대한 EJB를 향한 첫번째 단계입니다. Persistence 빌더를 사용하여 빌드된 응용프로그램은 최적의 재사용가능 객체 모델에 초점을 둘 수 있으며, 지원되는 관계형 데이터베이스에 이를 신속하게 맵핑합니다. Persistence 빌더는 상향식(스키마에서 객체) 및 하향식(객체에서 스키마) 맵핑을 지원합니다. 이 기능은 객체 및 객체 간의 관계를 관계형 데이터베이스에 저장된 데이터에 맵핑합니다.

이 문서의 나머지 부분에서는 데이터 액세스 기능(데이터 액세스 빈, 데이터 액세스 빌더 및 Persistence 빌더) 간의 차이점에 대해 설명합니다.

이 기능의 구현에 대한 자세한 내용은 여기에 포함되어 있지 않습니다. 온라인 문서는 Persistence 빌더와 데이터 액세스 빈이 제공하는 관계, 시각적 팔레트 파트, 고급 트랜잭션 기능 및 SQL 지원 SmartGuide와 같은 추가 기능성에 대해 설명합니다.

데이터 액세스 빌더의 주요 기능을 나타내는 핵심 기능 목록이 아래에 나열되어 있습니다. 각 핵심 기능은 컴포넌트마다 다른 방법으로 구현되었습니다.

파트 1: 관계형 맵핑에 대한 객체 기능

객체 맵핑에 대한 데이터베이스 스키마

코드 생성

파트 2: 런타임 기능

파트 3: 데이터 액세스 빈 기능

기능의 구현 방법은 다음 페이지에 설명되어 있습니다. 데이터 액세스 빌더와 Persistence 빌더의 기능을 모두 연속하여 비교하며, 한편 유사한 (맵핑용) 데이터 액세스 빈 기능은 이 절의 끝부분에 나열되어 있습니다.

파트 1: 관계형 맵핑에 대한 객체 기능

객체 맵핑에 대한 데이터베이스 스키마

1.0 테이블 및 열람을 사용한 객체 맵핑에 대한 데이터베이스 스키마

데이터 액세스 빌더에서

주: 모든 데이터 액세스 빌더 단계는 데이터 액세스 빌더를 포함하는 VisualAge for Java의 이전 버전(3.02 이하)에서 수행되어야 합니다.  

스키마 맵핑 SmartGuide에서 DB2 또는 ODBC 연결을 선택한 다음 데이터베이스 테이블 또는 열람 선택 라디오 단추를 선택하십시오. 다음을 클릭하십시오. 다음 페이지가 열리면서 테이블 목록이 표시됩니다.

작업할 테이블을 선택한 후 종료를 클릭하십시오. 이들 테이블과 결과 객체 사이의 1 대 1 객체 맵핑이 작성됩니다. 데이터 액세스 빌더 창에는 자동으로 발생하는 속성 맵핑에 대한 열이 표시됩니다.

Persistence 빌더에서

스키마 브라우저에서, 스키마 > 데이터베이스에서 스키마 반입을 선택하십시오. 연결 정보를 입력하십시오. 테이블 선택 대화 상자가 열립니다.

원하는 테이블 및 열람을 선택하고 OK를 클릭하십시오. 스키마 브라우저에는 새로운 스키마가 포함되며 해당 테이블, 열 및 키가 나열됩니다.

스키마 > 스키마로부터 모델 생성을 선택하십시오. 그러면, 간단한 일대일 비지니스 모델이 생성됩니다.

2.0 조정 조회를 사용한 객체 맵핑에 대한 데이터베이스 스키마

데이터 액세스 빌더에서

스키마 맵핑 SmartGuide에서 DB2 또는 ODBC 연결을 선택한 후 SQL 명령문 입력 라디오 단추를 선택하십시오. 다음을 클릭하십시오. 작업할 테이블을 선택한 후 다음을 클릭하십시오. 다음 페이지가 열립니다.

조회를 입력하고 완료를 클릭하십시오. 위의 예제에 두 테이블 결합 조회가 표시됩니다. 매개변수 값을 가진 조회도 지원됩니다.

결과 객체에 다음과 같이 두 테이블로부터 결합된 속성이 들어 있습니다.

Persistence 빌더에서

Persistence 빌더를 사용하여 스키마를 수작업으로 맵핑하여 결합 조회 맵핑을 수행할 수 있습니다.
  1. 스키마 브라우저를 사용하여 스키마를 반입하십시오.
  2. 모델 브라우저를 열어 테이블이 맵핑될 객체 모델을 작성하십시오.
  3. 모델이 완료되면, 맵핑 브라우저를 열어 새 데이터스토어 맵을 작성하십시오. 스키마와 이미 작성된 모델을 선택하십시오.
  4. 모델 클래스를 선택하고 새 테이블 맵 > 상속이 없는 클러스터 맵 추가를 선택하여 클러스터 맵을 추가하십시오.
  5. 결합 테이블을 더 추가하려면, 새 테이블 맵 > 보조 테이블 맵 추가 메뉴 항목을 선택하십시오. 테이블이 추가되었으면, 각 테이블 맵에서 특성 맵 편집기를 열어 개별 속성을 맵핑하십시오.
  6. 각 속성을 테이블 열로 맵핑하고 다른 테이블 열은 맵핑되지 않은 상태로 두십시오. 맵핑 브라우저는 네 번째 분할 영역의 각 테이블에 해당하는 특성을 맵을 표시합니다.

3.0 저장 프로시저를 사용한 객체 맵핑에 대한 데이터베이스 스키마

데이터 액세스 빌더에서

스키마 맵 SmartGuide에서, DB2 또는 ODBC 연결을 선택한 다음 저장 프로시저 결과 세트 라디오 단추를 선택하십시오. 저장 프로시저 페이지가 열리면서 저장 프로시저 목록이 표시됩니다. 맵핑 이름을 입력하고 저장 프로시저를 선택한 후 완료를 클릭하십시오.

결과 객체에 저장 프로시저의 결과 열에 맵핑된 속성이 들어 있습니다. CRUD 작동에 대한 조회 또는 저장 프로시저는 이 유형의 맵핑에 대해 사전 정의되어 있지 않습니다.

Persistence 빌더에서

Persistence 빌더는 저장 프로시저 맵핑을 지원하는 도구를 지원하지 않습니다. 지원 코드를 제공해야 하는 skeleton 서비스 클래스를 작성하는 "스텁 스키마"를 생성할 수 있습니다. 모든 인스턴스 메소드는 다음과 같이 나타납니다.

/**
* Return a query spec for the query called allInstances
* @return java.util.Vector
*/

public java.util.Vector allInstancesQuery() {
   Vector aSpecArray = new Vector();
     DatabaseCompoundType aCompoundType;
        DatabaseQuerySpec spec = new DatabaseCallableQuerySpec("{call getAllEmp ()}");
      aCompoundType = new DatabaseCompoundType();
        aCompoundType.addField((DatabaseTypeField)(new                              com.ibm.ivj.db.base.DatabaseDecimalField("COMM")).setAttributes(9,2,3,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseIntegerField("EMPNO")).setAttributes(4,0,4,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseDecimalField("SAL")).setAttributes(9,2,3,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseIntegerField("DEPTNO")).setAttributes(2,0,4,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseStringField("ENAME")).setAttributes(10,0,12,false));

((DatabaseSelectQuerySpec)spec).setOutputShape(aCompoundType);

aSpecArray.addElement(spec);
return aSpecArray;
}

코드 생성

 

4.0 객체에서의 CRUD 작동

데이터 액세스 빌더

기본 CRUD 작동(작성, 검색, 갱신 및 삭제)이 하나의 테이블 당 하나의 객체 맵핑으로 생성됩니다. 조정 조회 또는 저장 프로시저를 사용할 경우, 이 조회는 누락되며 데이터 액세스 빌더 도구를 사용하여 수동으로 조회를 정의해야 합니다. 예를 들면, 고객이라는 객체를 정의하는 결합 조회가 있을 수 있습니다.

  1. 데이터 액세스 빌더 창의 빈의 팝업 메뉴에서 메소드를 선택하십시오. addCustomer1라고 하는 새 메소드를 추가하십시오.

  2. 다음 SQL 명령문을 입력하십시오.

INSERT INTO TPF.CUSTOMER (
CUSNO,
FIRSTNAME,
MIDINIT,
LASTNAME,
HOMEPHONE,
HOMEADDR,
WORKPHONE,
BILLADDR,
BRANCHNO,
OPEN DATE)
VALUES (?, ?, ?, ?, ?, ?, ?,?, ? ,?)

데이터 액세스 빌더가 조회를 확인한 후 페이지 페이지를 사용하여 개별적으로 매개변수를 맵핑해야 합니다.

두 번째 결합 테이블 CUSTDATA의 삽입을 위해 addCustomer2 조회를 정의해야 합니다. 이 자동 기능에 대한 두 조회의 동기화는 사용자에 의해 처리됩니다.

Persistence 빌더

정의된 스키마와 모델 간에 맵이 작성되면 Persistence 빌더는 모든 CRUD 작동을 생성합니다. 멀티 테이블 조인의 경우, 각 테이블 조회가 생성되고 서비스 엔진은 이 작동을 자동 단위로서 관리합니다.

저장 프로시저는 도구에서는 지원되지 않으나 "스텁 스키마"는 생성되어 확장될 수 있습니다. 삽입 저장 프로시저 조회의 예는 다음과 같습니다.

/**
*Return a query spec for the query called insert
* @return java.util.Vector
* @param args java.util.Vector
* @param anInjector com.ibm.vap.Persistence.BOInjector 

public java.util.Vector insertQuery(java.util.Vector args,com.ibm.vap.Persistence.BOInjector anInjector) {
    Vector aSpecArray = new Vector();
DatabaseCompoundType aCompoundType;
   

 DatabaseQuerySpec spec = new DatabaseCallableQuerySpec("{call     

    insertEmp (?,?,?,?)}");

Vector stringArgs;
a CompoundType = new DatabaseCompoundType();

aCompoundType.addField((DatabaseTypeField)(new         com.ibm.ivj.db.base.DatabaseIntegerField("EMPNO")).setAttributes(4,0,4,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseDecimalField("SAL")).setAttributes(9,2,3,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseIntegerField("DEPTNO")).setAttributes(2,0,4,false));

aCompoundType.addField((DatabaseTypeField)(new com.ibm.ivj.db.base.DatabaseStringField("ENAME")).setAttributes(10,0,12,false));

StringArgs = new Vector();
stringArgs.addElement("EMPNO");
stringArgs.addElement("SAL");
stringArgs.addElement("DEPTNO");
stringArgs.addElement("ENAME");

spec.setInputShape(aCompoundType);
spec.setInputValues(args);
spec.setInputNamesWithDuplicates(stringArgs);
   aSpecArray.addElement(spec);
        return aSpecArray;

5.0 조정 조회 지원

데이터 액세스 빌더에서

데이터 액세스 빌더에서의 조정 조회는 CRUD 조회가 정의된 것과 동일한 방법으로 정의됩니다. 사용자는 명명된 조회를 추가하고, 필요할 경우 매개변수를 사용합니다. 결과 조회는 BusinessObjectMgr 클래스에서의 메소드처럼 나타납니다.

데이터 액세스 빌더는 SQL 조건 대체와 같은 조정 조회를 정의하는 다른 방법도 제공합니다.

TheEmpMgr.select('WHERE WORKDEPT = 'E11');

Persistence 빌더에서

두 가지 방법으로 Persistence 빌더에 조정 조회를 추가할 수 있습니다. Lite Collection은 클래스 편집기를 사용하여 클래스 레벨에 정의될 수 있습니다. 다음 페이지는 지정된 클래스에서의 탐색과 필터에 사용됩니다.

Lite collection 조회는 일반적으로 해당 비지니스 객체로 "드릴 다운"할 탐색 목록 및 대화 상자에 사용됩니다. 결과 메소드는 해당 영속 비지니스 객체를 검색하는 데 사용할 수 있는 "데이터 객체" 벡터를 리턴합니다.

다음은 위에 표시된 생성된 Lite Collection을 사용하는 예제 코드입니다.

VapCourseHomeImpl aHome = VapCourseHomeImpl.singleton();
    VapDepartmentKey aKey = new VapDepartmentKey("Sales"); 
VapLiteCollection liteCollection = aHome.getByDepartmentLiteCollection(aKey); 

Enumeration enum = liteCollection.elements();
VapCourseDataObject aDO;
VapCourse aCourse; 

while (enum.hasMoreElements()) {

    aDO = (VapCourseDataObject)enum.nextElement(); 
   aCourse = aHome.find(aDO.getNumber()); 
   //Fetching fully hydrated EJBObject
   }

Persistence 빌더는 비지니스 클래스에 여러 가지 작동을 정의하는 데 사용할 수 있는 조정 조회 프레임워크도 제공합니다. 이러한 조회는 완전히 작동하는 비지니스 객체를 리턴합니다.

다음은 "retrieveStudentsOver21"라는 조정 조회를 가진 학생 클래스에 대한 예제입니다. 학생의 홈 클래스는 다음과 같은 메소드를 갖고 있습니다.

public Vector retrieveStudentsOver21() throws java.rmi.RemoteException,     
com.ibm.vap.common.VapReadFailureException {
    return customQuery("studentsOver21Query");
}

학생에 대한 QueryPool에는 조정 서비스에 대한 해당 메소드가 있습니다.

/* Return a query spec for the query called studentsOver21
 @return java.util.Vector */

public java.util.Vector studentsOver21Query() {
    Vector aSpecArray = new Vector();
   aSpecArray.addElement(new DatabaseSelectQuerySpec(studentsOver21SqlString()));
          return aSpecArray;

}

/* Return the SQL string for the query called studentsOver21Query
  @return java.lang.String */

public java.lang.String studentsOver21SqlString() {

return "SELECT T1.SNAME, T1.SNO, T1.SADVFNO, T1.SBDATE, T1.SADDR, T1.SPHNO, T1.SMAJ, T1.SIQ FROM SPARKY.STUDENT T1 WHERE T1.SBDATE <= (CURRENT DATE - 00210000.)";
}

이 메소드는 홈에서 실행가능하며, All-instances 메소드와 유사한 객체 캐시 동작을 갖고 있습니다. 이 메소드에 대한 자세한 정보는 Persistence 빌더 온라인 도움말을 참조하십시오.

파트 2: 런타임 기능

1.0 데이터스토어/트랜잭션 기능

데이터 액세스 빌더에서

데이터 액세스 빌더의 데이터스토어는 여러 응용프로그램 레벨에서 구성될 수 있습니다.

데이터 액세스 빌더 데이터스토어는 일반적인 트랜잭션 모델을 갖고 있습니다. 즉, 비지니스 기능을 적용하기 위해 여러 개의 트랜잭션이 필요한 경우 각 트랜잭션을 나타내는 데이터스토어가 활성화되어야 합니다.

다음은 직원 및 부서 모델에 대한 간단한 시나리오입니다.

EmployeeDatastore anEmpDS = new EmployeeDatastore().connect();
DepartmentDatastore aDeptDS = new DepartmentDatastore().connect();

Employee anEmp = new Employee();
Department aDept = new Department();

// Perform actions on anEmp and aDept

if (User Applied Employee Changes)
anEmpDS.commit()
else
anEmpDS.rollback();
aDeptDS.commit();

Persistence 빌더

VisualAge for Java, 버전 4.0에서 Persistence 빌더에는 데이터 소스를 찾기 위해 JNDI 이름을 사용하는 WebSphere 연결 풀을 사용하는 옵션이 있습니다. 이 옵션은 서비스 클래스를 사용할 때 사용할 수 있습니다.

Persistence 빌더의 여러 데이터스토어는 모델 데이터에 액세스하기 위해 여러 데이터베이스가 사용될 경우에만 필요합니다. 여러 번 중첩된 트랜잭션은 데이터스토어 단위로 지원됩니다. 트랜잭션은 데이터 액세스 빌더에 있는 것으로 간주되지 않습니다. 사용자 트랜잭션은 응용프로그램 비지니스 객체에 대한 열람이 있는 트랜잭션 객체에 의해 제어됩니다.

다음은 데이터 액세스 빌더 예제에서와 동일한 트랜잭션 성능을 보여주는 코드의 일부분입니다.

DB2Datastore aDS = DB2Datastore.singleton().activate();
Transaction empTransaction = Transaction.begin();
Employee anEmp = EmployeeHomeImpl.create("EmpNum1");
Transaction deptTransaction = Transaction.begin();
Department aDept = DepartmentHomeImpl.create("DeptNum1");

// Do some actions on anEmp and aDept, always resuming the appropriate transaction before making changes to the corresponding BO.

if (User Applied Employee Changes)
    empTransaction.commit();
else
    empTransaction.rollback();
deptTransaction.commit();

Persistence 빌더에서 트랜잭션이 확약될 때까지는 SQL이 실행되지 않습니다. 객체 트랜잭션 상황은 명시적 구간 복원 및 확약이 발생할 때까지 내부적으로 유지 관리됩니다.

2.0 API 지원

결과 비니지스 객체와 이에 속한 관리 객체에 대해 생성된 메소드는 세 프레임 간에 약간씩 다릅니다. 다음 테이블은 각 기능에 사용되는 클래스 및 메소드를 보여줍니다.

 

데이터 액세스 빌더

Persistence 빌더

데이터 액세스 빈

작성

aBusinessObject.add();

aBusinessObjectHome.create();

aSelectBean.newRow();

검색

aBusinessObject.retrieve();

aBusinessObjectHome.find (aKey);

 aSelectBean.setParameter
("ColumnName", value);
aSelectBean.execute();
모두 검색 aBusinessObjectMgr.select(); aBusinessObjectHome.allInstances(); aSelectBean.execute();
갱신 aBusinessObject.update(); (*) 지원되지 않음
삭제 aBusinessObject.delete(); aBusinessObject.remove(); 지원되지 않음
현재 삭제 aBusinessObject.deleteCurrent(); 지원되지 않음(**) aSelectBean.deleteRow();
현재 갱신 aBusinessObject.updateCurrent(); 지원되지 않음(**) aSelectBean.updateRow();
확약 aBusinessObjectDS.commit(); currentTransaction.commit(); aSelectBean.commit();
구간 복원 aBusinessObjectDS.rollback(); currentTransaction.rollback(); aSelectBean.rollback();
활성화 aBusinessObjectDS.connect(); aDataStore.activate(); aSelectBean.connect();
재설정 ABusinessObjectDS.disconnect(); aDataStore.reset(); aSelectBean.disconnect();

코드 예제: 직원을 찾아 전화 번호를 변경함

Employee anEmp = 
new Employee();
anEmp.setEmpno
("000130");
anEmp.retrieve();
anEmp.setPhoneno
("555-9988");
anEmp.update();
anEmp.getDefault
Datastore().
commit();

EmployeeHome aHome = EmployeeHome.singleton();

Employee anEmp = 
aHome.find("000130");

anEmp.setPhoneno("555-9988");
Transaction.
getCurrent().commit();

Retrieve all employees:

aSelectBean.execute();

positionToEmployee
("000130"); 
// User written method
// to position to 
//correct row

aSelectBean.
setColumnValue
("PhoneNo", "555-9988");

aSelectBean.updateRow();

aSelectBean.commit();
// If connection is not
//autoCommit=true

Retrieve result set with
only one employee row.

aSelectBean.setParameter
("EmployeeID", "000130");
aSelectBean.execute();
aSelectBean.setColumnValue
("PhoneNo", "555-9988");
aSelectBean.updateRow();

aSelectBean.commit();
// If connection is not 
//autoCommit=true

(*)갱신 작동은 비지니스 객체에 대한 값 변경에 의해 암시되며, 활성화 트랜잭션이 확약되면 해당 갱신 명령문을 발행함으로써 변경사항이 데이터스토어와 동기화됩니다.

(**)커서 지원 절에서는 대안 솔루션을 보여줍니다.

LOB 지원

데이터 액세스 빌더

Persistence 빌더

데이터 액세스 빈

데이터 액세스 빌더에는 DAIOStream이라는 클래스가 포함되며, 이는 전체 객체를 메모리로 폴트하지 않고 데이터베이스로부터 LOB를 검색하는데 사용됩니다.

Persistence 빌더는 현재 스트림 LOB를 지원하지 않습니다. LOB 객체는 메모리로 폴트됩니다.

DAB는 JDBC 2.0 LOB 데이터 유형을 지원합니다. JDBC 2.0 드라이버를 사용하여 LOB를 검색할 경우, 메모리로의 전체 LOB을 검색하거나 LOB 옵션만을 검색하도록 지정하십시오.

 

3.0 Quickforms(RAD 기능)

데이터 액세스 빌더

Persistence 빌더

데이터 액세스 빈

데이터 액세스 빌더의 Quickform 기능은 일반적인 AWT 파트를 사용하여 제공된 모델을 나타내기 위한 신속한 샘플 열람을 제공합니다.

VCE의 시각적 파트에 대한 콜렉션은 비주얼 프로그래밍의 복잡성을 덜어 주기 위해 사용됩니다. 이러한 파트는 사용자가 시각적으로 작업 단위를 분리할 수 있게 하는 트랜잭션 클래스를 나타냅니다.

버전 4.0에는 Select 빈이 확보한 테이블 열을 나타내는데 Swing 컴포넌트를 사용하는 응용프로그램을 작성할 데이터베이스 응용프로그램 마법사가 포함됩니다. VCE의 표준 QuickForm 성능을 사용하여 Select 빈의 특성에 기초한 조정 UI를 신속하게 작성할 수 있습니다.

4.0 현재 날짜/시간/시간소인 지원

데이터 액세스 빌더 도구를 사용하여 해당 SQL을 생성하는 "현재" 날짜/시간 데이터 유형을 지정할 수 있습니다. Persistence 빌더와 데이터 액세스 빈의 도구에서는 이것을 지원하지 않지만 SQL을 수동으로 추가할 수 있습니다.

5.0 커서 지원

데이터 액세스 빌더는 updateCurrent() 또는 deleteCurrent()와 같은, 결과 세트에 대해 커서 기능을 지원합니다.

Persistence 빌더는 현재 이러한 작동을 지원하지 않습니다. 이런 경우의 알맞은 대안은 데이터 액세스 빈 기능을 사용하는 것입니다.

데이터 액세스 빈은 커서 위치를 관리하는 DBNavigator 비주얼 파트로 커서 기능을 지원합니다. 다음은 모든 커서 기능에 대한 설명입니다.

JDBC v1.0은 JDBC 결과 세트에서 뒤로 이동을 지원하지 않습니다. Select 빈은 특정 행에 대한 직접 액세스뿐 아니라 결과 세트를 통해 화면을 이동할 수 있게 하는 결과 세트의 캐시도 유지관리합니다. Select 빈에는 캐시 크기를 조정할 수 있는 특성도 있습니다. 전체 결과 세트를 캐시(기본값임)로 인출하거나 패킷을 한 번에 캐시로 인출할 수 있습니다. 패킷의 크기 및 숫자는 사용자에 의해 조정됩니다.

결과 세트가 표시되면, Select 빈은 결과 세트에 있는 행을 갱신, 삭제 또는 삽입하는 메소드를 제공합니다. 이 기능을 수행하기 위해 사용자가 새로운 SQL을 기록할 필요는 없습니다.

6.0 비동기 실행

데이터 액세스 빌더는 생성된 클래스에 실행가능 인터페이스를 제공하여 비동기 작동을 지원합니다.

Persistence 빌더는 각 CRUD 작동마다 실행가능 인터페이스를 제공하고 조정 조회에도 하나의 실행가능 인터페이스를 제공합니다. 각 비지니스 클래스의 서비스 객체에는 해당 클래스의 실행 유형을 결정하는 runAsynch() 메소드가 있습니다.

데이터 액세스 빈은 "DBAction" 실행가능 인스턴스를 생성하는 DBNavigator 도구를 통해 비동기 실행을 지원합니다.

동시성 문제점(잠금/분리 레벨)

데이터 액세스 빌더에는 생성된 데이터스토어 클래스인 setTransactionIsolation(int)에 데이터베이스 분리 레벨을 설정하는 API가 있습니다.

Persistence 빌더는 자신의 트랜잭션을 유지 관리하고 내부적으로 다음과 같은 분리 레벨을 지원합니다.

트랜잭션은 반복 가능으로 읽기 또는 반복 불가능으로 읽기 분리 레벨을 지정합니다. 비지니스 클래스에 대한 서비스 구현은 비잠금 또는 잠금 구현을 지정합니다. 레벨간의 차이점에 관한 자세한 정보는 Persistence 빌더 온라인 도움말을 참조하십시오.

데이터 액세스 빈에는 데이터베이스 분리 레벨을 설정하는 API가 있습니다. 조정 특성 편집기 또는 DatabaseConnection.setTransactionIsolation() 메소드를 통해 연결 정보를 제공할 때 원하는 분리 레벨을 지정함으로써 이를 수행할 수 있습니다.

파트 3: 데이터 액세스 빈(DAB) 기능

DAB에 대한 맵핑은 테이블과 Select 빈 사이에서 발생합니다. 테이블과 Select 빈 간의 맵핑은 1:1이 아니므로 Select 빈이 테이블을 대표하지 않습니다. 그러나 Select 빈은 현재 행 및 결과 세트를 다루는데 매우 유용합니다. 테이블에서 기본 데이터베이스 프로그래밍 작동을 수행하는데 사용할 수 있는 Select 빈을 한 두 개 작성하십시오. 이렇게 조회, 읽기, 쓰기, 갱신 및 삭제와 같은 데이터베이스 작동에 DAX를 단순하고 직설적인 방법으로 사용한다면 DAB가 DAX의 좋은 대안이 될 수 있습니다.

Select 빈의 조회 특성(연결 정보 및 SQL 조회 정보로 구성됨)을 설정하여 데이터베이스와 대화할 수 있습니다.  조회 특성에 포함된 연결 정보는 둘 이상의 Select 빈에 의해 사용될 수 있습니다. Select 빈을 비주얼 컴포지션 편집기를 사용하거나 수작업으로 코드에 통합할 수 있습니다.

다음은 고객 테이블의 현재 행을 다루는 Select 빈을 작성하는 방법에 대한 일반적인 개요입니다. 이 단계를 수행하는 방법에 대해서는 온라인 도움말을 참조하십시오.

  1. VCE에서 클래스를 열고, Select 빈을 작성한 후 조회 특성 편집기를 여십시오.  
  2. 필요한 연결 정보를 입력하고 데이터베이스 액세스 클래스를 생성하십시오.
  3. 데이터 액세스 클래스를 지정하십시오. SQL 지원 SmartGuide를 여십시오.

  4. 고객 테이블을 선택하는 것과 고객 번호(cusno)가 매개변수 CUSTNUM과 정확하게 일치하는 조건을 지정하는 것이 고객용 Select 빈을 생성합니다. 이 Select 빈에 대한 데이터베이스 액세스 클래스는 다음과 유사하게 나타납니다.

이 Select 빈을 사용하여 고객 테이블의 행에서 기본 데이터베이스 작동(읽기, 쓰기, 갱신 및 삭제)을 수행할 수 있습니다(고객 번호가 지정되었을 때).  

두 번째 Select 빈 작성

동일한 프로시저를 수행하되 조건을 지정하지 않으면 결과 세트를 다루기 위한(즉, 데이터베이스 조회 수행) 또 다른 Select 빈을 작성할 수 있습니다. 두 번째 Select 빈은 DAB 결과 세트 기능성을 이용할 수 있게  합니다. 이 Select 빈에 대한 데이터베이스 액세스 클래스는 다음과 유사하게 나타납니다.

Select 빈 및 조정 조회

DAB는 조정된 조회를 사용하는 Select 빈 작성에 대해 강력한 지원을 제공합니다. 아래 표시된 것처럼 SQL 지원 SmartGuide는 결합 조회 작성, 조회용 조건 지정, 열 선택, 열 분류 및  필드 맵핑을 지원할 수 있습니다.

데이터 액세스 빈 및 저장 프로시저

프로시저 호출 빈은 저장 프로시저를 다룰 수 있게 합니다. 프로시저 호출 작성은 Select 빈 작성과 매우 유사합니다. 저장 프로시저용 SmartGuide는 아래 표시한 것처럼 사용할 수 있는 저장 프로시저를 열거합니다.

프로시저 호출 빈에 대한 자세한 내용은 데이터 액세스 빈 온라인 도움말을 참조하십시오.

저작권 및 주의사항

(C)Copyright IBM Corp.1997, 2001. All Rights Reserved.

이 정보는 미국 내에서 제공되는 제품 및 서비스용으로 개발되었습니다. IBM은 다른 국가에서는 이 정보에서 언급한 제품, 서비스 또는 피쳐를 제공하지 않을 수도 있습니다. 현재 사용 가능한 제품 및 서비스에 대한 정보는 한국 IBM 담당자에게 문의하십시오. IBM 제품, 프로그램 또는 서비스를 언급했다고 해서 반드시 IBM 제품, 프로그램 또는 서비스만을 사용할 수 있다는 의미는 아닙니다. IBM의 지적 재산권을 침해하지 않는 한, 타사의 기능상 동등한 제품, 프로그램 또는 서비스를 대신 사용할 수 있습니다. 그러나 비-IBM 제품, 프로그램 또는 서비스 운용에 대한 평가 및 검증은 사용자의 책임입니다.

다음 문단은 영국이나 이러한 조항이 현지법과 상충하는 다른 국가에는 적용되지 않습니다.

IBM은 타인의 권리를 비침해, 상품성 및 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여(단, 이에 한정되지 않음) 명시적이든 묵시적이든 어떠한 종류의 보증 없이 "현상태대로" 이 책을 제공합니다. 일부 국가에서는 특정 거래에서 명시적 또는 묵시적 보증의 면책사항을 허용하지 않으므로 이 사항이 적용되지 않을 수도 있습니다. 이 정보에는 기술적으로 부정확한 내용이나 인쇄상의 오류가 있을 수 있습니다. 여기에 수록된 정보는 주기적으로 변경되며, 이러한 변경사항은 새 개정판에 통합됩니다. IBM은 통지 없이 언제든지 이 정보에서 설명된 제품 및(또는) 프로그램을 개선하거나 변경할 수 있습니다.

이 정보에서 언급되는 비-IBM 웹 사이트는 편의상 제공된 것으로 이들 웹 사이트를 옹호하기 위한 것은 절대 아닙니다.

이들 웹 사이트에 나오는 자료들은 본 IBM 제품에 대한 자료의 일부가 아니며, 이들 웹 사이트의 사용으로 인한 위험은 귀하가 감수해야 합니다. IBM은 귀하에게 어떠한 의무도 발생하지 않는다고 생각되는 적정한 방식으로 귀하가 제공하는 정보를 사용하거나 배포할 수 있습니다. IBM은 이 정보에서 설명된 사용권이 있는 프로그램 및 이에 따라 사용이 가능한 사용권이 있는 모든 자료를 IBM 기본 계약, IBM 프로그램 사용권 계약(IPLA) 또는 이와 동등한 상호 계약 조건에 의거하여 제공합니다.

IBM, AIX, AS/400, DB2, OS/390, OS/400, RS/6000, S/390, VisualAge 및 WebSphere는 미국 및 기타 국가에서 사용되는 IBM Corporation의 상표입니다.

Lotus, Lotus Notes 및 Domino는 미국 및 기타 국가에서 사용되는 Lotus Development Corporation의 상표입니다. Java 및 모든 Java 기반 상표 및 로고는 미국 및 기타 국가에서 사용되는 Sun Microsystems, Inc.의 상표입니다. Microsoft, Windows 및 Windows NT는 미국 및 기타 국가에서 사용되는 Microsoft Corporation의 상표입니다. Intel 및 Pentium은 미국 및 기타 국가에서 사용되는 Intel Corporation의 상표입니다. 기타 회사, 제품 및 서비스 이름은 다른 회사의 상표 또는 서비스표입니다.