Parameters

Table 1. Valid Parameters by Device for the DEVICE Initialization Statement
Parm	All Devices	All Printers	All Punches	3800-1	3800-3 3800-6 3800-8	3820	AFP1	4245 & 4248	3525	SNA RJP
ALTPM=					valid
BURST=		valid	valid	valid	valid	valid	valid	valid	valid
CARRIAGE=		valid		valid	valid	valid	valid	valid
CB=				valid				valid
CHARS=				valid	valid	valid	valid
CHNSIZE=										valid
CKPNT=		valid	valid	valid	valid	valid	valid	valid	valid
CKPNTPG=					valid	valid	valid
CKPNTSEC=					valid	valid	valid
COPYMARK=					valid	valid	valid
DGROUP=	valid	valid	valid	valid	valid	valid	valid	valid	valid
DGRPONLY=	valid	valid	valid	valid	valid	valid	valid	valid	valid
DTYPE=	valid	valid	valid	valid	valid	valid	valid	valid	valid	valid
DYNAMIC=		valid	valid	valid	valid	valid	valid	valid	valid
FEATURES=				valid			valid
FLASH=				valid
FORMS=		valid	valid	valid	valid	valid	valid	valid	valid
FSSNAME=					valid	valid	valid
HEADER=		valid	valid	valid	valid	valid	valid	valid	valid
JNAME=	valid	valid	valid	valid	valid	valid	valid	valid	valid	valid
JUNIT=	valid	valid	valid	valid	valid	valid	valid	valid	valid	valid
LDENS=										valid
LINELIM=		valid	valid	valid	valid	valid	valid	valid	valid
MODE=					valid	valid	valid
MODIFY=				valid			valid
NPRO=					valid		valid
NUMDEV=			valid	valid	valid		(1)	valid	valid
OPACTLOG=					valid	valid	valid
PAGELIM=		valid	valid	valid	valid	valid	valid	valid	valid
PDEFAULT=					valid	valid	valid
PDIR=										valid
PM=		valid	valid	valid	valid	valid	valid	valid	valid
RDFEAT=									valid
RECORDS=		valid	valid	valid	valid	valid	valid	valid	valid
SELECT=										valid
SETUPMSG=					valid	valid	valid
SVF=										valid
STACKER=				valid			valid
TRAIN=							valid	valid
WC=		valid	valid	valid	valid	valid	valid	valid	valid
WS=		valid	valid	valid	valid	valid	valid	valid	valid
XLATE=		valid	valid	valid	valid	valid	valid	valid	valid	valid
XTYPE=			valid	valid	valid		(1)	valid	valid
XUNIT=			valid	valid	valid		(1)	valid	valid
Note: Parm is not valid for VTAM-attached printers.

The following chart shows required and optional parameters for defining a JES3 device, execution device, or shared device. For each device type, use only the required or optional parameters. R indicates a required parameter; O indicates an optional parameter.

DEVICE statement parameters	Device type
DEVICE statement parameters	JES3	Execution	Shared
DTYPE=	R (See notes 1, 2, and 3)		R (See notes 1, 2, and 3)
DGROUP=	O (See notes 1, 2, and 3)		O (See notes 1, 2, and 3)
JNAME=	R (See note 3)		R (See note 3)
JUNIT=	R (See note 3)		R (See note 3)
XTYPE=		R	R
XUNIT=		R	R
printer or punch parameters (See note 2)	O	O	O
Note: If you code DTYPE=PRTxxxxx, or PUNxxxx, or RDRxxxx, or TAxxxxx, and the JUNIT parameter specifies a device number, you must code the XTYPE and XUNIT parameters. If you define a printer as a JES3 device and that printer is also defined on a JES3ABEND, JES3SNAP, or SYSABEND DD statement, the printer can contain interspersed output. This can happen when the JES3 task and the ABDUMP task write concurrently to the printer. IBM® recommends that a TSO userid should not have the same name as a device JNAME, JUNIT, or DGROUP value. This avoids ambiguity when routing inbound SYSOUT data sets.

The following figure lists I/O devices. For each device type name, the figure shows whether you can specify that device type in the variable field of a DTYPE subparameter.

Table 2. I/O Generic Device Type Names
Generic Device Type (model)	Can this device type name be specified in the variable field of DTYPE=?
Generic Device Type (model)	PRTxxxxx?	PUNxxxx?	RDRxxxx?	RMTxxxx?	TAxxxxx?	Notes:
1403	Yes	No	No	Yes	No
2250(3)	No	No	No	No	No
2265	No	No	No	No	No
2305(2)	No	No	No	No	No
2501	No	No	Yes	No	No
2540(1,2)	No	Yes	Yes	Yes	No
2671	No	No	No	No	No
2740	No	No	No	No	No
2955	No	No	No	No	No
3060	No	No	No	No	No
3180(1)	No	No	No	No	No	Specify as the 3278 that is being emulated.
3203	Yes	No	No	Yes	No
3211	Yes	No	No	Yes	No
3277(1,2)	No	No	No	No	No
3278 (2,2A,3,4,5)	No	No	No	No	No
3279(2,2A,2B, 2C,3A,3B)	No	No	No	No	No
3284(1,2)	No	No	No	No	No
3286(1,2)	No	No	No	No	No
3288(2)	No	No	No	No	No
3289(1,2)	No	No	No	No	No
3330	No	No	No	No	No
3330-1	No	No	No	No	No
3330V	No	No	No	No	No
3340	No	No	No	No	No
3350	No	No	No	No	No
3375	No	No	No	No	No
3380	No	No	No	No	No
3390	No	No	No	No	No
3400 (2,3,4,5, 6,7,8,9)	No	No	No	No	See Note	Specify 73400 for 7-track, 93400 for 9-track and 34009 for 3480 compatibility mode.
3422	No	No	No	No	See Note	3400 Tape.
3429	No	No	No	No	See Note	Specify TA93429.
3430	No	No	No	No	See Note	3400 Tape.
3480	No	No	No	No	See Note	Specify TA03480 or TA03480X. TA03480X defines an IBM 3480 tape subsystem with compaction.
3490	No	No	No	No	See Note	Specify TA33490.
3505	No	No	Yes	No	No
3525	No	Yes, Note 1	Yes, Note 2	No	No	Specify 3525I for a 3525 with the two-line print feature. Specify 3525M for a 3525 with the multiline print feature. 3525 is valid for RDRxxxx only if the card reader feature is installed.
3590–1	No	No	No	No	See Note	Specify TA435901 on DTYPE
3800 (1,2,3,6,8)	Yes	No	No	No	No	For a 3800 model 3 or 6, specify 38003. For a 3800 model 8, specify 38008. For all other models, specify 3800.
3812	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
3816	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
3820	Yes	No	No	No	No
3825	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
3827	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE.
3828	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE.
3835	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE.
3900	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
4224	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
4234	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE
4245	Yes	No	No	Yes	No
4248	Yes	No	No	Yes	No
5450	No	No	No	No	No
6870	No	No	No	No	No
any AFP device	Yes	No	No	No	No	Specify PRTAFP1 on DTYPE.

ALTPM=

Specifies that JES3 can schedule data sets with this process mode to this device when an operator uses a command to change the device operating mode from what you originally defined on the MODE parameter of the DEVICE statement. In other words this value is an alternate to that defined on the PM parameter. You can specify 1 to 8 alphanumeric characters for the alternate process mode. You can define a maximum of eight alternate process modes for a device.

A combined total of 255 process modes and alternate process modes can exist in one JES3 complex at one time. For more information about this parameter, see “Defining Process Modes” in z/OS JES3 Initialization and Tuning Guide.

If the device is an IBM 3800 model 3 with MODE=FSS specified (or defaulted to) on this statement, the default is LINE. If the printer is anIBM 3800 model 3 with MODE=COMP specified (or defaulted to) on this statement or a line mode printer, the default is (LINE,PAGE). The ALTPM parameter is valid only for the IBM 3800-3, 3800-6, and 3800-8 printers.

BURST=

Specifies whether you want burst (trailer) pages printed or punched. You can specify this parameter with printer and punch devices only. If you specify the SELECT parameter, JES3 ignores the BURST parameter.

YES: Indicates that you want this device to print or punch burst pages at the end of each job.
NO: Indicates that you do not want this device to print or punch burst pages.
M: Specifies that you want JES3 to mark the edges of the burst page or mark three blank pages following a job's output for ease of separation. You can modify the mark forms specification after initialization using a *CALL, *START, or *RESTART,WTR command. See z/OS JES3 Commands for information about these commands.

If you specify an invalid subparameter, JES3 uses the parameter default.

CARRIAGE=

Specifies the carriage tape or forms control buffer (FCB) associated with this device. You can specify this parameter for printers only.

NO: Specifies that the carriage tape or FCB on this printer cannot be changed during writer execution.
YES: Specifies that the carriage tape or FCB (3211, 3203, or 3800 only) can be changed during writer execution as required.
STANDARD: Specifies the standard carriage tape that you define on the OUTSERV initialization statement.
carrtape: Specifies the name (1 to 8 characters) of the carriage tape that is initially mounted on the printer or the name (1 to 4 characters) of the FCB that is to be initially loaded on the printer. If the device is a 3211, 3203, or 3800 printer, a module must be included in SYS1.IMAGELIB, having the name FCB2xxxx or FCB3xxxx, where xxxx is the 1- to 4-character name of the forms control buffer. To define or modify an FCB image for a 3211 or 3203 printer, refer to z/OS DFSMSdfp Advanced Services. To define or modify an FCB image for a 3800 printer, refer to the IEBIMAGE documentation in z/OS DFSMSdfp Utilities.

If you specify an invalid subparameter, JES3 uses the parameter default.

Note: If you are using the user exit IATUX23 and you are coding FCBs for use with JES3 defined printers that are other than 3800, then you must code a CHANNEL 12 in the FCB.

CB=

Specifies when you want JES3 to clear the device's buffer. You can specify this parameter for the IBM 3800, IBM 4245, and IBM 4248 printers only.

D

Specifies that you want the data set option used. This causes output service to clear the buffer at the end of each data set and pause shortly at the end of each data set.

J

Specifies that you want the job option used. This causes output service to clear the buffer at the end of each job and pause shortly at the end of each job.

N

Specifies that you do not want the device's buffer cleared unless required by a function. Maximum performance is obtained with CB=N. Examples of functions that require a clear printer command are:

loading new characters
requesting operator setup
waiting for work

When the device is in manual mode (M specified on *X, *R, or *S and M is specified in message IAT8562), a clear printer command is issued (to clear the buffer) before each data set and CB has no effect.

If you specify an invalid subparameter, JES3 uses the parameter default.

CHARS=

Specifies the image(s) to be set up on printers that support character sets (for example: 3800, 3816, 3820) and whether the images are allowed to be changed. For specific printer information, see the documents provided with your printer.

YES: Allows changing of images.
NO: Does not allow changing of images.
STANDARD: Specifies that the name of the image to be set up is defined on the OUTSERV initialization statement.
id1: Specifies a 1- to 4-character name of an image to be set up. You can specify up to four names.

If you do not specify the CHARS parameter for remote devices, the default is NO.

If you specify an invalid subparameter, JES3 uses the parameter default.

For information about determining which output parameter values apply during printing, see z/OS JES3 Initialization and Tuning Guide.

CHNSIZE=

Specifies the size of the RU chain to be transmitted to this SNA work station.

DS: Specifies that the entire data set is to be sent as a single chain.
nnn: Specifies the number of pages that the chain is to contain. Control characters in the data (skip to channel 1 for printers or eject for punches) delimit the page size. The value for nnn can be any number from 1-255.
(nnn,mmm): Specifies the number of pages (nnn) in the chain and the number of logical records (mmm) in each page. This form of the subparameter allows you to transmit, as a multiple chain, a data set that contains no control characters.
The value for nnn and for mmm can be any number from 1-255.

Note:

If CHNSIZE=DS is specified no output checkpoints will be taken.
If you specify nnn or (nnn,mmm), JES3 takes an output checkpoint before each chain is transmitted.
CHNSIZE specified on a //*FORMAT statement overrides this CHNSIZE specification. CHNSIZE specified on this statement overrides CHNSIZE specified on a DEVICE statement.
CHNSIZE=DS gives the best performance, but error conditions detected cannot result in a restart from the last checkpoint since checkpoints are not taken.

CKPNT=

Specifies that a checkpoint is to be taken after the specified number of records. The number specified must be between 100 and 32767.

JES3 uses a default value of 200 for punch devices. For a printer, the following chart shows the default for each printer type.

Table 3. Changing the FSSNAME Parameter during a Hot Start with Refresh
Printer Type	Default
3800	CKPNT=10000
3211	CKPNT=2000
Other Line Mode Printers	CKPNT=1000
FSS-Supported Printers	Invalid

Note: If you specify an invalid subparameter, JES3 uses the parameter default.

CKPNTPG=

Specifies that a checkpoint is to be taken after the specified number of pages. The number specified must be between 1 and 32,767, inclusive. If this parameter is specified for any printer other than one operating in FSS mode (such as a 3800 model 3), the parameter is ignored. If the 3800 model 3 is running in compatibility mode, the checkpoint value is taken from the CKPNT parameter. You can modify this checkpoint parameter after initialization using the CK parameter on a *CALL, *START, or *RESTART,WTR command. For information about using JES3 commands, see z/OS JES3 Commands.

If neither this parameter nor the CKPNTSEC parameter is coded, the default is CKPNTPG=200. If you specify an invalid subparameter, JES3 uses the parameter default.

Note: Do not code the CKPNTPG and CKPNTSEC parameters on the same DEVICE statement; they are mutually exclusive.

CKPNTSEC=

Specifies that a checkpoint is to be taken after the specified number of seconds. The number specified must be between 1 and 32,767, inclusive. If this parameter is specified for any printer other than one operating in FSS mode, the parameter is ignored. If the printer is running in compatibility mode, the checkpoint value is taken from the CKPNT parameter. You can modify this checkpoint parameter after initialization using the CK parameter on a *CALL, *START, or *RESTART,WTR command. For information about using JES3 commands, see z/OS JES3 Commands.

If neither this parameter nor the CKPNTPG parameter is coded, the default is CKPNTPG=200.

If you specify an invalid subparameter, JES3 uses the parameter default.

Note: Do not code the CKPNTPG and CKPNTSEC parameters on the same DEVICE statement; they are mutually exclusive.

COPYMARK=

Specifies that you want vertical separator lines printed on the edges of output. If this parameter is specified for any printer other than one operating in FSS mode, the parameter is ignored. If the printer is running in compatibility (COMP) mode, a vertical separator line will still be sent on a job and data set basis if you also specify HEADER=YES on this statement. These separator lines help identify the beginning and end of each job or data set in a stack of output. A change in the thickness of the copy mark indicates the beginning of a new job, data set, or multiple copies of a data set.

You can modify this COPYMARK= parameter after initialization using the CM parameter on a *CALL, *START, or *RESTART, WTR command. For information about using JES3 commands, see z/OS JES3 Commands.

N: Specifies that you do not want to use copy marks. Although JES3 continues to print a vertical line on the edges of output from IBM 3800 printers, the thickness does not vary.
J: Specifies that you want copy marks printed on a job basis. A change in the thickness of the copy mark indicates the beginning of a new job.
C: Specifies that you want copy marks printed on a data set copy basis. For multiple copies of a data set, JES3 increments the thickness of the copy mark after each copy.

DGROUP=

Specifies the 1 to 8 alphameric-character name used to combine devices by physical location. When input is received from a device in a particular DGROUP, JES3 makes an attempt to send the associated output to the same DGROUP location. This parameter is ignored when defining remote devices.

DGRPONLY=

Specifies which data sets can be scheduled to this device when destination checking is in effect (WS=D). Specifying DGRPONLY=YES limits the use of this device to only those data sets that are destined for this device group. DGRPONLY=NO specifies that this device can also process data sets that are destined for any local device.

This parameter can be useful when defining SNA-attached AFP printers. For example, JES3 considers IBM 3827 printers to be local devices, even though they may be placed at distant locations. Specifying DGRPONLY=YES for these devices prevents data sets destined for any local device from being printed at remote locations.

You can use the *MODIFY,W command to dynamically change the device group scheduling criteria. However, you must restart any jobs in the output service hold queue when you dynamically change this value. See z/OS JES3 Commands for a description of the *MODIFY,W command.

DTYPE=

Specified for a JES3 device to indicate the device type. This parameter must precede the JUNIT and SELECT parameters on a DEVICE statement. See the previous device type table for the device type names that can be specified in the variable fields (xxxx) of the subparameters.

PRTxxxxx: Identifies a locally-attached printer. Specify PRTAFP1 for AFP1 printers. An AFP1 printer can be either channel attached or non-channel attached.
PUNxxxx: Identifies a locally-attached punch.
RDRxxxx: Identifies a locally-attached reader.
RMTxxxx: Identifies a remote terminal (described by an RJPTERM or RJPWS statement). For SNA RJP printers, specify RMTPRINT. For SNA RJP punches, specify RMTPUNCH.
TAxxxxx: Identifies a tape device.
username: Indicates a device type which is associated with a user DSP.

DYNAMIC=

Specifies whether you want this device started dynamically when there is work available to print, punch, or to be sent to a remote printer or punch.

NO

Specifies that you can only start this device by calling a hot writer using the JES3 *CALL,WTR command.

NO,+

Specifies that the writer is to remain active indefinitely even when no output is available for processing.

YES

Specifies that the writer is to stop automatically when no more output is available for processing.

YES,0

Specifies that the writer is to stop automatically when no more output is available for processing.

YES,timeout

Specifies that the writer is to stop automatically after the specified period of time, timeout if there is not more output to process.

timeout

The timeout parameter controls the writer when it is stopped. This value can be specified in either minutes, hours, or days. A (+) sign specifies that the writer is to remain active indefinitely. A (0) specifies that the writer is to stop when no more output is available for processing.

nnnM: Specifies a non-zero timeout interval in minutes (up to 999 minutes)
nnnH: Specifies a non-zero timeout interval in hours (up to 999 hours)
nnnD: Specifies non-zero timeout interval in days (up to 999 days)
0: Specifies that the writer is to stop when no more output is available for processing.
+: Specifies that the writer is to remain active until an operator stops it using a JES3 *CANCEL command.

You can change the value of this parameter during system operation using the *MODIFY,W command. For information about using JES3 commands, see z/OS JES3 Commands. If you omit this parameter, JES3 uses a value of YES for all devices except those that run under the control of an output writer FSS. For FSS devices, JES3 uses a value of NO.

If the JES3 DEVICE initialization statement of your IP printway FSA specifies DYNAMIC=YES and the WS criteria includes form, JES3 will not start the FSA dynamically unless a print data set's attribute, and other attributes, match the FSA's work selection criteria.

If you specify an invalid subparameter, JES3 uses the parameter default.

FEATURES=

Specifies the features of a 3800 printer.

CGS2: Specifies that the additional character generation storage feature is installed on the printer.
SS: Specifies that the burster-trimmer-stacker is attached.

FLASH=

Specifies the forms overlay frame associated with this device. You can specify this parameter for an IBM 3800 printer only.

YES: Indicates that forms flashing is allowed to change.
NO: Indicates that forms flashing must not change.
STANDARD: Indicates that the corresponding ID in the OUTSERV initialization statement will be used in the mounting of the forms overlay frame.
name: Indicates that the 4-character name specified will be used in the mounting of the forms overlay frame.

If you specify an invalid subparameter, JES3 uses the parameter default.

FORMS=

Specified for printer and punch devices only. This parameter describes the forms associated with this device.

YES

Indicates that the forms on this printer or punch can be changed during writer execution as required.

NO

Indicates that the forms on this printer or punch cannot be changed during writer execution.

STANDARD

Indicates the standard forms defined on the OUTSERV initialization statement are to be used.

forms

Indicates the name (1 to 8 characters) of the forms that are initially mounted on this printer.

If you specify the name of the initial forms, you must first explicitly specify either YES or NO.

If you specify an invalid subparameter, JES3 uses the parameter default.

FSSNAME=

Specifies the installation-defined name of the functional subsystem (FSS) under which an AFP printer will operate. The name must match the name of an output writer FSS defined on a FSSDEF initialization statement. If you omit this parameter, the value specified for the JNAME parameter on this DEVICE statement is used.

If you specify an invalid subparameter, JES3 uses the parameter default.

Note: During a hot start with refresh, changing the FSSNAME parameter requires knowing the state of the FSS associated with the original FSSNAME parameter and the state of the FSS associated with the new FSSNAME parameter. Table 4 shows the conditions when you can consider changing the FSSNAME parameter whether it is the original or new FSSNAME.

Table 4. Changing the FSSNAME Parameter during a Hot Start with Refresh
FSS Active	FSS Inactive	FSS on Global	Global IPLed before hot start with refresh	Can FSSNAME parameter be changed?
Yes	-	Yes	Yes	Yes
Yes	-	Yes	No	No
Yes	-	No	-	No
-	Yes	-	-	Yes

HEADER=

Specified for printer and punch devices only.

NO: Indicates that this printer or punch is not to print or punch block header pages for a job or its data sets.
YES: Indicates that this printer or punch is to print or punch block header pages for each job and each data set. If the device is a 3800 model 3 printer running in compatibility (COMP) mode, a copymark is also sent along with the header pages.

Note: If you specify the SELECT parameter, JES3 ignores the HEADER parameter.

If you specify an invalid subparameter, JES3 uses the parameter default.

JNAME=

Specifies the 1- to 8-character name of a JES3 device. The first character of the name cannot be a slash (/). This name should be unique to the device and must not be the same as used for the DGROUP parameter name. JNAME is used by the operator to refer to a JES3 device. For RJP devices, the JNAME must include (1) the work station name, which is assigned by the user, and must be exactly 5 characters in length, (2) followed by PRn for a printer, PUn for a punch, and RDn for a reader. The ‘n’ can be any number from and including X'1' to X'F'. When the NUMDEV parameter is used, JNAME specifies a 1–4 character prefix. See the NUMDEV= keyword for how the actual JNAMEs for a range of devices is determined.

JUNIT=

Specifies:

The number of the device on that main or NONE if the device does not attach to that main
The name of a main to which the device is attached
Routing information for messages about the device
Whether the device is initially on-line or off-line, or not identified to the system during MVS™ initialization.

You must code the following group of subparameters for each main to which the device is attached:

/devnum or devnum or NONE

Specifies the device number (by 3-digit or 4-digit hexadecimal number). A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

ddd and dddd represent the device numbers. This must be the address to which the device is attached on the processor named main. Specify NONE if the device is not attached to that main. If a device is not channel-attached (for example, the 3820 or 3816 printer), do not code /devnum or devnum; instead, use a comma as a position holder. For remote devices, you can specify either NONE or use a comma as a position holder.

main

Specifies a processor which can use this device as a JES3 global device when that main is global. This name must be the same name as that defined in the NAME parameter on a MAINPROC initialization statement. The device must be attached to this main at the address specified by /devnum or devnum.

Alternatively, a main name of *ALL can be used. Using *ALL indicates that all processors in the complex are eligible to use this device as a JES3 global device when the processor is the global. When *ALL is used, no other group of devnum,main,msgdest,OFF|ON can be used on the JUNIT parameter of this DEVICE initialization statement, and the values specified for devnum,main,msgdest,OFF|ON are the same for all mains.

msgdest

Specifies the routing information for messages concerning this device. If you are defining this device to run under the control of an output writer FSS, do not specify the MLG or ALL destination classes for this parameter. If you specify one of these classes, the routing information defaults to routing code 42 which is the route code equivalent of JES3 Destination Class JES.

This value may be specified as a JES3 destination class or as an MVS routing code. If a routing code is used, nnn specifies a decimal number from 1 through 28, or 41 through 128. Routing codes 29 through 40 are reserved for IBM's use and will be ignored if specified.

OFF

Specifies that the initial JES3 status of this device (as a JES3 device) is offline to JES3. For an assignable device, JES3 also varies the device offline to MVS unless it is online as an execution unit.

ON

Specifies that the initial JES3 vary status of this device (as a JES3 device) is online to JES3. For an assignable device, JES3 also varies the device online to MVS.

Note: For the 3820 printer, specifying JUNIT=(/devnum or devnum... is not valid. Instead, you must use a comma as a place-holder when specifying the JUNIT parameter. This parameter cannot precede the DTYPE parameter.

LDENS=

Specifies whether the set line density command is to be sent with the set vertical format (SVF) record to the work station. If the SVF=NO parameter is specified, this parameter is ignored.

YES: Specifies that the set line density command is to be sent with the SVF record. The work station printer will print the number of lines per inch specified in the FCB image in SYS1.IMAGELIB. The number of lines will be either 6 or 8 per inch.
NO: Specifies that the set line density command is not to be sent with the SVF record. The work station printer will print 6 lines per inch.

Note: Before specifying LDENS=YES, consult the software component description for the receiving unit to determine whether the software supports the set line density command. If the software does not support this command and the command is sent, the results are unpredictable.

LINELIM=

Specifies line limits for printer or punch devices only. The LINELIM parameter is associated with the WS=L parameter on the *CALL,WTR, *START, or *RESTART operator commands or the DEVICE or OUTSERV initialization statement.) The number specified must be between 0 and 2,147,483,647, inclusive.

nnnnnnnnnn: Indicates that a data set must have this number of output lines or less to be selected for output processing.
nnnnnnnnnn+: Indicates that a data set must have this number of output lines or more to be selected for output processing.

MODE=

Specifies the mode of an FSS-controlled device.

COMP: Specifies that JES3 is to consider the printer as a line mode printer compatible with other 3800 printers. JES3 creates an FSS table entry for the printer but the printer runs under the control of a writer DSP in the JES3 global address space. This parameter is only valid for an IBM 3800 model 3 printer.
FSS: Specifies that JES3 is to consider the printer as one that runs under the control of an output writer FSS in its own address space.

For guidelines on choosing a value for this parameter, see “Running a Page Mode Printer” in z/OS JES3 Initialization and Tuning Guide.

If you specify the FSSNAME parameter on this statement, the default value for the MODE parameter is FSS. Otherwise, the default value is COMP.

If you specify an invalid subparameter, JES3 uses the parameter default.

Note: If the device is an IBM 3820 or an AFP1 printer, JES3 assumes MODE=FSS, whether explicitly coded or not.

MODIFY=

Specified for the 3800 printer only. This parameter specifies the name of the copy modification module to be used as the table reference character for this device.

YES: Specifies that copy modification module changes can be made.
NO: Specifies that copy modification module changes cannot be made.
STANDARD: Specifies that the copy modification module to be used is defined by the OUTSERV initialization statement.
name: Specifies the 1- to 4-character name of the copy modification module.
0-3: Specifies the table reference character to be used with the copy modification module.

If you specify an invalid subparameter, JES3 uses the parameter default.

NPRO=

Specifies the non-process run-out interval for a channel-attached AFP printer running in FSS mode. If you later modify the NPRO interval using an operator command, JES3 retains the change across a hot start.

nnnn: Specifies the number of seconds the printer will wait for more data before forcing out the already-printed pages. The value specified must be between 0 and 9999, inclusive.
STANDARD: Specifies that the run-out interval will be taken from the NPRO parameter on the OUTSERV statement.
NO: Specifies that the run-out interval is not to be used for this printer.

If you specify an invalid subparameter, JES3 uses the parameter default.

NUMDEV=

Specifies the number of devices to be defined by this DEVICE statement, starting with the specified JUNIT or XUNIT. For example,

If a DEVICE statement defines
```
XUNIT=(3A0,main,md,ON),NUMDEV=32
```
32 devices will be defined with XUNITs of 3A0 through 3BF on the specified main.
If DEVICE statement defined
```
JNAME=TAPE,JUNIT=(FFF,main,md,ON),NUMDEV=3
```
three JNAMES of TAPE0FFF, TAPE1000, and TAPE1001 are defined with corresponding JUNITs of FFF, 1000, and 1001 on the specified main.

The NUMDEV parameter requires at least one JUNIT or XUNIT with a device number. For example, NUMDEV is not valid on a DTYPE=SYSMAIN or a VTAM-attached FSS printer.

Note:

Referenced JNAME
If the device is a JES3 global device, the JNAME parameter specifies a prefix rather than a complete JNAME. A four digit device number is built based on the JUNIT and NUMDEV and concatenated with the prefix to form a complete JNAME. For example, if the JUNIT=3A0, the specified JNAME is TAPE, and NUMDEV=32, the statement will define 32 JNAMEs of TAPE03A0 through TAPE03BF. Because of converting JNAME this way, omitting NUMDEV for JES3 global devices is not the same as specifying NUMDEV=1.

If the JUNIT combines mains with different device numbers, for example, JUNIT=(3A0,SY1,,ON,9C0,SY2,,ON), the first specification is used to build the JNAMEs (3A0 in this case).

If the JUNIT combines mains with device numbers and NONE, for example, JUNIT=(NONE,SY1,,ON,9C0,SY2,,ON), the first group with an actual device number is used to build the JNAMEs (9C0 in this case).

Since the JUNIT part of the JNAME is padded with 0's if it is a three digit device, be careful to use the correct JNAME if you reference a JNAME on any other initialization statement (for example, FSSDEF or SYSOUT).
Duplicate XUNIT
If the use of the NUMDEV parameter causes a range of devices to generate duplicate definitions, the device that appears earlier in the initialization stream prevails and the duplicate part of the range is ignored with a warning message, but any part of the range that is not duplicate also prevails. For example, if DEVICE statement 1 defines XUNIT=205 and DEVICE statement 2 later defines XUNIT=200,NUMDEV=8, the XUNIT=204 from device statement 1 prevails and XUNIT=204 from DEVICE statement 2 is ignored with a warning message, but DEVICE statement 2 successfully defines 200 through 203 and 205 through 207. If, however, these statements were reversed, the entire NUMDEV range would prevail and XUNIT=204 would be ignored with a warning message.
Duplicate JUNIT versus XUNIT
In determining duplicates, JES3 also considers a definition duplicated if one DEVICE statement defines a device number as a JUNIT and another DEVICE statement defines the same device number as an XUNIT. In the preceding example, if DEVICE statement 1 specifies JUNIT=204 instead of XUNIT=204 this would still be considered a duplicate, even if DEVICE statement 2 specifies an XUNIT range that includes 204 but no JUNIT.
Duplicate JNAME
It is also possible for the use of the NUMDEV parameter to cause duplicate JNAMEs to be generated. In the case of duplicate JNAMEs, the same rule holds: the earlier definition prevails but any part of the range that is not duplicate also prevails.

OPACTLOG=

Specifies whether operator command actions are to be logged in the output of this device. If the parameter is not specified, JES3 will log the messages only if both, the header and trailer pages are specified on the device. The default is 'YES'.

YES: Specifies that operator command actions will be logged in the output of this device using message IAT7066 or IAT7067. This parameter is only valid for FSS devices.
NO: Specifies that operator command actions will not be logged in the output. This parameter is only valid for FSS devices.

PAGELIM=

Specifies page limits for output processing on an AFP printer. The PAGELIM parameter is associated with the WS=L parameter on the *CALL,WTR *START, or *RESTART operator commands or the DEVICE or OUTSERV initialization statement.

nnnnnn: Indicates that a data set must have this number of output pages or less to be selected for output processing on a 3820 or 3800 model 3 printer. The value specified must be an integer between 0 and 999999, inclusive.
Note: If you specify line and page limits (L) in the work selection (WS) list and set (or accept the default of) PAGELIM=0 here, JES3 will not be able to select page-mode data sets for this device.
nnnnnn+: Indicates that a data set must have this number of output pages or more to be selected for output processing on the AFP printer. The value specified must be an integer between 0 and 999999, inclusive.

If you specify an invalid subparameter, JES3 uses the parameter default.

PDEFAULT=

Specifies a subset (CHARS and FCB) of the JES3 default values that you can specify that are not applied when controlling output processed by FSS-supported printers.

CHARS and FCB values can be applied from the FSS procedure PRINTDEV statement or the application JCL by coding PDEFAULT=CHARS or PDEFAULT=FCB, in conjunction with the corresponding WS= parameter (WS=U and/or WS=C). As a result, the FSS procedure PRINTDEV values are applied to the output during FSS processing, unless explicit specifications are made in the data set JCL.

If WS=C or WS=U are not coded in conjunction with the corresponding PDEFAULT values, the current values for the device are applied. These values are a combination of JES3 defaults, JES3 DEVICE initialization values and operator command changes to the values.

For additional details, refer to the scheduling output information in z/OS JES3 Initialization and Tuning Guide

CHARS: Indicates that JES3 will not supply default CHARS and UCS to the FSS for output that does not specifically request a CHARS or UCS value. Use this parameter with WS=U to apply values from PRINTDEV or JCL.
FCB: Indicates that JES3 will not supply default FCB or carriage tape to the FSS for output that does not specifically request an FCB or carriage tape value. Use this parameter with WS=C to apply values from PRINTDEV or JCL.
NONE: Indicates that the FSS will use all the JES3 default characteristics. If you specify an invalid subparameter, JES3 uses the parameter default.

The following overrides apply to the PDEFAULT parameter:

If WS=U/C and PDEFAULT=CHARS/FCB are coded together, the following override hierarchy applies:
1. JCL values apply, if coded.
2. PRINTDEV device values apply if no JCL values are used.
If WS=U/C is coded and PDEFAULT=CHARS/FCB is not coded, the following override hierarchy applies:
1. JCL values apply, if coded.
2. JES3 Data Set Defaults apply if no JCL values are used. Because WS= selection is in effect, the data set characteristics must match the current device set up.
If WS=U/C is not coded and PDEFAULT=CHARS/FCB is coded, the override hierarchy is: Current JES3 device values apply.
If neither WS=U/C nor PDEFAULT=CHARS/FCB are coded, the override hierarchy is: Current JES3 device values apply.

Table 5 lists the PDEFAULT override rules. Note that for the output to be selected, the final character set must match the character set on the device, with the exception of rule A.2:

Table 5. PDEFAULT override rules
JCL CHARS=	WC=	PDEFAULT=	OUTSERV=	DEVICE=	PRINTDEV=	Source of Passed Parm	Rule
GT15	U	CHARS	GS10	GT15	GT10	GT15 - JCL	A.1
	U	CHARS	GS10		GT10	GT10 - PRINTDEV	A.2
GT15	U		GS10	GT15	GT10	GT15 - JCL	B.1
	U		GS10	GS10	GT10	GS10 - JES3 Dev Value*	B.2
GT15		CHARS	GS10	GT12	GT10	GT12 - JES3 Dev Value*	C
GT15			GS10	GT15	GT10	GT12 - JES3 Dev Value*	D
* The current device value, from DEVICE= or operator commands.

PDIR=

Specifies at what point(s) a peripheral data set information record (PDIR) is to be sent with a job.

ALL: Specifies that a PDIR is to precede every data set in a job.
BDS: Specifies that a PDIR is to be sent at the beginning of the job, when JES3 sends the begin destination select (BDS) command. If you specify this parameter but the setup characteristics or copy count change between data sets, JES3 sends a PDIR between those data sets.

PM=

Specifies that data sets with this process mode may be scheduled to this device when the device is in the operating mode that is specified on the MODE parameter. The process mode is 1 to 8 alphanumeric characters. A maximum of eight process modes may be defined for a particular device. You can modify a data set's process mode after initialization using the MODIFY,U,Q=WTR command. For information about using JES3 commands, see z/OS JES3 Commands . For more information about this parameter, see “Defining Process Modes” in z/OS JES3 Initialization and Tuning Guide .

JES3 uses the following defaults for this parameter:

LINE for all line mode printers.
(LINE,PAGE) for all printers that must run under control of an output writer FSS or a 3800 model 3 printer that you are running in FSS mode (MODE=FSS on the DEVICE statement).
LINE for a 3800 model 3 printer that you are running in compatibility mode (MODE=COMP on the DEVICE statement).

If you specify an invalid subparameter, JES3 uses the parameter default.

RDFEAT=

Indicates whether the 3525 card punch has the card read feature.

Y: indicates that the 3525 has the card read feature.
N: indicates that the 3525 does not have the card read feature.

Note: If you use this parameter, code it after coding the DTYPE parameter.

RECORDS=

Specified for printer or punch devices only.

nnn: Indicates the number of records (from 1 to 255) be read from the spool data set at one time by JES3 output service. The record referred to is a JES3 spool record whose size is specified by the BUFSIZE parameter of the BUFFER initialization statement.
If a RECORDS parameter is specified on more than one DEVICE initialization statement, JES3 selects the largest value to determine the number of records JES3 writes to spool sequentially.

JES3 uses the following default values.

For a 3800, RECORDS=n, where
```
    n=(16K + (BUFSIZE/4))/BUFSIZE
```
For a 3211, RECORDS=2.
For all other devices, RECORDS=1.

SELECT=

Specifies that this statement defines a basic exchange device or an exchange device. The device must be attached to the SNA work station that is named in the first five characters of the JNAME parameter. The last three characters of the JNAME parameter must specify a printer. If you code the SELECT parameter, code it after coding the DTYPE parameter.

BEn

A basic exchange device is attached to the work station. Valid values for n are 1 to 9.

EXn

An exchange device is attached to the work station. Valid values for n are 1 to 9.

LEN=

Specifies the record length to be used for the exchange or basic exchange device.

For basic exchange devices, the valid range is 1 to 128 and the LEN= subparameter is required.

For exchange devices, the valid range is 1 to 255 and the default value is 132.

EDS=

For data sets on the device's diskette, specifies whether JES3 is to separate data sets with unlike print requirements (this means unlike carriage control characters, forms control buffers, or forms).

Note: If the SELECT parameter is specified, the HEADER and BURST parameters on this statement are ignored and no header, or burst is used.

When specifying the SELECT=BEn parameter for two devices, the SELECT parameter can be the same on the two DEVICE statements for those devices. However, the LEN parameters cannot be the same because unpredictable results can occur: For example, the following is the correct way to indicate this in the initialization stream:

DEVICE,DTYPE=RMTPRINT,JNAME=WS000PR1,SELECT=BE2,LEN=1
DEVICE,DTYPE=RMTPRINT,JNAME=WS000PR1,SELECT=BE2,LEN=2

When SELECT=EXn is specified, you cannot define more exchange devices than there are physical disks available to support them.

If you specify the EDS parameter for a device that is not a SNA RJP device or for a device that uses Peripheral Data Set Information Record (PDIR) support, JES3 ignores the parameter.

SETUPMSG=

Specifies that the installation wants to suppress writer setup message IAT7030 for FSS-supported devices. This is determined based on the characteristics of the device.

YES: Indicates that the writer setup action message is displayed for the specified device. This is the default.
NO: Indicates the writer setup action message is not displayed for the specified device.

This keyword applies only to FSS-supported devices. If it is specified for a non-FSS-supported device, warning message IAT3243 is issued and the keyword is ignored.

STACKER=

Specified for 3800 printer only. This parameter describes the output stacking of the device. If the SS subparameter of the FEATURES parameter is not specified, STACKER=(NO,C) is forced.

YES: Indicates that changing of output stacking is permitted.
NO: Indicates that changing of output stacking is not permitted.
STANDARD: Specifies that stacking is to be as specified on the OUTSERV initialization statement.
S: Specifies that output is to be placed in the sheet stacker, where offset stacking is performed.
C: Specifies that output is to be placed in the continuous forms stacker.

If you specify an invalid subparameter, JES3 uses the parameter default.

SVF=

Specifies that the set vertical format record (FCB load) is not to be sent to this work station. If the device is defined as basic exchange, the set vertical format record is not sent even if SVF=NO is omitted. For all other SNARJP work stations, omitting SVF=NO causes SNARJP to send an SVF record to the workstation NO is the only valid SVF value; any other value will be ignored and the device is defined as if the parameter was omitted.

TRAIN=

Specified for printer devices or the 3525/3525M/3525I punch with print feature only.

YES: Indicates that the initial print train or print band on this device can be changed during writer execution as required. JES3 does not provide UCS buffer loading to remote printers. However, the user may change trains or bands on a remote printer but must provide the UCS buffer loader as applicable to the type of work station.
NO: Indicates that the print train or print band on this printer cannot be changed during writer execution.
STANDARD: Indicates that the print train or print band specified on the OUTSERV initialization statement will be used. Do not specify STANDARD if TRAIN=ANY is specified on the OUTSERV initialization statement.
train: Indicates the name of the print train or print band that is mounted on this device at JES3 initialization. This field can be any valid name as specified in SYS1.IMAGELIB.
If a user-created print train or band image is specified in this subparameter and XLATE=YES is specified on the same DEVICE statement, the user-created print train or band image must be included in SYS1.IMAGELIB and the user must supply a translate table member named IATWxx in SYS1.JES3LIB. The variable xx is the name of the print train or print band as specified in the TRAIN parameter of this statement or of the OUTSERV statement.

Note: If you do not specify the TRAIN parameter for remote devices, the default is NO.

If you specify an invalid subparameter, JES3 uses the parameter default.

WC=

(c,...): Specifies writer classes. This parameter indicates SYSOUT classes in the order they are processed by the output service writers for this device. Data sets for a class not specified will not be selected. The value of c specifies a valid SYSOUT class (A-Z, 0-9) that appears as a SYSOUT parameter on a DD statement. If a list of classes is specified, separate each class by a comma.
STANDARD: Specifies that the values on the WC parameter of the OUTSERV initialization statement will be assumed.

If you specify an invalid subparameter, JES3 uses the parameter default.

WS=

(c,...) D,T,F,C,U,FL,CM,SS,CL,L,P,PM

Specifies the writer selection criteria. The value of c indicates the items JES3 output service checks, in order of importance, when selecting a data set for output processing on this device. (These WS parameter values remain in effect over a hot start.)

Specify the selections in order of importance and separate specifications with a comma.

Selection Character: Meaning
C: Carriage tape or FCB
CL: SYSOUT class
CM: Copy modification
D: Data set destination
F: Forms requested
FL: Flash
L: Limit scheduling (line, page or record)
SS: Stacker
P: Data set priority
PM: Processing mode
T: Specific device type requested
U: Character arrangement table name (CHARS) or Train image (UCS).

For additional information about the influence of JCL parameters on the settings for WS=, see Work Selection for JES3.

STANDARD

Specifies that the values on the WS parameter of the OUTSERV initialization statement will be assumed.

If you specify an invalid subparameter, JES3 uses the parameter default.

Attention: JES3 does not take any action (such as issue mount messages or load FCB and UCS) if you omit printer and punch setup characteristics on this parameter. For example, a job that requires special forms may print on the wrong form if you omit forms as a selection criterion.

Note: If you specify (or accept the default of) PAGELIM=0 and specify L in the WS list here, JES3 will not be able to select page-mode data sets for this device.

XLATE=

Specified for printer or punch devices only, to indicate whether JES3 translates unprintable characters in output lines into blanks.

YES: Indicates that you want JES3 to translate unprintable characters into blanks.
NO: Indicates that you do not want JES3 to translate unprintable characters into blanks.

When defining IBM 3211, IBM 4245, or IBM 4248 devices, JES3 uses a default value of XLATE=NO if you omit the XLATE parameter or specify an invalid subparameter. These device types do not require JES3 translation since the translation of unprintable characters is performed by the device itself. Specifying XLATE=YES for these devices can cause unnecessary device setup processing, which can interrupt the flow of data to the device.

XTYPE=

Specifies the characteristics of the JES3-managed or jointly managed device as it is used by jobs in execution. It must precede the XUNIT parameter, which is required if XTYPE is specified.

name: Specifies a 1- to 8-character name that defines a device that can be referenced. It should match the name specified in the XTYPE parameter on a SETNAME initialization statement.
CA: Specifies that the device is cartridge tape.
TA: Specifies that the device is reel tape.
GR: Specifies that the device is graphic.
DA: Specifies that the device is direct access.
UR: Specifies that the device is unit record.
RM: Specifies that the device will contain removable volumes whose mounting is to be controlled by MDS.
PR: Specifies that the device will contain MVS permanently resident volumes.

Note: Devices within a specific XTYPE should have compatible characteristics. For a SNA-attached AFP printer, XTYPE is not a valid parameter.

XUNIT=

Specifies the characteristics of a device attached to one or more mains. If a device is shared between two or more mains, all four subparameters are specified for each main to which the device is attached. If a device is shared between channels of the same main, the SYSGEN primary address should be the only subparameter indicated.

/devnum or devnum

Specifies the device number (by 3-digit or 4-digit hexadecimal number) of the device attached to the main. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

ddd and dddd represent the device numbers.

main

Specifies the processor to which the device is attached. This name must be the same as that defined in the NAME parameter on the MAINPROC initialization statement.

Alternatively, a main name of *ALL can be used. Using *ALL indicates that the device is attached to all processors in the complex. When *ALL is used, no other group of devnum,main,msgdest,OFF|ON can be used on the XUNIT parameter of this DEVICE initialization statement, and the values specified for devnum,main,msgdest,OFF|ON are the same for all mains.

msgdest

Specifies the routing information for all JES3 and MVS device-related messages concerning this device. If you do not specify any routing information, the SETUP parameter on the STANDARDS statement determines the default value that JES3 uses:

If you specify SETUP=NONE, JES3 uses routing code 97 which is the routing code equivalent of destination class S1.
If you specify any other value for SETUP or omit SETUP, JES3 uses the value specified for the MDSLOG parameter on the SETPARAM statement.

This value may be specified as a JES3 destination class or as an MVS routing code. If a routing code is used, specify a decimal number from 1 through 28, or 41 through 128. Routing codes 29 through 40 are reserved for IBM's use and will be ignored if specified.

ON|OFF

ON and OFF specify whether the device is to be online or offline (as an execution device) to JES3 and to MVS when it is initialized. Specifying OFF does not affect the MVS online or offline status of devices defined to MVS as permanently resident.

Note: The XTYPE parameter must precede the XUNIT parameter if you specify both. Do not specify the XUNIT parameter for a SNA-attached AFP printer.