You can use TCP/IP to access a VSAM file on a remote z/OS® system from EGL-generated Java™ code or from the EGL debugger. Use the VSAM Connector Server to control the operation if you typically access the file through a batch job.
To set up z/OS and Rational® Business Developer for remote VSAM support, you must install and configure the EGLVsamCon VSAM handler module on the z/OS system. EGLVsamCon is an archive file that contains a set of Java programs. Those programs handle the VSAM access requests and return the results. The following instructions assume that Java Runtime Environment version 1.5 or higher is already installed and configured. You do not need to apply any special configurations during Java installation for the VSAM Connector Server.
installDir\eclipse\plugins\com.ibm.etools.egl.vsam_version\EGLVsamCon.jar
ftp hostname
bin
cd /u/auser/EGLVSAMCon
put EGLVsamCon.jar
installDir\eclipse\plugins\com.ibm.etools.egl.vsam_version\
binaries\noncics\libEGLConSrvrUtility.so
ftp hostname
bin
cd /u/auser/EGLVSAMCon
put libEGLConSrvrUtility.so
//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
//
// ARGS='5553 TRACE'
To start the server:
extattr +p libEGLConSrvrUtility.so
If the server fails to start, you will see an error message in the log file. Otherwise the server starts listening to the specified port and returns the results from any requests.
/p EGLVSAMC
SysLib.setRemoteUser("auserid", "apassword");
ZOS:\\install_dns_or_ip:port\dataset
ZOS:\\ZOSMVS01:5553\//INFO.ORDERS
ZOS:\\ZOSMVS01:5553\//'CUST.INFO.ORDERS'
//ORDERS DD DSN=CUST.INFO.ORDERS,DISP=SHR
ZOS:\\ZOSMVS01:5553\//DD:ORDERS