1. Domino, DB2 and ... The other (IBM AS/400) That is: how to mix data from Domino and AS/400 in real-time using NSFDB2Speakers: Cristian DAloisio Vincenzo Capponcelli Domino Administrator & Developers Ciemme Service s.r.l.

2. AGENDA

Intro to NSFDB2

How to enable NSFDB2 feature on Lotus Domino for Windows

EnablingHomogeneous Federationon DB2 server to seamlessly access data on AS/400 and mix them with Notes data

Examples:some Notes/Domino applications showing how using NSFDB2 and FEDERATION with AS/400

3. What is NSFDB2?

On a Domino 8 server, ability to use a DB2server as analternative data store

Its a server-side technology

On a nsfdb2-enabled Domino server,not allNotes application must (or can) be saved on the DB2 data store

End-user connected to a Domino server are not aware that a Domino application is nsfdb2-enabled

Access: both Notes clients and web browsers can access a nsfdb2-enabled application

4. SCHEMA 5. What advantages? Integrations: Notes applications can access DB2 data without any batch transfer (LEI, etc.). Joining data: joining Domino data (even on several databases) and relational DB2 data Security: Domino ACL security is preserved both when data are accessed by a traditional Notes client or any other program (written in C/C++/Java etc) that access the same data saved on the DB2 serverPerformance: view index updating is done by the DB2 server, not by Domino Reports: accessing data from third-party reporting applications, mixing Notes and DB2 data (see IBM technote 7010956) 6. DOMINO DATABASES NOT CONVERTED

IMAP4 mailboxes

Shared Mail (SCOS)

Some Domino system db: e.g. names.nsf, log.nsf

7. NEW DESIGN ELEMENTS!1/2

• Domino Access View (DAV):

• • Allows developers toexpose Domino datain a relational format, via a DB2 view. Thats because using DB2 as a data storedoes notmean developers can directly access data via SQL: its like a blackbox!

• • Notes developers chooseswhich Notes data , actually saved on theDB2 data storage, will be available to both Notes clients and DB2 programs (C++, Java, etc)

• • Its important tomap DB2 users and Notes usersthat will access DAV data (ACL is preserved) !

8. NEW DESIGN ELEMENTS!2/2

QUERY VIEW (QV)

• its like a Notes view that shows data retrieved by a query SQL statement!

• QV has no index, data is refreshed at each view access/refresh

• QV can show data retrieved doing JOINs between Domino data (exposed as Domino Access View) and other DB2 data

• SQL statements can be dynamic, that is you can ask Notes user for parameters and build a statement that will run and populate the QV

• QV can be accessed by Notes clients and web browsers

9. NSFDB2 CONFIGURATIONS Local Configuration: Domino server and DB2 server are installed on the same physical server Remote Configuration: Domino server and DB2 server are installed on two different physical servers 10. SUPPORTED DB2 RELEASES(8.0.2 release notes)

DB2 EnterpriseServer Ed 9.1 FP2- MicrosoftWindows32-bit

DB2 EnterpriseServer Ed 9.1 interim special build 2a-IBM AIXandLinux(SLES10 & RHEL5) 64-bit

DB2 WorkgroupServer Ed 9.1 FP2 - MicrosoftWindows32 bit

DB2 WorkgroupServer Ed 9.1 interim special build 2a-IBM AIX and Linux(SLES10 & RHEL5) 64-bit

11. Linux, AIX, Windows... What about AS/400 !?

NSFDB2IS NOTavailable for Domino 8 on AS/400 (i Series,...) !

Workaround !EnableHomogeneous Federationon the DB2 server! You can configure DB2 server to seamlessly link some remote tables (aka files on AS/400) and use them as local tables, mixing them with Notes data

Licensing:using a DB2 server for NSFDB2 ONLY is free, using theFEDERATION feature on the same DB2 server IS NOT FREE (to date).

12. WED LIKE BRINGING AS/400 TO THIS EVENT....... BUT SOME COLLEAGUES DID NOT AGREE WITH US! WELL USE A VPN CONNECTION ;-) 13. WHAT WE USED IN OUR LOCAL NSFDB2 CONFIGURATION (WINDOWS)

Lotus Domino 8.0.2 Enterprise

DB2 Access for Lotus Domino 8.0.2

IBM DB2 9.1 fix pack 2

14. STEP 1: DOMINO INSTALLATION

Lotus Domino 8.0.2 Enterprise installation

EnablingDomino Transaction Log

15. STEP2: DB2 SERVER INSTALLATION

Local configuration : installing DB2 server on the same server where we installed Domino server (Windows OS)

creating a Windows account ( DB2ADMIN)and a group ( DB2DOM)

DB2 server 9.1 installation using Window userDB2ADMIN

setting a DB2 environment variable,SYSCTRL_GROUP ,to include the Windows groupDB2DOM

16. TIP (Windows OS) Be sure to setup Domino server as DEPENDENT from DB2 server: Domino server service can be run ONLY after DB2 server service is already running (need some Windows registry tweaking) 17. DB2 SERVER:slideshow 18. STEP3: DB2 ACCESS for Domino installation

First, create a special Domino serverID file that will be used by the DB2 Access for Domino (use Domino Administrator client)

Start the DB2 Access for Domino installation on the server that host your DB2 server (actually the same server where we also installed Domino)

Enable Domino server to DB2

Restart Domino server

TestDB2 Access for Domino , using Domino Administrator client

19. DB2 Access for Domino:slideshow 20. Some settings from Domino Administrator client

Map each Domino user to a DB2 user: eg. Domino Administrator with DB2ADMIN

Inside the Domino server document (names.nsf) youll find a new tab named DB2:

• Set adefault userthat it will be used for Query View

• Setup amax number of recordsthat will be returned by a Query View (default is 500, 0 means all)

21. ENABLINGHOMOGENEOUS FEDERATION ON DB2

On the DB2 server, allows you to define one or more tables that are actually definedon a remoteAS/400system

Since youre using a DB2 server for Domino NSFDB2 feature,you can federate remote AS/400 tables and seamlessly use them in any Query View

22. FEDERATION:slideshow 23. FAQ 1

How to enable a Notes application to NSFDB2 data storage? Run the following Domino console command: load compact-pmydbname.nsf

24. FAQ 2

Is it possible possible to programmatically change the Query Viewselection query? Use theundocumentedNotesView propertyselectionQuery : e.g.view.SelectionQuery= | SELECT * FROM schema.tabella |

Call view.Refresh

25. FAQ 3

How to read QV data using LS agents (or Java agents)? Use theNotesViewEntrycollectionclass to browse all data showed by the QV:

26. DEMO 1

thats an example about querying AS/400 in real-time using SQL

company data are retrieved onAS/400

orders are collected on a nsfdb2-enabled Notes application and exposed via a Domino Access View

items cost are also retrieved querying a AS/400 system

27. DEMO 2

Notes application to manage returned imperfect items

items data are retrieved from AS/400

data aremixed using Query View : real-time data JOINing between AS/400 data and Notes data

28. RESOURCES

Administratore Designer guides ;-)

IBM technotes: http://www-01.ibm.com/support/docview.wss?rs=1041&uid=swg27010956

IBM Domino blog:http://www.dominoblog.com

Domino Baloney blog:http://www.dominobaloney.com/

Vistalli blog:http:// www.vistalli.it /

Zoo Lotus blog: http://www.zoolotus.org/

29. TOOLS

Notepad++ http://notepad-plus.sourceforge.net/it/site.htm Useful text editor (with several plug-ins) to unwrap multi-line SQL statements and reformat them to a maximum row length, compatible with @formula inside QV selection query.

SQLinForm http://www.sqlinform.com/ Useful tool to reformat SQL statements for Query Views: transforming one-line SQL statements to more friendly multi-line SQL statements

30. HOW TO KEEP IN TOUCH WITH US? Cristian D'Aloisio [email_address] Vincenzo Capponcelli [email_address] 31. I Nostri Sponsor