1. IBM Software Group | Rational Software © 2003 IBM Corporation 1 iSeries – i5 Machine QSYSWRK SBS QZRCSRVSD (Remote Command Server - daemon) TCP/IP QUSRWRK SBS QZRCSRVS Pre-start Jobs QZRCSRVS Evoked Jobs QEGLYourLIB EGL Client EGL Program EGL Communications QVGNSVR QVGNRNCLQVGNSETPYourPgm Source File: QVGNSAMP EGL Calling System i Programs 1 2 Java Toolbox Class 3 4 5 6 7 1.Call statement issued (call YourPgm) 2.EGL Java400 comm layer does data conversions and invokes JT400 APIs 3.JT400 Toolkit invokes iSeries Remote Command Server 4.iSeries Remote Command Services is used (prestarted jobs first) 5.EGL Catcher program (QVGNSRVR) is invoked from QEGL library 6.QVGNSETP invoked to set library list if needed (CAN BE CUSTOMIZED) 7.QVGNRNCL is invoked from user library (REQUIRED TO BE COPIED THERE) to set commitment control 8.Called program is invoked from user library 8

2. IBM Software Group | Rational Software © 2003 IBM Corporation 2 Key Linkage Options Properties – System i pgmnameProgram being called conversionTableName of conversion table CSOE037 is conversion to US English (EBCDIC) librarySystem i library containing the called program (note: must also contain copy of QVGNRNCL) locationHost name of the system I machine luwControlTells EGL runtime to commit/rollback at end of each call (on return) remoteBindLinkage information is set at generation time remoteComTypeTell EGL communications layer what protocol to use remotePgmTypeSpecifies called program is EGL or non-EGL

3. IBM Software Group | Rational Software © 2003 IBM Corporation 3 What is required for Remote Calls – System i ?  Client (WAS or IDE) –Java Toolkit for 400 Toolkit Java version – if Client is not on iSeries Native Version – If Client on iSeries machine –like WAS on i See next chart for info on how to obtain –Must be added to lib directory of WEB-INF Use import->File System  Server (iSeries) –EGL COBOL Runtime for iSeries Obtained through WDSC-AE V6 or Working to make call support code downloadable for free –iSeries Remote Command Server

4. IBM Software Group | Rational Software © 2003 IBM Corporation 4 What is required for Remote Calls – System i ?  Getting the Java Toolkit for the 400 or  With WDSC, in the following directory – \rwdi_shared\eclipse\plugins\com.ibm.etools.iseries.toolbox_6.0.1\runtime or  From the System i directories –\QIBM\ProdData\HTTP\Public\j4400\lib

5. IBM Software Group | Rational Software © 2003 IBM Corporation 5 Calling a Program – Setting Userid/Password  Use syslib.setRemoteUser – built in function –Can be set with literals or variables