IBM S544-5351-03 manuel d'utilisation

P rin tSui te f o r iS eri e s A d v a n c e d P rin t U tili ty Us er ’ s G u i de S544-5351-03 IBM[...]

[...]

P rin tSui te f o r iS eri e s A d v a n c e d P rin t U tili ty Us er ’ s G u i de S544-5351-03 IBM[...]

Note! Before using this information and the pr oduct it supports, be sure to r ead the general information in “Notices” on page 133. Fourth Edition (May 2002) This edition applies to the licensed program IBM PrintSuite for iSeries: Advanced Print Utility (Pr ogram number 5798-AF2), and to all subsequent releases and modifications until otherwis[...]

Contents Figures ............... v T ables ............... v i i Purpose of this Publication ...... i x APU Enhancements ............ i x Organization of the Manual ......... i x Part 1. Understanding and Preparing t o U s e A P U ............. 1 Chapter 1. Introducing Advanced Print Utility ................ 3 W h a t i s A P U ? .............. 3 W[...]

Chapter 6. Automatic Printing with APU Monitor .............. 8 3 Introduction to the APU Monitor ....... 8 3 Understanding How the APU Monitor W orks . . . 83 An Example of APU Monitor Processing .... 8 4 A Customer Environment ......... 8 4 Implementing the Customer Requirements on the APU Monitor ............. 8 5 Condition of the Output Queue a[...]

Figures 1. Flow of Data Through APU and OS/400 . . . 5 2. APU Data Structure .......... 6 3. APU Concepts ............ 7 4. Steps to Creating a Document ....... 8 5. APU main menu panel ......... 1 0 6. Set APU Defaults panel ........ 1 4 7. Set Print Definition Attributes panel .... 1 5 8. Set Print Definition Attributes panel (Continued) ........[...]

1 1 1. Stop APU Monitor panel ........ 9 8 1 12. Create T emporary Resource File ..... 1 1 5 1 13. Copy From PC Document (CPYFRMPCD) panel .............. 1 1 5 1 14. Create Font Resource (CR TFNTRSC) panel 1 16 1 15. Create T emporary Resource File panel 1 16 1 16. Copying Overlay File from Folder .... 1 1 7 1 17. Create Overlay (CR TOVL) panel ...[...]

T ables 1. Field Mapping V alues ......... 4 8 2. Samples in the QAPU Library ...... 1 0 1 3. APU Print Engine Processing Phases 103 4. Parameters Passed to the Before Initialization User Exit ............. 1 0 3 5. Parameters Passed to the Middle User Exit 104 6. Parameters Passed to the User Exit After the AFPDS Spooled File has been Created . . [...]

viii APU User ’s Guide[...]

Purpose of this Publication This publication helps you to use the IBM PrintSuite for iSeries Advanced Print Utility (APU). It focuses on the concepts of APU, using a series of application examples to demonstrate how APU works. APU has extensive on-line help; we do not duplicate that information here. For details on the concepts of Advanced Function[...]

x APU User ’s Guide[...]

Part 1. Understanding and Preparing to Use APU Chapter 1. Introducing Advanced Print Utility .. 3 W h a t i s A P U ? .............. 3 W h a t Y o u C a n D o w i t h A P U ......... 3 W h y U s e A P U ? ............. 4 Printing with and without APU ........ 4 Printing without APU .......... 4 Printing with APU ........... 5 The Design Phase .....[...]

2 APU User ’s Guide[...]

Chapter 1. Introducing Advanced Print Utility Use this chapter to gain an understanding of what the IBM PrintSuite for iSeries Advanced Print Utility (APU) can do for you, including: v “What is APU?” v “What Y ou Can Do with APU” v “Why Use APU?” on page 4 v “Printing with and without APU” on page 4 v “APU formatting instructions?[...]

Why Use APU? APU assists you in building AFP-compatible electr onic output. Effective electr onic output can provide significant benefits to an or ganization, particularly in the ar eas of information systems costs, process r eengineering, and better communications, for example: v Replacing preprinted multipart forms with electr onic forms supplies[...]

access to the application program sour ce code or no pr ogramming skills exist in-house to implement changes to output pages or documents. Printing with APU Using APU r equires no pr ogramming skills, enabling individuals with graphics and layout ability to design the appearance of the printed page and to easily make changes to printout appearance.[...]

The Production Phase W ith the new print application designed, it is ready to be placed into pr oduction. Y ou define the desired production characteristics to APU. These characteristics include how to identify the target spooled file, which print definition to use, what user-specific pr ograms should be called during pr ocessing, and the dispositi[...]

as would be done with hard copy multipart forms. Y ou can, for example, suppress the price on the packing slip and print some inventory control information on the packing slip as a bar code. When you use APU, each copy can be dif ferent. The same data can be printed at a differ ent position, and dif ferent attributes can be used with each copy . Fo[...]

Step 1: Analyzing the Existing Application Questions you need to Ask The first step in creating a document is to examine the contents of the curr ent application program that is output by asking these questions: v Is the application currently being printed on pr eprinted forms? If so, how complicated is the information on the preprinted forms? If t[...]

LOS ARBOLES DEL MUNDO SAME 32483 ARBOL LANE MESA VERDE IL 54078-9390 141 31341 1/26/98 2/26/98 1/26/98 N10 MICHELE GOODACRE 900 EA 00001200 ARBOLES DEL SUR 45.00 40,500.00 951 CT 11005011 LASSO RED SEEDS 892.23 48,510.73 46 DZ 11005014 SCARLET NANTES SEEDS 5.90 271.40 45 BZ 11005015 CHANTENAY SEEDS 2.19 98.55 951 PK 11005018 EARLY BANTAM SEEDS .38 [...]

Initially , you may need to set the APU defaults if they wer e not previously set. For more information, see “Initial APU Setup” on page 14. Creating a print definition includes defining page formats and defining copies. W e describe these tasks in the sections that follow . Defining Page Formats When you create a print definition, you must spe[...]

After you specify which print definition to apply , APU cr eates another spooled file and sends it to the output queue that you select. Y ou will probably need to experiment some to get the data lined up with the electronic form or to r efine the conditional tests that APU performs to select page formats. When you have completed testing of the prin[...]

12 APU User ’s Guide[...]

Chapter 2. Preparing to Use the Advanced Print Utility Before building your first APU print definition, review the following installation and planning considerations: v “APU Prer equisites and Options” v “Initial APU Setup” on page 14 v “Font Installation Considerations” on page 16 v “Review Document Resource Requir ements” on page [...]

of AFP documents, as well as the ability to search, print, and fax what is viewed. In addition, the full AFP W orkbench includes the IBM AFP Printer Driver for W indows . Use this standar d W indows driver to create overlays and page segments from any W indows application. Non-IBM document product tools , of which many exist, assist you in creating[...]

v For the Job description, we recommend that you use QYPUJOBD in the QAPU library . T wo additional resource libraries, IMAGES and OVERLA YS, were also selected as defaults because APU looks in these libraries for document r esources, such as page segments and overlays. Y ou can specify defaults when you first begin an APU print definition. This di[...]

When you define a copy , you can specify print attributes at this level as well. Y ou can override print attributes or default to the attributes specified at the print definition or APU level. Font Installation Considerations APU installation loads the APU softwar e on to the iSeries and creates the QAPU library . During the installation process, A[...]

Y ou will note the many characteristics that make this invoice an effective document: v Static sections of the page built into an overlay v Company logo and accent image v Use of a variety of fonts v Use of bar coding — POSTNET for the zip code The following sections use the Super Sun Seeds example to provide a close look at the key resour ces th[...]

Using Fonts with APU The examples in the remainder of this manual use the fonts in the AFP Font Collection. Y ou should verify that you have these fonts available before going on. Y our results may dif fer depending on the fonts defined on your system. APU provides an interface that makes selecting fonts simple. During installation, APU determines [...]

Select M a pa sT e x t to change the font that is used for the name. The Map T ext panel appears. Position the cursor on the Font family field, press F4 to have the font database displayed, then select the font you want. Select Helvetica Bold in 12-point, and press Enter . The Map T ext panel appears again. Define Field Mapping Spooled file . . . .[...]

Outline Fonts The current modification level of the APU enables you to download outline fonts to IPDS printers. Y ou must first install the fonts, then update the font database (with the call qapu/qypusync command) before you can take advantage of this technology . Outline fonts are scaleable fonts. A scalable font represents each character by a ma[...]

Custom Fonts APU enables you to add special or custom fonts. Y ou might use a custom font when: v A particular font is an organizational standard. v Y ou need a unique font for a specific application. For example, a marketing document could requir e lar ge characters that are not found in the standar d fonts. v Y ou have modified IBM-supplied font [...]

The APU font database is displayed, showing the Helvetica character sets. Select option 5 to look at an existing character set recor d. The Display Font Details pop-up panel shows the structur e of the font recor ds. Character set C0H40000 is Helvetica Latin1 Roman Bold 10-point. It uses the default code page (that is stored in the APU defaults). T[...]

On the W ork with Fonts panel, add a new font family that is called “Special”. T ype in the font details for the “Special” font on the Add a Font panel. Press Enter to add the “Special” font to the database. See “Creating Font Resour ces” on page 1 15 for more details on fonts and font usage. Work with Fonts Domain . .......: *ALL *[...]

Image Resources Image resour ces ar e a key component in creating advanced electr onic print and presentation applications. In some cases, such as with accent images, the purpose is to improve the look and ef fectiveness of output. Images like logos and signatures ar e essential parts of a document. In other image applications, such as an integrate[...]

Based on the library specified, APU r etrieves all available page segments. Select STR WNB , an accent image of a strawberry , for use on the Super Sun Seeds invoice. The Define Page Segments panel shows the page segment positioning for this copy . The Super Sun Seeds logo was not selected for the invoice document. Instead, this page segment was de[...]

For example, if you have a page segment in the upper left hand corner of an 8 1/2 by 1 1–inch page in portrait mode, and you rotate the entir e page 180 degrees, you will need to recr eate your page segment with a r otation of 180 degrees also. Y ou then will need to specify the new position of the rotated page segment r elative to the original p[...]

How APU Works with Overlays APU can place overlays on any page, in virtually any location. APU can place multiple overlays per page and control the placement of each overlay . APU enables you to specify one constant back overlay , that is, print an overlay by itself on a page without data (for example, a “terms and conditions” page on the back [...]

Select the INV ALL overlay . The Define Overlay Positionings panel reappears. The Define Overlay Positionings panel summarizes which overlays are used for this copy . After you have defined the overlay , return to the Define a Copy panel and select Set Page Layout Options . At the copy level using the Set Page Layout Options panel, define a constan[...]

Note: When you specify *INPUT for the “Page orientation” field, APU always attempts to create the output in Portrait mode by default. APU attempts to perform rotation accor ding to the values specified for the “Page length” and “Page width” fields. Building Overlay Resources IBM provides many alternatives for cr eating electr onic overl[...]

a product, part, or publication number . Bar codes are designed to be read by a device called a bar code reader or scanner . The scanner must be compatible with the printed bar code symbology . The following sections show examples of two bar codes: Code 3 of 9 and POSTNET . Code 3 of 9 Bar Code Example Code 3 of 9 is a discrete bar code symbology b[...]

Y ou can specify the positioning, rotation, and color used for the bar code. Bar code data is displayed only on the Map Bar Code panel. Press F4 to display the Select a Bar Code T ype panel, which shows the 12 major bar codes supported by APU. Select POSTNET . The Map Bar Code Field panel r eappears. Scroll down on this panel to see the additional [...]

................................................................................ : Map Bar Code : : Type choices, press Enter. : : Bar code type . . : 12 - POSTNET : : Bar code data . . : 457892637 : : Length . ..... 9 1-50 : : POSTNET Type . . . 2 1=ZIP Code, : : 2=ZIP+4 Code, : : 3=Advanced Bar Code, : : 4=Variable length data : : : : Bottom : : [...]

Part 2. Creating Print Definitions with APU Chapter 3. Building an APU Print Definition for a Single Page Format ........... 3 5 Example of a Single-Page Format Document . . . 35 Example of the SCS File to be Formatted . . . 35 Example of the Formatted File ....... 3 6 Setting up a Basic Print Definition ....... 3 6 Identifying Resources ..........[...]

34 APU User ’s Guide[...]

Chapter 3. Building an APU Print Definition for a Single Page Format This chapter provides you with a detailed pr ocedur e you use to develop a print definition on OS/400 for a single-page document. Here is a summary of the steps described in this chapter: v “Example of a Single-Page Format Document” v “Setting up a Basic Print Definition” [...]

year, on your next seed order you will receive a 10% discount. $90,652.21 2/26/98 $90,652.21 IMPROVED PRINTING CORP PERFORMANCE BOULEVARD PRINTERSVILLE CO 457892637 Example of the Formatted File The formatted output that you want to produce is shown in Figur e 31. Setting up a Basic Print Definition This section describes the basic steps involved i[...]

Note: The output depends on the fonts that are available on your system. Y our output may not match the following examples. W orking with a Print Definition 1. T ype: GO QAPU/APU on the command line of any OS/400 panel. 2. APU displays its main menu, as shown in Figure 32: 3. Select option 1 , W ork with Print Definitions , fr om the APU main menu.[...]

4. T ype 1 in the option column in the first row , then press Enter to create a new print definition, as shown in Figure 34: 5. T ype the name of the Print Definition. Note: Use the T AB key to move fr om field to field. 6. T ype or select the name of the library where you want to store the print definition. 7. Select *NO for the Multiple Page Form[...]

1. First, type 10 in the OPT column next to your newly-created print definition to access the Define a Print Definition panel, as shown in Figure 35: 2. At this point, you have two options: a. T ype a 1 to access the Select a sample spooled file panel, as shown in Figure 36: This panel allows you to specify a sample SCS spooled file that is to be t[...]

Press Enter until the W ork with Print Definitions panel displays. W orking with Copies A page format needs a minimum of one copy . So, your next step is to examine the default values that APU has applied to the first, *ORIGINAL copy and make any necessary changes. 1. T ype 12 in the option column in the row containing SUNSD1, and the W ork with Co[...]

Y ou do not need to create or name a page format; APU does that for you, naming the page format *DEF AUL T . APU automatically creates the first copy in the page format and names it *ORIGINAL. Y ou can rename it by selecting the rename option or leave it as it is. 2. T o begin defining the contents of the copy , type 10 in the option column in the [...]

v Select Set page layout options to specify the page size, orientation, and margins, as described in “Initial APU Setup” on page 14. v Select Define overlays to name the overlay that you want merged with the application data on the page. v Select Define page segments to include the company logo in the output. v Select Define field mapping to ma[...]

Y ou need to be aware of the capabilities and limitations of duplex printing: What Duplex Printing Does 1. T ype 1 in the duplex printing field if you want simple duplex printing. The result will be that all second pages of the copy will be printed on the back side of the page. Enter a 2 to select tumble duplex. Restrictions 2. Duplex printing can [...]

Defining Overlays Select the Define overlays option to name and position the overlay that you want to use to replace the pr eprinted form. The Define Overlay Positionings panel is shown in Figure 44: Select option 1 to name a new overlay , then press Enter . T ype the name of the overlay , INV ALL, and where you want its top left corner to be posit[...]

If you want to use an overlay that is smaller than the page, you can change its location using the Position across and Position down fields. Assume that this overlay , INV ALL, is designed to fill the whole page and should therefore be positioned at the origin of the paper (0,0). Mapping Field Data Select the Define Field Mapping option to begin ma[...]

Notice that the “header” of the panel displays the spooled file name, the page number , the line number , and the line you are currently dealing with (1/12, 2/12, and so on), and the number of columns currently displayed. T o define and map a field: 1. Position the cursor where you want the field to start in the spooled file and press F14. The [...]

Mapping a Field as T ext In this example, select option 1 to map the customer name as text. When you select M a pa sT e x t , the Map T ext panel appears, as shown in Figure 48: In this example, you need to map the customer ’s name to print in bold and a larger font. This is the ar ea that uses the HELEVTICA font, so you need to select that font.[...]

When you map a field, the mapping is displayed as follows: T able 1. Field Mapping Values 1s Bar code 2s T ext 4s Suppression 1/2s Bar code and text overlapped 1/4s Bar code and suppression overlapped Note: If you want to edit a field you have previously mapped mor e than once (for example, mapping both bar code and text, or both bar code and suppr[...]

Using the Repeat T ext Mapping panel, you can repeat the text mapping you already defined for a field to other lines in the spooled file. T o repeat the mapping you selected, specify the following on the Repeat T ext Mapping panel: v The first row in the spooled file that you want to apply the selected mapping to (13 in this example) v The number o[...]

Mapping a Field to a Second Position If you want to place the field at a differ ent position, pr ess the P AGE-DOWN key to re-display the above window . This time, however , the screen will say “Mapping 2/2”: Keep pressing Enter to exit. Multiple Mapping Restrictions The following restrictions apply to the multiple field location mapping functi[...]

Chapter 4. Building an APU Print Definition for Multiple Page Formats This chapter provides you with a detailed pr ocedur e you use to develop a print definition with APU for a multiple-page format document. Her e is a summary of the steps described in this chapter: v “Example of a Multiple Page Format Document” v “Overview of Defining a Mult[...]

Figure 54. Super Sun Seeds Invoice - Page 1 52 APU User ’s Guide[...]

Figure 55. Super Sun Seeds Invoice - Page 2 Chapter 4. Building an APU Print Definition for Multiple Page Formats 53[...]

Overview of Defining a Multiple Page Format Document This section describes the overall set of steps you will take to define a multiple-page print definition. The specific procedur e is pr ovided beginning in “W orking with a Print Definition” on page 55. Y ou will need to define two different page formats (one for page one and the second for t[...]

Initial Copy for Page Format One APU automatically creates the initial copy for page format one (the default name for the copy is *ORIGINAL). Define the details of that first copy , as follows: 1. Specify general page layout options that includes the constant (T erms and Conditions) back overlay (INVBAC) 2. Map data in the spooled file, such as the[...]

2. Select option 1 to create a print definition, as shown in Figur e 58. 3. From the W ork with Print Definitions panel, create a print definition that is called INVOICE. Define INVOICE as a print definition with multiple page formats, as shown in Figure 58. Developing Y our Print Definition 1. When you have created the INVOICE print definition, se[...]

2. The Define a Print Definition panel displays: 3. From this panel, indicate that you will select a sample spooled file. Y ou can also define the print attributes at the print definition level. 4. First, select a sample spooled file. In this example, select the output (SCS format) called INVSCS, as shown in Figure 61 on page 58: Work with Print De[...]

5. Because the Set print definition attributes option was also selected on the Define a Print Definition panel, you are pr ompted for such attributes as page characteristics, default font family , and resource libraries, as shown in Figur e 62: Note: When you specify *INPUT for the Page orientation field, by default APU always attempts to create th[...]

Defining Selection Fields This is the continuation panel for setting the print definition attributes. After you have completed this panel, the Define Selection Fields panel appears. On this panel, you can view the sample spooled file (INVSCS) and define selection fields, as shown in Figure 64. The sample spooled file, INVSCS, displays. 1. Locate th[...]

2. Change the default field name to something more r ecognizable, such as P AGEN . Note that the page number field has changed to 000 , indicating that it is a defined field, as shown in Figure 66. 3. Press F3 to exit. 4. Keep pressing Enter until the W ork with Print Definition panel displays. W orking with Copies Inside page formats are copies. N[...]

The first copy (*ORIGINAL) of the print definition is automatically created. This first copy will be the Customer Copy of the Super Sun Seeds invoice. Defining the Page Layout 1. Select option 10 to define the page layout of this copy , as shown in Figure 68. The Define a Copy panel shows the composition elements that you can define for this copy .[...]

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 accor ding to the values specified for the Page length and Page width fields. Many of these values default to *PR TDEF , which points to values that are set for this print definition. H[...]

Mapping Fields After you have specified the T erms and Conditions overlay , you will then need to define field mapping for your output. Note: Refer to “Mapping Data” on page 1 12 for some helpful hints on mapping data. Press F3. The Define Field Mapping panel, shown in Figur e 71 on page 64, appears. Figure 70. Back Overlay (T erms and Conditio[...]

APU displays the Super Sun Seeds invoice spooled file for data mapping. W ith data mapping, you can redefine how the application data is to be placed when printed. For the example we are using, we will describe the following: v Mapping bar codes v Defining constant data v Defining Fonts v Defining overlays Note: If you want to map the same field to[...]

4. The Map Bar Code panel is a multi-panel pop-up used to select, define, and position the bar code. The zip code is at row 15, column 16, and the value is shown. Map it (make a copy of the zip code) in bar code to a position starting at 1.1 inches down and 1.6 inches across the paper . It could have also been positioned by row and column. In eithe[...]

Defining Constant Data Next, define the constant text Customer Copy to appear at the bottom of this copy .Specify a text type for this constant. Y ou could also specify a constant bar code. 1. Select option 1 , enter a constant type of *TEXT , then pr ess Enter . The Create Constant T ext panel appears, as shown in Figure 74. 2. Specify the text Cu[...]

Outline Fonts APU supplies Outline fonts in addition to other standard IBM fonts. Refer to “Outline Fonts” on page 20. 2. For this example, select a Helvetica, 10-point, bold font as shown in Figure 75. The Select a Font panel is a pop-up panel in which you specify a font family . Y ou can manually type point size and type style selections, or [...]

Defining Overlays 1. Press F3. The Define Overlays panel appears, as shown in Figur e 77. 2. On the Define Overlays panel, select the Super Sun Seeds invoice overlay (INV ALL) to be printed on this copy . A sample of the INV ALL overlay is shown below: Define Overlay Positionings Print Definition . . : INVOICE Page Forma t.....: * D EFAULT Library [...]

Replicating the Contents of Copies At this point, the composition of the customer copy has been defined. Press Enter until the W ork with Copies panel appears again. 1. Select option 2 to change the text to Customer copy . 2. Select option 3 (copy) to replicate the contents of the customer copy to two additional copies: the Packing list and the Fil[...]

6. Press Enter . 7. Select the function to repeat the suppr ession. In this case, because an invoice can contain up to 31 line items on a page, repeat the suppr ession 30 times for the price field, as shown in Figure 81. 8. Repeat these steps to suppress the extension field. The packing list copy is shown below: Define Field Mapping Spooled file . [...]

Continuation Page Copies At this point, you have defined all the copies within the first page format (P AGE1). 1. Now , return to the W ork with Page Formats panel. 2. Rename *DEF AUL T to P AGE1. 3. Change text to P AGE1 format. 4. From this panel, select option 3 to make a copy of the P AGE1 page format, copies and all. 5. Select option 2 to chan[...]

7. Press Enter to r eturn to the W ork with Page Formats panel, as shown in Figure 84. 8. Select option 12 to work with the P AGEN page format. The W ork with Copies panel appears, as shown in Figure 85 on page 73. Work with Page Formats Print Definition . . : INVOICE Library . .....: Q A P U Type options, press Enter. 1=Create 2=Change 3=Copy 4=De[...]

9. The page format copy function has created the same thr ee copies under the P AGEN page format. At this point, open these copies and make any changes to the page layout for the P AGEN pages. The principal dif ference between the copies is in the use of the differ ent overlays. 10. Press Enter until the W ork with Print Definitions panel appears. [...]

Note: Y ou do not have to type the logic for identifying pages greater than page one. 14. If the value of P AGEN is not 1 , then APU will select page format P AGEN, as shown in Figure 88. 15. After you have defined rules for P AGE1 and P AGEN, pr ess Enter . The Define Selection Rules panel appears. On this panel, APU summarizes the curr ent select[...]

16. After you have completed the selection rules, pr ess F3 to return to the W ork with Print Definitions panel. Define Selection Rules Print definition . . INVOICE Library ...... Q A P U Type options, press Enter. 1=Create 2=Modify 4=Delete Page format Opt Rule Cond Field Test Field or ’ Characters ’ Act. or Rule 10 IF PAGEN *EQ ’ 1 ’ *USE[...]

76 APU User ’s Guide[...]

Part 3. Printing With APU Chapter 5. Manual and Command Line Printing with APU ............... 7 9 Methods of Printing with APU ........ 7 9 Manually Associating a Print Definition with a Spooled File .............. 7 9 Panel 1: Apply Print Definition ....... 8 0 Panel 2: Apply Print Definition ....... 8 1 Panel 3: Apply Print Definition ....... 8 [...]

78 APU User ’s Guide[...]

Chapter 5. Manual and Command Line Printing with APU This chapter describes the methods of printing your print definition, and describes two of these three standar d methods in detail: v “Methods of Printing with APU” v “Manually Associating a Print Definition with a Spooled File” v “Using the Apply Print Definition Command” on page 82 [...]

Panel 1: Apply Print Definition APU will move the input spooled file to the output queue defined in the Success or Failure fields, depending on the r esult, and will place the file in one of the four status conditions shown above. *HOLD is the default for both success and failure. Some of the fields you should fill out include: Input Spooled File N[...]

Panel 2: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Her e is a description of some of the key fields: User exit BEFORE Initializes the name of a program you want r un before pr ocessing. Refer to “User Exit Before” on page 103. User exit MIDDLE Name of a program you want to be r un after the input[...]

Panel 3: Apply Print Definition Make the entries you want. Press F1 for descriptions of the fields. Key field entries here ar e: Output bin Where the output is to be placed. User exit AFTER Name of a program you want to be r un after the AFPDS output spooled file has been created. Refer to “User Exit After” on page 105. Using the Apply Print De[...]

Chapter 6. Automatic Printing with APU Monitor This chapter describes the third method of printing APU print definitions. (The other two methods are described in Chapter 5, “Manual and Command Line Printing with APU” on page 79.) T o give you an understanding of the operation of the APU Monitor , the following topics are described her e: v “I[...]

Figure 94 diagrams the sequence in which the APU Monitor pr ocesses the action groups. Here is an explanation of the steps shown in the diagram: 1. The monitor is invoked each time a spooled file arrives in a monitored output queue or if the spooled file status from a spool in a monitor ed queue changes to *RDY . Spooled files with other status con[...]

– The application’s original spooled files must be placed in the OUTQ called SA VE . – The original QSYSPR T spooled files must be deleted. The Figure 95 diagrams these customer requir ements. The numbers in the figure are used to identify the sequence of notes pr ovided following this diagram. Notes 1. All QSYSPR T spooled files fr om the OU[...]

The numbers in the figure indicate the actions that corr espond with Figur e 96 . Notes 1. Action for the application spooled files in OUTQ1 2. Action for all other application spooled files in all monitored OUTQs 3. Action for all other spooled files in OUTQ1 4. Action for all other spooled files in all other OUTQs Many other options are possible [...]

2. All QSYSPR T spooled files fr om the other OUTQs are in the output queue PTR02. 3. The original application SCS spooled files from OUTQ1 ar e in the output queue SA VE. New AFPDS spooled files have been placed in the output queue PR T01. This new spooled file is the result fr om APU after applying the print definition. 4. All other original appl[...]

Specifying the Queues APU is to Monitor The first task to perform is to specify the queues (OUTQs) the APU Monitor is to monitor . Y ou can add or remove OUTQs from the list. Y ou need to add only the queue where the spooled file action is performed on an APU print definition. If a spooled file comes from other OUTQs, no pr ocessing on them is done[...]

Configuring APU Monitor Action T o set 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: v Selection for input spooled [...]

2. T ype in a sequence number . APU Monitor uses this number to determine when to perform the test that is specified by the rule. If you want this test performed first, enter a number that is less than any previous r ule number . 3. T ype in a description of the rule. Note: Note that a rule may apply to all thr ee types of action groups. 4. W ithin[...]

Y ou enter values that APU uses to select the input spooled file. Following is a description of the values you can enter: Spooled file name This can be a specific name, a generic name, or *ALL. Output queue/Library This can be a specific output queue, a generic name, or *ALL. User This can be a specific user , a generic set, or *ALL. User Data This[...]

v T ransform the input database file to an AFP database file, using specified APU print definition v W rite the output AFP database file to the specified output queue v Call the “after” user program The Define Action for Output Spooled File display , consisting of two displays for each action group, pr ovide for configuring the pr ocessing opti[...]

For the monitor , the user must define two actions for output spooled files. Each action refers to one of the print definitions. At run time, the print engine runs both print definitions with a differ ent Output Queue for each. Notes 1. Action for the application spooled files in OUTQ1. An additional output action sequence is added. 2. A second pri[...]

Notes 1. The QSYSPR T spooled files fr om OUTQ1 are in PR T01 OUTQ. 2. All QSYSPR T spooled files fr om the other OUTQs are in PR T02 OUTQ. 3. All original application spooled files from OUT1 ar e placed in OUTQ SA VE after processing. A new AFPS spooled file has been placed in PR T01 for each spooled file formatted with the print definition “SAM[...]

On this panel, you specify the name, library , and user-defined parameter for the program that APU is to call before, during, or after processing. The default is *NONE. Refer to Appendix B, “User Exits” on page 103 for details about the user exits. The Print Definition lines contain values for the library where the print definition is stored, a[...]

output queue where the input spooled file was found. *DEV has APU place the file into the output queue of the device specified in the Output Device field. Defining User Exit After This panel is used to specify what is to be done after processing a file. File The File field is the name of the output spooled file. Use *PR TDEF if you want the output [...]

User exit after The User exit after field contains the name, library , and user defined parameter for the program to be called by APU after the output spooled file has been created. Starting APU Monitor Begin at the APU Main menu, as shown in Figur e 109: Select 4. Start APU Monitor to display the panel shown in Figure 1 10: T ype in the job descri[...]

Stopping APU Monitor T o stop the APU Monitor , return to the APU main menu and select 5. End APU Monitor: APU IBM Advanced Print Utility Select one of the following: Build and Test APU Print Definitions 1. Work with Print Definitions 2. Work with Spooled Files Run APU in Batch Mode 3. Work with APU Monitor 4. Start APU Monitor 5. End APU Monitor C[...]

Part 4. Appendixes © Copyright IBM Corp. 1996, 2002 99[...]

100 APU User ’s Guide[...]

Appendix A. APU Samples T o help you become familiar with APU, the following sample materials have been provided in the QAPU library: T able 2. Samples in the QAPU Library Name T ype AMASTER Print definition example to be used with INVPRE. GRID Overlay GRID1 Overlay INV ALL Overlay INVBAC Overlay INVFST Overlay INVHEAD Overlay INVHEAD2 Overlay INVL[...]

102 APU User ’s Guide[...]

Appendix B. User Exits This appendix describes the user exits that are r eferr ed to in “Defining User Exit Before and Middle” on page 94 and “Defining User Exit After” on page 96. Processing Phases Following is a description of the processing phases the APU print engine goes through in general and when pr ocessing the user exits: T able 3.[...]

T able 4. 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 cr eating job&csq;s user JOBNAM Input creating job&csq;s name JOBNBR Input creating job&csq;s number INOQNM Input-[...]

T able 5. Parameters Passed to the Middle 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 cr eating job&csq;s user JOBNAM Input creating job&csq;s name JOBNBR Input creating job&csq;s number INOQNM Input-output queue na[...]

T able 6. Parameters Passed to the User Exit After the AFPDS Spooled File has been Created 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 cr eating job&csq;s user JOBNAM Input creating job&csq;s name JOBNBR Input creating job&cs[...]

DCL VAR(&EXPARM) TYPE(*CHAR) LEN(512) /* Type of exit point (*BEFORE,*MIDDLE,*AFTER) */ DCL VAR(&EXTYPE) TYPE(*CHAR) LEN(10) /* Name of input spooled file */ DCL VAR(&EXINFILE) TYPE(*CHAR) LEN(10) /* Name of input spooled file number */ DCL VAR(&EXINNBR) TYPE(*CHAR) LEN(10) /* Input Printer device type */ DCL VAR(&EXINTYPE) TYPE[...]

/* Output User data */ DCL VAR(&EXOTUSDT) TYPE(*CHAR) LEN(10) /* Output Form type */ DCL VAR(&EXOTFORM) TYPE(*CHAR) LEN(10) /* Output out-bin */ DCL VAR(&EXOTOBIN) TYPE(*CHAR) LEN(10) /* User specified parameter for exit pgm */ DCL VAR(&EXUSRPRM) TYPE(*CHAR) LEN(20) /* Reserved for future use */ DCL VAR(&RESERVED) TYPE(*CHAR) LE[...]

IF COND(&EXTYPE = *AFTER) THEN(GOTO + CMDLBL(STEP3_AFT)) GOTO CMDLBL(STEP4) /******************************************************************************/ /* */ /* STEP 3: Perform specific commands depending on calling */ /* ------- exit point in APYPRTDEF */ /* */ /*****************************************************************************[...]

’ / ’ *CAT &EXPRTDEF *BCAT ’ for ’ *BCAT + &EXJOBUSR *CAT ’’’ s ’ *BCAT ’ spooled file ’ + *BCAT &EXINFILE *TCAT ’ . ’ *CAT &EXINNBR + *BCAT ’ type ’ *BCAT &EXINTYPE *BCAT ’ from + output queue ’ *BCAT &EXINOQLB *TCAT ’ / ’ + *CAT &EXINOQNM *TCAT ’ ) ’ ) TOUSR(*SYSOPR) GOTO CMDLBL([...]

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 dif fer ent positions. Refer to “Processing Phases” on page 103. APU Defaults[...]

v Initially , the additional resource libraries field entries in the “Set Print Definition Attributes” panel are copied fr om the APU defaults. If a user overrides any of these resour ces on this panel, APU will only use these overridden resources. APU does NOT concatenate these overridden resour ces with entries that might have been specified [...]

Duplex v When you enable duplex printing on the “Set Page Layout Options” display , specify *NONE for Back Overlay on this display because APU cannot print text that includes overlays, page segments, and boxes on the front side of a duplexed sheet and then print an overlay on the back side of that duplexed sheet. v Y ou can only specify duplex [...]

11 4 APU User ’s Guide[...]

Appendix D. AFP Resource Commands This appendix describes how to build iSeries resour ce objects fr om font, overlay , and page segment files that are cr eated on a client system. If you ar e using the Overlay Utility (part of AFPU) for overlays, you will not need the overlay commands. The Overlay Utility builds overlays directly on the OS/400. If [...]

3. Create the Font Resour ce. Use the CR TFNTRSC command to create an iSeries font resour ce. Creating Overlay Resources The following section describes how to create overlay r esour ces. 1. Create a temporary r esour ce file as follows. From an iSeries command line, issue the CR TPF command to cr eate a file to receive the PC r esources. The “Cr[...]

3. Create the Overlay . Use the CR TOVL command to create an iSeries overlay: An alternative to using the individual steps that are described above is to build and use the OVERLA Y command. Refer to the iSeries Guide to AFP Printing and PSF for details. Creating Page Segment Resources The following section describes how to create page segment r eso[...]

2. T ransfer the page segment file to the temporary resource file by using the CPYFRMPCD command. 3. Create the page segment by using the CR TP AGSEG command. Fill in the fields as as shown in the panel above to create an iSeries page segment. Create Physical File (CRTPF) Type choices, press Enter. F i l e.............. FILE > TEMPPF Library . .[...]

Y ou can automate the above process by using the SEGMENT command.Refer to the iSeries Guide to Advanced Function Presentation and Print Services Facility for details. Appendix D. AFP Resource Commands 11 9[...]

120 APU User ’s Guide[...]

Appendix E. Rotation Hints Methods of Rotating T ext Data Figure 121 shows the methods in which text data can be rotated. Note: Asterisks in the figure above indicate wher e text can be truncated on certain rotated pages if page length or page width values ar e not consider ed. T ext can always be truncated on all output pages if line incr ement va[...]

v Specifying a rotation of 90 or 270 degr ees, ensur e the page width value is greater than the page length value. 122 APU User ’s Guide[...]

Appendix F . Font Samples This appendix presents a sampling of various fonts pr ovided by IBM. T imes New Roman Medium Note: The outline font is CZN200. Figure 122. Times New Roman Medium © Copyright IBM Corp. 1996, 2002 123[...]

Helvetica Roman Bold Note: The outline font is CZH400. Figure 123. Helvetica Roman Bold 124 APU User ’s Guide[...]

Courier Note: The outline font is CZ4200, CZ4300, CZ4400, or CZ4500. Figure 124. Courier Font Samples Appendix F . Font Samples 125[...]

126 APU User ’s Guide[...]

Glossary A ACIF . AFP Conversion and Indexing Facility . An AFP program you can use to convert a print file into a MO:DCA-P document, to r etrieve resour ces used by the document, and to index the file for later retrieval and viewing. addressable point. Any point in a presentation surface that can be identified by a coordinate fr om the coordinate [...]

batch environment. The environment in which noninteractive programs ar e run. The envir onment schedules their processing independently of their submitter . Contrast with interactive environment. Bar Code Object Content Architecture (BCOCA). C character . (1) A symbol that is used in printing. For example, a letter of the alphabet, a numeral, a pun[...]

displays, printouts, or files. (2) T o arrange such things as characters, fields, and lines. (3) (v .) T o pr epare a document for printing in a specified format. formatter . A computer program that pr epares a sour ce document for printing. forms designer . A person who is responsible for designing electronic or pr eprinted forms that are readable[...]

MICR. Magnetic ink character recognition. Mixed Object Document Content Architecture (MO:DCA-P). A strategic, architected, device-independent data stream for inter changing documents. mixed-pitch font. A font that simulates a proportionally spaced font. The characters ar e in a limited set of pitches (for example, 10 pitch, 12 pitch, and 15 pitch).[...]

plotter . An output unit that presents data in the form of a two-dimensional graphic repr esentation. point. In printing, a unit of about 1/72 of an inch used in measuring typographical material. Each pica contains 12 points. point size. The height of a font in points. postprocessing option. A hardware device that attaches to the output side of a p[...]

software. Programs, pr ocedures, r ules, and any associated documentation pertaining to the operation of a system. Contrast with hardwar e. source format. The format of an AFP resource, other than fonts, used by AFP r esource management programs. Contrast with object format. spooling (simultaneous peripheral operation online). (1) The use of auxili[...]

Notices References in this publication to pr oducts or services of IBM do not suggest or imply that IBM will make them available in all countries where IBM does business or that only products or services of IBM may be used. Noninfringing equivalents may be substituted, but the user must verify that such substitutes, unless expressly designated by I[...]

134 APU User ’s Guide[...]

Index A accessing APU 16 Actions, Monitor action for input spooled file 83 action for output spooled file 83 creating 89 creating gr oups 89 for output file 92 for print engine 89 how they are pr ocessed 83 input spooled file for 91 selection for input spooled file 83 setting up 89 types of 90 Adobe T ype 1, type transformer for 21 AFP advantages o[...]

fields (continued) defining selection 59 editing 48 for user exits 81 four options for mapping 46 mapping 46, 63 mapping as text 47 mapping at multiple locations 49 mapping restrictions 50 mapping the first time 49 mapping to a second position 50 naming 60 page numbering 59 positioning 46, 47 repeat mapping 48 fields, leaving as is 46 fields, supre[...]

Q queues to monitor 88 QYPUEXTSMP , exit program for APYPR TDEF 106 QYPUSYNC program used to add font libraries 16 R resour ces, identifying 55 RMU, creating page segments with 26 rotating bar codes 30 page segments 26 pages 14 pages in a print definition 58 rotating pages 29 rotating text 26 rotating text data 121 rotating text data, hints for 121[...]

138 APU User ’s Guide[...]

Readers’ Comments — We’d Like to Hear from Y ou PrintSuite for iSeries Advanced Print Utility User ’ s Guide Publication No. S544-5351-03 Overall, how satisfied are you with the information in this book? V ery Satisfied Satisfied Neutral Dissatisfied V ery Dissatisfied Overall satisfaction hhhhh How satisfied are you that the information in[...]

Readers’ Comments — We’d Like to Hear from Y ou S544-5351-03 S544-5351-03 IBMR Cut or Fold Along Line Cut or Fold Along Line Fold and T ape Please do not staple Fold and T ape Fold and T ape Please do not staple Fold and T ape NO POST AGE NECESSARY IF MAILED IN THE UNITED ST A TES BUSINESS REPL Y MAIL FIRST -CLASS MAIL PERMIT NO. 40 ARMONK, N[...]

[...]

IBMR Program Number: 5798-AF2 Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber . S544-5351-03[...]