AS/400 Report Splitter V4.08 User Guide. Copyright RJS Software Systems Inc

Transcription

1 AS/400 Report Splitter V4.08 User Guide Copyright RJS Software Systems Inc

2 I AS/400 Report Splitter V4.08 Table of Contents Foreword 0 Part I AS/400 Report Splitter 3 1 Overview... 3 Introduction to... AS/400 Report Splitter 3 About RJS Software... Systems Inc. 4 Licensing Information... 4 Contacting RJS... Software Systems, Inc. 5 2 Installation... 5 Introduction to... Installation 5 AS/400 Prerequisites... for AS/400 Report Splitter 5 AS/400 Installation... 5 AS/400 User Authorization... Code Entry 6 Deinstallation of... AS/400 Report Splitter 6 3 Getting... Started 6 Introduction to... Getting Started 6 Version 4.0 Changes... 7 Installing the AS/ Report Splitter Software 7 Overview of Report... Splitting Process 7 How to Run the... Report Splitter Process 8 Available Report... Splitting Methods 9 Assigning ... Addresses to a Report 10 Flow for Interactively... Splitting a Report 11 Flow for Automatic... Report Processing 11 Flow for Embedding... the Report Splitter Command in a Program 11 Identifying Splitting... Criteria within a Report 11 Sample AS/ Report 12 First Item - Creating... Report Page Definition 14 Manually Splitting... your First Report 16 Manually Splitting... a Report by Page Range 18 Manually Decollating... a Report Each Time Criteria Changes 19 Manually Distributing... an Entire Report if Selected Criteria Found 20 Manually Distributing... a Selected Section of a Report 21 Manually Distributing... the Last Page of a Report 23 Setting up Report... Distribution Criteria Entries 24 Manually Splitting... a Report using Report Distribution Criteria Table 24 Manually Distributing... a Report and Embedding an Address 25 Automatically... Splitting Reports using Output Queue Monitor 26 Embedding Report... Splitter Command in User Written Program 27 Running the Report... Splitter in a CL Job Stream 27 CL Sample Program... Code 27 Creating AS/ Reports with Unique Spool File Names 28 Merging Multiple... Reports into a Single Spool File 29 What's Next After... Getting Started? 29 4 Available... Menus 29 Introduction to... Available Menus 29 Getting to the... Main Menu 30 Available Options... 30

3 Contents II 5 Entering... Report Page Definitions 32 Introduction to... Entering Report Page Definitions 32 Getting to the... Report Page Definition Screen 32 Function Keys Options Available Entry Fields Entering... Report Distribution Settings 37 Introduction to... Entering Report Distribution Criteria Settings 37 Getting to the... Report Distribution Setting Screen 38 Function Keys Options Available Entry Fields AS/ Commands 47 Introduction to... AS/400 Commands 47 RPTSPLIT: AS/ Report Splitter Command 47 RPTMON: Report... Splitter Output Queue Monitor 53 WRKSPLIT: Work... with Report Splitter 55 RPTMRG: Report... Splitter Merge Command 63 RPTNUM: Retrieve... Spool File Name/Number 65 RPTREPRINT: Reprint... Spool File 66 RJSWRKOUTQ:... RJS Work with Output Queue 67 RJSWRKSPLF:... RJS Work with Spooled Filesb 68 8 Problem... Handling 69 Common Errors Other Errors Index 0

4 3 AS/400 Report Splitter V AS/400 Report Splitter 1.1 Overview Introduction to AS/400 Report Splitter The AS/400 Report Splitter is a Native AS/400 Report Distribution application designed to distribute AS/400 reports to local or remote AS/400 users without the necessity of printing. Utilizing the AS/400 Report Splitter, an entire report or selected portions of a report may be distributed to another user. The AS/400 Report Splitter allows a user to: Deliver an entire report. Split and deliver a selected page range. Scan a report for selected distribution criteria and extract matching pages. Split a report and create a new spool file each time the selected criteria changes. This is known as decollating a report. Scan the header of a report for a selected string value and deliver the entire report if the string is found. Re-sort pages during reprinting. Select all pages except the last page. Select all pages except the last xxx number of pages. Select only the last page. Select only the last xxx number of pages. To facilitate the splitting of selected portions of a report, a level break or comparison data range must be coded in the report. This string can be up to 30 characters in length. The Report Splitter will scan the report for the selected comparison data range when the report is processed. A report that has been split by the Report Splitter can be automatically distributed to up to ten local output queues and ten remote users when selection criteria is entered at run time. When using the Report Distribution Table, up to different selection criteria and destination users can be specified for a report. The AS/400 Report Splitter's command driven interface makes it easy to integrate the AS/400 Report Splitter into existing applications with minimum effort. The Report Splitter also has an easy to use "Work With" style spool selection screen to provide users with easy interactive access to the AS/400 Report Splitter functionality. The AS/400 Report Splitter also includes an output queue monitor that can monitor an output queue and automatically intercept and distribute selected reports. The output queue monitor program is the best way to automate the entire AS/400 report distribution process with the report splitter. For a more complete electronic report delivery system, the AS/400 Report Splitter can be integrated with any of the RJS electronic report distribution products. When integrated with the other RJS AS/400 report distribution products, reports can be automatically delivered. Deliver Reports Using RJS Product(s)

5 AS/400 Report Splitter 4 - WinSpool/400 Report Server or Native Report Server/400 product LAN - WinSpool/400 Batch Report Server or Native Batch Report Server/400 CD-ROM - WinSpool/400 Batch Report Server or Lotus Notes Report Server Internet/Intranet - WinSpool/400 Web Report Server or Web Report Server/400 Lotus Notes/Domino - WinSpool/400 Lotus Notes Report Server or Domino Report Server/400 AS/400 Report Splitter Version 4.0 The AS/400 Report Splitter was originally developed back in 1992 before a lot of the newer facilities such as SQL, ILE, etc. were available for general use on the AS/400. We decided that the technologies available in 2001 would give us the opportunity to better tune the AS/400 Report Splitter by making it faster and more flexible. The AS/400 Report Splitter Version 4.0 is the culmination of these efforts to create a better AS/400 Report Splitter. AS/400 Report Splitter Version 4.0 Features When using the Report Splitter to burst reports, a report is now treated just like a query database. You define the locations on each page that get scanned and the report splitter searches, selects and sorts the resulting pages into sections based on your selection criteria. Up to 10 different locations on each page can now be scanned when splitting a report. Boolean selection criteria can bow be used to select pages from a report. This is similar to using a tool such as Query/400 or SQL/400 to select records. Pages can be re-sorted during processing About RJS Software Systems Inc. RJS Software is a privately-held software and hardware company dedicated to providing high-quality AS/400 - iseries, Client/Server and web-based products and customer services. Customer Service is central to the company's objective. Read more about us on our web site. Copyright by RJS Software Systems Inc. All rights reserved.this manual and the software described in it are copyrighted with all rights reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any means without the written permission of RJS Software Systems. Trademarks AS/400 Report Splitter ä is a trademark of RJS Software Systems. Brand names and product names are trademarks or registered trademarks of their respective companies Licensing Information AS/400 Report Splitter is licensed on a per AS/400 partition basis. The license allows reports to be processed on one licensed AS/400 system.

6 5 AS/400 Report Splitter V Contacting RJS Software Systems, Inc. For AS/400 Report Splitter technical support, please review the following information before contacting RJS Software Systems. For Technical Support with AS/400 Report Splitter. Because of the complexity of dealing with the various AS/400 connectivity environments, please gather and organize as much information as possible on the problem prior to contacting RJS Software Systems for support. If you have a question about an AS/400 Report Splitter operation, first browse through the Online Help to try to find your answer prior to calling RJS Software Systems. Contact Information Telephone support is available on normal business days from 9:00 am to 5:00 pm central time. (952) Voice (952) Fax Support is available via at support@rjssoftware.com. You may also find the answer to your question on our web site: Installation Introduction to Installation This section covers the installation of AS/400 Report Splitter on the AS/400 system that will be running the software AS/400 Prerequisites for AS/400 Report Splitter A RISC AS/400 system running V4R2-V5R1 or above is required to run the software. Note: A non-risc version of the software for V3R2 can be shipped upon request AS/400 Installation This section includes instructions for restoring the AS/400 Report Splitter AS/400 library. AS/400 Installation Using RSTLIB Command Insert the RJS CD into the AS/400 CD Drive and sign on to the AS/400 with a user ID that has security officer authority. Run the following AS/400 command to restore the AS/400 Report Splitter library: RSTLIB SAVLIB(RJSSPLIT) DEV(OPT01) OPTFILE('/RJSSPLIT') AS/400 Installation Using FTP This method of installation is described in the RJS Product Catalog and also on the RJS Software Systems installation screen on the RJS CD-ROM. Note: All web download packages contain an automated FTP upload utility.

7 AS/400 Report Splitter AS/400 User Authorization Code Entry Sign on to the AS/400 with a user ID that has security officer authority. Entering AS/400 Report Splitter Access Code Add the RJSSPLIT library to the user library list by typing: ADDLIBLE RJSSPLIT and pressing Enter. Go to the report splitter menu by typing: GO RJSSPLIT and pressing enter. From the menu, take option 1.(Enter AS/400 Report Splitter License Code). Type the access code provided by RJS Software Systems. Type RJSSPLIT for the data area and the data area library. Press Enter to save the access code. If you have questions or problems with entering the access codes, contact RJS Software Systems for assistance. Entering Operating System Specific Settings Add the RJSSPLIT library to the user library list by typing: ADDLIBLE RJSSPLIT and pressing Enter. Go to the report splitter menu by typing: GO RJSSPLIT and pressing enter. From the menu, take option 2. Enter OS/400 Settings (82=V4R2, 88=V4R3 and above). Enter 88 for the value. Press Enter to save the access code. If you have questions or problems with entering the operating system setting, contact RJS Software Systems for assistance Deinstallation of AS/400 Report Splitter The following sections describe how to remove the AS/400 Report Splitter software from an AS/400 system. Removing AS/400 Report Splitter from an AS/400 To remove AS/400 Report Splitter from an AS/400, perform the following individual steps. Make sure the RJSSPLIT library is not being used. Sign on to the AS/400 as a security officer. Delete the RJSSPLIT library from the AS/400 by entering the following command: DLTLIB LIB(RJSSPLIT) 1.3 Getting Started Introduction to Getting Started The purpose of this section is to describe how to quickly get started using the AS/400 Report Splitter software to electronically deliver AS/400 reports.

8 7 AS/400 Report Splitter V Version 4.0 Changes The AS/400 Report Splitter was originally developed in 1992 before a lot of the newer AS/400 programming tools such as SQL, ILE, etc. were available for use on the AS/400. We decided that taking advantage of these technologies would give us the opportunity to better tune the AS/400 Report Splitter by making it faster and more flexible. The AS/400 Report Splitter Version 4.0 is the culmination of these efforts to create a better AS/400 Report Splitter. Because of the changes in AS/400 Report Splitter 4.0, any customer migrating from an older Report Splitter version will need to re-enter their report distribution information because the Report Splitter now treats each report like a query database and uses SQL to allow users to enter multiple selection criteria when selecting pages from a report. AS/400 Report Splitter Version 4.0 Features When using the Report Splitter to burst reports, a report is now treated just like a query database. You define the locations on each page that get scanned and the report splitter searches, selects and sorts the resulting pages into sections based on your selection criteria. Up to 10 different locations on each page can now be scanned when splitting a report. Boolean selection criteria can bow be used to select pages from a report. This is similar to using a tool such as Query/400 or SQL/400 to select records. Pages can be re-sorted during processing Installing the AS/400 Report Splitter Software If you haven't installed the software yet, go back to the Installation topic and install the software before continuing. If you're just reading ahead to find out what to do, then please continue Overview of Report Splitting Process The AS/400 Report Splitter is a Native AS/400 Report Distribution application designed to distribute AS/400 reports to local or remote AS/400 users without the necessity of printing. Utilizing the AS/400 Report Splitter, an entire report or selected portions of a report may be distributed to another user. The AS/400 Report Splitter allows a user to: Deliver an entire report. Split and deliver a selected page range. Scan a report for selected distribution criteria and extract selected pages. Split a report and create a new spool file each time the selected criteria changes. Scan the header of a report for a selected string value and deliver the entire report. Re-sort pages during reprinting. Select all pages except the last page. Select all pages except the last xxx number of pages. Select only the last page. Select only the last xxx number of pages. To facilitate the splitting of selected portions of a report, a level break or comparison data range must be coded in the report. This string can be up to 30 characters in length and up to 10 comparison data

9 AS/400 Report Splitter 8 criteria can be entered for each report page. The Report Splitter will scan the report for the selected comparison data when the report is processed and turn the comparison data on each page is extracted into data fields that can be searched using boolean criteria just like an SQL or Query/400 query would use. Note: When scanning for selected distribution criteria, the criteria must be found on each page that will be split within a report or the Fill option must be used in the report page definition to tell the splitter to automatically use the previously selected criteria if the criteria for the current page is blank. Example: If you want to select all pages from a report where the sales rep = 100, each page for sales rep 100 must contain the sales rep number 100. Alternatively if rep 100 is only printed on the first page for the sales rep 100 section and the Fill option was enabled in the report page defiinition, the splitter will automatically fill in rep 100 on each subsequent page until the next rep number is found. A report that has been split by the Report Splitter can be automatically distributed to up to ten local output queues and ten remote users when selection criteria is entered at run time. When using the Report Distribution Table, up to different selection criteria and destination users can be specified for each report. The AS/400 Report Splitter's command driven interface makes it easy to integrate the AS/400 Report Splitter into existing applications with minimum effort. The Report Splitter also has an easy to use "Work With" style spool selection screen to provide users with easy interactive access to the AS/400 Report Splitter functionality. The AS/400 Report Splitter also includes an output queue monitor that can monitor an output queue and automatically intercept and distribute selected reports. The output queue monitor program is the best way to automate the entire AS/400 report distribution process with the report splitter. For a more complete electronic report delivery system, the AS/400 Report Splitter can be integrated with any of the RJS electronic report distribution products. When integrated with the other RJS AS/400 report distribution products, reports can be automatically delivered. Deliver Reports Using RJS Product(s) - WinSpool/400 Report Server or Native Report Server/400 product PC/LAN Directories - WinSpool/400 Batch Report Server or Native Batch Report Server/400 CD-ROM - WinSpool/400 Batch Report Server or Lotus Notes Report Server Internet/Intranet - WinSpool/400 Web Report Server or Web Report Server/400 Lotus Notes/Domino - WinSpool/400 Lotus Notes Report Server or Domino Report Server/ How to Run the Report Splitter Process The report splitting process can be run using one of the following methods: Interactively using the Work with Report Splitter Option. Programmatically using the Report Splitter CL Command. Automatically via the Output Queue Monitor

10 9 AS/400 Report Splitter V4.08 Interactively using Work with Report Splitter Option Using the Work with Report Splitter (WRKSPLIT) option, a report can be selected and split interactively. A report is selected by viewing a list of reports from a selected AS/400 output queue and then selecting a report to split from the list. Programmatically using the Report Splitter CL Command The Report Splitter (RPTSPLIT) CL command can be run from the AS/400 command line. The Report Splitter command can also be embedded into a CL program to allow report splitting to be integrated with any custom AS/400 report creation application. Automatically via the Output Queue Monitor The Output Queue Monitor (RPTMON) command can be run during nightly processing to automatically process all reports from a selected output queue. The output queue monitor can also run in batch all day long to process and split reports as they are generated. The output queue monitor can also be run from the AS/400 job scheduler Available Report Splitting Methods Reports can be split using one of the following methods: Distribute a Copy of the Entire Report Distribute a Copy of the Selected Page Range Decollate a Single Report into Multiple Reports Scan Report for a String and Distribute a Copy of the Entire Report Extract Selected Pages Based on Boolean Search Criteria within Report Distribute only the Last Page of a Report Distribute a Report using Report Distribution Criteria Distribute a Copy of the Entire Report An entire report can be copied and distributed to one or more AS/400 print queues using the *NOSPLIT option. This is a great way to electronically distribute multiple copies of a single AS/400 report to multiple users. Distribute a Copy of the Selected Page Range A selected number of report pages can be copied and distributed to one or more AS/400 print queues using the *PAGERANGEoption. This is a great way to distribute selected sections of a report based on a page number range selection. One use for the page range option is to allow a single report to be printed on multiple printers. An example of using this option would be printing an 1000 page report on 2 printers. Pages could be printed on one printer and pages could be printed on another printer. Decollate a Single Report into Multiple Reports A single report can be automatically decollated into multiple reports by using the *DECOLLATE option. This is a great way to break a report into sections every time a selected value within a report changes. Many companies create sales reports, commission reports, etc. that are created as a single report, but they want to break up the report into sections each time the sales rep, sales manager, customer etc. changes. The *DECOLLATEoption works well in these scenarios. Note: When scanning for selected criteria, the criteria must be found on each page that will be split within a report. Scan Report for a String and Distribute a Copy of the Entire Report

11 AS/400 Report Splitter 10 Selected columns within a report header can be scanned for a criteria string using the *SCANHDR option. If the selected string is found within the first few 100 lines of the report, the entire report can be distributed to the selected report queue. Extract Selected Pages Based on Boolean Search Criteria within Report The *SELECT option can be used to scan a report for up to 10 criteria values. A boolean selection criteria can be used to select pages from the report. Example: (@SALESREP >= 100 <= 999) All pages that match the boolean selection criteria will be included when the report is split. This is a great way to extract a selected portion of a report and distribute the new report electronically to another output queue, via etc. Pages can also be re-sorted in ascending or descending order during spltter processing: Sort Ascending Example: (@SALESREP >= 100 <= 999 ORDER Sort Descending Example: (@SALESREP >= 100 <= 999 ORDER DESC) Note: When scanning for selected criteria, the criteria must be found on each page that will be split within a report. Distribute only the Last Page of a Report The *LASTPAGE option can be used to distribute only the last page of a selected report. This option is useful when distributing report information to executives who only need to see report total information. Distribute a Report using Report Distribution Criteria The *TABLE option can be used to distribute a report based on the Report Distribution Criteria table. Up to 99,999 entries can be entered for a particular report. The report distribution criteria are driven by spool file name. You will need to make sure your reports are created with unique Spool File Names or User Data names to make sure the report distribution settings will work correctly with a selected report. Note: See Creating AS/400 Reports with Unique Spool File Names Assigning Addresses to a Report If you will be automatically ing AS/400 reports using the WinSpool/400 Report Server or the Report Server/400 product, you can embed an address within a report using one of the following methods: Code the MAILTO: keyword at the beginning of the report or in each report section that will be split with the report splitter. When setting up a Report Distribution Criteria entry, a report cover page can be created and the MAILTO: keyword can be printed as part of the cover page text. The Report Server will extract the address from a MAILTO: line and will the report to the selected recipient. If multiple addresses are coded in the report, the last address should be delimited with a

12 11 AS/400 Report Splitter V4.08 tilde ~. Example address line with 1 address: MAILTO: test@rjssoft.com Example multiple address line: MAILTO: test@rjssoft.com;sales@rjssoft.com~ Flow for Interactively Splitting a Report Sign on to the AS/400 and add the Report Splitter library to your library list using the ADDLIBLE RJSSPLIT command. Type GO RJSSPLIT to go the report splitter main menu. Take Option 10, Work with Report Splitter to display a list of reports available in a selected output queue. Place an Option 13 next to a report you would like to split and press Enter. Key in the selected criteria and press Enter to split the report interactively Flow for Automatic Report Processing Reports are generated on an AS/400 and placed into selected output queue(s) so the AS/400 Report Splitter process can retrieve and split the reports. The Output Queue Monitor (RPTMON) job is submitted by a user job or the AS/400 job scheduler when reports are ready to be captured and distributed from a selected output queue. The Output Queue Monitor process can be run once or can be set up to automatically monitor for new reports on a timed interval. Most companies run the output queue monitor process once at the end of their nightly report processing so all reports get captured and distributed in one pass at the same time. If multiple source output queues will be processed, the output queue monitor must be submitted once for each source output queue. When an output queue gets processed, the Report Distribution Table is checked for the correct splitting criteria. If criteria are found for a selected report, it is processed and split using the criteria. After each report is processed it can be automatically marked as sent, deleted, or moved to another output queue Flow for Embedding the Report Splitter Command in a Program Create a CL program that generates an AS/400 report from a query or RPG program. After the report program runs, use the RPTNUM command to retrieve the spool file attributes. Run the Report Splitter (RPTSPLIT) command to split the report using the spool file information retrieved by the RPTNUM command. See the CL Sample Program Code in one of the next sections for a sample CL program Identifying Splitting Criteria within a Report Before splitting a report that contains selected criteria, you need a quick lesson on how to identify the correct report data line and columns when splitting a report. Find a report you want to split by using the

13 AS/400 Report Splitter 12 AS/400 WRKOUTQ or WRKSPLF command and then open the report for viewing using Option 5. Sample Report Since the AS/400 Display Spool File option doesn't show blank lines in the report, follow the steps listed below to determine which data line and columns to use when splitting a report. Display the spool file. Place a +1 in the Control field and press Enter until the data line to scan on is displayed at the top of the screen directly under the white ruler line. Look in the upper right hand corner of the screen to determine the actual line number to scan. In this example, we will be scanning line 10 on each page. We will also scan columns1-7 where the customer number 938,472 is located. After determining the page line and columns to scan, you are ready to split a report using selected criteria. Note: If you don't correctly determine the actual report data line to scan within a report, your splitting results may not come out as expected. Always make sure to identify the correct data line and column range before attempting to split a report Sample AS/400 Report In this section we will describe the sample report included when the AS/400 Report Splitter software is shipped. We will also describe how to generate the report in an output queue so you can use it to test

14 13 AS/400 Report Splitter V4.08 the AS/400 Report Splitter software.generating the Sample Report. Sign on to the AS/400 system and add the RJSSPLIT library to your library list by using the following AS/400 command: ADDLIBLE RJSSPLIT. Next type: GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter main menu. Take Option 4. (Generate Report Splitter Sample AS/400 Report) and select an output queue where you would like the sample report to be generated. Press Enter to generate the sample report. Sample Report Characteristics The report is a sample "Outstanding Invoices" report that is broken up by Sales Rep. The report data is fictional. This report is to be used for learning purposes only. Sample Report The report is broken down as follows: Sales Rep Data Line Location Line 3 of every page Sales Rep Data Columns Starting column: 13 Ending column: 15 Sales Manager Data Line Location Line 1 of every page Sales Manager Data Columns

15 AS/400 Report Splitter 14 Starting column: 7 Ending column: 9 Here is the sample report page sort breakdown by sales rep: Page 1-2, Sales Rep: 100, Manager 001 Page 3, Sales Rep: 200, Manager 002 Page 4-6, Sales Rep: 300, Manager 003 Page 7, Sales Rep: 400, Manager 004 Page 8-9, Sales Rep: 100, Manager 005 Page 10, Sales Rep: 200, Manager 006 Page 11-13, Sales Rep: 300, Manager 007 Page 14, Sales Rep: 400, Manager First Item - Creating Report Page Definition The report page definition is used every time the selected report is split to determine where criteria fields are located within each report page. Before a report can be split for distribution, a report page definition must be created for the report based on its spool file name. A report page definition tells the report splitter where each of the 10 criteria fields are located on each report page. A report page definition has nothing to do with report distribution selection criteria and how a report is split. The report page definition simply tells the splitter how to read each report page and where the selected criteria is located on each page. Most reports will have only one report page definition based on the spool file name and *DEFAULT for the type. This means that there is typically a 1:1 correlation between the AS/400 report and a report page definition. 99.9% of the time each report will only have a single report page definition. In some situations where reports have a generic spool file name such as QPRINT or QSYSPRT, it may be necessary to specify the type field based on the program name that created the report or based on a user data, form type or job name value. Note: The RPTSAMPLE page definition already exists and will be used for the upcoming samples you will be running. Simply review the report page definition to understand how it works. Displaying the Report Page Definitions for the RJS Sample Report Sign on to the AS/400 system and add the RJSSPLIT library to your library list by using the following AS/400 command: ADDLIBLE RJSSPLIT. Next type: GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter main menu. Take Option 20. (Edit Report Page Definitions). The Edit Report Definitions screen will be displayed.

16 15 AS/400 Report Splitter V4.08 Edit Report Page Definitions Screen Select option 5 to display one of the sample report page definitions. Report Page Definition Detail In our example above, there are two fields defined for the selected - This field grabs the sales rep from each page at line 3, columns field can be

17 AS/400 Report Splitter 16 used on the Edit Report Distribution Setting screen to create a report distribution - This field grabs the sales manager from each page at line 1, columns 7-9. field can be used on the Edit Report Distribution Settings screen to create a report distribution setting. Note: Every report must have at least one Report Page Definition created before it can be split. If you are simply duplicating a report with the *NOSPLIT option, you do not have to define and criteria fields, but the report page definition must still be created Manually Splitting your First Report Let's begin by manually splitting an entire report to make sure the Report Splitter works correctly. Sign on to the AS/400 system and add the RJSSPLIT library to your library list by using the following AS/400 command: ADDLIBLE RJSSPLIT. Next type: GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter main menu. Take Option 4. (Generate Report Splitter Sample AS/400 Report) and select an output queue where you would like the sample report to be generated. Press Enter to generate the sample report. Take Option 10. (Work with Report Splitter) and select the output queue that contains the sample report you just created. Once the output queue name has been entered, press Enter and the Work with Report Splitter selection screen will be displayed.

18 17 AS/400 Report Splitter V4.08 Work with Report Splitter Report Selection Place a 13 next to the sample report you want to split. Press Enter and the Report Splitter Parameter Selection prompt will be displayed. Report Splitter Parameter Selection Screen for *NOSPLIT Enter the following parameters to split an entire report. The parameters will be explained in more detail in the reference section:

19 AS/400 Report Splitter 18 Split Option- *NOSPLIT Destination output queue/library - A destination output queue where the selected report will be duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue. Congratulations, you've just split your first report Manually Splitting a Report by Page Range This option will split a report based on a specific selected page range. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for *PAGERANGE Enter the following parameters to split the report by page range. The parameters will be explained in more detail in the reference section: Split Option - *PAGERANGE Page range: 1-5 Destination output queue/library - A destination output queue where the selected report will be

20 19 AS/400 Report Splitter V4.08 duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue Manually Decollating a Report Each Time Criteria Changes This option will split a single report into multiple reports every time a selected value within the report changes. The reports are split into the same output queue and the user data field for the reports will be set with the criteria for each report section. This allows the resulting reports to be easily distributed with the RJS Report Server, Batch Report Server, Domino Report Server, etc. The Report Server and other products can utilize the user data values to determine where to distribute the resulting reports. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for *DECOLLATE Enter the following parameters to split the report into a new report every time the first field in the Report Page Definition changes. The parameters will be explained in more detail in the reference section: Split Option - *DECOLLATE Destination output queue/library - A destination output queue where the selected report will be duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output

21 AS/400 Report Splitter 20 queue Manually Distributing an Entire Report if Selected Criteria Found This option will scan the selected column range for a specified search string within the first 100 lines of the report. If the selected string is found, the entire report will be duplicated and sent to the selected output queue. The search strings are CASE sensitive. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for *SCANHDR

22 21 AS/400 Report Splitter V4.08 Report Splitter Parameter Selection Screen 2 for *SCANHDR Enter the following parameters to search and distribute the entire report if the selected search string is found within the first 100 report lines. The parameters will be explained in more detail in the reference section: Split option - *SCANHDR Selection criteria - Rep: 100 Destination output queue/library - Enter a destination output queue where the selected report will be duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue Manually Distributing a Selected Section of a Report This option will scan the selected page for a selected criteria value. All pages containing the criteria will be split into a new report and delivered to the selected output queue(s). Note: When scanning for selected criteria, the criteria must be found on each page that will be split within a report or the Fill option must be enabled on the report page definition for the selected fields. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below.

23 AS/400 Report Splitter 22 Report Splitter Parameter Selection Screen for Selected Criteria Report Splitter Parameter Selection Screen 2 for Selected Criteria Enter the following parameters to search and distribute the selection section of a report. The parameters will be explained in more detail in the reference section: The parameters will be explained in more detail in the reference section:

24 23 AS/400 Report Splitter V4.08 Split option - *SELECT Selection criteria = "100" Destination output queue/library - Enter a destination output queue where the selected report will be duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue Manually Distributing the Last Page of a Report This option will distribute only the last page of the selected report. The last report page will be split into a new report and delivered to the selected output queue(s). This is a great way to deliver total pages to a manager or other employee/customer who doesn't need to see an entire report. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for *LASTPAGE Enter the following parameters to search and distribute the selection section of a report. The parameters will be explained in more detail in the reference section: The parameters will be explained in more detail in the reference section: Split option - *LASTPAGE

25 AS/400 Report Splitter 24 Destination output queue/library - Enter a destination output queue where the selected report will be duplicated. After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue Setting up Report Distribution Criteria Entries See the chapter on Entering Report Distribution Criteria Settings. There are a default set of entries already created for the RPTSAMPLE report. Introduction to Entering Report Distribution Criteria Settings Manually Splitting a Report using Report Distribution Criteria Table Manually Splitting a Report using Report Distribution Criteria Table This option will distribute a report based on pre-defined report distribution table settings. Up to 99,999 different recipients can be specified for a single report in the report distribution table. When this option is selected, all criteria, including the destination output queue(s) are selected from the report distribution table. When automating the AS/400 Report Splitter processing, you will most likely be using the report distribution criteria Table to hold all report distribution settings. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for *TABLE Enter the following parameters to use the pre-defined report distribution table settings to distribute a report. The parameters will be explained in more detail in the reference section:

26 25 AS/400 Report Splitter V4.08 The parameters will be explained in more detail in the reference section: Split option - *TABLE After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue(s) based on the report distribution setting table. Note: Remember that when creating Report Distribution Criteria entries, the distribution criteria information from the settings table are selected based on spool file name. Note: The sample entries created for RPTSAMPLE all point to output queue QPRINT in library QGPL. You can change this if necessary by editing the report distribution settings Manually Distributing a Report and Embedding an Address This option will distribute an entire report and will create a cover page with an address on it. This is a nice way to split and a report to someone via the WinSpool/400 Report Server or Report Server/400 software. The WinSpool/400 Report Server and Report Server/400 products also include additional methods for manually mailing an entire report. Go to the Work with Report Splitter screen and select the sample report for splitting. The Report Splitter Parameter Selection screen will be displayed as shown below. Report Splitter Parameter Selection Screen for Embedding Address Enter the parameters as shown to send out the entire report to the selected output queue. Make sure the output queue is a queue that will be monitored by the WinSpool/400 Report Server or Report Server/400 software.

27 AS/400 Report Splitter 26 Press F11 to display the Cover Page Screen. Enter the cover page info as follows. You can use your own addresses instead of the sample ones we used. All 5 lines can have a MAILTO: keyword if necessary. Our example only uses a single MAILTO: line. Cover Page Creation After typing the report information, press Enter to split the report. Once the report splitter completes, the new report(s) should now exist in the selected destination output queue. They are ready to be processed by the RJS Report Server/400 or WinSpool/400 Report Server software Automatically Splitting Reports using Output Queue Monitor When you're ready to start splitting reports automatically for the first time using the Output Queue Monitor, do the following: Create all the reports you want to split into a selected output queue. For this example, we will assume that all of our nightly reports are placed in an output queue called: REPORTS in library QGPL. Run the following AS/400 command interactively or submit it to batch to run the Output Queue Monitor one time. Once you get comfortable with the concept of using the output queue monitor to process reports, you can set the command up in an AS/400 job scheduler or as part of your nightly processing. RPTMON FILE(*TABLE) SPLFOPT(*MARK) OUTQ(QGPL/REPORTS) DELAY(*ONCE) When the command completes, all reports from the REPORTS output queue should be processed and marked as *SENT in the user data field. The SPLFOPT parameter can also be used to move the reports to another output queue after being processed or delete them.

28 27 AS/400 Report Splitter V Embedding Report Splitter Command in User Written Program By including the AS/400 Report Splitter command within an existing CL program, AS/400 reports can be automatically distributed to users on the AS/400 as soon as they're created on the system. This prevents special intervention to manually distribute a report to an AS/400 user Running the Report Splitter in a CL Job Stream If a job stream is to be set up where the Report Splitter is run right after a new report spool file has been created, you can include a call to the Report Splitter command right after the report creation program. Once the report program has completed, the report will be automatically distributed to the selected destinations. Following is an example of including the Report Splitter command in a CL report creation job stream and distributing the report using the Report Distribution Table criteria. Note: Always use the RPTNUM command to retrieve the original spool file information prior to processing the report with the Report Splitter command, otherwise the AS/400 Report Splitter may select the incorrect version of the spool file when splitting a report multiple times within the same AS/400 job. Note: You must also make sure to define all the CL return variables for the RPTNUM command or you may get a MCHxxxx error when running the RPTNUM command. Note: You must also make sure to remove all printer overrides with the DLTOVR command before calling the RPTMON or RPTSPLIT commands, otherwise reports may not get routed correctly to the destination output queue CL Sample Program Code This an example of including the Report Splitter command in a CL report creation job stream and distributing the report using the Report Distribution Table criteria. This is a great way to split reports as they are generated. PGM /****************************************************************/ /* DEFINE SPOOL FILE INFORMATION VARIABLES */ /****************************************************************/ DCL VAR(&SPLFNAME) TYPE(*CHAR) LEN(10) DCL VAR(&JOBNAME) TYPE(*CHAR) LEN(10) DCL VAR(&JOBUSER) TYPE(*CHAR) LEN(10) DCL VAR(&JOBNBR) TYPE(*CHAR) LEN(6) DCL VAR(&SPLNBR) TYPE(*CHAR) LEN(4) /****************************************************************/ /* SET UP PRINTER FILE OVERRIDE TO SET USER DATA */ /****************************************************************/ OVRPRTF FILE(RPT100P) USRDTA(SALES) /****************************************************************/ /* PRINT AS/400 REPORT */ /****************************************************************/ CALL PGM(RPT001) /****************************************************************/ /* REMOVE PRINTER OVERRIDE RIGHT AFTER REPORT IS PRINTED */

29 AS/400 Report Splitter 28 /****************************************************************/ DLTOVR FILE(RPT001P) /****************************************************************/ /* RETRIEVE ORIGINAL SPOOL INFORMATION FROM REPORT JUST CREATED*/ /* NOTE: MAKE SURE TO DEFINE ALL RETURN PARAMETERS */ /****************************************************************/ RPTNUM SPLF(RPT001P) JOB(*) SPLNBR(*LAST) + RTNSPLF(&SPLFNAME) RTNJOBNAME(&JOBNAME) + RTNJOBUSER(&JOBUSER) RTNJOBNUM(&JOBNBR) + RTNSPLNUM(&SPLNBR) /****************************************************************/ /* PROCESS ORIGINAL SPOOL FILE WITH THE AS/400 REPORT SPLITTER */ /* USING THE REPORT DISTRIBUTION TABLE */ /****************************************************************/ RPTSPLIT FILE(&SPLFNAME) + JOB(&JOBNBR/&JOBUSER/&JOBNAME) + SPLNBR(&SPLNBR) SPLITOPT(*TABLE) /****************************************************************/ /* DELETE ORIGINAL AS/400 SPOOL FILE AFTER PROCESSING */ /****************************************************************/ DLTSPLF FILE(&SPLFNAME) + JOB(&JOBNBR/&JOBUSER/&JOBNAME) + SPLNBR(&SPLNBR) ENDPGM Creating AS/400 Reports with Unique Spool File Names If you happen to run AS/400 queries or have a lot of reports that get created with QPQUPRFIL, QPRINT or QSYSPRT as the spool file name, the following CL programming technique can be used to ensure your reports get created with a unique spool file name. Creating unique spool file names will insure that the report splitter can process reports correctly. PGM /****************************************************************/ /* CREATE PRINTER OVERRIDE TO CHANGE QUERY SPOOL FILE NAME */ /****************************************************************/ OVRPRTF FILE(QPQUPRFIL) SPLFNAME(SALES01) /****************************************************************/ /* PRINT AS/400 QUERY REPORT */ /****************************************************************/ RUNQRY QRY(QGPL/SALES01) /****************************************************************/ /* REMOVE PRINTER OVERRIDE */ /****************************************************************/

30 29 AS/400 Report Splitter V4.08 DLTOVR FILE(QPQUPRFIL) ENDPGM The AS/400 query defined above will create a spool file named SALES01 when it gets run Merging Multiple Reports into a Single Spool File If you would like to merge multiple spool files into a single report, use the Report Merge (RPTMRG) command What's Next After Getting Started? You should now have the basics down for manually and automatically splitting AS/400 reports and staging them to be ed or archived via other RJS report distribution products. The next few sections are a reference for the Report Splitter menu options and each of the AS/400 commands and available parameters. Your input is also appreciated to help us keep improving our documentation. If there's something you would like to see in future versions of the Online Help, send your comments to: support@rjssoftware.com or give us a call. 1.4 Available Menus Introduction to Available Menus This section gives an overview of the AS/400 Report Splitter Main Menu. AS/400 Report Splitter Main Menu - Options 1-15

31 AS/400 Report Splitter 30 AS/400 Report Splitter Main Menu - Options Getting to the Main Menu Sign on to the AS/400 system and add the RJSSPLIT library to your library list using the following AS/400 command: ADDLIBLE RJSSPLIT. Next type GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter Main Menu Available Options Option 1 Enter AS/400 Report Splitter License Code This menu option is used to enter the AS/400 access code for the AS/400 Report Splitter software. An access code will be provided to you by RJS Software Systems Inc. Option 2 Enter OS/400 Settings This menu option is used to enter OS/400 version specific settings. Enter 82 if using OS/400 V4R2 or enter 88 if using OS/400 V4R3 or later. Option 3 Display Report Splitter Version Info This menu option displays the AS/400 Report Splitter version information data area named: VERSION.

32 31 AS/400 Report Splitter V4.08 Option 4 Generate Report Splitter Sample AS/400 Report - RPTTEST This menu option is used to create the sample spool file report included with the AS/400 Report Splitter. Option 10 Select and Split Reports Interactively This menu option is used to interactively select and split a report from a specific output queue. This is the best way to split AS/400 reports on an ad-hoc basis. Option 11 Run Report Splitter Output Queue Monitor - RPTMON This menu option is used to submit the output queue monitor to batch or run it interactively. The output queue monitor is used to automatically process all the reports from a selected output queue using the Report Distribution Criteria settings. Option 12 Submit Report Splitter Output Queue Monitor to Batch This menu option is used to submit the output queue monitor to batch. The output queue monitor is used to automatically process all the reports from a selected output queue using the Report Distribution Criteria settings. Option 13 Report Splitter Command - RPTSPLIT The Report Splitter command is a CL command used to split AS/400 reports from a user written program. The Report Splitter command can be embedded into a custom CL, RPG or COBOL program to add report splitting to user applications. Option 14 Report Splitter Spool Merge Command - RPTMRG The Report Merge command is a CL command used to merge multiple reports from a selected output queue into a single spool file. The Report Merge command can be run standalone or embedded into a custom CL, RPG or COBOL program to add report merging to user applications. Option 15 Report Splitter Reprint Spool File Utility - RPTREPRINT The Report Reprint command is a CL utility command used to reprint any AS/400 report manually using the selected printer attributes. This command is a utility command provided for the purpose of doing a simple report reprint. Option 20 Edit Report Page Definitions This menu option is used to enter AS/400 Report Page Definitions. Each report requires at least one page definition to be created before the report can be split. Option 21 Edit Report Distribution Settings This menu option is used to enter AS/400 Report Distribution Settings. Report Distribution settings are the selection criteria used when splitting a report into multiple sections for multiple recipients. Option 30 Build Report Splitter Settings Files This menu option is used to build a new set of report splitter setting files if multiple data libraries will be used to store report splitter settings. Option 31 Remove Report Splitter Settings Files This menu option is used to delete a set of report splitter setting files if they are no longer needed. Option 32 Set Report Splitter Debug Setting This menu option is used to enable or disable the AS/400 Report Splitter debug option. Option 33 Run SQL Query Statements This menu option is used to run the RPTSQL command which allows interactive SQL statements to be run to display or update records in any AS/400 data file.

33 AS/400 Report Splitter Entering Report Page Definitions Introduction to Entering Report Page Definitions The report page definition is used every time the selected report is split to determine where criteria fields are located within each report page. Before a report can be split for distribution, a report page definition must be created for the report based on its spool file name. A report page definition tells the report splitter where each of the 10 criteria fields are located on each report page. A report page definition has nothing to do with report distribution selection criteria and how a report is split. The report page definition simply tells the splitter how to read each report page and where the selected criteria is located on each page. Most reports will have only one report page definition based on the spool file name and *DEFAULT for the type. This means that there is typically a 1:1 correlation between the AS/400 report and a report page definition. 99.9% of the time each report will only have a single report page definition. In some situations where reports have a generic spool file name such as QPRINT or QSYSPRT, it may be necessary to specify the type field based on the program name that created the report or based on a user data, form type or job name value. Note: Try to avoid creating multiple page definitions for a single report because it can become confusing very quickly. Edit Report Page Definition Main List Screen Getting to the Report Page Definition Screen Sign on to the AS/400 system and add the RJSSPLIT library to your library list using the following AS/400 command: ADDLIBLE RJSSPLIT

34 33 AS/400 Report Splitter V4.08 Next type GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter Report Main menu. Select option 20 to start the program Function Keys Key F3 F5 F6 F8 ENTER Page Up/Down Function Exit Refresh subfile list Create new record Paste field values on entry screen Accept entry Page through available records Options Available Option Function 2 Edit existing record. 3 Copy existing record. Use F8 on detail screen to paste copied record into a new record. 4 Delete selected record. 5 Display selected record.

35 AS/400 Report Splitter Entry Fields Edit Report Page Definition Detail Entry Screen Page Definition Entry Fields Spool Enter the spool file name for the selected report. The spool file name is the main element used to associate a report page definition with the actual report it will be used with when splitting. Type Enter the spool file type for the selected report. The spool file type helps the report splitter processing to determine which report page definition to use when processing. Any text value can be entered into the type field, however the text value should correspond to one of the following spool file fields. 99.9% of the time we recommend entering *DEFAULT for the type since most reports will only require a single report page definition to define the available criteria fields for splitting.

36 35 AS/400 Report Splitter V4.08 Setting *DEFAULT Program Name Result This entry should be used for 99.9% of all reports set up. Entering *DEFAULT is the equivalent of saying that the selected spool file name only has one page definition defined for it and the same page definition and field names will be used each time the report is split. This is the easiest situation to use and understand. Enter the program name of the RPG or COBOL program that created the selected report if you want to use the spool file name and program name to determine which report page definition to use when splitting the report. Example: Let's say several of your reports are created with the same spool file name such as: QSYSPRT. The only way to tell the reports apart is by specifying the program name value for the type value. In our example here, we'll assume the RPG program that created our report was: RPT100R. When creating the report page definition we would enter QSYSPRT as the spool file name and RPT100R as the type. When splitting the report with the RPTSPLIT command, we would specify *SPOOL for the report page definition and *PGM or *ALL for the type. The splitter would then look for a report page definition based on Spool file name/type: QSYSPRT/RPT100R. If a match was not found for the spool file/program name combination, the splitter would next look for a default report page definition based on spool file only: QSYSPRT/*DEFAULT. Note: As mentioned previously, you should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. User Data Enter the user data value for the selected report if you want to use the spool file name and user data value to determine which report page definition to use when splitting the report. Example: Let's say several of your reports are created with the same spool file name such as: QSYSPRT. The only way to tell the reports apart is by specifying the user data value for the type value. In our example here, we'll assume the report was created with a user data value of: STORE100 When creating the report page definition we would enter QSYSPRT as the spool file name and STORE100 as the type. When splitting the report with the RPTSPLIT command, we would specify *SPOOL for the report page definition and *USERDATA or *ALL for the type. The splitter would then look for a report page definition based on Spool file name/type: QSYSPRT/STORE100. If a match was not found for the spool/user data combination, the splitter would next look for a default report page definition based on spool file only: QSYSPRT/*DEFAULT. Note: As mentioned previously, you should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. Form Type Enter the form type value for the selected report if you want to use the spool file name and form type to determine which report page definition to use when splitting the report.

37 AS/400 Report Splitter 36 Enabled This setting determines whether the selected report page definition can be used during report splitter processing. Setting N Y Result Enable this report page definition. Disable this report page definition. Page Definition Description Enter a text description that defines this report page definition. This field is not required. It is for information purposes only. Field Definition(s) - Up to 10 Criteria Fields can be defined for each report Page Line This entry field describes the page line from which the selected criteria field will be extracted. Page Beginning Column This entry field describes the beginning page column from which the selected criteria field will be extracted. Page Ending Column This entry field describes the ending page column from which the selected criteria field will be extracted. Field Description Enter a text description that defines this page definition field. This field is not required. It is for informational purposes only and is used to describe the criteria field. Symbolic Field Name This setting determines the field name that will be assigned to the selected criteria at the specified page line and column position. The symbolic field names must be used when entering report selection criteria in the Edit Report Distribution Settings screen or when a report is being split via the report splitter command. When assigning symbolic field names, use meaningful names @DEPT, etc. Fill This setting determines whether a criteria value will be automatically filled in with the previous page criteria values when the value is blank during processing. Example with Fill Enabled: If the fill setting is enabled and you have a report where the first page contains rep 100, the second and third pages contain blanks for the rep and the fourth page contains rep 200, the rep will automatically be set to rep 100 for pages two and three. If the selection criteria happens to be for rep 100, pages 1-3 will be selected for splitter processing. Example with Fill Disabled: If the fill setting is not enabled and you have a report where the first page contains rep 100, the second and third pages contain blanks for the rep and the fourth page contains rep 200, the rep will not be automatically set for pages two and three. If the selection criteria happens to be for rep 100, page one will be selected for splitter processing. Pages two and three will be omitted because the rep field is blank. Only page one will be selected during the splitter processing.

38 37 AS/400 Report Splitter V4.08 Setting N Y Result The fill option is not activated. The fill option is activated. Activated This setting determines whether the selected criteria field will be used during report splitter processing. Setting N Y Result The selected field entry is not activated and will not be extracted during report splitter processing. This field will not be available for query selection when splitting a report. The selected field entry is activated and will be extracted during report splitter processing. This field will be available for query selection when splitting a report. 1.6 Entering Report Distribution Settings Introduction to Entering Report Distribution Criteria Settings This section gives an overview of entering Report Distribution Criteria for selected reports. The Report Distribution Criteria settings are used to automate report distribution processing. The Report Distribution Table stores frequently used Report Splitter selection criteria. Once an entry has been made in the distribution table, it can be re-used anytime the Report Splitter command is run with *TABLE entered for the split option.the table can hold up to 99,999 table entries for each spool file name. The report distribution criteria table is also automatically used when the output queue monitor (RPTMON) is used to process reports. Report Distribution Settings are based on spool file name and an optional spool file group name.

39 AS/400 Report Splitter 38 Edit Report Distribution Settings Main List Screen Getting to the Report Distribution Setting Screen Sign on to the AS/400 system and add the RJSSPLIT library to your library list using the following AS/400 command: ADDLIBLE RJSSPLIT Next type GO RJSSPLIT and press Enter. This will take you to the AS/400 Report Splitter Report Main menu. Select option 21 to start the program Function Keys Key F3 F5 F6 F8 ENTER Page Up/Down Function Exit Refresh subfile list Create new record Paste field values on entry screen Accept entry Page through available records

40 39 AS/400 Report Splitter V Options Available Option Function 2 Edit existing record. 3 Copy existing record. Use F8 on detail screen to paste copied record into a new record. 4 Delete selected record. 5 Display selected record Entry Fields Report Distribution Criteria Detail Entry Screen 1 Spool Enter the spool file name for the selected report for which you will be entering criteria. Spool File Group The spool file distribution group is a nice way to separate settings that will be used on a daily basis or monthly basis, etc. By default, all entries are assigned to a spool file group of: *DEFAULT. Example: You could create a group named DAILY for daily reports or MONTHLY for month-end reports. Each group could have different report recipients specified. The spool file group would then be specified when the RPTSPLIT command is run to split a report or when the output queue monitor (RPTMON) is run to automatically split reports.

41 AS/400 Report Splitter 40 Note: If you're not sure how this setting will benefit your company, simply leave the spool file group field value set to *DEFAULT when you create new report distribution entries. Spool File Sequence Number An arbitrary sequence number is automatically assigned to each report distribution setting. Activated This setting determines whether the report distribution criteria setting is activated for report splitter processing. Setting N Y Result The distribution criteria entry is not activated. The distribution criteria entry is activated and will be used. Entry Description This parameter can be used to enter a meaningful text description for the specified criteria entry. The description if for informational purposes only. Destination Output Queue/Library The destination output queue can be any existing output queue on the local system. Remote TCP/IP output queues can also be created to route reports to other AS/400 systems. Destination User Identifier/Address The destination user identifier can be any valid user id that exists in the AS/400 system directory. Use the WRKDIR or WRKDIRE command to set up users in the AS/400 system directory. This value is only used if running QSNADS on the AS/400 system. Split Option This setting determines how a report is split

42 41 AS/400 Report Splitter V4.08 Setting *NOSPLIT *DECOLLATE *SELECT *PAGERANGE *LASTPAGE *SCANHDR *TABLE Result Reprints the entire report. This is a great way to duplicate an entire report to multiple recipients. Decollates the entire spool file to a single output queue and splits the report into multiple report sections. A new section is created each time the selected criteria field changes. The criteria value is placed into the user data field, so the reports can be uniquely identified. This is a good way to break up a sales report or any other report into multiple sections every time the selected criteria changes. Report pages are selected for reprinting based on the boolean selection criteria entered. The Report Splitter queries the selected fields based on the symbolic field names set in the report page definition. All selected pages are assembled and placed into a single new spool file. Pages can also be re-sorted during splitter processing. Reprints a selected page range. This is a good way to split up a report between multiple printers for printing or reprint selected page numbers. Distributes the last page of a report. Scans the first 100 lines of a report for the selected report criteria text value specified. If the substring is found anywhere within the first 100 lines of the report, the entire report will be reprinted. Splits the selected report based on the criteria data specified in the report distribution table. Any of the split options above can be specified when entries are added to the report distribution criteria table. Completion Message This parameter is not currently being used by the AS/400 Report Splitter software. Audit Trail This parameter is not currently being used by the AS/400 Report Splitter software. Use Extended Select If this option is enabled, reports will be selectively processed by using any combination of spool file name, user data, user id, job name, form type or the AS/400 program name as a filter to determine if the selected report will be processed. If this option is enabled and a report is found that does not match one or more of these entries, the report will not be processed by the report splitter. Setting N Y Result Select all reports. Use extended report selection filtering. PGM - Program That Created Spool File Because it is possible for many different report programs to use the same spool file name (Example: QPRINT,QSYSPRT, etc), this parameter is used to differentiate the spool file entries by program name. When a spool file is generated, it contains the program name that created it. The Report Splitter can filter and select spool file entries by the program name. The valid values for this field are *ANY, or the actual program name that created the spool file. This parameter must be entered, so *ANY should be used as a default entry if a spool file is not shared by more than one program. If the program name doesn't match the spool file program name or *ANY, the report distribution criteria entry will not by used to process the report. The report splitter will move on to the next criteria entry.

43 AS/400 Report Splitter 42 Use the WRKOUTQ or WRKSPLF command Option 8 to view the program name that created a spool file. Job If the job name entry is specified, the spool file job name will be checked before the report distribution criteria will be used for processing a particular report. This parameter can be a good way to filter spool file selections for the selected report by job name. It's essentially a report filter by AS/400 job name. If the job name doesn't match the spool file job name, the report distribution criteria entry will not by used to process the report. The report splitter will move on to the next criteria entry. Form If the form type entry is specified, the spool file form type will be checked before the report distribution criteria will be used for processing a particular report. This parameter can be a good way to filter spool file selections for the selected report by form type. It's essentially a report filter by AS/400 form type. If the form type doesn't match the spool file form type, the report distribution criteria entry will not by used to process the report. The report splitter will move on to the next criteria entry. User Data If the user data entry is specified, the spool file user data will be checked before the report distribution criteria will be used for processing a particular report. This parameter can be a good way to filter spool file selections for the selected report by user data. It's essentially a report filter by user data. If the user data value doesn't match the spool file user data, the report distribution criteria entry will not by used to process the report. The report splitter will move on to the next criteria entry. User ID If the user ID entry is specified, the spool file user ID will be checked before the report distribution criteria will be used for processing a particular report. This parameter can be a good way to filter spool file selections for the selected report by user ID. It's essentially a report filter by AS/400 user ID. If the user ID value doesn't match the spool file user ID, the report distribution criteria entry will not by used to process the report. The report splitter will move on to the next criteria entry. New Form Type This parameter is used to assign the selected form type to the new report created when the selected report is processed. New User Data This parameter is used to assign the selected user data to the new report created when the selected report is processed. New Copies This parameter is used to assign the selected number of print copies to the new report created when the selected report is processed. New Save Status This parameter is used to assign a new save status to the new report created when the selected report is processed. New Output Priority This parameter is used to assign a new output priority to the new report created when the selected report is processed. New Align Page

44 43 AS/400 Report Splitter V4.08 This parameter is used to assign a new align page status to the new report created when the selected report is processed. New Spool File Name This parameter is used to assign a new spool file name to the new report created when the selected report is processed. is entered for the new spool file name, the splitter will automatically create the spool file name as follows when splitting the reports with the *DECOLLATE option. Example: Original spool file name QSYSPRT. Report contains sales rep: 100 and 200. is entered for the new spool file name, each spool file name will be created as follows: R100 and R200. All spool file names must start with a character, so the first character is always 'R'. New Hold Status This parameter is used to assign a new hold status to the new report created when the selected report is processed. New Text This parameter is used to assign a new print text value to the new report created when the selected report is processed. The print text is a 30-character line of text that can be printer across the bottom of each report page. New Print Text This parameter is used to determine whether the specified print text is printed on the new report created when the selected report is processed. New IBM File Separator This parameter is used to assign a new IBM file separator value to the new report created when the selected report is processed. The IBM file separator is a banner page, which prints information about the job that created a spool file. Note: The Report Splitter banner page is more appropriate if you want to create a banner page. The Report Splitter banner page lets you assign up to 5 lines of text to be printed on a report cover page. New Beginning Page This parameter is used to determine the new beginning page range assigned to the new report created when the selected report is processed. Note: Under normal circumstances, the *PAGERANGE option should be used instead of this option which assigns the new page range directly to a spool file. The only time this option should be used is if an entire report is reprinted and you want to assign a page range directly to the spool file. New Ending Page This parameter is used to determine the new ending page range assigned to the new report created when the selected report is processed. Note: Under normal circumstances, the *PAGERANGE option should be used instead of this option which assigns the new page range directly to a spool file. The only time this option should be used is if an entire report is reprinted and you want to assign a page range directly to the spool file. New Dev This setting can be used to set the printer device type for the OVRPRTF command used during

45 AS/400 Report Splitter 44 reprinting. Setting Blank *SCS *AFPDS *USERASCII Result No change from original spool file. SCS text report AFP report. User ASCII Report New Front Overlay/Library This setting can be used to set the front overlay parameter for the OVRPRTF command used during reprinting. This will apply an AFP overlay automatically when a report is reprinted. This is a nice way to turn regular text reports into AFP documents. New Front Overlay/Library This setting can be used to set the back overlay parameter for the OVRPRTF command used during reprinting. This will apply an AFP overlay automatically when a report is reprinted. This is a nice way to turn regular text reports into AFP documents. Index Field Group This parameter is not currently being used by the AS/400 Report Splitter software. Report Distribution Criteria Detail Entry Screen 2 Banner Text Enter the text to be printed on the banner page when he selected report is split and a banner page is to be printed. If printing a banner page, the banner page will be printed at the beginning of each report section when the report is reprinted. The banner page can be utilized to embed addresses within a report using the MAILTO: keyword. The MAILTO: keyword can be used by the RJS Report Server products to assign addresses to a report without changing the actual report programming. Banner

46 45 AS/400 Report Splitter V4.08 pages are also a nice way to place a custom message at the beginning of a report. Example hard coded address: MAILTO: test@rjssoft.com Example with two addresses hard coded: MAILTO: test@rjssoft.com;test2@rjssoft.com~ Symbolic field values can also be substituted into the cover page during the splitting process. Example: If you have a symbolic field name defined in your report page definition and you specify: Rep for any of the banner page value(s), the cover page value would look as follows after the new spool file is created for rep 100: Rep Number: 100 Example: Let's say you printed an address inside the report and wanted to assign the address into the banner page text, you might key something like the following entry for the banner page text value: This sample entry assumes that the report page definition has a symbolic field defined to extract the address from the report when split. The resulting cover page value may look like the following: MAILTO: addr@domain.com When using the *DECOLLATEsplit option, the symbolic fields can be a great way to assign unique information to the banner page from within the first page of each report section. Print Banner This setting determines if the report banner page will be printed when a report is split. Setting N Y Result Do not print a banner page. Enable printing of the banner page. New User Defined Data This parameter is used to assign the selected user defined data value to the new report created when the selected report is processed. The used defined data field can be useful to assign addresses for the RJS Report Server products. This field can also be used by user applications as well. Symbolic field values can be substituted into the cover page during the splitting process. Example: If you have a symbolic field name defined in your report page definition and you specify: Rep for the user defined data value, the user defined data value would look as follows after the new spool file is created for rep 100: Rep Number: 100 Example: Let's say you printed an address inside the report and wanted to assign the address into the user defined data field, you might place something like the following entry for the new user defined data: This sample entry assumes that the report page definition has a symbolic field defined to extract the address from the report when split. The resulting value may look like the following: MAILTO: addr@domain.com

47 AS/400 Report Splitter 46 Report Distribution Criteria Detail Entry Screen 3 Report Selection Criteria This screen is used to enter boolean search criteria to determine which pages will be included during the report splitting process. The report page definition should be checked to determine which symbolic field names can be used on this screen. Note: Always use double-quotes (") to delimit the criteria values. Special keyword fields - Total number of pahges in the - Current page number. Example for selecting a single sales = "300" Example for selecting a list of multiple sales = "300" = "100" = "400" Example for selecting a range of sales >= "100" <= "400" Example for selecting a single sales rep for sales manager = "100" = "001" Example for selecting the last report Example for selecting last two pages of the >= (@PAGECOUNT - 2)

48 47 AS/400 Report Splitter V4.08 Example for selecting all except the last page of the <= - 1) Example for selecting all except the last two pages of the <= - 2) 1.7 AS/400 Commands Introduction to AS/400 Commands This section gives an overview of the AS/400 Report Splitter commands RPTSPLIT: AS/400 Report Splitter Command Description The RPTSPLIT command is the low-level API that gets called to split reports. The RPTSPLIT command is called automatically from the output queue monitor when automatically splitting reports. The RPTSPLIT command can also be utilized by user applications to split reports. This command is also called from the WRKSPLIT report selection screen when option 13 is selected to interactively split a report. Report Splitter Command - RPTSPLIT Command Parameters Spool File Name Enter the selected AS/400 spool file name. This information can be determined by using the WRKOUTQ command to display a report list. Job Name/User Name/Job Number

49 AS/400 Report Splitter 48 Enter the selected spool file job name, user name and job number. This information can be determined by using the WRKOUTQ command to display a report list. Spool File Number Enter the selected spool file number. This information can be determined by using the WRKOUTQ command to display a report list. Other valid values are *ONLY and *LAST. *ONLY will select the spool file if it's the only spool file in the selected job. *LAST will select the most recent spool file in the selected job. Report Definition Name This setting determines which report page definition is used to extract criteria fields from the selected report. If *SPOOL is selected, the report page definition will be selected based on the spool file name and the selected type on the next parameter. Default value = *SPOOL Report Definition Type This setting determines which report page definition type is used to extract criteria fields from the selected report. Default value = *ALL

50 49 AS/400 Report Splitter V4.08 Setting *ALL Result When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/program name. If not found, it will look for a report page definition based on spool file name/user data. If not found, it will look for a report page definition based on spool file name/form type. If not found, it will look for a report page definition based on spool file name/job name. If not found, it will look for the default report page definition based on spool file name/*default. *PGM Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/program name. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. *USERDATA When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/user data. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. *FORMTYPE When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/form type. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the

51 AS/400 Report Splitter 50 Report split option Setting *NOSPLIT *DECOLLATE *SELECT *PAGERANGE *LASTPAGE *SCANHDR *TABLE Result Reprints the entire report. This is a great way to duplicate an entire report to multiple recipients. Decollates the entire spool file to a single output queue and splits the report into multiple report sections. A new section is created each time the selected criteria field changes. The criteria value is placed into the user data field, so the reports can be uniquely identified. This is a good way to break up a sales report or any other report into multiple sections every time the selected criteria changes. Report pages are selected for reprinting based on the boolean selection criteria entered. The Report Splitter queries the fields based on the symbolic field names set in the report page definition. All selected pages are assembled and placed into a single new spool file. Pages can also be re-sorted during splitter processing. Reprints a selected page range. This is a good way to split up a report between multiple printers for printing. Distributes the last page of a report. Scans the first 100 lines of a report for the selected report criteria text value specified. If the substring is found anywhere within the first 100 lines of the report, the entire report will be reprinted. Splits the selected report based on the criteria data specified in the report distribution table.any of the split options above can be specified when entries are added to the report distribution criteria table. Report selection criteria This screen is used to enter boolean search criteria to determine which pages will be included during the report splitting process. The report page definition should be checked to determine which symbolic field names can be used on this screen. Note: Always use double-quotes (") to delimit the criteria values. Special keyword fields - Total number of pahges in the - Current page number. Example for selecting a single sales = "300" Example for selecting a list of multiple sales = "300" = "100" = "400" Example for selecting a range of sales >= "100" <= "400" Example for selecting a single sales rep for sales manager = "100" = "001" Example for selecting the last report

52 51 AS/400 Report Splitter V4.08 Example for selecting last two pages of the >= - 2) Example for selecting all except the last page of the <= - 1) Example for selecting all except the last two pages of the <= - 2) Starting page If *PAGERANGE is selected on the beginning compare data parameter, this is the first page which will be reprinted. Ending page If *PAGERANGE is selected on the ending compare data parameter, this is the last page which will be reprinted. Up to 9,999,999 pages can be selected. Destination Output Queue Destination output queue can be any existing output queue on the local system. Up to ten destination output queues can be selected. If *TABLE is selected for the beginning compare data selection, this field will not be displayed on the RPTSPLIT command prompt because all information will be selected from the Report Distribution Table. Destination User Identifier The destination user identifier can be any valid SNADS user ID that exists in the AS/400 system directory. Up to ten destination user identifiers can be selected. Most companies will not use SNADS unless they have multiple interconnected AS/400 systems where reports will be sent. If *TABLE is selected for the spool file run option selection, this field will not be displayed on the command prompt and the destination user identifier will be determined based on the settings within the Report Distribution Table. Use the WRKDIR or WRKDIRE command to set up users in the AS/400 system directory. New User Defined Data This parameter is used to assign the selected user defined data value to the new report created when the selected report is processed. The used defined data field can be useful to assign addresses for the RJS Report Server products. This field can also be used by user applications as well. Symbolic field values can be substituted into the cover page during the splitting process. Example: If you have a symbolic field name defined in your report page definition and you specify: Rep for the user defined data value, the user defined data value would look as follows after the new spool file is created for rep 100: Rep Number: 100 Example: Let's say you printed an address inside the report and wanted to assign the address into the user defined data field, you might place something like the following entry for the new user defined data: This sample entry assumes that the report page definition has a symbolic field defined to extract the address from the report when split. The resulting value may look like the following: MAILTO: addr@domain.com New Spool File Name This parameter is used to assign a new spool file name to the new report created when the selected

53 AS/400 Report Splitter 52 report is processed. is entered for the new spool file name, the splitter will automatically create the spool file name as follows when splitting the reports with the *DECOLLATE option. Example: Original spool file name QSYSPRT. Report contains sales rep: 100 and 200. is entered for the new spool file name, each spool file name will be created as follows: R100 and R200. All spool file names must start with a character, so the first character is always 'R'. New User Data This parameter is used to assign the selected user data to the new report created when the selected report is processed. New Form Type This parameter is used to assign the selected form type to the new report created when the selected report is processed. Print Banner This setting determines if the report banner page will be printed when a report is split. Setting *NO *YES Result Do not print a banner page. Enable printing of the banner page. Banner Text Enter the text to be printed on the banner page when he selected report is split and a banner page is to be printed. If printing a banner page, the banner page will be printed at the beginning of each report section when the report is reprinted. The banner page can be utilized to embed addresses within a report using the MAILTO: keyword. The MAILTO: keyword can be used by the RJS Report Server products to assign addresses to a report without changing the actual report programming. Banner pages are also a nice way to place a custom message at the beginning of a report. Example hard coded address: MAILTO: test@rjssoft.com Example with two addresses hard coded: MAILTO: test@rjssoft.com;test2@rjssoft.com~ Symbolic field values can also be substituted into the cover page during the splitting process. Example: If you have a symbolic field name defined in your report page definition and you specify: Rep for any of the banner page value(s), the cover page value would look as follows after the new spool file is created for rep 100: Rep Number: 100 Example: Let's say you printed an address inside the report and wanted to assign the address into the banner page text, you might key something like the following entry for the banner page text value: This sample entry assumes that the report page definition has a symbolic field defined to extract the address from the report when split. The resulting cover page value may look like the following: MAILTO: addr@domain.com When using the *DECOLLATEsplit option, the symbolic fields can be a great way to assign unique information to the banner page from within the first page of each report section. Spool File Distribution Group

54 53 AS/400 Report Splitter V4.08 Spool file distribution group is used to select a Report Distribution Group from the Report Distribution Table when *TABLE is specified for the beginning compare data selection. If this entry is left blank, all entries in the Report Distribution Table that correspond to the selected spool file will be processed. Validate Directory Entries If SNADS users are specified as report recipients, this setting determines whether the AS/400 system directory is checked before reports are split. Setting *NO *YES Result The system directory is not checked. The system directory is checked RPTMON: Report Splitter Output Queue Monitor Description The Output Queue Monitor is used to automatically monitor for new reports to split. This command can be run interactively or can be submitted to batch. Typically this option should be submitted to batch to run in job queue QBATCH or QSYSYNOMAX which is part of the QSYSWRK subsystem. Submitting the job to QSYSNOMAX allows the output queue monitor to run along with other AS/400 server jobs. Example Output Queue Monitor command being submitted to batch to run once: SBMJOB CMD(RPTMON OUTQ(QGPL/REPORTS) SPLFOPT(*MARK) DELAY(*ONCE) GROUP(*DEFAULT)) JOB(RPTMON) Example Output Queue Monitor command being submitted to batch to run without ending. It will check for new reports every 300 seconds (5 minutes): SBMJOB CMD(RPTMON OUTQ(QGPL/REPORTS) SPLFOPT(*MARK) DELAY(*DELAY) DLYTIM(300) ENDTIME(000000) GROUP(*DEFAULT)) JOB(RPTMON) Example Output Queue Monitor command being submitted to batch to run until 4:00pm. It will check for new reports every 300 seconds (5 minutes): SBMJOB CMD(RPTMON OUTQ(QGPL/REPORTS) SPLFOPT(*MARK) DELAY(*DELAY) DLYTIM(300) ENDTIME(160000) GROUP(*DEFAULT)) JOB(RPTMON) Example Output Queue Monitor command running interactively: RPTMON OUTQ(QGPL/REPORTS) SPLFOPT(*MARK) DELAY(*ONCE) GROUP(*DEFAULT) From the RJSSPLIT menu, take option 11 to run the Output Queue Monitor or option 12 to run in batch.

55 AS/400 Report Splitter 54 Output Queue Monitor - RPTMON Command Parameters Source Output Queue This parameter is used to select the output queue to be monitored. Only one output queue can be monitored per instance of the RPTMON command. Multiple instances of the RPTMON command can be run at the same time to monitor multiple output queues. After Processing Spool Option This parameter is used to handle the source spool file after it has been processed by the output queue monitor. Setting *DELETE *MARK *MOVE *NONE Result The processed spool file is deleted after processing. The processed spool file will be marked with a USRDTA entry of *SENT. The processed spool file will be moved to the output queue specified in the MOVEOUTQ parameter. No action is taken after processing the spool file. Delay Processing or Run Once Either *DELAY or *ONCE can be selected when running the output queue monitor to have it run continuously until a specified time or run only a single time. Delay Between Cycles The delay between cycles parameter tells the output queue monitor how long to wait after each cycle when running in *DELAY mode. The delay time is specified in seconds. The default value is 300 seconds or 5 minutes between each cycle.

56 55 AS/400 Report Splitter V4.08 Time to End Program This parameter is used to specify an ending time when running in *DELAY mode. The end time is based on a 24 hour clock from 00:01:00 23:59:00 (12:00am 11:59pm). The default value is , which will end the monitor at 4:00pm. Note: If you specify , the output queue monitor will never end unless the job is ended via the ENDJOB command. This setting can be used to run the output queue monitor continuously. Move to Output Queue This parameter tells the report monitor the name of an output queue where all processed spool files will be automatically moved if *MOVE is selected for the after processing spool option. A spool file will only be moved if pages are selected for reprinting during the report monitor processing. Spool File Distribution Group This parameter is used to specify a spool file distribution group to use for criteria selection when splitting reports with report monitor. See the Report Splitter command for a definition of the Spool File Distribution Group parameter. The default value is: *DEFAULT. This will process all entries in the *DEFAULT spool file distribution group WRKSPLIT: Work with Report Splitter Description The WRKSPLIT command can be used to manually select and split reports. This command is handy if users will have a need to manually split reports from the AS/400 without running the Output Queue Monitor. This command can be added to user application menus to allow users to access the interactive splitting functionality of the AS/400 Report Splitter software. Work with Report Splitter Command Prompt

57 AS/400 Report Splitter 56 Work with Report Splitter Selection Screen WRKSPLIT Command Parameters Output Queue/Library Type the selected output queue and library name and press Enter to display the report selection screen. After the Report Selection Screen is displayed, place an Option 13 next to any report if you want to split it or Option 5 to display the report. When using Option 13, the interactive Report Splitter Parameter Selection screen will be displayed after selecting the option and pressing Enter.

58 57 AS/400 Report Splitter V4.08 Report Splitter Parameter Selection View 1 Report Splitter Parameter Selection View 2 Function Keys

59 AS/400 Report Splitter 58 Key F3 F4 F6 F8 F9 F10 F11 F14 ENTER Function Exit Prompt the RPTSPLIT command Display completed RPTSPLIT command Submit RPTSPLIT command to batch Display spool file AS/400 command entry screen Display additional parameters (Banner Page Info) Test Report Distribution criteria settings Run RPTSPLIT command on selected report. Screen Selection Parameters for RPTSPLIT Spool File Name Display only. Automatically filled in by user selection. Job Name Display only. Automatically filled in by user selection. User Name Display only. Automatically filled in by user selection. Job Number Display only. Automatically filled in by user selection. Spool File Number Display only. Automatically filled in by user selection. Split Option This setting determines how a report is split

60 59 AS/400 Report Splitter V4.08 Setting *NOSPLIT *DECOLLATE *SELECT *PAGERANGE *LASTPAGE *SCANHDR *TABLE Result Reprints the entire report. This is a great way to duplicate an entire report to multiple recipients. Decollates the entire spool file to a single output queue and splits the report into multiple report sections. A new section is created each time the selected criteria field changes. The criteria value is placed into the user data field, so the reports can be uniquely identified. This is a good way to break up a sales report or any other report into multiple sections every time the selected criteria changes. Report pages are selected for reprinting based on the boolean selection criteria entered. The Report Splitter queries the selected fields based on the symbolic field names set in the report page definition. All selected pages are assembled and placed into a single new spool file. Pages can also be re-sorted during splitter processing. Reprints a selected page range. This is a good way to split up a report between multiple printers for printing or reprint selected page numbers. Distributes the last page of a report. Scans the first 100 lines of a report for the selected report criteria text value specified. If the substring is found anywhere within the first 100 lines of the report, the entire report will be reprinted. Splits the selected report based on the criteria data specified in the report distribution table. Any of the split options above can be specified when entries are added to the report distribution criteria table. Report Definition Name This setting determines which report page definition is used to extract criteria fields from the selected report. If *SPOOL is selected, the report page definition will be selected based on the spool file name and the selected type on the next parameter. Default value = *SPOOL Report Definition Type This setting determines which report page definition type is used to extract criteria fields from the selected report. Default value = *ALL

61 AS/400 Report Splitter 60 Setting *ALL Result When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/program name. If not found, it will look for a report page definition based on spool file name/user data. If not found, it will look for a report page definition based on spool file name/form type. If not found, it will look for a report page definition based on spool file name/job name. If not found, it will look for the default report page definition based on spool file name/*default. *PGM Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/program name. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. *USERDATA When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/user data. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the spool file name only with *DEFAULT as the type. This give a 1:1 correlation between the spool file name and the field extraction information uses during repot splitting. *FORMTYPE When deciding which report page definition to use, the report splitter command (RPTSPLIT) will use the following search order. It will first look for a report page definition based on spool file name/form type. If not found, it will look for the default report page definition based on spool file name/*default. Note: You should try to create 99.9% of all report page definitions based on the

62 61 AS/400 Report Splitter V4.08 Spool File Group This entry determines which spool file group will be used when processing reports. By default the *DEFAULT group will be used. All report distribution criteria entries are automatically assigned to the *DEFAULT group unless otherwise specified. Page Range If *PAGERANGE is selected on the split option parameter, this is the page range which will be reprinted. Destination Output Queue Destination output queue can be any existing output queue on the local system. Up to ten destination output queues can be selected. Note: If *TABLE is selected for the split option, this field will not be used. All destination info will be retrieved from the report distribution criteria setttings. Destination User Identifier The destination user identifier can be any valid SNADS user ID that exists in the AS/400 system directory. Up to ten destination user identifiers can be selected. Most companies will not use SNADS unless they have multiple interconnected AS/400 systems where reports will be sent. Note: If *TABLE is selected for the spool file run option selection, this field will not be used. Use the WRKDIR or WRKDIRE command to set up users in the AS/400 system directory. Submit Job Queue Selected job queue where report will be split if the job is submitted to batch. Submit on Hold Determines whether the job goes on hold when sent to batch. Setting N Y Result Do not submit on hold. Submit job on hold. Must be released from job queue by operator. If Y is chosen, the job will go on hold in the selected job queue if the job is submitted to batch. Print Banner This setting determines if the report banner page will be printed when a report is split. Setting N Y Result Do not print a banner page. Enable printing of the banner page. Banner Text Enter the text to be printed on the banner page when he selected report is split and a banner page is to be printed. If printing a banner page, the banner page will be printed at the beginning of each report section when the report is reprinted. The banner page can be utilized to embed addresses within a report using the MAILTO: keyword. The MAILTO: keyword can be used by the RJS Report Server products to assign addresses to a report without changing the actual report programming. Banner pages are also a nice way to place a custom message at the beginning of a report. Example hard coded address: MAILTO: test@rjssoft.com

63 AS/400 Report Splitter 62 Example with two addresses hard coded: MAILTO: Symbolic field values can also be substituted into the cover page during the splitting process. Example: If you have a symbolic field name defined in your report page definition and you specify: Rep for any of the banner page value(s), the cover page value would look as follows after the new spool file is created for rep 100: Rep Number: 100 Example: Let's say you printed an address inside the report and wanted to assign the address into the banner page text, you might key something like the following entry for the banner page text value: This sample entry assumes that the report page definition has a symbolic field defined to extract the address from the report when split. The resulting cover page value may look like the following: MAILTO: addr@domain.com When using the *DECOLLATEsplit option, the symbolic fields can be a great way to assign unique information to the banner page from within the first page of each report section. Report Selection Criteria This screen is used to enter boolean search criteria to determine which pages will be included during the report splitting process. The report page definition should be checked to determine which symbolic field names can be used on this screen. Note: Always use double-quotes (") to delimit the criteria values. Special keyword fields - Total number of pahges in the - Current page number. Example for selecting a single sales = "300" Example for selecting a list of multiple sales = "300" = "100" = "400" Example for selecting a range of sales >= "100" <= "400" Example for selecting a single sales rep for sales manager = "100" = "001" Example for selecting the last report Example for selecting last two pages of the >= (@PAGECOUNT - 2) Example for selecting all except the last page of the <= (@PAGECOUNT - 1) Example for selecting all except the last two pages of the <= (@PAGECOUNT - 2)

64 63 AS/400 Report Splitter V RPTMRG: Report Splitter Merge Command Description The report merge command is used to merge selected report files within a selected output queue into a single spool file. Some users may want to do this for easier report distribution. Note: All reports in the source output queue must have the same spool file attributes such as page length, width, characters per inch, lines per inch, etc. The attributes from the first spool file selected from the source output queue will be used when creating the new spool file during the merge processing. Report Splitter Merge Command - RPTMRG Command Parameters Source Output Queue This parameter is used to select the source output queue that will be merged into a single spool file. Destination Output Queue The destination output queue can be any existing output queue on the local system. Up to ten destination output queues can be selected. The destination output queue will receive the merged spool file. Destination User Identifier The destination user identifier can be any valid SNADS user id that exists in the AS/400 system directory. Up to ten destination user identifiers can be selected. Most companies will not use SNADS unless they have multiple interconnected AS/400 systems where reports will be sent. Use the WRKDIR or WRKDIRE command to set up users in the AS/400 system directory. Print Banner Page If *YES is selected, a banner page will be printed at the beginning of the report when it is reprinted. If *NO is selected, no banner page will be printed.