IBM S544-5351-03 - Manuals

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...

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 ...

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. ...

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 . ....

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...

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...

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...

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...

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...

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...

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...

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. ...

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 ...

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 , ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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 ...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

– 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. ...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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&...

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...

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 ...

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...

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...

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 ...

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...

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...

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...

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

Helvetica Roman Bold Note: The outline font is CZH400. Figure 123. Helvetica Roman Bold 124 APU User ’s Guide

Courier Note: The outline font is CZ4200, CZ4300, CZ4400, or CZ4500. Figure 124. Courier Font Samples Appendix F. Font Samples 125

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...

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...

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...

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...

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...