Download InterExcel User Guide
Transcript
InterForm A/S Hyldalvej 11 DK-9541 Suldrup Denmark tel: +45 98 37 80 17 fax: +45 98 37 87 99 e-mail: [email protected] [email protected] web: 2 www.interform400.com User’s Manual for InterExcel400 Docum ent XEL-001-010 Users Manual for InterExcel400 V011.M044 Printed in Denm ark 2012 No part of this guide m ay be photocopied or reproduced in any way, except where noted, without the written consent of Interform A/S. All the nam es in this m anual are fictional and any resem blance to existing people or firm s is purely coincidental. © Copyright Interform A/S 2009. All rights reserved. AS/400 is a registered tradem ark of the IBM Corporation. HP-PCL is a tradem ark of Hewlett Packard All other tradem arks m entioned in this docum ent are registered tradem arks of their respective owners. InterForm A/S 3 Table of Contents Table of Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 How to upgrade/install InterExcel400. . . . . . . . . . . . . . . . . . . . . . . . . . . . Upgrading InterExcel400. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing InterExcel400. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. Restore InterExcel400 library by use of RSTLIBPC. . . . . 2. Alternative: Restore the InterExcel400 library with FTP. . Restore of the InterXEL directory. . . . . . . . . . . . . . . . . . . . . Installation on PCs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 5 5 6 6 7 Configuring InterExcel400. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Sharing the InterXEL directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Initial testing/running the first time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 W atch the m ovie. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 InterExcel400 introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Setting up conversion of a spooled file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 1. W ork with fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2. W ork with Cell styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3. W ork with Conversion definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Conditioned lines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Define the Layout of cells. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 The INTERXEL/W RKOUTQXEL Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 The INTERXEL/W RKSPLFXEL Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 The Com mand SPL2XEL (Spooled file to Excel).. . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Running InterExcel400 w ith InterForm400. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Tips and tricks for Excel and InterExcel400. . . . . . Activating the ‘Text im port wizard’ in Excel. . . Converting text into num eric fields in excel. . . Displaying large texts across cells. . . . . . . . . Using charts with the spooled file data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 39 39 40 40 License code information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Appendix A: The W eb Interface. . . . . . . . . . . . . . . . . . . . . . Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure the web server. . . . . . . . . . . . . . . . . . . . . . Using tokens to elim inate a sign on request. Starting and stopping the web server. . . . . . . . . . . . . Using the web interface. . . . . . . . . . . . . . . . . . . . . . . . Changing the security settings in MS Explorer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 42 42 43 44 45 46 Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 4 User’s Manual for InterExcel400 How to upgrade/install InterExcel400 Upgrading InterExcel400 If you already have installed InterExcel400 and want to upgrade to a newer version, then you will first need to go through the steps below: If you are running InterExcel400 version 001144 or newer you will first need to end the web server and end journaling. This is done by entering InterExcel400 with the com m and INTERXEL/INTERXEL, select ‘80. Adm inistration’ followed by ‘17. Prepare for upgrade/renam e of library’ and select: ‘1: Prepare for upgrade - do the above.’ Next you should renam e the existing INTERXEL library to e.g. INTERXELOL, do a norm al installation (as described below) and after the installation you enter the new INTERXEL library with the com m and INTERXEL/INTERXEL and select option ‘80. Adm inistration’ followed by ‘14. Upgrade InterExcel400 (Copy resources from old)’. Now confirm the copy and state the nam e of the old library e.g. INTERXELOL. Installing InterExcel400 InterExcel400 is delivered as a zipped save file. Use e.g. W inzip to extract the Interxel.savf file from the interxel.zip file. Here are 2 ways to restore the INTERXEL library, that is inside the save file onto your System i: 1. Restore InterExcel400 library by use of RSTLIBPC You can restore the INTERXEL library via the PC tool, that is included in the distribution. This requires that Java Runtim e Environm ent is installed on the PC. That is required in order to be able to convert spooled files to form atted excel files interactively anyway. If this is m issing you can download the latest version from here: http://java.com /en/download/m anual.jsp Just unzip all the files in the distributed zip file into the sam e directory and then do this: 1) Double click on the RSTLIBPC.bat file. This will start a DOS window and shortly after this: InterForm A/S 5 2) State the identification (probably IP-address) of your System i, your user id and your password for the System i, click on ‘Open Save File on PC’ and select the INTERXEL.SAVF file. 3) If you want to restore the INTERXEL library into INTERXEL (and you probably will) you can keep the field ‘Restore to Library’ blank - if not state the library you want to restore to. 4) Finally click ‘Restore on System i‘ to start restoring the INTERXEL library. Now continue by restoring the interXEL directory as described below. 2. Alternative: Restore the InterExcel400 library with FTP Use this description to restore the INTERXEL library if the description above cannot be used. For restoring the InterExcel library with FTP you first place the interxel.savf file not too far from the root of a drive on your PC then do this: (The order of the actual ftp commands is important..) 1. Open a DOS session on your PC 2. Type ftp followed by the ip address of your as400, type your user profile and password when prom pted. 3. Type lcd c:\tem p (or wherever you have placed the interxel.savf file. 4. Type cd qgpl to tem porarily place the save file in the qgpl library. 5. Type bin to change to binary transfer. 6. Type quote site nam efm t 1. (Response should be: ‘Now using nam ing form at “1"’). 7. Transfer the file with put interxel.savf 8. Type quit to exit the ftp session. If this transfer should create a PF file on the host instead of a SAVF you should create the save file on the host before retrying the transfer. You create the save file with this com m and: CRTSAVF FILE(QGPL/INTERXEL) W hen the transfer is done you restore the interxel library with the com m and: RSTLIB SAVLIB(INTERXEL) DEV(*SAVF) SAVF(QGPL/INTERXEL) After that you can delete the tem porary save file: DLTF QGPL/INTERXEL Now continue by restoring the interXEL directory as described below. Restore of the InterXEL directory Inside the interxel library you can find a save file nam ed XELIFS. This contains a saved interxel directory and subdirectories. Restore the interxel directory with this com m and: RST DEV('/qsys.lib/interxel.lib/xelifs.file') OBJ(('/interxel')) 6 User’s Manual for InterExcel400 That com pletes the installation of InterExcel400. Now proceed with ‘Configuring InterExcel400' below. Installation on PCs To use the full potential of InterExcel400 you need to setup the PCs that are going to interactively select a spooled file and view it as an excel spreadsheet. A way to do this is to run the com m and INTERXEL/INTERXEL and select option ‘30. Install PC tools’. This will list the things to do (listed below). 1), 2) and 3) only need to be done once for the whole m achine. 1. Make sure that there is an INTERXEL directory on the iSeries. If there is none you can restore it with: RST DEV(/qsys.lib/interxel.lib/xelifs.file) OBJ((/interxel)) 2. Make sure that you have typed in the IP-address (or nam e) of the iSeries in option: 12. Configuration of InterExcel400 on the InterExcel400 m ain m enu. 3. Add a share on the iSeries of /INTERXEL with the nam e of INTERXEL. If you are running InterForm 400 you can do that with the com m and: APF3812/ADDFILSHR SHARE(INTERXEL) OBJ(/interxel) TEXT(INTERXEL) 4. Map a Network drive on the PC in question to INTERXEL using the nam e of the iSeries stated in 12.Configuration of InterExcel400. You do that in the MS Explorer on the PC. 5. Install Java Runtim e Environm ent (JRE) on the PC. Download from : (http://java.sun.com /javase/downloads/index.jsp) 6. Copy the INTERXEL directory from the iSeries onto the C-drive. This can be done via the INTERXEL/INTERXEL com m and and option ‘30. Install PC tools’. W hen you press ENTER it will copy the INTERXEL directory onto the PC. It will start a DOS session and it should look like this for a successful execution: \\192.168.151.3\interxel\system\LICENSE \\192.168.151.3\interxel\system\PCinstall.bat \\192.168.151.3\interxel\system\QSHELL_output \\192.168.151.3\interxel\system\dummy.txt \\192.168.151.3\interxel\system\iXEL001V106.jar \\192.168.151.3\interxel\system\ixel.bat \\192.168.151.3\interxel\system\ixel1001106.bat \\192.168.151.3\interxel\system\ixel2.bat \\192.168.151.3\interxel\system\ixel3.bat \\192.168.151.3\interxel\system\poi.jar \\192.168.151.3\interxel\system\poi3.jar \\192.168.151.3\interxel\system\xelSTY.TXT \\192.168.151.3\interxel\system\xelfnt.TXT \\192.168.151.3\interxel\system\ixel1001106DB.bat \\192.168.151.3\interxel\system\ixel1001107.bat \\192.168.151.3\interxel\system\ixel3001.bat \\192.168.151.3\interxel\system\ixel2001.bat \\192.168.151.3\interxel\system\ixel1001107DB.bat 18 file(s) copied. Press any key to return If the files are not copied you should go through the list above again. Refer to page 11 for inform ation of how to setup a share and m apping a network drive. You also need to have Java Runtim e Environm ent Version 1.3 or later installed. If you InterForm A/S 7 already are able to run the InterForm 400 graphical designer on the sam e PC you have it installed. You can download it for free from this site: http://java.sun.com /javase/downloads/index.jsp (Scroll down to find link to download only Java Runtim e Environm ent.) 8 User’s Manual for InterExcel400 Configuring InterExcel400 To configure InterExcel400 you execute this com m and: INTERXEL/INTERXEL. The first tim e you enter this com m and you m ay see the screen below: Create WEBINTER user profile In order to use the InterExcel400 web server a special user profile is needed. The user profile WEBINTER must exist in order to run the web server. It is found, that this user profile does not exist, so it will now be created. Press ENTER to create the user profile now. (The user profile is created with a random password) F3=Exit ENTER=Create the WEBINTER user profile F12=Cancel The user profile W EBINTER is needed for running the web server. Press Enter to let InterExcel400 create it or press F3/F12 to ignore this. Please notice that a random (not blank) password is needed. If the W EBINTER user exists, then this screen is not shown. You will then see the InterExcel400 Main Menu: www.InterExcel400.com Main Menu Version: 001133 Select an option: 1. 2. 3. 4. 5. 6. 7. Work with fonts Work with Cell styles Work with Conversion definitions Work with spooled files Work with an output queue Open a spooled file in Excel Install PC tools (WRKSPLFXEL) (WRKOUTQXEL) (SPL2XEL) 9. Output queue to use 80. Administration 90. Sign off Selection: F3=Exit Copyright of InterForm A/S 2008 F12=Cancel www.interform400.com InterForm A/S 9 (You do not need to add the INTERXEL library to your library list.) Adding the INTERXEL library to the system library list is not recom m ended as this m ay cause problem s with future upgrades. If the license code have run out or is invalid you will get a warning when entering the com m and. Now enter option ‘80. Administration’ followed by ‘12.Configuration of InterExcel400': InterExcel400 Configuration Merge overprint lines in spooled files..........: Y Create directories for output files if necessary: Y (N=Stop with error message) IP-address of AS400 (or Netserver name).........: 192.168.151.3 Run Host Java program under QSHELL.(Y/N)........: Y Default PC-drive to use on clients..............: C Debug (Keep temporary files in the IFS).........: N (Y/N) F3=Exit F12=Cancel Change the options to fit your installation: M erge overprint lines in spooled files This option is default activated and should be left like this, if you are in doubt if there are any spooled files (to be handled by InterExcel400), that are using overprinting (e.g. for printing in bold). InterExcel400 will not handle spooled files using overprinting correctly if this is disabled. Create directories for output files if necessary W hen you setup InterExcel400 to create Excel spreadsheets in the IFS (e.g. by using variables in the path) you would perhaps want InterExcel any directory need to fit the path specified. If you want to restrict InterExcel400 from creating directories state ‘N’ IP-address of AS400 (or Netserver name) InterExcel400 can startup a PC application to view a m arked spooled file as e.g. an Excel spreadsheet from the INTERXEL/W RKOUTQXEL com m and. In order to do so you need here to type the identification of the iSeries as seen from the PC. The IP-address can be used in m ost cases. Do not type any delim iters around the IP-address. Run Host Java program under QSHELL If you convert spooled files to excel via the com m and interxel/spl2xel (e.g. in batch), then InterExcel400 will norm ally run the java program under QSHELL. If this is a problem you can change the default ‘Y’ into ‘N’. Default PC-drive to use on clients Default InterExcel400 will use the C-drive on the local PCs. If you want to use a different drive for all users you can insert it here. Alternatively you can state it per user on the user setup. 10 User’s Manual for InterExcel400 Debug (Keep temporary files in the IFS) If InterExcel400 does not react as you expect it can be an idea to tem porarily change this into ‘Y’ (you m ay be asked to do so from your local support). This will leave any tem porary files in the IFS and QTEMP and run a special bat file for conversion so you can view the process of the used bat file. Rem em ber to change this to ‘N’ when done to avoid excessive disk usage. Please refer to Appendix A on page 42 for details of setting up the integrated web server. Sharing the InterXEL directory In order to m ake it possible to convert and view spooled files directly from the W RKOUTQXEL com m and you need to share the interxel directly as the tem porary files for that is placed in /interxel/tem p. If you are running InterForm 400 you can share the interxel directory with this com m and: APF3812/ADDFILSHR SHARE(INTERXEL) OBJ('/interxel') TEXT('Interxel directory') Alternatively you can share it via iSeries Navigator like this: (Left click on the m achine, Netw ork, TCP/IP. Then double click on iSeries Netserver and right click on Shared object and select New, ‘File’.) Use interxel as Share nam e and /interxel as Path nam e. After you have m ade a share it is a VERY good idea to m ap a network drive (In MS Explorer) to this share to m ake sure, that you have access: InterForm A/S 11 (Select Tools and M ap Netw ork drive to do that.) 12 User’s Manual for InterExcel400 Initial testing/running the first time After a first tim e installation you m ight want to test, that InterExcel400 is running OK and you have setup it up correctly. To help you to do that InterExcel400 is delivered with a dem o spooled file and a dem o setup, that fits with the spooled file. Go to the InterExcel400 Main Menu with the com m and interxel/interxel and select 80. Administration and then 13. Restore InterExcel400 demo spooled file. Select an output queue where to place the spooled file and press Enter: You can now view the restored spooled file. Try the com m and INTERXEL/W RKOUTQXEL and use the output queue as argum ent - or use option 5. W ork with an output queue on the InterExcel400 Main Menu: The spooled file is nam ed DEM O with the user data InterExcel. Now first try option 10, 12 and 13 for this spooled file. These options will convert the *SCS spooled file into a PC file and start up an application to show you the result. If this works you have a confirm ation, that InterExcel400 can com m unicate with your PC. You can try options 10, 12 and 13 for any *SCS spooled file. Next try option 11=Form at as xls for the DEMO spooled file only. This will look into a dem o setup (shipped with InterExcel400) to determ ine how to form at the spooled file when converting it into an Excel spreadsheet and then open the converted spreadsheet. This takes longer the first tim e as there are some initial files to be converted. If you work a lot in the green screen InterExcel400 Menu you can set your preferred output queue via option ‘9. Output queue to use’. Here you state your personal output queue and this will from now on be suggested when you select option 4 and 5 on the InterExcel400 Main Menu. InterForm A/S 13 The final Excel spreadsheet should look like this: As you can see, you can add graphics to your output, but you can also add form ulas and charts via a predefined tem plate.. (Form ulas will be updated via <Ctrl> + F9.) Alternatively you can also form at spooled files into excel files via a browser session by clicking ‘Form at as xls’ below: (Refer to appendix A on page 42 for inform ation of the included web server). Now InterExcel400 is ready to form at your own spooled files... 14 User’s Manual for InterExcel400 Watch the movie You have now read the book (or a part of it) so how about watching a m ovie about it? If you like to get a bit of inspiration you can watch a sm all video via this link: http://download.interform 400.com /shares/Newsletter/InterExcel400/InterExcel400.swf InterForm A/S 15 InterExcel400 introduction InterExcel400 was m ade to m ake a fast and easy form atting of reports that som e use a lot of tim e to m anually form at. For the end users the new additions are sim ply these 2 new functions: 1) A com m and, INTERXEL/SPL2XEL (spooled file to Excel) that will convert and form at an *SCS spooled file into a spreadsheet in the IFS. This could e.g. be subm itted to batch or e.g. called from an InterForm 400 AFC user program . The resulting Excel spreadsheet can either be directly opened on a connected PC for interactive jobs or be placed (e.g. in batch) directly in the IFS with the use of any PC. 2) A com m and INTERXEL/W RKOUTQXEL (work with output queue - InterExcel version) that looks and works alm ost as the OS400 W RKOUTQ, but with a few extra options to convert a spooled file. As an extra help any user can (in the green screen interface) set the preferred output queue with calling these com m ands from the InterExcel400 Main Menu via option Conversion of spooled files can also be done via the included web server. Refer to Appendix A on page 42 for details. The spooled files can be converted in these ways: a) The full conversion where you setup rules - setting up spooled files, lines and positions and how they should be presented in the final Excel file output. This is the real core of InterExcel400. This is done either via the SPL2XEL com m and or via option 11 in W RKOUTQXEL. The resulting excel file can be placed in the IFS using a path that could include inform ation from the spooled file and/or spooled file attributes. b) The W RKOUTQXEL com m and also offers the options to convert a sim ple *SCS spooled file into a .xls (for opening in Excel), .txt or .rtf docum ent and open the file on the PC application, that is associated with the extension. These conversions are at the m om ent only offered on this com m and - interactively. W hen form atting a spooled file you can e.g. run the SPL2XEL com m and that retrieves m any spooled file attributes and decides for what conversion definition to use. This will determ ine the layout and nam e of the resulting excel spreadsheet. For the adm inistrators of InterExcel400 another com m and is InterXEL/InterXEL. This gets you to the m ain m enu of InterExcel400. In the following chapter we will go through the InterXEL m enu in details. 16 User’s Manual for InterExcel400 Setting up conversion of a spooled file In order to illustrate the steps of setting up InterExcel to convert a specific spooled file into an Excel spreadsheet we are going to refer to the InterExcel400 dem o spooled file. To print out a copy of this spooled file you type INTERXEL/INTERXEL on a com m and line and select option ‘20. Restore InterExcel400 demo spooled file’. Here you type in the output queue on to which you want to restore the spooled file. It is a good idea to select an output queue, where it is not im m ediately printed out so you can view it during the setup.. Below we will refer to the conversion of the InterExcel400 dem o spooled file looking like this: Display Spooled File File . . . . . : DEMO Page/Line 1/2 Control . . . . . Columns 1 - 78 Find . . . . . . *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+... Sales Report - Rubber Band Inc. Department: Remote Monitoring User: Smith Date: 16.10.2006 Period: 4th Quarter Time: 14:20:55 ============================================================================== Sales Rep. Art Description Quantify Unit Price Discount ============================================================================== KSE 4100003 1x1/32 inch yellow rubber band 2 234,00 20% PDC 2100006 1x1/16 inch red rubber band 3 1.235,00 0% BJE 100006 1x1/16 inch black rubber band 2 1.565,00 0% BJE 1200003 2x1/32 inch braun rubber band 4 2.564,00 0% BJE 5300012 3x1/8 inch green rubber band 4 13,00 0% PDC 6300006 3x1/16 inch blue rubber band 3 24.365,00 0% PDC 7100050 1x1/2 inch violet rubber band 2 654,00 0% SEM 8400050 4x1/2 inch grey rubber band 4 3.456,00 0% SEM 9400050 4x1/2 inch white rubber band 2 5.646,00 0% More... F3=Exit F12=Cancel F19=Left F20=Right F24=More keys Into this spreadsheet: InterForm A/S 17 The setup contains of these 3 options: 1. W ork with fonts 2. W ork with Cell styles 3. W ork with Conversion definitions These are described below using this spooled file as an exam ple. 18 User’s Manual for InterExcel400 1. Work with fonts Here you m ake sure, that you have the fonts you need for the spooled file. After a new install you will already find a few font to help you get started: Work with fonts FNTUPD1 Position to . . . . . . Font number Type options, press Enter. 2=Change 3=Copy 4=Delete 5=Display Opt _ _ _ _ _ _ _ _ _ _ _ _ Font Nbr. 1 2 3 4 5 6 7 8 9 11 12 13 Font Name Arial Arial Arial Arial Arial Arial Arial Arial Arial Arial Bold Arial Bold Arial Bold Font Size 8 10 11 12 14 16 20 24 30 8 10 11 B N N N N N N N N N Y Y Y I N N N N N N N N N N N N U N N N N N N N N N N N N More... F1=Help F3=Exit F5=Refresh F6=Create F12=Cancel This list is lim ited to 99 different fonts. You can delete and change the predefined fonts as you please - just rem em ber that this m ight change the dem o exam ple in this m anual. To add a new font just press F6 and type the nam e as it is displayed in your PC applications. InterExcel400 does not need to know the font nam e, so you can even use special corporate font as long at it is placed on the PC that open the file.. The abbreviations B, I and U are short for Bold, Italic and Underline. The size of the font is m easured as on your standard PC applications. In the web interface you view/edit the font list by opening the font tree on the left and then you can click on the font to change either on the left or right: InterForm A/S 19 W hen you are sure, that you have the fonts you need you can proceed to work with the cell styles. See below. 20 User’s Manual for InterExcel400 2. Work with Cell styles Select this option to define various way to form at the spreadsheet cells: Work with cell styles STYUPD1 Position to . . . . . . Style number Type options, press Enter. 2=Change 3=Copy 4=Delete 5=Display Opt _ _ _ _ _ _ _ _ Style Nbr. 1 2 3 4 5 6 7 8 Description Top Header with underline Second Header Small headings Bold Small heading Small heading with T/B Border Detail left adj. Detail right adjust Total Right adj. T/B Borders size size size size size size size size 16 14 10 10 10 10 10 10 Font Nbr. 16 14 12 2 12 2 2 12 End F1=Help F3=Exit F5=Refresh F6=Create F11=View 2 F12=Cancel Up to 99 cell styles can be defined. A cell style looks like this: Change cell style Style number . . . . . . : Description . . . . . . . Font number . . . . . . . Border Thickness Top . . . Border Thickness Left . . Border Thickness Right . . Border Thickness Bottom . Horizontal align. (L C R . Vertical align. (T B C J). F1=Help F3=Exit STYUPD2 1 Top Header with underline size 16 16 (F4) 0 (0=No border, 1=Thin, 2=Thick) 0 0 2 L C F4=Prompt F12=Cancel It has a num ber that you can refer to later and a description to help you to rem em ber what it is for. The font num ber points out the font to use for this style. The border thickness can be 0, 1 or 2 which denotes the width of a border: 0=No border 1=Thin border 2=Thich border If you use a higher num ber the border will be dotted in a special m anner. The horizontal alignm ent can be: L=Left aligned C=Centered R=Right aligned InterForm A/S 21 The vertical alignm ent can be: T=Top aligned C=Centered B=Bottom aligned J=Justified (Refer to the Excel Help for a description of that.) W hen you have defined the necessary fonts and cell styles you can go on to define the spooled files to be converted in the next option on the InterXEL Main Menu. Below you see the web interface. If you want to work with the styles you sim ply open the ‘Styles’ tree on the left. Click either left or right on an existing style to change one or click the ‘Create’ icon on the top to create a new style: 22 User’s Manual for InterExcel400 3. Work with Conversion definitions Conversion definitions is the setup, that determ ines how a specific spooled file should be form atted into an excel spreadsheet if you activate this conversion. The conversion definition consists of 3 layers: InterExcel400 Spooled file Excel spreadsheet 1. Conversion definition Spooled file type/ID File nam e 2. Conditioned lines Spooled file line Rows 3. Layout Spooled file positions Cells This m eans that a conversion definition identifies the spooled file and decides for an output file nam e. Each conversion definition consists of one or m any conditioned lines, that identifies what kind of line each spooled file line is and thus decides for what row to use. Each conditioned line consists of one or m any layout definitions, that takes spooled file text from relevant positions in the given line and tells in which cells the text is to be placed. The tree structure is clearly visible on the web interface: Under ‘Conversion definitions’ you see the conversion definitions as first level of branches (DEMO, DEMO2, IS507....). Inside the DEMO conversion definition you see the conditioned lines (DETAIL1, HEAD1, HEAD2...). W ithin each conditioned line you see the layout of the line. Above the layout of the line DETAIL1 is shown - showing you the layout of cells starting with 2 and ending with 8. To open an elem ent you can either click the elem ent in the tree structure or the left or click the elem ent on the list on the right of the screen. InterForm A/S 23 W hen you select option ‘3. W ork with Conversion definitions’ after the INTERXEL/INTERXEL com m and for the first tim e you will see this: Work with Conversion definitions Position to . . . . . . Conversion definition Type options, press Enter. 2=Change 3=Copy 4=Delete Opt Conv. Definition DEMO DEMO2 IS507 IS508 IS750 R4IN70P1 R4LB30P1 R4LB42 ZHELP HEDUPD1 5=Display 7=Rename Description InterExcel400 demo spool file InterExcel400 demo spool file FMIS IS507 FMIS IS508 FMIS IS750 Demo for XPPS Infor splf Demo for XPPS Infor splf Demo for XPPS Infor splf Help to define conversion def. 8=Conditions Form type *STD DEMO2 Splf Name DEMO DEMO R4IN70P1 R4LB30P1 R4LB42P2 QSYSPRT End F1=Help F3=Exit F5=Refresh F6=Create F11=View 2 F12=Cancel This lists the different kinds of spooled files, that are known by InterExcel400. Here we use the conversion definition nam ed DEM O. It looks like this: (Selecting option 2=Change) Change Conversion definition Conversion definition Description . . . . . Form type . . . . . . Save attr. of Splf Y/N Job Name . . . . . . . Spooled file name . . Printer file . . . . . Program . . . . . . . . . . . . . . . : . . . . . . . HEDUPD2 DEMO______ InterExcel400_demo_spool_file_ __________ _ __________ DEMO______ __________ Printer file Library . . . __________ __________ Program Library . . . . . __________ Output Excel file name . . /interxel/temp/*V1_*V2_*V3.xls___________________ ______________________________________________________________________________ ______________________________________________________________________________ _____________________________________________ Replace if file exist Y/N. Y Spooled file codepage . . ______ Splf.Atr. From To Variables for file name: or blank pos pos Line *V1 . . . . . . . . . . . __________ __1 _12 __2 *V2 . . . . . . . . . . . __________ _22 _35 __5 *V3 . . . . . . . . . . . __________ _22 _33 __6 *V4 . . . . . . . . . . . __________ ___ ___ ___ F1=Help F3=Exit F12=Cancel Conversion definiton nam e is used when InterExcel400 is searched for a fit with a spooled file. The conversion definition are searched in alphabetical order, but norm ally that is not im portant. The spooled file attributes: Form type, save attr., Job nam e, spooled file nam e, printer file, printer file library, program and program library are all used to identify the spooled file. If any are filled out they m ust fit exactly with the spooled file if this conversion definition is to be selected for a ‘requesting’ spooled file. The Output Excel file nam e defines where the resulting excel spreadsheet is to be created when using the SPL2XEL com m and. This can later be overridden when converting a specific spooled file in the SPL2XEL com m and. As a part of the nam e you can use up to 24 User’s Manual for InterExcel400 4 variables defined below. The values of the variables will be substituted for *V1-*V4 in the file nam e and path. Note that directories in the path can be created if necessary depending on the configuration values of InterExcel400. Replace if file exists Y/N determ ines if InterExcel400 can replace existing files or not. If you state N and a file with the sam e nam e already exist you will get an error m essage. Spooled file codepage: Leave this field em pty if the spooled file is in the sam e codepage as the current job. If not type the codepage to use for the conversion from EBCDIC into ASCII. Variables for file nam e: The variables *V1-*V4 can be defined either as spooled file text as above (leaving the splf. Atr. Field em pty) or any of the spooled file attributes FORMTYPE, JOBNAME, USER, JOBNUMBER, SPLFNUMBER, SPLFNAME, USRDTA, USRDFNDTA. You can even com bine the spooled file attributes with the from pos. and to pos. fields to only include a part of the spooled file attribute. InterForm A/S 25 W hen you press Enter you see the other fields on a conversion definition: Change Conversion definition Template .xls file . . . . demo.xls Use template styles N (Y/N) Page Range . . . . . . . . From page . . . . . . . To page . . . . . . . . 1 *END HEDUPD2 (Blank means page 1) (Blank or *END means last splf page) Local file on PC . . . . . C:\INTERXEL\TEMP\MYFILE.XLS Delete original spool file *NO F1=Help F3=Exit F12=Cancel Template .xls file If you want to insert the spooled file data into an existing excel file, then you state the existing file here. It is to be placed in the /InterXEL/Tem plates directory in the IFS. This tem plate can have predefined graphics, form ulas and charts to help illustrate the data found. Use template styles If you use a tem plate you can chose if the styles (fonts, borders, form ats etc.) should override the styles of your conversion definition. State ‘Y’ to do that. If you state ‘N’ the styles defined in InterExcel400 will override the styles found in the tem plate. (However if you have stated 0 as the style in a layout the tem plate style will still be used.). Page Range If you do not want to convert the whole spooled file into excel you can state a page range to use here instead. Local file on PC If you convert your spooled files into excel via option 11 you can here state an alternative nam e for the tem porary files generated on your PC. Rem em ber to state the whole path including the file nam e e.g. C:\interxel\temp\myfile.xls. You can also use variables (*V1-*V4) as a part of the path or file nam e. If you use *DEFAULT the files will be generated in C:\interxel\tem p\ with the file nam e ‘file’ followed by a rolling num ber from 0 to 9 - with the extension .xls of course. W hen you are done setting up the conversion definition you select option ‘8=Conditions’ for the conversion definition to define the different types of lines in the spooled file: 26 User’s Manual for InterExcel400 Conditioned lines If you select option 8=Conditions for the DEMO conversion definition you will see this: Work with Conditioned lines Conversion definition : DEMO Position to . . . . . . Type options, press Enter. 2=Change 3=Copy 4=Delete Opt _ _ _ _ _ _ Line Name DETAIL1 HEAD1 HEAD2 HEAD3 HEAD4 TOTAL1 CONUPD1 Line Name 5=Display Description Detail line Top Header line Second header Small header line Column heading Report total 7=Rename Line Type D H H H H F 8=Layout From Line 10 2 3 4 8 10 To Line 30 2 3 6 8 30 From Pos. 65 0 0 0 0 55 To Pos. 65 0 0 0 0 65 End F1=Help F3=Exit F5=Refresh F6=Create F11=View 2 F12=Cancel The definitions you see above has been m ade for the InterExcel400 dem o spooled file. Here you can see how the line definitions are linked to the output: InterForm A/S 27 A conditioned line (or you m ight call it a line description) looks like this: Change Conditioned line Conversion definition Line Name . . . . . . Description . . . . . Type (D 1 2 3 H F X Y) . . . . : : . : From line . . . . . . . . To line . . . . . . . . . Row height . . . . . . . . Extension in same XLS row. Row placement (+/A ) . . . Condition: From Pos. 65 DEMO DETAIL1 Detail line D 10 30 12 N Row number . . . . . . . . (If left blank all lines in the interval will be used) To Pos. 65 F1=Help CONUPD2 Comp. (=N<>) = Compare text , F3=Exit F12=Cancel The line type defines the kind of line you define here: D Detail line. This can be found on any page and it will always be included in the final output if selected. 1 2 3 A detail line only to be searched for on page 1 of the spooled file. A detail line only to be searched for from page 2 until the end of the spooled file. A detail line only found on the last page of the spooled file. H A header line. The header lines found on page 1 of the spooled file are included in the excel output, while the header lines on the subsequent pages are not included in the output. F Footer line. The footer lines from the last page of the spooled file are included in the output. The others are not. That m akes sure that line totals and the like is not m aking a m ess of the output. X Extension line. This line is an extension of a previous line. If the conditioned line triggered by the last spooled file line had a ‘Y’ in the field ‘Extension in same XLS row’ this line will be placed in the sam e row in the output excel spreadsheet. Each of the cells in this line will be placed in the first free cell to the right of the previous line.. Y Fixed Extension line. This works very sim ular to the X-line above, except that a Yline will fill out fixed cells counted from the left. (This will use the colum n num ber stated in the layout inside this conditioned line). From To line The interval of lines in the spooled file to be considered for this kind of line. Row height The height of the row in excel. This should be about the sam e as the largest font size used in this row. Extension in same XLS row If you insert a ‘Y’ here, then you tell InterExcel, that this conditioned line can be linked with following X og Y-lines (with the sam e line nam e) which m ay insert cells in the sam e row as this. 28 User’s Manual for InterExcel400 Row placement The placem ent of the current line in the excel file. Keep this blank to sim ply use the next available row in the excel file. + This indicates that you want to skip rows (counted from the row that was last inserted). Type the num ber of rows to skip in the field Row number. Row num ber=1 will give you one em pty row. A Absolute positioning. This will place the spooled file line in a fixed row in the excel output. State the row num ber to tell where it is to be placed. If the row is lower than the rows previously processed, then InterExcel400 will m ove down and place the line here. If the row is already used then the line will be placed in the next free row. Condition The condition can be left blank to sim ply use this line definition for the whole line interval above. You can also state a condition to which the lines m ust fit in order to be considered here. Use the com parisons: = Equal to N Not equal to. > Greater than < Less than So in the exam ple above we search lines 10 to 30 for a ‘,’ in position 65. This is how we identify a detail line. The problem is, that the Grand total of the spooled file could also be found on any of these lines so that is why we have included a condition here. The TOTAL1 line is also conditioned to select only the line with ‘Grand Total’ in the spooled file. Please notice, that spooled file lines, that are not selected by any conditioned line in InterExcel400 are not copied to the final output: The top of page 2 in the *SCS dem o spooled file looks like this: Display Spooled File File . . . . . : DEMO Page/Line 2/7 Control . . . . . ____________ Columns 1 - 78 Find . . . . . . _________________________ *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+... ============================================================================== Sales Rep. Art Description Quantify Unit Price Discount ============================================================================== Transport -----------------------------------------------------------KSE 4100003 1x1/32 inch yellow rubber band 2 234,00 20% PDC 2100006 1x1/16 inch red rubber band 3 1.235,00 0% BJE 100006 1x1/16 inch black rubber band 2 1.565,00 0% BJE 1200003 2x1/32 inch braun rubber band 4 2.564,00 0% BJE 5300012 3x1/8 inch green rubber band 4 13,00 0% PDC 6300006 3x1/16 inch blue rubber band 3 24.365,00 0% PDC 7100050 1x1/2 inch violet rubber band 2 654,00 0% SEM 8400050 4x1/2 inch grey rubber band 4 3.456,00 0% SEM 9400050 4x1/2 inch white rubber band 2 5.646,00 0% PDC 400006 4x1/16 inch black rubber band 2 7.896,00 0% SEM 1400003 4x1/32 inch braun rubber band 4 546,00 10% More... F3=Exit F12=Cancel F19=Left F20=Right F24=More keys You m ay notice that the ‘======’ lines as well as the ‘Transport’ and ‘------------‘ lines are m issing in the Excel spreadsheet sim ply because no conditioned line is ‘grabbing’ those lines. W hen you have defined a conditioned line you use option ‘8=Layout’ to tell InterExcel400 how the relevant line is to placed in the cells in the current row of the output. Read below to see how to do that. InterForm A/S 29 Define the Layout of cells After you have defined a conversion definition you define at least one conditioned line and within each of these you define one or m ore layouts. You reach this from a com m and line by executing interxel/interxel and selecting: ‘3. W ork with Conversion definitions’, ‘8=Conditions’ and ‘8=Layout’: Work with Cell Layouts LAYUPD1 Conversion definition : Line Name . . . . . . : Line type (D 1 2 3 H F: DEMO DETAIL1 D Position to . . . . . . ____ Type options, press Enter. 2=Change 3=Copy 4=Delete Opt _ _ _ _ _ _ _ From Pos. 1 6 19 50 59 70 79 To Pos. 5 17 49 55 69 78 95 Output Column No 2 3 4 5 6 7 8 Column No in Excel outp 5=Display Style Nbr. 6 7 6 7 7 7 7 Data Type A N A N N A N Column Width 20 20 20 20 20 20 20 End F1=Help F3=Exit F5=Refresh F6=Create F12=Cancel Above we are looking at the layouts defined for the DETAIL1 conditioned line in the DEMO conversion defínition created for the InterExcel400 dem o spooled file. A layout is defined like this: Change Cell Layout Conversion definition . : Line Name . . . . . . . : Type (D 1 2 3 H F X Y) . : DEMO HEAD1 H From position (in splf.) . To position (in splf.) . . Column No in Excel output: Style number . . . . . . . Min. Column width . . . . 1 40 2 1 Data type in cell (N A) . Thousand separator in splf Decimal separator in splf: Negative value indicator: F1=Help From-To position 30 LAYUPD2 User’s Manual for InterExcel400 F3=Exit 20 A To column (Merge cells): (F4) (Measured approx. in mm.) 7 A=Alpha numeric, N=Numeric) (Only used for N=Numeric) (Only used for N=Numeric) (Only used for N=Numeric) F12=Cancel This is the interval of positions in the current spooled file line to be placed in this cell in the excel spreadsheet. InterExcel400 will rem ove any leading and trailing blanks from the m arked interval when copying it to excel. Colum n No in Excel output The colum n num ber where the spooled file data is placed. This is the cell num ber counted from the left so colum n A in excel is called 1, colum n B is 2 and so on.... To column (M erge cells) Style num ber M in. Column w idth Data type in cell If you want to m erge several cells into one e.g. to m ake room for a large header line, then you can state the en colum n here. Above we m erge cell 2 to 7 into one cell (also called cell A to G). A style num ber previously created. The cell style defines the font and borders for the cell. Use F4 to list the existing styles. You can also leave it blank (sam e as 0) and use the style of a tem plate excel file - if used. The m inim um colum n width. The m inim um width of this colum n when this cell is used. The colum n width will be adjusted to fit the largest value of the ‘m in. colum n width’ in all cells in this colum n. Auto adjust of the width is not possible at the m om ent. The unit of m easure is approxim ately around 1 m m . when printing on A3 (So 25 is around 1 Inch). The norm al data type to use is ‘A’ for alphanum eric. This can be used for norm al text. If you however wants to be able to use a num eric value to do further calculations in excel (after InterExcel400 have m ade the excel file) you need to m ake sure, that Excel recognizes the cell contents as num eric. That can be done either m anually as described on page 39 or by defining the field as ‘N’ - num eric. If you state the field to be num eric the following fields should also be filled out: Thousand separator Decimal separator The sign that InterExcel400 should look for as thousand separator in the spooled file. You can leave it blank if no thousand separator is used. If a sign for decim al point is used in the spooled file it m ust be stated here otherwise leave it blank. Negative value indicator If the num eric value can be negative you here state how InterExcel400 can determ ine that. A ‘-‘ (without ‘’) would be the norm al value to use. The whole position interval is scanned for this. InterForm A/S 31 Below you can see how the layout links the spooled file and excel output for one of the cells in a detail line: 32 User’s Manual for InterExcel400 The INTERXEL/WRKOUTQXEL Command This com m and offers the possibility for end users to quickly convert a spooled file into an Excel or text file and open it im m ediately on the PC. It looks very m uch like the OS400 W RKOUTQ: The additions to the norm al W RKOUTQ com m and are these options: 10=Open in Excel This opens the m arked spooled file as an unform atted text file in Excel. Blank lin 11=Form at as xls This will search all conversion definitions in InterExcel400 to find a conversion definition, that fits the spooled file attributes. If found it will convert the spooled file to a form attet Excel spreadsheet and open it. 12=Open as .txt Opens the spooled file unform atted as a .txt file in the application associated with .txt. 13=Open as .rtf Opens the spooled file unform atted as a .rtf file in the application associated with .rtf. The lim itations com pared to the norm al OS400 W RKOUTQ are these: a) The output queue contents is not updated unless you exit and reenter the com m and b) Option 7=M essages is not yet supported c) F17 (top) and F18 (bottom ) are not supported yet, but you can position to a spooled file num ber in the list (counted from the top). d) There is no com m and line. e) F5=Refresh does not work yet. Notice: W hen you open a spooled file with any of the options 10-13 the PC application will open a tem porary file. The sam e tem porary file will be reused for the sam e interactive job m eaning, that you will m ay get an object lock error if you try to convert a new spooled file before closing the tem porary file you opened earlier. InterForm A/S 33 The INTERXEL/WRKSPLFXEL Command Just like W RKOUTQXEL above gives you an extended version of the W RKOUTQ com m and, the W RKSPLFXEL com m and is an extended version of W RKSPLF. One difference is the param eters on the com m and: Work with Spooled Files (WRKSPLFXEL) Type choices, press Enter. Select files for: User . . . . . . . . Output queue . . . . Output queue Library Form type . . . . . User data . . . . . F3=Exit F4=Prompt F24=More keys SELECT . . . . . . . . . . . . . . . . . . . . . . . . . F5=Refresh *CURRENT *ALL *LIBL *ALL *ALL F12=Cancel Name, *CURRENT, *ALL Name, *ALL Name, *LIBL Form type, *ALL, *STD User data, *ALL Bottom F13=How to use this display On this com m and you can lim it the spooled files shown to be the ones that are owned by a special user AND that is placed on a special output queue, where the W RKSPLF com m and only lets you com bine the user with a printer device... The extra options and the actual list of spooled files looks and runs exactly like the W RKOUTQXEL com m and above. 34 User’s Manual for InterExcel400 The Command SPL2XEL (Spooled file to Excel) The com m and SPL2XEL can be used for converting *SCS spooled files into Excel or text files. The com m and looks like this: Spooled file to Excel conv. (SPL2XEL) Type choices, press Enter. Spooled file . . . . . . . . . Job name . . . . . . . . . . . User . . . . . . . . . . . . Job number . . . . . . . . . Spooled file number . . . . . Use Conv. def. (Format output) Open in . . . . . . . . . . . Output type . . . . . . . . . Codepage (if no conv. def.) . Replace (if no conv. def.) . . . FILE . JOB . . . SPLNBR FORMAT . OPEN . OUTPUT . CODEPAGE . REPLACE __________ *_________ __________ ______ ______ *YES *NONE_ *XLS *JOB____ *NO_ Name Name, * Name 000000-999999 000000-999999 *YES, *NO *NONE, *EXCEL, *WORD *XLS, *TXT, *RTF Character value *YES, *NO Excel file - incl. path (/) . . OUTFILE *DEFAULT_____________________________ _______________________________________________________________________________ _______________________________________________________________________________ _______________________________________________________________________________ _______________________________________________________________________________ _______________________________________________________________________________ _______________________________________________________________________________ *DEFAULT, *TEMP, Character value The fields are these: Spooled file, Job nam e, User, Job num ber and Spooled file num ber identifies the spooled file to be converted. FORM AT *YES indicates that the spooled file m ust be linked with an InterExcel400 Conversion definition and converted into a form atted excel spreadsheet according to this definition. *NO m eans that the output will be unform atted text in a file with the extension indicated in the OUTPUT field. OPEN *NONE indicates that the resulting file will not be opened on a connected PC. You m ust select *NONE for any batch jobs. *EXCEL indicates that the resulting file is to be opened in Excel. *W ORD m eans that the converted spooled file should be converted into a file with the extension denoted in OUTPUT and the PC application associated with this extension should open the file. OUTPUT The type (and extension) of the resulting file. *XLS, *TXT and *RTF are supported values. CODEPAGE The codepage in which the spooled file is written. *JOB will use the codepage (DFTCCSID) of the current job. REPLACE State if InterExcel400 can replace the old file if a file with the sam e nam e already exists. OUTFILE The nam e of the stream file to be created. *DEFAULT can be used if you select FORM AT=*YES. This will use the path specified in the conversion definition that fits the spooled file. *TEM P m eans that only a tem porary output file will be created. This can be used for interactive jobs where you want to open the resulting file, but not necessarily place it in the IFS of the iSeries. InterForm A/S 35 The speed of the SPL2XEL com m and varies a lot when you run it with FORM AT=*YES: If you com bine form at=*YES with a path or *DEFAULT as OUTFILE the conversion into an excel spreadsheet is done 100% on the iSeries (with a java program ). This takes considerably longer than if you com bine form at=*YES with outfile=*TEMP as this will run the java program on the connected PC, that is to open the excel file. Please note, that using *TEMP as outfile reuses the sam e tem porary file, so in order to avoid any object lock you need to close the previously opened file on the PC. 36 User’s Manual for InterExcel400 Running InterExcel400 with InterForm400 InterExcel400 can be used without InterForm 400, but if needed it can easily be setup with InterForm 400. You can sim ply use the dem o program delivered with InterExcel400. It is: INTERXEL/AFCSPL2XLS, which is prepared like below and the owner is QSECOFR. The source of this program can be found in INTERXEL/APISRC. These are the steps you can use: 1. Create this source m em ber to be used via a option 8=Call Program in auto form s control in InterForm 400: PGM (&JOBNAME &USER &JOBNBR &FILNAM &FILNBR &OUTQ &OUTQLIB) DCL DCL DCL DCL DCL DCL DCL &JOBNAME &USER &JOBNBR &FILNAM &FILNBR &OUTQ &OUTQLIB *CHAR *CHAR *CHAR *CHAR *CHAR *CHAR *CHAR 10 10 6 10 6 10 10 INTERXEL/SPL2XEL FILE(&FILNAM) + JOB(&JOBNBR/&USER/&JOBNAME) + SPLNBR(&FILNBR) ENDPGM You can copy the m em ber called funkt_8 from the source file apf3812/apisrc and rem ove any unnecessary lines from the copy and just add the INTERXEL/SPL2XEL com m and. Please go through the param eters of the SPL2XEL com m and to m ake sure all the param eters are set correctly. 2. Com pile the program you have just created. Make sure, that the com piled program is not placed in the INTERXEL or APF3812 library as that can cause a problem the next tim e you upgrade either InterForm 400 or InterExcel400. 3. The final step sets your changes into production. Please note, that it takes a bit longer to create Excel files directly on the iSeries com pared to norm al InterForm 400 functions, so it m ight be an idea to use a dedicated output queue for this. To setup InterForm 400 for this you setup the output queue in auto form s control like this: InterForm A/S 37 Update AFC-functions attached to output queues Queue: INTERXEL Seqnbr Funct 0001 8 0002 Library: Form type AFC305D QUSRSYS Save Jobname Filename Device file Program DEMO Call, program: FUNKT_8XEL library: APF3812 User profile AFCOPER 6 Hold Spooled File Seqnbr Function 1.0 8 Program call Program name . . . . . Library . . . . . . User profile . . . . F3=Exit F13=Fold/Unfold AFCSPL2XEL APF3812___ AFCOPER___ F11=Delete Name Name, *LIBL AFCOPER, *OWNER F12=Cancel In this exam ple we have chosen to only convert spooled files with the nam e DEM O into Excel spreadsheets. This selection should fit the definitions in InterExcel400 so the spooled files are recognized by InterExcel400 and a fitting conversion definition can be found. This fits the InterExcel400 dem o spooled file. You can consider to use either AFCOPER or *OW NER as the user profile for the program call. The user profile stated here will own the created excel spreadsheet and should have authority to create the files in the IFS. 38 User’s Manual for InterExcel400 Tips and tricks for Excel and InterExcel400 Below are listed a few tips and tricks that m ight com e in handy when using InterExcel400 and/or Excel: Activating the ‘Text import wizard’ in Excel. Som e of your users m ight want to convert a spooled files into excel ad hoc i.e. they want to create an excel spreadsheet for a spooled file for which no conversion definition have been defined. The sim ple way to do that is from the INTERXEL/W RKOUTQXEL com m and and select option 10=Open in Excel. That will not break up the file into nice colum ns, but you can be prom pted for how it should be broken up by sim ply closing the file and then reopening it from Excel by selecting ‘File’ and selecting the tem porary file like this: W hen you then reopen the file the Text im port wizard will start. After selecting next you can drag the lines below to state how the colum ns should be split up: Converting text into numeric fields in excel W hen form atting a spooled file into an excel spreadsheet you can define cells to be num eric (if the text inside is num eric), but for som e situations you m ight want m anually to tell excel to consider text in a cell to be numeric. This m ight be the case in these situations: a) The cells are m arked with the warning ‘The num ber in this cell is form atted as text or preceded by an apostophe’. InterForm A/S 39 b) You want to execute a num eric form ula e.g. SUM on the relevant cells. This can m anually be fixed in this m anner: (Quote from help in Excel) 1. Select a blank cell that you know has the General num ber form at If you are not sure of the cell form at, click Cells on the Format m enu, and then click the Num ber tab. In the Category box, click General, and then click OK. 2. In the cell type 1 and then press ENTER. 3. Click the cell, and then click Copy on the Standard toolbar. 4. Select the range of cells that contain the “text” num bers. 5. On the Edit m enu, click Paste Special, click M ultiply, and then click OK. Displaying large texts across cells If you want to distribute one value or cell across m any cells you can do that in the layout. Here we are distributing the header across cells from 2 to 7: Change Cell Layout LAYUPD2 Conversion definition . : Line Name . . . . . . . : Type (D 1 2 3 H F X Y) . : DEMO HEAD1 H From position (in splf.) . To position (in splf.) . . Column No in Excel output: Style number . . . . . . . Min. Column width . . . . 1 40 2 1 Data type in cell (N A) . Thousand separator in splf Decimal separator in splf: Negative value indicator: F1=Help 20 A To column (Merge cells): (F4) (Measured approx. in mm.) 7 A=Alpha numeric, N=Numeric) (Only used for N=Numeric) (Only used for N=Numeric) (Only used for N=Numeric) F3=Exit F12=Cancel Using charts with the spooled file data You can define charts in your tem plate to present your spooled file data in a m anner that is easier to read - as you know a picture tells m ore than a thousand words... You just define the chart outside the area where the spooled file data is inserted. Refer to the tem plate R4LB30P1.xls in /interxel/tem plates and refer to the conversion definition with the sam e nam e. This has been predefined for the Infor XPPS spooled file with the sam e nam e. 40 User’s Manual for InterExcel400 License code information The license code of InterExcel400 can be found and change via INTERXEL/INTERXEL and option ‘10. W ork with license inform ation’: Work with InterExcel400 license code Type in the values and press Enter. Serial No......: 65BD1BB Enddate........: 20061121 (YYYYMMDD) Max. Nbr. users: 050 License code...: NBTJ9MFB Version........: 001015 Valid License..: *YES F3=Exit F12=Cancel W hen you receive a license code it m ust be delivered with an end date and a m axim um num ber of users. If the end date is blank it is a perm anent license. The sam e values m ust be entered with the license code for it to be accepted. A user profile is considered to be a user of InterExcel400 (and is counted in the list of users) if the user profile is using either of the com m ands INTERXEL/SPL2XEL or INTERXEL/W RKOUTQXEL or if a spooled file owned by a user profile is handled by InterExcel400 (converted into a stream file). The license code is also depending on the version of InterExcel400 i.e. the first 3 digits of the version (001 above). InterForm A/S 41 Appendix A: The Web Interface If you are not running InterExcel400 on an older iSeries and using InterExcel400 intensively with m any users using InterExcel400 in parallel, then you should consider to activate the web interface of InterExcel400. The web interface runs java program s on the System i and that can run slow, if the System i is not up to date. The web interface requires that the user profile W EBINTER exists and that the user has a password (which can be unknown by InterExcel400). W hen the first user enters the InterExcel400 m enu this user is created, if it does not exist. Prerequisites Apart from installation of InterExcel400, it is required that the System i is running Java Runtim e Environm ent version 1.5 or newer in order to use the web interface. Configure the web server First you need to configure the web server. In order to configure the server you go into InterExcel400 with the com m and, INTERXEL/INTERXEL and select option ‘80. Adm inistration‘ followed by ‘16. W ork with Tom cat web server’, which will get you to this screen: Work with Web servers Type options, press Enter. 1=Start server 2=Change Opt WSR100D 4=End server 5=Display Description Inter Excel F3=Exit F5=Refresh F10=Configure control ports 8=Display log Status *IDLE Library INTERXEL F11=View 2 End F12=Cancel You can here select option ‘2=Change’ to verify and change the ports used: 42 User’s Manual for InterExcel400 Change Web server Description . . . . . . . Sign on required . . . . . TCP/IP port . . . . . . . TCP/IP control port F3=Exit . . . WSR110D Inter Excel *YES 8800 18800 *YES, *NO 1-65535 10000-65535 F12=Cancel These are the default values. If you set ‘Sign on required’ to *NO, then you will need to use tokens with the browser sessions as described below. The TCP/IP port is the port to use when you use the browser interface. You access InterExcel400 by e.g. typing this in the browser: http://192.168.250.11:8800/ W here you of course exchange ‘192.168.250.11' with the IP-address or identification of your system i. If you find, that the web server does not behave as it should you can use option 8=Display log to check the log of the web server for any errors. Using tokens to eliminate a sign on request If you do not want to sign on (specifying *NO for ‘Sign on required’ above), then you will need to use tokens instead. First you need to get a token. You can do that via program , that is calling the com m and INTERXEL/GETW EBTKN (Get web token). This program should call the com m and with a variable defined as CHAR (alphanum eric) which m ust be at least 32 characters long. The variable will contain the token value when returning from the com m and. The com m and, GETW EBTKN can only be called from a program . The program m ust run under the sam e user as the user that should use the token. You can e.g. call this CL program : PGM DCL &TOKEN *CHAR 32 INTERXEL/GETW EBTKN TOKEN(&TOKEN) DMPCLPGM ENDPGM It will generate a spooled file containing value of the token in the variable &TOKEN. Now you can use the token to access InterExcel400 via a browser by specifying this as the address: http://system :port?user=usrprf&token=token W here usrprf is the user profile that has run the program above and the one running the browser session and the last token is the value found when calling the program . InterForm A/S 43 Here is an exam ple: http://192.168.250.11:8800/?user=KSE&token=5kodcEI5RZIz2J7X8Npzxy2psVLKSbgz Here the user profile, KSE is running the browser session with the token, 5kodcEI5RZIz2J7X8Npzxy2psVLKSbgz. Starting and stopping the web server You can start and stop the web server by entering InterExcel400 with the com m and, INTERXEL/INTERXEL and selecting option ‘80. Adm inistration‘ followed by ‘16. W ork with Tom cat web server’, which will get you to this screen: Work with Web servers Type options, press Enter. 1=Start server 2=Change Opt WSR100D 4=End server 5=Display Description Inter Excel F3=Exit F5=Refresh F10=Configure control ports 8=Display log Status *IDLE Library INTERXEL F11=View 2 End F12=Cancel If you select option ‘1=Start server’ you will subm it a job called STRW EBSVR to the job queue, QSYSNOMAX which will norm ally m ean that the job runs in subsystem , QSYSW RK. After a few seconds the status should change to ‘*ACTIVE’. If not you can check the joblog of the subm itted job e.g. with the com m and ‘W RKJOB STRW EBSVR’. If you select option ‘4=End server’ a job called ‘ENDW EBSVR’ is subm itted like above. The web server will then end after a few seconds. You would probably want the web server to start as a part of the IPL. If so you can add the com m ands below at the end of the start up program , keeping in m ind that ONLY a system responsible should change the start up program . These com m ands could be added to start up the web server - please note that the start up should always be subm itted as the com m and changes som environm ent variables of the current job: SBMJOB CMD(CALL PGM(INTERXEL/STRTOMSVRC)) JOB(STRW EBSVR) JOBQ(QSYS/QSYSNOMAX) MONMSG MSGID(CPF0000) (Rem em ber MONMSG to ignore any errors so the start up process will proceed independent of this subm it). If you want to subm it an autom atic end of the web server you can do that with this com m and: 44 User’s Manual for InterExcel400 SBMJOB CMD(CALL PGM(INTERXEL/ENDTOMSVRC)) JOB(STRWEBSVR) JOBQ(QSYS/QSYSNOMAX) MONMSG MSGID(CPF0000) Using the web interface To use the web interface you sim ply start up your web browser and type this as the address: http://<ip>:<port>/ W here <ip> is exchanged with the ip-address of the System i and <port> is exchanged with the port num ber specified above e.g. like so: http://192.168.250.11:8800/ Now you will be prom pted for a user profile and password to access the System i in a new window. After that you will see this: Notice the tree structure on the left. You can sim ply click on the ‘+’ and ‘-‘ left to the branches to open and close any subtree: InterForm A/S 45 The functionality and setting up InterExcel400 is described elsewhere in the m anual. It is in essence working in the sam e m anner for both green screen and browser sessions, except that the tree structure of the conversion definitions, conditioned lines and layouts can be clearly seen in the browser interface. Above we have clicked ‘Spooled files’ on the left listing the spooled files of the current user. Now you can type in a search criteria on the upper right if you e.g. want only to see spooled files on a specific output queue. Currently the option ‘Display spooled file’ has not been im plem ented in the Browser interface yet. If you want to form at a spooled file into an Excel file you m ark the spooled file and click the ‘Form at as xls’ icon on the top. If nothing happens or if a browser window quickly flash and end then you m ight need to adjust the security settings of your browser to allow your System i to output the file to your browser. Below it is shown how to do that in MS Internet Explorer: Changing the security settings in MS Explorer If you see a flashing new window when you try to form at a spooled file as an Excel file via the browser, then it is very likely that your security settings are restricting this. Here is a one way to allow the System i to open the excel file on your PC. In MS Explorer you select ‘Tools’ and ‘Internet Options’: 46 User’s Manual for InterExcel400 Now you select the ‘Security’ tab in the top, ‘Local intranet’ and ‘Sites’ as m arked below: Now click the ‘Advanced’ button in the new window below: And finally you can add the current site as a safe intranet site: InterForm A/S 47 48 User’s Manual for InterExcel400 Index Configuring InterExcel400. . . . . . . . . . . . . . . . . . . 9 Contact information. . . . . . . . . . . . . . . . . . . . . . . . 2 Convert spooled file to Excel In Batch. . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Interactively. . . . . . . . . . . . . . . . . . . . . . . . . 33 Convert spooled file to Text.. . . . . . . . . . . . . . . . 33 convert text to numeric Automatic. . . . . . . . . . . . . . . . . . . . . . . . . . 31 Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Defining Cell Styles. . . . . . . . . . . . . . . . . . . . . . . . . . 21 Conditioned lines. . . . . . . . . . . . . . . . . . . . . 27 Conversion definitions. . . . . . . . . . . . . . . . . 23 Fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Layout of cells. . . . . . . . . . . . . . . . . . . . . . . 30 Display texts across cells. . . . . . . . . . . . . . . . . . 40 Import wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Initial test.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Installation On PCs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Restore directory. . . . . . . . . . . . . . . . . . . . . . 6 Restore library. . . . . . . . . . . . . . . . . . . . . . . . 5 Introduction to InterExcel400.. . . . . . . . . . . . . . . 16 License code.. . . . . . . . . . . . . . . . . . . . . . . . . . . 41 License Information.. . . . . . . . . . . . . . . . . . . . . . 41 Setup of conversion. . . . . . . . . . . . . . . . . . . . . . 17 SPL2XEL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Support information.. . . . . . . . . . . . . . . . . . . . . . . 2 Table of Contents. . . . . . . . . . . . . . . . . . . . . . . . . 4 Text Import Wizard. . . . . . . . . . . . . . . . . . . . . . . 39 Web Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . 42 Eliminate sign on request. . . . . . . . . . . . . . 43 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 42 MS Explorer setup. . . . . . . . . . . . . . . . . . . . 46 Start and Stop. . . . . . . . . . . . . . . . . . . . . . . 44 Using the web interface. . . . . . . . . . . . . . . . 45 Using tokens. . . . . . . . . . . . . . . . . . . . . . . . 43 Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 WRKOUTQXEL. . . . . . . . . . . . . . . . . . . . . . . . . 33 WRKSPLFXEL. . . . . . . . . . . . . . . . . . . . . . . . . . 34 InterForm A/S 49