Retrieve Printer File Attributes (QDFRPRTA) API

Use the Retrieve Printer File Attributes (QDFRPRTA) API to get specific information about the attributes used to create a printer file.

Authorities and Locks

Library Authority

*EXECUTE

File Authority

*USE

File Lock

*SHRNUP

Required Parameter Group

Receiver variable

OUTPUT; CHAR(*)

The receiver variable that receives the information requested. You can specify the size of the area smaller than the format requested as long as you specify the length of receiver variable parameter correctly. As a result, the API returns only the data the area can hold.

Length of receiver variable

INPUT; BINARY(4)

The length of the receiver variable provided. If the data available is larger than the length of the receiver variable, the result is truncated. The length of receiver variable parameter can be specified up to the size of the receiver variable specified in the user program. If the length of receiver variable parameter specified is larger than the allocated size of the receiver variable specified in the user program, the results are not predictable. The minimum length is 8 bytes.

Format of printer file information

INPUT; CHAR(8)

The format of the printer file information being returned. The format names that can be used are as follows:

PRTF0100

This format returns all the printer file attributes.

See Format PRTF0100 for details.

Qualified printer file name

INPUT; CHAR(20)

The name of the printer file whose attributes are to be extracted and the library in which it is located. The first 10 characters contain the file name. The second 10 characters contain the library name.

You can use these special values for the library name:

*CURLIB	The job's current library
*LIBL	The job's library list

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Format PRTF0100

Channel Value Entry

Field Descriptions

AFP Characters list. Up to four 4-byte names of coded fonts to be specified with the line data and a page definition. The 4-byte names are concatenated to X0 to identify up to four coded fonts which are to be used when TBLREFCHR is being used within the data.

Align page. Whether the pages must be aligned in the printer before printing is started. The possible values are 0 (*NO) or 1 (*YES).

If ALIGN(*YES) and SPOOL(*NO) were specified on the Create Printer File (CRTPRTF) command, 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 Create Printer File (CRTPRTF) command and ALIGN(*FILE) is specified on the Start Print Writer (STRPRTWTR) command, this value is used to determine whether an alignment message is sent by the system.

This value 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.

Back margin - offset across. Specify the offset of the origin from the left side of the page. The possible values are:

Back margin - offset down. Specify the offset of the origin from the top of the page. If *CM (centimeter) is specified for the Unit of measure (UOM) field, valid values range from 0 through 57.79 centimeters. If *INCH is specified for the UOM field, valid values range from 0 through 22.75 inches.

Back side overlay - constant back. 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. The possible values are:

Back side overlay - library. The name of the library where the overlay is located. The possible values are:

Back side overlay - name. The name of 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 possible values are:

Back side overlay - offset across. The offset across from the point of origin at which to begin printing the overlay . If UOM(*CM) is specified on the Create Printer File (CRTPRTF) command, valid values range from 0 through 57.79 centimeters, and if UOM(*INCH) is specified, valid values range from 0 through 22.75 inches.

Note that the offset across values are ignored when *CONSTANT is specified for constant back. An offset of 0.0 is assumed for these values.

Back side overlay - offset down. The offset down from the point of origin at which to begin printing the overlay . If UOM(*CM) is specified on the Create Printer File (CRTPRTF) command, valid values range from 0 through 57.79 centimeters, and if UOM(*INCH) is specified, valid values range from 0 through 22.75 inches.

Note that the offset down values are ignored when *CONSTANT is specified for constant back. An offset of 0.0 is assumed for these values.

Bytes available. The number of bytes of data available to be returned. All available data is returned if enough space is provided.

Bytes returned. The number of bytes of data returned.

Channel number. Specify an American National Standard channel number to be associated with a corresponding 'skip to' line number. The possible values for this field are:

Character identifier - code page. The code page value that matches the printer. Valid values range from 1 through 32767.

Character identifier - graphic character set. The graphic character set for the file. This field and the character identifier code page field allow printing of text that is in different character identifier (graphic character set and code page) coding. The values specified on these fields are 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. The possible values for this field are:

Characters per inch (CPI). Specifies the printer character density, in the unit of measure (characters per inch) used by this device file. For the printers that support fonts, the value specified in the font special value implies the CPI. If *CPI is specified for the font identifier field, the font used is based on the CPI value. The following table describes the default font ID for each CPI value:

The possible values are:

Coded font - library. The library where the coded font object is located. The possible values are:

Coded font - name. The name of the coded font. The possible values are:

Coded font - point size. The point size to be used. Range is 0.1-999.9. If 0 (*NONE) is returned, the point size is supplied by the system and is determined by the specified font character set.

Control character. Specifies whether the printer device file supports input with print control characters. Control characters that are not valid are ignored. Single spacing is assumed. The possible values are:

Convert line data. Whether line data and a page definition should be converted to AFPDS before the data is spooled. The possible values are 0 (*NO) or 1 (*YES).

Copies. For spooled output only, the number of copies of the output being printed. Range from 1 to 255.

Corner staple. 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. The possible values are:

Days until file expires. The interval in days after which the spooled file will be eligible for removal from the system by the Delete Expired Spooled Files (DLTEXPSPLF) command. The actual expiration date applied to the spooled file is calculated by adding the number of days specified to the date the printer file is opened. Range from 1 to 366. If the Expiration date for file field has a value other than *DAYS, 0 is returned for this field.

DBCS character rotation. Whether the printer rotates the 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. The possible values are 0 (*NO) or 1 (*YES).

DBCS characters per inch. The printer character density of double-byte character set (DBCS) data in characters per inch (CPI).

Note:This field does not specify the printer character density of alphanumeric characters. Alphanumeric characters are printed with the value specified on the CPI parameter on the Create Printer File (CRTPRTF) command.

The possible values are:

DBCS coded font - library. The library where the coded font name is located. The possible values are:

DBCS coded font - name. The coded font that the system uses for double-byte character set (DBCS) printing. The possible values are:

DBCS coded font - point size. The DBCS coded font point size. If a point size is specified, range from 0.1 to 999.9. If 0 (*NONE) is returned, the point size is supplied by the system and is determined by the specified font character set.

DBCS extension characters. Whether the system processes double-byte character set (DBCS) extension 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. The possible values are 0 (*NO) or 1 (*YES).

DBCS SO/SI spacing. How the system prints shift-in and shift-out characters. The possible values are:

Decimal format. Specifies which decimal format value is used when editing numeric fields with the EDTCDE (Edit Code) 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. The possible values are:

Defer write. Whether output is held in the system buffer before being sent to the printer. The possible values are 0 (*NO) or 1 (*YES).

Degree of page rotation. The degree of text rotation for the 3112, 3116, 3130, 3812, 3816, 4028, 3820, 3825, 3827, 3829, 3831, 3835, 3900, 3916, 3930 and 3935 printers. This value allows the user to specify the degree of rotation of the text on the page with respect to the way the form is loaded into the printer.

Device. 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. The possible values are:

Edge stitch - length of staple offset entry. The length in bytes of one staple offset entry.

Edge stitch - number of staple offsets. The number of staple offset entries in the staple offsets list.

Edge stitch - number of staples. The number of staples that are to be applied along the finishing operation axis. The possible values are:

Edge stitch - offset to staple offsets list. The offset to the user staple offsets list.

Edge stitch - reference edge 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. Refer to your printer's documentation for information about which elements of the EDGESTITCH parameter for a printer file 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. The possible values are:

Edge stitch - reference edge offset. The offset of the edge stitch from the reference edge. If UOM(*CM) is specified on the Create Printer File (CRTPRTF) command, valid values range from 0 through 57.79 centimeters, and if UOM(*INCH) is specified, valid values range from 0 through 22.75 inches. This value is converted to millimeters for the printer. Fractional millimeters are not supported and are discarded when conversion to millimeters is performed. If -1 (*DEVD) is returned, the reference edge offset is the default reference edge offset used by the device.

Edge stitch - staple offsets. 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. The possible values are:

Expiration date for file. The expiration date for the spooled file. The spooled file will expire at 23:59:59, system local time on the date specified. The possible values are:

Fidelity. Whether printing continues when print errors are found for printers configured with AFP(*YES). The possible values are:

File separators. 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. Each separator page has the following items printed on it: file name, file number, job name, user name, and job number. Value range is 0 to 9. If 0 is specified, no separator pages are printed for the file. In this case, the printed output for each file (or copy of a file) starts at the top of a new page.

Fold records. Whether all positions in a record are printed when the record length exceeds the page width (returned in the Page size width field). 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 possible values are 0 (*NO) or 1 (*YES).

Note: Fold records is ignored under the following conditions:

• When DEVTYPE(*SCS) is not specified in the printer file.
• When printing through OfficeVision^®.
• When in the S/36 execution environment.
• 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.

Font character set - code page. The name of the code page

Font character set - code page library. The library where the code page object is located. The possible values are:

Font character set - library. The library where the font character set is located. Special values are:

Font character set - name. The name of the font character set. The possible values are:

Font character set - point size. The point size to be used. Range is 0.1-999.9. If 0 (*NONE) is returned, the point size is supplied by the system and is determined by the specified font character set.

Font identifier. The numeric font identifier to be used with this printer device file. The possible values are:

Font point size. The font point size. The possible values are:

Font resolution for formatting. 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. The possible values are:

Form definition - library. The name of the library to be searched. The possible values are:

Form definition - name. 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. The possible values are:

When a form definition (*DEVD or form definition name) is specified 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:

• DUPLEX (If *FORMDF specified)
• DRAWER (If *FORMDF specified)
• PAGRTT
• PRTQLTY.
• FORMFEED
• FRONTMGN
• BACKMGN
• MULTIUP
• REDUCE
• CORNERSTPL
• EDGESTITCH
• SADLSTITCH

Form feed. The form feed attachment used by this printer device file. The possible values are:

Form type. The type of forms used in the printer. The possible values are:

Front margin - offset across. The offset of the origin from the left side of the page. The possible values are:

Front margin - offset down. The offset of the origin from the top of the page. If *CM (centimeter) is specified for the Unit of measure (UOM) field, valid values range from 0 through 57.79 centimeters. If *INCH is specified for the UOM parameter, valid values range from 0 through 22.75 inches.

Front side overlay - library. The name of the library where the overlay is located. The possible values are:

Front side overlay - name. The name of 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. If *NONE is returned no overlay is used.

Front side overlay - offset across. The offset across from the point of origin at which to begin printing the overlay. If UOM(*CM) is specified on the Create Printer File (CRTPRTF) command, valid values range from 0 through 57.79 centimeters, and if UOM(*INCH) is specified, valid values range from 0 through 22.75 inches.

Front side overlay - offset down. The offset down from the point of origin at which to begin printing the overlay. If UOM(*CM) is specified on the Create Printer File (CRTPRTF) command, valid values range from 0 through 57.79 centimeters, and if UOM(*INCH) is specified, valid values range from 0 through 22.75 inches.

Hardware justification. The printing positions of the characters on a page so that the right-hand margin of printing is regular. Justification is done to the record length on the printer file opened. The possible values are:

Note: Hardware justification is supported only on the 3812 SCS, 3816 SCS, and 5219 SCS printers.

Hold spooled file. For spooled output files only, whether the spooled file is held. The spooled file can be released by using the Release Spooled File (RLSSPLF) command. The possible values are 0 (*NO) or 1 (*YES).

IPDS pass through. Whether IPDS (intelligent printer data stream) pass-through is done for the spooled file. The possible values are:

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 undergoes 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 using Print Services Facility™ for OS/2^®'s Distributed Print Function.

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.

Length of AFP character. The length of one AFP character.

Length of channel value entry. The length of one channel value entry.

Length of To Stream File path. The length of the To Stream File path string.

Length of user defined option entry. The length of one user defined option entry.

Length of user resource library entry. The length of one user resource library entry.

Line number for channel. The line number assigned for the channel number in the same list. Line numbers range from 1 through 255. If no line number is assigned to a channel number, and that channel number is encountered in the data, a default of 'space one line' before printing is used.

Lines per inch (LPI). The line spacing setting on the printer, in the unit of measure (lines per inch), used by this device file. The possible values are:

Max spooled output records. For spooled output only, the maximum number of records that can be in the spooled file for spooled jobs using this printer file. Value range is 0-999999. If 0 (*NOMAX) is returned, there is no maximum on the number of records that can be in the spooled file.

Maximum file wait time. 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. The possible values are:

Number of AFP characters. The number of AFP characters. If 0 is returned, AFPCHARS(*NONE) command parameter is specified.

Number of channel values. The number of times the channel value entries are repeated. These fields are the channel number and channel line number. If 0 is returned, CHLVAL(*NORMAL) command parameter is specified.

Number of user defined options. The number of user defined options. If 0 is returned, USRDFNOPT (*NONE) command parameter is specified.

Number of user resource libraries. The number of user resource libraries. If 0 is returned, USRRSCLIBL (*DEVD) command parameter is specified.

Offset to AFP characters list. The offset to the AFP characters list.

Offset to channel values list. The offset to the channel values list.

Offset to To Stream File path. The offset to the To Stream File path string.

Offset to user defined option list. The offset to the user defined option list.

Offset to user resource library list. The offset to the user resource library list.

Output bin. The destination of the output on printers capable of multiple output bins. The possible values are:

Output priority. The output priority for spooled output files that are produced by this job. The highest priority is 1 and the lowest priority is 9. If 0 (*JOB) is returned, the output priority associated with the job that created the spooled file is used.

Overflow line number. The line number on the page at which overflow to a new page begins. Generally, after the specified line is printed, the printer overflows to the next page before printing continues. Margins specified for the printer file are ignored when determining overflow.

Page definition - library. The page definition library to be searched. The possible values are:

Page definition - name. The name of the page definition be used to format line data. Device type *AFPDSLINE, *LINE, or *USERASCII must be specified when using a page definition. If *NONE is returned, no page definition is specified. If a page definition with *LINE, *AFPDSLINE, or *USERASCII data was specified, PSF/400 will convert the line data and page definition to IPDS.

When a page definition on the printer file is specified, some printer file parameters will be ignored when the spooled file is printed by PSF/400. The following print file parameters will be ignored:

• CDEFNT
• CHRID
• CPI
• FNTCHRSET
• FOLD
• FONT
• LPI
• MULTIUP
• PAGESIZE
• PAGRTT
• REDUCE

Note: 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.

Page range to print - ending page. The ending page number to print. The possible values are:

Page range to print - starting page. The starting page number to print. The possible values are:

Page size length - lines per page. The page length that is used by this printer file. The length is specified in lines per page or by the units specified in the Unit of measure field.

Page size measurement method. The method used to measure the length and width of the page size. The possible values are:

Page size width - positions per line. The page width that is used by this printer file. The width is specified in print positions (characters) per line or by the units specified for the Unit of measure field.

Pages per side. Specifies, for spooled output only, whether or not multiple pages of output are printed on 1 physical page. The possible values are:

Note: Overlays are not reduced when more than one page is printed on a side.

Print on both sides. Whether output is printed on one side or two sides of the paper. The possible values are:

Print quality. The quality of the print produced. The possible values are:

Print text. The text that is printed at the bottom of each page of printed output and on separator pages. The possible values are:

Printer device type. The type of data stream that is used for a printer device file. The possible values are:

Printer file library name. The name of the library in which the printer file resides.

Printer file name. The name of the printer file about which information is returned.

Record format level check. Whether the level identifiers of the record formats in this device file are checked when the file is opened by a program. The possible values are 0 (*NO) or 1 (*YES)..

Reduce output. Whether or not to reduce the output when doing multiple up printing. The possible values are:

Reserved. The field is reserved.

Saddle stitch - length of staple offset entry. The length in bytes of one staple offset entry.

Saddle stitch - number of staple offsets. The number of staple offset entries in the staple offsets list.

Saddle stitch - number of staples. The number of staples that are to be applied along the finishing operation axis. The possible values are:

Saddle stitch - offset to staple offsets list. The offset to the user staple offsets list.

Saddle stitch - reference edge 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. The possible values are:

Saddle stitch - staple offsets. 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 saddle or the left saddle 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. The possible values are:

Save spooled file. For spooled output files only, whether the spooled file is saved (kept on the output queue) after the output has been produced. The possible values are 0 (*NO) or 1 (*YES). If 1 is returned, The spooled file data is kept on the output queue until the file is deleted. After the file is produced, the number of copies (see Copies field) is set to 1, and its status is changed from WTR to SAV. Refer to the Release Spooled File (RLSSPLF) command for information on how to produce the spooled file again.

Share open data path. 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. The possible values are:

Source drawer. The source drawer used when single-cut sheets are semi-automatically fed into the printer. The possible values are:

Spool file owner. For spooled output only, who the owner of the spooled file is. The possible values are:

Spool the data. Specifies whether the output data for the printer device file is spooled. If SPOOL(*NO) is specified on the Create Printer File (CRTPRTF) command, the following parameters on that command are ignored: OUTQ, COPIES, MAXRCDS, FILESEP, SCHEDULE, HOLD, SAVE, OUTPTY, and USRDTA. The possible values are 0 (*NO) or 1 (*YES).

Spooled output queue library. The library where the output queue is located. The possible values are:

Spooled output queue name. The name of the output queue (*OUTQ) object. The possible values are:

Spooled output schedule. For spooled output files only, when the spooled output file is made available to a diskette writer. Possible values are:

Table Reference Characters. Whether table reference characters are present in the line data. The possible values are 0 (*NO) or 1 (*YES).

Note: 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.

Text description. The text that describes the printer device file.

To Stream File path. Specifies the directory or stream file where the output data is to be written. All directories in the path name must exist. New directories are not created. This parameter is only valid when the Workstation customizing object (WSCST) parameter is not *NONE, or the Printer device type (DEVTYPE) parameter is *AFPDS.

If the To Stream File value refers to a directory, the system will create a stream file in that directory with a unique name derived from the printer file name. If the TOSTMF value is a file name, a stream file by that name must not already exist. The possible values are:

Unit of measure. The unit of measurement to be used. The possible values are:

Unprintable character action - replace character. Specifies whether unprintable characters are replaced. The possible values are 0 (*NO) or 1 (*YES).

Note: If DEVTYPE(*IPDS) and RPLUNPRT(*YES) were specified on the Create Printer File (CRTPRTF) command, a hyphen (-) is printed for the unprintable character.

Unprintable character action - replacement character. The replacement character that is used each time an unprintable character is detected. This character is used only if unprintable characters are replaced. Any printable EBCDIC character can be specified (X'40'-X'FE').

User data. For spooled output, user-specified data that identifies the file. The possible values are:

User defined data. For spooled output only, the user-defined data to be used by user applications or user-specified programs that process spooled files. The possible values are:

User defined object - library. The library where the user-defined object is located. The possible values are:

User defined object - name. The user-defined object to be used by user applications or user-specified programs that process spooled files. If no user-defined object is specified, *NONE is returned.

User defined object - type. The user object type can be one of the following:

User defined option list. 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. The possible values are:

User resource library list. 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. The possible values are:

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.

User specified DBCS data. For program described files, whether the file processes double-byte character set (DBCS) data. For externally described files, the DBCS attributes of the file.

For program described files the possible values are:

For externally described files, the possible values are:

Workstation Customizing Object - library. The library where the Workstation customizing object is located. The possible values are:

Workstation Customizing Object - name. Specifies the workstation customizing object to use to transform the printer file output to final form before writing it to a stream file. This parameter is only valid when the To stream file parameter is not *NONE.

Error Messages

The following messages may be sent from this function:

[ Back to top | Database and File APIs | APIs by category ]