VSAM Connector Server에 대해 원격 VSAM 지원 설치 및 구성
TCP/IP를 사용하여 EGL 생성 Java™ 코드 또는 EGL 디버거에서 원격 z/OS® 시스템의 VSAM 파일에 액세스할 수 있습니다. 일반적으로 일괄처리 작업을 통해 파일에 액세스하는 경우 VSAM Connector Server를 사용하여 조작을 제어하십시오.
원격 VSAM 지원을 위해 z/OS 및 Rational® Business Developer을 설정하려면 z/OS 시스템에서 EGLVsamCon VSAM 핸들러 모듈을 설치하고 구성해야 합니다. EGLVsamCon은 Java 프로그램의 세트를 포함하는 아카이브 파일입니다. 해당 프로그램은 VSAM 액세스 요청을 처리하고 결과를 리턴합니다. 다음 지시사항에서는 Java Runtime Environment 버전 1.5 이상이 이미 설치되어 구성되었다고 가정합니다. VSAM Connector Server에 대해 Java 설치 중 특수 구성을 적용할 필요가 없습니다.
z/OS에 EGLVsamCon 전송
- z/OS USS(UNIX System Services)를 사용하여 EGL VSAM Connector Server 파일을 전송할 수 있는 대상 디렉토리를 작성하십시오. 이러한 지시사항에서는 /u/auser/EGLVSAMCon이라는 디렉토리를 작성했다고 가정합니다.
- Rational Business Developer 설치 폴더에서
EGLVsamCon.jar 파일을 찾으십시오.
installDir\eclipse\plugins\com.ibm.etools.egl.vsam_version\EGLVsamCon.jar - 2진 모드에서 FTP를 사용하여 EGLVsamCon.jar 아카이브를 z/OS에 전송하십시오.
- 세션을 Initiate®하십시오.
ftp hostname - 프롬프트가 표시되면 사용자 이름 및 비밀번호를 입력하십시오.
- 다음 명령을 입력하십시오.
bin cd /u/auser/EGLVSAMCon put EGLVsamCon.jar
- 세션을 Initiate®하십시오.
- Rational Business Developer 설치
폴더에서 다음 라이브러리를 찾으십시오.
installDir\eclipse\plugins\com.ibm.etools.egl.vsam_version\ binaries\noncics\libEGLConSrvrUtility.so - 2진 모드에서 FTP를 사용하여 libEGLConSrvrUtility.so 라이브러리를
z/OS로
전송하십시오.
- 세션을 시작하십시오.
ftp hostname - 프롬프트가 표시되면 사용자 이름 및 비밀번호를 입력하십시오.
- 다음 명령을 입력하십시오.
bin cd /u/auser/EGLVSAMCon put libEGLConSrvrUtility.so
- 세션을 시작하십시오.
EGL VSAM Connector Server 시작 JCL 준비
EGLVsamCon.jar
파일의 기본 클래스는 com.ibm.etools.egl.vsam.host.zos.EGLConSrvr입니다.
EGLConSrvr은 실행 시 지정된 포트에서 오는 요청을 청취하고
결과를 해당 포트에 리턴합니다. 다음 JCL을 통해
기타 Java 프로그램의 경우와 같이
EGLConSrvr을 시작하십시오. 이 JCL은 JVMPRC50을 호출하고
ARGS를 통해 지정된 인수를 전달합니다. 이 예제에서 지정된 포트는 5553입니다.
//EGLVSAMC JOB CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1),NOTIFY=&SYSUID
//PROCLIB JCLLIB ORDER=SYS1.PROCLIB
//* TODOs
//* 1. Tailor the JCL to suite the installation of Java.
//* 2. Review EGLVsamCon_HOME.
//* 3. Review the first argument to EGLSRV step to configure port.
//* 4. Add TRACE as second argument to EGLSRV step to enable log.
//EGLSRV EXEC PROC=JVMPRC50,VERSION='50',
// JAVACLS='com.ibm.etools.egl.vsam.host.zos.EGLConSrvr',
// ARGS='5553'
//STDENV DD *
export EGLVsamCon_HOME=/u/auser/EGLVSAMCon
export JAVA_HOME=/usr/lpp/java/J5.0
export PATH=/bin:"${JAVA_HOME}"/bin:"${EGLVsamCon_HOME}"
LIBPATH=/lib:/usr/lib:"${JAVA_HOME}"/bin
LIBPATH="$LIBPATH":"${JAVA_HOME}"/bin/classic
LIBPATH="$LIBPATH":"${EGLVsamCon_HOME}"
export LIBPATH="$LIBPATH":
CLASSPATH="${JAVA_HOME}/lib/tools.jar"
CLASSPATH="$CLASSPATH":"${EGLVsamCon_HOME}/EGLVsamCon.jar"
export CLASSPATH="$CLASSPATH":
# Configure JVM options
IJO="-Xms64m -Xmx128m"
groupname='id -gn'
export IBM_JAVA_OPTIONS="$IJO "
export JAVA_DUMP_HEAP=false
export JAVA_PROPAGATE=NO
export IBM_JAVA_ZOS_TDUMP=NO
//
자세한 로그를 사용으로 설정하려면 키워드 TRACE를
두 번째 매개변수로 추가하십시오.
// ARGS='5553 TRACE'
EGL VSAM Connector Server 시작
EGL
VSAM Connector Server가 Java 스레드를 작성하여
각 VSAM 액세스 요청을 처리합니다. 이 스레드는
요청자가 액세스할 수 있는 VSAM 파일에만 액세스할 수 있도록 요청자의 ID를
사용합니다(EGL VSAM Connector Server를
시작한 사용자에 대조적으로). 따라서 EGL VSAM Connector
Server를 시작하는 사용자는 다음 권한 중 하나를 요구합니다.
- FACILITY 클래스의 BPX.SERVER 자원 프로파일에 대한 읽기 또는 업데이트 액세스
- 수퍼유저 상태
서버를 시작하려면 다음을 수행하십시오.
- 다음 명령을 사용하여
libEGLConSrvrUtility.so 라이브러리에 대해 프로그램-제어 플래그를 켜십시오.
extattr +p libEGLConSrvrUtility.so - 이전 섹션에서 EGLVSAMC JCL을 제출하여 EGL VSAM Connector Server를 시작하십시오.
서버가 시작되는 데 실패하면 로그 파일에서 오류 메시지가 표시됩니다. 그렇지 않으면 서버가 지정된 포트 청취를 시작하고 임의의 요청에서 결과를 리턴합니다.
EGL
VSAM Connector Server를 종료하려면 작업을 취소하십시오.
/p EGLVSAMC
EGL 구성
- z/OS에서 원격 VSAM 파일에 액세스하는 데
유효한 사용자 ID 및 비밀번호가 필요합니다.
- EGL 생성 Java 코드에서 파일에 액세스하려고 계획하는 경우 다음과 같이 수행하십시오.
- 다음 EGL 명령을 사용하여 사용자 ID 및 비밀번호를 설정하십시오.
SysLib.setRemoteUser("auserid", "apassword"); - 5단계로 진행하십시오.
- 다음 EGL 명령을 사용하여 사용자 ID 및 비밀번호를 설정하십시오.
- EGL 디버거에서 파일에 액세스하려고 계획하는 경우 EGL 환경 설정에 ID 및 비밀번호를 저장하십시오. 를 클릭하십시오.
- EGL 생성 Java 코드에서 파일에 액세스하려고 계획하는 경우 다음과 같이 수행하십시오.
- 원격 사용자 필드에 유효한 ID를 입력하십시오.
- 원격 비밀번호 필드에 유효한 비밀번호를 입력하십시오.
- 확인을 클릭하여 환경 설정을 저장하고 종료하십시오.
- EGL 생성 Java 코드 및 디버깅에 대해
자원 연관 파트를 작성하고 액세스하려고 계획하는 각 VSAM 데이터 세트마다 연관 요소를
추가하십시오.
- 디버깅을 위해 system을 win으로 설정하고 런타임 시 해당 요소를 대상 플랫폼에 설정하십시오.
- fileType을 vsam 또는 ibmcobol로 설정하십시오.
- 다음 형식을 사용하여 systemName을 설정하십시오.
ZOS:\\install_dns_or_ip:port\dataset- install_dns_or_ip
- z/OS가 설치되는 위치입니다.
- port
- EGL VSAM Connector Server가 청취하는 포트입니다.
- dataset
- VSAM 파일의 이름입니다.
다음 예제에서 VSAM 파일 이름은 userid.INFO.ORDERS입니다. 인용 표시를 생략하면 사용자 ID가 파일 이름에 접두부로 추가됩니다.ZOS:\\ZOSMVS01:5553\//INFO.ORDERS다음 예제에서 VSAM 파일 이름은 CUST.INFO.ORDERS입니다. 작은따옴표 표시로 인해 파일 이름이 글자 그대로 해석됩니다.ZOS:\\ZOSMVS01:5553\//'CUST.INFO.ORDERS'다음 예제에서 VSAM Connector Server 시작 JCL이 ORDERS에 대해 다음 정의를 포함합니다.//ORDERS DD DSN=CUST.INFO.ORDERS,DISP=SHR이 정의로 인해 systemName 특성에서 DD 이름을 사용할 수 있습니다.ZOS:\\ZOSMVS01:5553\//DD:ORDERS
- 실행 시간과 디버깅에 대한 빌드 디스크립터에서 resourceAssociations 옵션이 이전 단계에서 작성한 자원 연관 파트의 이름으로 설정되는지 확인하십시오.