Convert PCD to Page Segment (CVTPCDPAGS)

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, 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.

From PC document (FRMDOC)

Specifies the PC document name to be converted.

The possible values are:

*PRV: Specifies the name of the PC document 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 PC document.
PC-document-name: Specifies the PC document name that is to be converted.

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.

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.

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.

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.

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.

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.

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.