PrintSuite for iSeries IBM Advanced Print Utility User’s Guide S544-5351-03
PrintSuite for iSeries IBM Advanced Print Utility User’s Guide S544-5351-03
Note! Before using this information and the product it supports, be sure to read the general information in “Notices” on page 133. Fourth Edition (May 2002) This edition applies to the licensed program IBM PrintSuite for iSeries: Advanced Print Utility (Program number 5798-AF2), and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. Be sure to use the correct edition for the level of the product.
Contents Figures . . . . . . . . . . . . . . . v Chapter 3. Building an APU Print Definition for a Single Page Format . . 35 Tables . . . . . . . . . . . . . . . vii Example of a Single-Page Format Document Example of the SCS File to be Formatted Example of the Formatted File . . . . Setting up a Basic Print Definition . . . . Identifying Resources . . . . . . . Working with a Print Definition . . . Further Defining the Print Definition . . . Working with Copies . . . . . . . .
Chapter 6. Automatic Printing with APU Monitor . . . . . . . . . . . . . . 83 Introduction to the APU Monitor . . . . . . . Understanding How the APU Monitor Works . . . An Example of APU Monitor Processing . . . . A Customer Environment. . . . . . . . . Implementing the Customer Requirements on the APU Monitor . . . . . . . . . . . . . Condition of the Output Queue after Processing Configuring APU Monitor . . . . . . . . . Specifying the Queues APU is to Monitor . . . Configuring APU Monitor Action . . . .
Figures 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. Flow of Data Through APU and OS/400 . . . 5 APU Data Structure . . . . . . . . . . 6 APU Concepts . . . . . . . . . . . . 7 Steps to Creating a Document . . . . . . . 8 APU main menu panel. . . . . . . . . 10 Set APU Defaults panel . . . . . . . . 14 Set Print Definition Attributes panel . .
111. Stop APU Monitor panel . . . . . . . 112. Create Temporary Resource File . . . . 113. Copy From PC Document (CPYFRMPCD) panel . . . . . . . . . . . . . 114. Create Font Resource (CRTFNTRSC) panel 115. Create Temporary Resource File panel 116. Copying Overlay File from Folder . . . 117. Create Overlay (CRTOVL) panel . . . . vi APU User’s Guide . 98 . 115 . 115 116 116 . 117 . 117 118. 119. 120. 121. 122. 123. 124. Create Temporary Resource File . . . .
Tables 1. 2. 3. 4. Field Mapping Values . . . . . . . . . 48 Samples in the QAPU Library . . . . . . 101 APU Print Engine Processing Phases 103 Parameters Passed to the Before Initialization User Exit . . . . . . . . . . . . . 103 © Copyright IBM Corp. 1996, 2002 5. 6. Parameters Passed to the Middle User Exit 104 Parameters Passed to the User Exit After the AFPDS Spooled File has been Created . . .
viii APU User’s Guide
Purpose of this Publication This publication helps you to use the IBM PrintSuite for iSeries Advanced Print Utility (APU). It focuses on the concepts of APU, using a series of application examples to demonstrate how APU works. APU has extensive on-line help; we do not duplicate that information here. For details on the concepts of Advanced Function Presentation (AFP), refer to iSeries Guide to AFP and PSF, S544-5319.
x APU User’s Guide
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 . . . . . . . . . . 4 Printing with APU . . . . . . . . . . . 5 The Design Phase. . . . . . . . . . . 5 The Production Phase . . . . . . . . . 6 APU formatting instructions . . . . . . . . .
2 APU User’s Guide
Chapter 1.
Why Use APU? APU assists you in building AFP-compatible electronic output. Effective electronic output can provide significant benefits to an organization, particularly in the areas of information systems costs, process reengineering, and better communications, for example: v Replacing preprinted multipart forms with electronic forms supplies significant cost savings. – You can print a variety of different forms one after the other without switching forms at the printer.
access to the application program source code or no programming skills exist in-house to implement changes to output pages or documents. Printing with APU Using APU requires no programming skills, enabling individuals with graphics and layout ability to design the appearance of the printed page and to easily make changes to printout appearance. Note: Exact print results depend on the type of printer you have.
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 characteristics include how to identify the target spooled file, which print definition to use, what user-specific programs should be called during processing, and the disposition of both the input and output spooled files. With this information in place, you start the APU Monitor.
as would be done with hard copy multipart forms. You can, for example, suppress the price on the packing slip and print some inventory control information on the packing slip as a bar code. When you use APU, each copy can be different. The same data can be printed at a different position, and different attributes can be used with each copy.
Analyze the SCS job Document structure - Page format - Page copy - Data identification - Resources identification - Trigger for conditional processing Create AFP Resources with AFP tools - Font - Page Segment - Overlay Create the Print Definition Run the Print Definition Define APU Defaults Run APU manually - Select unit of Work with APU monitor measure - Select font - Select paper size -... Create print definition - Define page format - (cond. processing) - Create copy - (Mapping) - (. . . ) Figure 4.
LOS ARBOLES DEL MUNDO 32483 ARBOL LANE MESA VERDE IL 54078-9390 141 31341 1/26/98 900 951 46 45 951 4 100 1000 98 EA CT DZ BZ PK BX EA BX PK SAME 1/26/98 N10 00001200 ARBOLES DEL SUR 11005011 LASSO RED SEEDS 11005014 SCARLET NANTES SEEDS 11005015 CHANTENAY SEEDS 11005018 EARLY BANTAM SEEDS 11057893 AFRICAN DAISY, SEEDS 31321655 SEMILLAS DEL SUS SOMBEROS 56413213 POT POT 84512023 OREGON SPRING TOMATO SEED 2/26/98 MICHELE GOODACRE 45.00 892.23 5.90 2.19 .38 2.35 24.95 7.65 .97 Thank You .....
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 Monitor 4. Start APU Monitor 5. End APU Monitor Configure APU 6. Set APU Defaults 7. Work with Fonts 8. Configure APU Monitor Action Selection or command ===> 1 F3=Exit F4=Prompt F23=Set initial menu F9=Retrieve F12=Cancel F16=System main menu Figure 5.
After you specify which print definition to apply, APU creates another spooled file and sends it to the output queue that you select. You will probably need to experiment some to get the data lined up with the electronic form or to refine the conditional tests that APU performs to select page formats. When you have completed testing of the print definition, you are ready to put the application into production. This involves defining how the production process is to work, then starting the APU Monitor.
12 APU User’s Guide
Chapter 2.
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 for Windows. Use this standard Windows driver to create overlays and page segments from any Windows application. Non-IBM document product tools, of which many exist, assist you in creating fonts, images, and overlays.
v For the Job description, we recommend that you use QYPUJOBD in the QAPU library. Two additional resource libraries, IMAGES and OVERLAYS, were also selected as defaults because APU looks in these libraries for document resources, such as page segments and overlays. You can specify defaults when you first begin an APU print definition. This display is shown in Figure 7. Set Print Definition Attributes Print Definition . . : Library . . . . . . : SUPER2 QAPU Type choices, press Enter. Unit of Measure . . .
Set Print Definition Attributes Print Definition . . : Library . . . . . . : SUPER2 QAPU Type choices, press Enter. Default font family . Point size . . . . Bold . . . . . . . Italic . . . . . . Default Color . . . . Addl. resource libs. . . . . . . F3=Exit F12=Cancel F4=Prompt *APUDFT *CALC *APUDFT *APUDFT, Value *CALC, Value 1=Yes 1=Yes *APUDFT, Value Name Name Name Name F4 for List F4 for List Bottom Figure 8.
Figure 9. Super Sun Seeds Invoice You will note the many characteristics that make this invoice an effective document: v Static sections of the page built into an overlay v Company logo and accent image v Use of a variety of fonts v Use of bar coding — POSTNET for the zip code The following sections use the Super Sun Seeds example to provide a close look at the key resources that comprise APU electronic documents: how they are used on the iSeries, how they are created, and how APU works with them.
Using Fonts with APU The examples in the remainder of this manual use the fonts in the AFP Font Collection. You should verify that you have these fonts available before going on. Your results may differ depending on the fonts defined on your system. APU provides an interface that makes selecting fonts simple. During installation, APU determines which fonts (character sets) are on your system and loads them into this interface. APU distinguishes between IBM-supplied fonts and your own custom fonts.
Select Map as Text to change the font that is used for the name. The Map Text panel appears. Define Field Mapping Spooled file . . . . : INVPRE Page/Line . . . . . . : 1/1 ............................................................................ : Map Text : : Type choices, press Enter. : : From Row / Column : 12 / 12 : : Mapping . . . . . : 1 / 1 : : Length . . . . . . 22 : : Position across . . 1.1 *INCH Value : : Position down . . . 2 *INCH Value : : Font family . . . .
Define Field Mapping Spooled file . . . . : INVPRE Page/Line . . . . . . : 1/1 ............................................................................ : Map Text : : Type choices, press Enter. : : From Row / Column : 12 / 12 : : Mapping . . . . . : 1 / 1 : : Length . . . . . . 22 : : Position across . . 1.1 *INCH Value : : Position down . . . 2 *INCH Value : : Font family . . . . HELVETICA *PRTDEF, Value F4 for list : : Point size . . . 12 *CALC, Value : : Bold . . . . . . 1 1=Yes : : Italic . . . . .
Work with Fonts Domain . . . . . . . . : *ALL *USR, *SYS, *ALL Type Options, press Enter. 1=Add 2=Change 4=Delete 5=Details Opt Style Font family TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN TIMES NEW ROMAN F3=Exit F5=Refresh Size 30 Bold-Italic 36 Normal 36 Italic 36 Bold 36 Bold-Italic Outl *V Normal Outl *V Italic Outl *V Bold Outl *V Bold-Italic F12=Cancel Font char.
Work with Fonts Domain . . . . . . . . : *ALL Type Options, press Enter. 1=Add 2=Change 4=Delete Opt Font family HELVETICA HELVETICA HELVETICA HELVETICA 5 HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA F3=Exit F5=Refresh *USR, *SYS, *ALL 5=Details Size Style 9 Bold 9 Bold-Italic 10 Normal 10 Italic 10 Bold 10 Bold-Italic 11 Normal 11 Italic 11 Bold 11 Bold-Italic 12 Normal 12 Italic Font char.
Work with Fonts Domain . . . . . . . . : *ALL Type Options, press Enter. 1=Add 2=Change 4=Delete Opt Font family 1 SPECIAL HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA HELVETICA F3=Exit F5=Refresh Size 9 9 10 10 10 10 11 11 11 11 12 12 *USR, *SYS, *ALL 5=Details Style Font char.
Image Resources Image resources are a key component in creating advanced electronic print and presentation applications. In some cases, such as with accent images, the purpose is to improve the look and effectiveness of output. Images like logos and signatures are essential parts of a document. In other image applications, such as an integrated check image on bank statements, the image is an actual part of the application data.
Prin Li Type 1 Opt 1 F3=E Define Page Segments ......................................................................... : Select a Page Segment : : : : Page Segment . . . . . *ALL Name, Generic*, *ALL : : : : Type Options, press Enter. : : 1=Select : : Page : : Opt Segment Text description : : : : 1 STRWNB Strawberry, no box, 300-pel : : SUNLOGO Sun Seeds Logo, 300-pel : : TREENB Tree, no box, 300-pel : : : : : : : : : : Bottom : ; F5=Refresh F12=Cancel : : : :............................................
For example, if you have a page segment in the upper left hand corner of an 8 1/2 by 11–inch page in portrait mode, and you rotate the entire page 180 degrees, you will need to recreate your page segment with a rotation of 180 degrees also. You then will need to specify the new position of the rotated page segment relative to the original page origin; in this case, the lower right corner of the page.
Figure 22. Super Sun Seeds Invoice How APU Works with Overlays APU can place overlays on any page, in virtually any location. APU can place multiple overlays per page and control the placement of each overlay. APU enables you to specify one constant back overlay, that is, print an overlay by itself on a page without data (for example, a “terms and conditions” page on the back of an invoice). You can use overlays conditionally by varying which overlays print on each page format or copy.
Prin Li Type 1 Opt .... : : : T : : P : P : O : : : F : :... Define Overlay Positionings ......................................................................... : Select an Overlay : : : : Overlay . . . . . . . . INV* Name, Generic*, *ALL : : : : Type Options, press Enter. : : 1=Select : : : : : : Opt Overlay Text description : : : : INVOICE INVOICE OVERLAY w/o LOGOS : : 1 INVALL INVOICE: ALL ON ONE PAGE : : INVBAC SUPER SUN SEEDS T&C.
Set Page Layout Options Print Definition . . . Library . . . . . . . MYPRTDEF QAPU Page Format . . . . . : *DEFAULT Copy . . . . . . . . : *ORIGINAL Type choices, press Enter. Input drawer . . . . . Default line increment Default Column inc. . . Page length . . . . . . Page width . . . . . . Top margin (down) . . . Left margin (across) . Page orientation . . . Duplex printing . . . . Back overlay . . . . . Position across . . . Position down . . . .
a product, part, or publication number. Bar codes are designed to be read by a device called a bar code reader or scanner. The scanner must be compatible with the printed bar code symbology. The following sections show examples of two bar codes: Code 3 of 9 and POSTNET. Code 3 of 9 Bar Code Example Code 3 of 9 is a discrete bar code symbology because each character stands by itself and is separated from the others by a non-data space or intercharacter gap.
You can specify the positioning, rotation, and color used for the bar code. Bar code data is displayed only on the Map Bar Code panel. .............................................................................. : Map Bar Code : : : : Type choices, press Enter. : : : : From Row / Column : 15 / 16 : : Bar code data . . : 45789-2637 : : : : Position across . . 1.5 *INCH Value : : Position down . . . 2.333 *INCH Value : : : : Rotation . . . . . *DEFAULT *DEFAULT, 0, 90, 180, 270 : : Color . . . . . . .
................................................................................ : Map Bar Code : : Type choices, press Enter. : : Bar code type . . : 12 - POSTNET : : Bar code data . . : 457892637 : : Length . . . . . . 9 1-50 : : POSTNET Type . . . 2 1=ZIP Code, : : 2=ZIP+4 Code, : : 3=Advanced Bar Code, : : 4=Variable length data : : : : Bottom : : F12=Cancel : ...............................................................................: Figure 30.
Part 2. Creating Print Definitions with APU Chapter 3. Building an APU Print Definition for a Single Page Format . . . . . . . . . . . Example of a Single-Page Format Document . . . Example of the SCS File to be Formatted . . . Example of the Formatted File . . . . . . . Setting up a Basic Print Definition . . . . . . . Identifying Resources . . . . . . . . . . Working with a Print Definition . . . . . . Further Defining the Print Definition . . . . . . Working with Copies . . . . . . . . . . .
34 APU User’s Guide
Chapter 3. Building an APU Print Definition for a Single Page Format This chapter provides you with a detailed procedure you use to develop a print definition on OS/400 for a single-page document.
year, on your next seed order you will receive a 10% discount. 2/26/98 IMPROVED PRINTING CORP PERFORMANCE BOULEVARD PRINTERSVILLE CO 457892637 $90,652.21 $90,652.21 Example of the Formatted File The formatted output that you want to produce is shown in Figure 31. Figure 31. Super Sun Seeds Invoice Setting up a Basic Print Definition This section describes the basic steps involved in setting up a print definition.
Note: The output depends on the fonts that are available on your system. Your output 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: 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 Monitor 4. Start APU Monitor 5.
4. Type 1 in the option column in the first row, then press Enter to create a new print definition, as shown in Figure 34: Work with Print Definitions Library . . . . . . . . QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 4=Delete 6=Print contents 7=Rename 10=Define Name, *CURLIB 5=Display contents 12=Work with Opt Name Text 1 ........................................................................ : Create a Print Definition : : : : Type choices, press Enter. : : : : Print Definition . . .
1. First, type 10 in the OPT column next to your newly-created print definition to access the Define a Print Definition panel, as shown in Figure 35: Define a Print Definition Print Definition . . : SUNSD1 Library . . . . . . : QAPU Type options, press Enter. 1=Select Opt Function Select a sample spooled file Set print definition attributes F3=Exit F12=Cancel Figure 35. Define a Print Definition panel 2. At this point, you have two options: a.
Set Print Definition Attributes Print Definition . . : SUNSD1 Library . . . . . . : QAPU Type choices, press Enter. Unit of Measure . . . . *INCH *INCH, *CM, *ROWCOL, *UNITS Default line increment *INPUT *INCH *INPUT, Value Default column inc. . . *INPUT *INCH *INPUT, Value Page length . . . . . . *INPUT *INCH *INPUT, Value Page width . . . . . . *INPUT *INCH *INPUT, Value Top margin (down) . . . 0 *INCH 0, Value Left margin (across) . 0 *INCH 0, Value Page orientation . . .
Work with Copies Print Definition . . Library . . . . . . SUNSD1 QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 10=Define Opt Name *ORIGINAL F3=Exit Page Format . . . . . 4=Delete *DEFAULT 7=Rename Text Original (first copy) F5=Refresh Bottom F12=Cancel Figure 39. Work with Copies panel You do not need to create or name a page format; APU does that for you, naming the page format *DEFAULT. APU automatically creates the first copy in the page format and names it *ORIGINAL.
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 the application data on the page. v Select Define page segments to include the company logo in the output. v Select Define field mapping to map spooled file data to the output page. Most of these steps are illustrated below.
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. The result will be that all second pages of the copy will be printed on the back side of the page. Enter a 2 to select tumble duplex. Restrictions 2. Duplex printing can be done only for consecutive pages of the same copy.
Define Page Segments Print Definition . . : SUNSD1 Page Format . . . . . : *DEFAULT Library . . . . . . : QAPU Copy . . . . . . . . : *ORIGINAL Type options, press Enter. 1=Create 2=Change 3=Copy 4=Delete Position Position Unit of Page Opt across down measure segment 1 *INCH ...................................................................... : Create a Page Segment Positioning : : Type choices, press Enter. : : Position across . . . . 3.6 *INCH Value : : Position down . . . . .
Define Overlay Positionings Print Definition . . : Library . . . . . . : SUNSD1 QAPU Type options, press Enter. 1=Create 2=Change 3=Copy Page Format . . . . . : Copy . . . . . . . . : *DEFAULT *ORIGINAL 4=Delete Position Position Unit of Opt across down measure Overlay 1 .............................................................................. : Create an Overlay Positioning : : : : Type choices, press Enter. : : : : Position across . . . . 0 *INCH Value : : Position down . . . . .
Notice that the “header” of the panel displays the spooled file name, the page number, the line number, and the line you are currently dealing with (1/12, 2/12, and so on), and the number of columns currently displayed. To define and map a field: 1. Position the cursor where you want the field to start in the spooled file and press F14. The rest of the line is highlighted. 2. Position the cursor where you want the field to end and press F15. 3.
Mapping a Field as Text In this example, select option 1 to map the customer name as text. When you select Map as Text, the Map Text panel appears, as shown in Figure 48: Define Field Mapping Spooled file . . . . : INVSCS Page/Line . . . . . . : 1/1 ............................................................................... : Map Text : : Type choices, press Enter. : : From Row / Column : 12 / 12 : : Mapping . . . . . : 1 / 1 : : Length . . . . . . 22 : : Position across . . 1.
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 (for example, mapping both bar code and text, or both bar code and suppression for a field), position the cursor on the mapped field and press Enter.
Spooled file . . . . : Define Field Mapping INVSCS Page/Line . . . . . . : 1/1 Edit Text Mapping Type choices, pr..........................................................: : Repeat Text Mapping : From Row / Colum : : Mapping . . . . : From row / column . . : 12 / 12 : Length . . . . : Length . . . . . . . : 22 : : Position across . . . : 1.1 *INCH : Position across : Position down . . . . : 2 *INCH : Position down . : : Font family . . : Type choices for repetitions, press Enter. : Point size .
Define Field Mapping Spooled file . . . . : INVSCS Page/Line . . . . . . : 1/1 ............................................................................... : Map Text : : Type choices, press Enter. : : From Row / Column : 12 / 12 : : Mapping . . . . . : 1 / 1 : : Length . . . . . . 22 : : Position across . . 1.1 *INCH Value : : Position down . . . 2 *INCH Value : : Font family . . . . HELVETICA *PRTDEF, Value F4 for list : : Point size . . . 12 *CALC, Value : : Bold . . . . . . 1 1=Yes : : Italic . . . .
Chapter 4. Building an APU Print Definition for Multiple Page Formats This chapter provides you with a detailed procedure you use to develop a print definition with APU for a multiple-page format document.
Figure 54.
Figure 55. Super Sun Seeds Invoice - Page 2 Chapter 4.
Figure 56. Super Sun Seeds Invoice - Page 3 Overview of Defining a Multiple Page Format Document This section describes the overall set of steps you will take to define a multiple-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 formats (one for page one and the second for the continuation pages) and then define the various copies within each page format.
Initial Copy for Page Format One APU automatically creates the initial copy for page format one (the default name for the copy is *ORIGINAL). Define the details of that first copy, as follows: 1. Specify general page layout options that includes the constant (Terms and Conditions) back overlay (INVBAC) 2. Map data in the spooled file, such as the zip code to POSTNET bar code. 3. Add the constant text Customer Copy at the bottom 4. Place page one overlay (INVALL) on front 5.
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 Monitor 4. Start APU Monitor 5. End APU Monitor Configure APU 6. Set APU Defaults 7. Work with Fonts 8. Configure APU Monitor Action Selection or command ===> F3=Exit F4=Prompt F9=Retrieve F12=Cancel F23=Set initial menu 5798-AF4 (C) COPYRIGHT IBM CORP. 1996, 1997 F16=System main menu Figure 57.
Work with Print Definitions Library . . . . . . . . QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 4=Delete 6=Print contents 7=Rename 10=Define Opt Name APU1 10 INVOICE F3=Exit Name, *CURLIB 5=Display contents 12=Work with Text APU Screen demo Super Sun Seeds Invoice F5=Refresh Bottom F12=Cancel Figure 59. Work with Multiple Page Formats panel 2. The Define a Print Definition panel displays: Define a Print Definition Print Definition . . Library . . . . . .
Select a Sample Spooled File Output Queue . . . . . QYPUOUTQ Name, *ALL F4 for list Library . . . . . . QAPU Name, *LIBL User . . . . . . . . . *ALL Name, *CURRENT, *ALL Type choices, press Enter. 1=Select 5=Display File Total Opt File Nbr User User Data Queue Sts Pages INVPRE 1 PERELMAN QYPUOUTQ RDY 7 INVSCS 2 PERELMAN QYPUOUTQ HLD 6 F4=Prompt F5=Refresh Bottom F12=Cancel Figure 61. Select a Sample Spooled File panel 5.
Set Print Definition Attributes Print Definition . . : INVOICE Library . . . . . . : QAPU Type choices, press Enter. Default font family . . COURIER LATIN1 *APUDFT, Value Point size . . . . . 12 *CALC, Value Bold . . . . . . . . 1=Yes Italic . . . . . . . 1=Yes Default Color . . . . . *APUDFT *APUDFT, Value Addl. resource libs. . Name Name Name Name F3=Exit F4=Prompt F4 for List F4 for List Bottom F12=Cancel Figure 63.
Define Selection Fields Spooled file . . . . : INVSCS Page/Line . . . . . . : 2/49 Control . . . . . . . . Columns . . . . . . . : 1 - 78 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+... ................................................. : Define Selection Field : : Type choices, press Enter. : : Starting Row / Column : 63 / 73 : : Length . . . . . . . . 3 Value : : Name . . . . . . . . . PAGEN Name : : F12=Cancel : :...............................................: Page 1 More..
Work with Copies Print Definition . . Library . . . . . . INVOICE QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 10=Define Opt Name 10 *ORIGINAL F3=Exit Page Format . . . . . 4=Delete 7=Rename Text Original (first copy) F5=Refresh *DEFAULT F12=Cancel Bottom Figure 67. Work with Copies panel 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.
Set Page Layout Print Definition . . . INVOICE Library . . . . . . . QAPU Type choices, press Enter. Input drawer . . . . . *DEFAULT Default line increment *PRTDEF *INCH Default Column inc. . . *PRTDEF *INCH Page length . . . . . . *PRTDEF *INCH Page width . . . . . . *PRTDEF *INCH Top margin (down) . . . *PRTDEF *INCH Left margin (across) . *PRTDEF *INCH Page orientation . . . *PRTDEF Duplex printing . . . . Back overlay . . . . . *NONE Position across . . . *INCH Position down . . . .
Figure 70. Back Overlay (Terms and Conditions) - INVBAC Mapping Fields After you have specified the Terms and Conditions overlay, you will then need to define field mapping for your output. Note: Refer to “Mapping Data” on page 112 for some helpful hints on mapping data. Press F3. The Define Field Mapping panel, shown in Figure 71 on page 64, appears. Chapter 4.
Define Field Mapping Spooled file . . . . : INVSCS Page/Line . . . . . . : 2/11 Control . . . . . . . . +10 Columns . . . . . . . : 1 - 78 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
.............................................................................. : Map Bar Code : : : : Type choices, press Enter. : : : : From Row / Column : 15 / 16 : : Bar code data . . : 94523-4852 : : : : Position across . . 1.1 *INCH Value : : Position down . . . 1.6 *INCH Value : : : : Rotation . . . . . *DEFAULT *DEFAULT, 0, 90, 180, 270 : : Color . . . . . . . *PRTDEF *PRTDEF, Value F4 for list : : : : Bar code type . . . 12 Value F4 for list : : : : : : : : More...
Define Constants Print Definition . . Library . . . . . . INVOICE QAPU Type options, press Enter. 1=Create 2=Change 3=Copy Page Format . . . . . *DEFAULT Copy . . . . . . . . *ORIGINAL 4=Delete Constant Position Position Unit of Opt type across down measure Constant value 1 *TEXT F3=Exit F5=Refresh F12=Cancel Figure 73. Define Constants panel Defining Constant Data Next, define the constant text Customer Copy to appear at the bottom of this copy.Specify a text type for this constant.
Outline Fonts APU supplies Outline fonts in addition to other standard IBM fonts. Refer to “Outline Fonts” on page 20. 2. For this example, select a Helvetica, 10-point, bold font as shown in Figure 75. : : : : : : : : : : : : : : : : : : : : : : Define Constants ............................................................................ : Select a Font : : : : Font family . . . . . . HELVETICA Name, Generic*, *ALL : : Point size . . . . . *ALL Value, *ALL : : Bold . . . . . . . .
Defining Overlays 1. Press F3. The Define Overlays panel appears, as shown in Figure 77. Define Overlay Positionings Print Definition . . : INVOICE Page Format . . . . . : Library . . . . . . : QAPU Copy . . . . . . . . : Type options, press Enter. 1=Create 2=Change 3=Copy 4=Delete Position Position Unit of Opt across down measure Overlay 1 0 0 *INCH INVALL (There are no overlay positionings defined) F3=Exit F5=Refresh *DEFAULT *ORIGINAL F12=Cancel Figure 77. Define Overlays panel 2.
Replicating the Contents of Copies At this point, the composition of the customer copy has been defined. Press Enter until 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 two additional copies: the Packing list and the File copy, as shown in Figure 79: Work with Copies Print Definition . . : INVOICE Page Format . . . . . : Library . . . . . . : QAPU Type options, press Enter.
Define Field Mapping Spooled file . . . . : INVSCS Page/Line . . . . . . : 2/17 Control . . . . . . . . Columns . . . . . . . : 1 - 78 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
Figure 82. Sample Packing List Showing Suppression 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, copies and all. 5. Select option 2 to change the text to Page 1 format. 6.
Work with Page Formats Print Definition . . : Library . . . . . . : INVOICE QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 12=Work with 4=Delete 7=Rename Opt Name Text 3 ........................................................................ : Copy a Page Format : : : : Type choices, press Enter. : : : : From Print Definition : INVOICE : : From Page Format . . : PAGE1 : : To Page Format . . . . PAGEN Name : : New text . . . . . . . Page N Format : : : : F12=Cancel : F3=Ex : : Page :.........
Work with Copies Print Definition . . : INVOICE Page Format . . . . . : Library . . . . . . : QAPU Type options, press Enter. 1=Create 2=Change 3=Copy 4=Delete 7=Rename 10=Define Opt Name Text *ORIGINAL Customer Copy FILE File Copy PACKING Packing List F3=Exit F5=Refresh F12=Cancel PAGE1 Bottom Figure 85. Create with Copies panel 9. The page format copy function has created the same three copies under the PAGEN page format.
............................................................................. : Define a Rule : : : : Type choices, press Enter. : : : : Rule number . . . . . : 10 : : : : Condition 1 . . . . . . IF IF, blank : : Field . . . . . . . . . PAGEN Name F4 for list : : Test . . . . . . . . . *EQ *EQ, *NE, *GT... : : Field or ’Characters’ . ’ 1’ Value F4 for list : : Action . . . . . . . . *USE *USE, *OMIT, *GOTO : : Page format or rule . . PAGE1 Value F4 for list : : : : Condition 2 . . . . . .
Define Selection Rules Print definition . . Library . . . . . . INVOICE QAPU Type options, press Enter. 1=Create 2=Modify 4=Delete Test Field or ’Characters’ Act. Page format or Rule PAGEN *EQ ’ *USE *USE PAGE1 PAGEN F5=Refresh F12=Cancel Opt Rule Cond Field 10 IF 20 F3=Exit 1’ F22=Renumber Bottom Figure 89. Define Selection Rules panel 16. After you have completed the selection rules, press F3 to return to the Work with Print Definitions panel. Chapter 4.
76 APU User’s Guide
Part 3. Printing With APU Chapter 5. Manual and Command Line Printing with APU . . . . . . . . . . . . . . . 79 Methods of Printing with APU . . . . . . . . 79 Manually Associating a Print Definition with a Spooled File . . . . . . . . . . . . . . 79 Panel 1: Apply Print Definition . . . . . . . 80 Panel 2: Apply Print Definition . . . . . . . 81 Panel 3: Apply Print Definition . . . . . . . 82 Using the Apply Print Definition Command . . . 82 Chapter 6.
78 APU User’s Guide
Chapter 5. Manual and Command Line Printing with APU This chapter describes the methods of printing your print definition, and describes two 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 Print Definition Command” on page 82 Methods of Printing with APU You can use any of three methods to print with APU: 1. Manually associating a print definition with a specific spooled file.
Panel 1: Apply Print Definition Apply Print Definition (APYPRTDEF) Type choices, press Enter. SCS Spooled File . . . . . . . . > INVSCS Name Job name . . . . . . . . . . . . > QPADEV0016 Name, * User . . . . . . . . . . . . . > JOHN Name Number . . . . . . . . . . . . > 098677 000000-999999 SCS Spooled file number . . . . > 10 1-9999, *ONLY, *LAST Print Definition . . . . . . . . > INVOICE Name, *NONE, *SPOOLFILE Library name . . . . . . . . . > QAPU Name, *PRTDEFLIB, *LIBL Run option . . . . . . . . . . .
Panel 2: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Here is a Apply Print Definition (APYPRTDEF) Type choices, press Enter. User exit BEFORE: Program . . . . . . . . . . . Library Name . . . . . . . . User parameter . . . . . . . . User exit MIDDLE: Program . . . . . . . . . . . Library Name . . . . . . . . User parameter . . . . . . . . Device Name . . . . . . . . . . Output queue . . . . . . . . . . Library Name . . . . . . . . . Spooled file name . . . . .
Panel 3: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Key field entries Apply Print Definition (APYPRTDEF) Type choices, press Enter. Output bin . . . . . . . . . . . *SPOOLFILE User exit AFTER: Program . . . . . . . . . . . *NONE Library Name . . . . . . . . User parameter . . . . . . . . F3=Exit F4=Prompt F24=More keys F5=Refresh F12=Cancel 1-65536, *SPOOLFILE, *DEVD Name, *NONE Name, *LIBL Bottom F13=How to use this display Figure 93.
Chapter 6. Automatic Printing with APU Monitor This chapter describes the third method of printing APU print definitions. (The other two methods are described in Chapter 5, “Manual and Command Line Printing with APU” on page 79.
Figure 94 diagrams the sequence in which the APU Monitor processes the action groups. Figure 94. APU Monitor Processing Sequence 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 output queue or if the spooled file status from a spool in a monitored queue changes to *RDY. Spooled files with other status conditions are not processed. 2. The monitor checks the input selection from each action rule in a sequential manner. 3.
– 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 figure are used to identify the sequence of notes provided following this diagram. Figure 95. APU Monitor before Processing Notes 1. All QSYSPRT spooled files from the OUTQ1 must be moved to OUTQ PRT01. 2. All QSYSPRT spooled files from all other OUTQs must be moved to OUTQ PRT02. 3.
The numbers in the figure indicate the actions that correspond with Figure 96 . Figure 96. APU Monitor - Action Example Notes 1. Action 2. Action 3. Action 4. Action for for for for the application spooled files in OUTQ1 all other application spooled files in all monitored OUTQs all other spooled files in OUTQ1 all other spooled files in all other OUTQs Many other options are possible for each action.
2. All QSYSPRT spooled files from the other OUTQs are in the output queue PTR02. 3. The original application SCS spooled files from OUTQ1 are in the output queue SAVE. New AFPDS spooled files have been placed in the output queue PRT01. This new spooled file is the result from APU after applying the print definition. 4. All other original application SCS spooled files from all other OUTQs are placed in the output queue SAVE. New AFPDS spooled files have been placed in the output queue PRT02.
Specifying the Queues APU is to Monitor The first task to perform is to specify the queues (OUTQs) the APU Monitor is to monitor. You can add or remove OUTQs from the list. You need to add only the queue where the spooled file action is performed on an APU print definition. If a spooled file comes from other OUTQs, no processing on them is done by the APU Monitor. To specify the queues to be monitored, take the following steps. 1. Access option 3, Work with APU Monitor at the APU Main menu. 2.
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.
Create Action Entry Type choices, press Enter. Sequence . . . . . . . Text . . . . . . . . . 10 Number QSYSPRT spool in OUTQ1 Type options, press Enter. 1=Select Opt 1 1 1 Function Define selection for input spooled file Define action for input spooled file Define action for output spooled file F12=Cancel Figure 102. Configure APU Monitor Action panel 2. Type in a sequence number. APU Monitor uses this number to determine when to perform the test that is specified by the rule.
Define Selection for Input Spooled File Sequence . . . . . . : Text . . . . . . . . : 10 QSYSPRT spool in OUTQ1 Type choices, press Enter. File . . . . Output queue Library . . User . . . . User Data . . Form Type . . Program . . . Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
v Transform the input database file to an AFP database file, using specified APU print 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 for each action group, provide for configuring the processing options. These options include the APU print definition, the user exit programs, the run option, and the output file options.
For the monitor, the user must define two actions for output spooled files. Each action refers to one of the print definitions. At run time, the print engine runs both print definitions with a different Output Queue for each.
OUTQ3 OUTQ2 OUTQ1 3 4 SAVE B B B C C 1 3 PRT01 B B A 5 6 PARIS C B C B B 2 4 PRT02 C A C B QSYSPRT (QSYSPRT) = A APPLICATION (APP01) = B APPLICATION (APP02) = C Figure 106. Spooled File Location after Processing 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 SAVE after processing.
Define Action for Output Spooled File Sequence Text . . Action . Panel . . . . . . . . . . . . . . . . . . . . . . . . . . : : : : 10 QSYSPRT spool in OUTQ1 1 / 1 1 / 2 Type choices, press Enter. User exit before Library . . . . User parameter Print Definition Library . . . . Run option . . User exit middle Library . . . . User parameter Output device . . Output queue . . Library . . . . ====> F12=Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
output queue where the input spooled file was found. *DEV has APU place the file into 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. Define Action for Output Spooled File Sequence Text . . Action . Panel . . . . . . . . . . . . . . . . . . . . . . . . . . : : : : 10 QSYSPRT spool in OUTQ1 1 / 1 2 / 2 Type choices, press Enter. File . . . . . . User Data . . . . Form Type . . .
User exit after The User exit after field contains the name, library, and user defined parameter for the program to be called by APU after the output spooled file has been created. Starting APU Monitor Begin at the APU Main menu, as shown in Figure 109: 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 Monitor 4. Start APU Monitor 5.
Stopping APU Monitor To stop the APU Monitor, return to the APU main menu and select 5. End APU Monitor: 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 Monitor 4. Start APU Monitor 5. End APU Monitor Configure APU 6. Set APU Defaults 7. Work with Fonts 8.
Part 4. Appendixes © Copyright IBM Corp.
100 APU User’s Guide
Appendix A. APU Samples To help you become familiar with APU, the following sample materials have been provided in the QAPU library: Table 2. Samples in the QAPU Library Name Type AMASTER Print definition example to be used with INVPRE.
102 APU User’s Guide
Appendix B. User Exits This appendix describes the user exits that are referred to in “Defining User Exit Before 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 goes through in general and when processing the user exits: Table 3.
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.
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.
Table 6. Parameters Passed to the User Exit After the AFPDS Spooled File has been Created 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.
DCL VAR(&EXPARM) TYPE(*CHAR) LEN(512) DCL /* Type of exit point (*BEFORE,*MIDDLE,*AFTER) VAR(&EXTYPE) TYPE(*CHAR) LEN(10) */ DCL /* Name of input spooled file VAR(&EXINFILE) TYPE(*CHAR) LEN(10) */ DCL /* Name of input spooled file number VAR(&EXINNBR) TYPE(*CHAR) LEN(10) */ DCL /* Input Printer device type VAR(&EXINTYPE) TYPE(*CHAR) LEN(10) */ DCL /* Input Jobs User VAR(&EXJOBUSR) TYPE(*CHAR) LEN(10) */ DCL /* Input Jobs Name VAR(&EXJOBNAM) TYPE(*CHAR) LEN(10) */ DCL /* Input Jobs Numb
DCL /* Output User data VAR(&EXOTUSDT) TYPE(*CHAR) LEN(10) */ DCL /* Output Form type VAR(&EXOTFORM) TYPE(*CHAR) LEN(10) */ DCL /* Output out-bin VAR(&EXOTOBIN) TYPE(*CHAR) LEN(10) */ DCL /* User specified parameter for exit pgm VAR(&EXUSRPRM) TYPE(*CHAR) LEN(20) */ DCL /* Reserved for future use VAR(&RESERVED) TYPE(*CHAR) LEN(246) */ /******************************************************************************/ /* */ /* STEP 1: Split parameter structure into single fields */ /* ------*/ /*
IF COND(&EXTYPE = *AFTER) CMDLBL(STEP3_AFT)) GOTO CMDLBL(STEP4) THEN(GOTO + /******************************************************************************/ /* */ /* STEP 3: Perform specific commands depending on calling */ /* ------exit point in APYPRTDEF */ /* */ /******************************************************************************/ /******************************************************************************/ /* SAMPLE CODE FOR *BEFORE */ /************************************************
’/’ *CAT &EXPRTDEF *BCAT ’for’ *BCAT + &EXJOBUSR *CAT ’’’s’ *BCAT ’spooled file’ + *BCAT &EXINFILE *TCAT ’.
Appendix C. APU Helpful Hints APYPRTDEF Command When you are applying a print definition to a spool file using the APYPRTDEF command, a line appears on the bottom left of the display as an indicator of the processing phases. The line contains 3 asterisks(***) in eight different positions. Refer to “Processing Phases” on page 103. APU Defaults v When initially setting APU defaults, we recommend that you ensure that any libraries where code pages exist have been added to your current library list.
v Initially, the additional resource libraries field entries in the “Set Print Definition Attributes” panel are copied from the APU defaults. If a user overrides any of these resources on this panel, APU will only use these overridden resources. APU does NOT concatenate these overridden resources with entries that might have been specified in the APU defaults initially.
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 text that includes overlays, page segments, and boxes on the front side of a duplexed sheet and then print an overlay on the back side of that duplexed sheet. v You can only specify duplex printing for consecutive pages of the same copy. When you are printing different copies, you cannot specify duplex printing.
114 APU User’s Guide
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 the Overlay Utility (part of AFPU) for overlays, you will not need the overlay commands. The Overlay Utility builds overlays directly on the OS/400. If you are using the Resource Management Utility (also part of AFPU), it provides the functions that are needed to build page segments.
3. Create the Font Resource. Use the CRTFNTRSC command to create an iSeries font resource. Create Type choices, press Enter. Font resource . . . . . . . . . Library . . . . . . . . . . . File . . . . . . . . . . . . . . Library . . . . . . . . . . . Member . . . . . . . . . . . . . Text ’description’ . . . . . . .
Copy From PC Document (CPYFRMPCD) Type choices, press Enter. From folder . . . . . . . . . . FROMFLR resource To file . . . . . . . . . . . . TOFILE temppf Library . . . . . . . . . . . qtemp From document . . . . . . . . . FROMDOC newovl.oly To member . . . . . . . . . . . TOMBR *FIRST Replace or add records . . . . . MBROPT *REPLACE Translate table . . . . . . . . TRNTBL *none Library . . . . . . . . . . . Format of PC data . . . . . . .
Type choices, press Enter. File . . . . . . . . . . . . . . Library . . . . . . . . . . . Source file . . . . . . . . . . Library . . . . . . . . . . . Source member . . . . . . . . . Record length, if no DDS . . . . Generation severity level . . . Flagging severity level . . . . File type . . . . . . . . . . . Member, if desired . . . . . . . Text ’description’ . . . . . . .
You can automate the above process by using the SEGMENT command.Refer to the iSeries Guide to Advanced Function Presentation and Print Services Facility for details. Appendix D.
120 APU User’s Guide
Appendix E. Rotation Hints Methods of Rotating Text Data Figure 121 shows the methods in which text data can be rotated. Figure 121. Rotation Hints Note: Asterisks in the figure above indicate where text can be truncated on certain rotated pages if page length or page width values are not considered. Text can always be truncated on all output pages if line increment values force data to be greater than the page length. General Rules The general rules APU follows when rotating data are: 1.
v Specifying a rotation of 90 or 270 degrees, ensure the page width value is greater than the page length value.
Appendix F. Font Samples This appendix presents a sampling of various fonts provided by IBM. Times New Roman Medium Figure 122. Times New Roman Medium Note: The outline font is CZN200. © Copyright IBM Corp.
Helvetica Roman Bold Figure 123. Helvetica Roman Bold Note: The outline font is CZH400.
Courier Figure 124. Courier Font Samples Note: The outline font is CZ4200, CZ4300, CZ4400, or CZ4500. Appendix F.
126 APU User’s Guide
Glossary A ACIF. AFP Conversion and Indexing Facility. An AFP program you can use to convert a print file into a MO:DCA-P document, to retrieve resources used by the document, and to index the file for later retrieval and viewing. addressable point. Any point in a presentation surface that can be identified by a coordinate from the coordinate system of the presentation medium. See also pel. Advanced Function Presentation (AFP).
batch environment. The environment in which noninteractive programs are run. The environment schedules their processing independently of their submitter. Contrast with interactive environment. Bar Code Object Content Architecture (BCOCA). C character. (1) A symbol that is used in printing. For example, a letter of the alphabet, a numeral, a punctuation mark or any other symbol that represents information. (2) A byte of data. character graphic.
displays, printouts, or files. (2) To arrange such things as characters, fields, and lines. (3) (v.) To prepare a document for printing in a specified format. formatter. A computer program that prepares a source document for printing. forms designer. A person who is responsible for designing electronic or preprinted forms that are readable, usable, and attractive. The forms designer usually has training in graphics design and in the presentation of information. G GDDM. Graphical Data Display Manager.
MICR. Magnetic ink character recognition. Mixed Object Document Content Architecture (MO:DCA-P). A strategic, architected, device-independent data stream for interchanging documents. mixed-pitch font. A font that simulates a proportionally spaced font. The characters are in a limited set of pitches (for example, 10 pitch, 12 pitch, and 15 pitch). monospaced font. A font in which the graphic characters have a uniform character increment. Synonymous with uniformly spaced font.
plotter. An output unit that presents data in the form of a two-dimensional graphic representation. R point. In printing, a unit of about 1/72 of an inch used in measuring typographical material. Each pica contains 12 points. raster font. (1) A font created by a series of pels (picture elements) arranged in scan lines to form an image. (2) A font in which the characters are defined directly by the raster bit map. point size. The height of a font in points. postprocessing option.
software. Programs, procedures, rules, and any associated documentation pertaining to the operation of a system. Contrast with hardware. source format. The format of an AFP resource, other than fonts, used by AFP resource management programs. Contrast with object format. spooling (simultaneous peripheral operation online). (1) The use of auxiliary storage as a buffer storage to reduce processing delays when transferring data between peripheral equipment and the processors of a computer.
Notices References in this publication to products or services of IBM do not suggest or imply that IBM will make them available in all countries where IBM does business or that only products or services of IBM may be used. Noninfringing equivalents may be substituted, but the user must verify that such substitutes, unless expressly designated by IBM, work correctly. No license, expressed or implied, to patents or copyrights of IBM is granted by furnishing this document.
134 APU User’s Guide
Index A accessing APU 16 Actions, Monitor action for input spooled file 83 action for output spooled file 83 creating 89 creating groups 89 for output file 92 for print engine 89 how they are processed 83 input spooled file for 91 selection for input spooled file 83 setting up 89 types of 90 Adobe Type 1, type transformer for 21 AFP advantages of 4 Font Collection 13 optional utilities for APU 13 Overlay Utility for APU 13 Print Format Utility for APU 13 Printer Driver for Windows 29 printing with 5 printin
fields (continued) defining selection 59 editing 48 for user exits 81 four options for mapping 46 mapping 46, 63 mapping as text 47 mapping at multiple locations 49 mapping restrictions 50 mapping the first time 49 mapping to a second position 50 naming 60 page numbering 59 positioning 46, 47 repeat mapping 48 fields, leaving as is 46 fields, supressing 46 font libraries adding 16 font samples 123 Courier 125 examples of 123 Helvetica Roman Bold 124 Times New Roman Medium 123 fonts custom 21 downloading out
Q queues to monitor 88 QYPUEXTSMP, exit program for APYPRTDEF 106 QYPUSYNC program used to add font libraries 16 R resources, identifying 55 RMU, creating page segments with 26 rotating bar codes 30 page segments 26 pages 14 pages in a print definition 58 rotating pages 29 rotating text 26 rotating text data 121 rotating text data, hints for 121 user exit (continued) parameters for user exit middle 104 print options 95 user exits 103 user exits, processing phases for 103 using APU to create a print defini
138 APU User’s Guide
Readers’ Comments — We’d Like to Hear from You PrintSuite for iSeries Advanced Print Utility User’s Guide Publication No.
S544-5351-03 IBMR ___________________________________________________________________________________________________ Readers’ Comments — We’d Like to Hear from You Cut or Fold Along Line _ _ _ _ _ _ _Fold _ _ _and _ _ _Tape _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please _ _ _ _ _do _ _not _ _ staple _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold _ _ _and _ _ Tape ______ NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO.
IBMR Program Number: 5798-AF2 Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber.