IBM S544-5351-03 APU formatting instructions

The Production Phase

With the new print application designed, it is ready to be placed into production.

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

The APU Monitor automatically monitors iSeries output queues, looking for the

specified spooled file. When that target file is identified, it is retrieved and passed

to the APU print engine. The APU print engine uses the formatting instructions

contained in the APU print definition to create a newAFP output file and place it

in an output queue.

At this point, standard iSeries print management takes over.When the new file is

to be printed, PSF/400 manages the printing process (including the retrieval and

management document resources such as overlays, images, and fonts) to an IPDS

printer.Alternatively, the new print file can be routed through Host Print

Transformto an HP-PCL printer.

APU formatting instructions

APU enables you to build a print definition, which is a set of instructions for

formatting the data that is contained in a spooled print file. Aprint definition can

contain one or more page formats, enabling you to change formatting instructions

for different pages in the spooled file. Withinthe page format, you can define one

or more copies of each input page. Figure2 shows the relationship among these

APU concepts.

Youcan specify a single page format in a print definition, if all of the pages in

your spooled file are formatted in the same way.An application that might require

only one page format is a one-page form such as an invoice, where all of the fields

on the form are predefined, and a second page is never required.

Even though you define only one page format in the print definition, you can still

use the APU multiple copy function to produce differentcopies of the same page,

Figure 2. APU Data Structure

6APU User’s Guide

Contents

Main Page Page Page Contents Figures ...............v Tables ...............vii Purpose of this Publication ......ix Part 1. Understanding and Preparing toUseAPU.............1 Chapter 1. Introducing Advanced Print Utility................3 Chapter 2. Preparing to Use the Advanced Print Utility ........13 Part 4. Appendixes.........99 Figures vi Tables Page Purpose of this Publication APU Enhancements Organization of the Manual Page Part 1. Understanding and Preparing to Use APU Page Chapter 1. Introducing Advanced Print Utility What is APU? What You Can Do with APU Why Use APU? Printing with and without APU 4 Printing without APU Printing with APU The Design Phase The Production Phase APU formatting instructions 6 Steps in Creating an APU Document Step 1: Analyzing the Existing Application Questions you need to Ask 8 Example of Sample Spooled File (Source Input Data) Step 2: Locating Required AFP Resources Step 3: Using APU to Create a Print Definition Defining Page Formats Defining Copies 10 Step 4: Printing with the Print Definition Page Page Chapter 2. Preparing to Use the Advanced Print Utility APU Prerequisites and Options Required Recommended Optional Initial APU Setup 14 Page Font Installation Considerations Review Document Resource Requirements 16 Page Using Fonts with APU 18 Select MapasTexttochange the font that is used for the name. The Map Text panel appears. Select Helvetica Bold in 12-point, and press Enter.The Map Text panel appears again. Figure 11.Map Text panel Figure 12. Select a Font panel Outline Fonts 20 Custom Fonts 22 Figure 15. Work with Fonts panel Figure 16. Display Font Details on Work with Fonts panel On the Work with Fonts panel, add a new font family that is called Special. Figure 17. RequestAddition of the Special Font Figure 18.Add the Special Font to APU Image Resources How APU Works with Image Resources 24 Page Building Image Resources Overlay Resources 26 How APU Works with Overlays Select the INVALLoverlay. The Define Overlay Positionings panel reappears. 28 Figure 23. Select an Overlay panel Figure 24. Define Overlay Positionings panel Building Overlay Resources Bar Code Resources Code 3 of 9 Bar Code Example POSTNET (Postal Bar Code) Bar Code Example 30 How APU Works with Bar Codes Figure 28. Map Bar Code panel Figure 29. Select a Bar Code Typepanel Figure 30. Additional Bar Code Attributes 32 Part 2. Creating Print Definitions with APU Page 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 36 Identifying Resources Working with a Print Definition Further Defining the Print Definition 38 Page Press Enter until the Workwith Print Definitions panel displays. Working with Copies 40 Figure 37. Set Print DefinitionAttributes panel 1 Figure 38. Set Print DefinitionAttributes panel 2 Page Selecting a Sample Spooled File Page Layout Options 42 Page Layout Options You can Set Setting up Duplexing Defining Page Segments Defining Overlays 44 Mapping Field Data Figure 45. Create an Overlay Positioning panel Figure 46. Define Field Mapping panel 46 Mapping a Field as Text Using the Repeat Function 48 Mapping a Field at Multiple Locations Mapping a Field the First Time Mapping a Field to a Second Position Multiple Mapping Restrictions 50 Chapter 4. Building an APU Print Definition for Multiple Page Formats Example of a Multiple Page Format Document Page Page Overview of Defining a Multiple Page Format Document 54 Initial Copy for Page Format One Continuation Page Format Working with a Print Definition Identifying Resources Starting to Work on a Print Definition 2. Select option 1to create a print definition, as shown in Figure58. Developing Your Print Definition 56 Figure 57.APU Main Menu Panel Figure 58. Create a Print Definition Panel 2. The Define a Print Definition panel displays: Figure 59. Work with Multiple Page Formats panel Figure 60. Further Define your Print Definition panel 58 Defining Selection Fields Working with Copies 60 Defining the Page Layout Specifying the Back Overlay 62 Mapping Fields Mapping Bar Codes 64 Page Defining Constant Data 66 1. Position the cursor in the Font field, and press F4. The font database appears. 2. Specify the text Customer Copy and position it 10.8 inches down and 4 inches across the paper. Selecting Fonts Page Defining Overlays 68 Replicating the Contents of Copies 70 8. Repeat these steps to suppress the extension field. The packing list copy is shown below: Figure 80. Suppression panel Figure 81. Repeating a Suppression panel Continuation Page Copies 7. Press Enter to return to the Workwith Page Formats panel, as shown in Figure84. 72 Figure 83. Work with Page Formats panel Figure 84. Work with Page Formats panel Page 74 Figure 87. Define a Rule panel Figure 88. Define a Rule panel Figure 89. Define Selection Rules panel Page Part 3. Printing With APU Page Chapter 5. Manual and Command Line Printing with APU Methods of Printing with APU Manually Associating a Print Definition with a Spooled File Panel 1: Apply Print Definition 80 Panel 2: Apply Print Definition Panel 3: Apply Print Definition Using the Apply Print Definition Command 82 Chapter 6. Automatic Printing with APU Monitor Introduction to the APU Monitor Understanding How the APU Monitor Works An Example of APU Monitor Processing A Customer Environment 84 Implementing the Customer Requirements on the APU Monitor Condition of the Output Queue after Processing 86 Configuring APU Monitor Specifying the Queues APU is to Monitor 88 Configuring APU Monitor Action Initial Panel Creating an Action Group Entry Defining Selection for Input Spooled File 90 Defining Action for Input Spooled File Defining Action for Output Spooled File An Example of this Processing Step 92 Action Page Page Defining User Exit After 96 Starting APU Monitor Stopping APU Monitor Tostop the APU Monitor, return to the APU main menu and select 5. End APU Monitor: 98 Figure 111.Stop APU Monitor panel Page Page Appendix A. APU Samples Table2. Samples in the QAPU Library Page Appendix B. User Exits Processing Phases User Exit Before User Exit Middle 104 User Exit After Table6. Parameters Passed to the User Exit After the AFPDS Spooled File has been Created Sample User Exit Program 106 Page 108 Page 110 Appendix C. APU Helpful Hints APYPRTDEF Command APU Defaults Maximum APU Values Print Definition Creation Mapping Data Copies and Page Formats 112 Page Page Appendix D. AFP Resource Commands Creating Font Resources Creating Overlay Resources 116 Creating Page Segment Resources 2. Transferthe page segment file to the temporary resource file by using the CPYFRMPCD command. 118 3. Create the page segment by using the CRTPAGSEGcommand. Fill in the fields as as shown in the panel above to create an iSeries page segment. Figure 118.Create Temporary Resource File Figure 119.Copy Page Segment to Temporary File Page Page Appendix E. Rotation Hints Methods of Rotating Text Data General Rules Page Page Page Page Page Glossary A B C D 128 E F G H I L M N O 130 P R S T U 132 V W Notices Trademarks Page Index A B C D E G H 136 I M Q R S T U Page Readers Comments Wed Like to Hear from You Readers Comments Wed Like to Hear from You IBMR ___________________________________________________________________________________________________ S544-5351-03 BUSINESS REPLY MAIL