IBM AS/400 Chapter 21. AFP Utilities for AS/400 Commands

Chapter 21. AFP Utilities for AS/400 Commands

This chapter describes the commands for AFP Utilities for AS/400. The AFP

Utilities for AS/400 provide the following eight commands:

STRAFPU

STROVLU

STRPFU

PRTPFDDTA

CVTPCDPAGS

CVTPFMPAGS

CVTOVLPFM

CVTPAGSPFM

You can enter the above commands on any display that contains the command

line.

STRAFPU (Start AFP Utilities for AS/400) Command

The STRAFPU command displays the IBM Advanced Function Printing Utilities for

AS/400 menu that allows you to use the AFP Utilities functions.

There are no parameters for this command.

STROVLU (Start Overlay Utility) Command

STROVLU command allows you to perform an option of the Overlay Utility directly

without viewing the Work with Source Overlays display.

Figure 37 on page 356 shows the command syntax for STROVLU command.

Contents

Main Page Page Second Edition (February 1998) Contents iv vi viii x Page Page Figures xiv Notices Trademarks and Service Marks Page About IBM Advanced Function Printing Utilities for AS/400 AS/400 Information Directory AS/400 Information Directory Publications Reference Advanced Function Presentation: Printer Information Who Should Use This Book Introduction to IBM Advanced Function Printing Utilities for AS/400 Page Chapter 1. What are the IBM Advanced Function Printing Utilities for AS/400? What You Can Do with AFP Utilities for AS/400 4 Page Using Overlays 6 Page Page Overlay Utility Print Format Utility 10 Page Resource Management Utility 12 AFP Resource and AFP Utilities for AS/400 Requirements for Use of the AFP Utilities for AS/400 Hardware Requirement Software Requirement 14 AFP Utilities Fundamentals (Concepts) Libraries, Files, and Members Elements AFP Utilities for AS/400 Displays F4 for list Source overlay Library Design display List view: Function Keys 18 Related Online Information Help for Displays Extended help Contextual help InfoSeeker Page Overlay Utility 22 Chapter 2. Introduction to the Overlay Utility Print Form and Overlay Page Operation Flow 26 Page Page Chapter 3. Getting Started with the Overlay Utility Step 1 - Starting the Overlay Utility 30 Step 2 - Creating a Source Overlay File 1. Type 2 on the command line. Type OVLLIB in the The Work with Source Overlay Files display appears. prompt and press the Enter key to list source overlay files stored in OVLLIB. Example Actions 32 User specified DBCS data Example Actions Step 3 - Creating a Source Overlay In this step, an overlay is designed by creating a source overlay. 1. Type 1 (Create) in the column in the first line of the list. 2. Type STATIONERY in the Defining a Text Element 1. Type AS/4 Stationery Co., Ltd. in the 36 prompt in the key entry area. 4. Press the Enter key. Defining a Line Element Press the Enter key to define the line element in the source overlay. 38 Mark %L003 changes to *L003 in the display to show that the line is correctly defined. Defining a Box Element Press the Enter key to define the box element in the source overlay. Defining a Bar Code Element 40 1. Type 1 in the prompt. 2. Type 5A-3233-1 in the prompt. 3. Press the Enter key to define the bar code element in the source overlay. Placing a Graphics Element 42 1. Type 2 in the prompt. 1. Type QAFCGRPH in the prompt. 2. Type QGPL in the prompt. 3. Press the Enter key. \FIRST in the 44 Press the F3 key (Exit). Press the F3 key to exit from this display. 1. Type 1 (Save and exit) in the prompt. 1. Type Sample Form number 3 inthe 46 The following display appears with the completion message. Press the F3 key to complete the source overlay creation. Press the F3 key to exit from this display. Step 4 - Changing a Source Overlay Placing a Page Segment 48 1. Type 2 in the column next to the source overlay name STATIONERY. The Change Source Overlay display appears. The Design Overlay display appears. 50 1. Type QFCLOGO for the prompt. Press the F3 key to complete designing overlay. The Change Source Overlay display appears. Press the F3 key to exit changing a source overlay. The Exit Overlay Utility display appears. 52 1. Type 1 for the prompt. Creating an Overlay from a Source Overlay Example Actions: prompt. 54 Step 5 - Using an Overlay AS/400 Guide to Advanced Function Presentation and Print Services Facility Overriding a Printer File Example Actions: Printing Overlays with AFP Utilities for AS/400 Chapter 4. Starting and Ending the Overlay Utility Starting the Overlay Utility Option 1 (Work with source overlays) 58 Option 2 (Work with source overlay files) Ending the Overlay Utility Chapter 5. Work with Source Overlays 60 Page Showing a Source Overlay List 62 Selecting a Source Overlay from a List 1=Create a Source Overlay Define Overlay Specifications 64 Using the Define Overlay Specifications display, you can define the overlay The information specified on this display is used : Page 66 Change Overlay Specifications cases. 68 Figure 16 (Page 2 of 2). The Causeof a Message andIts Results Underline Character size Confirm Delete of Elements Reason 70 Work with Source Overlay Fonts Design Overlay Saving a Source Overlay Step 4. Type 1 in the 72 prompt, and press the Enter key. The Save Source Overlay display appears. On the Save Source Overlay display, you can specify the following: 2=Change a Source Overlay 3=Copy a Source Overlay 74 4=Delete a Source Overlay 6=Print a Source Overlay 76 7=Rename a Source Overlay New member 9=Create Overlay 78 Return to source overlay list Page Chapter 6. Work with Source Overlay Files The following table explains each field on this display. 82 The following display appears by pressing the Enter key on the previous display. The following tables explain each field of the Work with Source Overlay Files 84 Columns Showing a Source Overlay File List Selecting a Source Overlay File from a List 86 1=Create Source Overlay File Press the Enter key after you specify the choices. 88 2=Change Source Overlay File Description 3=Copy Source Overlay File 90 4=Delete Source Overlay File 7=Rename Source Overlay File 92 New object 8=Display Description of Source Overlay File 12=Work with Source Overlays Print Format Utility 94 Chapter 7. Introduction to Print Format Utility Printout Format Definition (PFD Definition) PFD Specifications PFD Definition Fonts 96 Database File Record Layout Page Layout Elements 98 Record Selection Printout Specifications Mapping Object Name Printing with Print Format Utility 100 Operation Flow Page 102 Chapter 8. Getting Started with Print Format Utility 104 Step 2 - Creating a PFD Definition File Example Actions: 106 User specified DBCS data Example Actions: Step 3 - Creating a PFD Definition The actions with a 1 in the 108 Define printout specifications column beside Page 110 Specifying Fixed Text Data 112 1. Type Product : inthe The Design Record Layout display appears as follows. Specifying Variable Text Data from a Database File Record 114 1. Type 1 in the You can select the field in a record format by typing a 1 (Select) in the Move the cursor to the The Define Text Detail display appears again with the selected field name in the prompt. In this case &NAME. is displayed because NAME is the selected field. Specifying a Page Segment 116 1. Type QFCLOGO in the prompt. Specifying a Bar Code Element 118 Specifying a Box Element You can draw a box in the record layout. 120 Press the Enter key to define the box element in the record layout. Specifying a Line Element You can draw a line in a record layout. Exiting from Design Record Layout 122 The function key area changes and F11=Place record layout is displayed. Press the F11 key to place a record. 124 You can type the desired choices in the detail list. Page Example Action: 126 1. Type 2 in the Defining Printout Specifications Example Actions: prompt. Form definition prompt. Exiting from Defining the PFD Definition Now you can save the PFD definition and exit from defining a PFD definition. 128 From this display, you can print a database file. Step 4 - Printing a Database File 130 When the database file is printed, the following display appears: Press the F3 key. 132 Press the F3 key to return to the AS/400 Main Menu. Page Chapter 9. Starting and Ending the Print Format Utility Option 11 (Work with PFD definitions) 136 Option 12 (Work with PFD definition files) Option 13 (Print Database File Member) Page Page Chapter 10. Work with PFD Definitions 140 Page Columns 142 Showing a PFD Definition List Selecting a PFD Definition from a List 1=Create PFD Definitions The following table explains each field of the Create PFD Definition display. 144 Page 146 Define PFD Specifications Page 148 Page Change PFD Specifications 150 Page Confirm Delete of Elements 152 Confirm Delete of Page Layout Elements Confirm Delete of Record Layout Elements appears. Work with PFD Definition Fonts 154 Specify Database File Select Database File column beside the database file to select, and press the Enter Select Record Format 156 Specify 1 in the Specify Break Fields column beside the fields to be selected and press the Enter key. 158 Type 1 in the Design Record Layout Data in Record Layout Variable Data: Reserved Variable Data: Member File 160 Then press the F11 key. The following display appears: Fixed Data: Concatenation of Variable Data and Fixed Data: 162 Numeric Editing On this display, you can specify an edit code and an edit code modifier. 164 Design Page Layout From the following display you can specify the design of the page layout. 166 Page Repetition of the Record in the Page 168 Page 170 The following figure shows the above choices: Page 172 Page 174 Page Text 176 Print at page break only Print at page break only 178 Specify Record Selection AND/OR 180 Value Field Define Printout Specifications 182 Page 184 Specify Mapping Object Name 186 The following table explains each field of the Mapping Page Segment Name display: Page segment Database field value Saving PFD Definition 188 When you specify 1 in the prompt and Y in the Return to PFD definition list prompt, the following display appears: When you press the Enter key after specifying these prompts, the following display appears: 2=Change PFD Definition column beside the PFD definition that you want to change. The following display appears: 3=Copy PFD Definition 192 4=Delete PFD Definition 6=Print PFD Definition 194 7=Rename PFD Definition New member 9=Print Database File Chapter 11. Work with PFD Definition Files 196 Page 198 Page Showing a PFD Definition File List 200 Library PFD Definition file Selecting a PFD Definition File from a List 1=Create PFD Definition File 202 2=Change PFD Definition File 3=Copy PFD Definition File 204 4=Delete PFD Definition File 7=Rename PFD Definition File 206 New object 8=Display Description of PFD Definition File 12=Work with PFD Definitions Chapter 12. Print Database File Member Start Printing from Work with PFD Definitions Display 208 The following table describes the Print Database File Member display. Library Database file the Printout specifications 210 You can choose a database file and a member from the list. For example, move the cursor to the prompt and press F4. The Select Database File Member display appears: Page 212 Start Printing from the AFP Utilities Menu To start printing, type 13 at the command line on the AFP Utilities menu. You can show the list of PFD definition files in the specified library. Move the cursor to the prompt, and press the F4 key. The Select PFD Definition File display appears: 214 Start Printing by PRTPFDDTA The following command prompt appears: See page 208 through 212 for more information. Page Design Operation and Fonts Page Chapter 13. Design Operation Element Types Text Graphics 220 Design Overlay Source overlay Record Layout Design Display Screen View List View Defining Elements in the Screen View 222 Layout of the Screen View The screen view of the design display is shown: The following table explains each field in the above display. Element Indication on Image Area - Element Mark Element Mark On/Off 224 Hide Refresh Scroll Function Keys: Control field Control Control Field: Element Operations in the Screen View 226 Define Element Operation Change Element Operation Edit Operation Function Keys on the Design Display 228 Figure 24 (Page 2 of 2). Common Function Keys for all Operations on the Design Display Figure 25. Function Keys for Base Operation on the Design Display Figure 26. Function Keys for Define or Change Operation on the Design Display Figure 27. Function Keys for Place Operation on the Design Display Defining or Changing an Element 230 Page 232 Text 234 Page Text data 236 User specified DBCS data User specified DBCS data 238 When you press Enter, the Overlay Utility and the Print Format Utility check the Font Selection: DBCS font Font or the Font Number 240 Page Press the Enter, F3, or F12 key after you specify the parameters, or press the F4 242 By pressing the F4 key, the following display appears to specify those characteristics. Page 244 Page 246 Page Shading pattern 248 Shading pattern shading pattern Text data Text placement 250 Page Horizontal 252 Vertical horizontal Bar Code 254 Press the Enter, F3 or F12 key after you specify the parameters, or press the F4 Press the Roll Up (Page Down) key to see the next page of the Define Bar Code Detail display. 256 Page 258 The following explains the Bar Code Data: 260 Page Check digit 262 Check Digit: Page 264 Page 266 Select Page Segment: Specify Variable Page Segment: 268 Graphics When you specify '2=File' as the source object type, the following display appears: 270 The following table explains each field in these displays. Page 272 When you specify '2=File' as the source object type, the following display appears: The following table explains each field in these displays. Select Field in Record Format (Graphics): prompt, the following occurs: , or If you press F4 (Detail) in the Place Graphics Detail display when the cursor is in the Folder, PC document, Library, 274 Specify Variable Graphics: Record Layout By pressing the F4 key, the following display appears. 276 Page 278 Copy, Move, and Remove an Existing Element Element Edit Block Edit 280 window if necessary. Page Changing Elements in the List View 282 Layout of the List View Page 284 Create or Change the Element Create Change 286 Sort Element List Copy, Move, Remove, or Restore Element Edit Across Down Across Page Chapter 14. Work with Fonts 290 Page 292 Font type 2=Change Font Font type Change Font (Font Type=1): CL Reference 294 When you choose 2 for the Change Font (Font Type=2): Change Font (Font Type=3): When you choose 3 for the prompt, the following display appears. 296 Opt. 5=Display Font column beside the font number you want to display. 2. Press Enter. Display Font (Font Type=2) Display Font (Font Type=3) 298 Opt. 9=Set Initial Font Resource Management Utility 300 Chapter 15. Introduction to the Resource Management Utility (RMU) Converting to an AS/400 Page Segment Converting to a Page Segment from an AS/400 Database File Converting to a Page Segment from a PC Document 302 Working with Overlays Copying an Overlay Working with Page Segments Page Page Chapter 16. Getting Started with the Resource Management Utility Starting Resource Management Utility Converting a PC Document to a Page Segment 308 Example Actions: Change image size From PC document Printing an Overlay 310 Page Printing a Page Segment 312 Page 314 Chapter 17. Starting and Ending the Resource Management Utility Starting the Resource Management Utility Starting the Resource Management Utility with the STRAFPU Option 21 : Convert to Page Segment Function Starting the Resource Management Utility with the CVTPCDPAGS The following display appears when you type data in the fields and press the F10 Press the Enter key and the following display appears. 318 Starting the Resource Management Utility with the CVTPFMPAGS The following display appears when you type data in the fields and press the F10 Press the Enter key and the following display appears. Starting the Resource Management Utility with the CVTOVLPFM 320 From this display, you can convert an overlay object to a database file member. field to '\YES', and press Starting the Resource Management Utility with the CVTPAGSPFM 322 Chapter 18. Convert to Page Segment Function The following table describes the fields on the Convert to Page Segment display: 324 prompt, the following display appears. the The following table describes the fields on the Convert to Page Segment display: 326 Change image size When you select Y (Yes) for the prompt and press Enter, the Convert to Page Segment display changes as follows: The following table describes the fields newly shown on the Convert to Page Segment display: 328 Length Width Page Page Page Page Chapter 19. Work with Overlays Function Overlay 334 Columns 3=Copy Overlay Object 4=Delete Overlays 336 6=Print Overlay Page 338 7=Rename Overlay 8=Display Overlay Description 9=Convert Overlay to Physical File Member 1. Type data in the prompts. 2. PressEnter. The prompt appears as follows when you specify 'Y' in the Create prompt: The following table describes the Convert Overlay to File display. file-name 340 library-name member-name 13=Change Overlay Text Page Chapter 20. Work with Page Segments Function 344 Columns 3=Copy Page Segment 4=Delete Page Segments column beside the page segment that you want to delete. 2. Press Enter. 6=Print Page Segment 346 Page 7=Rename Page Segment 348 8=Display Page Segment Description 9=Convert Page Segment to Physical File Member 1. Type data in the prompts. 2. PressEnter. prompt for the file appears when you specify 'Y in the The following table describes the Convert Page Segment to File display. file-name 350 library-name Page segment 13=Change Page Segment Text Page References 354 Chapter 21. AFP Utilities for AS/400 Commands STRAFPU (Start AFP Utilities for AS/400) Command STROVLU (Start Overlay Utility) Command source-overlay-file-name 356 source-overlay-name STRPFU (Start Print Format Utility) Command PFD-definition-file-name 358 PFD-definition-name Page Page PFD-definition-file-name 362 PFD-definition-name Page page-number 364 number-of-copies output-queue-name form-definition-name CVTPCDPAGS (Convert PC Document to Page Segment) Command 366 Page page-segment-name 368 folder-name PC-document-name width-value length-value 370 authorization-list-name CVTPFMPAGS (Convert Physical File Member to Page Segment) 372 Page page-segment-name 374 width-value length-value 376 Page authorization-list-name 378 CVTOVLPFM (Convert Overlay to Physical File Member) Command Page 380 Page CVTPAGSPFM (Convert Page Segment to Physical File Member) 382 Page 384 Page Page Chapter 22. Limitations and Restrictions Overlay Utility Limitations Minimum and Maximum Limitations Dashed and Dotted Lines Source Overlay File 388 Font Page Segment Line Box Text in Box Print Format Utility Limitations Minimum and Maximum Limitations Dashed and Dotted Lines Line Width and Page Size Element Position PFD Definition File 392 Font Page Segment Line Box Text in Box Shading in Box Graphics (GDF) Size Resource Management Utility Limitations Restrictions IMDS (IOCA) Data Stream Print Operation Creating Page Segment Converting an Overlay to a Physical File Member Sending Source Overlays and PFD Definitions Page Chapter 23. Problem Analysis No Yes 0100 (continued) 398 Page 0100 (continued) 400 Software Installation 0100 (continued) Software Installation 402 Common Symptoms and Possible Causes Printer Device Programming 404 Character size Sense Codes and Possible Causes Character size 406 Color Contacting Your Service Representative Element Type and Position Text Element and Position Line Element and Position 408 Line Placement is Center Line Placement is Border Box Element and Position Line Placement is Border Line Placement is Center: 410 Bar Code Element and Position Top of the row and left edge of the column is the bar code position. Top left corner of the bar code area is positioned. Page Segment Element and Position Top of the row and left edge of the column is the page segment position. Record Layout Element and Position Top of the row and left edge of the column is the record layout position. Top left corner of the record layout is positioned. Graphics Element and Position 412 Appendix A. Printer Characteristics Advanced Function Printing: Printer Information Supported Printers 414 Offset Advanced Function Printing Utilities for OS/400 Licensed Program Specifications Printable Area 3812 Printer 3816 and 3930 Printers 3820 Printer 3825 Printer 3827 and 3829 Printers 416 3831 Printer 3835 Printer 3900 Printer 3916 and 4028 Printers 4224 Printer 3935 Printer 418 4234 Printer 4230 Printer Page Appendix B. Rotation, Format, and Shading Pattern in Box Format, Text Placement and Rotation Format Text placement Format Degree of Rotation 422 Page Page Page Page Page Page Page Page Page Page Page Page Page Page Shading Pattern in Box Shading pattern Shading type Page Page Page Appendix D. Using GDFs in AFP Utilities Figure 59 (Page 1 of 2). 442 Figure 59 (Page 2 of 2). Page Appendix E. How to Do a Task How to Use This Chapter Tasks Related to Source Overlays Tasks Related to Source Overlay Files 446 Tasks Related to PFD Definitions Tasks Related to PFD Definition Files Tasks Related to Overlay Objects Tasks Related to Page Segments 448 Note: The following description assumes that you are on a display with the Tasks Related to Screen View of Design Display Defining an Element Handling Existing Elements Changing the View of the Display 450 Tasks Related to List View of Design Display Defining an Element Handling Existing Elements Tasks Related to Each Element Text Element The Define Text Detail display The Change Text Detail display Line Element 452 Pattern Line width The Define Line Detail display The Change Line Detail display Graphics Element Note: The following description assumes that you are on one of the following The Place Graphics Detail display The Change Graphics Detail display Page Segment Element Note: The following description assumes that you are on one of the following Record Layout Element 454 Value (Field, number, or 'character') Test Field F4 for list Tasks Related to Overlay Specifications and PFD Specifications Tasks Related to Font Task Related to Printout Specifications 456 Source drawer Duplex Print quality Appendix F. Portability to Other Systems Overstrike Underline IPDS Towers Fonts 458 Page Segments PSF (Print Service Facility) Appendix G. Sample Overlays and Sample PFD Definitions Sample Overlays DMAS Forms MAPICS/DB Forms 460 Sample PFD Definitions AIAG (Automotive Industry Action Group) Labels EIA (Electronic Industries Association) Labels 462 Appendix H. Code 128 Character Set Page Page Page Page Page Glossary interactive job interactive descending sequence control language (CL) 470 characters per inch (cpi) extended help physical file logical file all authority element mark element name character key 472 human readable interpretation (HRI) control character key entry area batch document library folder image area screen view 474 electronic overlay all authority page up ward general-purpose library private authority public authority resource management utility (RMU) 476 spooled output file data authority fixed data Page Index Special Characters Numerics A B C 480 D 482 E F G 484 H I J K L M N 486 O P Page R 488 S T 490 U V W Page Page Readers' Comments We'd Like to Hear from You BUSINESS REPLY MAIL