IBM AS-400 User Manual
AS/400 Advanced Series IBM
Advanced Function Printing Utilities for
AS/400 User’s Guide
S544-5349-01
AS/400 Advanced Series IBM
Advanced Function Printing Utilities for
AS/400 User’s Guide
S544-5349-01
Note!
Before using this information and the product it supports, be sure to read the general information in
“Notices” on page xv.
Second Edition (February 1998)
This edition applies to Version 4 Release 2 of AFP Utilities for AS/400 (Program 5769-AF1), and to all subsequent releases and
modifications until otherwise indicated in new editions or technical newsletters.
Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the
address given below.
The IBM Printing Systems Company welcomes your comments. A form for reader's comments is provided at the back of this
publication. If the form has been removed, you may send your comments to the following address:
INFORMATION DEVELOPMENT
THE IBM PRINTING SYSTEMS COMPANY
DEPARTMENT H7FE BUILDING 003G
PO BOX 1900
BOULDER CO 80301-9191
If you prefer to send comments electronically, use one of the following methods:
| Internet: printpub@us.ibm.com
Fax: 1-800-524-1519
Internet
| Visit our home page at http://www.printers.ibm.com
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes
appropriate without incurring any obligation to you.
Copyright International Business Machines Corporation 1996, 1998. All rights reserved.
Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to
restrictions set forth in GSA ADP Schedule Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Trademarks and Service Marks ........................... xv
About IBM Advanced Function Printing Utilities for AS/400 ......... xvii
Who Should Use This Book ............................. xviii
Chapter 1. What are the IBM Advanced Function Printing Utilities for
AS/400? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What You Can Do with AFP Utilities for AS/400 ................... 4
Using Overlays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Using Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Using Bar Codes ................................... 8
Using Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Overlay Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Print Format Utility ................................... 10
Resource Management Utility ............................. 12
AFP Resource and AFP Utilities for AS/400 .................... 13
Requirements for Use of the AFP Utilities for AS/400 ............... 13
Hardware Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Software Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
AFP Utilities Fundamentals (Concepts) ....................... 14
Libraries, Files, and Members ........................... 14
Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
AFP Utilities for AS/400 Displays ......................... 15
Menu Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Work with Display ................................ 15
Design display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Related Online Information .............................. 19
Help for Displays .................................. 19
InfoSeeker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Help for Control Language Commands ...................... 19
Chapter 2. Introduction to the Overlay Utility ................. 23
Print Form and Overlay ................................ 23
Source Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Overlay Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Overlay Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Design Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Operation Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 3. Getting Started with the Overlay Utility .............. 29
Step 1 - Starting the Overlay Utility ......................... 30
Step 2 - Creating a Source Overlay File ...................... 31
Step 3 - Creating a Source Overlay ......................... 33
Defining a Text Element .............................. 34
Defining a Line Element .............................. 37
Defining a Box Element .............................. 38
Defining a Bar Code Element ........................... 40
Placing a Graphics Element ............................ 42
Copyright IBM Corp. 1996, 1998 iii
| Viewing the Overlay with the AFP Workbench Viewer ............. 44
| Saving the Source Overlay ............................. 45
Step 4 - Changing a Source Overlay ........................ 48
Placing a Page Segment .............................. 48
Creating an Overlay from a Source Overlay ................... 53
Step 5 - Using an Overlay ............................... 55
Overriding a Printer File .............................. 55
Using the Printer File ................................ 55
Printing Overlays with AFP Utilities for AS/400 ................. 56
Chapter 4. Starting and Ending the Overlay Utility .............. 57
Starting the Overlay Utility ............................... 57
Option 1 (Work with source overlays) ...................... 58
Option 2 (Work with source overlay files) .................... 58
Ending the Overlay Utility ............................... 58
Chapter 5. Work with Source Overlays ..................... 59
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Showing a Source Overlay List ............................ 62
Selecting a Source Overlay from a List ....................... 62
1=Create a Source Overlay .............................. 63
Define Overlay Specifications ........................... 64
Change Overlay Specifications ......................... 67
Confirm Delete of Elements .......................... 69
Work with Source Overlay Fonts ......................... 70
Design Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Saving a Source Overlay ............................ 71
2=Change a Source Overlay ............................. 73
3=Copy a Source Overlay ............................... 74
4=Delete a Source Overlay .............................. 75
6=Print a Source Overlay ............................... 76
7=Rename a Source Overlay ............................. 77
9=Create Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter 6. Work with Source Overlay Files ................... 81
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Showing a Source Overlay File List ......................... 85
Selecting a Source Overlay File from a List .................... 86
1=Create Source Overlay File ............................ 87
2=Change Source Overlay File Description ..................... 89
3=Copy Source Overlay File ............................. 90
4=Delete Source Overlay File ............................. 91
7=Rename Source Overlay File ........................... 92
8=Display Description of Source Overlay File ................... 92
12=Work with Source Overlays ............................ 92
Chapter 7. Introduction to Print Format Utility ................. 95
Printout Format Definition (PFD Definition) ..................... 95
PFD Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
PFD Definition Fonts ................................ 96
iv AFP Utilities for AS/400 User’s Guide
Database File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Page Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Record Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Printout Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Mapping Object Name ............................... 98
Printing with Print Format Utility .......................... 99
Operation Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Chapter 8. Getting Started with Print Format Utility ............ 103
| Step 1 - Starting the Print Format Utility ...................... 104
Step 2 - Creating a PFD Definition File ...................... 105
Step 3 - Creating a PFD Definition ......................... 107
| Specifying a Database File ............................ 108
| Designing a Record Layout ........................... 110
Specifying Fixed Text Data .......................... 111
Specifying Variable Text Data from a Database File Record ....... 113
Specifying a Page Segment ......................... 116
Specifying a Bar Code Element ....................... 118
Specifying a Box Element ........................... 119
Specifying a Line Element .......................... 121
Exiting from Design Record Layout ..................... 122
| Designing a Page Layout ............................ 122
Defining Printout Specifications ......................... 126
Exiting from Defining the PFD Definition .................... 127
Step 4 - Printing a Database File ......................... 130
| Step 5 - Ending the Print Format Utility ...................... 131
| Step 6 - Printing the AFP Utilities tutorial ..................... 132
Chapter 9. Starting and Ending the Print Format Utility .......... 135
| Starting the Print Format Utility ........................... 135
Option 11 (Work with PFD definitions) ..................... 136
Option 12 (Work with PFD definition files) ................... 136
Option 13 (Print Database File Member) .................... 136
| Option 14 (Print AFP Utilities tutorial) ..................... 136
| Ending the Print Format Utility ........................... 137
Chapter 10. Work with PFD Definitions .................... 139
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Showing a PFD Definition List ........................... 142
Selecting a PFD Definition from a List ....................... 142
1=Create PFD Definitions .............................. 143
Define PFD Specifications ............................ 146
Change PFD Specifications .......................... 150
Confirm Delete of Elements ......................... 152
Work with PFD Definition Fonts ......................... 154
Specify Database File .............................. 154
Select Database File .............................. 155
Select Record Format ............................. 156
Specify Break Fields ............................... 157
Design Record Layout .............................. 158
Contents v
Data in Record Layout ............................ 159
Numeric Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Design Page Layout ............................... 165
Repetition of the Record in the Page .................... 168
Specify Record Selection ............................. 179
Define Printout Specifications .......................... 182
Specify Mapping Object Name ......................... 185
Saving PFD Definition ............................. 188
2=Change PFD Definition .............................. 190
3=Copy PFD Definition ............................... 191
4=Delete PFD Definition ............................... 193
6=Print PFD Definition ................................ 194
7=Rename PFD Definition .............................. 194
9=Print Database File ................................ 194
Chapter 11. Work with PFD Definition Files ................. 195
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Showing a PFD Definition File List ......................... 200
Selecting a PFD Definition File from a List .................... 200
1=Create PFD Definition File ............................ 201
2=Change PFD Definition File ........................... 203
3=Copy PFD Definition File ............................. 204
4=Delete PFD Definition File ............................ 205
7=Rename PFD Definition File ........................... 206
8=Display Description of PFD Definition File ................... 206
12=Work with PFD Definitions ........................... 206
Chapter 12. Print Database File Member ................... 207
Start Printing from Work with PFD Definitions Display ............. 207
Start Printing from the AFP Utilities Menu .................... 213
Start Printing by PRTPFDDTA ........................... 215
Chapter 13. Design Operation . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Element Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Bar Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Page Segment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Defining Elements on the Design Display ..................... 220
Design Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Screen View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Defining Elements in the Screen View ..................... 222
Layout of the Screen View .......................... 222
Element Indication on Image Area - Element Mark ............ 223
Element Mark On/Off ............................. 224
Hide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
vi AFP Utilities for AS/400 User’s Guide
Element Operations in the Screen View .................... 226
Define Element Operation ........................... 226
Change Element Operation .......................... 226
Edit Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Function Keys on the Design Display ..................... 227
Defining or Changing an Element ........................ 230
Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Bar Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Page Segment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Copy, Move, and Remove an Existing Element ................ 279
Element Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Block Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Changing Elements in the List View ........................ 282
Layout of the List View ............................ 282
Create or Change the Element ......................... 285
Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Sort Element List ................................. 286
Copy, Move, Remove, or Restore ........................ 286
Element Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Chapter 14. Work with Fonts .......................... 289
2=Change Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
5=Display Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9=Set Initial Font ................................... 298
Chapter 15. Introduction to the Resource Management Utility (RMU) .. 301
Converting to an AS/400 Page Segment ..................... 301
Converting to a Page Segment from an AS/400 Database File ....... 301
Converting to a Page Segment from a PC Document ............ 302
Working with Overlays ................................ 303
Copying an Overlay .............................. 303
Deleting an Overlay .............................. 304
Renaming an Overlay ............................. 304
Printing an Overlay .............................. 304
Displaying an Overlay Description ...................... 304
Changing an Overlay Description ...................... 304
Converting an Overlay to Physical File Member .............. 304
Working with Page Segments ........................... 304
Copying a Page Segment ........................... 304
Deleting Page Segments ........................... 304
Renaming a Page Segment ......................... 304
Printing a Page Segment ........................... 305
Displaying a Page Segment Description .................. 305
Changing a Page Segment Description ................... 305
Converting a Page Segment to a Physical File Member ......... 305
Chapter 16. Getting Started with the Resource Management Utility ... 307
Starting Resource Management Utility ....................... 307
Converting a PC Document to a Page Segment ................. 308
Contents vii
Printing an Overlay .................................. 309
Printing a Page Segment .............................. 312
Chapter 17. Starting and Ending the Resource Management Utility ... 315
Starting the Resource Management Utility .................... 315
Starting the Resource Management Utility with the STRAFPU Command 315
Option 21 : Convert to Page Segment Function .............. 316
Option 22 : Work with Overlays Function .................. 316
Option 23 : Work with Page Segments Function ............. 316
Starting the Resource Management Utility with the CVTPCDPAGS
Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Starting the Resource Management Utility with the CVTPFMPAGS
Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Starting the Resource Management Utility with the CVTOVLPFM Command 320
Starting the Resource Management Utility with the CVTPAGSPFM
Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
| Ending the Resource Management Utility ..................... 322
Chapter 18. Convert to Page Segment Function ............... 323
Chapter 19. Work with Overlays Function .................. 333
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
3=Copy Overlay Object ............................... 335
4=Delete Overlays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
6=Print Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
7=Rename Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
8=Display Overlay Description ........................... 338
9=Convert Overlay to Physical File Member ................... 338
13=Change Overlay Text .............................. 341
Chapter 20. Work with Page Segments Function .............. 343
Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
3=Copy Page Segment ............................... 345
4=Delete Page Segments .............................. 345
6=Print Page Segment ................................ 346
7=Rename Page Segment ............................. 348
8=Display Page Segment Description ....................... 348
9=Convert Page Segment to Physical File Member ............... 348
13=Change Page Segment Text .......................... 351
Chapter 21. AFP Utilities for AS/400 Commands .............. 355
STRAFPU (Start AFP Utilities for AS/400) Command .............. 355
STROVLU (Start Overlay Utility) Command ................... 355
STRPFU (Start Print Format Utility) Command .................. 357
PRTPFDDTA (Print PFD Data) Command .................... 360
CVTPCDPAGS (Convert PC Document to Page Segment) Command .... 366
CVTPFMPAGS (Convert Physical File Member to Page Segment) Command 372
CVTOVLPFM (Convert Overlay to Physical File Member) Command ..... 378
CVTPAGSPFM (Convert Page Segment to Physical File Member) Command 382
viii AFP Utilities for AS/400 User’s Guide
Chapter 22. Limitations and Restrictions ................... 387
Overlay Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Minimum and Maximum Limitations ..................... 387
Dashed and Dotted Lines ........................... 387
Line Width and Overlay Size ......................... 387
Element Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Source Overlay File .............................. 388
Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Page Segment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
Text in Box ................................... 389
Shading in Box ................................. 390
Graphics (GDF) Size ............................. 390
Text Font in Graphics (GDF) ......................... 390
Overlay object authority ............................ 390
Printer Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Print Format Utility .................................. 390
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Minimum and Maximum Limitations ..................... 390
Dashed and Dotted Lines ........................... 391
Line Width and Page Size .......................... 391
Element Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
PFD Definition File ............................... 392
Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Page Segment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Text in Box ................................... 393
Shading in Box ................................. 393
Graphics (GDF) Size ............................. 393
Text Font in Graphics (GDF) ......................... 393
Printer Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Resource Management Utility ............................ 394
Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
IMDS (IOCA) Data Stream .......................... 394
Print Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Creating Page Segment ............................ 394
Converting an Overlay to a Physical File Member ............. 394
Converting the Page Segment to a Physical File Member ........ 394
Sending Source Overlays and PFD Definitions .................. 395
Chapter 23. Problem Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . 397
How to Use This Procedure ............................. 397
Identifying Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
0100: Problem Analysis Procedures ...................... 397
Common Symptoms and Possible Causes .................... 402
Sense Codes and Possible Causes ........................ 405
Contacting Your Service Representative ..................... 407
Element Type and Position ............................. 407
Contents ix
Text Element and Position ............................ 407
Measurement Method is Row/Column .................... 407
Measurement Method is Inch or Centimeter ................ 407
Line Element and Position ............................ 408
Measurement Method is Row/Column .................... 408
Measurement Method is Inch or Centimeter ................ 409
Box Element and Position ............................ 409
Measurement Method is Row/Column .................... 409
Measurement Method is Inch or Centimeter ................ 410
Bar Code Element and Position ......................... 410
Measurement Method is Row/Column .................... 410
Measurement Method is Inch or Centimeter ................ 410
Page Segment Element and Position ...................... 410
Measurement Method is Row/Column .................... 410
Measurement Method is Inch or Centimeter ................ 411
Record Layout Element and Position ...................... 411
Measurement Method is Row/Column .................... 411
Measurement Method is Inch or Centimeter ................ 411
Graphics Element and Position ......................... 411
Measurement Method is Row/Column .................... 411
Measurement Method is Inch or Centimeter ................ 412
Appendix A. Printer Characteristics . . . . . . . . . . . . . . . . . . . . . . 413
Supported Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Printable Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Printer Storage Limitations ............................. 414
Limitations for Each Printer ............................. 414
3812 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
3816 and 3930 Printers ............................. 415
3820 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
3825 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
3827 and 3829 Printers ............................. 416
3831 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
3835 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
3900 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
3916 and 4028 Printers ............................. 417
4224 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
3935 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
4234 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
4230 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Appendix B. Rotation, Format, and Shading Pattern in Box ....... 421
Format, Text Placement and Rotation ....................... 421
Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Text Placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Degree of Rotation ................................ 422
Shading Pattern in Box ............................... 437
Appendix C. Rotation of Graphics ....................... 439
Appendix D. Using GDFs in AFP Utilities ................... 441
Appendix E. How to Do a Task ......................... 445
How to Use This Chapter .............................. 445
x AFP Utilities for AS/400 User’s Guide
Tasks Related to Source Overlays ......................... 445
Tasks Related to Source Overlay Files ...................... 446
Tasks Related to PFD Definitions ......................... 446
Tasks Related to PFD Definition Files ....................... 447
Tasks Related to Overlay Objects ......................... 447
Tasks Related to Page Segments ......................... 448
Tasks Related to Screen View of Design Display ................ 448
Defining an Element ............................... 448
Handling Existing Elements ........................... 449
Changing the View of the Display ........................ 450
Tasks Related to List View of Design Display .................. 450
Defining an Element ............................... 450
Handling Existing Elements ........................... 450
Tasks Related to Each Element .......................... 451
Text Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Line Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
Box Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
Bar Code Element ................................. 452
Graphics Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
Page Segment Element ............................. 453
Record Layout Element ............................. 454
Tasks Related to Database File Selection .................... 454
Tasks Related to Record Selection ........................ 454
Tasks Related to Overlay Specifications and PFD Specifications ....... 455
Tasks Related to Font ................................ 455
Task Related to Printout Specifications ...................... 456
Task Related to Mapping Object .......................... 456
Task Related to Break Fields ............................ 456
Appendix F. Portability to Other Systems ................... 457
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
IPDS Towers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
PT2 Tower (Underline and Overstrike) ..................... 457
Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Page Segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
PSF (Print Service Facility) ........................... 458
Appendix G. Sample Overlays and Sample PFD Definitions ....... 459
Sample Overlays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
DMAS Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
MAPICS/DB Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
Sample PFD Definitions ............................... 460
AIAG (Automotive Industry Action Group) Labels ............... 461
EIA (Electronic Industries Association) Labels ................ 461
| AFP Utilities Tutorial PFD Definitions ...................... 461
Appendix H. Code 128 Character Set ..................... 463
Appendix I. Font Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Times New Roman Medium ............................. 465
Helvetica Roman Bold ................................ 466
Courier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Contents xi
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
xii AFP Utilities for AS/400 User’s Guide
Figures
1. Conventional Letter Preparation ......................... 5
2. Letter Preparation Using AFP Utilities ...................... 6
3. Using Overlays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4. Using Page Segments .............................. 8
5. Sample Overlay (Created by the Overlay Utility) ............... 9
6. Sample Label (Created by the Print Format Utility) ............. 10
7. Print Sample (Labels) .............................. 11
8. Members and Files in a Library ........................ 14
9. Menu for the IBM Advanced Function Printing Utilities for AS/400 .... 15
10. Prompts and Columns on the Work with Source Overlays Display .... 16
11. Design Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
12. Summary of AFP Utilities Function Keys ................... 18
13. Sample Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
14. Overview of Overlay Utility Operation ..................... 26
15. Sample Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
16. The Cause of a Message and Its Results .................. 68
17. Record Layout Sample ............................. 96
18. Page Layout Sample .............................. 97
19. Overview of Print Format Utility Operation ................. 100
20. Sample Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
21. The Cause of Message and Its Result ................... 150
22. Function Keys for Scroll Operation ..................... 225
23. Commands in Control Field for Scroll Operation .............. 225
24. Common Function Keys for all Operations on the Design Display ... 227
25. Function Keys for Base Operation on the Design Display ........ 228
26. Function Keys for Define or Change Operation on the Design Display . 229
27. Function Keys for Place Operation on the Design Display ........ 229
28. Function Keys for Edit Operation on the Design Display ......... 230
29. Function Keys to Specify End Position on the Design Display ..... 230
30. Position and Distance of the Record in the Page Layout ......... 278
31. Process of Converting to Page Segment .................. 302
32. Letters which Contain a Page Segment .................. 303
33. Example of Position-and-Trim Mapping ................... 329
34. Example of Scale-to-Fit Mapping ...................... 329
35. Example of Center-and-Trim Mapping ................... 330
36. Example of Rotating the Image Block .................... 331
37. Command Syntax for STROVLU Command ................ 356
38. The Command Syntax for STRPFU Command .............. 358
39. The Command Syntax for PRTPFDDTA Command ............ 361
40. The Command Syntax for CVTPCDPAGS Command .......... 367
41. The Command Syntax for CVTPFMPAGS Command .......... 373
42. The Command Syntax for CVTOVLPFM Command ........... 379
43. The Command Syntax for CVTPAGSPFM Command .......... 382
44. Print Example - 1 ............................... 423
45. Print Example - 2 ............................... 424
46. Print Example - 3 ............................... 425
47. Print Example - 4 ............................... 426
48. Print Example - 5 ............................... 427
49. Print Example - 6 ............................... 428
50. Print Example - 7 ............................... 429
Copyright IBM Corp. 1996, 1998 xiii
51. Print Example - 8 ............................... 430
52. Print Example - 9 ............................... 431
53. Print Example - 10 ............................... 432
54. Print Example - 11 ............................... 433
55. Print Example - 12 ............................... 434
56. Print Example - 13 ............................... 435
57. Print Example - 14 ............................... 436
58. Print Example - 15 ............................... 437
59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
60. Times New Roman Medium ......................... 465
61. Helvetica Roman Bold ............................. 466
62. Courier Font Samples ............................. 467
xiv AFP Utilities for AS/400 User’s Guide
Notices
References in this publication to products 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 IBM, work correctly. No license, expressed or implied, to patents or copyrights of
IBM is granted by furnishing this document. You can send license inquiries, in writing, to the IBM Director
of Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594, USA.
Licensees of this program who wish to have information about it for the purpose of enabling: (1) the
exchange of information between independently created programs and other programs (including this one)
and (2) the mutual use of the information, which has been exchanged, should contact: IBM Corporation,
Printing Systems Company Legal Department, Mail Drop 001W, Boulder, Colorado 80301 USA. Such
information may be available, subject to appropriate terms and conditions, including in some cases,
payment of a fee.
Trademarks and Service Marks
The following terms, denoted by an asterisk (*) in this publication, are trademarks of the IBM Corporation
in the United States or other countries or both:
| Advanced Function Presentation
Advanced Function Printing
AFP
Application System/400
AS/400
BCOCA
GDDM
IBM
IPDS
MAPICS
Other company, product and service names, which may be denoted by a double asterisk (**), may be
trademarks or service marks of others.
OS/2
OS/400
Personal Computer AT
Personal System/2
Print Services Facility
PSF
System/370
400
Copyright IBM Corp. 1996, 1998 xv
xvi AFP Utilities for AS/400 User’s Guide
About IBM Advanced Function Printing Utilities for AS/400
| The IBM Advanced Function Printing Utilities for AS/400 (AFP/U), Version 4
| Release 2, is a licensed program consisting of three integrated modules that
| provide support for Advanced Function Printing (AFP) applications on AS/400. This
| book describes how to use the AFP Utilities for AS/400. It includes detailed
| reference information as well as extensive examples.
This book consists of the following parts.
Introduction to IBM Advanced Function Printing Utilities for AS/400
introduces the concept of AFP Utilities for AS/400 and provides general
information.
Overlay Utility provides detailed information about the Overlay Utility, helps
you decide how to use the Overlay Utility, and provides practical exercises.
Print Format Utility provides detailed information about the Print Format Utility,
and describes how to use the Print Format Utility with practical exercises.
Design Operation and Fonts provides detailed information about designing
elements in an overlay, in a record layout, and in a page layout. It also
provides detailed information about the fonts that you can use for the Overlay
Utility and Print Format Utility.
Resource Management Utility provides detailed information about the
Resource Management Utility, and describes how to use the Resource
Management Utility with practical exercises.
Reference describes the AFP Utilities for AS/400 commands, the limitations
and restrictions of the AFP Utilities for AS/400 program, and provides problem
analysis information.
Practice exercises described in the “Getting Started with ...” chapters enable you to
quickly become familiar with AFP Utilities for AS/400. After the exercises, see the
| detailed information to do more complex tasks. The best resource for learning
| about AFP applications on AS/400 is the
|
Presentation and Print Services Facility,
AS/400 Guide to Advanced Function
S544-5319.
The following AS/400 books contain information you may need.
CL Reference
Printer Device Programming
, SC41-4722, provides the information about the CL commands.
, SC41-4713, provides the information about printing on
the AS/400 system.
|
| information about AFP printers, their characteristics, and resident fonts.
Advanced Function Presentation: Printer Information
, S544-3290, provides general
For information about other AS/400 publications, see either of the following:
The
The
Publications Reference
book, SC41-4003, in the AS/400 Softcopy Library.
AS/400 Information Directory
, a unique, multimedia interface to a
searchable database containing descriptions of titles available from IBM or from
selected other publishers. The
AS/400 Information Directory
is shipped with
your system at no charge.
Copyright IBM Corp. 1996, 1998 xvii
Who Should Use This Book
This book is intended for AS/400 users, such as system administrators, system
programmers, and anyone who uses the AS/400 system.
Before you use this book, you should be familiar with the introductory material for
using the AS/400 system. You do not need to understand how to use a high-level
programming language to use AFP Utilities
xviii AFP Utilities for AS/400 User’s Guide
Introduction to IBM Advanced Function Printing Utilities for
AS/400
Chapter 1. What are the IBM Advanced Function Printing Utilities for
AS/400? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What You Can Do with AFP Utilities for AS/400 ................... 4
Using Overlays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Using Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Using Bar Codes ................................... 8
Using Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Overlay Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Print Format Utility ................................... 10
Resource Management Utility ............................. 12
AFP Resource and AFP Utilities for AS/400 .................... 13
Requirements for Use of the AFP Utilities for AS/400 ............... 13
Hardware Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Software Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
AFP Utilities Fundamentals (Concepts) ....................... 14
Libraries, Files, and Members ........................... 14
Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
AFP Utilities for AS/400 Displays ......................... 15
Menu Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Work with Display ................................ 15
Design display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Related Online Information .............................. 19
Help for Displays .................................. 19
InfoSeeker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Help for Control Language Commands ...................... 19
Copyright IBM Corp. 1996, 1998 1
2 AFP Utilities for AS/400 User’s Guide
Chapter 1. What are the IBM Advanced Function Printing
Utilities for AS/400?
| The IBM Advanced Function Printing Utilities for AS/400 (AFP/U), Version 4
| Release 2, is a licensed program consisting three integrated utilities that provide
| support for Advanced Function Printing (AFP) applications on AS/400. These
| utilities enable you to create and manage electronic forms (overlays), to create and
| manage image resources, and to create AFP applications from AS/400 database
| files. The three AFP Utilities are:
| Overlay Utility: Enables you to create electronic forms directly on AS/400 for use
| in AS/400 AFP applications. The Overlay Utility works with any AS/400 terminal,
| providing an interactive design interface. Overlay Utility functions include:
| Create AFP electronic forms from any AS/400 terminal
| Place text, lines, boxes, shading, bar codes, graphics, and page segments at
| any location on the overlay page
| Present text in a wide variety of fonts using either downloadable fonts
| (AS/400-resident) or printer-resident fonts
| Present text in either single byte character sets (SBCS) or double byte
| character sets (DBCS)
| Present text in four orientations (across, down, back, and up) and three formats
| (horizontal, vertical, and vertical right to left)
| Define horizontal and vertical lines, with control of line type (solid, dashed, or
| dotted) and line thickness
| Define boxes, with control over box type (solid, dashed, or dotted) and shading
| Define any of 14 standard bar code symbologies with control over sizing,
| human-readable information, and orientation. Supported bar codes are:
| – 3-of-9 code, MHI/AIM US-3
| – Interleave 2-of-5
| – MSI Plessey
| – Industrial 2-of-5
| – Codabar
| – UPC-A
| – UPC-E
| – EAN-8
| – EAN-13
| – Matrix 2-of-5
| – POSTNET
| – Code128
| – Japan Postal
| – Royal Mail
| Position overlay, page segment, and graphic elements by row/column or direct
| page offset in inches or centimeters.
| Resource Management Utility: Provides full management of overlay and page
| segment (image) resources. Images scanned on a client workstation can be
| processed, resized, rotated, created, and printed. Resource Management Utility
| functions include:
| Manage overlays and overlay source files, including print and view options
| Create page segments from scanned image files, with sizing and rotation
| options
Copyright IBM Corp. 1996, 1998 3
| Manage page segments, including print support
| Convert overlays and page segments to file format for use with client
| workstation applications
| Print Format Utility: Provides an interactive method for creating AFP printing
| applications directly from AS/400 database files. The Print Format Utility is similar
| to Query for AS/400, but the Print Format Utility is designed for creating AFP
| output, not reports. With the Print Format Utility, complex document applications
| that combine database-driven variable data with overlays, image, bar coding, fonts,
| and other document elements can be produced. Print Format Utility functions
| include:
| All of the text, box, line, bar code, graphics, and image functions supported with
| the Overlay Utility
| Ability to design a record layout and page layout
| Select records from a database file
| Place database fields anywhere in the record layout
| Place variable page segments (images) and graphics in the record layout
| Replicate the record layout across and down the page
| Select overlays to be added to each page
| Specify control breaks for selected fields in the database file
The AFP Utilities for AS/400 provide you the above AFP* functions on the AS/400
system interactively. You can perform your task by selecting options or typing
choices on the menu display.
This chapter describes the following:
What you can do with AFP Utilities for AS/400
Functions of AFP Utilities for AS/400
Requirements for use of AFP Utilities for AS/400
What You Can Do with AFP Utilities for AS/400
AFP Utilities for AS/400 enable you to print a document such as a business letter in
only one step. In conventional printing, you must load letterhead paper into your
printer, print the letter texts, and then manually sign the letter.
4 AFP Utilities for AS/400 User’s Guide
Figure 1. Conventional Letter Preparation
With the AFP Utilities for AS/400, you can electronically store your letterhead and
signature and print the letterhead, text, and signature all at the same time on blank
paper already in your IPDS printer. You can also include graphics such as a line
chart or bar chart in your letter, creating a composite document.
Chapter 1. What are the IBM Advanced Function Printing Utilities for AS/400? 5
Figure 2. Letter Preparation Using AFP Utilities
| The AFP Utilities provide flexible printing. For example, with AFP Utilities you can:
Highlight a list of items by printing the list in a different type style from the
remainder of the text.
Print your letterhead in one font and your text in another font.
You can electronically store your letterhead so it always prints in the same style.
This printing concept is described in “Using Overlays.”
Using Overlays
Overlays are stored constructs of text, boxes, lines, graphics, images, and bar
codes with all the instructions needed to print. They are often in complex
configurations. An overlay is always printed in the same format as it was stored in
and can be positioned anywhere on the page.
Overlays are useful for letterheads and forms as shown in the following figure.
6 AFP Utilities for AS/400 User’s Guide
Figure 3. Using Overlays
Chapter 1. What are the IBM Advanced Function Printing Utilities for AS/400? 7
Using Images
You can place images anywhere on the page.
Figure 4. Using Page Segments
Using Bar Codes
Bar code data is encoded information that is recognized by optical scanning
devices. The AFP Utilities for AS/400 can print various types of bar codes in any
size and with variations, such as with or without the human readable interpretation
(HRI) characters.
Using Graphics
The AFP Utilities for AS/400 can include the Graphics Data File (GDF). GDF can
| be created by OS/400* graphics or created by GDDM* on the System/390*. See
Appendix D, “Using GDFs in AFP Utilities” on page 441 for more information.
8 AFP Utilities for AS/400 User’s Guide
Overlay Utility
| The Overlay Utility enables you to create overlays (electronic forms). Once
| created, an overlay can be placed on pages of output using AS/400 printer file
| support, Data Description Specifications (DDS) in conjunction with High-Level
| Language (HLL) application programs, Advanced Print Utility, AS/400 page and
| form definitions, AFP Toolbox for AS/400, Print Format Utility, and other AFP
| document enabling applications. Figure 3 on page 7 shows how an overlay can
| be merged with data.
You can:
Design an overlay interactively on a display screen.
An overlay can contain text with several kinds of fonts, lines, boxes, images,
bar codes, and graphics.
Store the source data of the overlay (source overlay) that you designed in your
file.
Change the source overlay that was previously stored in the file.
Create an overlay object from the source overlay.
Print the overlay object that was created in the specified library.
Figure 5 shows a sample overlay.
Figure 5. Sample Overlay (Created by the Overlay Utility)
Chapter 1. What are the IBM Advanced Function Printing Utilities for AS/400? 9
Print Format Utility
| The Print Format Utility provides the capability to develop AFP output applications
| directly from AS/400 database files. With the Print Format Utility, you can:
Design your desired layout of a record interactively in the same way as the
Overlay Utility.
You can define headings, boxes, or logos which contain text, lines, boxes,
images, bar codes, and graphics to be printed in addition to the data in the
database file member.
Figure 6 shows a sample label you can create from a record in a database file
using the Print Format Utility.
Figure 6. Sample Label (Created by the Print Format Utility)
Design a page layout interactively in the same way as in the Overlay Utility.
You can define headings, boxes, or logos which contain text, lines, boxes,
images, bar codes, and graphics to be printed.
Save the record layout and page layout as a printout format definition in your
file.
Print a database file member according to the printout format definition.
| Replicate a record layout across and down the page such as in a multiple-up
| label application.
Figure 7 on page 11 shows a print sample of the labels you can create using the
Print Format Utility.
10 AFP Utilities for AS/400 User’s Guide
Loading...