Change Output Queue (CHGOUTQ)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Output Queue (CHGOUTQ) command allows the user to change the attributes of the specified output queue. The following attributes of the output queue can be changed while the writer is active to the output queue:

The following attributes can be changed only while a writer is not active to the specified output queue:

If the output queue contains spooled files, the user cannot change the SEQ parameter for the queue. Other CHGOUTQ parameters such as DSPDTA, JOBSEP, and OPRCTL can normally be changed if the output queue contains spooled files. If the user attempts to change the SEQ parameter when the output queue contains spooled files, none of the specified parameters are changed.

Top

Parameters

Keyword Description Choices Notes
OUTQ Output queue Qualified object name Required, Key, Positional 1
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MAXPAGES Maximum spooled file size Single values: *SAME, *NONE
Other values (up to 5 repetitions): Element list
Optional
Element 1: Number of pages Integer
Element 2: Starting time Time
Element 3: Ending time Time
SEQ Order of files on queue *SAME, *JOBNBR, *FIFO Optional
RMTSYS Remote system Character value, *SAME, *INTNETADR, *NONE, *PASTHR, *NWSA Optional
RMTPRTQ Remote printer queue Character value, *SAME, *USER, *SYSTEM Optional
AUTOSTRWTR Writers to autostart 1-10, *SAME, *NONE Optional
MSGQ Queue for writer messages Single values: *SAME
Other values: Qualified object name
Optional
Qualifier 1: Queue for writer messages Name
Qualifier 2: Library Name, *LIBL, *CURLIB
CNNTYPE Connection type Character value, *SAME, *SNA, *IP, *IPX, *USRDFN Optional
DESTTYPE Destination type Character value, *SAME, *OS400, *OS400V2, *PSF2, *S390, *NETWARE3, *NDS, *OTHER Optional
TRANSFORM Host print transform *SAME, *YES, *NO Optional
USRDTATFM User data transform Single values: *SAME, *NONE
Other values: Qualified object name
Optional
Qualifier 1: User data transform Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MFRTYPMDL Manufacturer type and model Character value, *SAME, *WSCST Optional
WSCST Workstation customizing object Single values: *SAME, *NONE
Other values: Qualified object name
Optional
Qualifier 1: Workstation customizing object Name
Qualifier 2: Library Name, *LIBL, *CURLIB
IMGCFG Image configuration Character value, *SAME, *NONE Optional
INTNETADR Internet address Character value, *SAME Optional
CLASS VM/MVS class *SAME, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 Optional
FCB Forms Control Buffer Character value, *NONE, *USRDTA, *PRTF, *SAME Optional
DESTOPT Destination options Character value, *SAME, *NONE, *USRDFNTXT, *NOWAIT Optional
SEPPAGE Print separator page *SAME, *YES, *NO Optional
USRDFNOPT User defined option Single values: *SAME, *NONE
Other values (up to 4 repetitions): Character value
Optional
USRDFNOBJ User defined object Single values: *SAME, *NONE
Other values: Element list
Optional
Element 1: Object Qualified object name
Qualifier 1: Object Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Element 2: Object type *DTAARA, *DTAQ, *FILE, *PSFCFG, *USRIDX, *USRQ, *USRSPC
USRDRVPGM User driver program Single values: *SAME, *NONE
Other values: Qualified object name
Optional
Qualifier 1: User driver program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
SPLFASP Spooled file ASP *SAME, *SYSTEM, *OUTQASP Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional
DSPDTA Display any file *SAME, *NO, *YES, *OWNER Optional, Positional 2
JOBSEP Job separators 0-9, *SAME, *MSG Optional, Positional 3
OPRCTL Operator controlled *SAME, *YES, *NO Optional, Positional 4
DTAQ Data queue Single values: *SAME, *NONE
Other values: Qualified object name
Optional
Qualifier 1: Data queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
AUTCHK Authority to check *SAME, *OWNER, *DTAAUT Optional
Top

Output queue (OUTQ)

Specifies the output queue that is to have its attributes changed.

This is a required parameter.

Qualifier 1: Output queue

name
Specify the name of the output queue to be changed.

Qualifier 2: Library

*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 in which the output queue is located.
Top

Maximum spooled file size (MAXPAGES)

Specifies the maximum spooled file size in pages that will be allowed to print between a starting and ending time. If a spooled file exceeds the page limit it will be deferred (DFR status) until the ending time expires. For files where the exact number of pages is not known, the estimated number of pages is used. (You can use the Work with Spooled File Attributes (WRKSPLFA) command to find out the estimated number of pages.) The time must be specified in hhmmss format, on a 24 hour clock.

Single values

*SAME
The value does not change.
*NONE
There is no limit on the size of spooled files allowed to print from this output queue.

Other values (up to 5 repetitions)

Element 1: Number of pages

integer
Specify the largest spooled file, in pages, that is allowed to print.

Element 2: Starting time

time
Specify the time of day that the maximum spooled file size limit is to start.

Element 3: Ending time

time
Specify the time of day that the maximum spooled file size limit is to end.
Top

Order of files on queue (SEQ)

Specifies the order of the spooled files on the output queue.

*SAME
The sequence of spooled files placed on the queue does not change.
*JOBNBR
The queue entries for spooled files are sorted in priority sequence using the job number (actually, the date and time that the job entered the system is used) of the job that created the spooled file.

If *JOBNBR is specified on the SEQ parameter, spooled files of a job with the same output priority and status are grouped together.

Also if *JOBNBR is specified on the SEQ parameter, the first job always has its spooled files produced first for jobs of equal priority.

*FIFO
The queue is first-in first-out within priority for each file. That means, new spooled files are placed on the queue after all other entries of the same priority. The following changes place a queue entry after all others of equal priority on the queue.
  • A change of output priority with the Change Job (CHGJOB) command
  • A change in status from held (HLD), saved (SAV), closed (CLO), or open (OPN) to available (RDY)
  • A change in status from available (RDY) to not available (HLD, SAV, CLO, OPN)
  • A spooled file added to the queue if the file is opened
  • Using the Change Spooled File Attributes (CHGSPLFA) command to move a spooled file to an output queue which has SEQ(*FIFO) specified
Top

Remote system (RMTSYS)

Specifies the remote system to which files are sent when a remote writer is started (using the STRRMTWTR command) to the output queue. This is referred to as the "address" by SNADS, and the "host" by TCP/IP.

*SAME
The value does not change.
*NONE
The output queue is used only for local printing. The STRRMTWTR command cannot be used when this output queue is specified on the OUTQ parameter.
*NWSA
The RMTPRTQ parameter is used to identify the system when a remote writer is started to the output queue. This value is valid only when *NDS has been specified on the DESTTYPE parameter.
*PASTHR
The system from which a user passed through (using the STRPASTHR command) is used when sending spooled files created by the user job. If a spooled file was not created by a job that had passed through from another system, the spooled file will be held (HLD status).
*INTNETADR
The INTNETADR parameter is used to identify the system when a remote writer is started to the output queue.

If you have a host table or a domain name server on your TCP/IP network, you can use the remote-system-name instead of this parameter.

Note: This value is valid only when *IP has been specified for the CNNTYPE parameter.

name
Specify a name for the remote system. Only the first 8 characters will be used when the connection type (CNNTYPE parameter) is specified as *SNA. If the name of the remote system needs to be lower case, the name must be enclosed in apostrophes. If you do not use apostrophes, the operating system changes the name to upper case.
Top

Remote printer queue (RMTPRTQ)

Specifies the printer queue on the remote system (RMTSYS parameter) to which the remote writer sends spooled files.

*SAME
The value does not change.
*USER
The user profile that created the spooled file determines the user ID on the remote system. The file is spooled on the user's default output queue.

Note: This value is valid only when the connection type (CNNTYPE parameter) is specified as *SNA or *USRDFN.

*SYSTEM
The default system printer on the remote system will be used to determine the printer queue. For a remote iSeries family system, the output queue associated with the printer device specified in the QPRTDEV system value is used as the printer queue.

Note: This value is valid only when the connection type (CNNTYPE parameter) is specified as *SNA or *USRDFN and the destination type (DESTTYPE) is *OS400 or *S390.

name
Specify the name for the printer queue on the remote system. For remote systems that are iSeries family systems, this is the name of an output queue that the spooled file is created on.

If the name of the remote system needs to be lower case, the name must be enclosed in apostrophes. If you do not use apostrophes, the operating system changes the name to upper case.

For destination systems that are not iSeries family systems, this name is system-dependent, and can be either the actual name of the device or the name of a printer queue.

This output queue is usually specified as library name/output queue name. If a library name qualifier is not specified, *LIBL is used as the default.

Top

Writers to autostart (AUTOSTRWTR)

Specifies the number of writers that will be started automatically by the system to this output queue. If the remote system is specified as a value other than *NONE, the value of this parameter determines the number of remote writers started to this output queue. If the remote system is specified as *NONE and this is a system created printer default output queue, the value of this parameter will determine if a single printer writer is started to the output queue when the Start Printer Writer (STRPRTWTR) command is run with DEV(*ALL).

For system created printer default output queues, this parameter can be specified as *NONE or 1. For user created output queues with the remote system (RMTSYS parameter) specified as *NONE, this parameter will be ignored.

*SAME
The value does not change.
*NONE
No writers are auto-started by the system to this output queue.
1-10
Specify the number of writers to be auto-started to this output queue.
Top

Queue for writer messages (MSGQ)

Specifies the qualified name of the message queue to which messages are sent when created by the remote writer started to this output queue.

Single values

*SAME
The value does not change.

Qualifier 1: Queue for writer messages

name
Specify the name of the message queue to which messages created by the remote writer are sent.

Qualifier 2: Library

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

Connection type (CNNTYPE)

Specifies the type of connection with the remote system.

*SAME
The value does not change.
*SNA
The spooled files will be sent using SNADS. This is similar to the Send Network Spooled Files (SNDNETSPLF) command and requires that SNADS be configured.
*IP
The spooled files will be sent using TCP/IP. This is similar to the Send TCP/IP Spooled File (SNDTCPSPLF) command and requires that the TCP/IP product be installed.
*IPX
The spooled files are sent using IPX.

Note: The operating system no longer supports IPX, this value will be ignored.

*USRDFN
The spooled files are sent using a user-defined connection.
Top

Destination type (DESTTYPE)

Specifies the type of the remote system (RMTSYS parameter). This parameter, along with the type of data contained in the spooled file (DEVTYPE parameter on the CRTPRTF command), is used by a remote writer to determine the format used to send the spooled file. The spooled file will be held by the remote writer if the type of data in the spooled file is not supported by the system.

*SAME
The value does not change.
*OS400
The spooled files are to be sent to an iSeries family system, running OS/400 V3R1M0 or later, or i5/OS, when the connection type (CNNTYPE) has been specified as *SNA. This value can be specified for all releases which support TCP/IP (V2R3 and later) when CNNTYPE is *IP or when CNNTYPE is *USRDFN.

Note: This value should be specified when possible, to allow the greatest flexibility when selecting values for other parameters.

*OS400V2
The spooled files are to be sent to an iSeries family system running OS/400 versions prior to V3R1M0. This value is valid only when CNNTYPE is *SNA.
*S390
The spooled files are to be sent to a System/390* system. This value is only valid when CNNTYPE is *SNA or *USRDFN.
*PSF2
The spooled files are to be sent to a personal computer running the PSF*/2 product.

Note: This value is valid only when the CNNTYPE is *IP or *USRDFN.

*NDS
The spooled files are to be sent to NETWARE4. This value is valid only when the CNNTYPE is *IP or *USRDFN.
*OTHER
The spooled files are to be sent to a system not matching any of the other special values. This includes iSeries family systems running OS/400 version 1, as well as System/36 and System/38 systems.

Note: This value is not valid when CNNTYPE(*IPX) is specified.

Top

Transform SCS to ASCII (TRANSFORM)

Specifies whether to make use of the host print transform function to transform a spooled file of device type *SCS into ASCII data when the file is sent to a remote printer queue.

Note: This parameter is not valid when the CNNTYPE is specified as *SNA or *NONE.

*SAME
The value does not change.
*YES
The SCS data streams are transformed.
*NO
The SCS data streams are not transformed.
Top

Data transform program (USRDTATFM)

Specifies the user-defined data program that is used to transform the spooled file data.

Note: This parameter is valid only when RMTSYS is not *NONE.

Single values

*SAME
The value does not change.
*NONE
No user-defined data transform program name is specified.

Qualifier 1: User data transform

name
Specify the name of the user-defined data transform program.

Qualifier 2: Library

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

Manufacturer type and model (MFRTYPMDL)

Specifies the manufacturer, type, and model for a printer using the host print transform function or a user data transform program.

If *WSCSTxxx is specified for MFRTYPMDL, a workstation customizing object must be specified.

This parameter is only prompted when TRANSFORM(*YES) is specified or when a user data transform program is used.

*SAME
The value does not change.
*WSCST
The value of the WSCST parameter is used.
manufacturer-type-model
Specify the manufacturer, type, and model for a printer using the host print transform function or a user data transform program.

Manufacturer Type and Model Table

*IBM2380        IBM 2380 Personal Printer Series II
                IBM 2380 Plus Printer
*IBM2381        IBM 2381 Personal Printer Series II
                IBM 2381 Plus Printer
*IBM2390        IBM 2390 Personal Printer Series II
                IBM 2390 Plus Printer
*IBM2391        IBM 2391 Personal Printer Series II
                IBM 2391 Plus Printer
*IBM3112        IBM 3112 Page Printer
*IBM3116        IBM 3116 Page Printer
*IBM3130        IBM 3130 Advanced Function Printer
*IBM3812        IBM 3812 Pageprinter
*IBM3816        IBM 3816 Pageprinter
*IBM3912HP      IBM 3912 Page Printer (HP Mode)
*IBM3916HP      IBM 3916 Page Printer (HP Mode)
*IBM39302       IBM 39302 IBM 3930-02S Page Printer
                IBM 39302 IBM 3930-02D Page Printer
*IBM39303       IBM 39303 IBM 3930-03S Page Printer
                IBM 39303 IBM 3930-03D Page Printer
*IBM4019        IBM 4019 LaserPrinter
                IBM 4019E LaserPrinter E
*IBM4019HP      IBM 4019 LaserPrinter (HP Mode)
                IBM 4019E LaserPrinter E (HP Mode)
*IBM4029        IBM 4029-010 LaserPrinter 5E
                IBM 4029-020 LaserPrinter 6
                IBM 4029-030 LaserPrinter 10
                IBM 4029-040 LaserPrinter 10L
*IBM4029HP      IBM 4029-010 LaserPrinter 5E (HP Mode)
                IBM 4029-020 LaserPrinter 6 (HP Mode)
                IBM 4029-030 LaserPrinter 10 (HP Mode)
                IBM 4029-040 LaserPrinter 10L
                (HP Mode)
*IBM4037        IBM 4037 5E Printer
*IBM4039HP      IBM 4039 LaserPrinter 10D (HP Mode)
                IBM 4039 LaserPrinter 10D Plus
                (HP Mode)
                IBM 4039 LaserPrinter 10R (HP Mode)
                IBM 4039 LaserPrinter 10R Plus
                (HP Mode)
                IBM 4039 LaserPrinter 12R (HP Mode)
                IBM 4039 LaserPrinter 12R Plus
                (HP Mode)
                IBM 4039 LaserPrinter 12L (HP Mode)
                IBM 4039 LaserPrinter 12L Plus
                (HP Mode)
                IBM 4039 LaserPrinter 16L (HP Mode)
                IBM 4039 LaserPrinter 16L Plus
                (HP Mode)
*IBM4070        IBM 4070 IJ (IBM Mode)
*IBM4070EP      IBM 4070 IJ (Epson Mode)
*IBM4072        IBM 4072 ExecJet
*IBM4076        IBM 4076 ExecJet II Printer (HP Mode)
*IBM42011       IBM 4201-1 Proprinter
*IBM42012       IBM 4201-2 Proprinter II
*IBM42013       IBM 4201-3 Proprinter III
*IBM42021       IBM 4202-1 Proprinter XL
*IBM42022       IBM 4202-2 Proprinter II XL
*IBM42023       IBM 4202-3 Proprinter III XL
*IBM42071       IBM 4207-1 Proprinter X24
*IBM42072       IBM 4207-2 Proprinter X24E
*IBM42081       IBM 4208-1 Proprinter XL24
*IBM42082       IBM 4208-2 Proprinter XL24E
*IBM4212        IBM 4212 Proprinter 24P
*IBM4216        IBM 4216-10 Personal Pageprinter
*IBM4226        IBM 4226-302 Printer
*IBM4230        IBM 4230-4S3 Printer (IBM Mode)
                IBM 4230-4I3 Printer (IBM Mode)
*IBM4232        IBM 4232-302 Printer (IBM Mode)
*IBM4244ASF     IBM 4244 Printer (single tractor feed
                and ASF)
*IBM4244DUAL    IBM 4244 Printer (dual tractor feeds)
*IBM4244MAN     IBM 4244 Printer (single form feed or
                manual selection)
*IBM4247ASF     IBM 4247 Printer (single tractor feed
                and ASF)
*IBM4247DUAL    IBM 4247 Printer (dual tractor feeds)
*IBM4247MAN     IBM 4247 Printer (single form feed or
                manual selection)
*IBM4308        IBM Infoprint Color 8
*IBM4312        IBM Network Printer 12
*IBM4317        IBM Network Printer 17
*IBM4320        IBM Infoprint 20
*IBM4322        IBM Infoprint 21
*IBM4324        IBM Network Printer 24
*IBM4332        IBM Infoprint 32
*IBM4340        IBM Infoprint 40
*IBM47121       IBM 4712-1 Transaction Printer
*IBM47122       IBM 4712-2 Transaction Printer
*IBM47221       IBM 4722-1 Document Printer
*IBM47222       IBM 4722-2 Document Printer
*IBM4770        IBM 4770 InkJet Transaction Printer
*IBM4912        IBM Infoprint 12
*IBM5152        IBM 5152 Graphics Printer
*IBM5201        IBM 5201-2 Quietwriter
*IBM5202        IBM 5202-1 Quietwriter III
*IBM5204        IBM 5204-1 Quickwriter
*IBM5216        IBM 5216 Wheelprinter
*IBM5575        IBM 5579-H02 Printer
                IBM 5579-K02 Printer
                IBM 5577-T02 Printer
                IBM 5579-S02 Printer
                IBM 5577-K02 Printer
                IBM 5577-J02 Printer
                IBM 5577-G02 Printer
                IBM 5577-H02 Printer
                IBM 5577-F02 Printer
                IBM 5577-B02 Printer
                IBM 5575-H02 Printer
                IBM 5575-F02 Printer (with SBCS
                Cartridge)
                IBM 5575-B02 Printer (with SBCS
                Cartridge)
                IBM 5573-K02 Printer
                IBM 5573-J02 Printer
                IBM 5573-H02 Printer
                IBM 5573-G02 Printer
                IBM 5572-B02 Printer
                IBM 5417-011 Printer
                IBM 5407-011 Printer
                IBM 5327-011 Printer
                IBM 4208-502 Printer
*IBM6400        IBM 6400 Printers (IBM Mode)
*IBM6400EP      IBM 6400 Printers (Epson Mode)
*IBM6404        IBM 6404 Printers (IBM Mode)
*IBM6404EP      IBM 6404 Printers (Epson Mode)
*IBM6408        IBM 6408-A00 Printer (IBM Mode)
                IBM 6408-CTA Printer (IBM Mode)
*IBM6408EP      IBM 6408-A00 Printer (Epson Mode)
                IBM 6408-CTA Printer (Epson Mode)
*IBM6412        IBM 6412-A00 Printer (IBM Mode)
                IBM 6412-CTA Printer (IBM Mode)
*IBM6412EP      IBM 6412-A00 Printer (Epson Mode)
                IBM 6412-CTA Printer (Epson Mode)
*IBMPAGES       IBM 5589-H01 Printer
                IBM 5588-H02 Printer
                IBM 5587-H01 Printer
                IBM 5586-H02 Printer
                IBM 5585-H01 Printer
                IBM 5584-K02 Printer
                IBM 5584-H02 Printer
                IBM 5584-G02 Printer
*IBMPAGESNPB    Same as *IBMPAGES, but without text
                positioning adjustments for a no-print
                border
*IBMPAGES300    IBM Network Printer 12 (with PAGES
                feature)
                IBM Network Printer 17 (with PAGES
                feature)
                IBM Network Printer 24 (with PAGES
                feature)
                IBM Infoprint 20 (with PAGES feature)
                IBM Infoprint 32 (with PAGES feature)
                IBM Infoprint 40 (with PAGES feature)
*IBMPAGES300NPB Same as *IBMPAGES300, but without text
                positioning adjustments for a no-print
                border
*INFOPRINT8C    IBM Infoprint Color 8
*INFOPRINT12    IBM Infoprint 12
*INFOPRINT20    IBM Infoprint 20
*INFOPRINT21    IBM Infoprint 21
*INFOPRINT32    IBM Infoprint 32
*INFOPRINT40    IBM Infoprint 40
*INFOPRINT70    IBM Infoprint 70
*INFOPRINT85    IBM Infoprint 2085
*INFOPRINT105   IBM Infoprint 2105
*INFOPRINT1116  IBM Infoprint 1116
*INFOPRINT1120  IBM Infoprint 1120
*INFOPRINT1125  IBM Infoprint 1125
*INFOPRINT1130  IBM Infoprint 1130
*INFOPRINT1140  IBM Infoprint 1140
*INFOPRINT1145  IBM Infoprint 1145
*INFOPRINT1220C IBM Infoprint Color 1220
*INFOPRINT1222  IBM Infoprint 1222
*INFOPRINT1226  IBM Infoprint 1226
*INFOPRINT1228C IBM Infoprint Color 1228
*INFOPRINT1312  IBM Infoprint 1312
*INFOPRINT1332  IBM Infoprint 1332
*INFOPRINT1334C IBM Infoprint Color 1334
*INFOPRINT1352  IBM Infoprint 1352
*INFOPRINT1354C IBM Infoprint Color 1354
*INFOPRINT1357C IBM Infoprint Color 1357
*INFOPRINT1372  IBM Infoprint 1372
*INFOPRINT1400C IBM Infoprint Color 14xx Series
                Printer
*INFOPRINT1410  IBM Infoprint 1410 MFP
*INFOPRINT1412  IBM Infoprint 1412
*INFOPRINT1422  IBM Infoprint 1422
*INFOPRINT2000  IBM Infoprint 2000
*INFOPRINT2085  IBM Infoprint 2085
*INFOPRINT2105  IBM Infoprint 2105
*INFOPRINT2705  IBM Infoprint 2105
*INFOPRINT2706  IBM Infoprint 2105ES
*INFOPRINT2761  IBM Infoprint 2060ES
*INFOPRINT2775  IBM Infoprint 2075ES
*INFOPRINT2785  IBM Infoprint 2085
*INFOPRINT2790  IBM Infoprint 2090ES
*CANLIPS3       Canon LIPS3 DBCS Printers
*CANLIPS3NPB    Same as *CANLIPS3, but without text
                positioning adjustments for a no-print
                border
*CPQPM15        COMPAQ PageMark 15 (HP Mode)
*CPQPM20        COMPAQ PageMark 20 (HP Mode)
*EPAP2250       Epson ActionPrinter 2250
*EPAP3250       Epson ActionPrinter 3250
*EPAP5000       Epson ActionPrinter 5000
*EPAP5500       Epson ActionPrinter 5500
*EPDFX5000      Epson DFX-5000
*EPDFX8000      Epson DFX-8000
*EPEPL7000      Epson EPL-7000
*EPEPL8000      Epson EPL-8000
*EPFX850        Epson FX-850
*EPFX870        Epson FX-870
*EPFX1170       Epson FX-1170
*EPLQ510        Epson LQ-510
*EPLQ570        Epson LQ-570
*EPLQ860        Epson LQ-860
*EPLQ870        Epson LQ-870
*EPLQ1070       Epson LQ-1070
*EPLQ1170       Epson LQ-1170
*EPLQ2550       Epson LQ-2550
*EPLX810        Epson LX-810
*EPSQ870        Epson SQ-870
*EPSQ1170       Epson SQ-1170
*ESCPDBCS       Epson ESC/P DBCS Printers
*HPII           HP LaserJet Series II
*HPIID          HP LaserJet IID
*HPIIP          HP LaserJet IIP
*HPIII          HP LaserJet III
*HPIIID         HP LaserJet IIID
*HPIIIP         HP LaserJet IIIP
*HPIIISI        HP LaserJet IIISi
*HP4            HP LaserJet 4
*HP5            HP LaserJet 5 series
*HP5SI          HP LaserJet 5Si
*HP6            HP LaserJet 6 series
*HP310          HP DeskJet 310
*HP320          HP DeskJet 320
*HP500          HP DeskJet 500
*HP520          HP DeskJet 520
*HP540          HP DeskJet 540
*HP550C         HP DeskJet 550C
*HP560C         HP DeskJet 560C
*HP1100         HP LaserJet 1100 series
*HP1200C        HP DeskJet 1200C
*HP1600C        HP DeskJet 1600C
*HP4000         HP LaserJet 4000 series
*HP5000         HP LaserJet 5000 series
*HP8000         HP LaserJet 8000 series
*HPCOLORLJ      HP Color LaserJet 5
*HPDBCS         HP LaserJet-compatible printers for
                Double Byte Character Set (DBCS) input
*HPPAINT        HP PaintJet
                HP PaintJet XL
                HP PaintJet XL300
*LEX2380        Lexmark Forms Printer 2380 Plus
*LEX2381        Lexmark Forms Printer 2381 Plus
*LEX2390        Lexmark Forms Printer 2390 Plus
*LEX2391        Lexmark Forms Printer 2391 Plus
*LEX4227        Lexmark 4227 Forms Printer
*LEXMARKC       Lexmark C Series Printer
*LEXMARKC510    Lexmark C510 Color Printer
*LEXMARKC750    Lexmark C750 Color Printer
*LEXMARKC752    Lexmark C752 Color Printer
*LEXMARKC910    Lexmark C910 Color Printer
*LEXMARKC912    Lexmark C912 Color Printer
*LEXMARKE       Lexmark E Series Printer
*LEXMARKE322    Lexmark E322 Printer
*LEXMARKE323    Lexmark E323 Printer
*LEXMARKE330    Lexmark E330 Printer
                Lexmark E332n Printer
*LEXMARKT       Lexmark T Series Printer
*LEXMARKT420    Lexmark T420 Printer
*LEXMARKT520    Lexmark T520 Printer
*LEXMARKT522    Lexmark T522 Printer
*LEXMARKT620    Lexmark T620 Printer
*LEXMARKT622    Lexmark T622 Printer
*LEXMARKT630    Lexmark T630 Printer
*LEXMARKT632    Lexmark T632 Printer
*LEXMARKT634    Lexmark T634 Printer
*LEXMARKW       Lexmark W Series Printer
*LEXMARKW812    Lexmark W812 Printer
*LEXMARKW820    Lexmark W820 Printer
*LEXMARKX422    Lexmark X422 MFP
*LEXOPTRA       Lexmark Optra Family (HP Mode)
*LEXOPTRAC      Lexmark Optra C Color Printer
*LEXOPTRAN      Lexmark Optra N Printer
*LEXOPTRAS      Lexmark Optra S Printer family
*LEXOPTRASC     Lexmark Optra SC Color Printer
                Lexmark Optra Color 1200 Printer
*LEXOPTRAT      Lexmark Optra T Printer series
*LEXOPTRAW      Lexmark Optra W Printer series
*NECP2          NEC P2 Pinwriter
*NECP2200       NEC P2200 Pinwriter
*NECP2200XE     NEC P2200 XE Pinwriter
*NECP5200       NEC P5200 Pinwriter
*NECP5300       NEC P5300 Pinwriter
*NECP6200       NEC P6200 Pinwriter
*NECP6300       NEC P6300 Pinwriter
*NECPCPR201     NEC PC-PR101 DBCS Printer
                NEC PC-PR201 DBCS Printer
*NONE           Printer supports page-descriptor
                language generated by the CVTIMG API.
                NOTE: Spoolfiles with device type of
                *SCS or *AFPDS cannot be processed by
                the Host Print Transform function for
                these printers.
*OKI184IBM      Okidata Microline 184 Turbo (IBM Mode)
*OKI320IBM      Okidata Microline 320 (IBM Mode)
*OKI321IBM      Okidata Microline 321 (IBM Mode)
*OKI390IBM      Okidata Microline 390 Plus (IBM Mode)
*OKI391IBM      Okidata Microline 391 Plus (IBM Mode)
*OKI393IBM      Okidata Microline 393 Plus (IBM Mode)
*OKI590IBM      Okidata Microline 590 (IBM Mode)
*OKI591IBM      Okidata Microline 591 (IBM Mode)
*OKI400         Okidata OL400 LED Page Printer
*OKI800         Okidata OL800 LED Page Printer
*OKI810         Okidata OL810 LED Page Printer
*OKI820         Okidata OL820 LED Page Printer
*OKI3410        Okidata Pacemark 3410
*PAN1123EP      Panasonic KX-P1123 (Epson Mode)
*PAN1124EP      Panasonic KX-P1124 (Epson Mode)
*PAN1124IEP     Panasonic KX-P1124i (Epson Mode)
*PAN1180EP      Panasonic KX-P1180 (Epson Mode)
*PAN1180IEP     Panasonic KX-P1180i (Epson Mode)
*PAN1191EP      Panasonic KX-P1191 (Epson Mode)
*PAN1624EP      Panasonic KX-P1624 (Epson Mode)
*PAN1654EP      Panasonic KX-P1654 (Epson Mode)
*PAN1695EP      Panasonic KX-P1695 (Epson Mode)
*PAN2123EP      Panasonic KX-P2123 (Epson Mode)
*PAN2124EP      Panasonic KX-P2124 (Epson Mode)
*PAN2180EP      Panasonic KX-P2180 (Epson Mode)
*PAN2624EP      Panasonic KX-P2624 (Epson Mode)
*PAN4410HP      Panasonic KX-P4410 (HP Mode)
*PAN4420HP      Panasonic KX-P4420 (HP Mode)
*PAN4430HP      Panasonic KX-P4430 (HP Mode)
*PAN4450IHP     Panasonic KX-P4450i (HP Mode)
*PAN4451HP      Panasonic KX-P4451 (HP Mode)
*PANASONIC2310  Panasonic DP-2310 Printer
*PANASONIC3010  Panasonic DP-3010 Printer
*PANASONIC3510  Panasonic DP-3510 Printer
*PANASONIC3520  Panasonic DP-3520 Printer
*PANASONIC4510  Panasonic DP-4510 Printer
*PANASONIC4520  Panasonic DP-4520 Printer
*PANASONIC6010  Panasonic DP-6010 Printer
*PANASONIC6020  Panasonic DP-6020 Printer
*RICOH1515      Ricoh Aficio 1515 Printer Series
*RICOH2015      Ricoh Aficio 2015 Printer Series
*RICOH2018      Ricoh Aficio 2018 Printer Series
*RICOH2022      Ricoh Aficio 2022 Printer Series
*RICOH2027      Ricoh Aficio 2027 Printer Series
*RICOH2032      Ricoh Aficio 2032 Printer Series
*RICOH2035      Ricoh Aficio 2035 Printer Series
*RICOH2045      Ricoh Aficio 2045 Printer Series
*RICOHAP400     Ricoh Aficio AP400 Printer Series
*RICOHAP600N    Ricoh Aficio AP600N Printer Series
*RICOHAP900     Ricoh Aficio AP900 Printer Series
*RICOHAP3200    Ricoh Aficio AP3200 Printer Series
*RICOHAP4510    Ricoh Aficio AP4510 Printer Series
*RICOHCL2000    Ricoh Aficio CL2000 Color Printer
                Series
*RICOHCL3100    Ricoh Aficio CL3000e Color Printer
                Series
                Ricoh Aficio CL3100N Color Printer
                Series
*RICOHCL4000    Ricoh Aficio CL4000 Color Printer
                Series
*RICOHCL5000    Ricoh Aficio CL5000 Color Printer
                Series
*RICOHCL7000    Ricoh Aficio CL7000 Color Printer
                Series
*RICOHCL7100    Ricoh Aficio CL7100 Color Printer
                Series
*WORKIO_BL      Panasonic WORKiO DP-23xx Series
                Printer
                Panasonic WORKiO DP-30xx Series
                Printer
*WORKIO_BM      Panasonic WORKiO DP-35xx Series
                Printer
*WORKIO_CR      Panasonic WORKiO DP-Cxxx Series
                Color Printer
*XRX4215MRP     Xerox 4215/MRP (HP Mode)
*XRX4219MRP     Xerox 4219/MRP (HP Mode)
*XRX4220MRP     Xerox 4220/MRP (HP Mode)
*XRX4230MRP     Xerox 4230/MRP (HP Mode)
*XRX4235        Xerox 4235 LaserPrinting (HP Mode)
*XRX4700II      Xerox 4700 II Color Document Printer
                (HP Mode)
*WSCSTA3        Printer not listed (A3-sized paper)
*WSCSTA4        Printer not listed (A4-sized paper)
*WSCSTA5        Printer not listed (A5-sized paper)
*WSCSTB4        Printer not listed (B4-sized paper)
*WSCSTB5        Printer not listed (B5-sized paper)
*WSCSTCONT80    Printer not listed (8 inch continuous
                forms)
*WSCSTCONT132   Printer not listed (13.2 inch
                continuous forms)
*WSCSTEXECUTIVE Printer not listed (executive-sized
                paper)
*WSCSTLEDGER    Printer not listed (ledger-sized
                paper)
*WSCSTLEGAL     Printer not listed (legal-sized paper)
*WSCSTLETTER    Printer not listed (letter-sized
                paper)
*WSCSTNONE      Printer not listed (paper size not
                specified)
*WSCST          Printer not listed

Top

Workstation customizing object (WSCST)

Specifies an object that consists of a table of attributes used to customize a given ASCII device, such as a workstation or printer. Character presentation, font specifications, and control key sequences are examples of characteristics that can be customized.

This parameter is only prompted when TRANSFORM(*YES) is specified, or when a user data transform program is used.

Single values

*SAME
The value does not change.
*NONE
No workstation customizing object is specified.

Qualifier 1: Workstation customizing object

name
Specify the name of a workstation customizing object, which was created with the Create Work Station Customizing Object (CRTWSCST) command.

Qualifier 2: Library

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

Image configuration (IMGCFG)

Specifies the image configuration for this output queue. An image configuration object provides transform services for a variety of image and print datastream formats. This parameter is only used with remote writers.

See the Image Configuration Object (IMGCFG Parameter) table below for a list of the image configuration objects provided.

See the Recommended Image Configuration Objects by Printer table below for the suggested IMGCFG object for many popular printers.

*SAME
The value does not change.
*NONE
No image configuration specified.
character-value
Specify the image configuration to be used with the output queue.

Image Configuration Object Table

 -------------- HP PCL Datastream ------------------------
*IMGA01    PCL 300-dpi printer
*IMGA02    PCL 600-dpi printer
*IMGA03    PCL 1200-dpi printer
*IMGA04    PCL 300-dpi color printer
*IMGA05    PCL 600-dpi color printer
*IMGA06    PCL 1200-dpi color printer
*IMGA07    PCL 75-dpi printer (No compression)
*IMGA08    PCL 600-dpi color printer
           with larger no-print border
*IMGA09    PCL 300-dpi printer (No compression)
 ------------- Postscript Datastream ----------------------
*IMGB01    Postscript 300-dpi printer
*IMGB02    Postscript 600-dpi printer
*IMGB03    Postscript 1200-dpi printer
*IMGB04    Postscript 300-dpi color printer
*IMGB05    Postscript 600-dpi color printer
*IMGB06    Postscript 1200-dpi color printer
*IMGB07    Postscript 600x300-dpi color printer
*IMGB08    Postscript 1200x300-dpi color printer
*IMGB09    Postscript 360-dpi color printer
*IMGB10    Postscript 720-dpi color printer
*IMGB11    Postscript 1440x720-dpi color printer
*IMGB12    Postscript 400-dpi printer
*IMGB13    Postscript 800-dpi color printer
*IMGB14    Postscript 600-dpi color printer
           with larger no-print border
*IMGB15    Postscript 300-dpi color printer
           with larger no-print border
 ----------------- IPDS Datastream -------------------------
*IMGC01    IPDS 240-dpi printer
*IMGC02    IPDS 300-dpi printer
*IMGC03    IPDS 600-dpi printer
*IMGC04    IPDS 1200-dpi printer
*IMGC05    IPDS 240-dpi printer with no-print border
*IMGC06    IPDS 300-dpi printer with no-print border
*IMGC07    IPDS 600-dpi printer with no-print border
*IMGC08    IPDS 1200-dpi printer with no-print border
*IMGC09    IPDS 240-dpi printer (IM/1 image only)
*IMGC10    IPDS 240-dpi printer with no-print border
                (IM/1 image only)
*IMGC11    IPDS 240-dpi printer (CCITT G4 compression)
 ------------- PCL and Postscript Datastreams ---------------
*IMGD01    PCL/Postscript 300-dpi printer
*IMGD02    PCL/Postscript 600-dpi printer
*IMGD03    PCL/Postscript 1200-dpi printer
*IMGD04    PCL/Postscript 300-dpi color printer
*IMGD05    PCL/Postscript 600-dpi color printer
*IMGD06    PCL/Postscript 1200-dpi color printer
*IMGD07    PCL 300-dpi/Postscript 600-dpi printer
*IMGD08    PCL 300-dpi/Postscript 1200-dpi printer
*IMGD09    PCL 600-dpi/Postscript 300-dpi printer
*IMGD10    PCL 600-dpi/Postscript 1200-dpi printer
*IMGD11    PCL/Postscript 600-dpi color printer
           with larger no-print border

Recommended Image Configuration Objects by Printer Table

Compaq Pagemarc 20                                      *IMGD01
Epson EPCL-4 Printer                                    *IMGA01
Epson EPCL-5 Printer                                    *IMGA02
Epson Stylus Photo with Postscript                      *IMGB10
Epson Stylus Color 600, 800 with Postscript             *IMGB11
HP Color Laserjet 5                                     *IMGA04
HP Color Laserjet 5M                                    *IMGD04
HP Deskjet 560C, 820C, 1200C                            *IMGA04
HP Deskjet 500, 600, 1200                               *IMGA01
HP Deskjet 1600C, 1600CN                                *IMGA04
HP Deskjet 1600CM                                       *IMGD04
HP Laserjet II, IID, IIP                                *IMGA09
HP Laserjet II, IID, IIP with Postscript                *IMGB01
HP Laserjet III, IIID, IIISi, 4L                        *IMGA01
HP Laserjet III, IIID, IIISi, 4L with Postscript        *IMGD01
HP Laserjet 4, 4P, 4V, 4Si, 4 Plus                      *IMGA02
HP Laserjet 4M, 4MP, 4MV, 4Si MX, 4M Plus               *IMGD02
HP Laserjet 5, 5P, 5Si                                  *IMGA02
HP Laserjet 5M, 5MP, 5Si MX                             *IMGD02
HP Laserjet 6, 6P, 6L                                   *IMGA02
HP Laserjet 6M, 6MP                                     *IMGD02
IBM 3112, 3116 Page Printer with IPDS feature           *IMGD02
IBM 3112, 3116 Page Printer (ASCII/LAN)                 *IMGA02
IBM 3112, 3116 Page Printer with Postscript             *IMGD02
IBM 3130, 3160-1 AF Printer (240-pel mode)              *IMGC01
IBM 3130 AF Printer (300-pel mode)                      *IMGC02
IBM Infoprint 20 with IPDS feature                      *IMGC02
IBM Infoprint 20 (ASCII)                                *IMGA02
IBM Infoprint 32 with IPDS feature                      *IMGC02
IBM Infoprint 32 (ASCII)                                *IMGA02
IBM Infoprint 60                                        *IMGC03
IBM Infoprint 62 Model 2                                *IMGC05
IBM Infoprint 62 Model 3                                *IMGC06
IBM InfoColor 70                                        *IMGB05
IBM Infoprint 4000                                      *IMGC05
IBM Infoprint 4000 High Resolution                      *IMGC06
IBM 3825, 3827, 3828 AF Printer                         *IMGC09
IBM 3825, 3827, 3828 AF Printer (with AFIG)             *IMGC01
IBM 3829 AF Printer                                     *IMGC01
IBM 3835-001 AF Printer                                 *IMGC10
IBM 3835-001 AF Printer (with AFIG)                     *IMGC05
IBM 3835-002, 3900 AF Printer                           *IMGC05
IBM 3912, 3916 Page Printer (ASCII/LAN)                 *IMGA01
IBM 3912, 3916 Page Printer with IPDS feature (twinax)  *IMGC06
IBM 3930-02 Page Printer (IPDS diskette)                *IMGC01
IBM 3930-03 Page Printer                                *IMGA01
IBM 3930-03 Page Printer with Postscript                *IMGD01
IBM 3935 AF Printer                                     *IMGC02
IBM 4019 LaserPrinters (HP mode)                        *IMGA09
IBM 4019 LaserPrinters with Postscript                  *IMGB01
IBM 4028 LaserPrinters                                  *IMGC06
IBM 4029 LaserPrinters                                  *IMGA01
IBM 4029 LaserPrinters with Postscript                  *IMGB02
IBM 4039 LaserPrinters                                  *IMGA01
IBM 4039 LaserPrinters with Postscript                  *IMGD07
IBM 4049 LaserPrinters                                  *IMGA02
IBM 4049 LaserPrinters with Postscript                  *IMGD02
IBM 4079 Color Jetprinter PS                            *IMGB09
IBM 4303 Network Color Printer                          *IMGB05
IBM 4312, 4317, 4324 NP with IPDS feature (twinax)      *IMGC06
IBM 4312, 4317, 4324 NP with IPDS feature (LAN)         *IMGC06
IBM 4312, 4317, 4324 NP (ASCII/LAN)                     *IMGA02
IBM 4312, 4317, 4324 NP with Postscript (ASCII/LAN)     *IMGD02
Lexmark 4039Plus                                        *IMGB02
Lexmark Optra C Color Printer                           *IMGD11
Lexmark Optra E, E+                                     *IMGA02
Lexmark Optra N                                         *IMGD02
Lexmark Optra R+, Rx+, Lx+, Lxn+                        *IMGD02
Lexmark Optra S Printers                                *IMGD02
Lexmark Optra SC Color Printer                          *IMGD05
Okidata OL400 LED Page Printer                          *IMGA01
Okidata OL800, OL810 LED Page Printers                  *IMGA02
QMS 2025, 3225                                          *IMGB12
QMS Magicolor CX                                        *IMGD04
Tektronix Phaser 140                                    *IMGB09
Tektronix Phaser 300                                    *IMGB04
Tektronix Phaser 400                                    *IMGB05
Tektronix Phaser 540, 550                               *IMGB05
Tektronix Phaser 560                                    *IMGB06
Xerox 4219/MRP                                          *IMGA01
Xerox 4220/MRP                                          *IMGA02
Xerox 4230 DocuPrinter                                  *IMGA02
Xerox 4512, 4517 Network Printer                        *IMGA02
Xerox 4520mp Printer                                    *IMGB13
Xerox 4700 II Color Document Printer                    *IMGD04
Xerox 4915 Color Laser Printer                          *IMGB08
Xerox 4920, 4925 Color Laser Printer                    *IMGB05

Top

Internet address (INTNETADR)

Specifies the internet address of the remote system to which the print request will be sent.

Note: This parameter is valid only when RMTSYS(*INTNETADR) is specified.

*SAME
The value does not change.
internet-address
The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. (An internet address having all binary ones or zeros in the bits of the network or host identifier portions of the address is not valid.)

Values must be enclosed in apostrophes (') when entered from the command line.

Top

VM/MVS class (CLASS)

Specifies the VM/MVS SYSOUT class for files sent to a VM/MVS host system.

Note: This parameter is valid only when CNNTYPE(*SNA) and DESTTYPE(*S390) are specified.

*SAME
The value does not change.
character-value
Specify a distribution class value. Valid values range from A through Z and 0 through 9.
Top

Forms Control Buffer (FCB)

Specifies the forms control buffer for files sent to a VM/MVS host system.

Note: This parameter is valid only when CNNTYPE(*SNA) and DESTTYPE(*S390) are specified.

*SAME
The value does not change.
*NONE
No forms control buffer is used.
*USRDTA
The first 8 characters of the user data (USRDTA) spooled file attribute is the name of the forms control buffer. If the user data is blank, no forms control buffer is used.
*PRTF
The first 8 characters of the printer file used to spool the file is the name of the forms control buffer.
name
Specify the name of the forms control buffer to be used.
Top

Destination options (DESTOPT)

Specifies the destination-dependent options. When CNNTYPE(*IP) is specified, the destination-dependent options are added to the control file which is sent to the remote LPD server. When CNNTYPE(*IP) and DESTTYPE(*NDS) or CNNTYPE(*SNA) is specified, this field is used to determine how spooled files are handled once they are sent to the remote system.

*SAME
The value does not change.
*NONE
No destination options are specified.
*USRDFNTXT
The user-defined text of the user profile when the spooled file was created is used. This value is ignored if CNNTYPE(*IP) and DESTTYPE(*NDS) or CNNTYPE(*SNA) is specified.
*NOWAIT
When CNNTYPE(*IP) and DESTTYPE(*NDS) or CNNTYPE(*SNA) is specified, a value of *NOWAIT indicates that the operating system will no longer keep track of spooled files once they have been sent.
'destination-options'
Specify no more than 128 characters, enclosed in apostrophes.
Top

Print separator page (SEPPAGE)

Specifies whether or not to request a separator page when printing on a remote system.

Note: This parameter is valid only when CNNTYPE(*IP) is specified.

*SAME
The value does not change.
*YES
A separator page is requested.
*NO
A separator page is not requested.
Top

User-defined options (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.

Single values

*SAME
The value does not change.
*NONE
No user-defined option is specified.

Other values (up to 4 repetitions)

character-value
Specify the user-defined option to be used by user applications that process spooled files. All characters are acceptable.
Top

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.

Single values

*SAME
The value does not change.
*NONE
No user-defined object name is specified .

Element 1: Object

Qualifier 1: Object

name
Specify the name of the user-defined object.

Qualifier 2: Library

*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: Object type

object-type
The user object type can be one of the following:
  • *DTAARA (Data Area)
  • *DTAQ (Data Queue)
  • *FILE (File)
  • *PSFCFG (PSF Configuration)
  • *USRIDX (User Index)
  • *USRQ (User Queue)
  • *USRSPC (User Space)
Top

User-defined driver program (USRDRVPGM)

Specifies the user-defined driver program.

Note: This parameter is valid only when RMTSYS is not *NONE.

Single values

*SAME
The value does not change.
*NONE
No user-defined driver program is specified.

Qualifier 1: User driver program

name
Specify the name of the user-specified driver program to process spooled files.

Qualifier 2: Library

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

Spooled file ASP (SPLFASP)

Specifies the auxiliary storage pool (ASP) where the spooled files physically reside.

*SAME
The value does not change.
*OUTQASP
The spooled files reside in the same ASP that the output queue resides in.
*SYSTEM
The spooled files reside in the system ASP. This value is not allowed if the output queue is in a library on a primary or secondary ASP.
Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text, if any, is not to be changed.
*BLANK
No text is to be specified.
'description'
Specify no more than 50 characters, enclosed in apostrophes.
Top

Display any file (DSPDTA)

Specifies whether users that have authority to read the output queue can display the data from any spooled file on the queue or display only data from their own files.

*SAME
The current value of the display data attribute that is specified for the output queue does not change.
*NO
Users authorized to use the queue can display, copy, or send the data from their own files only, unless they have some special authority.
*YES
Any user with read authority for the output queue can display, copy, or send the data from any file on the queue.
*OWNER
The owner of the file or a user with spool control (*SPLCTL) special authority can display, copy, or send the spooled files on the queue.
Top

Job separators (JOBSEP)

Specifies, for each job having spooled files on this output queue, the number of separators to be placed at the beginning of the printed output for each job. Each separator contains information that identifies the job such as its name, the job user's name, the job number, and the time and date when the job was run. The number of separators can range from 0 through 9.

This parameter is used only by the printer writers, all other types of writers will ignore the value specified for this parameter.

*SAME
The number of job separators does not change.
*MSG
No job separators are placed before each job's output. Instead, a message is sent to the writer's message queue notifying the operator of the end of each job.
0-9
Specify the new number of separators placed before the output of each job.
Top

Operator controlled (OPRCTL)

Specifies whether a user with job control authority is allowed to control and make changes to spooled files with entries on this output queue.

*SAME
The current value specified for the operator control attribute of the output queue does not change.
*YES
A user with job control authority can control the queue and make changes to the entries on the queue.
*NO
This queue and its entries cannot be manipulated or changed by users with job control authority unless they also have some other special authority.
Top

Data queue (DTAQ)

Specifies the data queue associated with the output queue.

Single values

*SAME
The value does not change.
*NONE
No data queue is associated with the output queue.

Qualifier 1: Data queue

name
Specify the name of the data queue associated with the output queue.

Qualifier 2: Library

*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 where the data queue is located.
Top

Authority to check (AUTCHK)

Specifies what type of authorities to the output queue allow the user to control all the files on the queue. Users with some special authority may also be able to control the spooled files.

*SAME
The current value of the authority check attribute that is specified for the output queue is not to be changed.
*OWNER
The requester must have ownership authority to the output queue to pass the output queue authorization test. The requester can have ownership authority by being the owner of the output queue, sharing a group profile with the queue owner, or running a program that adopts the owner's authority.
*DTAAUT
Any user with add, read, and delete authority to the output queue can control all spooled files on the queue.
Top

Examples

CHGOUTQ   OUTQ(QPRINT4)  JOBSEP(4)
          TEXT('Default queue for files using 4-part forms')

This command changes the number of job separators and the text that describes the output queue named QPRINT4. Four job separator pages are inserted before the spooled files for each job produced from the QPRINT4 output queue.

Top

Error messages

*ESCAPE Messages

CPF0002
Command not run. Error detected by validity checker.
CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF33F1
Data queue &1 in library &2 not found.
CPF3319
Cannot change parameters specified. A writer is active to output queue &1.
CPF3330
Necessary resource not available.
CPF3357
Output queue &1 in library &2 not found.
CPF3361
Output queue &1 in library &2 not changed. Output queue in use.
CPF34D7
Output queue &1 in &2 not changed due to errors.
Top