Professional Documents
Culture Documents
ERserver
iSeries
AFP Utilities for iSeries Commands
Version 5 Release 3
ERserver
iSeries
AFP Utilities for iSeries Commands
Version 5 Release 3
Note
Before using this information and the product it supports, be sure to read the information in
“Notices,” on page 39.
Parameters
Keyword Description Choices Notes
OVL Overlay Qualified object name Required, Positional 1
Qualifier 1: Overlay Name
Qualifier 2: Library Name, *LIBL, *CURLIB
DTAFMT Format of data *FIXED, *CONTINUOUS Required, Positional 2
FILE To file Qualified object name Required, Positional 3
Qualifier 1: To file Name, *VM, *MVS
Qualifier 2: Library Name, *CURLIB
MBR To member Name, *OVL Optional, Positional 4
TEXT Text ’description’ Character value, *OVLTXT Optional
REPLACE Replace *YES, *NO Optional
CRTFILE Create file *YES, *NO Optional
FILETEXT Text ’description’ Character value, *BLANK Optional
Top
Overlay (OVL)
Specifies the qualified name of the overlay that is converted. This is a required parameter.
File (FILE)
Specifies the qualified name of the physical file being used to fill the overlay data.
Member (MBR)
Specifies the name of the physical file member which is filled with the overlay data.
Replace (REPLACE)
Specifies whether or not the physical file member replaces the existing physical file member if a physical
file member of the same name already exists in the library.
Examples
None
Top
Parameters
Keyword Description Choices Notes
PAGSEG Page segment Qualified object name Required,
Positional 1
Qualifier 1: Page segment Name
Qualifier 2: Library Name, *LIBL, *CURLIB
DTAFMT Format of data *FIXED, *CONTINUOUS Required,
Positional 2
FILE To file Qualified object name Required,
Positional 3
Qualifier 1: To file Name, *VM, *MVS
Qualifier 2: Library Name, *CURLIB
MBR To member Name, *PAGSEG Optional,
Positional 4
TEXT Text ’description’ Character value, *PSGTXT Optional
REPLACE Replace *YES, *NO Optional
CRTFILE Create file *YES, *NO Optional
FILETEXT Text ’description’ Character value, *BLANK Optional
Top
File (FILE)
Specifies the qualified name of the physical file being used to fill the page segment data.
Replace (REPLACE)
Specifies whether or not the physical file member replaces the existing physical file member if a physical
file member of the same name already exists in the library.
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
Top
Parameters
Keyword Description Choices Notes
PAGSEG Page segment Qualified object name Required, Key,
Positional 1
Qualifier 1: Page segment Name, *PRV
Qualifier 2: Library Name, *CURLIB
FRMFLR From folder Character value, *PRV Optional, Key,
Positional 2
FRMDOC From PC document Name, *PRV, *PAGSEG Optional, Key,
Positional 3
CHGIMGSIZE Change image size *SAME, *NO, *YES Optional,
Positional 4
IMGSIZE Image area size Element list Optional,
Positional 5
Element 1: Unit of measure *SAME, *INCH, *CM
Element 2: Width 0.1-57.79, *SAME
Element 3: Length 0.1-57.79, *SAME
MAPPING Mapping option *PAT, *STF, *CAT, *IPTP, *IPTPD, *SAME Optional,
Positional 6
IMGRTT Degree of rotation 0, 90, 180, 270, *SAME Optional,
Positional 7
CHGOFF Change image offset *NO, *YES Optional,
Positional 8
AUT Authority Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE, Optional,
*SAME Positional 9
TEXT Text ’description’ Character value, *SAME, *BLANK Optional,
Positional 10
REPLACE Replace *NO, *YES Optional,
Positional 11
Top
Length
Specifies the length of the image to be created.
The possible values are:
*SAME
Specifies the value of the length used when you previously created a page segment of the
same name.
length-value
Specify the length value in the selected unit of measurement.
If the option is used to change the offset, the upper left corner of the rotated image will be placed at the
specified point on the overlay or layout. This placement is the same as that used for IM1 raster images.
For an image rotated 90 degrees, the upper left corner is the same as the bottom left corner of an image
that is not rotated. For an image rotated 180 degrees, the upper left corner is the same as the bottom right
corner of an image that is not rotated.
Authority (AUT)
Specifies the authority given to the user who does not have specific authority, who is not on the
authorization list, or whose user group has no specific authority to the created page segment. This value
is ignored and the current authority remains if a page segment already exists and this is replacing it.
Replace (REPLACE)
Specifies whether or not the page segment replaces the existing page segment if a page segment of the
same name already exists in the library.
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
Top
Parameters
Keyword Description Choices Notes
PAGSEG Page segment Qualified object name Required, Key,
Positional 1
Qualifier 1: Page segment Name, *PRV
Qualifier 2: Library Name, *CURLIB
FILE From file Single values: *PRV Optional, Key,
Other values: Qualified object name Positional 2
Qualifier 1: From file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR From member Name, *PRV, *PAGSEG Optional, Key,
Positional 3
CHGIMGSIZE Change image size *SAME, *NO, *YES Optional,
Positional 4
IMGSIZE Image area size Element list Optional,
Positional 5
Element 1: Unit of measure *SAME, *INCH, *CM
Element 2: Width 0.1-57.79, *SAME
Element 3: Length 0.1-57.79, *SAME
MAPPING Mapping option *PAT, *STF, *CAT, *IPTP, *IPTPD, *SAME Optional,
Positional 6
IMGRTT Degree of rotation 0, 90, 180, 270, *SAME Optional,
Positional 7
CHGOFF Change image offset *NO, *YES Optional,
Positional 8
AUT Authority Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE, Optional,
*SAME Positional 9
TEXT Text ’description’ Character value, *SAME, *BLANK Optional,
Positional 10
Top
Top
Top
Length
Specifies the length of the image to be created.
The possible values are:
*SAME
Specifies the value of the length used when you previously created a page segment of the
same name.
length-value
Specify the length value in the selected unit of measurement.
Top
If the option is used to change the offset, the upper left corner of the rotated image will be placed at the
specified point on the overlay or layout. This placement is the same as that used for IM1 raster images.
For an image rotated 90 degrees, the upper left corner is the same as the bottom left corner of an image
that is not rotated. For an image rotated 180 degrees, the upper left corner is the same as the bottom right
corner of an image that is not rotated.
Authority (AUT)
Specifies the authority given to the user who does not have specific authority, who is not on the
authorization list, or whose user group has no specific authority to the created page segment. This value
is ignored and the current authority remains if a page segment already exists and this is replacing it.
Replace (REPLACE)
Specifies whether or not the page segment replaces the existing page segment if a page segment of the
same name already exists in the library.
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
Top
This command allows you to print a database file member according to the design of a PFD definition.
Parameters
Keyword Description Choices Notes
PFDFILE PFD file Qualified object name Required,
Positional 1
Qualifier 1: PFD file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PFDMBR PFD definition Name, *FIRST Optional,
Positional 2
FILE Database file Single values: *PFD Optional,
Other values: Qualified object name Positional 3
Qualifier 1: Database file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Member Name, *FIRST Optional,
Positional 4
GRID Include grid *YES, *NO, *YES, *NO Optional,
Positional 5
RCDSLT Record selection *YES, *NO, *YES, *NO Optional,
Positional 6
ENDPAGE Ending page 1-9999, *END Optional,
Positional 7
DRAWER Source drawer 1-255, *PFD, *E1, *CUT Optional,
Positional 8
OUTBIN Output bin 1-65535, *DEVD Optional,
Positional 9
COPIES Copies 1-255, *PFD Optional,
Positional 10
Top
Top
Top
Member (MBR)
Specifies the name of the member to be printed.
Drawer (DRAWER)
Specifies the source drawer used when single-cut sheets are fed into the printer.
Top
Top
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
AFP0040
Database file &2 in library &1 cannot be allocated.
AFP22A0
Print request canceled.
Top
The command displays the main AFP Utilities menu that allows you to use the AFP Utilities functions.
Parameters
None
Top
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
AFP10C0
Error occurred while AFPU main menu was displayed.
AFP22A0
Print request canceled.
AFP3303
Page segment &5 was not created in library &1.
This command allows you to perform an option of the overlay utility directly without viewing the Work
with Source Overlays display.
Parameters
Keyword Description Choices Notes
FILE Source overlay file Single values: *PRV Optional,
Other values: Qualified object name Positional 1
Qualifier 1: Source overlay Name
file
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Source overlay Name, *PRV, *SELECT Optional,
Positional 2
OPTION Option *BLANK, X’40’, 1, 2, 3, 4, 6, 7, 9 Optional,
Positional 3
Top
Top
Option (OPTION)
Specifies the function to perform on the selected source overlay.
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
Top
This command allows you to perform an option of print format utility directly without viewing the Work
with PFD Definitions display.
Parameters
Keyword Description Choices Notes
PFDFILE PFD file Single values: *PRV Optional,
Other values: Qualified object name Positional 1
Qualifier 1: PFD file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PFDMBR PFD definition Name, *PRV, *SELECT Optional,
Positional 2
OPTION Option *BLANK, X’40’, 1, 2, 3, 4, 6, 7, 9 Optional,
Positional 3
Top
Top
Option (OPTION)
Specifies the function to perform on the selected PFD definition. The default value depends on if you
specify a PFD definition name.
Examples
None
Top
Error messages
*ESCAPE Messages
AFP0010
An error occurred.
AFP22A0
Print request canceled.
Top
IBM may not offer the products, services, or features discussed in this document in other countries.
Consult your local IBM representative for information on the products and services currently available in
your area. Any reference to an IBM product, program, or service is not intended to state or imply that
only that IBM product, program, or service may be used. Any functionally equivalent product, program,
or service that does not infringe any IBM intellectual property right may be used instead. However, it is
the user’s responsibility to evaluate and verify the operation of any non-IBM product, program, or
service.
IBM may have patents or pending patent applications covering subject matter described in this
document. The furnishing of this document does not give you any license to these patents. You can send
license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
500 Columbus Avenue
Thornwood, NY8809
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION
PROVIDES THIS PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some
states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication.
IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this
one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Such information may be available, subject to appropriate terms and conditions, including in some cases,
payment of a fee.
The licensed program described in this information and all licensed material available for it are provided
by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or
any equivalent agreement between us.
Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM
products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of
those products.
This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs
in any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. You may copy, modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application programs conforming
to IBM’s application programming interfaces.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Trademarks
The following terms are trademarks of International Business Machines Corporation in the United States,
other countries, or both:
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, and service names may be trademarks or service marks of others.
Personal Use: You may reproduce these Publications for your personal, noncommercial use provided that
all proprietary notices are preserved. You may not distribute, display or make derivative works of these
Publications, or any portion thereof, without the express consent of IBM.
Commercial Use: You may reproduce, distribute and display these Publications solely within your
enterprise provided that all proprietary notices are preserved. You may not make derivative works of
these Publications, or reproduce, distribute or display these Publications or any portion thereof outside
your enterprise, without the express consent of IBM.
Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either
express or implied, to the Publications or any information, data, software or other intellectual property
contained therein.
IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of
the Publications is detrimental to its interest or, as determined by IBM, the above instructions are not
being properly followed.
You may not download, export or re-export this information except in full compliance with all applicable
laws and regulations, including all United States export laws and regulations. IBM MAKES NO
GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE
PROVIDED ″AS-IS″ AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE
By downloading or printing a publication from this site, you have indicated your agreement with these
terms and conditions.
Appendix. Notices 41
IBM grants you a nonexclusive copyright license to use all programming code examples from which you
can generate similar function tailored to your own specific needs.
All sample code is provided by IBM for illustrative purposes only. These examples have not been
thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability,
or function of these programs.
All programs contained herein are provided to you ″AS IS″ without any warranties of any kind. The
implied warranties of non-infringement, merchantability and fitness for a particular purpose are expressly
disclaimed.
Printed in USA