Menu item 11: Convert spool file to PDF (CVTSPLPDF) Part 4

Color (COLOR)

This parameter determines the color of the text in the document that i-effect creates and the color of the background on which the text is presented.
This parameter contains 2 elements:

Text Color

Background Color

In each instance, colors can be defined in one of two ways:

Either a predefined color name such as *BLACK, *WHITE, *RED etc. The following list of predefined names includes all those normally recognized in HTML by browser applications.
Or an RGB (Red-Green-Blue) color number, equivalent to HTML color numbers.
An RGB color number is a string consisting of six hexadecimal digits (0-F). The first two digits represent the red color value (00-FF). The next two digits represent the green color value (00-FF). The last two digits represent the blue color value (00-FF). For example, white is FFFFFF, while black is 000000, and red is FF0000. Unlike HTML, an i-effect color number should not be prefixed with a hash symbol (#).

Text Color

The first element specifies the color to be used when displaying black text in the original spooled file.
Any text in the spooled file, which is not black, will retain its original color. Any black text will assume the color specified here instead.
Specify one of the special values below or an HTML style color number.
Special Values:

*BLACK	*GOLDENROD	*OLIVEDRAB
*ALICEBLUE	*GRAY	*ORANGE
*ANTIQUEWHITE	*GREY	*ORANGERED
*AQUA	*GREEN	*ORCHID
*AQUAMARINE	*GREENYELLOW	*PALEBLUE
*AZURE	*HONEYDEW	*PALEBROWN
*BEIGE	*HOTPINK	*PALECYAN
*BISQUE	*INDIANRED	*PALEGOLDENROD
*BLANCHEDALMOND	*INDIGO	*PALEGRAY
*BLUE	*KHAKI	*PALEMAG
*BLUEVIOLET	*LAVENDER	*PALETURQUOISE
*BROWN	*LAVENDERBLUSH	*PALEVIOLETRED
*BURLYWOOD	*LAWNGREEN	*PALEYLW
*CADETBLUE	*LEMONCHIFFON	*PAPAYAWHIP
*CHARTREUSE	*LIGHTBLUE	*PEACHPUFF
*CHOCOLATE	*LIGHTCORAL	*PERU
*CORAL	*LIGHTCYAN	*PINK
*CORNFLOWERBLUE	*LIGHTGOLDENROD	*PLUM
*CORNSILK	*LIGHTGRAY	*POWDERBLUE
*CRIMSON	*LIGHTGREY	*PURPLE
*CYAN	*LIGHTGREEN	*RED
*DARKBLUE	*LIGHTPINK	*ROSYBROWN
*DARKCYAN	*LIGHTSALMON	*ROYALBLUE
*DARKGOLDENROD	*LIGHTSEAGREEN	*SADDLEBROWN
*DARKGRAY	*LIGHTSKYBLUE	*SALMON
*DARKGREY	*LIGHTSLATEBLUE	*SANDYBROWN
*DARKGREEN	*LIGHTSLATEGRAY	*SEAGREEN
*DARKKHAKI	*LIGHTSLATEGREY	*SEASHELL
*DARKMAGENTA	*LIGHTSTEELBLUE	*SIENNA
*DARKOLIVEGREEN	*LIGHTYELLOW	*SILVER
*DARKORANGE	*LIME	*SKYBLUE
*DARKORCHID	*LIMEGREEN	*SLATEBLUE
*DARKRED	*LINEN :	*SLATEGRAY
*DARKSALMON	*MAGENTA	*SLATEGREY
*DARKSEAGREEN	*MAROON	*SNOW
*DARKSLATEBLUE	*MEDIUMAQUAMARINE	*SPRINGGREEN
*DARKSLATEGRAY	*MEDIUMBLUE :	*STEELBLUE
*DARKSLATEGREY	*MEDIUMORCHID	*TAN
*DARKTURQUOISE	*MEDIUMPURPLE	*TEAL
*DARKVIOLET	*MEDIUMSLATEBLUE	*THISTLE
*DEEPPINK	*MEDIUMSPRINGGREEN	*TOMATO
*DEEPSKYBLUE	*MEDIUMTURQUOISE	*TURQUOISE
*DIMGRAY	*MEDIUMVIOLETRED	*VIOLET
*DIMGREY	*MIDNIGHTBLUE	*VIOLETRED
*DODGERBLUE	*MINTCREAM	*WHEAT
*FELDSPAR	*MISTYROSE	*WHITE
*FIREBRICK	*MOCCASIN	*WHITESMOKE
*FLORALWHITE	*NAVAJOWHITE	*WHITESMOKE
*FORESTGREEN	*NAVY	*YELLOWGREEN
*FUCHSIA	*OLDLACE
*GAINSBORO	*OLIVE

Zeichenwert

Specify the RGB color number.

Background Color

The second element determines the color of the background on which the text appears.
Options for both the text and background color are as follows (the table also indicates the corresponding color value). The list of predefined color names available from CVTSPLSTMF is a subset of those available from the other commands, which have the COLOR parameter.
Specify one of the special values below or an HTML style color number.
Special Values:

*WHITE	*FUCHSIA	*OLDLACE
*ALICEBLUE	*GOLDENROD	*OLIVEDRAB
*ANTIQUEWHITE	*GRAY	*ORANGE
*AQUA	*GREY	*ORANGERED
*AQUAMARINE	*GREEN	*ORCHID
*AZURE	*GREENYELLOW	*PALEBLUE
*BEIGE	*HONEYDEW	*PALEBROWN
*BISQUE	*HOTPINK	*PALECYAN
*BLACK	*INDIANRED	*PALEGOLDENROD
*BLANCHEDALMOND	*INDIGO	*PALEGRAY
*BLUE	*KHAKI	*PALEMAG
*BLUEVIOLET	*LAVENDER	*PALETURQUOISE
*BROWN	*LAVENDERBLUSH	*PALEVIOLETRED
*BURLYWOOD	*LAWNGREEN	*PALEYLW
*CADETBLUE	*LEMONCHIFFON	*PAPAYAWHIP
*CHARTREUSE	*LIGHTBLUE	*PEACHPUFF
*CHOCOLATE	*LIGHTCORAL	*PERU
*CORAL	*LIGHTCYAN	*PINK
*CORNFLOWERBLUE	*LIGHTGOLDENROD	*PLUM
*CORNSILK	*LIGHTGRAY	*POWDERBLUE
*CRIMSON	*LIGHTGREY	*PURPLE
*CYAN	*LIGHTGREEN	*RED
*DARKBLUE	*LIGHTPINK	*ROSYBROWN :
*DARKCYAN	*LIGHTSALMON	*ROYALBLUE
*DARKGOLDENROD	*LIGHTSEAGREEN	*SADDLEBROWN
*DARKGRAY	*LIGHTSKYBLUE	*SALMON
*DARKGREY	*LIGHTSLATEBLUE	*SANDYBROWN
*DARKGREEN	*LIGHTSLATEGRAY	*SEAGREEN
*DARKKHAKI	*LIGHTSLATEGREY	*SEASHELL
*DARKMAGENTA	*LIGHTSTEELBLUE	*SIENNA
*DARKOLIVEGREEN	*LIGHTYELLOW	*SILVER
*DARKORANGE	*LIME	*SKYBLUE
*DARKORCHID	*LIMEGREEN	*SLATEBLUE
*DARKRED	*LINEN :	*SLATEGRAY
*DARKSALMON	*MAGENTA	*SLATEGREY
*DARKSEAGREEN	*MAROON	*SNOW
*DARKSLATEBLUE	*MEDIUMAQUAMARINE	*SPRINGGREEN
*DARKSLATEGRAY	*MEDIUMBLUE :	*STEELBLUE
*DARKSLATEGREY	*MEDIUMORCHID	*TAN
*DARKTURQUOISE	*MEDIUMPURPLE	*TEAL
*DARKVIOLET	*MEDIUMSLATEBLUE	*THISTLE
*DEEPPINK	*MEDIUMSPRINGGREEN	*TOMATO
*DEEPSKYBLUE	*MEDIUMTURQUOISE	*TURQUOISE
*DIMGRAY	*MEDIUMVIOLETRED	*VIOLET
*DIMGREY	*MIDNIGHTBLUE	*VIOLETRED
*DODGERBLUE	*MINTCREAM	*WHEAT
*FELDSPAR	*MISTYROSE	*WHITE
*FIREBRICK	*MOCCASIN	*WHITESMOKE
*FLORALWHITE	*NAVAJOWHITE	*WHITESMOKE
*FORESTGREEN	*NAVY	*YELLOWGREEN

Character Value

Specify the RGB color number.

PDF Options (PDF)

This parameter manages a number of features for the PDF file, which will be created.

This parameter contains 19 elements:

PDF Viewer

Determines the platform of the PDF viewer, which will be used to open the created PDF.

*WINDOWS	A Microsoft ® Windows PDF viewer will be used.
*OTHER	A viewer other than a Microsoft ® Windows viewer will be used.

Bookmark Display

The element determines whether the bookmarks, which were created at file creation, should be visible when the file is opened for the first time, or if the user must choose to have them displayed.

*SHOW

Display the bookmarks when the document is opened.

*HIDE

Hide the bookmarks when the document is opened.

It should be noted that the PDF file can be opened more quickly if BMARKACT (*HIDE) is selected, however, the user will need to make the bookmarks visible before they can be used to navigate the document.

Magnification at the PDF's Initial Opening

This element sets the scaling, which will be used, when the document is opened.

*PDFDFT	The default magnification will be used.
*FITWDW	Adjusts the magnification so that the entire page fits in the viewer window.
*ACTUAL	Adjusts the magnification so that the page is viewed at its actual size.
*FITWIDTH	Adjusts the magnification so that the page width fits in the viewer window.
*FITVIS	Adjusts the magnification so that the text and graphics fit in the viewer window.
8.33-1600.0	The percentage magnification to apply.

PDF Keyword for Indexing

This element determines a set of keywords to be included in the "Document Info" section of the PDF file, which can be used by indexing and document management applications.

*NONE	No key words will be used.
Character Value	Specify the keywords as a single character string with keywords separated by a comma or semicolon.

Data Compression

It can be determined here, if data stream data of the PDF file should be compressed.

Data compression is a trade-off between compression ratio and time. The higher the compression ratio that is attempted, the longer the data will take to compress. The options below enable selection of a high compression ratio (renders the smallest PDF files but takes longer to create) or the fastest conversion time (produces larger PDF files but runs more quickly).

*OPT	Stream data in PDF files is compressed. The level of compression provides a good degree of data compression, but does not take long to compress.
*NONE	Stream data in PDF files is not compressed. The resultant PDF files will be significantly larger than if data compression was applied, but will take less time to create.
*FASTEST	The lowest and fastest level of data compression.
*FASTER	A compression ratio less than FAST but higher than FASTEST.
*FAST	A compression ratio less than OPT but higher than FASTER.
*HIGH	A compression ratio higher than OPT but less than HIGHER.
*HIGHER	A compression ratio higher than HIGH but less than MAX.
*MAX	The maximum possible level of data compression is applied; PDF files will be as small as possible, but take the longest time to create.

Fast Web View?

Determines if the PDF "Fast Web View" option is implemented. This option can improve the time taken to open PDF files across a network.

*YES	"Fast Web View" will be applied.
*NO	"Fast Web View" will not be applied.

Rotated or Not Rotated?

Determines if the rotated pages will be rendered in their rotated alignment or in their original alignment.

*YES	If the page is rotated, or if auto-rotation is applied (see next element), the page will be automatically rotated back into the standard orientation for easier viewing.
*NO	The page, if rotated, is viewed in the rotated orientation.

Rotation angle (degrees)

The angle, by which the page is rotated in the PDF when *YES is specified for the previous element.

*NONE	No rotation will be used.
90	90 Degrees.
180	180 Degrees.
270	270 Degrees.

Element 9: PDF Standard

The PDF Standard that the new PDF document must meet.

*ADOBE	Adobe's PDF Specification.
*PDFA	PDF/A-1. Standard. PDF/A-1 is an international standard document file format for long-term archiving. It is also called ISO 19005-1.

Element 10: Sub-standard

The level of conformity to the previously selected standard.

*NONE	No level of conformity will be applied. This value is required if ADOBE was selected in the previous element and is not allowed if PDFA was selected.
*LEVEL1A	Level 1A Conformity of the PDF/A-1 Standard.
*LEVEL1B	Level 1B Conformity of the PDF/A-1 Standards.

Element 11: Language Code

A code that specifies the text language of the PDF document.

*SYSVAL	The language code will be taken from the QLANGID system value.
*JOB	The language code will be taken from the LANGID job attribute.

Element 12: Country Code

This code is used to give more details for the language code that was selected in the previous Parameter. If EN was entered as the language code, the country code can clarify the language in greater detail as US (en-US) or British (en-GB).

*SYSVAL	The country code is taken from the QCNTRYID system value.
*JOB	The country code is taken from the CNTRYID job attribute.

Element 13: Author

Name of the document's author.

*NONE	No author is specified.
Zeichenwert	Name of the author.

Element 14: Subject

The document's subject

*NONE	No subject is specified.
Character Value	The document's subject.

Number of copies to be printed

Preset number of copies to be printed in the print dialog.

*DFT	The value will not happen in the print dialog. If the PDF file is opened and the print dialog box, the value for this attribute is set by the PDF reader application and not through the PDF file that was generated by this command.
*SPLF	The value is the NBR COPIES attribute of the spooled file removed.
1-5	Specify the number of copies that will be forwarded to the print dialog. Please note that PDF supports only values 1 to 5 All other values are ignored.

Print scale

Shows the scaling option in the print dialog.

*DFT	The value will not happen in the print dialog. If the PDF file is opened and the print dialog box, the value for this attribute is set by the PDF reader application and not through the PDF file did was generated by this command.
*NONE	The Print dialog box is set to the No scaling option.
1-5	Specify the number of copies that will be forwarded to the print dialog. Please note that PDF supports only values 1 to 5 All other values are ignored.

Select source by PDF Satiengrößte

Displays the "source by PDF size Select" option in the print dialog to.

*DFT	The value will not happen in the print dialog. If the PDF file is opened and the print dialog box, the value for this attribute is set by the PDF reader application and not through the PDF file that was generated by this command.
*YES	The option is set to "Yes".
*NO	The option is set to "No".

Recompress IBM MMR images

This element determines whether PDF image objects are compressed and embedded with IBM MMR compression method or with zlib-compression method (more compatibility).

*NO	IBM MMR compression is maintained.
*YES	The embedded images will be recompressed with zlib-compression method Use this setting to enable PDF Direct print feature on e.g. Lexmark or IBM printers.

Adobe Reader 7+ search option.

Since version 7.0 (and later) of Adobe Reader lyrics are mixed together in part. This results in incorrect searches within the documents - despite a correct graphical display of the texts. This element specifies the this behavior does not occur and thus can be searched for within the document with the newer Adobe readers. This relates to the types Spoolarten * SCS.

*NO	No correction mode for Adobe Reader 7.0+.
*YES	Correction mode for Adobe Reader 7.0+

Exclude Page Number (EXCLPAGNBR)

This parameter provides the opportunity to exclude pages from the output, for example, pages appearing in the spooled file, but which are not required in the output. For exam-ple, batch header and trailer sheets can be left unprinted by means of this parameter.
Single Values:

*NONE	No pages will be excluded.
Other Values	(Up to 100 repetitions)

This parameter contains 2 elements:

Point of Exclusion

The point in the spooled file where the excluded page(s) are located.

*SPLFSTR	At the start of the spooled file. The specified number of pages from the start of the spooled file will not be printed.
*SPLFEND	At the end of the spooled file. The specified number of pages from the end of the spooled file will not be printed.
*STMFSTR	At the start of each stream file. The specified number of pages from the start of the each set of pages selected for stream file creation will not be printed.
*STMFEND	At the end of the stream file. The specified number of pages from the end of the each set of pages selected for stream file creation will not be printed.
*PAGNBR	Indicates that the "Numer of Excluded or *BLANK" element denotes a page number, not a number of pages. The page number specified will not be printed.

Number of Excluded Pages or *BLANK

The number of pages to exclude or the page number to exclude.

1	Excludes one page.
*BLANK	All blank pages up to the next non-blank page (if SPLFSTR or STMFSTR) or back to the last non-blank page (if SPLFEND or STMFEND) will be excluded.
1-999999	Specify the number of pages or (for *PAGNBR) the page number to exclude.

Exclude Pages Based on Key String (EXCLPAGKEY)

Provides the opportunity to exclude pages from output, based on the appearance of a key string. For example, pages appearing in the spooled file, but which are not required in the output such as batch header and trailer sheets can be excluded from conversion by means of this parameter.
Single Values:

*NONE	No pages will be excluded.
Further Values	(Up to 100 repetitions)

This parameter contains 3 elements:

Key String

A key string identifying pages, which will be excluded.

Every page on which the key string appears, or every page on which the key string does not appear (dependent on the following option), will be excluded.

Character Value

Specify the desired key string. This is case-sensitive and should be enclosed in single quotes if a lower-case or mixed-case value is desired.

Options:

The way, in which the key string will be used.

*CT	Contains. Any page, which contains the specified key string, will be excluded.
*NC	Does not contain. Any page, which does not contain the specified key string, will be excluded.

Number of Pages to Exclude

Determines the number of pages to exclude when the key string is found (*CT) or not found (*NC).

1	Exclude one page.
1-999999	Enter the number of pages to be excluded.

If, for example, the spooled file contains batch header sheets, and these contain the word "Batch" on them, they can be excluded from the stream file by specifying "Batch" as the key string with this parameter and *CT for the exclude option.

CCSID of the Spooled file (SPLFCCSID)

This parameter indicates the CCSID (Coded Character Set Identifier), which i-effect should assume, when converting the spooled file's data content, if a CCSID has not been otherwise indicated. The CCSID specifies the encoding scheme used to represent the data and determines how particular code point values will be interpreted and converted in the stream file that will be created.
Although more advanced printer data streams such as AFP and IPDS will include information indicating the encoding scheme used for data representation in the spooled file, SCS spooled files often contain no explicit information about the CCSID of the data.
Possible Values:

*SPLF	i-effect will use whatever information is available from the spooled file to determine the correct CCSID.
*JOB	The CCSID of the current job will be used. If the CCSID of the job is 65535, the default CCSID attribute of the job will be used.
*SYSVAL	The value of the QCCSID system value will be used.
*USER	The CCSID specified in the user profile of the user running the command will be used.
1-65533	Specify the CCSID to be used.

Public Data Rights. (AUT)

Determines the data rights given to *PUBLIC for the merged file.
Possible Values:

*R	Read only
*RX	Read and execute
*RW	Read and write
*RWX	Read, write and execute (all)
*X	Execute only
*W	Write only
*WX	Write and execute
*NONE	No Authority