ibmi-brunch-learn

Announcement

Collapse
No announcement yet.

'PRINT' keyword to program desribed file

Collapse
X
 
  • Filter
  • Time
  • Show
Clear All
new posts

  • 'PRINT' keyword to program desribed file

    When I press "PRINT SCREEN" from my program that contains the PRINT keyword in the dspf the screen prints to a spool file that is 132 wide. I want to change this to print to a spool file only 80 wide.

    I have tryied specifiying a printer file on the print keyword ('PRINT(Qsysprt2)') and then definning qsysprt2 in my program as 80 wide, but the screen still does not print to that file, it prints to what it printed to before. I do I change this?

    Thanks, Jane22

  • #2
    Re: 'PRINT' keyword to program desribed file

    Jane you can try the OVRPRTF or CHGSPLFA on your QSYSPRT2.

    Code:
    5722SS1 V5R3M0 040528                                         HELP                               06/17/05  10:20:48     Page     1
                                                  Change Spooled File Attributes - Help
             The Change Spooled File Attributes (CHGSPLFA) command allows you to
             change attributes of a spooled file while it is on an output queue.
             These changes affect only the current processing of the file.  The
             next time the job runs and the file is produced, the file
             attributes are derived from the device file description, the
             program, and any override commands.
             If the file is currently being produced on an output device, the
             only parameters that can be changed are COPIES, RESTART, and SAVE.
             An attempt to change any other parameter results in an error, and
             no file attributes are changed.  However, if the file is being held
             on an output queue because of spooling attribute errors, this
             command can be used to change the attributes, and a spooling writer
             can then be started to produce the file.
             See the Printer Device Programming book, SC41-5713 for more
             information about changing spooled file attributes.
             You can change the following attributes:
              o  The name of the device
              o  The order of the spooled file entries
              o  The output queue of the specified file
              o  The type of forms to be used for printer output
              o  The number of copies to be produced
              o  The number of separator pages for this printer file
              o  The schedule for the output
              o  Whether the spooled file is to be saved after it has been
                 written
              o  The output priority
              o  The user data that identifies the spooled file
              o  The alignment prompts to be used for a printer file
              o  The print quality for a printer file
              o  Whether to print the file on one or both sides of each page
              o  The form feed attachment to be used for a printer file
              o  The volume identifier used for diskette files
              o  The label identifier used for diskette files
              o  The exchange type used to write to diskette
              o  The character code (EBCDIC or ASCII) used for diskette
         Spooled file (FILE)
                                                                                                                            Page     2
             This is a required parameter.
             Specifies the name of the spooled file that is having its
             attributes changed.
             *SELECT
                 All spooled files that meet the selection values specified on
                 the Select files for prompt (SELECT parameter) are changed.
                 This value is mutually exclusive with a value specified on the
                 Job name prompt (JOB parameter), Spooled file number prompt
                 (SPLNBR parameter), Job system name prompt (JOBSYSNAME
                 parameter), or Spooled file created prompt (CRTDATE parameter).
             spooled-file-name
                 Specify the name of the spooled file.
         Job name (JOB)
             Specifies the name of the job that created the spooled file.
             *
                 The job that created the spooled file issued this command.
             job-name
                 Specify the name of the job that contains the spooled file.
             user-name
                 Specify the user name that identifies the user profile under
                 which the job is run.
             job-number
                 Specify the system-assigned job number.
         Spooled file number (SPLNBR)
             Specifies the unique number of the spooled file in the job whose
             attributes are being changed.
             *ONLY
                 Only one spooled file in the job has the specified file name;
                 therefore, the number of the spooled file is not necessary.
             *LAST
                 If there is more than one spooled file with the specified file
                 name the one with the highest number is the file whose
                 attributes are changed.
             *ANY
                 The spooled file number is not used to determine which spooled
                 file is used. Use this value when the job system name parameter
                 or the spooled file create date and time parameter is to take
                 precedence over the spooled file number when selecting a
                 spooled file.
             spooled-file-number
                 Specify the number of the spooled file that matches the file
                 name whose attributes you wish to change.
                                                                                                                            Page     3
         Job system name (JOBSYSNAME)
             Specifies the name of the system where the job that created the
             spooled file (JOB parameter) ran.  This parameter is considered
             after the job name, user name, job number, spooled file name, and
             spooled file number parameter requirements have been met.
             *ONLY
                 There is one spooled file with the specified job name, user
                 name, job number, spooled file name, spooled file number, and
                 spooled file create date and time.
             *CURRENT
                 The spooled file created on the current system with the
                 specified job name, user name, job number, spooled file name,
                 spooled file number, and create date and time is used.
             *ANY
                 The job system name is not used to determine which spooled file
                 is used. Use this value when the spooled file create date and
                 time parameter is to take precedence over the job system name
                 when selecting a spooled file.
             job-system-name
                 Specify the name of the system where the job that created the
                 spooled file ran.
         Spooled file created (CRTDATE)
             Specifies the date and time the spooled file was created.  This
             parameter is considered after the job name, user name, job number,
             spooled file name, spooled file number, and job system name
             parameter requirements have been met.
             The possible single values are:
             *ONLY
                 There is one spooled file with the specified job name, user
                 name, job number, spooled file name, spooled file number, and
                 job system name.
             *LAST
                 The spooled file with the latest create date and time of the
                 specified job name, user name, job number, spooled file name,
                 spooled file number, and job system name is used.
             The possible create date value is:
             spooled-file-create-date
                 Specify the date the spooled file was created.
             The possible create time values are:
             *ONLY
                 There is one spooled file with the specified job name, user
                 name, job number, spooled file name, spooled file number, job
                 system name, and spooled file create date.
                                                                                                                            Page     4
             *LAST
                 The spooled file with the latest create time of the specified
                 job name, user name, job number, spooled file name, spooled
                 file number, job system name, and spooled file create date is
                 used.
             spooled-file-create-time
                 Specify the time the spooled file was created.
         Select files for (SELECT)
             Specifies which files have their attributes changed.  This
             parameter allows you to process more than one file at a time.
             Positional values can be specified to select the files:  the user
             that created the file, the device that the file is queued for, the
             form type specified, the user data tag associated with the file, or
             the auxiliary storage pool the file is in.  Only files that meet
             each of the values are selected.
             The possible values for the user are:
             *CURRENT
                 Only files created by the user running this command are
                 selected.
             *ALL
                 Files created by all users are selected.
             user-name
                 Specify a user name.  Only files created by that user name are
                 selected.
             The possible values for the device are:
             *ALL
                 Files on any device-created or user-created output queue are
                 selected.
             *OUTQ
                 All files on any user-created output queue are selected.  A
                 user-created output queue is any output queue that is not
                 automatically created by a device.  A user-created output queue
                 does not generally have the same name as a device, but if it
                 does, it does not reside in library QUSRSYS.
             device-name
                 Specify a device name.  Only files on the device created output
                 queue for that device are selected.  A device created output
                 queue is one that has the same name as a device and resides in
                 the QUSRSYS library.  Unless it already exists, it will
                 automatically be created by the system when the device is
                 created.  A device created output queue cannot be deleted.
             The possible values for the form type are:
             *ALL
                 Files for all form types are selected.
                                                                                                                            Page     5
             *STD
                 Only files that specify the standard form type are selected.
             form-type
                 Specify the form type to select the file.
             The possible values for the user data are:
             *ALL
                 Files with any user data tag specified are selected.
             user-data
                 Specify the user data tag to select the file.
             The possible values for Auxiliary Storage Pool number (ASP) are:
             *ALL
                 All files as specified in the Auxiliary Storage Pool Device
                 (ASPDEV) parameter are selected.
             *ASPDEV
                 Files specified in the Auxiliary Storage Pool Device (ASPDEV)
                 parameter are selected.
             ASP-number
                 Specify the auxiliary storage pool (ASP) of the files being
                 selected.  Valid values are 1 to 32.
         ASP device (ASPDEV)
             Specifies the auxiliary storage pool device name from which spooled
             files are to be selected. This parameter is only valid if the ASP
             number (ASP) element of the Select parameter is *ALL or *ASPDEV.
             The possible values are:
             *
                 Files which are found in the ASPs that are currently part of
                 the thread's library name space are selected.  This includes
                 the system ASP (ASP 1), all defined basic user ASPs (ASPs
                 2-32), and if the thread has an ASP group, the primary and
                 secondary ASPs in the thread's ASP group.
             *SYSBAS
                 Files which are found in the system ASP (ASP 1) and all defined
                 basic user ASPs (ASPs 2-32) are selected.
             *CURASPGRP
                 Files which are found in the primary and secondary ASPs in the
                 thread's ASP group are selected.  If no ASP group is associated
                 with the thread, an error will be issued.
             auxiliary-storage-pool-device-name
                 Files which are found in the specified primary or secondary ASP
                 are selected. Only primary or secondary ASPs which are in the
                 thread's ASP group may be specified.  If no ASP group is
                 associated with the thread, an error will be issued.
                                                                                                                            Page     6
         Printer (DEV)
             Specifies the name of the printer that is used to print the file.
             *SAME
                 The current value does not change.
             *OUTQ
                 The file is not assigned to a specific printer.  Instead, it is
                 placed on the output queue specified on the Output queue prompt
                 (OUTQ parameter).
             device-name
                 Specify the name of the printer that will print this file.
         Print sequence (PRTSEQ)
             Specifies whether the file is the next file on the output queue to
             be printed.
             A value here is mutually exclusive with a value on the File becomes
             available prompt (SCHEDULE parameter) or Output priority prompt
             (OUTPTY parameter).
             *SAME
                 The file is not explicitly moved to the top.  Changes to the
                 File becomes available prompt (SCHEDULE parameter) or Output
                 priority prompt (OUTPTY parameter) may cause the position of
                 the file on the output queue to change.
             *NEXT
                 The attributes of the file (or files) are changed so that they
                 are moved to the top of the output queue.  If PRTSEQ(*NEXT) is
                 specified when the SELECT parameter is specified, files with
                 selection values are moved ahead of the files that do not meet
                 the requirements.  Two files that are both moved may change
                 their relative positions on the output queue.
         Form type (FORMTYPE)
             Specifies the type of forms used in the printer.
             *SAME
                 The type of forms does not change.
             *STD
                 The standard form used at your computer system is used to
                 produce this spooled file.
             form-type
                 Specify the type of form you wish to use to print the output of
                 this spooled file.  If the name of the form type includes
                 embedded blanks, you must enclose it in apostrophes.
         Copies (COPIES)
             Specifies, for spooled output only, the number of copies of the
                                                                                                                            Page     7
             output being printed.
                 Note:  If you specify a value while a file is being printed the
                 number of copies you specify are printed in addition to the
                 number of copies that have already been printed.
             *SAME
                 The number of copies remains unchanged.
             number-of-copies
                 Specify the number of identical copies to print.  Valid values
                 range from 1 to 255.
         Restart printing (RESTART)
             Specifies the page on which you wish to restart printing.
             Specifying a value while a file is being printed causes the writer
             to stop printing the file and restart on the specified page.  If a
             file is not being printed, this change takes effect when the first
             copy is printed.  After the writer repositions to the page
             specified by this parameter, the value for this parameter is reset
             to *STRPAGE.
             The possible values are:
             *SAME
                 The page on which to restart printing does not change.
             *STRPAGE
                 The first page specified on the Page range to print prompt
                 (PAGERANGE parameter) is the page on which to restart printing.
             *ENDPAGE
                 The starting page to print is the ending page to print.  Only
                 the end page is printed.
             *NEXT
                 The page following the last page printed is the page on which
                 to restart printing.  If printing has not been interrupted, the
                 starting page will be used.
                     Note:  You can determine the last page printed by using the
                     Work with Spooled File Attributes (WRKSPLFA) command.  This
                     value will be accurate when the writer has been ended
                     *PAGEEND or the file has been held *PAGEEND.  This value
                     may not be accurate if the writer has been ended *IMMED or
                     the spooled file has been held *IMMED.
             restart-page
                 Specify the page on which to restart printing.
         Volume (VOL)
             Specifies, for diskette output files only, one or more volume
             identifiers of the diskettes on which this spooled file will be
             written.  The diskettes (volumes) must be put into the device in
             the same order as the identifiers are specified here; a message is
             sent to the system operator if the order is different.
                                                                                                                            Page     8
             *SAME
                 The volume identifiers associated with the spooled file are not
                 changed.
             *NONE
                 No diskette volume identifiers are specified.  This file is
                 written on the first available diskette, based on the diskette
                 writer's current position.  No volume identifier checking is
                 performed.
             volume-identifier
                 Specify the identifier of one or more volumes in the order in
                 which they are inserted and used for this file.  Each volume
                 identifier contains a maximum of six characters.  A blank is
                 used as the separator character when listing multiple
                 identifiers.
                 If less than ten identifiers were initially specified for the
                 diskette unit file, a maximum of ten can be specified here.  If
                 more than ten volume names were specified when the file was
                 first opened, only that number of volumes can be entered on the
                 change command.  The maximum number of volumes allowed in the
                 list is 50.  You can always specify at least 10 volumes.  You
                 can enter multiple values for this parameter. If you are on an
                 entry display and you need additional entry fields to enter
                 these multiple values, type a plus sign (+) in the entry field
                 opposite the phrase "+ for more", and press the Enter key.
         File label (LABEL)
             Specifies, for diskette output files only, the data file identifier
             of the data file written on diskette from this spooled file.  The
             data file identifier is stored in a label in the volume label area
             of the diskette.
             *SAME
                 The data file identifier associated with the spooled file
                 remains the same.
             data-file-identifier
                 Specify the identifier (8 characters maximum) to be assigned to
                 the data file that will be written on the diskette.
         Output queue (OUTQ)
             Specifies the name of the output queue to which the spooled file is
             moved.  This parameter is used only when the specified file is
             moved from one output queue to another.
                 Note:  If the spooled file is currently on an output queue for
                 which DSPDTA(*OWNER) is specified, you must own the file or
                 have *SPLCTL authority to move it.
             The possible values are:
             *SAME
                 The file remains on the same output queue.
                                                                                                                            Page     9
             *DEV
                 The output queue associated with the printer device for the
                 spooled file is used.
             output-queue-name
                 Specify the name of the output queue to which the spooled file
                 is moved.
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the output
                 queue.  If no current library entry exists in the library list,
                 QGPL is used.
             library-name
                 Specify the library in which the output queue is located.
         File separators (FILESEP)
             Specifies the number of separator pages to produce at the beginning
             of each file so you can separate this file from the other files
             being printed.  The identifying information included on each file
             separator is the file name, file number, the name of the job and
             number, and the user's name.
             The possible values are:
             *SAME
                 The number of separator pages does not change.
             number-of-file-separators
                 Specify the number of pages (from 0 through 9) that are used as
                 file separators.
         Page range to print (PAGERANGE)
             Specifies the page range to print for each copy of the file.
             Restriction This parameter will be ignored by diskette writers when
             printer spooled files are redirected.
             Element 1: Starting Page to Print
             *SAME
                 The starting page does not change.
             *ENDPAGE
                 The starting page to print is the ending page to print.  Only
                 the ending page is printed.
             starting-page
                 Specify the starting page to printed.
             Element 2: Ending Page to Print
                                                                                                                            Page    10
             *SAME
                 The ending page does not change.
             *END
                 The last page of the file is the ending page to print.
             ending-page
                 Specify the ending page to print.
         File becomes available (SCHEDULE)
             Specifies when the spooled file is made available to the writer.
             *SAME
                 The schedule attribute of the spooled file does not change.
             *JOBEND
                 The spooled file is made available to the writer only after the
                 entire job is completed.
             *FILEEND
                 The spooled file is made available to the writer as soon as the
                 file has been closed in the program.
             *IMMED
                 The spooled output file is made available to the writer as soon
                 as the file is opened in the program.
         Save file (SAVE)
             Specifies whether the spooled file is saved after it has been
             written to an output device.
             *SAME
                 The save attribute of the spooled file does not change.
             *NO
                 The spooled file data is not held on the output queue after it
                 has been produced.
             *YES
                 The spooled file data is held on the output queue until the
                 file is deleted.  After the file is produced, the number of
                 copies is set to 1, and the status of the file is changed from
                 WTR to SAV.  Refer to the Release Spooled File (RLSSPLF)
                 command for information on how to produce the spooled file
                 again.
         Output priority (OUTPTY)
             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.
             *SAME
                 The current value does not change.
             *JOB
                                                                                                                            Page    11
                 The output priority associated with the job that created the
                 spooled file is used.
             output-priority
                 Specify the output priority assigned.  Valid values range from
                 1 (highest) to 9 (lowest).
         User data (USRDTA)
             Specifies, for spooled output, user-specified data that identifies
             the file.
             *SAME
                 The current value does not change.
             user-data
                 Specify up to 10 characters of data assigned to the spooled
                 file.
         Align page (ALIGN)
             Specifies whether to verify forms alignment on this file.  This
             parameter is only used by printer writers which were started with
             *FILE specified on the Align page prompt (ALIGN parameter).
             *SAME
                 The current value for forms alignment verification does not
                 change.
             *NO
                 The forms alignment is not verified.
             *YES
                 The forms alignment is verified.
         Print quality (PRTQLTY)
             Specifies the quality of the print to be produced.  Not all
             printers support this parameter.  Refer to the Create Printer File
             (CRTPRTF) command to determine which printers are supported.
             *SAME
                 The print quality associated with the spooled file remains the
                 same.
             *STD
                 The output is printed with standard quality.
             *DRAFT
                 The output is printed with draft print quality.
             *NLQ
                 The output is printed with near letter quality.
             *DEVD
                 The output is printed with the default print quality for the
                 printer.
             *FASTDRAFT
                                                                                                                            Page    12
                 The output is printed at a higher speed and with lower quality
                 than it would be if you specified *DRAFT.
         Form feed (FORMFEED)
             Specifies the form feed attachment used for this spooled file.
             This parameter determines how forms are fed into the printer.  Not
             all printers support this parameter.  Refer to the Create Printer
             File (CRTPRTF) command to determine if this parameter is supported.
             *SAME
                 The value does not change.
             *DEVD
                 The forms are fed into the printer in the manner specified in
                 the device description for that printer.
             *CONT
                 Continuous forms are used by the printer (the tractor feed
                 attachment must be present).
             *CONT2
                 Continuous forms are used by the printer.  The form is fed from
                 the secondary tractor feed attachment.  The secondary tractor
                 feed attachment must be on the printer device.
             *CUT
                 Single-cut sheets are used by the printer.  Each sheet must be
                 manually loaded.  For cut sheets, the forms alignment message
                 is not issued.
             *AUTOCUT
                 Single-cut sheets are automatically fed into the printer (the
                 sheet-feed attachment must be attached).  For cut sheets, the
                 forms alignment message is not issued.
         Source drawer (DRAWER)
             Specifies the source drawer used when single-cut sheets are fed
             into the printer (specified by FORMFEED(*AUTOCUT)).
             The possible values are:
             *SAME
                 The value does not change.
             *E1
                 The envelopes are fed from the envelope drawer on the
                 sheet-feed paper handler.
             *FORMDF
                 The form definition specifies the drawer from which the paper
                 is fed.
             source-drawer
                 Specify the drawer from which the paper is fed.  Valid values
                 range from 1 through 255.
         Print fidelity (FIDELITY)
                                                                                                                            Page    13
             Specifies the print fidelity that will be maintained for this file.
             The possible values are:
             *SAME
                 The print fidelity does not change.
             *ABSOLUTE
                 The file is printed exactly as intended.  Printing is stopped
                 if an error is encountered in the data stream.
             *CONTENT
                 Errors in the data stream are overridden, if possible, and
                 printing is continued.
         Print on both sides (DUPLEX)
             Specifies whether output is printed on one side or two sides of the
             paper.
             *SAME
                 The duplex value does not change.
             *NO
                 The output is printed on one side of the paper.
             *YES
                 The output is printed on both sides of the paper, with the top
                 of each printed page at the same end of the sheet of paper.
             *TUMBLE
                 The output is printed on both sides of the paper, with the top
                 of one printed page at the opposite end from the top of the
                 other printed page.  This is usually used for output that will
                 be bound at the top.
             *FORMDF
                 The duplex value specified in the form definition is used.
                 This value is valid only with printer device types of *AFPDS,
                 *AFPDSLINE, or *LINE.
         Pages per side (MULTIUP)
             Specifies, for spooled files, whether or not multiple pages of
             output are printed on each physical page.  This parameter is used
             only when the printer device type is *SCS, *IPDS, or *AFPDS and the
             spooled file was created on an iSeries 400 system.
                 Note:  This parameter cannot change when the value for Reduce
                 output (REDUCE) is *NONE.  You can determine the value of
                 Reduce output by using the Work with Spooled File Attributes
                 (WRKSPLFA) command.
             The possible values are:
             *SAME
                 The number of pages of output printed per physical page does
                                                                                                                            Page    14
                 not change.
             1
                 One page of output is printed for every physical page.
             2
                 Two pages of output are printed for every physical page.
             4
                 Four pages of output are printed for every physical page.
         Page definition (PAGDFN)
             Specifies the page definition to be used to format line data.
             The possible values are:
             *SAME
                 The value does not change.
             *NONE
                 No page definition is specified.
                 Because PSF/400 requires a page definition when *LINE or
                 *AFPDSLINE is specified, an inline page definition is built
                 from the print file parameters and passed to PSF/400 when *NONE
                 is specified.
             page-definition-name
                 Specify the name of the page definition that must exist in the
                 library specified.  Valid values range from 1 to 8 characters.
                 Device type *AFPDSLINE, *LINE, or *USERASCII must be specified
                 when using a page definition.
             The name of the page definition can be qualified by one of the
             following library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
         Form definition (FORMDF)
             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.
             The possible values are:
                                                                                                                            Page    15
             *SAME
                 The value does not change.
             *NONE
                 No form definition is used.
                 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.
             *DEVD
                 The name of the form definition is specified in the printer
                 device description.
             *INLINE
                 The form definition is searched for inline.  If no inline form
                 definition exists, the file will not print.
             *INLINED
                 The form definition is searched for inline.  If none exists,
                 the *DEVD form definition is used.
             form-definition-name
                 Specify the name of the form definition that must exist in the
                 library specified.  Valid values range from 1 to 8 characters.
             The name of the form definition can be qualified by one of the
             following library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
         AFP Characters (AFPCHARS)
             Specifies one or more AFP characters (coded fonts) to be used with
             line data and a page definition.
             The possible values are:
             *SAME
                 The value does not change.
             *NONE
                 No AFP characters (coded fonts) specified.
             coded-font-name
                 Specify 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
                                                                                                                            Page    16
                 concatenated to X0 to identify up to four coded fonts which are
                 to be used when TBLREFCHR is being used within the data.
         Front side overlay (FRONTOVL)
             Specifies the name and library that contains the overlay to be
             printed on the front side of the page.  This parameter also
             specifies where on the page to place the overlay.
             The possible overlay values are:
             *SAME
                 The front overlay value does not change.
             *NONE
                 No overlay is to be used.
             overlay
                 Specify the name of the overlay.
             The possible library values are:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the overlay.
                 If no library is specified as the current library for the job,
                 QGPL is used.
             library-name
                 Specify the name of the library where the overlay is located.
             The possible offset values are:
             *SAME
                 The offset does not change.
             offset
                 Specify the point where the overlay is placed.  The offset down
                 value specifies the vertical position and the offset across
                 value specifies the horizontal position.  Valid values range
                 from 0 through 57.79 if the unit of measure is centimeters, or
                 0 through 22.75 if the unit of measure is inches.  If no value
                 is specified, the system sets the offset to 0.
         Back side overlay (BACKOVL)
             Specifies the qualified name of the object that contains both the
             the overlay to be printed on the back side of the page and the
             offset, down and across, form the point of origin used when the
             overlay is printed.  This parameter is used only when the printer
             device is *SCS or *IPDS.
             Element 1: Overlay Name
             *SAME
             _____                                                                                                          Page    17
                 The back overlay value does not change.
             *FRONTOVL
                 The value specified for the Front side overlay prompt (FRONTOVL
                 parameter) is used.
             *NONE
                 No overlay is used.
             overlay
                 Specify the name of the overlay.
             The possible library values are:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the overlay.
                 If no library is specified as the current library for the job,
                 QGPL is used.
             library-name
                 Specify the name of the library where the overlay is located.
             Element 2: Offset Down
             *SAME
                 The offset does not change.
             offset-down
                 Specify the offset down from the point of origin at which to
                 begin printing.  If UOM(*CM) was specified on the CRTPRTF
                 command when this file was created, valid values range from 0
                 through 57.79 and if UOM(*INCHES) was specified, valid values
                 range from 0 through 22.57.
             Element 3: Offset Across
             *SAME
                 The offset does not change.
             offset-across
                 Specify the offset across from the point of origin at which to
                 begin printing the overlay.  If UOM(*CM) was specified on the
                 CRTPRTF command when this file was created, valid values range
                 from 0 through 57.79 and if UOM(*INCHES) was specified, valid
                 values range from 0 through 22.57.
             Element 4: 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 blank pages 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 print application is printed on the
                                                                                                                            Page    18
             pages.  This value is not changeable if MULTIUP is not 1.  The
             constant back function is only supported for duplex printing.  It
             is ignored when DUPLEX(*NO) is specified on the printer file.
                 Note:  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.
             The possible constant back values are:
             *SAME
                 The value does not change.
             *NOCONSTANT
                 The constant back function is not performed.
             *CONSTANT
                 The constant back function is performed.
         User Defined Option (USRDFNOPT)
             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.
             The possible values are:
             *SAME
                 The value does not change.
             *NONE
                 No user-defined options specified.
             user-defined-option
                 Specify a user-defined option to be used by user applications
                 or user-specified programs that process spooled files.  All
                 characters are acceptable.
         User Defined Data (USRDFNDTA)
             Specifies, 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:
             *SAME
                 The value does not change.
             *NONE
                 No user-defined data is specified.
             user-defined-data
                 Specify user-defined data to be used by user applications or
                 user-specified programs that process spooled files.  All
                 characters are acceptable.
         User Defined Object (USRDFNOBJ)
                                                                                                                            Page    19
             Specifies, for spooled output only, the user-defined object to be
             used by user applications or user-specified programs that process
             spooled files.
             The possible values are:
             *SAME
                 The value does not change.
             *NONE
                 No user-defined object specified.
             Element 1: Name of User-Defined Object
             object-name
                 Specify the user-defined object to be used by user applications
                 or user-specified programs that process spooled files.
             The user-defined object can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
             Element 2: Type of User-Defined Object
             object-type
                 The user object type can be one of the following:
                 *DTAARA     Data Area
                 *DTAQ       Data Queue
                 *FILE       File
                 *PSFCFG     PSF Configuration Object
                 *USRIDX     User Index
                 *USRQ       User Queue
                 *USRSPC     User Space
         IPDS pass through (IPDSPASTHR)
             Specifies whether IPDS (Intelligent Printer Data Stream)
             pass-through is done for the spooled file.
             The possible values are:
                                                                                                                            Page    20
             *SAME
                 The value does not change.
             *DEVD
                 The value specified for IPDSPASTHR in the PSF configuration
                 object specified for a printer device description is used.  If
                 no PSF configuration object is specified for the device, a
                 value of *NO is used.
             *NO
                 No IPDS pass-through is done.
             *YES
                 Specifies that IPDS pass-through is to be done if the spooled
                 file is eligible for IPDS pass-through.
                     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 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.
         Font resolution for formatting (FNTRSL)
             Specifies the resolution PSF/400 should use to print the spooled
             file when printing to a multiple resolution printer and the spooled
             file does not specify the font metrics and resolution with which to
             print the spooled file or the font is not available at that
             resolution.
             For more information regarding the algorithm used for searching a
             library list for a font resource, see the Printer Device
             Programming book, SC41-5713 in the section entitled "User and
             Device Resource Library Lists" in the chapter called "Working With
             PSF Configuration Objects".
             The possible values are:
                                                                                                                            Page    21
             *SAME
                 The value does not change.
             *DEVD
                 The value specified in the FNTRSL parameter of the PSF
                 configuration object for the device is used. If no PSF
                 configuration object is specified for the device, a value of
                 *SEARCH is used.
             *SEARCH
                 Specifies to search the library list for the first occurrence
                 of a host font with a name match.  The resolution of that font
                 is used to print the spool file.  Message PQT3546 is sent to
                 specify the resolution of the font that was selected.
             240
                 The font resolution is 240 pels per inch.
             300
                 The font resolution is 300 pels per inch.
         Diskette file exchange type (EXCHTYPE)
             Specifies, for diskette output files only, the exchange type used
             to write the spooled file.  This parameter determines the format
             and record length of the data being written to diskette. If you are
             going to read this diskette on another type of system, make sure
             this format is compatible with the other system.
             *SAME
                 The current value does not change.
             *STD
                 The BASIC exchange format is used for a type 1 or a type 2
                 diskette.  The H exchange type is used for a type 2D diskette.
             *BASIC
                 The BASIC exchange type is used.
             *H
                 The H exchange type is used.
             *I
                 The I exchange type is used.
         Code (CODE)
             Specifies, for diskette output files only, the type of character
             code used when this spooled file is written to diskette.
             *SAME
                 The type of character code associated with the spooled file
                 remains the same.
             *EBCDIC
                 The EBCDIC character code is used with this spooled file.
             *ASCII
                                                                                                                            Page    22
                 The ASCII character code is used.
         Examples for CHGSPLFA
             Example 1: Moving a File to Another Queue
                 CHGSPLFA   FILE(SALES)  JOB(000147/JONES/BILLING)  OUTQ(QPRINT2
                 )
                            FORMTYPE('1140-6')
             This command moves the file named SALES (of the BILLING job
             numbered 000147) from the present queue to the QPRINT2 queue. It
             also changes the forms identifier to 1140-6, which means that this
             form type is used in the printer.
             Example 2: Changing Number of Output Copies
                 CHGSPLFA   FILE(DEPT511)  COPIES(2)  FILESEP(5)
             This command changes the attributes of the spooled file DEPT511
             that is produced by the submitter's job. It changes the number of
             output copies to 2 and specifies that five separator pages precede
             each copy.
             Example 3: Changing Starting and Ending Pages to Print
                 CHGSPLFA   FILE(DEPT481)  PAGERANGE(99 100)
             This command changes the attributes of the spooled file, DEPT481.
             It changes the starting and ending pages that are to be printed.
             Now, only pages 99 and 100 of each copy of the file is printed.
             Example 4: Starting on a Specific Page
                 CHGSPLFA   FILE(DEPT481)  RESTART(5)
             This command restarts printing spooled file DEPT481 on page 5.  All
             of the copies that follow are printed from the specified starting
             page to ending page. If the file is in WTR status, the writer stops
             printing the current copy and restarts printing on page 5. The page
             specified on the RESTART parameter must be within the range
             specified on the PAGERANGE parameter.
             Example 5: Restarting on the Next Page
                 CHGSPLFA   FILE(DEPT481)  RESTART(*NEXT)
             This command restarts the printing job on the page following the
             last page printed when the job was interrupted. All of the copies
             that follow are printed from the specified starting page to ending
             page. The file must not be in WTR status. If the file is in WTR
             status, this command is rejected and a message is sent to the user.
             RESTART(*NEXT) is not valid when a file is being processed by a
             writer.
         Error messages for CHGSPLFA
             *ESCAPE_Messages
             ________________                                                                                               Page    23
             CPD3351     &1 parameter allowed only for print files.
             CPD3352     Page definition &1 in library &2 not found.
             CPD3353     Form definition &1 in library &2 not found.
             CPD3354     Parameter DRAWER conflicts with parameter FORMFEED.
             CPD3355     FORMDF(*NONE) conflicts with parameter DRAWER.
             CPD3356     DRAWER parameter not allowed with diskette parameters.
             CPD3357     PAGDFN parameter not allowed with diskette parameters.
             CPD3358     AFPCHARS parameter not allowed with diskette
                         parameters.
             CPD3359     FORMDF parameter not allowed with diskette parameters.
             CPF337E     ASP device &1 not in current ASP group for thread.
             CPF337F     ASP device &1 not allowed with ASP number &2.
             CPF2207     Not authorized to use object &1 in library &3 type *&2.
             CPF33AD     Target spooled file &1 not last spooled file in ready
                         status.  Source spooled file not moved.
             CPF33A6     Spooled file &1 selected by writer.  Spooled file not
                         moved.
             CPF33A7     Spooled file &1 number &8 in job &5/&4/&3 not moved.
             CPF33A8     Spooled file &1 specified more than once.  Spooled file
                         not moved.
             CPF33A9     Target spooled file &1 changed output queue.  Source
                         spooled file not moved.
             CPF33C2     Moving spooled files to the top allowed only for output
                         queues with SEQ(*FIFO).
             CPF33C3     Priority required to move spooled file exceeds user's
                         limit.
             CPF33C4     Spooled file &1 held by HLDJOB command.  Spooled file
                         not moved.
             CPF33C5     Target spooled file &1 selected by writer.  Source
                         spooled file not moved.
             CPF33C6     Priority required to move file exceeds user's limit.
             CPF33C7     Cannot move file ahead of other users' files.
             CPF33D0     Printer &1 does not exist.
             CPF33D1     User &1 does not exist.
             CPF33F0     Not authorized to move spooled file.
             CPF3303     File &1 not found in job &5/&4/&3.
             CPF3309     No files named &1 are active.
             CPF3330     Necessary resource not available.
             CPF3335     File &1 number &8 attributes not changed.
             CPF334A     Specified user defined object &1 not valid.  See
                         previous messages.
             CPF3340     More than one file with specified name found in job
                         &5/&4/&3.
             CPF3341     File &1 number &8 attributes not changed.
             CPF3342     Job &5/&4/&3 not found.
             CPF3343     Duplicate job names found.
             CPF3344     File &1 number &8 no longer in the system.
             CPF3401     Cannot change COPIES for files in PRT or SND status.
             CPF3464     Not authorized to output queue &1 in library &2.
             CPF3492     Not authorized to spooled file.
             CPF9825     Not authorized to device &1.
             CPF9833     *CURASPGRP or *ASPGRPPRI specified and thread has no
                         ASP group.
             CPFB8ED     Device description &1 not correct for operation.
                                           * * * * *   E N D   O F   L I S T I N G   * * * * *




    Code:
    5722SS1 V5R3M0 040528                                         HELP                               06/17/05  10:20:59     Page     1
                                                    Override with Printer File - Help
             The Override with Printer File (OVRPRTF) command is used to (1)
             override (replace) the file named in the program, (2) override
             certain parameters of a file that are used by the program, or (3)
             override the file named in the program and override certain
             parameters of the file processed.  Parameters overridden by this
             command are specified in the file description, in the program, or
             in other file override commands that run in the following command.
             If a file named in the program is overridden, the name of that file
             is specified in the FILE parameter and the name of the overriding
             file (the file processed) is specified in the TOFILE parameter.
             The OVRPRTF command also specifies parameters to override values
             contained in the file description of the overriding file.  If the
             file named in the program is not replaced but certain parameters of
             the file are overridden, the name of the file is specified in the
             FILE parameter and *FILE is specified in the TOFILE parameter.  The
             parameters overridden are then specified by the other parameters of
             the OVRPRTF command.  Parameters not specified do not affect
             parameters specified in the file description, in the program, or in
             other file override commands run later.
             Restrictions:
               1.  In a multithreaded job, this command may only be issued from
                   the initial thread.
               2.  In a multithreaded job, only Activation Group or Job scoped
                   overrides will affect opens performed in a secondary thread.
             More information on overriding files is in the Printer Device
             Programming book, SC41-5713.
                 Note:  Using this command does not cause a file to be
                 overridden immediately.  Information provided on this command
                 is stored until the file is used, at which time the file is
                 overridden.
         File being overridden (FILE)
             Specifies the name of the file being used by the program to which
             this override command is applied.  The specified file must be a
             printer device file when *FILE is specified in the Overriding to
             printer file prompt (TOFILE parameter).  Otherwise, any device file
             name or database file name is specified.
             *PRTF
                 The *PRTF override is applied.  This override applies to all
                 printer files being opened except for those printer files that
                 already have specific overrides.  For example, if a *PRTF
                 override is issued at call level 3, and an override is issued
                 for QSYSPRT at call level 3, the *PRTF override is applied to
                 all printer files being opened except for QSYSPRT since there
                 is a specific override for it.
             file-override-name
                 Specify the names of one or more overridden files for which the
                 overrides in the call level are applied.
                                                                                                                            Page     2
         Overriding to printer file (TOFILE)
             Specifies the name of the printer file that is used instead of the
             file specified in the File being overridden prompt (FILE
             parameter); or, if *FILE is specified, specifies that certain
             attributes are overridden by parameters specified in this command.
             The parameters specified on this OVRPRTF command override the same
             parameters specified in the printer file, in the program, or in
             other called (OVRPRTF) commands.
             *FILE
                 The printer device file named in the File being overridden
                 prompt (FILE parameter) has some of its parameters overridden
                 by values specified in this command.
             printer-device-file-name
                 Specify the name and library of the printer device file that is
                 used instead of the overridden file.
             The possible library values are:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the file.  If
                 no library is used as the current library for the job, QGPL is
                 used.
             library-name
                 Specify the library where the file is located.
         Device (DEV)
             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.
             *SYSVAL
                 The value in the system value QPRTDEV at the time the job is
                 started is used as the printer device.
             *JOB
                 The printer associated with the job is the printer device.
             device-name
                 Specify the name of the device that is used with the printer
                 file.  The device name must already be known on the system by a
                 device description.
             Double-byte character set considerations:  When printing a file
             that has double-byte character set (DBCS) data, specify a DBCS
             printer (5553, 5583).
                                                                                                                            Page     3
         Printer device type (DEVTYPE)
             Specifies the type of data stream that is created for a printer
             device file.  This parameter indicates whether the resulting data
             stream is an Intelligent Printer Data Stream (IPDS) or an SNA
             Character Stream (SCS).
             *SCS
                 An SNA Character Stream (SCS) data stream is created.
                     Note:  When using double-byte character set (DBCS) printers
                     (the 5553 and 5583 Printers), DEVTYPE(*SCS) must be
                     specified.
             *IPDS
                 An Intelligent Printer Data Stream (IPDS) is created.  This
                 parameter can be specified when using an IPDS printer.  If
                 *IPDS is specified and the spooled printer file is directed to
                 a printer other than an IPDS printer, the IPDS printer file is
                 converted to an SCS printer file.  More information is in the
                 Printer Device Programming book, SC41-5713.
             *USERASCII
                 An ASCII data stream is placed on a spooled output queue.  You
                 are responsible for placing the entire hexadecimal data stream
                 in the buffer, since the AS/400 system does not change or
                 validate the values that are passed.  This value cannot be
                 specified with SPOOL(*NO).
             *AFPDS
                 An advanced function print data stream (AFPDS) is created.
                 Some systems refer to this data stream as MODCA-P.
             *AFPDSLINE
                 Mixed data (line data and AFPDS data) is created.  This value
                 can be specified when using any printer supported by PSF/400.
                 The printer must be configured with AFP(*YES).
             *LINE
                 Line data is created.  This value can be specified when using
                 any printer supported by PSF/400.  The printer must be
                 configured with AFP(*YES).
         Page size (PAGESIZE)
             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 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).
                                                                                                                            Page     4
                 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.
             The possible values are:
             page-length
                 Specify the page length used by this device file.  Although a
                 value ranging from 1 through 255 is allowed, the value
                 specified should not exceed the actual length of the forms
                 used.
             page-width
                 Specify the page width used by this device file.  The value
                 specified should not exceed the actual width of the page used.
                 Valid values for the 3203, 4245, 5211, 5256, 5262, and 3287
                 printers range from 1 through 132.
             The possible method of measure values are:
             *ROWCOL
                 Page-length and page-width are measured as numbers of rows and
                 columns.
             *UOM
                 Page-length and page-width are measured in the units specified
                 on the UOM parameter.
         Lines per inch (LPI)
             Specifies the line spacing setting on the printer, in lines per
             inch, 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.
             The possible values are:
             3
                 The line spacing on the printer is 3 lines per inch.  This
                 value is valid only for double-byte character set (DBCS)
                 printers.
             4
                                                                                                                            Page     5
                 The line spacing on the printer is 4 lines per inch.
             6
                 The line spacing on the printer is 6 lines per inch.  This is
                 the default value for this parameter on the CRTPRTF command.
             7.5
                 The line spacing on the printer is 7.5 lines per inch.  This
                 value is valid only for double-byte character set (DBCS)
                 printers.
             8
                 The line spacing on the printer is 8 lines per inch.
                     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.
             9
                 The line spacing on the printer is 9 lines per inch.
             12
                 The line spacing on the printer is 12 lines per inch.
             Double-byte character set considerations:  When printing a file
             that has double-byte character set (DBCS) data, specify a DBCS
             printer (5553, 5583).
         Characters per inch (CPI)
             Specifies the printer character density (in 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 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
             The possible values are:
                                                                                                                            Page     6
             5
                 Character density is 5 characters per inch.
             10
                 Character density is 10 characters per inch.  (This is the
                 default value for this parameter on the CRTPRTF command.)
             12
                 Character density is 12 characters per inch.
             13.3
                 Character density is 13.3 characters per inch.  This value is
                 valid only for double-byte character set (DBCS) printers.
             15
                 Character density is 15 characters per inch.
             16.7
                 Character density is 16.7 characters per inch.
             18
                 Character density is 18 characters per inch.  This value is
                 valid only for double-byte character set (DBCS) printers.
             20
                 Character density is 20 characters per inch.  This value is
                 valid only for double-byte character set (DBCS) printers.
             Double-byte character set considerations:  When printing a file
             that has double-byte character set (DBCS) data, specify a DBCS
             printer (5553, 5583).
         Front margin (FRONTMGN)
             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.
             *DEVD
                 The no-print border from the printer is used to place the text
                 on the page when printing to a printer configured with
                 AFP(*YES).  A margin of 0 is used for IPDS printers without a
                 no-print border, or which are configured with AFP(*NO).
             The possible offset-down values are:
             0
                 No offset of the origin occurs.
             offset-down
                 Specify the offset of the origin from the top of the page.
             The possible offset-across values are:
             0
                 No offset of the origin occurs.
                                                                                                                            Page     7
             offset-across
                 Specify the offset of the origin from the left side of the
                 page.
         Back margin (BACKMGN)
             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.  If UOM(*CM) is specified,
             valid values range from 0 through 57.79, and if UOM(*INCH) is
             specified, valid values range from 0 through 22.57.  This parameter
             can only be used for printer files with DEVTYPE(*AFPDS) specified.
             The possible values are:
             *FRONTMGN
                 The offsets specified on the FRONTMGN parameter are used.
             *DEVD
                 The no-print border from the printer is used to place the text
                 on the page when printing to a printer configured with
                 AFP(*YES).  A margin of 0 is used for IPDS printers without a
                 no-print border, or which are configured with AFP(*NO).
             The possible offset-down values are:
             0
                 No offset of the origin occurs.
             offset-down
                 Specify the offset of the origin from the top of the page.
             The possible offset-across values are:
             0
                 No offset of the origin occurs.
             offset-across
                 Specify the offset of the origin from the left side of the
                 page.
         Overflow line number (OVRFLW)
             Specifies the line number on the page at which overflow to a new
             page occurs.  Generally, after the specified line is printed, the
             printer overflows to the next page before printing continues.
             Overflow is signaled when the specified line number is made the
             current line, whether printing has occurred on that line or not.
             The value specified must not exceed the forms length specified in
             the Page size prompt (PAGESIZE parameter) for the file.  Margins
             specified for the printer file are ignored when determining
             overflow.  More information is in the Printer Device Programming
             book, SC41-5713.  This parameter overrides the overflow value
             specified in the printer file, in the program, or in other called
             OVRPRTF commands.
             The possible values are:
                                                                                                                            Page     8
             overflow-line-number
                 Specify the line number on the current page at which overflow
                 to a new page begins, whether or not printing has occurred on
                 that line.  The value specified must not be greater than the
                 page length (PAGESIZE).  Margins specified for the printer file
                 are ignored when determining overflow.
         Fold records (FOLD)
             Specifies whether all positions in a record are printed when the
             record length exceeds the form width.  If so, any portion of the
             record that cannot be printed on the first line is continued
             (folded) on the next line or lines until the entire record is
             printed.
             The FOLD parameter is ignored under the following conditions:
              o  When DEVTYPE(*SCS) is not specified.
              o  When printing through the OfficeVision for AS/400 program.
              o  When in the S/36 processing environment.
             *YES
                 Records whose length exceeds the form width are folded on the
                 following lines.
             *NO
                 Records are not folded; if a record is longer than the form
                 width, only the first part of the record that fits on one line
                 is printed.
             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 form width, the system continues printing the
             record on the next line.
             This parameter overrides the value specified in the printer file,
             in the program, or in other called OVRPRTF commands.
         Unprintable character action (RPLUNPRT)
             Specifies whether unprintable characters are replaced and which
             substitution character (if any) is used.  An unprintable character
             is a character that the printer is unable to print.
                 Note:  If *IPDS is specified in the Printer device type prompt
                 (DEVTYPE parameter), a hyphen (-) is printed for the
                 unprintable characters.  The substitution character is ignored
                 for the 3287 printer.
             The possible values are:
             *YES
                 Unprintable characters are replaced.  The program is not
                 notified when unprintable characters are detected.
             *NO
                 Unprintable characters are not replaced.  When an unprintable
                                                                                                                            Page     9
                 character is detected, a message is sent to the program.
             '_'
                 A blank is used as the substitution character when an
                 unprintable character is detected and *YES is specified.
             'replacement-character'
                 Specify the substitution character that is used each time an
                 unprintable character is detected if *YES is also specified in
                 this parameter.  Any printable EBCDIC character can be
                 specified.
                 Double-byte character set considerations:  The system ignores
                 the chosen replacement character when you specify *YES.
                 Instead, the system replaces unprintable characters as follows:
                   1.  If *YES is also specified in the DBCS extension
                       characters prompt (IGCEXNCHR parameter), the system
                       replaces unprintable characters with double-byte
                       character set (DBCS) underscores.
                   2.  If *NO is specified in the DBCS extension characters
                       prompt (IGCEXNCHR parameter), the system replaces all
                       extension characters with the undefined character.
         Align page (ALIGN)
             Specifies whether the forms must be aligned in the printer before
             printing is started.  If *YES is specified and *NO is specified in
             the Spool the data prompt (SPOOL parameter), and forms alignment is
             required, the system sends a message to the message queue specified
             for the printer, and waits for a reply to the message.  If *YES is
             specified on the Spool the data prompt (SPOOL parameter), and *FILE
             is specified on the Align page prompt (ALIGN parameter), of the
             Start Printer Writer (STRPRTWTR) command, this parameter is used to
             determine whether an alignment message should be 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.
             The possible values are:
             *NO
                 No forms alignment is required.
             *YES
                 The forms are aligned before the output is printed.
         Source drawer (DRAWER)
             Specifies the source drawer used when single-cut sheets are fed
             into the printer.  *AUTOCUT must be specified on the Form feed
             prompt (FORMFEED parameter).
             *E1
                                                                                                                            Page    10
                 The envelopes are fed from the envelope drawer on the
                 sheet-feed paper handler.
             *FORMDF
                 The paper is fed from the source drawer specified in the form
                 definition.  If a form definition is not specified, then source
                 drawer 1 is used.
             source-drawer
                 Specify the drawer from which the paper is fed.  Valid values
                 range from 1 through 255.
         Output bin (OUTBIN)
             Specifies the destination of the output on printers capable of
             multiple output bins.
             The possible values are:
             *DEVD
                 The destination of the output is the device default output bin.
             output-bin
                 Specify the output bin for the destination of the output.
                 Valid values range from 1 through 65535.
         Font specifications (FONT)
             Specifies the font identifier and point size used with this printer
             device file.  If a font identifier and point size is not specified,
             the system automatically sets them.
             The possible font identifier values are:
             *CPI
                 The identifier of the font with the specified pitch (characters
                 per inch (CPI)) is used.
             *DEVD
                 The font identifier and point size specified in the device
                 description are used.
             identifier
                 Specify the numeric font identifier being used with this
                 printer device file.
             The possible point size values are:
             *NONE
                 No point size is specified; the system sets one based on the
                 type of printer being used.
             point-size
                 Specify a point size.  Valid values range from .1 through 999.9
                 points.
         Form feed (FORMFEED)
             Specifies the form feed attachment used by this printer device
                                                                                                                            Page    11
             file.
             *DEVD
                 The forms are fed into the printer in the manner specified in
                 the device description.
             *CONT
                 Continuous forms are used by the printer.  The tractor-feed
                 attachment must be put on the printer if this value is
                 specified.
             *CONT2
                 Continuous forms are used by the printer.  The form is fed from
                 the secondary tractor feed attachment.  The secondary tractor
                 feed attachment must be on the printer device.
             *CUT
                 Single-cut sheets are used by the printer.  Each sheet must be
                 loaded manually.  For cut sheets, the forms alignment message
                 is not issued.
             *AUTOCUT
                 Single-cut sheets are semiautomatically fed into the printer.
                 The sheet-feed attachment must be put on the printer if this
                 value is specified.  For cut sheets, the forms alignment
                 message is not issued.
         Print quality (PRTQLTY)
             Specifies, for the 3812 SCS, 3816 SCS, 4214, 4224, 4230, 4234, and
             5219 printers, the quality of print produced.
             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.  In other words, the 5219
             Printer conserves printer ribbon when in draft mode by not
             advancing it as fast per character printed.  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.
                                                                                                                            Page    12
             NOTES:
              o  For the 4214 Printer, quality mode (*STD or *NLQ) is only
                 supported for 10 and 12 characters per inch.  If PRTQLTY(*STD
                 or *NLQ) and 5, 15, or 16.7 characters per inch is specified,
                 the data is printed in draft mode.
              o  For the 4234 Printer, only a limited character set (62
                 characters) is supported when PRTQLTY(*DRAFT) is specified.  A
                 description of the character set supported with draft print
                 quality is in the 4234_Printer_Operator's_Guide.
              o  For the 4224 and 4230 printers, the fonts supported are not
                 available for all three print qualities.  The OCR-A and OCR-B
                 fonts are supported only with PRTQLTY(*NLQ).  The Courier and
                 Essay fonts are available only with PRTQLTY(*NLQ) and
                 PRTQLTY(*STD).  The Gothic font is available only with
                 PRTQLTY(*DRAFT) or PRTQLTY(*FASTDRAFT).  If there is a mismatch
                 between the print quality and the font selected, the font is
                 changed to match the print quality.
              o  Specify PAGRTT(*DEVD) and PRTQLTY(*DRAFT) on this command to
                 enable automatic rotation if the data does not fit on the
                 paper.
             The possible values are:
             *STD
                 The output is printed with standard quality.
             *DRAFT
                 The output is printed with draft quality.
             *DEVD
                 The print quality is set on the printer by the user.  It is not
                 set in the data stream.
             *NLQ
                 The output is printed with near letter quality.
             *FASTDRAFT
                 The output is printed at a higher speed and with lower quality
                 than it would be if you specified *DRAFT.  This value is only
                 supported by the 4230 printer.
         Control character (CTLCHAR)
             Specifies whether the printer device file supports input with print
             control characters.  Any control characters found that are not
             valid are ignored, and single spacing is assumed.
             *NONE
                 No print control characters are passed in the data printed.
             *FCFC
                 The first character of every record contains an ANSI
                 forms-control character.  If *FCFC is specified, the record
                                                                                                                            Page    13
                 length must include one position for the first-character
                 forms-control code.  This value is not valid for externally
                 described printer files.
             *MACHINE
                 The first character of every record contains a machine code
                 control character.  If *MACHINE is specified, the record length
                 must include one extra position for the first character forms
                 control code.  This value is not valid for externally described
                 printer files.
                 If TBLREFCHR(*YES) is also specified, then the record length
                 must include two extra positions for the control character and
                 the table reference character.
         Channel values (CHLVAL)
             Specifies a list of channel numbers with their assigned line
             numbers.  Use this parameter only if *FCFC is specified in the
             Control character prompt (CTLCHAR parameter).
                 Note:  If one or more channel-number/line-number combinations
                 are changed, all other combinations must be re-entered.
             *NORMAL
                 The default values for skipping to channel identifiers are
                 used.
             channel-number
                 Specify an American National Standard channel number to be
                 associated with a corresponding 'skip to' line number.  Valid
                 values for this parameter range from 1 through 12,
                 corresponding to channels 1 through 12.  The CHLVAL parameter
                 associates the channel number with a page line number.  For
                 example, if you specify CHLVAL(2 20), channel identifier 2 is
                 allocated with line number 20; therefore, if you place the
                 forms-control 2 in the first position of a record, the printer
                 skips to line 20 before printing the line.
                     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.
             line-number
                 Specify the line number assigned for the channel number in the
                 same list.  Valid 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
                                                                                                                            Page    14
                 line' before printing is used.  Each line number should be
                 specified only once.
         Fidelity (FIDELITY)
             Specifies whether printing continues when print errors are found
             for printers configured with AFP(*YES).
             The possible values are:
             *CONTENT
                 Printing continues when errors are found.
             *ABSOLUTE
                 Printing stops when errors are found.
         Character identifier (CHRID)
             Specifies the character identifier (graphic character set and code
             page) for the file.  This parameter allows you to print text that
             is in different character identifier (graphic character set and
             code page) coding.  The value specified on this parameter is used
             to command the printer device to interpret the hexadecimal byte
             string by printing the same characters that were intended when the
             text was created.
             The possible values are:
             *DEVD
                 The default CHRID value that the device is designed to handle
                 is used.  Character selection is normal because the file has
                 the same character identifier as the device default.
             *SYSVAL
                 The CHRID value specified for the system on which the
                 application runs is used.
             *JOBCCSID
                 The character identifier for the printer file is taken from the
                 coded character set identifier (CCSID) of the job.
                     Note:  This value is not allowed if the file was created on
                     a system at an earlier release level than V2R3M0.
             graphic-character-set code-page
                 Specify the graphic character set and code page values that
                 match the printer.  Valid values range from 1 through 32767.
         Decimal format (DECFMT)
             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.
             The possible values are:
             *FILE
                                                                                                                            Page    15
                 Use the decimal format value stored with the file when the file
                 was created.
             *JOB
                 Use the decimal format value from the DECFMT job attribute when
                 the file is opened.
         Font character set (FNTCHRSET)
             Specifies a downloaded font consisting of a character set and code
             page.  For an outline font, a point size is required.  For a raster
             font, the point size is ignored.  This parameter can only be used
             for printer files with DEVTYPE(*AFPDS) specified.
             The possible values are:
             *FONT
                 The value specified on the FONT parameter is used.
             The font character set value can be qualified by one of the
             following library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the font
                 character set.  If no library is specified as the current
                 library for the job, the QGPL library is used.
             library-name
                 Specify the name of the library where the font character set is
                 located.
             The code page name value can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the code page
                 name.  If no library is specified as the current library for
                 the job, the QGPL library is used.
             library-name
                 Specify the name of the library where the code page name is
                 located.
             The possible Point size values are:
             *NONE
                 The point size is supplied by the system and is determined by
                 the specified font character set.
             point-size
                                                                                                                            Page    16
                 Specify a point size ranging from 0.1 through 999.9.
         Coded font (CDEFNT)
             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.
             The possible values are:
             *FNTCHRSET
                 The font specified on the FNTCHRSET parameter is used.
             coded-font-name
                 Specify the coded font name to use.
             The coded font name value can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the coded
                 font name.  If no library is specified as the current library
                 for the job, the QGPL library is used.
             library-name
                 Specify the name of the library where the coded font name is
                 located.
             The possible Point size values are:
             *NONE
                 The point size is supplied by the system and is determined by
                 the specified font character set.
             point-size
                 Specify a point size ranging from 0.1 through 999.9.
         Page definition (PAGDFN)
             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:
              o  CDEFNT
              o  CHRID
              o  CPI
              o  FNTCHRSET
              o  FOLD
                                                                                                                            Page    17
              o  FONT
              o  LPI
              o  MULTIUP
              o  PAGESIZE
              o  PAGRTT
              o  REDUCE
             The possible values are:
             *NONE
                 No page definition is specified.
                 Because PSF/400 requires a page definition when *LINE or
                 *AFPDSLINE is specified, an inline page definition is built
                 from the print file parameters and passed to PSF/400 when *NONE
                 is specified.
             page-definition-name
                 Specify the name of the page definition that must exist in the
                 library specified.  Valid values range from 1 to 8 characters.
                 Device type *AFPDSLINE, *LINE, or *USERASCII must be specified
                 when using a page definition.
             The name of the page definition can be qualified by one of the
             following library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
         Form definition (FORMDF)
             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:
              o  DUPLEX (If *FORMDF specified)
              o  DRAWER (If *FORMDF specified)
              o  PAGRTT
              o  PRTQLTY
              o  FORMFEED
              o  FRONTMGN
              o  BACKMGN
                                                                                                                            Page    18
              o  MULTIUP
              o  REDUCE
              o  CORNERSTPL
              o  EDGESTITCH
              o  SADLSTITCH
             The possible values are:
             *NONE
                 No form definition is used.
                 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.
             *DEVD
                 The name of the form definition is specified in the printer
                 device description.
             form-definition-name
                 Specify the name of the form definition that must exist in the
                 library specified.  Valid values range from 1 to 8 characters.
             The name of the form definition can be qualified by one of the
             following library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
         AFP Characters (AFPCHARS)
             Specifies one or more AFP characters (coded fonts) to be used with
             line data and a page definition.
             The possible values are:
             *NONE
                 No AFP characters (coded fonts) specified.
             coded-font-name
                 Specify 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.
         Table Reference Characters (TBLREFCHR)
             Specifies whether table reference characters are present in the
             line data.
                                                                                                                            Page    19
             The possible values are:
             *NO
                 No table reference character is present in line data.
             *YES
                 Table reference characters are present in 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.
         Degree of page rotation (PAGRTT)
             Specifies the degree of rotation of the text on the page with
             respect to the way the form is loaded into the printer.
             *AUTO
                 Indicates that automatic rotation of output is done to fit the
                 printed data on the form.  If rotation does not accomplish
                 this, computer output reduction is performed automatically
                 (regardless of the print quality being used).  This parameter
                 is valid only for printers supporting rotation.
             *DEVD
                 The operating system sends a device default rotation value to
                 the printer.  Page rotation is dependent on your printer's
                 specifications.  See your printer or printer emulation
                 documentation to determine how page rotation is affected.
             *COR
                 Computer output reduction is done.  Computer output reduction
                 allows printed output intended for a 13.2-inch wide by
                 11.0-inch long form to be printed on an 8.5-inch wide by
                 11.0-inch long form.
             0
                 No rotation is done.  Printing starts at the edge loaded into
                 the printer first, and is parallel to that edge.
             90
                 Rotation of the text is done 90 degrees clockwise from the 0
                 degree writing position.
             180
                 Rotation of the text is done 180 degrees clockwise from the 0
                 degree writing position.
             270
                 Rotation of the text is done 270 degrees clockwise from the 0
                 degree writing position.
         Pages per side (MULTIUP)
                                                                                                                            Page    20
             Specifies, for spooled output only, whether multiple pages of
             output are printed on 1 physical page.
             The possible values are:
             1
                 One page of output is printed on one physical sheet of paper.
             2
                 Two pages of output are printed on 1 physical sheet of paper.
             3
                 Three pages of output are printed on 1 physical sheet of paper.
             4
                 Four pages of output are printed on 1 physical sheet of paper.
         Reduce output (REDUCE)
             Specifies whether to reduce the output when doing multiple up
             printing.
             For examples and more details see the Printer Device Programming
             book, SC41-5713.
             The possible values are:
             *TEXT
                 The text output is reduced when doing multiple up printing.
             *NONE
                 The output is not reduced when doing multiple up printing.
         Print text (PRTTXT)
             Specifies the text that is printed at the bottom of each page of
             printed output and on separator pages.
             *JOB
                 The value from the current job is used.
             *BLANK
                 No text is printed.
             'print-text'
                 Specify no more that 30 characters of text, enclosed in
                 apostrophes.
         Hardware justification (JUSTIFY)
             Specifies the printing positions of the characters on a page so
             that the right-hand margin of printing is regular.
             0
                 No justification occurs.  (This is the default value for this
                 parameter on the CRTPRTF command.)
             50
                                                                                                                            Page    21
                 Spaces are added to the blanks in the text so that the right
                 margin is more closely aligned, but not flush.
             100
                 The text is expanded by spaces (added where the blanks already
                 exist) until the right margin is flush.
         Print on both sides (DUPLEX)
             Specifies whether output is printed on one side or two sides of the
             paper.
             *NO
                 The output is printed on one side of the paper.
             *YES
                 The output is printed on both sides of the paper, with the top
                 of each printed page at the same end of the sheet of paper.
             *TUMBLE
                 The output is printed on both sides of the paper, with the top
                 of one printed page at the opposite end from the top of the
                 other printed page.  This is usually used for output that will
                 be bound at the top.
             *FORMDF
                 The output is printed on both sides of the paper if the duplex
                 value is specified in the form definition.  If a form
                 definition is not specified, then the output is printed on one
                 side of the paper.
         Unit of measure (UOM)
             Specifies the unit of measurement to be used.
             The possible values are:
             *INCH
                 The inch is used as the unit of measurement.
             *CM
                 The centimeter is used as the unit of measurement.
         Front side overlay (FRONTOVL)
             Specifies the qualified 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.
             The possible values are:
             *NONE
                 No overlay is used.
             The possible Overlay values are:
             overlay-name
                                                                                                                            Page    22
                 Specify the name of the overlay.
             The name of the overlay can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the overlay.
                 If no library is specified as the current library for the job,
                 the QGPL library is used.
             library-name
                 Specify the name of the library where the overlay is located.
             The possible Offset down values are:
             0
                 No offset down from the point of origin is used.
             offset-down
                 Specify the offset down from the point of origin at which to
                 begin printing the overlay.  If UOM(*CM) is specified, valid
                 values range from 0 through 57.79, and if UOM(*INCH) is
                 specified, valid values range from 0 through 22.57.
             The possible Offset across values are:
             0
                 No offset across from the point of origin is used.
             offset-across
                 Specify the offset across from the point of origin at which to
                 begin printing the overlay.  If UOM(*CM) is specified, valid
                 values range from 0 through 57.79, and if UOM(*INCH) is
                 specified, valid values range from 0 through 22.57.
         Back side overlay (BACKOVL)
             Specifies the object name and library name containing 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
                                                                                                                            Page    23
             assumed for these values.
             The possible values are:
             *FRONTOVL
                 The values that are specified on the FRONTOVL parameter are
                 used.
             *NONE
                 No overlay is used.
             The possible Overlay values are:
             overlay-name
                 Specify the name of the overlay.
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the overlay.
                 If no library is specified as the current library for the job,
                 the QGPL library is used.
             library-name
                 Specify the name of the library where the overlay is located.
             The possible Offset down values are:
             0
                 No offset down from the point of origin is used.
             offset-down
                 Specify the offset down from the point of origin at which to
                 begin printing the overlay.  If UOM(*CM) is specified, valid
                 values range from 0 through 57.79, and if UOM(*INCH) is
                 specified, valid values range from 0 through 22.57.
             The possible Offset across values are:
             0
                 No offset across from the point of origin is used.
             offset-across
                 Specify the offset across from the point of origin at which to
                 begin printing the overlay.  If UOM(*CM) is specified, valid
                 values range from 0 through 57.79, and if UOM(*INCH) is
                 specified, valid values range from 0 through 22.57.
             The possible Constant Back values are:
             *NOCONSTANT
                 No constant back is specified.
             *CONSTANT
                 Constant back is specified.
         Convert line data (CVTLINDTA)
                                                                                                                            Page    24
             Specifies whether line data and a page definition should be
             converted to AFPDS before the data is spooled.
             The possible values are:
             *NO
                 No AFPDS conversion is done.
             *YES
                 Specifies that AFPDS conversion is to be done on the line data
                 and page definition before the data is spooled.
         IPDS pass through (IPDSPASTHR)
             Specifies whether IPDS (intelligent printer data stream)
             pass-through is done for the spooled file.
             The possible values are:
             *DEVD
                 The value specified for IPDSPASTHR in the PSF configuration
                 object specified for a printer device description is used.  If
                 no PSF configuration object is specified for the device, a
                 value of *NO is used.
             *NO
                 No IPDS pass-through is done.
             *YES
                 Specifies that IPDS pass-through is to be done if the spooled
                 file is eligible for IPDS pass-through.
                 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 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
                                                                                                                            Page    25
             is ignored.
         User resource library list (USRRSCLIBL)
             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.
             The possible values are:
             *DEVD
                 The value specified for USRRSCLIBL in the PSF configuration
                 object specified for a printer device description is used.  If
                 no PSF configuration object is specified for the device, a
                 value of *JOBLIBL is used.
             *NONE
                 No user libraries are specified.
             *JOBLIBL
                 Specifies that the library list of the job that created the
                 spool file is used in searching for AFP resources.  This
                 library list is saved with the spool file when it is created.
             *CURLIB
                 Specifies that the current library of the job that created the
                 spool file is used for searching for AFP resources.  If no
                 library is specified as the current library for the job, then
                 library QGPL is used.
             user-resource-library-name
                 Specify the name of a library that will be used to search for
                 AFP resources.  Up to four library names may be specified.
             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.
         Corner staple (CORNERSTPL)
             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.
             The possible values are:
             *NONE
             _____                                                                                                          Page    26
                 A corner staple is not specified.
             *DEVD
                 The reference corner is the default reference corner used by
                 the device.
             *BOTRIGHT
                 The reference corner is the bottom right corner of the media.
             *TOPRIGHT
                 The reference corner is the top right corner of the media.
             *TOPLEFT
                 The reference corner is the top left corner of the media.
             *BOTLEFT
                 The reference corner is the bottom left corner of the media.
         Edge stitch (EDGESTITCH)
             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.
             The possible values are:
             *NONE
                 An edge stitch is not specified.
             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. Possible
             values are:
             *DEVD
                 The reference edge is the default reference edge used by the
                 device.
             *BOTTOM
                 The reference edge is the bottom edge of the media.
             *RIGHT
                 The reference edge is the right edge of the media.
             *TOP
                 The reference edge is the top edge of the media.
             *LEFT
                 The reference edge is the left edge of the media.
             Reference Edge Offset specifies the offset of the edge stitch from
             the reference edge toward the center of the media.
             *DEVD
                                                                                                                            Page    27
                 The reference edge offset is the default reference edge offset
                 used by the device.
             reference-edge-offset
                 Specifies the offset of the edge stitch from the reference
                 edge.  If UOM(*CM) is specified, valid values range from 0
                 through 57.79, and if UOM(*INCH) is specified, valid values
                 range from 0 through 22.57.  This value is converted to
                 millimeters for the printer.  Fractional millimeters are not
                 supported and are discarded when conversion to millimeters is
                 performed.
             Number of Staples specifies the number of staples that are to be
             applied along the finishing operation axis.
             *DEVD
                 The number of staples depends on the value of the Staple
                 Offsets element of this parameter.  If *DEVD is also specified
                 or defaulted for the Staple Offsets element value, then the
                 number of staples is the default number of staples used by the
                 device.  If one or more offsets are specified for Staple
                 Offsets, the number of staples is the same as the number of
                 staple offsets specified.
             number-of-staples
                 Specify the number of staples to be used for the edge stitch.
                 Valid values range from 1 to 122 staples.  If the number of
                 staples is specified, then *DEVD must be specified for staple
                 offsets. The device default for the spacing of each staple will
                 be used.
             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.
             *DEVD
                 The staple offsets are the default staple positions used by the
                 device. If a value was specified for the Number of Staples
                 element, the staple position of each staple will be calculated
                 automatically by the printer.
             staple-offset
                 Specify the staple offset for each staple in the edge stitch.
                 Up to 122 staple offsets may be specified. If one or more
                 staple offset values are specified, then *DEVD must be
                 specified for the number of staples.  If UOM(*CM) is specified,
                 valid values range from 0 through 57.79, and if UOM(*INCH) is
                 specified, valid values range from 0 through 22.57.  This value
                 is converted to millimeters for the printer.  Fractional
                 millimeters are not supported and are discarded when when
                 conversion to millimeters is performed.
         Saddle stitch (SADLSTITCH)
             Specifies where one or more staples are driven into the media along
                                                                                                                            Page    28
             the finishing operation axis, which is positioned at the center of
             the media parallel to the reference edge.  Page  rotation does not
             affect the placement of a saddle stitch.
             The possible values are:
             *NONE
                 A saddle stitch is not specified.
             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.  Possible values are:
             *DEVD
                 The reference edge is the default reference edge used by the
                 device.
             *TOP
                 The reference edge is the top edge of the media.
             *LEFT
                 The reference edge is the left edge of the media.
             Number of Staples specifies the number of staples that are to be
             applied along the finishing operation axis.
             *DEVD
                 The number of staples depends on the value of the Staple
                 Offsets element of this parameter.  If *DEVD is also specified
                 or defaulted for the Staple Offsets element value, then the
                 number of staples is the default number of staples used by the
                 device.  If one or more offsets are specified for Staple
                 Offsets, the number of staples is the same as the number of
                 staple offsets specified.
             number-of-staples
                 Specify the number of staples to be used for the saddle stitch.
                 Valid values range from 1 to 122 staples.  If you specify the
                 number of staples, then *DEVD must be specified for staple
                 offsets.  The device default for the spacing of each staple
                 will be used.
             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.
             *DEVD
                 The staple offsets are the default staple positions used by the
                 device. If a value was specified for the Number of Staples
                 element, the staple position of each staple will be calculated
                 automatically by the printer.
             staple-offset
                                                                                                                            Page    29
                 Specify the staple offset for each staple in the saddle stitch.
                 Up to 122 staple offsets may be specified. If one or more
                 staple offset values are specified, then *DEVD must be
                 specified for the the number of staples.  If UOM(*CM) is
                 specified, valid values range from 0 through 57.79, and if
                 UOM(*INCH) is specified, valid values range from 0 through
                 22.57.  This value is converted to millimeters for the printer.
                 Fractional millimeters are not supported and are discarded when
                 when conversion to millimeters is performed.
         Font resolution for formatting (RNTRSL)
             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.
             The possible values are:
             *DEVD
                 The value specified in the FNTRSL parameter of the PSF
                 configuration object for the device is used. If no PSF
                 configuration object is specified for the device, a value of
                 *SEARCH is used.
             *SEARCH
                 Specifies to search the library list for the first occurrence
                 of a host font with a name match.  The resolution of that font
                 is used to print the spool file.  Message PQT3546 is sent to
                 specify the resolution of the font that was selected.
             240
                 The font resolution is 240 pels per inch.
             300
                 The font resolution is 300 pels per inch.
         Defer write (DFRWRT)
             Specifies whether output is held in the system buffer before being
             sent to the printer.
             The possible values are:
             *YES
                 The system controls the amount of output that is held in the
                 buffer before it is sent to the printer.
             *NO
                 If *NO is specified on this parameter and if *NO is specified
                 on the Spool the data prompt (SPOOL parameter), output is not
                                                                                                                            Page    30
                 held in the buffer.  Instead, output is sent immediately to the
                 printer once the program has performed a write operation.
                 If *NO is specified on this parameter and if *YES is specified
                 on the Spool the data prompt (SPOOL parameter) and if *IMMED is
                 specified on the Spooled output schedule prompt (SCHEDULE
                 parameter), output is held in the buffer until a page of output
                 is available or until the system buffer is full.
         Spool the data (SPOOL)
             Specifies whether the output data for the printer device file is
             spooled.
             *YES
                 The data is spooled for processing by a diskette writer or
                 printer writer.
             *NO
                 The data is not spooled.  It is sent directly to the device to
                 print as the output becomes available.
         Output queue (OUTQ)
             Specifies the output queue used for spooled files that specify
             OUTQ(*JOB).  This parameter applies only to printer files that have
             *JOB specified for the OUTQ parameter.
             *DEV
                 The output queue associated with the printer specified on the
                 DEV parameter is used.  The output queue has the same name as
                 the printer.
             *JOB
                 The output queue associated with this job is used for the
                 spooled output.
             output-queue-name
                 Specify the name and library of the output queue to which the
                 output data is spooled.
             The possible library values are:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the output
                 queue.  If no library is specified as the current library for
                 the job, QGPL is used.
             library-name
                 Specify the library where the output queue is located.
         Form type (FORMTYPE)
             Specifies the type of forms used in the printer for printed output
                                                                                                                            Page    31
             that is produced using this device file.  If a form type other than
             *STD is specified, the system sends a message that identifies the
             form type to the system operator when the output is produced, and
             requests that the specified type of forms be put in the printer.
             This parameter overrides the form type value specified in the
             printer file or in other called OVRPRTF commands.
             *STD
                 The standard printer form for your computer system is used.
             form-type
                 Specify a form type identifier, having 10 characters or less,
                 for the printer forms used.
         Copies (COPIES)
             Specifies, for spooled output only, the number of copies of the
             output being printed.
         Page range to print (PAGERANGE)
             Specifies, for spooled output files only, the starting and ending
             pages to print.
             The possible starting page values are:
             *ENDPAGE
                 Use the end page value as the starting page.
             starting-page-number
                 Specify the starting page to print.
             The possible ending page values are:
             *END
                 Printing continues until the end of file.
             ending-page-number
                 Specify the ending page to print.
         Max spooled output records (MAXRCDS)
             Specifies, for spooled output only, the maximum number of records
             that can be in the spooled file for jobs using the printer file.
             This parameter overrides the value specified in the printer file or
             in other called OVRPRTF commands.
             The possible values are:
             *NOMAX
                 There is no maximum on the number of records that can be in the
                 spooled file.
             maximum-records
                 Specify a value ranging from 1 through 999999 (999,999) to
                 indicate the maximum number of records that can be in the
                 spooled output file.
         File separators (FILESEP)
                                                                                                                            Page    32
             Specifies, for spooled output only, the number of separator pages
             placed at the beginning of each printed file, including the pages
             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 the job number.  This parameter overrides the
             separator value specified in the printer file or in other called
             OVRPRTF commands.
             The possible values are:
             number-of-file-separators
                 Specify the number of separator pages used at the start of each
                 printed output file produced by this device file.  Valid values
                 range from 0 through 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.
         Spooled output schedule (SCHEDULE)
             Specifies, for spooled output files only, when the spooled output
             file is made available to a spooling writer.  This parameter
             overrides the scheduling value specified in the printer file or in
             other called OVRPRTF commands.
             The possible values are:
             *JOBEND
                 The spooled output file is available to the spooling writer
                 only after the entire job is completed.
             *FILEEND
                 The spooled output file is available to the spooling writer as
                 soon as the file is closed in the program.
             *IMMED
                 The spooled output file is made available to the writer as soon
                 as the file is opened in the program.
         Hold spooled file (HOLD)
             Specifies, 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.
                 Note:  This parameter overrides the hold value specified in the
                 printer file or in other called OVRPRTF commands.
             *NO
                 The spooled output file is not held on the output queue.  The
                 spooled output is available to a spooling writer based on the
                 Spooled output schedule prompt (SCHEDULE parameter) value.
             *YES
                 The spooled output file is held until it is released by the
                 Release Spooled File (RLSSPLF) command.
         Save spooled file (SAVE)
                                                                                                                            Page    33
             Specifies, for spooled output only, whether the spooled file is
             saved after the output is produced.  This parameter overrides the
             save value specified in the printer file or in other called OVRPRTF
             commands.
             The possible values are:
             *NO
                 The spooled file data is not kept (saved) on the output queue
                 after it is produced.
             *YES
                 The spooled file data is kept on the output queue until the
                 file is deleted.  After the file is produced, the number of
                 copies is set to 1, and the status of the file is changed from
                 WTR to SAV.
         Output priority (on OUTQ) (OUTPTY)
             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.
             *JOB
                 The output priority associated with the job that created the
                 spooled file is used.
             output-priority
                 Specify a number ranging from 1 (high) through 9 (low) to
                 indicate the output priority.
         User data (USRDTA)
             Specifies, for spooled output, user-specified data that identifies
             the file.
             *SOURCE
                 If the file was created by a System/36 procedure, the name of
                 the procedure is assigned.  If the file was created by an
                 application program, the name of the program is assigned.
             user-data
                 Specify up to 10 characters of user-specified text.
         Spool file owner (SPLFOWN)
             Specifies, for spooled output only, who the owner of the spooled
             file is.
             The possible values are:
             *CURUSRPRF
                 The spooled file is owned by the current effective user of the
                 current job or thread.  See the Printer Device Programming
                 book, SC41-5713 for more detailed information on how the
                 SPLFOWN parameter is affected when using any of the following
                 APIs:
                                                                                                                            Page    34
                  o  QWTSETP - Set Profile
                  o  qsysetuid() - Set User ID
                  o  qsyseteuid() - Set Effective User ID
                  o  qsysetreuid() - Set Real and Effective User ID
             *JOB
                 The spooled file is owned by the original user profile of the
                 job.  If the job has switched to a new user profile, the
                 original user profile is still the owner of the spooled file.
             *CURGRPPRF
                 The spooled file is owned by the current effective group
                 profile of the current job or thread.  If there is no current
                 effective group profile, ownership of the spooled file is
                 determined in the same manner as *CURUSRPRF.  See the Printer
                 Device Programming book, SC41-5713 for more detailed
                 information on how the SPLFOWN parameter is affected when using
                 any of the following APIs:
                  o  QWTSETP - Set Profile
                  o  qsysetgid() - Set Group ID
                  o  qsysetegid() - Set Effective Group ID
                  o  qsysetregid() - Set Real and Effective Group ID
             *JOBGRPPRF
                 The spooled file is owned by the group profile of the original
                 user profile of the job.  If the job has switched to a new user
                 profile, the group profile of the original user profile is
                 still the owner of the spooled file.  If no group profile
                 exists, ownership of the spooled file is determined the same
                 way as *JOB.
         User Defined Option (USRDFNOPT)
             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.
             This parameter overrides the user-defined options specified in the
             printer file or in other called OVRPRTF commands.
             The possible values are:
             *NONE
                 No user-defined options specified.
             user-defined-option
                 Specify a user-defined option to be used by user applications
                 or user-specified programs that process spooled files.  All
                 characters are acceptable.
         User Defined Data (USRDFNDTA)
             Specifies, for spooled output only, the user-defined data to be
             used by user applications or user-specified programs that process
             spooled files.
             This parameter overrides the user-defined data specified in the
                                                                                                                            Page    35
             printer file or in other called OVRPRTF commands.
             The possible values are:
             *NONE
                 No user-defined data specified.
             user-defined-data
                 Specify a user-defined data to be used by user applications or
                 user-specified programs that process spooled files.  All
                 characters are acceptable.
         User Defined Object (USRDFNOBJ)
             Specifies, for spooled output only, the user-defined object to be
             used by user applications or user-specified programs that process
             spooled files.
             This parameter overrides the user-defined object name specified in
             the printer file or in other called OVRPRTF commands.
             The possible values are:
             *NONE
                 No user-defined object specified.
             The possible User-Defined Object Name values are:
             object-name
                 Specify the user-defined object to be used by user applications
                 or user-specified programs that process spooled files.
             The user-defined object can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the thread is searched.  If no library
                 is specified as the current library for the thread, the QGPL
                 library is searched.
             name
                 Specify the name of the library to be searched.
             The possible User-Defined Object Type values are:
             object-type
                 The user object type can be one of the following:
                 *DTAARA     Data Area
                 *DTAQ       Data Queue
                 *FILE       File
                 *PSFCFG     PSF Configuration Object
                                                                                                                            Page    36
                 *USRIDX     User Index
                 *USRQ       User Queue
                 *USRSPC     User Space
         Spool file name (SPLFNAME)
             Specifies, for spooled output only, the spooled output file name.
             *FILE
                 The name of the printer file is used for the spooled output
                 file name.
             spool-file-name
                 Specify the name of the spooled output file.  A maximum of 10
                 characters can be used.
         User specified DBCS data (IGCDTA)
             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, the possible values are:
             *NO
                 The file does not process double-byte character set (DBCS)
                 data.
             *YES
                 The file processes double-byte character set (DBCS) data.
             For externally-described files, the possible values are:
             *NO
                 The only double-byte character set (DBCS) attributes of the
                 file are those defined in the DDS.
             *YES
                 DBCS attributes, in addition to those defined in the DDS,
                 include putting the DDS keyword for alternative data type
                 (IGCALTTYP) into effect, and identifying DBCS attributes of
                 fields or messages not identified in the DDS.
         DBCS extension characters (IGCEXNCHR)
             Specifies whether the system processes double-byte character set
             (DBCS) extension characters.
             *YES
                 The system processes extension characters.
             *NO
                 The system does not process extension characters; it prints
                 them as undefined characters.
         DBCS character rotation (IGCCHRRTT)
                                                                                                                            Page    37
             Specifies whether the printer should rotate double-byte character
             set (DBCS) data 90 degrees counterclockwise when printing.  The
             system prints rotated DBCS characters vertically so that they
             appear in proper reading sequence.  Alphanumeric characters are not
             rotated.
             *NO
                 The system does not rotate DBCS data when printing.
             *YES
                 The system rotates DBCS data 90 degrees counterclockwise when
                 printing.
         DBCS characters per inch (IGCCPI)
             Specifies the printer character density of double-byte character
             set (DBCS) data, in characters per inch (cpi).
             *CPI
                 DBCS density is based on the values specified for the
                 Characters per inch prompt (CPI parameter).  The system prints
                 one double-byte character for every two alphanumeric
                 characters.  (*CPI is the default value for this parameter on
                 the CRTPRTF command.)
                  o  For CPI(10), DBCS characters print at 5 characters per
                     inch.
                  o  For CPI(12), DBCS characters print at 6 characters per
                     inch.
                  o  For CPI(13.3), DBCS characters print at 6.7 characters per
                     inch (same as IGCCPI(*CONDENSED)).
                  o  For CPI(15), DBCS characters print at 7.5 characters per
                     inch.
                  o  For CPI(18), DBCS characters print at 9 characters per
                     inch.
                  o  For CPI(20), DBCS characters print at 10 characters per
                     inch.
             *CONDENSED
                 Condensed printing, where the system prints 20 double-byte
                 characters every three inches, is used.
             5
                 DBCS density is 5 characters per inch.
             6
                 DBCS density is 6 characters per inch.
             10
                 DBCS density is 10 characters per inch.
         DBCS SO/SI spacing (IGCSOSI)
                                                                                                                            Page    38
             Specifies how the system prints double-byte characters.
             *YES
                 The system prints double-byte characters as blanks.
             *NO
                 The system does not print double-byte characters.  These
                 characters do not occupy a position on printed output.
             *RIGHT
                 The system prints two blanks when printing shift-in characters,
                 but does not print shift-out characters.
         DBCS coded font (IGCCDEFNT)
             Specifies the coded font that the system uses for double-byte
             character set (DBCS) printing.  This parameter is only used when
             using printers configured with AFP(*YES).
             The possible values are:
             *SYSVAL
                 The DBCS coded font specified in the system value is used.
             The possible coded font name values are:
             coded-font-name
                 Specify the DBCS coded font name to use.
             The name of the coded font can be qualified by one of the following
             library values:
             *LIBL
                 All libraries in the library list for the current thread are
                 searched until the first match is found.
             *CURLIB
                 The current library for the job is used to locate the coded
                 font name.  If no library is specified as the current library
                 for the job, the QGPL library is used.
             library-name
                 Specify the name of the library where the coded font name is
                 located.
             The possible Point size values are:
             *NONE
                 The point size is supplied by the system and is determined by
                 the specified font character set.
             point-size
                 Specify a point size ranging from 0.1 through 999.9.
         Maximum file wait time (WAITFILE)
             Specifies the number of seconds that the program waits for the file
                                                                                                                            Page    39
             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.
             *IMMED
                 The program does not wait.  Immediate allocation of file
                 resources is required.
             *CLS
                 The default wait time specified in the class description is
                 used as the wait time for the file resources to be allocated.
             number-of-seconds
                 Specify the number of seconds that the program waits for the
                 file resources to be allocated.  Valid values range from 1
                 through 32767.
         Record format level check (LVLCHK)
             Specifies whether the level of the device file is checked when the
             file is opened by a program.  For this check, which is done while
             the file is opened, the system compares the record format
             identifiers of each record format used by the program with the
             corresponding identifiers in the device file.  Because the same
             record format name can exist in more than one file, each record
             format is given a unique internal system identifier when the format
             is created.  Level checking cannot be done unless the program
             contains the record format identifiers.  This command cannot
             override level checking from *NO to *YES.
             *NO
                 The level identifiers are not checked when the file is opened.
         Secure from other overrides (SECURE)
             Specifies whether this file is safe from the effects of previously
             called file override commands.
             *NO
                 This file is not protected from other file overrides.  Its
                 values are overridden by the effects of any previously called
                 file override commands.
             *YES
                 This file is protected from the effects of any previously
                 called file override commands.
         Override scope (OVRSCOPE)
             Specifies the extent of influence (scope) of the override.
             *ACTGRPDFN
                 The scope of the override is determined by the activation group
                 of the program that calls this command.  When the activation
                 group is the default activation group, the scope equals the
                 call level of the calling program.  When the activation group
                                                                                                                            Page    40
                 is not the default activation group, the scope equals the
                 activation group of the calling program.
             *CALLLVL
                 The scope of the override is determined by the current call
                 level.  All open operations done at a call level that is the
                 same as or higher than the current call level are influenced by
                 this override.
             *JOB
                 The scope of the override is the job in which the override
                 occurs.
         Share open data path (SHARE)
             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.
             *NO
                 The ODP is not shared with other programs in the routing step.
                 A new ODP for the file is created and used every time a program
                 opens the file.
             *YES
                 The same ODP is shared with each program in the job that also
                 specifies *YES when it opens the file.
         Open scope (OPNSCOPE)
             Specifies the extent of influence (scope) of the open operation.
             The possible values are:
             *ACTGRPDFN
                 The scope of the open operation is determined by the activation
                 group of the program that called the OVRPRTF command processing
                 program.  If the activation group is the default activation
                 group, the scope is the call level of the caller.  If the
                 activation group is a non-default activation group, the scope
                 is the activation group of the caller.
             *JOB
                 The scope of the open operation is the job in which the open
                 operation occurs.
         Examples for OVRPRTF
             Example 1: Printing Output
                 OVRPRTF   FILE(PRINTOUT)  TOFILE(PRINT3)  SPOOL(*YES)
                           COPIES(5)  OUTQ(OUTPUT1)
             This command overrides the file named PRINTOUT and uses the printer
             file named PRINT3 to produce the spooled output on the printer. The
             output from the program is sent to the OUTPUT1 output queue. Five
             copies of the spooled file are printed on the printer specified on
                                                                                                                            Page    41
             the Start Printer Writer (STRPRTWTR) command.
             Example 2: Rotating Double-Byte Characters
                 OVRPRTF   FILE(IGCLIB/IGCPRT)  IGCDTA(*YES)  IGCCHRRTT(*YES)
             This command overrides the IGCPRT printer file, which is stored in
             the IGCLIB library. The override puts the IGCALTTYP DDS keyword
             into effect to change character output fields to DBCS fields, and
             rotates the double-byte characters when printing.
         Error messages for OVRPRTF
             *ESCAPE_Messages
             CPF180C     Function &1 not allowed.
             CPF7343     Channel number specified more than once on CHLVAL.
                                           * * * * *   E N D   O F   L I S T I N G   * * * * *
    All my answers were extracted from the "Big Dummy's Guide to the As400"
    and I take no responsibility for any of them.

    www.code400.com

    Comment


    • #3
      Re: 'PRINT' keyword to program desribed file

      I think you may find this controlled by the Job Description.

      Comment


      • #4
        Re: 'PRINT' keyword to program desribed file

        If I use PRINT(*PGM) and return control to the program, is there then an easy way to write whatever is on the screen to o-specs? I would like to avoid having to create complicated o-specs if I can.

        Also, I don't think I want to do an ovrprtf because the program is not currenty called by a CL and it could be more trouble then it is worth to make it.

        Comment


        • #5
          Re: 'PRINT' keyword to program desribed file

          Sorry no "easy" way to get info from screen to printed output.

          You may be able to use STRCPYSCN to a file but I have never attempted this.

          You can also do the override from RPG not CL

          make your F spec qsysprt be user open usropn
          then use QCMDEXC to try the override

          Code:
               fWKR42PR   o    e             printer usropn   oflind(*in69)                                                                              
                 *                                                                             
                 * OVRPRTF FILE(BLAHBLAH) TOFILE(BLAHBLAH) PAGRTT(90)                          
                 *                                                                             
                c                   eval      CmdString = 'OVRPRTF FILE(WKR42PR) TOFILE('+     
                c                                         'WKR42PR)  PAGRTT(90)'               
                c                   eval      CmdLength = %len(%trim(CmdString))               
                c                   call(e)   'QCMDEXC'                                        
                c                   parm                    CmdString                          
                c                   parm                    CmdLength                          
                 *                                                                             
                c                   if        not%open(WKR42PR)                                
                c                   open      WKR42PR                                          
                c                   endif                                                      
                 *
          otherwise you need them o'specs or create a printer file

          jimmy

          Comment


          • #6
            Re: 'PRINT' keyword to program desribed file

            I tried it with the CL but it is not working. Any ideas? This is what I have:

            DSPF
            Code:
            A                                      PRINT(QSYSPRT2)
            CL

            Code:
            OVRPRTF    FILE(QSYSPRT2) TOFILE(QSYSPRT2) PAGESIZE(66 80)
             CALL       PGM(prmg1)

            Comment


            • #7
              Re: 'PRINT' keyword to program desribed file

              Okay lets copy QSYSPRT2 to lets say QSYSPRT7

              then chgprtf
              Change Printer File (CHGPRTF)

              Type choices, press Enter.

              change the print file itself........ then use QSYSPRT7

              Code:
                                                                                            
               File . . . . . . . . . . . . . . > QSYSPRT2      Name, generic*, *ALL          
                 Library  . . . . . . . . . . .     *LIBL       Name, *LIBL, *ALL, *ALLUSR... 
               Device:                                                                        
                 Printer  . . . . . . . . . . .   *JOB          Name, *SAME, *JOB, *SYSVAL    
               Printer device type  . . . . . .   *SCS          *SAME, *SCS, *IPDS, *LINE...  
               Page size:                                                                     
                 Length--lines per page . . . .   66            .001-255.000, *SAME           
                 Width--positions per line  . .   132           .001-378.000, *SAME           
                 Measurement method . . . . . .   *ROWCOL       *SAME, *ROWCOL, *UOM          
               Lines per inch . . . . . . . . .   6             *SAME, 6, 3, 4, 7.5, 7,5...   
               Characters per inch  . . . . . .   10            *SAME, 10, 5, 12, 13.3, 13... 
               Overflow line number . . . . . .   60            1-255, *SAME                  
               Record format level check  . . .   *NO           *SAME, *YES, *NO              
               Text 'description' . . . . . . .   'System non-described printer file'
              All my answers were extracted from the "Big Dummy's Guide to the As400"
              and I take no responsibility for any of them.

              www.code400.com

              Comment


              • #8
                Re: 'PRINT' keyword to program desribed file

                I did get the CL working correctly but I don't think that how I want to do it. I would have to change all the programs that call that program to call the CL.

                I tryed doing the overide in the RPG but it didn't work and I think I am not understanding something.

                In the IBM mannuals it says that you can specify a printer file on the PRINT keyword and then the display image will be written to that printer file (if it can find it). It also says it can be an externally described file or a program described file. But when I say PRINT(Qsysprt2) in the dspf file, and then have Qsysprt2 in my f-specs as program described, it does not write to that file. When I call the program I get two print files, one from the screen shot, and one that is never written to. Even with the CL doing an overide prtf on the files it doesn't work. So I don't get it. How do I specify to print to the qsysprt2 file in the program. It seems like it is still just printing to a default.

                Also if I was to make an external printfile, what would it look like? Would it just have a record format name and thats all?

                I appreciate all your help. If nothing else I guess I can just do it the hard way but I was interested in seeing if it could be done otherwise (it seems to me it should).

                Comment


                • #9
                  Re: 'PRINT' keyword to program desribed file

                  If the cl works then it will work in the RPG.

                  What happens when an RPG program is called is it goes thru the cycle....
                  and one of the first things it does "automagically" is open all the files.

                  so you need to make sure that your printfile is user open (usropn)
                  so it stays closed until you run your override command.

                  then do the ovrprtf

                  then open the printfile.

                  I always use printfiles so I guess Im not your best resource

                  Take care
                  Jamie
                  All my answers were extracted from the "Big Dummy's Guide to the As400"
                  and I take no responsibility for any of them.

                  www.code400.com

                  Comment

                  Working...
                  X