OPTU Key Definitions

The suggested defaults listed in the following table may be used when the OPTU is not contained in the OPTB.

Table 1. OPTU Key Definition Table
Key	Maximum Count	Length Range	External Keyword	Data Values Allowed and Description
0001	1	1	Reserved	Reserved - private JES2/JES3.
0002	4	4	Font	Set and ready by AS/400, JES2, and JES3.
0003	1	2	CKPTLINE	Binary: range 0-32767. Maximum number of lines contained in a logical page. This value is used to determine when to take checkpoints for printed output or SNA data sets. Installation defaults may be used. (Not supported by VM or AS/400.)
0004	1	2	CKPTPAGE	Binary: range 1-32767. Number of logical pages to be printed or transmitted before the next output data set checkpoint is taken. This value represents the number of pages transmitted as a single SNA chain to an SNA work station. (Not supported by AS/400.)
0005	1	2	CKPTSEC	Binary: range 1-32767. Number of seconds that may elapse between printer checkpoints. Installation defaults may be used. (Not supported by VM or AS/400.)
0006	1	1	Reserved	Reserved - private JES2/JES3.
0007	1	8	COMPACT	Symbolic name from 1-8 alphameric characters long, used to determine the compaction table when sending the SYSOUT data set described by this control statement to an SNA remote terminal. This specification overrides any remote device-defined compaction table. Installation defaults may be used. (Not supported by VM or AS/400.)
0008	1	1	CONTROL	X‘80’ - Force single space. X‘40’ - Force double space. X‘20’ - Force triple space. X‘10’ - Use first character in line as CC. Installation defaults may be used. (Not supported by VM.)
0009	1	1	Copies	Set and read by AS/400, JES2, and JES3 for the number of copies to print.
000A	8	1	Reserved	Reserved - private JES2/JES3.
000B	8	1	Reserved	Not used at output nodes.
000C	1	17	Reserved	Reserved - private JES2/JES3.
000D	1	4	Reserved	Reserved - private JES2/JES3.
000E	1	4	Reserved	Reserved - private JES2/JES3.
000F	1	1	Reserved	Reserved - private JES2/JES3.
0010	1	8 for JES2/JES3 10 for AS/400	FORM	Set and Read by AS/400, JES2, and JES3. AS/400 uses the system default of the *STD type if the value of the first parameter is 0.
0011	1	8	Reserved	Reserved - private JES2/JES3.
0012	1	1	INDEX	Binary: range 1-31. Indicates the data set indexing print position offset (to the right) for the 3211 printer. (Not supported by VM or AS/400.)
0013	1	1	Reserved	Not used at output nodes.
0014	1	1	LINDEX	Binary: range 1-31. Indicates the data set indexing print position offset (to the left) for the 3211 printer. (Not supported by VM or AS/400.)
0015	1	1	Reserved	Reserved - private JES2/JES3.
0016	1	4	Reserved	Reserved - private JES2/JES3.
0017	1	1	Reserved	Reserved - private JES2/JES3.
0018	1	8 for JES2/JES3 16 for AS/400	PRMODE	Set and read by AS/400 and JES3 for the data stream type. Possible values for AS/400: ‘SCS’ - Standard Character String with no SOSI processing ‘SCS1’ - SCS with SOSI1 processing ‘SCS2’ - SCS with SOSI2 processing ‘SCS3’ - SCS with SOSI3 processing ‘IPDS’ - IPDS (intelligent printer d s) with no SOSI processing ‘AFPDS’ - AFPDS (advanced function printing d s) with no SOSI processing ‘LINE’ - LINE with no SOSI processing ‘SOSI1’ - LINE or PAGE with SOSI processing ‘SOSI2’ - LINE or PAGE with SOSI2 processing ‘SOSI3’ - LINE or PAGE with SOSI3 processing ‘PAGE’ - PAGE with no SOSI processing ‘ASCII’ - USERASCH with NO SOSI processing ‘ASCIICS’ - SCS ASCII with no SOSI processing
0019	1	1	PRTY	Binary: range 0-255 (255 is hishest priority.) Represents the priority of the output data set for output queuing. (Not supported by VM.) AS/400 print file priority ranges from 1 to 9 with 1 representing the highest priority. AS/400 sets this field by converting the AS/400 print file priority to the PRTY value through the algorithm: (X=AS/400 print file priority) PRTY keyword value=(9-X)31 AS/400* reads this field by converting the PRTY value to the AS/400 print file priority through the algorithm: (X=AS/400 print file priority) If X < 248, then AS/400 priority=9-(x/31) Else, If X > = 248, then AS/400 priority=9-(248/31)
001A	1	1	TRC	AS/400, JES2, and JES3 read and set this field for table reference characters. In AS/400: X'80'-No TRC exists. X'40'-TRC exists.
001B	1	4	Reserved	Reserved - private JES2/JES3.
001C	1	8	WRITER	1-8 character name (consisting of any combination of alphamerics, #, @, or $) of an installation-written program in the system library that is to write the output data set. (Not supported by VM.)
001D	1	1-6 1-8 for AS/400	FORMDEF	Specifies the 1-6 character (A-Z, 0-9, #, @, or $) member name of the installation's form definition library that contains information which the page-mode printer uses to print a data set. The first two characters of the member name are pre-defined IBM standards and prefixed to the name specified here. The members can contain the following information: Overlays to be invoked during output processing. Location on the page where the overlays are placed. Suppression to be activated for specified page formats. AS/400 reads and sets this field if the FORMDEF mane for the spooled file on the AS/400 begins with ‘F1’.
001E	-	-	Reserved	Reserved for IBM's use.
001F	1	1-6 1-8 for AS/400	PAGEDEF	Specified to the 1-6 character (A-Z, 0-9, #, @, or $) member name of the installation's page definition library that contains information which the page-mode printer uses to print a data set. The first two characters of the member name are pre-defined by IBM standards and prefixed to the name specified here. The members can contain the following information: Logical page size and width. Desired fonts and page segments. Definition of multiple page types or formats. Definition of lines within a page (for example, line origin, carriage controls, spacing, fonts, and suppression control). Definition of multiple logical pages on a physical page and line-skipping instructions. AS/400 reads and sets this field if the PAGEDEF name for the spooled file on the AS/400 begins with ‘P1’.
0020	-	-	Reserved	Reserved for IBM's use.
0021	2	1-3	PIMSG	Mixed data format. Level of printing system-generated messages by a functional subsystem. See PIMSG for details. (Not supported by AS/400)
0022	1	4	THRESHLD	Binary: range 1-9999999. The maximum size for the SYSOUT data set before a new unit of work is created on a data set boundary. The size is based on the number of records multiplied by the number of copies. (Not supported by JES2, VM, or VSE.)
0023	1	1	DPAGELBL	Binary: range X'40' - X'80' Specifies whether or not data pages are labeled with the security label associated with the data set. X'40' - (YES) Specifies that security labels are to be printed. X'80' - (NO) Specifies that security labels are not to be printed (the application may generate its own security labels). (Not supported by VM or AS/400.)
0024	1	1	SYSAREA	Binary: range X'40' - X'80' Specifies whether a System Defined User Printable Area (UPA) is to be in effect when printing output. The System Defined UPA is a subset of the physical page and only Security Overlays (used for B1 security labeling) can print outside of it. X'40' - (YES) Specifies that the System Defined UPA is in effect for printed output. X'80' - (NO) Specifies that the System Defined UPA is not in effect for printed output.
0025	-	-	Reserved	Reserved for IBM's use.
0026	1	0-60	ROOM	EBCDIC text characters. Specifies the room identification to be associated with the SYSOUT for use by the installation. (Not supported by AS/400.)
0027	4	0-60	ADDRESS	EBCDIC text characters. Specifies the delivery address for SYSOUT. (Not supported by AS/400.)
0028	1	0-60	BUILDING	EBCDIC text characters. Specifies the building location associated with the SYSOUT. (Not supported by AS/400.)
0029	1	0-60	DEPT	EBCDIC text characters. Specifies the department associated with the SYSOUT for use by the installation to assist in distributing SYSOUT. (Not supported by VM, VSE, or AS/400.)
002A	1	0-60	TITLE	EBCDIC text characters. Specifies a description of the SYSOUT that can be placed on separator pages by the installation. (Not supported by VM, VSE, or AS/400.)
002B	1	1	OUTDISP	JES2 sets and uses this field. The second byte is not relevant once SYSOUT is created and transmitted. You can set the bytes to the following values: X‘80’ - WRITE - Output is processed and purged. X‘40’ - HOLD - Hold until released; goes to WRITE. X‘20’ - KEEP - Output is processed and held. X‘10’ - LEAVE - Hold until released; goes to KEEP. X‘08’ - PURGE - Output deleted without processing.
002C	1	1	AOUTDISP	This option specifies the abnormal output disposition. You can set the bytes to the following values: X‘80’ - WRITE - Output is processed and purged. X‘40’ - HOLD - Hold until released; goes to WRITE. X‘20’ - KEEP - Output is processed and held. X‘10’ - LEAVE - Hold until released; goes to KEEP. X‘08’ - PURGE - Output deleted without processing.
002D	1	0-60	NAME	EBCDIC text characters. Specifies the preferred name to be associated with the SYSOUT for use by the installation. (Not supported by AS/400.)
002E	1	0-60	USERLIB	EBCDIC text characters. Specifies the libraries containing the Advanced Function Printer (AFP) resources that PSF uses when processing data sets. (Not supported by VM or AS/400.)
002F	1	0-60	NOTIFY	EBCDIC text characters. Specifies the user(s) to be identified by PSF when the output has finished printing. (Not supported by VM, VSE, or AS/400.)
0030	-	2	PAGERANGE	Specifies the range of pages to print this file. Odd numbered pages are always starting pages. If the parameter length is zero, the starting page is the first page of the document. An ‘-1’ tells the system to use the ending page value in the next parameter as the starting page. Even numbered pages are always ending pages. If the parameter length is zero, the ending page is the last page of the document. No special values exist for the ending page. (Only supported by AS/400.)
0031	16	1-60	USERDATA	Specifies the installation specific feature for which it has been defined. If you specify two or more values, they must be enclosed by parentheses. If your installation does not define a use for this keyword, the information is syntax checked, stored as part of the output descriptor's information, and ignored.
0032 to 200A	-	-	Reserved	Reserved for IBM's use.
200B	2	1-41	FILEID	This option specifies where the file to be printed or associated resource files can be found. A print file can be either line or page mode records. Page mode data sets must have each record preceded by X'5A'. See FILEID for syntax details. AS/400 only reads this field. (Not supported by MVS.)
200C 2019	-	-	Reserved	Reserved for IBM's use.
201A	1	1	BIN	Binary: range 1-2. Specifies the media bin from which sheets are fed for printing as follows: 1 - indicates that all sheets are to be fed from the primary input source. 2 - indicates that all sheets are fed from an alternate input source. Overrides the value in the active FORMDEF. AS/400 reads and sets this field. (Not supported by MVS or VSE.)
201B	1	1	DUPLEX	Binary: range X'00'-X'02' Specifies whether printing is to be done in simplex or duplex mode. This parameter overrides the value in the active FORMDEF and applies during the printing of the entire print data set. X'00' - (NODUPLEX) Specifies standard simplex printing; printing will occur on only one side of the physical page. X'01' - (DUPLEX) Specifies that printing is to occur on both sides of the physical page. This permits the print data set to be bound on its side. X'02' - (DUPLEX TUMBLE) Specifies that printing will occur on both sides of the physical page such that the top of the back side is oriented with the bottom of the front side. Tumble duplexing permits the print data set to be bound at the top. AS/400 sets and reads this field. (Not supported by MVS or VSE.)
201C	1	1	OPTIMIZE	Binary: range X'00'-X'02' Specifies whether resource (page segments, fonts, etc.) loading is to be optimized to determine the best time to load resources into the printer. This will improve the performance of the loading and printer processes at the cost of more storage and the CPU used during the optimization analysis. X'00' - (NOOPTIMIZE) Indicates that resources are to be loaded into the printer on a page-by-page basis. X'01' - (OPTIMIZE) Specifies that all possible resources are to be loaded prior to the printing of the data set. X'02' = (OPTIMIZE FONTS) Specifies, that in addition to resource optimization, only those characters of a font that are referenced in the data set are loaded in the printer. This option is not defined for double-byte fonts. The optimization function is not defined for line-mode or mixed-mode data sets. (Not supported by MVS, VSE, or AS/400.)
201D	1	1	VERIFY	Binary: range X'00'-X'01' Specifies that the data stream contained in the data set be syntax checked at the destination. 0=NO, 1=YES. For example, each AFPDS structured fields are checked for fields containing values within ranges, reserved fields not used, mandatory values being correct, etc. (Not supported by MVS, VSE, or AS/400.)
201E	4		TRACE	Mixed Format. Allows for the tracing of the internal operation of the print server as a particular spool file is being processed. See TRACE for additional details. (Not supported by MVS, VSE, or AS/400.)
201F	32	2	SHEETS	Binary: range 1-32767 This option overrides a FORMDEF specification and will cause only the sheets specified to be printed. A sheet represents the physical page, not the logical page. The numbering begins with the first sheet (sheet 1) and may or may not have a relationship with the page number printed on the pages. The sheet numbers are specified in begin/end pairs. Each number and each range must be listed in ascending order from left to right. (Not supported by MVS, VSE, or AS/400.)
2020	3	1-8	DUMP	Mixed format. Allows for the DUMPing of the internal operation of the printing subsystem (e.g., Print Services Facility™). See DUMP for additional details. (Not supported by MVS, VSE, or AS/400.)
2021	-	-	Reserved	Reserved for IBM's use.
2022	1	1	DATACK	Binary: range X'00' - X'82' This option specifies whether the printer will block print-positioning and invalid-character errors. The term "block" means the printer will not return error messages to PSF, even if data is lost. X'00' - (BLOCK) Specifies that the printer will block (not report) print-positioning and invalid-character errors. X'80' - (UNBLOCK) Specifies that the printer will not block (will report) both print- positioning and invalid-character errors. X'81' - (BLKCHAR) Specifies that the printer will block invalid-character errors. The printer will report print-positioning errors. X'82' - (BLKPOS) Specifies that the printer will block print-positioning errors. The printer will report invalid-character errors. AS/400 sets and reads this field. (Not supported by VSE.)
2023 to 3EFF	-	-	Reserved	Reserved for IBM's use.
3F00	1	1-128	CICSDATA	Character: alphameric and national. A sequence of from 1 to 128 bytes passed by the CICS® application that created the output request. This data is then associated with the output data set within the spool subsystems. Mapped by CICS. (Not supported by MVS, VM, or AS/400.)
3F01 to 3FFF	-	-	Reserved	Not used in NJE.
4000	1	10	AS4NAM	1-10 EBCDIC text characters. User's name for a file. Reserved - private AS/400.
4001	1	2	AS4DLN	Binary: 4079\|512 Spool database record length. Reserved - private AS/400.
4002	1	6	AS4DR	1-6 EBCDIC text characters. Special device requirements. Reserved - private AS/400.
4003	1	2	AS4MFW	Binary Maximum printer file forms width. Reserved - private AS/400.
4004	1	2	AS4LN1	Binary Output record length 1. Reserved - private AS/400.
4005	1	2	AS4SEP	Binary: 0-9 Number of file separators. Reserved - private AS/400.
4006	1	4	AS4MRC	Binary Maximum number of records allowed. Reserved - private AS/400.
4007	1	20	AS4FIL	1-20 EBCDIC text characters. Qualified print file name. Reserved - private AS/400.
4008	1	6	AS4BIT	1-6 EBCDIC text characters. OS/400® Network flags. Reserved - private AS/400.
4009	1	15	AS4ACC	1-15 EBCDIC text characters. Job accounting code. Reserved - private AS/400.
400A	1	8	AS4TKN	1-8 EBCDIC text characters. Token for graphics file. Reserved - private AS/400.
400B	1	30	AS4SEC	1-30 EBCDIC text characters. Security classification text. Reserved - private AS/400.
400C	1	3	AS4DIW	4.2 packed numeric. Width of drawer 1. Reserved - private AS/400.
400D	1	3	AS4DW2	4.2 packed numeric. Height of drawer 1. Reserved - private AS/400.
400E	1	3	AS4D2W	4.2 packed numeric. Width of drawer 2. Reserved - private AS/400.
400F	1	3	AS4D2H	4.2 packed numeric. Height of drawer 2. Reserved - private AS/400.
4010	1	8	AS436T	1-8 EBCDIC text character Time of Day (TOD) file is opened. Reserved - private AS/400.
4011	1	10	AS4UDT	1-10 EBCDIC text character User-supplied data. Reserved - private AS/400.
4012	1	12	AS4DOC	1-12 EBCDIC text character Document name. Reserved - private AS/400.
4013	1	64	AS4FDR	1-64 EBCDIC text character Folder name. Reserved - private AS/400.
4014	1	20	AS4PGM	1-20 EBCDIC text character Qualified program name. Reserved - private AS/400.
4015	1	8	AS4PRC	1-8 EBCDIC text character S/36 procedure name. Reserved - private AS/400.
4016	1	2	AS4AFW	Binary Alternate forms width Reserved - private AS/400.
4017	1	2	AS4AFL	Binary Alternate forms length Reserved - private AS/400.
4018	1	2	AS4AL1	Binary Alternate lines per inch in 1440's of an inch Reserved - private AS/400.
4019	1	3	AS4DEL	1-3 EBCDIC text characters of YINIAIC A=absolute fidelity C=content fidelity Print Spool Facility (PSF) defined. Reserved - private AS/400.
401A	1	2	AS4PR1	Binary Primary record length Reserved - private AS/400.
401B	1	2	AS4PFL	Binary Forms length in lines Reserved - private AS/400.
401C	1	2	AS4PFW	Binary Forms width in characters Reserved - private AS/400.
401D	1	2	AS4PLI	Binary ‘0003’X - 3.0 LPI ‘0004’X - 4.0 LPI ‘0006’X - 6.0 LPI ‘004B’X - 7.5 LPI ‘0008’X - 8.0 LPI ‘0009’X - 9.0 LPI Lines per inch Reserved - private AS/400.
401E	1	2	AS4POF	Binary 1-255 Overflow line number. Reserved - private AS/400.
401F	1	1	AS4PAL	Binary ‘00’X - Do not Align Form ‘80’X - Align Form Aligning Form Reserved - private AS/400.
4020	1	1	AS4PFT	Binary ‘00’X - Truncate ‘80’X - Fold Fold or Truncate Reserved - private AS/400.
4021	1	2	AS4PUP	1-2 EBCDIC characters Unprintable character substitution Reserved - private AS/400.
4022	1	2	AS4CPI	Binary ‘0005’X - 5.0 CPI ‘000A’X - 10.0 CPI ‘000C’X - 12.0 CPI ‘000F’X - 15.0 CPI ‘0085’X - 13.3 CPI ‘00A7’X - 16.7 CPI ‘0012’X - 18.0 CPI ‘0014’X - 20.0 CPI Characters per inch Reserved - private AS/400.
4023	1	13	AS4FT	1132 EBCDIC characters Font identifier Note: If specified, the valid range for the number of parameters is 0-1. If zero is specified, use *DEVD for the font and point size. Reserved - private AS/400.
4024	1	1	AS4QLT	1 EBCDIC character ‘00’X - Standard ‘01’X - Draft ‘02’X - Near letter quality ‘03’X - Use device default Print quality value Reserved - private AS/400.
4025	1	1	AS4FFA	1 EBCDIC character ‘00’X - Use divide default ‘01’X - Use continuous forms ‘02’X - Use manual cut sheet mode ‘03’X - Use automatic cut sheet mode Form feed attachment Reserved - private AS/400.
4026	1	2	AS4DWR	Binary ‘0001’X - Use drawer 1 ‘0002’X - Use drawer 2 ‘0003’X - Use enveloper drawer 1 ‘0013’X - Use drawer 3 ‘00FF’X - Use value in the FORMDF Drawer value Reserved - private AS/400.
4027	1	2	AS4TXT	1-2 EBCDIC characters Text utility flags Reserved - private AS/400.
4028	1	1	AS4DTA	1 EBCDIC character File contains DBCS data Reserved - private AS/400.
4029	1	1	AS4EXN	1 binary number ‘00’X - Do not use DBCS extension characters ‘80’X - Use DBCS extension characters Use of DBCS extension characters Reserved - private AS/400.
402A	1	1	AS4KCP	1 EBCDIC character ‘00’X - Print at half of CPI. ‘01’X - 6.7 DBCS CPI. ‘05’X - 5.0 DBCS CPI. ‘06’X - 6.0 DBCS CPI. ‘0A’X - 10.0 DBCS CPI. DBCS characters per inch Reserved - private AS/400.
402B	1	1	AS4RRT	1 binary number ‘00’X - Do not rotate DBCS characters ‘80’X - Rotate DBCS characters Rotate DBCS characters Reserved - private AS/400.
402C	1	4	AS4CHI	1 EBCDIC text character Character set and code page ID Reserved - private AS/400.
402D	1	2	AS4PRG	2 binary numbers ‘0000’X - Printer default ‘FFFF’X - Perform computer output reduction ‘FFFE’X - Automatic computer output reduction ‘0168’X - Rotate 0 degrees ‘005A’X - Rotate 90 degrees ‘00B4’X - Rotate 180 degrees ‘010E’X - Rotate 270 degrees Page rotate Reserved - private AS/400.
402E	1	2	AS4JFY	2 binary numbers ‘0000’X - No justification ‘0032’X - 50% justification ‘0064’X - 100% justification Justification Reserved - private AS/400.
402F	48	16	AS4FE	1-16 EBCDIC text characters Font equivalence table Reserved - private AS/400.
4030	1	20	AS4FDN	1-20 EBCDIC text characters Qualified form definition name Reserved - private AS/400.
4031	1	9	AS4RST	1-9 EBCDIC text character 0 - Use the starting page in the page range. -1 - Use the ending page in the page range. -3 - Use the next page after the last page printed. Restart Reserved - private AS/400.
4032	1	2	AS4MUL	2 binary numbers 0 - Print 1 page per side. 2 - Print 2 pages per side. 4 - Print 4 pages per side. Multiup Reserved - private AS/400.
4033	1	1	AS4UOM	1 EBCDIC text character ‘00’X - Inches ‘00’X - Centimeters Unit of measure Reserved - private AS/400.
4034	1	28	AS4FOV	1-28 EBCDIC text characters Font side overlay Reserved - private AS/400.
4035	1	28	AS4BOV	1-28 EBCDIC text characters Back side overlay Reserved - private AS/400.
4036	1	20	AS4PGD	1-20 EBCDIC text characters Qualified page definition name Reserved - private AS/400.
4037	1	13	AS4CH	1-13 EBCDIC text characters Channel values Reserved - private AS/400.
4038	1	9	AS4PSZ	1-9 EBCDIC text characters Page size Reserved - private AS/400.
4039	1	8	AS4FMG	1-8 EBCDIC text characters Front margin Reserved - private AS/400.
4040	1	8	AS4BMG	1-8 EBCDIC text characters Back margin Reserved - private AS/400.
4041	1	40	AS4FCI	1-40 EBCDIC text characters Font character set Reserved - private AS/400.
4042	1	20	AS4CDF	1-20 EBCDIC text characters Coded font Reserved - private AS/400.
4043	1	20	AS4DCF	1-20 EBCDIC text characters DBCS (Double-Byte Character Set) coded font Reserved - private AS/400.
4044-4FFF	-	-	RESERVED	Reserved for AS/400.
8005	1	0-124	IPADDR	IP address extracted from the DEST = 'IP:ip-address' format of the DEST = keyword. It is supported by JES2 and JES3.

Note:

Except where otherwise noted, the OPTU Keys are supported on VM, and MVS systems.
It is acceptable for implementations to ignore keys for which no support exists; however, it is not acceptable to flag as an error any key defined herein.
Alphameric characters are A-Z, a-z, and 0-9.
VSE does not use any OPTU keys. Any program may define its own OPTU keys using VSE/POWER. VSE/POWER passes any OPTU keys to the local program or to any node via the network.