CHGSPLFA (Change Spooled File Attributes)

CHGSPLFA Command syntax diagram

 

Purpose

The Change Spooled File Attributes (CHGSPLFA) command changes the attributes of a spooled file while it is on an output queue. The 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 for more information about changing spooled file attributes.

 

Required Parameters

FILE

Specifies the name of the spooled file whose attributes are being changed.

*SELECT: All spooled files that meet the selection values specified in the SELECT keyword are changed. This value is mutually exclusive with the JOB, SPLNBR, JOBSYSNAME, and CRTDATE parameters.

spooled-file-name: Specify the name of the spooled file. If *SELECT is specified, the JOB, SPLNBR, JOBSYSNAME, and CRTDATE> keywords are ignored.

 

Optional Parameters

JOB

Specifies the name of the job that created the spooled file.

A job identifier is a qualified name with up to three elements. For example:

job-name
user-name/job-name
job-number/user-name/job-name

More information on this parameter is in Commonly used parameters.

*: The job that issued this CHGSPLFA command is the job that created the spooled file. If no job qualifier is given, the jobs currently in the system are searched for the simple job name.

job-name: Specify the name of the job that created the spooled file.

user-name: Specify the name of the user of the job that created the spooled file.

job-number: Specify the number of the job that created the spooled file.

SPLNBR

Specifies the number of the spooled file in the job whose attributes are being changed. More information on this parameter is in Commonly used parameters.

*ONLY: One spooled file from the job has the specified file name. The number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file has the specified file name, a message is sent.

*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 creation date and time parameter is to take precedence over the spooled file number when selecting a spooled file. >

*LAST: The spooled file with the highest number and the specified file name is used.

spooled-file-number: Specify the number of the spooled file having the specified file name whose attributes are being changed.

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 creation 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 creation 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 creation date and time parameter is to take precedence over the job system name when selecting a spooled file.

system name: Specify the name of the system where the job that created the spooled file ran.

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.

*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 creation date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.

Element 1: Date spooled file was created

date: Specify the date the spooled file was created.

Element 2: Time spooled file was created

*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 creation date.

*LAST: The spooled file with the latest creation time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date is used.

time: Specify the time the spooled file was created.

SELECT

Specifies which group of files have their attributes changed. Files can be selected based on user, device, form type, and user data. Only files that meet each of the specified requirements are selected.

Element 1: User Values

*CURRENT: Only files created by the user running this command are selected.

*ALL: Files created by all users or on any output queue are selected.

user-name: Specify only files created by the named user.

Element 2: Device Values

*ALL: Files queued for any device are selected.

*OUTQ: All files not queued for a device are selected. These files are on output queues not associated with printers.

device-name: Specify only files queued for the specified device name.

Element 3: Form Type Values

*ALL: Files for all form types are selected.

*STD: Only files that specify the standard form type are selected.

form-type: Specify only files with the specified form type.

Element 4: User Data Values

*ALL: Files with a user data tag specified are selected.

user-data: Specify only files with the specified user data tag.

DEV

Specifies the name of the printer on which the file is printed.

*SAME: The current value does not change.

*OUTQ: The file is not assigned to a specific printer. It is placed on the output queue specified on the OUTQ parameter.

device-name: Specify the name of the printer that prints the file.

PRTSEQ

Specifies whether the file is next on the output queue to be printed. To move the file to the top of the queue, the following steps are taken:

1. If the file is held, it is released
2. The SCHEDULE attribute changes to *IMMED
3. The output priority (OUTPTY) changes to a priority that places it at the top of the queue

Because of these actions, PRTSEQ is mutually exclusive with the SCHEDULE and OUTPTY parameters.

*SAME: The value does not change.

*NEXT: The attributes of the file are changed to move it 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.

OUTQ

Specifies the qualified name of the output queue.

Note:

If the spooled file is currently on an output queue for which DSPDTA(*OWNER) was specified on the Create Output Queue (CRTOUTQ) or Change Output Queue (CHGOUTQ) command, the user must own the file or have *SPLCTL authority to move it.

*SAME: The value does not change.

*DEV: The output queue specified on the PRTDEV parameter is used.

The name of the output queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

output-queue-name: Specify the name of the output queue to which the file is moved.

FORMTYPE

Specifies the type of form on which the output is printed. The identifiers used to indicate the type of forms are user-defined and can be a maximum of 10 characters in length.

Note:

*SAME must be specified if the output file is a diskette file.

*SAME: The value does not change.

*STD: The standard form type is used. The output is printed on the form type specified in the printer file for the printers selected. The printer file contains information that controls how the document is printed on a particular printer.

form-type: Specify the forms identifier for the forms used to produce the output of this spooled file. Up to 10 alphanumeric characters can be specified. Strings with embedded blanks must be enclosed in apostrophes.

COPIES

Specifies, for spooled files, the number of copies being printed.

Note:

Specifying a value while a file is being printed causes the specified number of copies to print in addition to the number of copies that have already been printed.

*SAME: The value does not change.

number-of-copies: Specify the number of copies to print. Valid values range from 1 through 255.

FILESEP

Specifies the number of separator pages to produce at the beginning of each printed output file to separate the file from the other files being spooled to an output device. The identifying information included on each file separator is the file name and number, the job name and number, and the user's name. *SAME must be specified if the spooled file is a diskette file.

*SAME: The value does not change.

number-of-file-separators: Specify the number of pages, ranging from 0 through 9, used as file separators.

PAGERANGE

Specifies the page range to print for each copy of the file to be printed.

Element 1: Starting Page to Print

*SAME: The value does not change.

*ENDPAGE: The page on which to start printing is the same as the page on which to end printing.

starting-page: Specify the page on which to start printing.

Element 2: Ending Page to Print

*SAME: The value does not change.

*END: The last page in the file is printed.

ending-page: Specify the page on which to end printing.

RESTART

Specifies the page on which to restart printing. Specifying a value while a file is being printed causes the printer writer to stop printing the file and restart on the page specified by the user. If the file is not being printed, the change occurs when the first copy is printed. After the printer writer is repositioned to the page specified on this parameter, the value is reset to RESTART(*STRPAGE).

*SAME: The value does not change.

*STRPAGE: The starting page specified on the PAGERANGE parameter is the page on which printing is restarted. This value is the default value that is used when a spooled file is created. Also, RESTART is reset to *STRPAGE after the printer writer repositions to the page specified on this parameter.

*ENDPAGE: The ending page is the page on which to restart printing. Therefore, only the ending page is printed.

*NEXT: This value is valid only when a spooled file has been interrupted while it is being printed by the HLDSPLF command where OPTION(*PAGEEND) is specified or the ENDWTR command where OPTION(*PAGEEND) is specified.

restart-page: Specify the page on which to restart printing.

SCHEDULE

Specifies when the output file is available to the writer.

*SAME: The value does not change.

*JOBEND: The spooled file is available to the writer only after the entire job is completed.

*FILEEND: The spooled file is available to the writer as soon as the file is closed in the program.

*IMMED: The spooled file is made available to the writer as soon as the file is opened in the program.

SAVE

Specifies whether the spooled file is saved after it has been written to an output device.

*SAME: The value does not change.

*NO: The spooled file data is not retained on the output queue after it has been produced.

*YES: The spooled file data is retained on the output queue until the file is deleted. After the file is produced, the number of copies (COPIES parameter) is set to 1, and the status of the file is changed from WTR to SAV. Refer to the RLSSPLF command description for information on how to produce the spooled file.

OUTPTY

Specifies the output priority assigned to the spooled file.

*SAME: The value does not change.

*JOB: The output priority associated with the job that created the spooled file is used.

output-priority: Specify the assigned output priority. Valid values range from 1 (high priority) through 9 (low priority).

USRDTA

Specifies, for spooled output only, the user-specified data that identifies the file.

*SAME: The value does not change.

user-data: Specify up to 10 characters of data assigned to the spooled file.

ALIGN

Specifies whether to verify forms alignment on this file. This parameter is used only by print writers which were started with the ALIGN(*FILE) option, and can be changed only on spooled files which are to be printed. *SAME must be specified for diskette files.

*SAME: The value does not change.

*NO: The forms alignment is not verified.

*YES: The forms alignment is verified.

PRTQLTY

Specifies the quality of the print produced. Refer to the CRTPRTF (Create Printer File) command description for a list of printers supporting the PRTQLTY parameter.

Note:

The user can also specify PRTQLTY(*NLQ) for the 5219 and 4214 Printers to get the best print quality.

*SAME: The value does not change.

*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: The output is printed at a higher speed and with lower quality than it would be if you specified *DRAFT.

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.

*AUTOCUT: The sheet-feed attachment must be on the printer. Single-cut sheets are automatically fed into the printer. The forms alignment message is not sent for cut sheets.

*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.

DRAWER

Specifies the source drawer used when single-cut sheets are fed into the printer (specified by FORMFEED(*AUTOCUT)).

*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 paper is fed.

source-drawer: Specify the drawer from which the paper is fed. Valid values range from 1 through 255.

MULTIUP

Specifies, for spooled output only, whether multiple pages of output are printed on a single physical page. This parameter is used only when the printer device type is *SCS, *IPDS, or *AFPDS and the spooled file was created on the iSeries 400.

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.

*SAME: The value does not change.

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.

4: Four pages of output are printed on 1 physical sheet of paper.

PAGDFN

Specifies the qualified name of the page definition to be used to format line data.

*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.

The name of the page definition can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

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 or *LINE must be specified when using a page 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.

*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.

The name of the form definition can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

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.

AFPCHARS

Specifies one or more AFP characters (coded fonts) to be used with line data and a page definition.

*SAME: The value does not change.

*NONE: No AFP character (coded fonts) specified.

coded-font-name: Specify up to four 4-byte names of coded fonts to be specified with line data and a page definition. The 4-byte names would be concatenated to X0 to identify up to four coded fonts which are to be used when TBLREFCHR is being used within the data.

DUPLEX

Specifies whether output is printed on one side or two sides of the paper.

*SAME: The 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 paper.

*TUMBLE: The output is printed on both sides of the paper with the top of one side at the opposite end of the top of the other side. This is usually used for output that will be bound at the top.

*FORMDF: The duplex value specified in the form definition file is used. This value is valid only with printer device types of *AFPDS, *AFPDSLINE, or *LINE.

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. This parameter is used only when the printer device type is *SCS or *IPDS.

*SAME: The value does not change.

*NONE: No overlay is used.

The name of the overlay can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

Element 1: Overlay Name

overlay: Specify the name of the overlay.

Element 2: Offset Down

*SAME: The value does not change.

offset-down: Specify the offset down 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 3: Offset Across

*SAME: The value 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.

BACKOVL

Specifies the qualified name of the object that contains both the overlay that is printed on the BACK side of the page and the offset, down and across, from the point of origin used when the overlay is printed. This parameter is used only when the printer device type is *SCS or *IPDS.

*SAME: The value does not change.

*FRONTOVL: The values specified on the FRONTOVL parameter are used.

*NONE: No overlay is used.

The name of the overlay can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

Element 1: Overlay Name

overlay: Specify the name of the overlay.

Element 2: Offset Down

*SAME: The value does not change.

offset-down: Specify the offset down 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 3: Offset Across

*SAME: The value 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 the user 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 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 that the offset down and offset across values are ignored when *CONSTANT is specified for constant back. An offset of 0.0 is assumed for these values.

*SAME: The value does not change.

*NOCONSTANT: The constant back function is not performed.

*CONSTANT: The constant back function is performed.

FIDELITY

Specifies the print fidelity that is maintained for this file when printing to an AFP enabled printer.

*SAME: The value does not change.

*ABSOLUTE: Print the file exactly as intended. Stop printing the file immediately if an error is encountered in the data stream.

*CONTENT: Try to override any errors in the data stream and attempt to continue printing the file.

VOL

Specifies, for diskette output files only, one or more volume identifiers of the diskettes on which this spooled file is written. The diskettes (volumes) must be placed in the device in the same order as the identifiers are specified in this parameter; a message is sent to the system operator if the order is different. More information on this parameter is in Commonly used parameters.

*SAME: The value does not change.

*NONE: No diskette volume identifiers are specified. This output 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 identifiers of one or more volumes in the order in which they are inserted and used for this output file. No more identifiers can be specified than were initially specified for the diskette device file.

Each volume identifier contains up to six characters. A blank is used as the separator character when listing multiple identifiers. The number of volumes possible in the list is 50, but if more than 10 volume names are specified when the file is first opened, then only that number of files can be entered on the change command. Up to 10 volumes can be specified.

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 value does not change.

data-file-identifier: Specify the identifier (up to 8 characters) assigned to the data file being written on diskette from this spooled file.

EXCHTYPE

Specifies the exchange type used to write the spooled file. This parameter must be coded EXCHTYPE(*SAME) if the spooled file is not a diskette file.

*SAME: The 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

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*SAME: The value does not change.

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character set code is used.

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.

*SAME: The value does not change.

*NONE: No user-defined options are specified.

user-defined-option: Specify the user-defined option to be used by user applications or user-specified programs that process spooled files. All characters are acceptable.

USRDFNOBJ

Specifies, for spooled output only, the qualified name and type of the user-defined object to be used by user applications or user-specified programs that process spooled files.

*SAME: The value does not change.

*NONE: No user-defined object specified.

Element 1: Name of User-Defined Object

The name of the user-defined object can be qualified by one of the following library values:

The name of the user-defined object can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

object-name: Specify the user-defined object to be used by user applications or user-specified programs that process spooled files.

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

IPDSPASTHR

Specifies whether IPDS (intelligent printer data stream) pass-through is done for the spooled file.

*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.

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 section entitled "User and Device Resource Library Lists" in the chapter called "Working With PSF Configuration Objects."

Valid values are:

*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.

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

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.

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 &2 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 &2 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 &2 attributes not changed.

CPF3342

Job &5/&4/&3 not found.

CPF3343

Duplicate job names found.

CPF3344

File &1 number &2 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.