IBM S544-5351-03 Appendix C. APU Helpful Hints

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

vWhen initially setting APU defaults, we recommend that you ensure that any

libraries where code pages exist have been added to your current library list.

Command line capability does not exist within APU to add any libraries from

this display.

vAn administrator must ensure that enough library list entries are available

during APU execution for the additional resources listed in the “SetAPU

Defaults” panel.

Maximum APU Values

Because APU builds structure into the document design, some limitations exist on

those structural elements, as shown below.

APU Function Maximum Value

Input page width 250 characters

Input page length 127lines

Number of selection rules per print definition 99

Number of selection fields per print definition 600(including constants in

rules)

Number of page formats per print definition 99

Number of copies per page format 99

Number of text mappings and suppressions per line 250

Number of text constants per copy 250

Number of bar code mappings and bar code constants per

copy 750

Number of different font character sets per copy 32

Number of boxes per copy 99

Number of page segments per copy 99

Number of overlays per copy 99

Print Definition Creation

vWhen you are creating a print definition and have selected a sample spool file,

remember that you are selecting a spool file for reference purposes only.This

spool file may or may not be the actual spool file that is specified for the print

definition for printing.

© Copyright IBM Corp. 1996, 2002 111

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