RPGMail. Easily send directly from RPG! Krengel Technology Inc. by Aaron Bartell. Copyright Aaron Bartell 2011

Transcription

1 RPGMail Easily send directly from RPG! Copyright Aaron Bartell 2011 by Aaron Bartell Krengel Technology Inc.

2 Joke Of The Day Found in employee handbook SURGERY: Operations are now banned. As long as you are an employee here, you need all your organs. You should not consider removing anything. We hired you intact. To have something removed constitutes a breach of employment.

3 Abstract Learn how to easily send from your iseries using open source software RPGMail. Make your boss happy and take this code home to gain immediate RPG Summit ROI. Not only will you have a free utility (RPGMail) to put on your iseries after leaving this session but you will also get a full understanding of how the guts work in conjunction with Sun's JavaMail API's to send directly to your mail server (i.e. Microsoft Exchange), completely by-passing the problematic iseries MSF (Mail Server Framework). Don't miss this one!

4 MowYourLawn.com Inception: Free and Open SourceTools RPGMail 3352 downloads since RPG Chart Engine 1248 downloads since RPG To Desktop 768 downloads since ( control System i SVN Client(source 342 downloads since

5 Addiction Dear Andy: How have you been? Your mother and I are fine. We miss you. Please sign off your computer and come downstairs for something to eat. Love, Dad.

6 RPGMail What,Why,How? What: A set of RPG sub procedures (say service program) that utilize the JavaMail API's from Sun to send s with ease from your iseries RPG program without limitations on the amount of addresses or attachments. Why: IBM s MSF (Mail Server Framework) is/was problematic in that it just stopped working with a whole bunch of s queued and waiting to be sent out. One approach to fixing this problem was to clear/restart the MSF. How: I took my first Java class at the local technical college and developed RPGMail shortly after. After learning how to use Eclipse and reading different tutorials on JavaMail, I waded my way through the creation of a Java wrapper to JavaMail to simplify the use at that level. I then added an RPG wrapper to make it easy to use for other RPG developers in my shop.

7 Requirements OS/400 V5R1 ( info RPG Compiler (to recompile example programs with your 5722JV1 *COMPATIBLE Java Developer Kit 1.4 You need to have access to your own SMTP server (i.e. Microsoft Exchange). At least a small sense of adventure! You are, after all, using Java!

8 Installation 1. Unzip the downloaded file to c:\temp (or the directory of your choice). 2. Issue the AS/400 command: ( AUT(*ALL CRTSAVF FILE(QGPL/RPGMAIL) 3. FTP the file RPGMAIL.SAVF from your PC to the AS/400 in BINARY mode into the save file RPGMAIL in library QGPL. 4. Issue the AS/400 commands. ( LIB(RPGMAIL CRTLIB ( SAVF(QGPL/RPGMAIL RSTOBJ OBJ(*ALL) SAVLIB(RPGMAIL) DEV(*SAVF) CPYTOIMPF FROMFILE(RPGMAIL/QSOURCE MYTEXTFILE) TOSTMF('/home/mytextfile.txt') ( MBROPT(*REPLACE ( DTAFMT(*FIXED STMFCODPAG(*PCASCII) RCDDLM(*CRLF) ADDLIBLE RPGMAIL 5. Copy the *.jar files included with the download to IFS folder /java/. Use a Windows drive mapping, FTP, or WDSC RSE to do this. 6. Change source members T1_RPGMAIL and T2_RPGMAIL in RPGMAIL/QSOURCE to have valid addresses and SMTP host/port, and then recompile and run.

9 Uses For RPGMail 1. Send notification s upon receiving an order. 2. Notify customer of order getting shipped and include carrier and tracking number. 3. Send s to programming staff if critical processes don t complete. 4. Send out s to existing customers about discounts and specials you may be having (i.e. mass ing). Be careful with this because of spam laws and getting your IP address on black lists. 5. reports that have been created on the iseries.

10 Sending Basic H spec thread(*serialize) is necessary in Java situations.

11 Attachments and File as Body

12 RPG Guts Prime the Java environment. Note that this only needs to be called once per job. Calling it again will simply have no affect. What is a CLASSPATH you ask? Very similar to a library list.

13 RPG Guts contd Create/Instantiate the RPGMail.class Java object for later use in our RPG code.

14 RPG Guts contd This shows how most of the remaining API s work. They receive in the RPGMail.class object instance, along with other parameters, and turn around to call the corresponding Java prototype.

15 RPG Guts contd RPGMail_send is the only API that receives information back from the Java class. A Java object of type java.lang.string is returned from RPGMail.class. If the process was successful the String will be empty, otherwise it will be occupied with an error (most likely occupied with what s called a stack trace). This was put in place because when errors occur in Java they aren t recorded in an extended fashion within the OS/400 job log.

16 Java Guts Example Java program that shows how to make use of the RPGMail.class object. The JavaMail API by itself wasn t able to be quickly implemented in other Java programs so an additional Java wrapper (RPGMail.java) was added to wrap up the ugliness. Look similar to the RPG example?

17 Java Guts contd Here are three Java methods from RPGMail.java, showing what the Java wrapper looks like.

18 Java Jump-start for RPG'ers I wrote an article for IBMSystemsMag.com that guides you through the general concepts of modifying RPGMail as if you were a complete noob to the process. You can see the article by going to In the search box on site you can enter my name and you should find the article. The article is titled Roll The Tape A Java Jump-start video tutorial for RPG'ers. Or you can view the digital version of the magazine by going to the following URL:

19 Future Enhancements address validation. Check to see if attachments exists on RPG end before attempting to send. High Priority s. Encryption?? Authenticate to remote SMTP server Modify infrastructure to have RPG layer talk to data queues with Java on the other side. Make process a lot faster and wouldn t have ANY Java in the RPG source code. Anybody want to help?!

20 Troubleshooting Problem Message.... : Java exception received when calling Java method. Cause..... : RPG procedure RPGMAIL_SE in program RPGMAIL/ RPGMAILSV received Java exception "java.lang.nosuchmethoderror: append (Ljava/lang/StringBuffer;)Ljava/lang/StringBuffer;" when calling method "send" with signature "()V" in class "com.mowyourlawn.rpgmail.rpgmail". Solution This means that a previous JDK is being chosen to run the code (most likely JDK 1.3) and you need to tell the iseries that you instead want to use JDK1.4. To do this you need to create the following file in the IFS: /QIBM/ UserData/Java400/SystemDefault.properties Once it has been created, open it and place the following line of text in it: java.version=1.4 Save the file and exit. Sign off and back on again. Re-run your RPGMail program.

21 Troubleshooting contd Are other Java applications installed on your iseries? May be that their.jar files are loaded into the shared Java directory: /qibm/ userdata/java400/ext and causing conflicts with your.jar files. Make sure the mail/smtp server allows relaying from your iseries IP address. You can only start one JVM per OS/400 job and once started you cannot modify the CLASSPATH (among other startup variables). This could pose a problem if you have other Java processes that run BEFORE RPGMail and then RPGMail will be unable to add the necessary.jar files to the CLASSPATH. Make sure all your DNS stuff is setup correctly on both the iseries and network devices. Don t use IFS QDLS for attachments or bodies.

22 Other Open Source Java Utilities Try one of these guys out for yourself to see what you can do! (Graphical charts) (Excel Spreadsheets) (PDF creation) (Reports) (check out for a ( project start to this ( Reporting )

23 Other Open Source Sites

24 We have reached the end! Aaron Bartell ( ) lead developer of RPG-XML Suite and owner of and check out his latest effort at