Create Output Queue (CRTOUTQ)

The Create Output Queue (CRTOUTQ) command creates a new output queue for spooled files. An entry is placed on the output queue for each spooled file. The order in which the files are written to the output device is determined by the output priority of the spooled file and the value specified on the Order of files on queue (SEQ) parameter.

Parameters

Keyword	Description	Choices	Notes
OUTQ	Output queue	Qualified object name	Required, Positional 1
	Qualifier 1: Output queue	Name
	Qualifier 2: Library	Name, *CURLIB
MAXPAGES	Maximum spooled file size	Single values: 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	FIFO, JOBNBR	Optional
RMTSYS	Remote system	Character value, INTNETADR, NONE, PASTHR, NWSA	Optional
RMTPRTQ	Remote printer queue	Character value, USER, SYSTEM	Optional
AUTOSTRWTR	Writers to autostart	1-10, *NONE	Optional
MSGQ	Queue for writer messages	Qualified object name	Optional
	Qualifier 1: Queue for writer messages	Name, QSYSOPR
	Qualifier 2: Library	Name, LIBL, CURLIB
CNNTYPE	Connection type	Character value, SNA, IP, *USRDFN	Optional
DESTTYPE	Destination type	Character value, OS400, OS400V2, PSF2, S390, NDS, OTHER	Optional
TRANSFORM	Host print transform	YES, NO	Optional
USRDTATFM	User data transform	Single values: 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, IBM42011, WSCST	Optional
WSCST	Workstation customizing object	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Workstation customizing object	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
IMGCFG	Image configuration	Character value, *NONE	Optional
INTNETADR	Internet address	Character value	Optional
CLASS	VM/MVS class	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	Optional
DESTOPT	Destination options	Character value, NONE, USRDFNTXT, *NOWAIT	Optional
SEPPAGE	Print separator page	YES, NO	Optional
USRDFNOPT	User defined option	Single values: NONE Other values (up to 4 repetitions): Character value*	Optional
USRDFNOBJ	User defined object	Single values: NONE Other values: Element list*	Optional
	Element 1: Object	Qualified object name
	Qualifier 1: Object	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
	Element 2: Object type	DTAARA, DTAQ, FILE, PSFCFG, USRIDX, USRQ, *USRSPC
USRDRVPGM	User driver program	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: User driver program	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
SPLFASP	Spooled file ASP	SYSTEM, OUTQASP	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
DSPDTA	Display any file	NO, YES, *OWNER	Optional, Positional 2
JOBSEP	Job separators	0-9, 0, *MSG	Optional, Positional 3
OPRCTL	Operator controlled	YES, NO	Optional, Positional 4
DTAQ	Data queue	Single values: NONE Other values: Qualified object name*	Optional
	Qualifier 1: Data queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
AUTCHK	Authority to check	OWNER, DTAAUT	Optional
AUT	Authority	Name, USE, ALL, CHANGE, EXCLUDE, *LIBCRTAUT	Optional

Top

Output queue (OUTQ)

Specifies the output queue being created.

This is a required parameter.

Qualifier 1: Output queue

name: Specify the name of the output queue being created.

Qualifier 2: Library

*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.
name: Specify the name of the library where the output queue is to be located.
Note: The temporary library QTEMP is not a valid library name. Output queues must be in permanent libraries.

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.) Time must be specified in hhmmss format, on a 24 hour clock.

Single values

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

Order of files on queue (SEQ)

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

*FIFO: The queue is first-in first-out within priority for each file. That is, new spooled files are placed after all other entries on the queue of the same priority.
*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.

Remote system (RMTSYS)

Specifies the remote system to send files to 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.

*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.
*PASTHR: The system 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.
*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 for the DESTTYPE parameter.
remote-system-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.

Remote printer queue (RMTPRTQ)

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

*USER

The user profile that created the spooled file determines the user ID on the remote system. 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 is used to determine the printer queue. For a remote IBM System i, 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 DESTTYPE is *OS400 or *S390.

name

Specifies the name for the printer queue on the remote system. For a remote IBM System i, this is the name of an output queue on which the spooled file is created.

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 a destination system that is not an IBM System i, 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, the value *LIBL is used as the default.

Writers to autostart (AUTOSTRWTR)

Specifies the number of remote writers that will be started automatically by the system. For user created output queues with the remote system (RMTSYS parameter) specified as *NONE, this parameter will be ignored.

*NONE: There will be no writers auto-started by the system to this output queue.
1-10: Specify the number of writers to be auto-started to this output queue.

Queue for writer messages (MSGQ)

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

Qualifier 1: Queue for writer messages

QSYSOPR: Messages are sent to the QSYSOPR message queue.
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.

Connection type (CNNTYPE)

Specifies the type of connection with the remote system.

*SNA: The spooled files are sent using SNADS. This is similar to the Send Network Spooled File (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.
*USRDFN: The spooled files are sent using a user-defined connection.

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.

*OS400: The spooled files are to be sent to an IBM System i, 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 sent to a system runing IBM i (OS/400) V2R3 or earlier. This value is valid only when CNNTYPE is *SNA.
*S390: The spooled files are sent to a System z. This value is valid only when CNNTYPE is *SNA or when CNNTYPE is *USRDFN.
*PSF2: The spooled files are sent to a personal computer running the PSF/2 product. This value is valid only when the CNNTYPE is *IP.
*NDS: The spooled files are to be sent to NETWARE4. This value is valid only when the CNNTYPE is *USRDFN.
*OTHER: The spooled files are sent to a system not matching any of the other special values. This includes systems running IBM i (OS/400) V1R3 or earlier, as well as System/36 and System/38 systems.

Transform SCS to ASCII (TRANSFORM)

Specifies whether or not 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.

*YES: The SCS data streams are transformed.
*NO: The SCS data streams are not transformed.

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

*NONE: No user-defined data transform program name is specified.

Qualifier 1: User data transform

name: Specify the name of the data transform program to be used by the driver 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.

Manufacturer type and model (MFRTYPMDL)

Specifies the manufacturer, type, and model for a printer using the host print transform function or user data transform program. This parameter is only prompted when TRANSFORM(*YES) is specified or a user data transform program is specified.

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

*IBM42011: The IBM 4201-1 Proprinter is used.
*WSCST: The value of the WSCST parameter is used.
character-value: Specify the manufacturer, type, and model for a printer using the host print transform function.

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
*INFOPRINT1500  IBM Infoprint 15xx Series Printer
*INFOPRINT1500C IBM Infoprint Color 15xx Series
                Printer
*INFOPRINT1600  IBM Infoprint 16xx Series Printer
*INFOPRINT1600C IBM Infoprint Color 16xx Series
                Printer
*INFOPRINT2000  IBM Infoprint 2000
*INFOPRINT2085  IBM Infoprint 2085
*INFOPRINT2105  IBM Infoprint 2105
*INFOPRINT2190  IBM Infoprint 2190
*INFOPRINT2210  IBM Infoprint 2210
*INFOPRINT2235  IBM Infoprint 2235
*INFOPRINT2705  IBM Infoprint 2105
*INFOPRINT2706  IBM Infoprint 2105ES
*INFOPRINT2761  IBM Infoprint 2060ES
*INFOPRINT2775  IBM Infoprint 2075ES
*INFOPRINT2785  IBM Infoprint 2085
*INFOPRINT2790  IBM Infoprint 2090ES
*INFOPRINT6500  IBM Infoprint 6500 (Epson Mode)
*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
*PDF            Portable Document Format
*PDFEMBEDTT     Portable Document Format. All TrueType
                font references are embedded in the
                output document.
*PDFIBMWT       Portable Document Format. References
                to IBM WorldType fonts shipped with
                the system are mapped to standard PDF
                font references.
*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
*RICOHMP1100    Ricoh Aficio MP1100 Printer Series
*RICOHMP1350    Ricoh Aficio MP1350 Printer Series
*RICOHMP9000    Ricoh Aficio MP9000 Printer Series
*RICOHSP4100N   Ricoh Aficio SP4100N Printer Series
                Ricoh Aficio SP4110N Printer Series
*RICOHSP9100DN  Ricoh Aficio SP9100DN Printer Series
*RICOHSPC811DN  Ricoh Aficio SPC811DN 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

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

*NONE: No workstation customizing object is specified.

Qualifier 1: Workstation customizing object

name: Specify the name of a workstation customizing object, which has been 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.

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.

*NONE: No image configuration specified.
character-value: Specify the image configuration to be used for this 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

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) and CNNTYPE(*IP) or CNNTYPE(*USRDFN) are specified.

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.

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.

A: The class is A.
character-value: Specify a distribution class value. Valid values range from A through Z and 0 through 9.

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.

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

Destination options (DESTOPT)

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

*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(*SNA) is specified.
*NOWAIT: When 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.

Print separator page (SEPPAGE)

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

*YES: A separator page is requested.
*NO: A separator page is not requested.

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

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

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

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

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)

User-defined driver program (USRDRVPGM)

Specifies the user-defined driver program.

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

Single values

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

Spooled file ASP (SPLFASP)

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

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

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*BLANK: No text is specified.
'description': Specify no more than 50 characters, enclosed in apostrophes.

Display any file (DSPDTA)

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

*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 having authority to read the queue can display, copy, or send the data of 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.

Job separators (JOBSEP)

Specifies, for each job with files on the output queue, the number of separators placed at the beginning of the output for the job. Each separator contains information that identifies the job, such as the name of the job, the job user's name, the job number, and the time and date when the job is run.

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

0: No job separators are printed before each job's output.
*MSG: A message is sent to a message queue notifying the operator of the end of each job. This message queue is identified by the Message queue (MSGQ) parameter of the Start Printer Writer (STRPRTWTR) command.
0-9: Specify the number of separators to be placed before each job's output.

Operator controlled (OPRCTL)

Specifies whether a user who has job control authority is allowed to manage or control the files on this output queue.

*YES: A user with job control authority can control the queue and make changes to the files on the queue.
*NO: This queue and its entries cannot be controlled or changed by users with job control authority unless they also have some other special authority.

Data queue (DTAQ)

Specifies the data queue associated with the output queue. Entries are logged in the data queue when spooled files are in ready (RDY) status on the output queue. A user program can determine when a spooled file is available on an output queue using the Receive Data Queue API (QRCVDTAQ) to receive information from a data queue.

Each time a spooled file on the output queue reaches RDY status, an entry is sent to the data queue. A spooled file can have several changes in status (for example, RDY to held (HLD) to release (RLS) to RDY again) before it is taken off the output queue. These status changes result in entries in the data queue for a spooled file each time the spooled file goes to RDY status.

When the data queue is created using the Create Data Queue (CRTDTAQ) command, the maximum message length (MAXLEN parameter) value should be at least 128 and the sequence (SEQ parameter) value should be *FIFO or *LIFO. More information about data queues on output queues is in the Printing category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Single values

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

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.

*OWNER: The requester must have ownership authority to the output queue in order 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.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*USE: Use authority allows the user to perform basic operations on the output queue, such as place spooled files on the queue. *USE authority provides object operational authority, read authority, and execute authority.
*CHANGE: Change authority allows the user to change the output queue description and to control files created by other users if the queue was created with *DTAAUT specified on the Authority to check (AUTCHK) parameter.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*EXCLUDE: The user cannot access the object.

*LIBCRTAUT: The authority for the object is the same as the value specified on the Create authority (CRTAUT) parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.
name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTOUTQ   OUTQ(DEPTAPRT)  AUT(*EXCLUDE)  SEQ(*FIFO)
          TEXT('SPECIAL PRINTER FILES FOR DEPTA')

This command creates an output queue named DEPTAPRT and puts it in the current library. Because AUT(*EXCLUDE) is specified and OPRCTL(*YES) is assumed, the output queue can be used and controlled only by the user who created the queue and users who have job control authority or spool control authority. Because SEQ(*FIFO) is specified, spooled files are placed in first-in first-out order on the queue. If users in Department A are authorized to use this output queue, the Grant Object Authority (GRTOBJAUT) command must be used to grant them the necessary authority. Data contained in files on this queue can be displayed only by users who own the files, by the owner of the queue, by users with job control authority, or by users with spool control authority. By default, no job separator is printed at the beginning of the output for each job.

Error messages

*ESCAPE Messages

CPF2182: Not authorized to library &1.
CPF2192: Object &1 cannot be created into library &3.
CPF2207: Not authorized to use object &1 in library &3 type *&2.
CPF2212: Not able to allocate library &1.
CPF2402: Library &1 not found
CPF2799: Message queue &1 in library &2 not found.
CPF33F1: Data queue &1 in library &2 not found.
CPF3352: Temporary library &1 invalid for output queue &2.
CPF3353: Output queue &1 in &2 already exists.
CPF3354: Library &1 not found.
CPF3356: Cannot allocate library &1.
CPF3371: Spool user profile QSPL damaged or not found.
CPF34D6: Output queue &1 in &2 not created due to errors.
CPF9818: Object &2 in library &3 not created.