egl–callingcobolonsystemz

egl–callingcobolonsystemz内容摘要：

IBM Software Group | Rational Software 169。 2020 IBM Corporation 18 Configuration Calling remote CICS Progams – NonJ2EE IDE Debug Native Java EGL Communications Layer z/OS EGL Logic J2C Config Distributed CICS ELACSV (only when called PGM pointers) Tcpipservice port CTG Gateway Daemon CTG Server TCP/IP CTG Client Daemon Choice VTAM w/AnyNET TCP62 (LU62 within TCP/IP) LU62 MRO/EXCI TCP/IP EGL or native Program (CICSECI) (CICSECI) IBM Software Group | Rational Software 169。 2020 IBM Corporation 19 CTG Gateway/Server TID1 DFHMIRS TID2 DFHMIRS As Needed EGL COBOL Runtime YourLIB EGL Client EGL Program EGL Communications ELACSV7 YourPgm EGL Calling CICS Programs 1 2 CTG Client 3 4 5 7 1. Call statement issued (call YourPgm) 2. EGL CICSxxx m layer does data conversions and invokes CTG APIs 3. CTG Client municates with CTG Gateway/Server 4. CTG Server invokes TID1 (associated with DFHMIRS…required CICS prog) 5. DFHMIRS links to called program. Directly when data is to be sent as values (COMMDATA) 6. DFHMIRS links to ELACSV7 (as specified by EGL munications) when data is to be received as pointers or uses dynamic arrays. 7. ELACSV allocates storage and calls and passes data to called program CICS Region 6 IBM Software Group | Rational Software 169。 2020 IBM Corporation 20 Key Linkage Options Properties – J2EE pgmname Program being called conversionTable Name of conversion table CSOE037 is conversion to US English (EBCDIC) ctgLocation Not Needed in WAS resource definition ctgPort Not Needed in WAS resource definition location JNDI Name entry in WAS Resource entries (case sensitive) Region name defined in WAS resource definition luwControl Tells EGL runtime to mit/rollback at end of each call (on return) parmForm Data is passed by value (COMMDATA) or pointer (COMMPTR) remoteBind Linkage information is set at generation time remoteComType Tell EGL munications layer what protocol to use CICSJ2C remotePgmType Specifies called program is EGL or nonEGL serverID Not Needed – in WAS resource definition IBM Software Group | Rational Software 169。 2020 IBM Corporation 21 Key Linkage Options Properties – nonJ2EE pgmname Program being called conversionTable Name of conversion table CSOE037 is conversion to US English (EBCDIC) ctgLocation Host name of the CTG Gateway/Server machine ctgPort Port CTG Gateway/Server is listening on location CICS Entry associated with CICS Region to call in CICS Gateway/Server INI files luwControl Tells EGL runtime to mit/rollback at end of each call (on return) parmForm Data is passed by value (COMMDATA) or pointer (COMMPTR) remoteBind Linkage information is set at generation time remoteComType Tell EGL munications layer what protocol to use CICSECI or CICSSSL remotePgmType Specifies called program is EGL or nonEGL serverID Transaction Started in CICS (must define TWASIZE of 1024) IBM Software Group | Rational Software 169。 2020 IBM Corporation 22 What is required for Remote Calls – CICS ?  Client (IDE – Debug CICSECI) – Access to CTG client code 1. Must be added to lib directory of WEBINF – Use importFile System OR 2. Add to Debug Preference Classpath IBM Software Group | Rational Software 169。 2020 IBM Corporation 23 What is required for Remote Calls – CICS ?  Client (WAS) – CICS Resource Defined to WAS – uses – Referenced by JNDI Name (. eis/NRACICS3) • Connection information to host is in Connection Factory definition – More in referenced docs and lab IBM Software Group | Rational Software 169。 2020 IBM Corporation 24 What is required for Remote Calls – CICS ?  Getting CICS Transaction Gateway CLIENT Code – EGL V6 • CICS Transaction Gateway for Multiplatforms V6 or later – Purchase license (multiple ways to license) – If using WebSphere developer for z/Series, then is extra CD in media pack (Development License only) • Purchase CICS Transaction Gateway for z/OS V6 or later (MLC license) Use/Download (nonJ2EE) or (J2EE) • Install Optional RAD J2EE Connectors Feature through Rational Product Updater Use (contains if expanded) IBM Software Group | Rational Software 169。 2020 IBM Corporation 25 What is required for Remote Calls – CICS ?  Getting CICS Transaction Gateway GATEWAY/SERVER Code • CICS Transaction Gateway for Multiplatforms V6 or later – Purchase license (multiple ways to license) – If using WebSphere developer for z/Series, then is extra CD in media pack Licensed for Development purposes only • Purchase CICS。