IBM S544-5351-03 58

5. Because the Set print definition attributes option was also selected on the

Define a Print Definition panel, you are prompted for such attributes as page

characteristics, default font family,and resource libraries, as shown in Figure 62:

Note: When you specify *INPUT for the Page orientation field, by default APU

always attempts to create the output in Portrait mode. APU attempts to

perform rotation according to the values specified for the Page length

and Page width fields.

6. Specify *inch for unit of measure. If you use a grid overlay with the input

spooled file (an overlay that delineates row and columns), you can choose

*ROWCOL for unit of measure and just specify a row and column position

when placing document elements. This does not provide the same level of

precision as the other units, but for most applications it will be much easier.

7. Page Down to Panel 2 and change the font:

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

Bottom

F4=Prompt F5=Refresh F12=Cancel

Figure 61. Select a Sample Spooled File panel

Set Print Definition Attributes

Print Definition . . INVOICE

Library...... QAPU

Type choices, press Enter.

UnitofMeasure.... *INCH *INCH, *CM, *ROWCOL, *UNITS

Default line increment *INPUT *INCH *INPUT, Value

Default column inc. . . *INPUT *INCH *INPUT, Value

Page length...... 11 *INCH *INPUT, Value

Page width ...... 8.5 *INCH *INPUT, Value

Top margin (down) . . . 0 *INCH 0, Value

Left margin (across) . 0 *INCH 0, Value

Page orientation . . . 0 *INPUT, 0, 90, 180, 270

Apply field attributes 1=Yes

More...

F3=Exit F12=Cancel F22=Set Units

Figure 62. Set Print DefinitionAttributes (Screen 1) panel

58 APU 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