IBM S544-5351-03 Configuring APU Monitor Action

Configuring APU Monitor Action

Toset 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 following

three parts:

vSelection for input spooled file

vAction for input spooled file

vAction for output spooled file

The Configure APU Monitor Action display allows you to create, change, copy,

and delete actions. Each action is performed in the sequence shown on the display

by the APU print engine.

Initial Panel

The Configure APU Monitor Action panel allows you to develop a table with

selections and actions that the APU monitor and print engine have to perform.

The initial panel allows a user to create, change, copy or delete action entries. The

F22 key is used to renumber the entries automatically.The renumbering uses an

increment of 10 unless the number of records is greater than 999. In that case the

increment will be calculated depending on the number of records.

At runtime the monitor will retrieve the SCS spooled file attributes and try to find

a matching entry.The monitor evaluates the entries in the order of the user-entered

sequence numbers. As soon as the monitor finds a match, it processes the spooled

file according to the rest of the information in the table. If is does not find a match

in the table, a message is put into the monitor’s joblog and the spooled file is not

processed.

Creating an Action Group Entry

Tocreate an action group entry, proceed as follows.

1. Type1under the OPT column to create a new sequence number, as shown in

Figure102 on page90.

Configure APU Monitor Action

Type options, press Enter.

1=Create 2=Change 3=Copy 4=Delete

Opt Sequence Text

_1

20 Qsysprt spool in all other OUTQ’s

30 QPJOB spool in OUTQ1

40 QPJOB spool in all other OUTQ’s

50 All other spool in OUTQ1

60 All other spool in all other OUTQ’s

F3=Exit F5=Refresh F12=Cancel F22=Renumber Sequence

Figure 101. Configure APU Monitor Action panel

Chapter6. Automatic Printing with APU Monitor 89

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