| Conversion of the Font Source (CVTFNTRSC) | This parameter allows user defined mappings for fonts used in the spooled file that are identified by a font resource name. Mappings may be defined here in order to improve the appearance of the report if FONT (*MAP) alone does not give satisfactory results. Up to 100 mappings may be defined.
Single Values: | *NONE | The default is *NONE. No font substitutions are required. | | Other Values | (Up to 100 entries) |
This parameter contains 2 elements: From Resource Where the specified font resource name appears in the spooled file, it will be mapped to the font typeface and point size specified here in the resultant output file.
i-effect sends notification of the font mappings that it has chosen by sending a message to the job log when the command is run. If the appearance of the spooled file in the stream file is not satisfactory, this parameter or the CVTFONTID parameter can be used to define font mappings. Element 1: Name of the "from" Font
Font name and size in the output file. | name | Enter the name of a font resource referenced in the spooled file. This will usually be either a font character set defined in the FNTCHRSET parameter of the CRTPRTF (Create Printer File) command, or on the DDS FNTCHRSET keyword, or a coded font defined on the CDEFNT parameter of the CRTPRTF (Create Printer File) command, or on the DDS CDEFNT keyword. | Element 2: Font Size
Size of the source font. | *FONTNAME | The font size is implied by the font re-source name. | | 4-36 | Enter the font size. | Element 3: Size Units
The unit type, in the above mentioned font size is measured. | *POINTS | Font size is in point. | | *CPI | The font size is a CPI value (characters per inch). |
|
To Font
| Element 1: Font
Target font and size.
Specify a built-in typeface or a font object.
| *COURIER *COURIERB *COURIERO *COURIERBO *HELVETICA *HELVB *HELVO *HELVBO *TIMES *TIMESB *TIMESI *TIMESBI *SYMBOL *DINGBATS | Courier Courier Bold Courier oblique Courier Bold oblique Helvetica Helvetica Bold Helvetica oblique Helvetica Bold oblique Times New Roman Times New Roman Bold Times New Roman Italic Times New Roman Bold Italic Symbol Zapf Dingbats | | path-name | Alternatively, either a font resource object or a PostScript Type 1 font file can be specified. Note: FONT (*EMBED) needs to be specified if the font is to be embedded in PDF. | If FONT (*MAP) is specified, i-effect® will use the font specified on this element of the CVTFNTRSC parameter to select a suitable standard font to map to, but will still use a mapped standard font not an embedded font. These parameters require an IFS path name. If a font resource object is referenced, the object name must be specified in IFS format, i.e: /QSYS.LIB/library_name.LIB/object_name.FNTRSC |
|
Example:
CODE
CVTSPLPDF
CVTFNTRSC(((C0S0CR10)
(‚/QSYS.LIB/QFNTCPL.LIB/C0S0CR10.FNTRSC)))
FONT(*EMBED)
Font resource C0S0CR10 will be implemented by embedding font resource object C0S0CR10 in library QFNTCPL.
Example:
CODE
CVTSPLPDF
CVTFONTID(((C0S0CR10) (‚/QIBM/PRODDATA/OS400/
FONTS/PSFONTS/LATIN/COU.PFB')))
FONT(*EMBED)
|
Font resource C0S0CR10 should be implemented by embedding the PostScript courier font supplied by IBM at the path given. Please note that two files are required in order to successfully embed a PostScript font: |
| A PostScript Type 1 font file. This normally has a file extension of .pfb (e.g. /QIBM/PRODDATA/OS400/FONTS/PSFONTS/LATIN/HEL.PFB) | | A PostScript Type 1 font metrics file. This normally has a file extension of .afm (e.g. /QIBM/PRODDATA/OS400/FONTS/PSFONTS/LATIN/HEL.AFM) |
|
| Specify the name of the font file (.pfb extension) on this parameter. i-effect will attempt to locate the corresponding font metrics file (.afm extension) in the same location. If either file cannot be found, or if either file is not recognized as the appropriate file type, an error will occur. |
Element 2: Size
Target font size. | *FONTID | This indicates that the size of the font used will be the same as the font size implied or specified by the from-font resource or from-font-size part of this parameter. | | | 4-36 | The font size in points. |
|
| Text Options (TEXT) | Determines various options relating to the processing of text in the spooled file. Currently there is only one option: | Include overlay text? | Determines whether textual content derived from an overlay or page segment object is included in the output.
Overlays often contain constants, labels and heading text while the spooled file itself contains the variable data associated with those constants, labels and headings. For example, an invoicing application where the overlay contains text such as "Customer Name", "Invoice Number" and "Invoice Date" and the spooled file supplies the actual customer name, invoice number and invoice date information to be printed alongside those labels.
While the text from the overlay is often included in the file created, in other circumstances, for example identifying bookmark text, it might be more appropriate to ignore the overlay text and just process the variable data from the spooled file itself. This parameter indicates which option is to be chosen.
The following options are possible: | *OUTPUT | Overlay text is included in the stream file that is created. However, text from overlays and page segments are ignored when processing text functions such as bookmarks, split triggers, and exit program parameters. | | *YES | Overlay text will be included. | | *NO | Overlay text will be excluded. | | *SPLF | i-effect determines whether to include overlay text based on the format of the spooled file being converted. Overlay text is excluded if the spooled file being converted is *SCS, otherwise it is included. | | *IGNOVLDTA | All content from overlay and page segment objects (both text and non-text) are ignored and dropped from processing. |
|
|
| DBCS Conversion Options (DBCS) | Determines various options relating to the processing of DBCS (Double-Byte Character Set) data, i.e. data in languages such as Japanese, Chinese and Korean. This parameter contains 3 elements: | DBCS coded font | The first element specifies the qualified name of the DBCS coded font to be used to implement DBCS text in the spooled file.
It is not normally necessary to specify a value with this parameter since the names of DBCS fonts to be used will be derived from instructions in the spooled file data stream.
If a DBCS spooled file has been created using a printer file, which specifies IGCCDEFNT (*SYSVAL), the name of the coded font will be obtained from the QIGCCDEFNT system value. However, if the spooled file has been transferred to a system (e.g. a non-DBCS system), which has the system value QIGCCDEFNT, set to *NONE, i-effect will be unable to identify the appropriate coded font to use. In those circumstances, this parameter can be used to specify the name of the font resource object (coded font) that should be used to display DBCS text in the spooled file.
Single Values: | *SPLF | i-effect determines the DBCS coded font name from the spooled file attributes. Where the spooled file refers to the QIGCCDEFNT system value, the coded font is taken from the system value. If QIGCCDEFNT is set to *NONE, an error will be reported and a coded font name should be specified in this parameter. | | *IGNORE | Tells i-effect to ignore data that appears to be DBCS and treat it as SBCS. | Qualifier 1:
DBCS
coded font | Name | Specify the qualified name of the font resource object to be used. The object specified must be of object type *FNTRSC with object attributes CDEFNT. | | *LIBL | Locates the font resource object through the job library list. | Qualifier 2:
Bibliothek | *CURLIB | The font resource is located in the current job library. | | Name | Specify the name of the library in which the font resource object is located. |
| | DBCS Font Size | The second element specifies the DBCS font size. It is normally not necessary to specify a value with this parameter since the font size of DBCS fonts to be used will be derived from instructions in the spooled file data stream. | *SPLF | i-effect determines the DBCS font size from the spooled file attributes. | | 0.1-999.9 | Specify the font in points. |
| | DBCS in Non-DBCS Spooled File? | This element tells i-effect what to do if it encounters what appears to be DBCS data in a spooled file, who's attributes indicate that the spooled file is not capable of holding DBCS data. | *NO | i-effect ignores the apparent DBCS data and treats it as SBCS. | | *YES | i-effect treats the apparent DBCS data as DBCS. |
| | DBCS characters per inch | The fourth element specifies the DBCS characters per inch fixed: *SPLF | The DPI value for DBCS fonts is determined by IGCC DPI and CPI attributes of the spooled file | *FONT
| The DPI value for DBCS fonts, is calculated based on the font size that is specified in the second element of this parameter. | 00.1-99.9
| Define the characters to be used per inch, fixed. Note that this means of double-byte characters per inch is done (for example, a value of 5 is equivalent to CPI (10)). |
|
|
| Additional Margins (MARGINS) | With this parameter, additional margins or alignment adjustments can be made to the text within the spooled file.
If no value is specified on this parameter, i-effect will reproduce the margins defined in the spooled file and align text exactly as specified in the printer data stream, which may not necessarily be the way the data appears on the page when printed. This parameter can be used to make slight adjustments to ensure that the PDF reproduces the appearance of the printed page as closely as possible. This parameter contains 8 elements: | Left | This first element allows the definition of an additional left margin in the PDF. This option may be useful where otherwise data appears too close to the left edge of the page to be easily read or printed on a PC printer with a no-print border.
If the spooled file is rotated, the term "left" refers to the page prior to rotation, in other words, the margin may appear at the top, at the bottom, or on the right, depending on the angle through which the page is rotated.
| 0 | No additional left margin is required. | | *CALC | i-effect calculates the margins that are required to align the overlay. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined by the "Unit of Measure" element of this parameter. |
| | Top | The second element allows the definition of an additional top margin in the PDF. This option may be useful where otherwise data appears too close to the top edge of the page to be easily read or printed on a PC printer with a no-print border.
Please note that if the spooled file is rotated, the term "top" refers to the page prior to rotation, in other words the margin may appear at the bottom or on the left or right, depending on the angle through which the page is rotated.
| 0 | No additional top margin is required. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined by the "Unit of Measure" element of this parameter. |
| | Overlays Left | The third element allows the definition of an additional left margin or horizontal shift for overlays only in the PDF. Text, images, and other items that are held in overlays will be shifted horizontally by the amount specified in this parameter. A positive value will cause data to shift to the right and a negative value will case data to shift to the right. This may be useful when the PDF being created with the default parameters appears to have the overlays slightly misaligned from the other content of the spooled file. This can occur, for example, if the printer positions the overlay differently than the instructions contained in the printer data stream (perhaps because data falls within the no-print border and could not otherwise be printed) and the application has been programmed to produce the correct results on that particular printer.
Please note: If the spooled file is rotated, the term "left" refers to the page prior to rotation, in other words the shift may appear at the top, bottom or on the right, depending on the angle through which the page is rotated.
| 0 | No additional horizontal overlay alignment is required. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined by the "Unit of Measure" element of this parameter. |
| | Overlays Top | The fourth element determines an additional top margin or vertical shift for overlays only in the PDF. Text, images, and other items that are held in overlays will be shifted vertically by the amount you specify on this parameter. A positive value will cause data to shift down the page and a negative value will case data to shift up the page. This may be useful when the PDF being created with the default parameters appears to have the overlays slightly misaligned from the other content of the spooled file. This can occur, for example, if the printer positions the overlay differently than the instructions contained in the printer data stream (perhaps because data falls within the no-print border and could not otherwise be printed) and the application has been programmed to produce the correct results on that particular printer.
If the spooled file is rotated, the term "top" refers to the page prior to rotation, in other words the shift may appear at the top, bottom or on the right, depending on the angle through which the page is rotated.
| 0 | No additional vertical overlay alignment is required. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined by the "Unit of Measure" element of this parameter. |
| | Horizontal Shift After Rotation | The fifth element determines the distance across the page by which the contents of the spooled file will be shifted from the position at which they are expected to be found.
When pages are rotated, especially when auto-rotation and/or COR (Computer Output Reduction) is applied, certain printers may shift data down the page in order to avoid printing data in the no-print border. i-effect cannot know whether a particular printer will do this or not. As a result, the PDF may not reproduce the appearance of the printed page 100% accurately. Where this occurs, applying a shift in this element or the next can usually correct the alignment. | *CALC | i-effect decides whether any shift is necessary and what the size of that shift should be, based on the information available to it. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined on the "Unit of Measure" element of this parameter. |
| | Vertical Shift after Rotation | The fifth element determines the vertical across the page by which the contents of the spooled file will be shifted from the position at which they are expected to be found.
When pages are rotated, especially when auto-rotation and/or COR (Computer Output Reduction) is applied, certain printers may shift data down the page in order to avoid printing data in the no-print border. i-effect cannot know if a particular printer will do this or not. As a result, the PDF may not reproduce the appearance of the printed page 100% accurately. Where this occurs, applying a shift in this element or the next can usually correct the alignment. | *CALC | i-effect decides whether any shift is necessary and what the size of that shift should be, based on the information available to it. | | -99.999-99.999 | Specify a value between -99.999 and 99.999. This value is measured in the units defined on the "Unit of Measure" element of this parameter. |
| | Unit of Measurement | The seventh element determines the units in which the preceding options are measured. | *MM | Millimeters | | *INCH | Inches | | *CM | Centimeters |
| | Increase Page Size? | If additional margins are applied to the PDF, the eighth element indicates whether the size of the page should be modified to accommodate the additional margin, or whether data is simply shifted across the page. | *NO | The page size remains the same and the data is simply shifted across or up/down the page. If there is insufficient room on the page, certain data may not be printed on the page. | | *YES | The page size is increased by the amount of the margin. |
|
|
| Include Files (INCLFILE) | Up to 20 stream files can be specified with this parameter, which will be included when the PDF stream file is created. This option can be used for various purposes: - Inclusion of a company logo, watermark, or other graphic to enhance the appearance of a largely textual report.
- Inclusion of a scanned image or other graphic of your preprinted stationary in the PDF file, so that it reproduces the appearance of the printed form exactly.
Included image file(s) must be in JPEG or GIF format.
i-effect needs to be able to access the image file at run time. The file must therefore be located either on Power Systems itself or at a location that can be accessed through an IFS path name.
Single Values: | *NONE | No files will be included. | | Further Values | (Up to 20 repetitions): |
This parameter contains 14 elements: | Name of the Included file | | Path Name | The IFS path name identifying the file to be included. i-effect will use this path to locate the file at the time the command is executed. If it cannot be located, or if the file is not in JPEG format, an error will be reported. Refer to the OUTPFILE parameter for further details of how to define an IFS path name. |
| | Image Format | | *JPG | (Deutsch) JPEG-Format | | *GIF | (Deutsch) GIF-Format |
| | Inclusion Method | The method by which the JPEG file is included in the PDF
Possible Special Values: | *EMBEDDED | The JPEG file is embedded in the PDF file that is created. This approach has the advantage that only a single file is managed or distributed, and the JEPG file is guaranteed to be available when the PDF file is opened. However, it may significantly increase the size of the resulting PDF file. | | *EXTERNAL | The PDF contains an external link or reference to the JPEG file. The image file is accessed by the PDF viewer application (e.g. Acrobat Reader) when the PDF file is opened. This approach minimizes the size of the PDF file, but means that the JPEG file must be managed and distributed with the PDF file. |
| | Contained on Page | This element determines the pages, on which the image file will be inserted.
Possible Special Values: | *ALL | On every page | | *ODD | On all odd pages | | *EVEN | On all even pages | | *FIRST | Only on the first page | | *BFRLAST | On all but the last page | | *AFTFIRST | On all but the first page | | *BACK | An extra page is inserted after each page in the spooled file and the image is included on this extra page. This option is useful with a preprinted form with information printed on the backside. | | *FRONT | As with *BACK, an extra page is inserted after each page in the spooled file. Unlike *BACK, the image is included on the original page, not the inserted page. | | *HEADER | An extra page is inserted at the start of each group of pages, which forms a single PDF file, and the image is included on this additional page. This option can be useful if you wish to have a header sheet at the start of the PDF file. | | *TRAILER | An extra page is inserted at the end of each group of pages, which forms a single PDF file, and the image is included on this additional page. This option can be useful if a trailer sheet is required at the end of the PDF file. |
When determining whether a page is odd- or even-numbered, i-effect uses the natural order of pages in the spooled file and takes no account of any internal page numbering. For example, if the spooled file has an unnumbered batch header sheet, and the page numbering starts at 1 on page 2 of the spooled file, i-effect will take no account of this and will count the first page odd, the second page even etc.
| | X-Coordinate | The X -coordinate (horizontal distance across from left to right in the specified unit of measurement) of the position on the page where the image should appear. | 0 | The default is 0 (i.e. on the left edge. | | -999.999-999.999 | Specify the horizontal coordinate where the image should be included. |
| | Y-Coordinate | The Y-coordinate (vertical distance down from top to bottom in the specified unit of measurement) of the position on the page where the image should appear. | 0 | The default is 0 (i.e. on the top edge). | | -999.999-999.999 | Specify the vertical coordinate where the image should be included. |
| | Unit of Measurement | The following units of measurement are available for x and y coordinates: | *MM | Millimeters | | *INCH | Inches | | *CM | Centimeters |
| | External Reference | No longer supported. Is not followed and is only backward compatibility. | | External Reference Type | No longer supported. Is not followed and is only only for backward compatibility. | | Scaling Factor | The scaling factor. This allows the expansion and contraction of the JPG image as it appears in the PDF file. | 1.0 | No Scaling. | | 0.001-999.999 | Specify the scaling factor to be applied. |
| | Rotation Angle (in Degrees) | The rotation angle to be applied to the image when it is included. The rotation angle can be used to ensure that the orientation of the included image is correct when viewed in Acrobat. For example, when the page itself is rotated. | *NONE | No rotation. | | 90.0 | 90 degrees. | | 180.0 | 180 degrees. | | 270.0 | 270 degrees. |
| | Based on a Key Character String | Interpretation of the X and Y coordinates defined earlier. If the image should always appear in the same, absolute, fixed position on the page, *ABS should be specified for this element (this is the default value). However, if the image position needs to vary, one option is to specify the location of the image relative to a piece of text (the key string) on the page. | *ABS | The X- and Y-coordinates defined above are interpreted as absolute coordinates, not relative to a key string. | | Character Value | The key string. The X- and Y-coordinates defined above are interpreted as offsets relative to the start of this key string. |
| | Key String Occurrence | Determines the key string occurrence at which the image will be positioned on the page. If the key sting occurs more than once, it can be predefined at which occurrence the image will appear. | *FIRST | The first occurrence of the key string is the one that determines the positioning of the image. | | 1-999 | Specify an occurrence between 1 and 999. |
| | Key String Action | Determines whether the key string is included in the output or deleted.
If key string was included in the spooled file simply to indicate the location where an image should be positioned, it can be removed from the final PDF file by telling i-effect to remove it. | *KEEP | Keeps the key string in the output. | | *REMOVE | Removes the key string from the output. |
| | Include On page number | The page number on which the image is to be inserted. The value of this element can not be * NONE or 0 if * PAGNBR specified in the element "Includes on pages".
The value of this element must be * NONE or 0 if * PAGNBR was not specified "on pages Includes" in the element. | *NONE | The image is inserted on a given page. | 1-99999999 | The page number on which the image is inserted. |
|
|
