1. ViaSQL Legacy Data Server

2. Viaserv, Inc. 2 ViaSQL Legacy Data Server n “Relational engine” for non- relational OS/390 data n Functions –interface with OS/390 data during virtual table definition –store virtual table metadata in DB2-like catalog –execute SQL statements against non-relational data –format results into relational sets OS/390 CICS Legacy Data Server DB2 VSAM IMS Seq. RSP Other ViaSQL Access Server

3. Viaserv, Inc. 3 LDS Architecture n Legacy Data Server runs in its own address space n Communicates with ViaSQL Access Server via –a cross-memory service (XMS) –running in a Viaserv Common Services (VCSERVER) address space –and a CICS-LDS connection n Requires IBM DFSORT r13 or equivalent –and temporary work space available as required

4. Viaserv, Inc. 4 ViaSQL Access Server Legacy Data Server CICS ViaSQL Access Server VCSERVERLDS XMS Service ldsname assigned at startup Default: VIASQL ldsname assigned at startup VIBSQL LDS XMS Endpoint CICS-LDS Connection CICS-LDS Connection XMS Endpoint CICS Resource Manager rm_name: LDSA myname: LCASERVR CICS Resource Manager rmname: LDSB myname:LCBSERVR

5. Viaserv, Inc. 5 Viaserv Common Services n VCSERVER runs as started task –must run from authorized loadlib –can run multiple instances (eg. 1 for test, another for production); each requires a unique job name in OS/390 n One-to-many relationship: –one VCSERVER can service multiple LDS regions –an LDS can be serviced by only one VCSERVER n Then, a CICS-LDS connection can be started

6. Viaserv, Inc. 6 XMS Session n Session types –master — passes control information between two programs only one master session per ViaSQL connection –task — services user request as required by concurrent users n Session states –reserved — XMS endpoints defined and assigned, but no formal connection request has been made –open — XMS connection has been formally requested and VCS has established it

7. Viaserv, Inc. 7 CICS-LDS Connection n Group of XMS endpoints and associated sessions –defines logical link between LDS region and CICS region where ViaSQL Access Server is running n Each connection started and stopped by dedicated CICS resource manager

8. Viaserv, Inc. 8 Summary n CICS-LDS connections manage sessions between Legacy Data Server and ViaSQL Access Server n Dedicated CICS resource managers are used to start and stop CICS-LDS connections –VCSERVER and LDS must already be running for CICS-LDS connection to start n Each CICS-LDS connection contains one master session and some number of task sessions n One-to-many relationship between CICS-LDS connections and sessions

9. Viaserv, Inc. 9 Requirements for LDS Usage n ViaSQL Access Server running –MDII transaction or automatic start –instructions in ViaSQL Access Server module n VCSERVER running n Legacy Data Server running n CICS-LDS connection started Recommended Start Order

10. Viaserv, Inc. 10 Starting VCSERVER n Runs as started task n PROC named VCSERVER created during installation n Issue OS/390 console command S VCSERVER,JOBNAME=vcsjobname

11. Viaserv, Inc. 11 Starting XMS Service n Automatic start as part of VCS startup n Manual start Fvcsjobname, START XMCOM xmsname xmsmembers Specifiies LDS region(s) to be accessed Specify by ldsname value Can use wildcards

12. Viaserv, Inc. 12 Starting Legacy Data Server n Runs as started task n Automatic start as part of VCSERVER startup n Manual start S LDS, JOBNAME=ldsjobname

13. Viaserv, Inc. 13 Starting CICS-LDS Connection n Automatic start with CICS region n Manual start from 3270 session n Manual start from Legacy Data Manager

14. Viaserv, Inc. 14 Manual Start from 3270 Session n Run LDSB transaction LDS1MP2 LDS INITIALIZATION MENU TERMID: A002 NETNAME: D20101 USERID: XXXX RESOURCE MANAGER NAME: rm_name DATE: 04/11/99 APPLICATION NAME FOR LDS: ldsname TIME: 10.38.23 APPLICATION NAME FOR CICS: applcicn # CONCURRENT TASKS FOR THIS CONNECTION: #reqtasks TIMEOUT VALUE(SECONDS): timeout ================================================================= RESULTS: ENTER=PROCESS PF1=HELP PF3=EXIT CICS Resource Manager Default: LDSA LDS Application Name Default: VIASQL CICS Endpoint of CICS-LDS Connection Default: LCASERVR Concurrent Tasks Requested Default: 8

15. Viaserv, Inc. 15 Testing n Display status of CICS-LDS connection –from 3270 session –from Legacy Data Manager n Test Legacy Data Server –instructions in administration manual n Test ViaSQL Access Server –access to DB2 –access to Legacy Data Server –instructions in ViaSQL Access Server module

16. Viaserv, Inc. 16 CICS-LDS Connection Status from 3270 Session n Run LDSD transaction n Choose Option A LDS1MP5 LDS DISPLAY RESOURCE MANAGER STATUS RM_NAME TARGET_LDS MYNAME MGR_ACT? START_DATE START_TIME #SESS #INUSE ________ __________ ________ ________ __________ __________ _____ ______ LDSA VIASQL LCASERVR YES 07/15/99 15.37.57 4 0 POSITION CURSOR AT RM_NAME TO MANIPULATE; HIT PF KEY MATCHING YOUR REQUEST ENTER=DISPLAY_RM PF3=EXIT PF5=STOP_RM PF6=START_RM

17. Viaserv, Inc. 17 Shutting It Down n Stop ViaSQL Access Server –MDIZ transaction n Stop Legacy Data Server n Stop CICS-LDS connection n Stop Viaserv Common Services (VCSERVER) if planning to IPL Recommended Stop Order

18. Viaserv, Inc. 18 Stopping the Legacy Data Server n OS/390 console command: MODIFY F ldsjobname, SHUTDOWN [FORCE]

19. Viaserv, Inc. 19 Stopping the CICS-LDS Connection n Manual stop from 3270 session –execute LDST transaction from 3270 session LDSD rm_name –execute LDSD transaction from 3270 session choose Option A stop appropriate resource manager n Manual stop from Legacy Data Manager Associated CICS Resource Manager Default: LDSA

20. Viaserv, Inc. 20 Stopping Viaserv Common Services n Don’t do this unless you’re sure –can use up address space IDs and require IPL to fix –OS/390 console command F vcsjobname, SHUTDOWN –Automatically stops all XMS services in region n To stop an XMS service individually: F vcsjobname, STOP XCOM xmsname