IBM S544-5351-03 User Exit Middle

Table4. 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 creatingjob&csq;s user

JOBNAM Input creating job&csq;s name

JOBNBR Inputcreating job&csq;s number

INOQNM Input-outputqueue name

INOQLB Input-output queue library

INUSDT Input user data string

INFORM Input form type

INOBIN Input outbin

INPGNM Input creating programname

INPGLB Input creating program library

PRTDEF Empty

PRTDLB Empty

SUCFLG Empty

OTFILE Empty

OTOQNM Empty

OTOQLB Empty

OTHOLD Empty

OTSAVE Empty

OTUSDT Empty

OTFORM Empty

OTOBIN Empty

USRPRM Value from the User Parameter (before) field

User Exit Middle

A USER EXIT MIDDLE program includes the library the programis in and a 20

character user parameter to be passed to the exit program. This program (phase

EXTMID) will be run after the print engine copies the input spooled file to the

input spool database. (This occurs in the CPYSPL phase, which creates the internal

spool database using the CPYSPLF command.)

Following is the parameter structure passed by the APU print engine if a user exit

is called after the input spooled file has been copied to the input spool database:

104 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