Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Printer File (CRTPRTF) command creates a printer device file from the information specified on this command and, optionally, from the data description specifications (DDS) contained in a source file.
A printer device file is used to send records to a printer device. The printer device file identifies the printer device used and the spooling requirements; it does not contain data.
Top |
Keyword | Description | Choices | Notes |
---|---|---|---|
FILE | File | Qualified object name | Required, Positional 1 |
Qualifier 1: File | Name | ||
Qualifier 2: Library | Name, *CURLIB | ||
SRCFILE | Source file | Single values: *NONE Other values: Qualified object name |
Optional, Positional 2 |
Qualifier 1: Source file | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
SRCMBR | Source member | Name, *FILE | Optional, Positional 3 |
GENLVL | Generation severity level | 0-30, 20 | Optional |
FLAG | Flagging severity level | 0-30, 0 | Optional |
DEV | Device | Element list | Optional |
Element 1: Printer | Name, *JOB, *SYSVAL | ||
DEVTYPE | Printer device type | *SCS, *IPDS, *LINE, *AFPDSLINE, *USERASCII, *AFPDS | Optional |
IGCDTA | User specified DBCS data | *NO, *YES | Optional |
IGCEXNCHR | DBCS extension characters | *YES, *NO | Optional |
TEXT | Text 'description' | Character value, *SRCMBRTXT, *BLANK | Optional |
OPTION | Source listing options | Values (up to 4 repetitions): *SRC, *NOSRC, *SOURCE, *NOSOURCE, *LIST, *NOLIST, *SECLVL, *NOSECLVL, *EVENTF, *NOEVENTF | Optional, Positional 4 |
PAGESIZE | Page size | Element list | Optional |
Element 1: Length--lines per page | 0.001-255.0, 66 | ||
Element 2: Width--positions per line | 0.001-378.0, 132 | ||
Element 3: Measurement method | *ROWCOL, *UOM | ||
LPI | Lines per inch | 6, 6.0, 3.0, 4.0, 7.5, 7.5, 8.0, 9.0, 12.0 | Optional |
CPI | Characters per inch | 10, 10.0, 5.0, 12.0, 13.3, 13.3, 15.0, 16.7, 16.7, 18.0, 20.0 | Optional |
FRONTMGN | Front margin | Single values: *DEVD Other values: Element list |
Optional |
Element 1: Offset down | 0.0-57.79 | ||
Element 2: Offset across | 0.0-57.79 | ||
BACKMGN | Back margin | Single values: *FRONTMGN, *DEVD Other values: Element list |
Optional |
Element 1: Offset down | 0.0-57.79 | ||
Element 2: Offset across | 0.0-57.79 | ||
OVRFLW | Overflow line number | 1-255, 60 | Optional |
FOLD | Fold records | *NO, *YES | Optional |
RPLUNPRT | Unprintable character action | Single values: *NO Other values: Element list |
Optional |
Element 1: Replace character | *YES | ||
Element 2: Replacement character | X'40'-X'FE', ' ' | ||
ALIGN | Align page | *NO, *YES | Optional |
CTLCHAR | Control character | *NONE, *FCFC, *MACHINE | Optional |
CHLVAL | Channel values | Single values: *NORMAL Other values (up to 12 repetitions): Element list |
Optional |
Element 1: Channel | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 | ||
Element 2: Line number for channel | Element list | ||
Element 1: Line | 1-255 | ||
FIDELITY | Fidelity | *CONTENT, *ABSOLUTE | Optional |
PRTQLTY | Print quality | *STD, *DEVD, *DRAFT, *NLQ, *FASTDRAFT | Optional |
FORMFEED | Form feed | *DEVD, *AUTOCUT, *CONT, *CUT, *CONT2 | Optional |
DRAWER | Source drawer | 1-255, 1, *E1, *FORMDF | Optional |
OUTBIN | Output bin | 1-65535, *DEVD | Optional |
FONT | Font | Single values: *CPI, *DEVD Other values: Element list |
Optional |
Element 1: Identifier | Character value, 2, 002, 3, 003, 5, 005, 8, 008, 10, 010, 11, 011, 12, 012, 13, 013, 18, 018, 19, 019, 20, 020, 21, 021, 25, 025, 26, 026, 30, 030, 31, 031, 36, 036, 38, 038, 39, 039, 40, 040, 41, 041, 42, 042, 43, 043, 44, 044, 46, 046, 49, 049, 50, 050, 51, 051, 52, 052, 55, 055, 61, 061, 62, 062, 63, 063, 64, 064, 66, 066, 68, 068, 69, 069, 70, 070, 71, 071, 72, 072, 74, 074, 75, 075, 76, 076, 78, 078, 80, 080, 84, 084, 85, 085, 86, 086, 87, 087, 91, 091, 92, 092, 95, 095, 96, 096, 98, 098, 99, 099, 101, 102, 103, 109, 110, 111, 112, 154, 155, 157, 158, 159, 160, 162, 163, 164, 167, 168, 173, 174, 175, 178, 179, 180, 181, 182, 183, 186, 187, 188, 189, 190, 191, 194, 195, 204, 205, 211, 212, 221, 222, 223, 225, 226, 229, 230, 232, 233, 234, 244, 245, 247, 248, 249, 252, 253, 254, 255, 256, 258, 259, 279, 281, 282, 285, 290, 300, 304, 305, 306, 307, 318, 319, 400, 404, 416, 420, 424, 428, 432, 434, 435, 751, 752, 753, 754, 755, 756, 757, 758, 759, 760, 761, 762, 763, 764, 765, 1051, 1053, 1056, 1351, 1653, 1803, 2103, 2304, 2305, 2306, 2307, 2308, 2309, 2310, 2311, 4407, 4427, 4535, 4919, 4939, 5047, 5067, 5687, 5707, 5815, 5835, 5943, 6199, 6219, 6327, 6347, 8503, 8523, 8631, 8651, 8759, 8779, 8887, 8907, 12855, 12875, 16951, 16971, 17079, 17099, 33335, 33355, 33463, 33483, 33591, 33601, 33719, 33729, 34103, 34123, 34231, 34251, 37431, 41783, 41803 | ||
Element 2: Point size | 0.1-999.9, *NONE | ||
CHRID | Character identifier | Single values: *DEVD, *SYSVAL, *JOBCCSID, *CHRIDCTL Other values: Element list |
Optional |
Element 1: Graphic character set | Integer | ||
Element 2: Code page | Integer | ||
DECFMT | Decimal format | *FILE, *JOB | Optional |
FNTCHRSET | Font character set | Single values: *FONT Other values: Element list |
Optional |
Element 1: Character set | Qualified object name | ||
Qualifier 1: Character set | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Code page | Qualified object name | ||
Qualifier 1: Code page | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 3: Point size | 0.1-999.9, *NONE | ||
CDEFNT | Coded font | Single values: *FNTCHRSET Other values: Element list |
Optional |
Element 1: Coded font | Qualified object name | ||
Qualifier 1: Coded font | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Point size | 0.1-999.9, *NONE | ||
TBLREFCHR | Table Reference Characters | *YES, *NO | Optional |
PAGDFN | Page definition | Single values: *NONE Other values: Qualified object name |
Optional |
Qualifier 1: Page definition | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
FORMDF | Form definition | Single values: *NONE, *DEVD Other values: Qualified object name |
Optional |
Qualifier 1: Form definition | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
AFPCHARS | AFP Characters | Single values: *NONE Other values (up to 4 repetitions): Character value |
Optional |
PAGRTT | Degree of page rotation | *AUTO, *DEVD, *COR, 0, 90, 180, 270 | Optional |
MULTIUP | Pages per side | 1-4, 1 | Optional |
REDUCE | Reduce output | *TEXT, *NONE | Optional |
PRTTXT | Print text | Character value, *JOB, *BLANK, X'' | Optional |
JUSTIFY | Hardware justification | 0, 50, 100 | Optional |
DUPLEX | Print on both sides | *NO, *YES, *TUMBLE, *FORMDF | Optional |
UOM | Unit of measure | *INCH, *CM | Optional |
FRONTOVL | Front side overlay | Single values: *NONE Other values: Element list |
Optional |
Element 1: Overlay | Qualified object name | ||
Qualifier 1: Overlay | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Offset down | 0.0-57.79, 0 | ||
Element 3: Offset across | 0.0-57.79, 0 | ||
BACKOVL | Back side overlay | Single values: *FRONTOVL, *NONE Other values: Element list |
Optional |
Element 1: Overlay | Qualified object name | ||
Qualifier 1: Overlay | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Offset down | 0.0-57.79, 0 | ||
Element 3: Offset across | 0.0-57.79, 0 | ||
Element 4: Constant back | *NOCONSTANT, *CONSTANT | ||
CVTLINDTA | Convert line data | *NO, *YES | Optional |
IPDSPASTHR | IPDS pass through | *DEVD, *NO, *YES | Optional |
USRRSCLIBL | User resource library list | Single values: *DEVD, *NONE, *JOBLIBL, *CURLIB Other values (up to 4 repetitions): Name |
Optional |
CORNERSTPL | Corner staple | *NONE, *BOTRIGHT, *TOPRIGHT, *TOPLEFT, *BOTLEFT, *DEVD | Optional |
EDGESTITCH | Edge stitch | Single values: *NONE Other values: Element list |
Optional |
Element 1: Reference edge | *BOT, *RIGHT, *TOP, *LEFT, *DEVD | ||
Element 2: Reference edge offset | 0.0-57.79, *DEVD | ||
Element 3: Number of staples | 1-122, *DEVD | ||
Element 4: Staple offsets |
Single values: *DEVD Other values (up to 122 repetitions): 0.0-57.79 |
||
SADLSTITCH | Saddle stitch | Single values: *NONE Other values: Element list |
Optional |
Element 1: Reference edge | *TOP, *LEFT, *DEVD | ||
Element 2: Number of staples | 1-122, *DEVD | ||
Element 3: Staple offsets |
Single values: *DEVD Other values (up to 122 repetitions): 0.0-57.79 |
||
FNTRSL | Font resolution for formatting | *DEVD, *SEARCH, 240, 300 | Optional |
DFRWRT | Defer write | *YES, *NO | Optional |
SPOOL | Spool the data | *YES, *NO | Optional |
OUTQ | Spooled output queue | Single values: *JOB, *DEV Other values: Qualified object name |
Optional |
Qualifier 1: Spooled output queue | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
FORMTYPE | Form type | Character value, *STD | Optional |
COPIES | Copies | 1-255, 1 | Optional |
EXPDATE | Expiration date for file | Date, *NONE, *DAYS | Optional |
DAYS | Days until file expires | 1-366 | Optional |
PAGERANGE | Page range to print | Element list | Optional |
Element 1: Starting page | Integer, 1, *ENDPAGE | ||
Element 2: Ending page | Integer, *END | ||
MAXRCDS | Max spooled output records | 1-999999, 100000, *NOMAX | Optional |
FILESEP | File separators | 0-9, 0 | Optional |
SCHEDULE | Spooled output schedule | *FILEEND, *IMMED, *JOBEND | Optional |
HOLD | Hold spooled file | *NO, *YES | Optional |
SAVE | Save spooled file | *NO, *YES | Optional |
OUTPTY | Output priority (on OUTQ) | *JOB, 1, 2, 3, 4, 5, 6, 7, 8, 9 | Optional |
USRDTA | User data | Character value, *SOURCE | Optional |
SPLFOWN | Spool file owner | *CURUSRPRF, *JOB, *CURGRPPRF, *JOBGRPPRF | Optional |
USRDFNOPT | User Defined Option | Single values: *NONE Other values (up to 4 repetitions): Character value |
Optional |
USRDFNDTA | User Defined Data | Character value, *NONE | Optional |
USRDFNOBJ | User Defined Object | Single values: *NONE Other values: Element list |
Optional |
Element 1: Object | Qualified object name | ||
Qualifier 1: Object | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Object type | *DTAARA, *DTAQ, *FILE, *PSFCFG, *USRIDX, *USRQ, *USRSPC | ||
IGCCHRRTT | DBCS character rotation | *NO, *YES | Optional |
IGCCPI | DBCS characters per inch | *CPI, *CONDENSED, 5, 6, 10 | Optional |
IGCSOSI | DBCS SO/SI spacing | *YES, *NO, *RIGHT | Optional |
IGCCDEFNT | DBCS coded font | Single values: *SYSVAL Other values: Element list |
Optional |
Element 1: DBCS coded font | Qualified object name | ||
Qualifier 1: DBCS coded font | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
Element 2: Point size | 0.1-999.9, *NONE | ||
WAITFILE | Maximum file wait time | Integer, *IMMED, *CLS | Optional |
SHARE | Share open data path | *NO, *YES | Optional |
LVLCHK | Record format level check | *YES, *NO | Optional |
AUT | Authority | Name, *LIBCRTAUT, *ALL, *CHANGE, *EXCLUDE, *USE | Optional |
REPLACE | Replace file | *YES, *NO | Optional |
Top |
Specifies the printer device file to be created.
If the file is used in a high-level language program, the file name should be consistent with the naming rules of that language; otherwise, the file must be renamed in the program itself.
This is a required parameter.
Qualifier 1: File
Qualifier 2: Library
Top |
Specifies the source file (if one is specified) containing the data description specifications (DDS) source file used to create the printer device file. More information on the specifications that can be made in DDS is in the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter and the DDS Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Single values
Qualifier 1: Source file
Qualifier 2: Library
Top |
Specifies the source file member that contains the data description specifications (DDS) source for the printer file being created.
Top |
Specifies the severity level of data description specifications (DDS) messages that cause file creation to fail. This parameter applies only to messages created while processing DDS source files.
Top |
Specifies the minimum severity level of messages to be listed.
Top |
Specifies the name of a printer device description. For nonspooled output, this identifies the printer device used to produce the printed output. For spooled output, the file is placed on the output queue determined by the OUTQ parameter. If OUTQ(*DEV) is used, the file is placed on the output queue with the same name as the device.
Top |
Specifies the type of data stream created for the printer device file.
Double-Byte Character Set Consideration
When using the 5553 and 5583 DBCS-capable printers, DEVTYPE(*SCS) must be specified. An SNA Character Stream (SCS) data stream is created.
Top |
Specifies, for program-described files, whether the file processes double-byte character set (DBCS) data. Specifies, for externally described files, the DBCS attributes of the file.
For program-described files
For externally-described files
Top |
Specifies whether the system processes double-byte character set (DBCS) extended characters. When processing DBCS extended characters, the device requires the assistance of the system. The system must tell the device what the character looks like before the device can display or print the character. Extended characters are stored in a DBCS font table, not in the DBCS device. Extended character processing is a function of the operating system that is required to make characters stored in a DBCS font table available to a DBCS device.
Top |
Specifies the text that briefly describes the object.
Top |
Specifies the type of output produced when the file is created. A maximum of four of the following values can be specified in any order on this parameter. If neither or both of the values on an option are specified, the first value listed for the option is used.
Note: The first values on each option are similar to, but are not actually default values, and therefore, cannot be changed with the CHGCMDDFT (Change Command Default) command.
Source Listing Option
Program Listing Option
Second-Level Message Text Option
Event File Creation Option
Top |
Specifies the length and width of the printer forms used by this device file. The length is specified in lines per page or by the units specified for the UOM parameter. The width is specified in print positions (characters) per line or by the units specified for the Unit of measure (UOM) parameter.
The page size must be specified with reference to the way the data is printed on the page. For example, if using 8.5 inch wide by 11.0 inch long forms and printing at 6 lines per inch with a 10-pitch font, specify PAGESIZE(66 85) PAGRTT(0). However, to rotate the page, specify the page size for an 11.0 inch wide by 8.5 inch long page and enter PAGESIZE(51 110) PAGRTT(90).
Note: Specify PAGRTT(*AUTO) or PAGRTT(*DEVD) and PRTQLTY(*DRAFT) on this command to enable automatic reduction or rotation if the data does not fit on the paper.
Specify PAGRTT(*COR) on this command to enable automatic reduction whether or not the data fits on the paper.
Element 1: Length--lines per page
Element 2: Width--positions per line
Element 3: Measurement method
Top |
Specifies the line spacing setting on the printer, in lines per inch, to be used by this device file.
The line spacing on the 5256 printer must be set manually. When the lines per inch (LPI) value on this parameter changes (from the value on the previous printer file), an inquiry message is sent to the message queue associated with the printer that requests a change to the LPI value.
The line spacing on the 4214, 4224, 4230, 4234, 4245, and 5262 Printers is set by a print command. These also allow setting the lines per inch spacing on the control panel of the printer. The lines per inch value must not be set at the printer. If the LPI value is overridden at the control panel, the system overrides the value set with the LPI value of the next printer file received.
Note: When printing double-byte character set (DBCS) data for a file specified with LPI(8), use double spacing. Otherwise, the DBCS data does not print correctly. Alphanumeric data, however, prints correctly in single spacing when LPI(8) is specified.
Top |
Specifies the printer character density, in characters per inch.
For the printers that support fonts, the value specified in the font special value implies the CPI. If FONT(*CPI) is specified, the font used is based on the CPI value. The following diagram describes the default font ID for each CPI value:
CPI FONT ID DEFAULT 5 245 10 011 12 087 13.3 204 15 222 16.7 400 18 252 20 281
Top |
Specifies the offset, down and across, of the origin from the edge on the front side of the paper. The offsets are in the units of measure specified on the UOM parameter. This parameter can only be used for printer files with DEVTYPE(*AFPDS) specified.
Single values
Element 1: Offset down
Element 2: Offset across
Top |
Specifies the offset, down and across, of the origin from the edge on the back side of the paper. The offsets are in the units of measure specified on the UOM parameter. This parameter can only be used for printer files with DEVTYPE(*AFPDS) specified.
Single values
Element 1: Offset down
Element 2: Offset across
Top |
Specifies the line number on the page at which printer overflow to a new page occurs. Overflow is signaled when the specified line number becomes the current line, whether or not printing has occurred on that line.
Top |
Specifies whether all positions in a record are printed when the record length is greater than the page width. If *IPDS is specified on the Printer device type (DEVTYPE) parameter, this parameter is ignored.
When folding is specified and a record exceeds the page width, any portion of the record that cannot be printed on the first line continues (is folded) on the next line or lines until the entire record has been printed.
The FOLD parameter is ignored under the following conditions:
Double-Byte Character Set Considerations
The system ignores this parameter when printing double-byte character set (DBCS) files. The system assumes that DBCS records fit on a printed line. If the record exceeds the page width, the system continues printing the record on the next line.
Top |
Specifies whether unprintable characters are replaced and which substitution character (if any) is used for unprintable characters. An unprintable character is a character that the printer is not able to print.
Double-Byte Character Set Considerations
For double-byte character set (DBCS) data, an unprintable character is one that cannot be processed. When using DBCS-capable printers, consider the following:
More information is in the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Single values
Element 1: Replace character
Element 2: Replacement character
Top |
Specifies whether each page must be aligned in the printer before printing is started. If ALIGN(*YES) and SPOOL(*NO) are specified, and forms alignment is required, the system sends a message to the message queue specified in the printer device description and waits for a reply to the message. When spool (*YES) is specified on the CRTPRTF command and ALIGN(*FILE) is specified on the STRPRTWTR command, then this parameter is used to determine whether an alignment message is sent by the system.
This parameter is ignored when cut sheets are used (spooled and direct output). Page alignment can be done only for text-only files. Page alignment cannot be done for print jobs containing graphics or bar codes.
Top |
Specifies whether the printer device file supports input with print control characters.
If TBLREFCHR(*YES) is also specified, then the record length must include two extra positions for the control character and the table reference character.
Top |
Specifies a list of channel numbers with their assigned line numbers. Use this parameter only if *FCFC is specified for the Control character (CTLCHAR) parameter.
Single values
Code Action before Printing a Line ----- ----------------------------------------- ' ' Space one line (blank code) 0 Space two lines - Space three lines + Suppress space 1 Skip to line 1 2-11 Space one line 12 Skip to overflow line (OVRFLW parameter)
Element 1: Channel
Note: If the printer stops and the next record processed has a channel value forms-control number that is the same value as the line number the printer is on, the printer advances to that value (line number) on the next page. However, if the printer is positioned at the top of the page (line number one) and the channel value forms-control value is associated with line number one, the printer does not advance to a new a new page.
If no line number is specified for a channel identifier, and that channel identifier is encountered in the data, a default of 'space one line' before printing is used. Each channel number can be specified only once.
Element 2: Line number for channel
Top |
Specifies whether printing continues when print errors are found for printers configured with AFP(*YES).
Top |
Specifies, for the 3812 SCS, 3816 SCS, 4214, 4224, 4230, 4234, and 5219 printers, the quality of print produced.
Some non-impact IPDS printers support a toner miser feature. This feature is device dependent. Specifying *DRAFT for the PRTQLTY value will activate the toner miser feature on those printers that support it.
For the 5219 Printer, different print qualities are produced by varying the speed at which the print ribbon advances. Quality mode (*STD or *NLQ) results in normal print ribbon advancement. In draft mode (*DRAFT), the ribbon advances at a rate of one-third the distance it advances in quality mode. The 5219 Printer has a conserve ribbon switch that overrides the value of *DRAFT specified by this parameter.
For the 3812 SCS and 3816 SCS Printers, the automatic hardware selection of computer output reduction printing selected through soft switches on the printers occurs only when *DRAFT is specified for PRTQLTY and PAGRTT is *DEVD. If PAGRTT(*COR) is specified, the PRTQLTY parameter does not affect the printed output.
For the 4224, 4230, and 4234 Printers, standard print quality is produced by varying the density of the dot matrix pattern used to create printable characters. Standard mode (*STD) is the normal mode. Quality mode (*NLQ) requires multiple passes by the printer to produce a line of data. Draft mode (*DRAFT) results in high-speed printing.
For the 4214 printer, only draft (*DRAFT), quality (*NLQ), and device default (*DEVD) modes are supported. Other values are set to quality (*NLQ) mode.
More information about the valid values for the 4214, 4224, 4230, 4234, and 5219 Printers is in the Printer Device Programming Manual.
Notes:
Top |
Specifies the form feed attachment used by this printer device file.
Top |
Specifies the source drawer used when cut sheets are fed into the printer (specified by FORMFEED(*AUTOCUT)).
Top |
Specifies the destination of the output on printers capable of multiple output bins.
Top |
Specifies the font identifier and point size used with this printer device file.
More information about the valid font identifiers, the display value, the characters per inch value implied with each font style, a description of each font style, and whether the font is supported on a particular printer is in the Printer Device Programming Manual..
Note: Some fonts can be substituted by the printer. Consult the various printer reference guides for details.
Single values
Element 1: Identifier
Element 2: Point size
Top |
Specifies the character identifier (graphic character set and code page) for the printer file. This parameter allows you to print text that has different character identifier coding. The value specified for this parameter is used to instruct the printer device to interpret the hexadecimal byte string to print the same characters that were intended when the text was created. More information about the character identifier is in the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Single values
Note: The *JOBCCSID special value, either specified directly on the CHRID command parameter or on the CHRIDCTL job attribute when the *CHRIDCTL special value is specified for the CHRID command parameter, is not allowed if the file was created on a system at an earlier release level than V2R3M0. A file created prior to V2R3M0 will not be tagged with a CCSID and cannot be used in combination with the *JOBCCSID support.
Element 1: Graphic character set
Element 2: Code page
Top |
Specifies which decimal format value is used when editing numeric fields with the EDTCDE DDS keyword. The decimal format value determines the use of commas and periods for the decimal position and three digit positional separators on edited fields.
Top |
Specifies a downloaded font consisting of a character set and code page. This parameter can only be used for printer files with DEVTYPE(*AFPDS) specified.
Single values
Element 1: Character set
Qualifier 1: Character set
Qualifier 2: Library
Element 2: Code page
Qualifier 1: Code page
Qualifier 2: Library
Element 3: Point size
Note: The point size parameter is only used when an outlined font is named, in other cases it is ignored.
Top |
Specifies the coded font that the system uses for single-byte character set (SBCS) printing. This parameter can only be used for printer files with DEVTYPE(*AFPDS) specified.
Single values
Element 1: Coded font
Qualifier 1: Coded font
Qualifier 2: Library
Element 2: Point size
Note: The point size parameter is only used when an outlined font is named, in other cases it is ignored.
Top |
Specifies whether table reference characters are present in the line data.
If forms control characters are used with the data, the table reference character follows the forms control character but precedes the data bytes. If forms control characters are not used, the table reference character is the first byte of the data record. As with forms control character, if table reference characters are used, every data record must contain a TRC byte.
Top |
Specifies the page definition to be used to format line data.
You can specify a page definition with *LINE, *AFPDSLINE, or *USERASCII data. PSF/400 will convert the line data and page definition to IPDS.
When you specify a page definition on the printer file, some printer file parameters will be ignored when the spooled file is printed by PSF/400. The following print file parameters will be ignored
Single values
Because PSF/400 requires a page definition when *LINE or *AFPSDLINE is specified, an inline page definition is built from the print file parameters and passed to PSF/400 when *NONE is specified.
Qualifier 1: Page definition
Qualifier 2: Library
Top |
Specifies the form definition to use when printing the file. A form definition is a resource object that defines the characteristics of the form, including overlays, position of page data on the form, and number of copies of pages and modifications to pages. The form definition is located inline with the file being printed, or in a library.
When you specify a form definition (*DEVD or form definition name) on the printer file, some printer file parameters will be ignored when the spooled file is printed by PSF/400. The following print file parameters will be ignored:
Single values
Because PSF/400 requires a form definition, an inline form definition is built from the print file parameters and passed to PSF/400 when *NONE is specified.
Qualifier 1: Form definition
Qualifier 2: Library
Top |
Specifies one or more AFP characters (coded fonts) to be used with line data and a page definition.
Single values
Other values (up to 4 repetitions)
Top |
Specifies the degree of rotation of the text on the page with respect to the way the page is loaded into the printer. See the note under the PAGESIZE parameter for directions on specifying page size when rotating the page.
Specify *AUTO or *DEVD for this parameter and PRTQLTY(*DRAFT) on this command to enable automatic rotation if the data does not fit on the paper.
For computer output reduction printing, the following operations are done for cut-sheet IPDS printers:
Note: For landscape paper on non-impact continuous form printers, the rotation is counter-clockwise from the 0 degree rotation position (upper right corner of the first edge loaded into the printer).
Top |
Specifies, for spooled output only, whether or not multiple pages of output are printed on 1 physical page.
Note: Overlays are not reduced when more than one page is printed on a side.
For more information and examples see the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Top |
Specifies whether or not to reduce the output when doing multiple up printing.
For more information and examples see the Basic Printing information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Top |
Specifies the text that is printed at the bottom of each page of printed output and on separator pages.
Top |
Specifies the printing positions of the characters on a page to control the degree of print alignment at the right-hand margin. Justification is done to the record length on the printer file opened.
Note: The JUSTIFY parameter is supported only on the 3812 SCS, 3816 SCS, and 5219 Printers.
Top |
Specifies whether output is printed on one side or two sides of the paper.
Top |
Specifies the unit of measurement to be used.
Top |
Specifies the object that contains both the overlay that is printed on the front side of the page and the offset, down and across, from the point of origin used when the overlay is printed.
Single values
Element 1: Overlay
Qualifier 1: Overlay
Qualifier 2: Library
Element 2: Offset down
Element 3: Offset across
Top |
Specifies the object that contains both the overlay that is printed on the back side of the page and the offset, down and across, from the point of origin used when the overlay is printed.
The constant back function allows you to print overlays on blank pages without adding blank pages to the print application. Specifying the constant back function would cause, for each page generated by the application program, a blank page to be generated onto which the specified back overlay could be printed. The generated blank pages are called constant forms because no variable data from the user's program is printed on the pages. The constant back function is only supported for duplex printing. It is ignored when DUPLEX(*NO) is specified on the printer file.
Note that the offset down and offset across values are ignored when *CONSTANT is specified for constant back. An offset of 0.0 is assumed for these values.
Single values
Element 1: Overlay
Qualifier 1: Overlay
Qualifier 2: Library
Element 2: Offset down
Element 3: Offset across
Element 4: Constant back
Top |
Specifies whether line data and a page definition should be converted to AFPDS before the data is spooled.
Top |
Specifies whether IPDS (intelligent printer data stream) pass-through is done for the spooled file.
Note: Not all SCS or IPDS spooled files are eligible for IPDS pass-through. They may contain special functions that require transform to AFPDS for correct printing. Specifying IPDS pass-through on the printer file allows only those spooled files eligible for IPDS pass-through to bypass the extra transforms. Those spooled files not eligible for IPDS pass-through will still undergo the transforms to AFPDS and back to IPDS.
IPDS pass-through will not be valid for all PSF/400 supported printers. Any printer (or attachment) that does not support resident fonts can not support IPDS pass-through. This is because the resident font references in the data stream must be mapped to host fonts which are downloaded to the printer. All IBM IPDS printers, except for the following, can be supported with IPDS pass-through: 3820, 3825, 3827, 3828, 3829, 3831, 3835, 3900-001 and any printer attached to a system using the Distributed Print Function provided by either InfoPrint Manager or Print Services Facility for OS/2.
For V3R7, V4R1 and V4R2, IPDSPASTHR can be specified with the USRDFNDTA parameter in a printer file. You may continue using this support with existing printer files and PSF configuration objects by specifying IPDSPASTHR(*DEVD) in the printer file. If you specify a value of anything other than *DEVD for the IPDSPASTHR parameter, any IPDS pass-through value in the USRDFNDTA parameter is ignored.
Top |
Specifies the list of user resource libraries to be used for searching for AFP resources for a spooled file. If the AFP resource is not found in the user resource libraries, then the library list specified in the DEVRSCLIBL parameter of the PSF configuration object is searched. If no PSF configuration object is specified for the device, then libraries QFNTCPL, QFNT01-QFNT19, and QFNT61-69 are searched.
Single values
Other values (up to 4 repetitions)
For V3R7, V4R1 and V4R2, USRRSCLIBL can be specified with the USRDFNDTA parameter in a printer file. PSF/400 uses that value if USRRSCLIBL(*PRTF) is specified in a PSF configuration object which is specified in the printer device description. You may continue using this support with existing printer files and PSF configuration objects by specifying USRRSCLIBL(*DEVD) in the printer file. If you specify a value of anything other than *DEVD for the USRRSCLIBL parameter, any user resource library value in the USRDFNDTA parameter is ignored.
Top |
Specifies the reference corner to be used for a corner staple. A staple is driven into the media at the reference corner. Refer to your printer's documentation for information as to which reference corners are supported. Page rotation does not affect the placement of a corner staple.
Top |
Specifies where one or more staples are driven into the media along the finishing operation axis. Refer to your printer's documentation for information about which elements of this parameter are supported and which values for each element are supported. If specification of a value for an element is not supported by a printer, specify a value of *DEVD for that element. Page rotation does not affect the placement of an edge stitch.
Single values
Element 1: Reference edge
Specifies the reference edge to be used for an edge stitch. An edge stitch is formed by having one or more staples driven into the media along the finishing operation axis.
Element 2: Reference edge offset
Specifies the offset of the edge stitch from the reference edge toward the center of the media.
Element 3: Number of staples
Specifies the number of staples that are to be applied along the finishing operation axis.
Element 4: Staple offsets
Specifies the offset of the staples along the finishing operation axis. The offset is measured from the point where the finishing operation axis intersects either the bottom edge or the left edge of the media, toward the center of the media. Each consecutive value is used to position a single finishing operation centered on the specified point on the finishing operation axis.
Single values
Other values (up to 122 repetitions)
Top |
Specifies where one or more staples are driven into the media along the finishing operation axis, which is positioned at the center of the media parallel to the reference edge. Refer to your printer's documentation for information about which elements of this parameter are supported and which values for each element are supported. If specification of a value for an element is not supported by a printer, specify a value of *DEVD for that element. Page rotation does not affect the placement of an edge stitch.
Single values
Element 1: Reference edge
Specifies the reference edge to be used for a saddle stitch. A saddle stitch is formed by having one or more staples driven into the media along the finishing operation axis, which is positioned at the center of the media parallel to the reference edge.
Element 2: Number of staples
Specifies the number of staples that are to be applied along the finishing operation axis.
Element 3: Staple offsets
Specifies the offset of the staples along the finishing operation axis. The offset is measured from the point where the finishing operation axis intersects either the bottom edge or the left edge of the media, toward the center of the media. Each consecutive value is used to position a single finishing operation centered on the specified point on the finishing operation axis.
Single values
Other values (up to 122 repetitions)
Top |
Specifies the resolution PSF/400 uses when printing to a multiple resolution printer configured to report multiple resolutions, but the spooled file does not specify the font metrics and resolution or the font is not available at the resolution that is contained in the spooled file.
For more information regarding the algorithm used for searching a library list for a font resource, see the Printer Device Programming manual section entitled User and Device Resource Library Lists in the chapter called Working With PSF configuration objects.
Top |
Specifies whether output is held in the system buffer before being sent to the printer.
If *NO is specified for this parameter and *YES is specified for the SPOOL parameter, and if *IMMED is specified for the Spooled output schedule (SCHEDULE) parameter, output is held in the buffer until a page of output is available or until the system buffer is full.
If *IMMED is not specified for the SCHEDULE parameter, specifying *NO on this parameter has no effect.
Top |
Specifies whether the output data for the printer device file is spooled. If *NO is specified, the other parameters on this command related to spooling are ignored.
Top |
Specifies, for spooled output files only, the name of the output queue for the printer file.
Single values
Qualifier 1: Spooled output queue
Qualifier 2: Library
Top |
Specifies the type of form on which the output is printed. The identifiers used to indicate the type of forms are user-defined and can be a maximum of 10 characters in length.
Top |
Specifies, for spooled output only, the number of copies of the output being printed.
Top |
Specifies the expiration date for the spooled file. The spooled file will expire at 23:59:59, system local time on the date specified.
Top |
Specifies the number of days to keep the spooled file.
Note: A value must be specified for this parameter if the Expiration date for file (EXPDATE) parameter has a value of *DAYS. If the EXPDATE parameter has a value other than *DAYS, no value is allowed for this parameter.
Top |
Specifies, for spooled output files only, the starting and ending pages to print.
Element 1: Starting page
Element 2: Ending page
Top |
Specifies, for spooled output only, the maximum number of records that can be in the spooled file for jobs using this printer file. If this maximum is reached, an inquiry message is sent to the program message queue.
Top |
Specifies, for spooled output files only, the number of separator pages placed at the start of each printed file, including those between multiple copies of the same output.
Top |
Specifies, for spooled output files only, when the spooled output file is available to a writer.
Top |
Specifies, for spooled output only, whether the spooled file is held. The spooled file can be released by using the Release Spooled File (RLSSPLF) command.
Top |
Specifies, for spooled output files only, whether the spooled file is saved (left on the output queue) after the output has been produced.
Top |
Specifies the output priority for spooled output files that are produced by this job. The highest priority is 1 and the lowest priority is 9.
Top |
Specifies, for spooled files only, some user-specified data that identifies the file.
Top |
Specifies, for spooled output only, who the owner of the spooled file is.
Top |
Specifies, for spooled output only, one or more user-defined options to be used by user applications or user-specified programs that process spooled files. A maximum of four user-defined options can be specified.
Single values
Other values (up to 4 repetitions)
Top |
Specifies, for spooled output only, the user-defined data to be used by user applications or user-specified programs that process spooled files.
Top |
Single values
Element 1: Object
Qualifier 1: Object
Qualifier 2: Library
Element 2: Object type
Top |
Specifies whether the printer rotates double-byte character set (DBCS) characters 90 degrees counterclockwise when printing. The system prints rotated DBCS characters so that they appear in a vertical reading sequence. Alphanumeric characters are not rotated.
Top |
Specifies the printer character density of double-byte character set (DBCS) characters, in characters per inch (CPI).
Note: This parameter does not specify the printer character density of alphanumeric characters. Alphanumeric characters are printed with the value specified for the CPI parameter.
Top |
Specifies how the system prints shift control characters.
Top |
Specifies the coded font that the system uses for double-byte character set (DBCS) printing.
Single values
Element 1: DBCS coded font
Qualifier 1: DBCS coded font
Qualifier 2: Library
Element 2: Point size
Note: The point size parameter is only used when an outlined font is named, in other cases it is ignored.
Top |
Specifies the number of seconds that the program waits for the file resources to be allocated when the file is opened, or the device or session resources to be allocated when an acquire operation is performed to the file. If the file resources cannot be allocated in the specified wait time, an error message is sent to the program.
Top |
Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.
Top |
Specifies whether the level identifiers of the record formats in the printer device file are checked when the file is opened by a program. If so, the record format identifiers in the program must match those in the device file. Because the same record format name can exist in more than one file, each record format is given an internal system identifier when it is created.
Top |
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
Top |
Specifies whether an existing file, other than a save or database file, is replaced.
Note: The authority value for the file is determined by the user profile of the user. If an existing file is replaced, the authority value for the new file is copied from the replaced file.
Top |
Example 1: Creating a Printer File
CRTPRTF FILE(DSPHIST) SRCFILE(PRSNNL/JOBHIST) FILESEP(3)
This command creates a printer file named DSPHIST using the DDS source file named JOBHIST that is stored in the PRSNNL library. The defaults for the other parameters are assumed, except for FILESEP.
The printer uses standard forms that are 66 lines long and 132 print positions wide. An SCS data stream is used. It prints 6 lines per inch and overflows to a new page after line 60 is printed. The print image specified in the device description is used. Output is spooled to the output queue specified for the job and cannot be printed until the file is closed. The spooled file is not held or saved after printing. One copy of the output is printed, preceded by three separator pages, each containing the file name, the spooled number, and the job name and number. The print text specified in the current job is used.
Example 2: Creating a Printer File Containing DBCS Data
CRTPRTF FILE(IGCLIB/IGCPRT) IGCSTA(*YES) FORMFEED(*AUTOCUT) IGCCHRRTT(*YES)
This command creates a printer file, IGCPRT (stored in library IGCLIB) that contains DBCS data. Cut sheets are automatically fed, and double-byte characters are rotated when printing.
Top |
*ESCAPE Messages
Top |