Convert PFM to Page Segment (CVTPFMPAGS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
Convert PFM to Page Segment
This command allows you to convert a member in a physical database file to a page segment. The member must contain only one Image Data Stream (IMDS) or one Image Object Content Architecture (IOCA) function set 10 image data stream.
Error messages for CVTPFMPAGS
*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 Other values: Qualified object name |
Optional, Key, 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, *SAME | Optional, Positional 9 |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional, Positional 10 |
| REPLACE | Replace | *NO, *YES | Optional, Positional 11 |
| Top |
Page segment (PAGSEG)
Specifies the qualified name of the page segment to be created. This is a required parameter.
The possible values are:
- *PRV
- Specifies that the name of the page segment and library used when you performed this command last is used. If you specify *PRV for the PAGSEG parameter, it is not necessary to specify a library.
- page-segment-name
- Specifies the page segment name to be created.
The possible library values are:
- *CURLIB
- The current library for the job is used to create the page segment. If no library is specified as the current library for the job, QGPL is used.
- library-name
- Specify the library in which the page segment will be created.
| Top |
From file (FILE)
Specifies the qualified name of the physical file that contains the member to be converted.
The possible values are:
- *PRV
- Specifies the file and library used when you previously created a page segment of the same name.
- file-name
- Type the name of an existing physical database file to be used. If you do not specify a library name, *LIBL is used.
The possible library values are:
- *LIBL
- The library list is used to locate the file.
- *CURLIB
- The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
- library-name
- Specify the library where the file resides.
| Top |
From member (MBR)
Specifies the name of the physical file member to be converted.
The possible values are:
- *PRV
- Specifies the member name used when you previously created a page segment of the same name.
- *PAGSEG
- Specifies the name of the page segment to be created is the same as the name of the member.
- member-name
- Specifies the member name that is to be converted.
| Top |
Change image size (CHGIMGSIZE)
Specifies whether the size of the image in the page segment is changed or not.
The possible values are:
- *SAME
- Specifies the same value for this parameter used when you previously created a page segment of the same name.
- *NO
- Specifies not to change the image size.
- *YES
- Specifies to change the image size.
If you specify *YES, the IMGSIZE and MAPOPT parameters will appear, and you can specify the new image size in the page segment and how to map the input image to the size.
| Top |
Image area size (IMGSIZE)
Specifies the unit of measurement, width, and length of the image to be created in the page segment when Change image size parameter is specified as *YES. This prompt is ignored when Change image size is specified as *NO.
- Unit of measure
- Specifies the unit of measurement used to specify the following two parameters.
The possible values are:
- *SAME
- Specifies the unit of measurement used when you previously created a page segment of the same name.
- *INCH
- Inch is used as the unit of measurement.
- *CM
- Centimeter is used as the unit of measurement.
- Width
- Specifies the width of the image to be created.
The possible values are:
- *SAME
- Specifies the value of the width used when you previously created a page segment of the same name.
- width-value
- Specify the width value in the selected unit of measurement.
- 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 |
Mapping option (MAPPING)
Specifies how the input image is mapped to the specified size of output image in the page segment when Change image size parameter is specified as *YES. This prompt is ignored when Change image size is specified as *NO.
The possible values are:
- *SAME
- Specifies the mapping option used when you previously created a page segment of the same name.
- *PAT (Position and trim)
- The top left corner of the input image is located to the top left corner of the output image area. The image size is not changed, and any portion of the input image that falls outside of the output image size is trimmed.
- *STF (Scale to fit)
- The center of the input image is located to the center of the output image area. The image size is changed so that the input image fits in the output image size.
- *CAT (Center and trim)
- The center of the input image is located to the center of the output image area. The image size is not changed, and any portion of the input image that falls outside of the output image size is trimmed.
- *IPTP (Image point to pel)
- The top left corner of the input image is located to the top left corner of the output image area. No resolution correction is done and each image point in the input image is mapped to a pel of the output printer. The image size may vary depending on the pel-density of the output printer, and any portion of the input image that falls outside of the output image size is trimmed.
- *IPTPD (Image point to pel with double dot)
- The top left corner of the input image is located to the top left corner of the output image area. No resolution correction is done and each image point in the input image is doubled (replicated) in both dimensions and mapped to pels of the output printer. The image size may vary depending on the pel-density of the output printer, and any portion of the input image that falls outside of the output image size is trimmed.
| Top |
Degree of rotation (IMGRTT)
Specifies the degree of the clockwise rotation of the output image. The center of the rotation is the top left corner of the image.
The possible values are:
- *SAME
- Specifies the degree of rotation used when you previously created a page segment of the same name.
- 0
- No rotation is done.
- 90
- The image is rotated 90 degrees clockwise.
- 180
- The image is rotated 180 degrees clockwise.
- 270
- The image is rotated 270 degrees clockwise.
| Top |
Change image offset (CHGOFF)
A rotated IOCA image (page segment) created with no change in offset can be placed at the same point on a rotated overlay, record layout, or page layout that the corresponding image that is not rotated is placed on a layout that is not rotated.
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.
The possible values are:
- *NO
- Offset is not changed.
- *YES
- Offset is changed so that the image must be placed on the layout the same as IM1 raster images.
| Top |
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.
The possible values are:
- *SAME
- Specifies the authority used when you previously created a page segment of the same name.
- *LIBCRTAUT
- The system determines the authority for the page segment by using the value specified for the Create authority prompt (CRTAUT parameter) on the Create Library command (CRTLIB) for the library containing the page segment to be created. If the value specified on the Create authority prompt (CRTAUT parameter) is changed, the new value will not affect this page segment.
- *CHANGE
- Change authority allows the user to perform all operations on the page segment except those limited to the owner or controlled by object existence authority and object management authority. The user can change the page segment and perform basic functions on the page segment. Change authority provides object operational authority and all data authority.
- *ALL
- All authority allows the user to perform all operations on the page segment except those limited to the owner or controlled by authorization list management authority. The user can control the page segment's existence, specify the security for the page segment, change the page segment, and perform basic functions on the page segment. The user cannot transfer ownership of the page segment.
- *USE
- Use authority allows the user to perform basic operations on the page segment, such as read the page segment. The user is prevented from changing the page segment. Use authority provides object operational authority and read authority.
- *EXCLUDE
- Exclude authority prevents the user from accessing the page segment.
- authorization-list-name
- Specify the name of an authorization list. Users included on the authorization list are granted authority to the page segment as specified by the list. The authorization list must exist when the page segment is created.
| Top |
Text 'description' (TEXT)
Specifies text that briefly describes the page segment to be created.
The possible values are:
- *SAME
- Specifies the text used when you previously created a page segment of the same name.
- *BLANK
- Specifies the text is blank.
- 'description'
- Specifies no more than 50 characters of text, enclosed in apostrophes.
| Top |
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.
The possible values are:
- *YES
- A new page segment is created and the old page segment is replaced by it.
- *NO
- A new page segment is not created if an old page segment of the same name already exists in the library.
| Top |
Examples
None| Top |
| Top |