Page 3 - PrintSuite for iSeries; Advanced Print Utility; IBM
PrintSuite for iSeries Advanced Print Utility User’s Guide S544-5351-03 IBM
Page 5 - Contents; Part 3. Printing With APU; iii
Contents Figures . . . . . . . . . . . . . . . v Tables . . . . . . . . . . . . . . . vii Purpose of this Publication . . . . . . ix APU Enhancements . . . . . . . . . . . . ix Organization of the Manual . . . . . . . . . ix Part 1. Understanding and Preparingto Use APU . . . . . . . . . . . . . 1 C...
Page 6 - iv
Chapter 6. Automatic Printing with APUMonitor . . . . . . . . . . . . . . 83 Introduction to the APU Monitor . . . . . . . 83 Understanding How the APU Monitor Works . . . 83 An Example of APU Monitor Processing . . . . 84 A Customer Environment. . . . . . . . . 84 Implementing the Customer Requirem...
Page 7 - Figures
Figures 1. Flow of Data Through APU and OS/400 . . . 5 2. APU Data Structure . . . . . . . . . . 6 3. APU Concepts . . . . . . . . . . . . 7 4. Steps to Creating a Document . . . . . . . 8 5. APU main menu panel . . . . . . . . . 10 6. Set APU Defaults panel . . . . . . . . 14 7. Set Print Definitio...
Page 9 - Tables; vii
Tables 1. Field Mapping Values . . . . . . . . . 48 2. Samples in the QAPU Library . . . . . . 101 3. APU Print Engine Processing Phases 103 4. Parameters Passed to the Before InitializationUser Exit . . . . . . . . . . . . . 103 5. Parameters Passed to the Middle User Exit 104 6. Parameters Passed ...
Page 10 - viii
Page 11 - Purpose of this Publication; APU Enhancements; Duplex Printing; Organization of the Manual; Introducing Advanced Print Utility; ix
Purpose of this Publication This publication helps you to use the IBM PrintSuite for iSeries Advanced PrintUtility (APU). It focuses on the concepts of APU, using a series of applicationexamples to demonstrate how APU works. APU has extensive on-line help; we do not duplicate that information here. ...
Page 13 - Part 1. Understanding and Preparing to Use APU
Part 1. Understanding and Preparing to Use APU Chapter 1. Introducing Advanced Print Utility . . 3 What is APU? . . . . . . . . . . . . . . 3 What You Can Do with APU . . . . . . . . . 3 Why Use APU? . . . . . . . . . . . . . 4 Printing with and without APU . . . . . . . . 4 Printing without APU . ....
Page 15 - What You Can Do with APU
Chapter 1. Introducing Advanced Print Utility Use this chapter to gain an understanding of what the IBM PrintSuite for iSeriesAdvanced Print Utility (APU) can do for you, including: v “What is APU?” v “What You Can Do with APU” v “Why Use APU?” on page 4 v “Printing with and without APU” on page 4 v...
Page 16 - Printing with and without APU
Why Use APU? APU assists you in building AFP-compatible electronic output. Effective electronicoutput can provide significant benefits to an organization, particularly in the areasof information systems costs, process reengineering, and better communications,for example: v Replacing preprinted multi...
Page 17 - Printing with APU; The Design Phase
access to the application program source code or no programming skills existin-house to implement changes to output pages or documents. Printing with APU Using APU requires no programming skills, enabling individuals with graphicsand layout ability to design the appearance of the printed page and to...
Page 18 - The Production Phase; APU formatting instructions
The Production Phase With the new print application designed, it is ready to be placed into production.You define the desired production characteristics to APU. These characteristicsinclude how to identify the target spooled file, which print definition to use, whatuser-specific programs should be c...
Page 19 - Steps in Creating an APU Document
as would be done with hard copy multipart forms. You can, for example, suppressthe price on the packing slip and print some inventory control information on thepacking slip as a bar code. When you use APU, each copy can be different. The same data can be printed at adifferent position, and different...
Page 20 - Step 1: Analyzing the Existing Application; Questions you need to Ask; What fonts will you need to produce effective output?; Example of Sample Spooled File (Source Input Data)
Step 1: Analyzing the Existing Application Questions you need to Ask The first step in creating a document is to examine the contents of the currentapplication program that is output by asking these questions: v Is the application currently being printed on preprinted forms? If so, howcomplicated is...
Page 22 - Step 4: Printing with the Print Definition
Initially, you may need to set the APU defaults if they were not previously set. Formore information, see “Initial APU Setup” on page 14. Creating a print definition includes defining page formats and defining copies. Wedescribe these tasks in the sections that follow. Defining Page Formats When you...
Page 23 - option on the APU Main Menu. At this point, the production
After you specify which print definition to apply, APU creates another spooled fileand sends it to the output queue that you select. You will probably need toexperiment some to get the data lined up with the electronic form or to refine theconditional tests that APU performs to select page formats. ...
Page 25 - Chapter 2. Preparing to Use the Advanced Print Utility; APU Prerequisites and Options
Chapter 2. Preparing to Use the Advanced Print Utility Before building your first APU print definition, review the following installationand planning considerations: v “APU Prerequisites and Options” v “Initial APU Setup” on page 14 v “Font Installation Considerations” on page 16 v “Review Document ...
Page 26 - Non-IBM document product tools; Initial APU Setup
of AFP documents, as well as the ability to search, print, and fax what is viewed.In addition, the full AFP Workbench includes the IBM AFP Printer Driver forWindows . Use this standard Windows driver to create overlays and page segments from any Windows application. Non-IBM document product tools , ...
Page 27 - The continuation of the panel is shown in Figure 8 on page 16:
v For the Job description, we recommend that you use QYPUJOBD in the QAPUlibrary. Two additional resource libraries, IMAGES and OVERLAYS, were also selected asdefaults because APU looks in these libraries for document resources, such as pagesegments and overlays. You can specify defaults when you fi...
Page 30 - Using Fonts with APU; on the Define a Copy panel to have the Define Field Mapping
Using Fonts with APU The examples in the remainder of this manual use the fonts in the AFP FontCollection. You should verify that you have these fonts available before goingon. Your results may differ depending on the fonts defined on your system. APU provides an interface that makes selecting fonts...
Page 32 - Outline Fonts; command) before you can take advantage of this
Outline Fonts The current modification level of the APU enables you to download outline fontsto IPDS printers. You must first install the fonts, then update the font database(with the call qapu/qypusync command) before you can take advantage of this technology. Outline fonts are scaleable fonts. A s...
Page 33 - Custom Fonts; A particular font is an organizational standard.
Custom Fonts APU enables you to add special or custom fonts. You might use a custom fontwhen: v A particular font is an organizational standard. v You need a unique font for a specific application. For example, a marketingdocument could require large characters that are not found in the standard fon...
Page 36 - panel. The Select a Page Segment panel appears. This; panel is used to select page segments with APU.
Image Resources Image resources are a key component in creating advanced electronic print andpresentation applications. In some cases, such as with accent images, the purposeis to improve the look and effectiveness of output. Images like logos andsignatures are essential parts of a document. In othe...
Page 37 - , an accent image of a strawberry, for use on the Super Sun Seeds
Based on the library specified, APU retrieves all available page segments. SelectSTRWNB , an accent image of a strawberry, for use on the Super Sun Seeds invoice. The Define Page Segments panel shows the page segment positioning for thiscopy. The Super Sun Seeds logo was not selected for the invoice...
Page 39 - How APU Works with Overlays; panel. The Select an Overlay panel appears.
How APU Works with Overlays APU can place overlays on any page, in virtually any location. APU can placemultiple overlays per page and control the placement of each overlay. APU enablesyou to specify one constant back overlay, that is, print an overlay by itself on apage without data (for example, a...
Page 41 - Building Overlay Resources; Some of the options available include:; Bar Code Resources
Note: When you specify *INPUT for the “Page orientation” field, APU alwaysattempts to create the output in Portrait mode by default. APU attempts toperform rotation according to the values specified for the “Page length” and“Page width” fields. Building Overlay Resources IBM provides many alternativ...
Page 45 - Part 2. Creating Print Definitions with APU
Part 2. Creating Print Definitions with APU Chapter 3. Building an APU Print Definition for aSingle Page Format . . . . . . . . . . . 35 Example of a Single-Page Format Document . . . 35 Example of the SCS File to be Formatted . . . 35 Example of the Formatted File . . . . . . . 36 Setting up a Basi...
Page 48 - Example of the Formatted File; The formatted output that you want to produce is shown in Figure 31.; Setting up a Basic Print Definition
year, on your next seed order you will receive a 10% discount. $90,652.21 2/26/98 $90,652.21 IMPROVED PRINTING CORP PERFORMANCE BOULEVARD PRINTERSVILLE CO 457892637 Example of the Formatted File The formatted output that you want to produce is shown in Figure 31. Setting up a Basic Print Definition ...
Page 49 - Working with a Print Definition; APU displays its main menu, as shown in Figure 32:
Note: The output depends on the fonts that are available on your system. Youroutput may not match the following examples. Working with a Print Definition 1. Type: GO QAPU/APU on the command line of any OS/400 panel. 2. APU displays its main menu, as shown in Figure 32: 3. Select option 1, Work with ...
Page 50 - Further Defining the Print Definition
4. Type 1 in the option column in the first row, then press Enter to create a newprint definition, as shown in Figure 34: 5. Type the name of the Print Definition. Note: Use the TAB key to move from field to field. 6. Type or select the name of the library where you want to store the printdefinition...
Page 52 - Press Enter until the Work with Print Definitions panel displays.; Working with Copies; panel appears, as shown in Figure 39 on page 41:
Press Enter until the Work with Print Definitions panel displays. Working with Copies A page format needs a minimum of one copy. So, your next step is to examine thedefault values that APU has applied to the first, *ORIGINAL copy and make anynecessary changes. 1. Type 12 in the option column in the ...
Page 54 - Page Layout Options You can Set; You can specify the following page layout options:; Setting up Duplexing; Notice that you can specify duplex printing.
v Select Set page layout options to specify the page size, orientation, and margins,as described in “Initial APU Setup” on page 14. v Select Define overlays to name the overlay that you want merged with theapplication data on the page. v Select Define page segments to include the company logo in the...
Page 55 - Restrictions; Defining Page Segments
You need to be aware of the capabilities and limitations of duplex printing:What Duplex Printing Does 1. Type 1 in the duplex printing field if you want simple duplex printing. Theresult will be that all second pages of the copy will be printed on the back sideof the page. Enter a 2 to select tumble...
Page 56 - Defining Overlays
Defining Overlays Select the Define overlays option to name and position the overlay that you wantto use to replace the preprinted form. The Define Overlay Positionings panel isshown in Figure 44: Select option 1 to name a new overlay, then press Enter. Type the name of theoverlay, INVALL, and where...
Page 57 - Mapping Field Data
If you want to use an overlay that is smaller than the page, you can change itslocation using the Position across and Position down fields. Assume that thisoverlay, INVALL, is designed to fill the whole page and should therefore bepositioned at the origin of the paper (0,0). Mapping Field Data Selec...
Page 59 - Mapping a Field as Text
Mapping a Field as Text In this example, select option 1 to map the customer name as text. When you selectMap as Text , the Map Text panel appears, as shown in Figure 48: In this example, you need to map the customer ’s name to print in bold and alarger font. This is the area that uses the HELEVTICA...
Page 60 - When you map a field, the mapping is displayed as follows:; panel appears allowing you to choose which mapping; Using the Repeat Function
When you map a field, the mapping is displayed as follows: Table 1. Field Mapping Values 1s Bar code 2s Text 4s Suppression 1/2s Bar code and text overlapped 1/4s Bar code and suppression overlapped Note: If you want to edit a field you have previously mapped more than once (forexample, mapping both...
Page 61 - The spacing between the repeated mappings (0.167 in this example); Mapping a Field at Multiple Locations; Mapping a Field the First Time
Using the Repeat Text Mapping panel, you can repeat the text mapping youalready defined for a field to other lines in the spooled file. To repeat the mappingyou selected, specify the following on the Repeat Text Mapping panel: v The first row in the spooled file that you want to apply the selected m...
Page 62 - Mapping a Field to a Second Position; Keep pressing Enter to exit.; Multiple Mapping Restrictions
Mapping a Field to a Second Position If you want to place the field at a different position, press the PAGE-DOWN keyto re-display the above window. This time, however, the screen will say “Mapping2/2”: Keep pressing Enter to exit. Multiple Mapping Restrictions The following restrictions apply to the...
Page 63 - Example of a Multiple Page Format Document
Chapter 4. Building an APU Print Definition for Multiple PageFormats This chapter provides you with a detailed procedure you use to develop a printdefinition with APU for a multiple-page format document. Here is a summary ofthe steps described in this chapter: v “Example of a Multiple Page Format Do...
Page 66 - Overview of Defining a Multiple Page Format Document
Overview of Defining a Multiple Page Format Document This section describes the overall set of steps you will take to define amultiple-page print definition. The specific procedure is provided beginning in“Working with a Print Definition” on page 55. You will need to define two different page format...
Page 67 - Initial Copy for Page Format One; Map data in the spooled file, such as the zip code to POSTNET bar code.; Add the constant text Customer Copy at the bottom; as constant text; Change the file copy, printing File Copy at the bottom; Continuation Page Format; Start from the APU Main Menu. as shown in Figure 57 on page 56:
Initial Copy for Page Format One APU automatically creates the initial copy for page format one (the default namefor the copy is *ORIGINAL). Define the details of that first copy, as follows: 1. Specify general page layout options that includes the constant (Terms andConditions) back overlay (INVBAC...
Page 68 - Select option 1 to create a print definition, as shown in Figure 58.; Developing Your Print Definition
2. Select option 1 to create a print definition, as shown in Figure 58. 3. From the Work with Print Definitions panel, create a print definition that iscalled INVOICE. Define INVOICE as a print definition with multiple pageformats, as shown in Figure 58. Developing Your Print Definition 1. When you ...
Page 69 - The Define a Print Definition panel displays:
2. The Define a Print Definition panel displays: 3. From this panel, indicate that you will select a sample spooled file. You canalso define the print attributes at the print definition level. 4. First, select a sample spooled file. In this example, select the output (SCSformat) called INVSCS, as sh...
Page 71 - Defining Selection Fields
Defining Selection Fields This is the continuation panel for setting the print definition attributes. After youhave completed this panel, the Define Selection Fields panel appears. On thispanel, you can view the sample spooled file (INVSCS) and define selection fields,as shown in Figure 64. The samp...
Page 72 - is a defined field, as shown in Figure 66.; Inside page formats are copies.
2. Change the default field name to something more recognizable, such asPAGEN . Note that the page number field has changed to 000, indicating that it is a defined field, as shown in Figure 66. 3. Press F3 to exit. 4. Keep pressing Enter until the Work with Print Definition panel displays. Working w...
Page 73 - Defining the Page Layout; Select the following items:
The first copy (*ORIGINAL) of the print definition is automatically created.This first copy will be the Customer Copy of the Super Sun Seeds invoice. Defining the Page Layout 1. Select option 10 to define the page layout of this copy, as shown in Figure 68. The Define a Copy panel shows the composit...
Page 74 - Specifying the Back Overlay; If you are going to use duplexing, you cannot have a back overlay.
Note: When you specify *INPUT for the Page orientation field, by default APUalways attempts to create the output in Portrait mode. APU attempts toperform rotation according to the values specified for the Page lengthand Page width fields. Many of these values default to *PRTDEF, which points to valu...
Page 75 - Mapping Fields
Mapping Fields After you have specified the Terms and Conditions overlay, you will then need todefine field mapping for your output. Note: Refer to “Mapping Data” on page 112 for some helpful hints on mappingdata. Press F3. The Define Field Mapping panel, shown in Figure 71 on page 64,appears. Figur...
Page 76 - Mapping Bar Codes; This section describes how to map bar codes.
APU displays the Super Sun Seeds invoice spooled file for data mapping. Withdata mapping, you can redefine how the application data is to be placed whenprinted. For the example we are using, we will describe the following: v Mapping bar codes v Defining constant data v Defining Fonts v Defining over...
Page 77 - Press Enter to return to the Define Field Mapping panel.
4. The Map Bar Code panel is a multi-panel pop-up used to select, define, andposition the bar code. The zip code is at row 15, column 16, and the value isshown. Map it (make a copy of the zip code) in bar code to a position startingat 1.1 inches down and 1.6 inches across the paper. It could have al...
Page 80 - Press F3. The Define Overlays panel appears, as shown in Figure 77.
Defining Overlays 1. Press F3. The Define Overlays panel appears, as shown in Figure 77. 2. On the Define Overlays panel, select the Super Sun Seeds invoice overlay(INVALL) to be printed on this copy. A sample of the INVALL overlay is shownbelow: Define Overlay Positionings Print Definition . . : IN...
Page 81 - Replicating the Contents of Copies; Select option 2 to change the text to Customer copy.
Replicating the Contents of Copies At this point, the composition of the customer copy has been defined. Press Enteruntil the Work with Copies panel appears again. 1. Select option 2 to change the text to Customer copy. 2. Select option 3 (copy) to replicate the contents of the customer copy to twoa...
Page 83 - Continuation Page Copies; Now, return to the Work with Page Formats panel.; Change text to PAGE1 format.; Select option 2 to change the text to Page 1 format.
Continuation Page Copies At this point, you have defined all the copies within the first page format (PAGE1). 1. Now, return to the Work with Page Formats panel. 2. Rename *DEFAULT to PAGE1. 3. Change text to PAGE1 format. 4. From this panel, select option 3 to make a copy of the PAGE1 page format,c...
Page 84 - panel appears, as shown in Figure 85 on page 73.
7. Press Enter to return to the Work with Page Formats panel, as shown inFigure 84. 8. Select option 12 to work with the PAGEN page format. The Work withCopies panel appears, as shown in Figure 85 on page 73. Work with Page Formats Print Definition . . : INVOICE Library . . . . . . : QAPU Type optio...
Page 85 - page format. At this point, open these copies and make any changes; Press Enter until the Work with Print Definitions panel appears.
9. The page format copy function has created the same three copies under thePAGEN page format. At this point, open these copies and make any changes to the page layout for the PAGEN pages. The principal difference between thecopies is in the use of the different overlays. 10. Press Enter until the W...
Page 86 - panel appears. On this panel, APU summarizes the current
Note: You do not have to type the logic for identifying pages greater thanpage one. 14. If the value of PAGEN is not 1, then APU will select page format PAGEN, asshown in Figure 88. 15. After you have defined rules for PAGE1 and PAGEN, press Enter. The DefineSelection Rules panel appears. On this pa...
Page 91 - Chapter 5. Manual and Command Line Printing with APU; “Methods of Printing with APU”; Methods of Printing with APU; You can use any of three methods to print with APU:; Manually Associating a Print Definition with a Spooled File
Chapter 5. Manual and Command Line Printing with APU This chapter describes the methods of printing your print definition, and describestwo of these three standard methods in detail: v “Methods of Printing with APU” v “Manually Associating a Print Definition with a Spooled File” v “Using the Apply P...
Page 92 - Panel 1: Apply Print Definition; Some of the fields you should fill out include:; Input Spooled File; Name of the print definition to be applied to the spooled file.; Success or Failure; Press the “Page Down” key to access the next panel.
Panel 1: Apply Print Definition APU will move the input spooled file to the output queue defined in the Successor Failure fields, depending on the result, and will place the file in one of the fourstatus conditions shown above. *HOLD is the default for both success and failure. Some of the fields yo...
Page 93 - Panel 2: Apply Print Definition; description of some of the key fields:
Panel 2: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Here is a description of some of the key fields: User exit BEFORE Initializes the name of a program you want run before processing. Refer to“User Exit Before” on page 103. User exit MIDDLE Name of a p...
Page 94 - Panel 3: Apply Print Definition; Output bin; Where the output is to be placed.; User exit AFTER; Using the Apply Print Definition Command; The APYPRTDEF command can also be used to run in batch.
Panel 3: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Key field entries here are: Output bin Where the output is to be placed. User exit AFTER Name of a program you want to be run after the AFPDS output spooledfile has been created. Refer to “User Exit A...
Page 95 - Introduction to the APU Monitor
Chapter 6. Automatic Printing with APU Monitor This chapter describes the third method of printing APU print definitions. (Theother two methods are described in Chapter 5, “Manual and Command LinePrinting with APU” on page 79.) To give you an understanding of the operation of the APU Monitor, the fo...
Page 96 - An Example of APU Monitor Processing; Assume that a customer wants to set up the following environment:; SAMPLE; applied
Figure 94 diagrams the sequence in which the APU Monitor processes the actiongroups. Here is an explanation of the steps shown in the diagram: 1. The monitor is invoked each time a spooled file arrives in a monitored outputqueue or if the spooled file status from a spool in a monitored queue changes...
Page 97 - SAVE; – The original QSYSPRT spooled files must be deleted.; Notes; Implementing the Customer Requirements on the APU Monitor
– The application’s original spooled files must be placed in the OUTQ called SAVE . – The original QSYSPRT spooled files must be deleted. The Figure 95 diagrams these customer requirements. The numbers in the figureare used to identify the sequence of notes provided following this diagram. Notes 1. ...
Page 98 - Action for the application spooled files in OUTQ1; Condition of the Output Queue after Processing; The QSYSPRT spooled file from OUTQ1 is in the output queue PRT01.
The numbers in the figure indicate the actions that correspond with Figure 96 . Notes 1. Action for the application spooled files in OUTQ1 2. Action for all other application spooled files in all monitored OUTQs 3. Action for all other spooled files in OUTQ1 4. Action for all other spooled files in ...
Page 99 - Configuring APU Monitor; The following configuration steps are needed:
2. All QSYSPRT spooled files from the other OUTQs are in the output queuePTR02. 3. The original application SCS spooled files from OUTQ1 are in the output queueSAVE. New AFPDS spooled files have been placed in the output queue PRT01.This new spooled file is the result from APU after applying the pri...
Page 100 - Specifying the Queues APU is to Monitor; Access option 3, Work with APU Monitor at the APU Main menu.
Specifying the Queues APU is to Monitor The first task to perform is to specify the queues (OUTQs) the APU Monitor is tomonitor. You can add or remove OUTQs from the list. You need to add only thequeue where the spooled file action is performed on an APU print definition. If aspooled file comes from...
Page 101 - Configuring APU Monitor Action; Initial Panel
Configuring APU Monitor Action To set up APU Monitor actions, you need to access item 8 on the APU Main menu,Configure APU Monitor Action . This selection displays an initial panel, followed by several additional panels. This section describes each part of a Monitor action. Each action has the follo...
Page 102 - Defining Selection for Input Spooled File
2. Type in a sequence number. APU Monitor uses this number to determine whento perform the test that is specified by the rule. If you want this test performedfirst, enter a number that is less than any previous rule number. 3. Type in a description of the rule. Note: Note that a rule may apply to al...
Page 103 - Defining Action for Input Spooled File; Call the “before” user program
You enter values that APU uses to select the input spooled file. Following is adescription of the values you can enter: Spooled file name This can be a specific name, a generic name, or *ALL. Output queue/Library This can be a specific output queue, a generic name, or *ALL. User This can be a specif...
Page 104 - Defining Action for Output Spooled File
v Transform the input database file to an AFP database file, using specified APUprint definition v Write the output AFP database file to the specified output queue v Call the “after” user program The Define Action for Output Spooled File display, consisting of two displays foreach action group, prov...
Page 105 - Action for all other spooled files in OUTQ1.; Action
For the monitor, the user must define two actions for output spooled files. Eachaction refers to one of the print definitions. At run time, the print engine runs bothprint definitions with a different Output Queue for each. Notes 1. Action for the application spooled files in OUTQ1. An additional ou...
Page 106 - The QSYSPRT spooled files from OUTQ1 are in PRT01 OUTQ.; Defining User Exit Before and Middle; C B
Notes 1. The QSYSPRT spooled files from OUTQ1 are in PRT01 OUTQ. 2. All QSYSPRT spooled files from the other OUTQs are in PRT02 OUTQ. 3. All original application spooled files from OUT1 are placed in OUTQ SAVEafter processing. A new AFPS spooled file has been placed in PRT01 for eachspooled file for...
Page 107 - Following are the values that could be entered for Run Option:; Ignored
On this panel, you specify the name, library, and user-defined parameter for theprogram that APU is to call before, during, or after processing. The default is*NONE. Refer to Appendix B, “User Exits” on page 103 for details about the userexits. The Print Definition lines contain values for the libra...
Page 108 - Defining User Exit After
output queue where the input spooled file was found. *DEV has APU place the fileinto the output queue of the device specified in the Output Device field. Defining User Exit After This panel is used to specify what is to be done after processing a file. File The File field is the name of the output s...
Page 109 - User exit after; Starting APU Monitor; Begin at the APU Main menu, as shown in Figure 109:; Select 4. Start APU Monitor to display the panel shown in Figure 110:
User exit after The User exit after field contains the name, library, and user definedparameter for the program to be called by APU after the output spooledfile has been created. Starting APU Monitor Begin at the APU Main menu, as shown in Figure 109: Select 4. Start APU Monitor to display the panel...
Page 110 - Stopping APU Monitor
Stopping APU Monitor To stop the APU Monitor, return to the APU main menu and select 5. End APUMonitor: APU IBM Advanced Print Utility Select one of the following: Build and Test APU Print Definitions 1. Work with Print Definitions 2. Work with Spooled Files Run APU in Batch Mode 3. Work with APU Mo...
Page 113 - Appendix A. APU Samples
Appendix A. APU Samples To help you become familiar with APU, the following sample materials have beenprovided in the QAPU library: Table 2. Samples in the QAPU Library Name Type AMASTER Print definition example to be used with INVPRE. GRID Overlay GRID1 Overlay INVALL Overlay INVBAC Overlay INVFST ...
Page 115 - Appendix B. User Exits; Processing Phases; User Exit Before
Appendix B. User Exits This appendix describes the user exits that are referred to in “Defining User ExitBefore and Middle” on page 94 and “Defining User Exit After” on page 96. Processing Phases Following is a description of the processing phases the APU print engine goesthrough in general and when...
Page 116 - User Exit Middle
Table 4. Parameters Passed to the Before Initialization User Exit INFILE Name of the Input spooled file INNBR File number of the input spooled file INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) JOBUSR Input creating job&csq;s user JOBNAM Input creating job&csq;s name JOBNBR I...
Page 117 - User Exit After
Table 5. Parameters Passed to the Middle User Exit INFILE Name of the Input spooled file INNBR File number of the input spooled file INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) JOBUSR Input creating job&csq;s user JOBNAM Input creating job&csq;s name JOBNBR Input creating j...
Page 118 - Sample User Exit Program
Table 6. Parameters Passed to the User Exit After the AFPDS Spooled File has beenCreated INFILE Name of the Input spooled file INNBR File number of the input spooled file INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) JOBUSR Input creating job&csq;s user JOBNAM Input creating job&...
Page 123 - Appendix C. APU Helpful Hints; APYPRTDEF Command; Print Definition Creation
Appendix C. APU Helpful Hints APYPRTDEF Command When you are applying a print definition to a spool file using the APYPRTDEFcommand, a line appears on the bottom left of the display as an indicator of theprocessing phases. The line contains 3 asterisks(***) in eight different positions.Refer to “Pro...
Page 124 - Mapping Data
v Initially, the additional resource libraries field entries in the “Set Print DefinitionAttributes” panel are copied from the APU defaults. If a user overrides any ofthese resources on this panel, APU will only use these overridden resources.APU does NOT concatenate these overridden resources with ...
Page 125 - Recreating INVPRE and INVSCS
Duplex v When you enable duplex printing on the “Set Page Layout Options” display,specify *NONE for Back Overlay on this display because APU cannot print textthat includes overlays, page segments, and boxes on the front side of a duplexedsheet and then print an overlay on the back side of that duple...
Page 127 - Appendix D. AFP Resource Commands; Creating Font Resources; The following section describes how to create font resources.
Appendix D. AFP Resource Commands This appendix describes how to build iSeries resource objects from font, overlay,and page segment files that are created on a client system. If you are using theOverlay Utility (part of AFPU) for overlays, you will not need the overlaycommands. The Overlay Utility b...
Page 128 - Creating Overlay Resources; The following section describes how to create overlay resources.
3. Create the Font Resource. Use the CRTFNTRSC command to create an iSeriesfont resource. Creating Overlay Resources The following section describes how to create overlay resources. 1. Create a temporary resource file as follows. From an iSeries command line,issue the CRTPF command to create a file ...
Page 129 - Creating Page Segment Resources
3. Create the Overlay. Use the CRTOVL command to create an iSeries overlay: An alternative to using the individual steps that are described above is to buildand use the OVERLAY command. Refer to the iSeries Guide to AFP Printing and PSFfor details. Creating Page Segment Resources The following secti...
Page 130 - Create the page segment by using the CRTPAGSEG command.
2. Transfer the page segment file to the temporary resource file by using theCPYFRMPCD command. 3. Create the page segment by using the CRTPAGSEG command. Fill in the fields as as shown in the panel above to create an iSeries page segment. Create Physical File (CRTPF) Type choices, press Enter. File...
Page 133 - Appendix E. Rotation Hints; Methods of Rotating Text Data; Figure 121 shows the methods in which text data can be rotated.; General Rules; The general rules APU follows when rotating data are:
Appendix E. Rotation Hints Methods of Rotating Text Data Figure 121 shows the methods in which text data can be rotated. Note: Asterisks in the figure above indicate where text can be truncated on certainrotated pages if page length or page width values are not considered. Textcan always be truncate...
Page 135 - Appendix F. Font Samples; Times New Roman Medium; The outline font is CZN200.
Appendix F. Font Samples This appendix presents a sampling of various fonts provided by IBM. Times New Roman Medium Note: The outline font is CZN200. Figure 122. Times New Roman Medium © Copyright IBM Corp. 1996, 2002 123
Page 136 - Helvetica Roman Bold; The outline font is CZH400.
Helvetica Roman Bold Note: The outline font is CZH400. Figure 123. Helvetica Roman Bold 124 APU User ’s Guide
Page 137 - Courier
Courier Note: The outline font is CZ4200, CZ4300, CZ4400, or CZ4500. Figure 124. Courier Font Samples Appendix F. Font Samples 125
Page 139 - Glossary
Glossary A ACIF. AFP Conversion and Indexing Facility. An AFP program you can use to convert a print file into aMO:DCA-P document, to retrieve resources used by thedocument, and to index the file for later retrieval andviewing. addressable point. Any point in a presentation surface that can be ident...
Page 145 - Notices; Trademarks; The following terms are trademarks of other companies as listed:
Notices References in this publication to products or services of IBM do not suggest orimply that IBM will make them available in all countries where IBM does businessor that only products or services of IBM may be used. Noninfringing equivalentsmay be substituted, but the user must verify that such...
Page 147 - Index
Index A accessing APU 16Actions, Monitor action for input spooled file 83action for output spooled file 83creating 89creating groups 89for output file 92for print engine 89how they are processed 83input spooled file for 91selection for input spooled file 83setting up 89types of 90 Adobe Type 1, type...
Page 151 - Readers’ Comments — We’d Like to Hear from You
Readers’ Comments — We’d Like to Hear from You PrintSuite for iSeriesAdvanced Print UtilityUser ’s Guide Publication No. S544-5351-03 Overall, how satisfied are you with the information in this book? Very Satisfied Satisfied Neutral Dissatisfied Very Dissatisfied Overall satisfaction h h h h h How s...
Page 152 - IBMR; BUSINESS REPLY MAIL
Readers’ Comments — We’d Like to Hear from You S544-5351-03 S544-5351-03 IBMR Cut or FoldAlong Line Cut or FoldAlong Line Fold and Tape Please do not staple Fold and Tape Fold and Tape Please do not staple Fold and Tape NO POSTAGENECESSARYIF MAILED IN THEUNITED STATES BUSINESS REPLY MAIL FIRST-CLASS...