Create Device Desc (Printer) (CRTDEVPRT)

The Create Device Description (Printer) (CRTDEVPRT) command creates a device description for a printer device.

Notes:

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword Description Choices Notes
DEVD Device description Name Required, Key, Positional 1
DEVCLS Device class *LCL, *RMT, *VRT, *SNPT, *LAN Required, Key, Positional 2
TYPE Device type 3287, 3812, 4019, 4201, 4202, 4207, 4208, 4214, 4216, 4224, 4234, 4245, 4247, 5204, 5219, 5224, 5225, 5256, 5262, 5553, 5583, 6252, 6404, 6408, 6412, *IPDS Required, Key, Positional 3
MODEL Device model 0, 1, 2, 3, 4, 10, 13, 200, 301, 302, 3E3, *ASCII, *POST, AS8, B01, CTA, D1, D2, T08, T12, T20, *IPDS, *LU3, 0000, 0001, 0002, 0003, 0004, 0010, 0013, 0200, 0301, 0302 Required, Key, Positional 4
LANATTACH LAN attachment *LEXLINK, *IP, *USRDFN Optional
SWTLINLST Switched line list Values (up to 8 repetitions): Name Optional
ADPTADR LAN remote adapter address 000000000001-FFFFFFFFFFFE Optional
ADPTTYPE Adapter type *INTERNAL, *EXTERNAL Optional
ADPTCNNTYP Adapter connection type *PARALLEL, *SERIAL Optional
EMLDEV Emulated twinaxial device 3812, 5219, 5224, 5256 Optional
AFP Advanced function printing *NO, *YES Optional
AFPATTACH AFP attachment *WSC, *APPC Optional
PORT Port number 0-65535 Optional
SWTSET Switch setting 0, 1, 2, 3, 4, 5, 6 Optional
LOCADR Local location address 00-FE Optional
AUXPRT Auxiliary printer *YES, *NO Optional
EMLASCII Emulating ASCII device *NO, *YES Optional
ATTACH Physical attachment *DIRECT, *PTT, *MODEM, *WIRE3, *WIRE4, *EIA422 Optional
ONLINE Online at IPL *YES, *NO Optional
CTL Attached controller Name Optional
LNGTYPE Language type *SYSVAL, AGB, AGI, ALI, BGB, BLI, BRB, CAB, CAI, CLB, CSB, CYB, DMB, DMI, ESB, FAB, FAI, FNB, FNI, GKB, GNB, HNB, ICB, ICI, IRB, ITB, ITI, JPB, LTB, LVB, MKB, NCB, NEB, NEI, NWB, NWI, PKB, PLB, PRB, PRI, RMB, ROB, RUB, SFI, SGI, SKB, SPB, SPI, SQB, SSB, SSI, SWB, SWI, THB, TKB, TRB, UAB, UKB, UKI, USB, USI, YGI Optional
PRTQLTY Print quality *STD, *DRAFT, *NLQ Optional
FONT Font Element list Optional
Element 1: Identifier Character value, 2, 3, 5, 8, 10, 11, 12, 13, 18, 19, 20, 21, 25, 26, 30, 31, 38, 39, 40, 41, 42, 43, 44, 46, 49, 50, 51, 52, 55, 61, 62, 63, 66, 68, 69, 70, 71, 72, 74, 75, 76, 80, 84, 85, 86, 87, 91, 92, 95, 96, 98, 99, 101, 102, 103, 109, 110, 111, 112, 154, 155, 157, 158, 159, 160, 162, 163, 164, 167, 168, 173, 174, 175, 178, 179, 180, 181, 182, 183, 186, 187, 188, 189, 190, 191, 194, 195, 204, 205, 211, 212, 221, 222, 223, 225, 226, 229, 230, 232, 233, 234, 244, 245, 247, 248, 249, 252, 253, 254, 255, 256, 258, 259, 279, 281, 282, 285, 290, 300, 400, 434, 435, 751, 752, 753, 754, 755, 756, 757, 758, 759, 760, 761, 762, 763, 764, 765, 1051, 1053, 1056, 1351, 1653, 1803, 2103, 4407, 4427, 4535, 4919, 4939, 5047, 5067, 5687, 5707, 5815, 5835, 5943, 6199, 6219, 6327, 6347, 8503, 8523, 8631, 8651, 8759, 8779, 8887, 8907, 12855, 12875, 16951, 16971, 17079, 17099, 33335, 33355, 33463, 33483, 33591, 33601, 33719, 33729, 34103, 34123, 34231, 34251, 37431, 41783, 41803
Element 2: Point size 0.1-999.9, *NONE
FORMFEED Form feed *TYPE, *CONT, *CONT2, *CUT, *AUTOCUT Optional
SEPDRAWER Separator drawer 1-255, *FILE Optional
SEPPGM Separator program Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Separator program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
NBRDRAWER Number of drawers 1, 2, 3 Optional
PRTERRMSG Printer error message *INQ, *INFO Optional
MSGQ Message queue Single values: *CTLD, *SYSOPR
Other values: Qualified object name
Optional
Qualifier 1: Message queue Name, QSYSOPR
Qualifier 2: Library Name, *LIBL, *CURLIB
APPTYPE Application type *NONE, *NRF, *DEVINIT, *APPINIT Optional
ACTTMR Activation timer 1-2550, 170, *NOMAX Optional
INACTTMR Inactivity timer 1-30, *ATTACH, *NOMAX, *SEC15, *SEC30 Optional
SNPTDEV SNA pass-through device desc Name, *NONE Optional
SNPTGRP SNA pass-through group name Name, *NONE Optional
LOGON Host signon/logon command Character value, *NONE Optional
PACING Pacing 1-7, 7 Optional
LINESPEED Line speed *TYPE, 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, 38400 Optional
WORDLEN Word length *TYPE, 7, 8 Optional
PARITY Type of parity *TYPE, *EVEN, *ODD, *NONE, *MARK, *SPACE Optional
STOPBITS Stop bits *TYPE, 1, 2 Optional
TRANSFORM Host print transform *NO, *YES Optional
MFRTYPMDL Manufacturer type and model Character value Optional
PPRSRC1 Paper source 1 *MFRTYPMDL, *LETTER, *LEGAL, *EXECUTIVE, *LEDGER, *A3, *A4, *A5, *B4, *B5, *CONT80, *CONT132, *NONE Optional
PPRSRC2 Paper source 2 *MFRTYPMDL, *LETTER, *LEGAL, *EXECUTIVE, *LEDGER, *A3, *A4, *A5, *B4, *B5, *CONT80, *CONT132, *NONE Optional
ENVELOPE Envelope source *MFRTYPMDL, *MONARCH, *NUMBER9, *NUMBER10, *B5, *C5, *DL, *NONE Optional
ASCII899 ASCII code page 899 support *NO, *YES Optional
IMGCFG Image configuration Character value, *NONE Optional
MAXPNDRQS Maximum pending requests 1-31, 6 Optional
PRTCVT Print while converting *NO, *YES Optional
PRTRQSTMR Print request timer 1-3600, *NOMAX Optional
FORMDF Form definition Qualified object name Optional
Qualifier 1: Form definition Name, F1C10110
Qualifier 2: Library Name, *LIBL, *CURLIB
CHRID Character identifier Single values: *SYSVAL
Other values: Element list
Optional
Element 1: Graphic character set 1-32767
Element 2: Code page 1-32767
RMTLOCNAME Remote location Element list Optional
Element 1: Name or address Character value
LCLLOCNAME Local location Communications name, *NETATR Optional
MODE Mode Communications name, QSPWTR, *NETATR Optional
IGCFEAT DBCS feature Element list Optional
Element 1: Device features Character value
Element 2: Last code point 4141-FFFE
USRDFNOPT User-defined options 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, *USRIDX, *PSFCFG, *USRQ, *USRSPC
USRDTATFM Data transform program Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Data transform program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
USRDRVPGM User-defined driver program Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: User-defined driver program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
SYSDRVPGM System driver program Character value, *HPPJLDRV, *IBMPJLDRV, *NETSTNDRV, *IBMSNMPDRV, *IBMIPPDRV Optional
SECURECNN Secure connection *NO, *YES Optional
VLDL Validation list Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Validation list Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Start of changeSNMPUSRend of change Start of changeSNMP user nameend of change Start of changeCharacter value, *NONEend of change Start of changeOptionalend of change
Start of changeSNMPCNTXend of change Start of changeSNMP context nameend of change Start of changeCharacter value, *NONEend of change Start of changeOptionalend of change
PUBLISHINF Publishing information Element list Optional
Element 1: Support duplex *UNKNOWN, *SIMPLEX, *DUPLEX
Element 2: Support color *UNKNOWN, *NOCOLOR, *COLOR
Element 3: Pages per minute black 1-32767, *UNKNOWN
Element 4: Pages per minute color 1-32767, *UNKNOWN
Element 5: Location Character value, *BLANK, X''
Element 6: Data streams supported Single values: *UNKNOWN
Other values (up to 5 repetitions): *PCL, *PS, *PDF, *IPDS, *SCS
TEXT Text 'description' Character value, *BLANK Optional
DEPLOCNAME Dependent location name Communications name, *NONE Optional
RMTNETID Remote network identifier Communications name, *NETATR, *NONE 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
AUT Authority Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT Optional

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Device class (DEVCLS)

Specifies the device class for this display station or printer.

*LCL

This device description is for a device connected to a local work station controller.

*RMT

This device description is for a device connected to a remote work station controller.

*VRT

This device description is for a virtual device.

*SNPT

This device description is for a printer connected to an SNA pass-through advanced program-to-program communications (APPC) controller. SNA pass-through support allows the user to connect this printer with host logical unit (LU) types 0 through 3 applications.

*LAN

The device description is for a printer connected directly to a local area network (LAN).

Device type (TYPE)

Specifies the type of device this description represents.

This is a required parameter.

The valid values are:

For ASCII devices only: The following device types are listed with their more common descriptions:

Type
Description
4019
IBM LaserPrinter
4201
IBM Proprinter II
4202
IBM Proprinter XL
4207
IBM Proprinter X24
4208
IBM Proprinter XL24
4216
IBM Personal Pageprinter
4224
IBM 4224 Printer
4234
IBM 4234 Printer
5204
IBM Quickwriter
6252
IBM ImpactWriter

Note: Proprinter, Quickwriter, and ImpactWriter are registered trademarks of International Business Machines.

Device model (MODEL)

Specifies the model number of the device for this description.

TYPE
MODEL
3287
0
3812
1
4214
2
4234
2
4245
T12, T20
4247
CTA
5219
D1, D2
5224
1, 2
5225
1, 2, 3, 4
5256
1, 2, 3
5262
1
5553
B01
5583
200
6252
T08
*IPDS
0
6404
CTA
6408
CTA
6412
CTA

For ASCII devices only:

*ASCII

Specify this value if the model number cannot be easily determined for this printer. The system will assign a model number (if the device has a model number). The model number assigned by the system may not be the actual model number of your printer; see the following table to determine the model number which will be assigned by using *ASCII. It is recommended that you determine your printer's model number if at all possible, and enter that number.

The possible choices are:

TYPE
MODEL
4019
1 (*ASCII)_
4201
2 (*ASCII), 3
4202
1 (*ASCII), 2, 3
4207
1 (*ASCII), 2
4208
1 (*ASCII), 2
4216
10 (*ASCII)
4224
301 (*ASCII), 302, 3E3
4234
13 (*ASCII)
5204
1 (*ASCII)
6252
AS8 (*ASCII)

LAN attachment (LANATTACH)

Specifies the attachment of a printer when DEVCLS(*LAN) is specified.

*LEXLINK

The printer is attached to lexlink.

*IP

The printer is attached to TCP/IP.

*USRDFN

The printer attachment is user-defined; either lexlink or TCP/IP.

Switched line list (SWTLINLST)

Specifies the name of the switched lines to which the printer is associated when DEVCLS(*LAN) and LANATTACH(*LEXLINK) or LANATTACH(*USRDFN) are specified. The types of switched lines this printer may associate with are: Ethernet IEEE 802.3, and Ethernet with all standards specified.

A maximum of 8 switched lines can be specified.

LAN remote adapter address (ADPTADR)

Specifies the 12-character hexadecimal LAN address of the remote printer when DEVCLS(*LAN) and LANATTACH(*LEXLINK) or LANATTACH(*USRDFN) are specified. Valid values range from 000000000001 through FFFFFFFFFFFE.

Adapter type (ADPTTYPE)

Specifies the type of LAN printer adapter to be used when DEVCLS(*LAN) and LANATTACH(*LEXLINK) or LANATTACH(*USRDFN) are specified.

*INTERNAL

The printer has an internal LAN adapter card.

*EXTERNAL

The printer has an internal LAN adapter card.

Adapter connection type (ADPTCNNTYP)

Specifies the type of ports supported by the external LAN printer adapter when DEVCLS(*LAN) and ADPTTYPE(*EXTERNAL) are specified.

Note: This parameter is ignored when ADPTTYPE(*INTERNAL) is specified.

*PARALLEL

The LAN printer adapter supports one or more parallel ports.

*SERIAL

The LAN printer adapter supports one or more serial ports.

Emulated twinaxial device (EMLDEV)

Specifies, for ASCII printers, the twinaxial printer type that the ASCII printer will emulate.

3812

3812 model 1 emulation is valid for the following ASCII printers: 4019, 4216, and 5204.

5219

5219 model D2 emulation is valid for all ASCII printers except 4201, 4202, and 4234.

5224

5224 model 1 emulation is valid for all ASCII printers.

5256

5256 model 3 emulation is valid for all ASCII printers.

Advanced function printing (AFP)

Specifies whether or not this printer does advanced function printing. Most IPDS printers can be configured with AFP(*YES) or AFP(*NO). Most non-IPDS printers can be configured only with AFP(*NO). This parameter is only used if *LCL, *RMT, or *LAN is specified on the Device class (DEVCLS) parameter and *IPDS is specified on the Device type (TYPE) parameter.

*NO

This printer is not used for advanced function printing.

*YES

This printer is used for advanced function printing.

AFP attachment (AFPATTACH)

Specifies the type of attachment used for a printer. This parameter is used only if *YES is specified for the Advanced function printing (AFP) parameter.

*WSC

3812 or 3816 printers are attached to a local or remote work station controller.

*APPC

3820, 3825, 3827, or 3835 printers are attached by LU 6.2 using APPC/APPN.

Port number (PORT)

Specifies the port number for printer devices. Valid values range from 0 through 65535. Some printer devices may further restrict the valid value range.

For twinaxial attached printers: Valid values range from 0 through 7.

For printers attached to a TCP/IP network, where DEVCLS(*LAN), TYPE(3812), and LANATTACH(*IP) are specified:

Note: If the device supports the Simple Network Management Protocol (SNMP), SYSDRVPGM(*IBMSNMPDRV), or the HP Printer Job Language (PJL), SYSDRVPGM(*IBMPJLDRV), refer to the device's documentation, or contact the device manufacturer to determine the port number.

If the device supports the Internet Printing Protocol (IPP), SYSDRVPGM(*IBMIPPDRV), the well known port number is 631.

For printers attached to the ASCII workstation controller: Valid values range from 0 through 17 and indicate the port of the ASCII workstation controller to which the printer is attached. Without the 12-port expansion feature, only ports 0 through 5 are valid. With the 12-port expansion feature, ports 6 through 17 are added.

For printers attached to a LAN, where DEVCLS(*LAN) TYPE(3812), and LANATTACH(*LEXLINK) or LANATTACH(*USRDFN):

Note: If ADPTTYPE(*EXTERNAL) is specified, the port number value indicates which parallel or serial port to use, if there is more than one port on the external LAN adapter. Valid values range from 0 - 17.

If ADPTTYPE(*INTERNAL) is specified, the port number is not required.

Switch setting (SWTSET)

Specifies the switch setting for local twinaxial devices.

Valid values range from 0 to 6.

Local location address (LOCADR)

Specifies the local location address for this device.

The possible values range from 00 to FE. The type of controller to which the device is being attached determines which values are valid.

Controller
Valid Values
5251
00, 02-09
5294
00-1B
5394
00-14
5494
00-37
3174
02-41
3274
02-41
SNA Host
01-FE
4701
02-FE
4702
02-FE
4680
02-54
4684
02-FE
FBSS
02-FE

Auxiliary printer (AUXPRT)

Specifies, for ASCII printers, whether or not this printer description is for an auxiliary printer. An auxiliary printer is attached to an ASCII display station, instead of being physically cabled to the ASCII work station controller. All data sent to the printer passes through the display station.

*YES

Specifies that this printer is attached to the auxiliary port of an ASCII display.

*NO

Specifies that this printer is physically cabled to the ASCII work station controller.

For auxiliary printers, the following parameters must match those specified for the ASCII display to which this printer is attached:

Emulating ASCII device (EMLASCII)

Specifies, for ASCII devices, whether the device being configured is emulating a supported ASCII device type (TYPE parameter). When an ASCII device is configured, choices for the following parameters are restricted to the valid range for that device:

For ASCII devices emulating supported ASCII device types, these restrictions may not be applicable (the emulating device might have a wider range of choices for these parameters than the emulated ASCII device does). When EMLASCII(*YES) is specified, these parameter restrictions are not enforced; the user is allowed to enter the full range of values for these parameters, but also is responsible for verifying that the values selected are valid for the device being configured.

*NO

Specifies that the device being configured is one of the supported ASCII device types Device type (TYPE) parameter, and that the device-specific restrictions for the physical attachment, line speed, word length, type of parity, and stop bits parameters are to be enforced.

*YES

Specifies that the device being configured is emulating one of the supported ASCII device types (TYPE parameter), and that the device-specific restrictions for the physical attachment, line speed, word length, type of parity, and stop bits parameters are not enforced.

Physical attachment (ATTACH)

Specifies, for ASCII display stations, the physical attachment of the display station to the ASCII work station controller.

*EIA422

The EIA-422 attachment (valid only for models 3101, 3151, 3161, 3162, 3163, and 3164) is used.

*DIRECT

Specifies EIA-232 Direct attachment.

*MODEM

Specifies EIA-232 modem attachment.

*PTT

Specifies Post Telephone and Telegraph (PTT) attachment.

*WIRE3

Specifies EIA-232 3-wire attachment.

*WIRE4

Specifies EIA-232 4-wire attachment.

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

Attached controller (CTL)

Specifies the name of the controller description to which this device is attached.

Note: To use this device for communicating with a remote location that resides on the same system as the local location, specify a controller description that was created with LINKTYPE (*LOCAL) specified.

Language type (LNGTYPE)

For ASCII printers, describes the default country keyboard language identifier for this printer.

The following languages can be used by ASCII devices only if either host print transform or work station customization are also used: ALI, BGB, CSB, ESB, HNB, IRB, JPB, LTB, LVB, MKB, PKB, PLB, RMB, RUB, SKB, SQB, TRB, UAB, and YGI.

*SYSVAL

The system uses the QKBDTYPE system value.

language-type

Specify the correct country keyboard language identifier for this printer from the following table.

Identifier
Language(Country) - ASCII Device Groups
ALI
Albania
CLB
Arabic X/Basic - D*
AGB
Austria/Germany - A, B
AGI
Austria/Germany Multinational - A, B
BLI
Belgium Multinational - B
BRB
Brazilian Portuguese
BGB
Bulgaria
CAB
Canadian French - A, B
CAI
Canadian French Multinational - A, B
SPB
Catalan
YGI
Croatia/Serbia (Latin)/Slovenia
CYB
Cyrillic
CSB
Czech Republic
DMB
Denmark - B
DMI
Denmark Multinational - B
ESB
Estonia
FNB
Finland/Sweden - B
FNI
Finland/Sweden Multinational - B
FAB
France (Azerty) - A, B
FAI
France (Azerty) Multinational - A, B
GNB
Greek (see note)
NCB
Hebrew - D*
HNB
Hungary
ICB
Iceland
ICI
Iceland Multinational
IRB
Iran (Farsi)
ITB
Italy - A, B
ITI
Italy Multinational - A, B
JPB
Japan Latin Extended
ROB
Latin-2/ROECE
LVB
Latvia
LTB
Lithuania
MKB
FYR Macedonia (Former Yugoslav Republic)
NEB
Netherlands
NEI
Netherlands Multinational
NWB
Norway - B
NWI
Norway Multinational - B
PLB
Poland
PRB
Portugal - B
PRI
Portugal Multinational - B
RMB
Romania
RUB
Russia
SQB
Serbia (Cyrillic)
SKB
Slovakia
SPB
Spain - B
SPI
Spain Multinational - B
SSB
Spanish Speaking - B
SSI
Spanish Speaking Multinational - B
SWB
Sweden - B
SWI
Sweden Multinational - B
SFI
Switzerland/France Multinational - B
SGI
Switzerland/Germany Multinational - B
THB
Thailand
TKB
Turkey (Qwerty)
TRB
Turkey (F)
UAB
Ukraine
UKB
United Kingdom - A, B
UKI
United Kingdom Multinational - A, B
USB
United States/Canada - A, B, C
USI
United States/Canada Multinational - A, B, C
PKB
Urdu
YGI
Languages of the former Yugoslavia

Note: The GNB code is the current identifier for Greece. The GKB code was used prior to V2R1, and continues to be supported, but provides fewer characters than the recommended GNB code.

Print quality (PRTQLTY)

Specifies whether the default print quality for ASCII printers should be draft (*DRAFT), standard (*STD), or near-letter quality (*NLQ), from least to best quality. All ASCII printer types (with all emulations) support this parameter. If the printer is emulating a 5219 (EMLDEV parameter), this quality setting is overridden by individual printer files sent to this printer.

Note: All twinaxial printer emulations support this parameter. If the ASCII printer is emulating a 5219 twinaxial printer, then this print quality setting can be overridden by individual print files sent to this printer.

*STD

Specifies standard quality setting.

*DRAFT

Specifies draft quality setting.

*NLQ

Specifies near letter quality setting.

Font identifier (FONT)

Specifies the font identifier and the point size used by the 3812, 3816, 5219 printers (including ASCII printers emulating the 5219 printer), and IPDS printers. A font identifier (up to 10 digits) is used with this printer file. Each font identifier has an implied characters-per-inch (CPI) value.

Note: Some fonts may be substituted by the printer. Consult the various printer reference guides for details.

Element 1: Font identifier

identifier

Specify the font identifier associated with this printer.

Element 2: Point size

*NONE

The point size is supplied by the system and is determined by the specified font identifier.

point-size

Specify a point size ranging from 0.1 through 999.9.

Form feed (FORMFEED)

Specifies the form feed attachment used for this spooled file. This parameter determines how forms are fed into the printer. Not all printers support this parameter. Refer to the Create Printer File (CRTPRTF) command to determine if this parameter is supported.

Note: The FORMFEED parameter is overridden by the value specified on the PPRSRC1 parameter when the host print transform function is enabled.

*TYPE

Form feed value is determined by the system based on printer type.

For MODEL(*IPDS), this value cannot be determined accurately. You must select a value that is appropriate for the printer: *CONT, *CONT2, *CUT, or *AUTOCUT.

*CONT

Continuous forms are used by the printer. Some printers (3812, 4216) don't have tractor feed attachments (they don't actually support continuous forms). But in some cases, *CONT must be specified to match what the emulated twinaxial printer supports.

*CONT2

Continuous forms are used by the printer. The form is fed from the secondary tractor feed attachment. The secondary tractor feed attachment must be on the printer device. This value is allowed for 4214, 4234, 4247, and *IPDS printers.

*CUT

Single-cut sheets are used by the printer. For cut sheets, the forms alignment message is not sent. This value is valid for all ASCII printers, except the 4216 Printer emulating a SCS 5219 Printer.

*AUTOCUT

Single-cut sheets are fed into the printer automatically. The printer must have the sheet feed attachment. The *AUTOCUT feature is valid for 4207, 4208, 4216, 4224, and 5204 printers that are emulating a 5219 printer.

Separator drawer (SEPDRAWER)

Specifies which drawer is selected for printing separators.

*FILE

The separator pages are printed on paper from the same drawer as the rest of the spooled file.

separator-drawer

Specify a value ranging from 1 through 255 to indicate the drawer from which the separator pages are printed.

Note: For some printers, SEPDRAWER(3) implies an envelope drawer.

Separator program (SEPPGM)

Specifies a style of separator page by allowing you to call a user exit program while printing job and file separators.

*NONE

The separator pages are not changed.

exit-program-name

Specify an exit program name.

The possible library values are:

*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 job is used to locate the exit program. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library where the exit program is located.

Number of drawers (NBRDRAWER)

Specifies, for ASCII printers defined with *AUTOCUT for the form feed (FORMFEED parameter), whether the printer's sheet feed attachment supports 1, 2, or 3 drawers. This parameter is not applicable if form feed is *CONT or *CUT.

Note: The number of drawers parameter specifies how many drawers the printer physically supports, not which drawer the paper is selected from. The individual print files sent to the printer will dictate which drawer is selected.

1

One drawer is physically supported.

2

Two drawers are physically supported.

3

Three drawers are physically supported.

For the printers that support FORMFEED(*AUTOCUT), the following number of drawers are supported:

  1. For 4207-1 and 4208 printers, only NBRDRAWER(1) is valid.
  2. For a 4224 printer, only NBRDRAWER(3) is valid.
  3. For 4207-2, 4216, and 5204 printers, NBRDRAWER values of 1, 2, and 3, are supported.

Note: NBRDRAWER(3) implies that two paper drawers and an envelope drawer are used.

Printer error message (PRTERRMSG)

Specifies whether the device has inquiry messages or informational messages for recoverable errors. This parameter is not applicable for printers attached to ASCII work station controllers.

*INQ

Inquiry messages are sent for recoverable errors.

*INFO

Informational messages are sent for recoverable errors.

Message queue (MSGQ)

Specifies the message queue to which operational messages for this device are sent.

*CTLD
Messages are sent to the message queue defined in the attached controller. The message queue is determined when the device is varied on.
*SYSOPR
Messages are sent to the system operator message queue (QSYS/QSYSOPR).
message-queue-name

Specify the name of the message queue to which operational messages are sent.

*LIBL

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

*CURLIB

The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name

Specify the name of the library to be searched.

Application type (APPTYPE)

Specifies the application type used by this device.

*NONE

The device is not used for any application.

*NRF

The device is used for the Network Routing Facility application.

*DEVINIT

The device starts (initiates) the session.

*APPINIT

The application program starts (initiates) the session.

Activation timer (ACTTMR)

Specifies the amount of time (in seconds) to wait for the device to respond to the activation request from the host IBM i. If the device does not respond within this time, it is considered not available.

Note: This parameter is valid only on switched lines and when *SNPT is specified for the DEVCLS parameter.

170

The device waits 170 seconds.

*NOMAX

The device waits forever.

Note: *NOMAX is valid only when DEVCLS(*LAN) and AFP(*YES) are specified.

activation-timer

Specify a number indicating the number of seconds before the device is considered not available.

Note: If LANATTACH is *LEXLINK, and the specified number of seconds has elapsed, an inquiry message is issued.

Inactivity timer (INACTTMR)

Specifies an inactivity timer (time-out) value. This parameter also specifies what happens when the time-out value is exceeded, dependent on other attributes of the device:

Note: This timer is not used by devices allocated to a subsystem (normal interactive use) because the subsystem always has a file open for the device. The timer is used by batch jobs that open and close files for the device.

For all other attachments, valid values range from 1 through 30 minutes.

*ATTACH

This value varies by the value on the physical attachment (ATTACH parameter) and certain values on the device class (DEVCLS) and application type (APPTYPE) parameters.

  1. For DEVCLS(*SNPT) or APPTYPE(*DEVINIT) support, *ATTACH maps to *NOMAX.
  2. For DEVCLS(*LAN), *ATTACH maps to *SEC15.
  3. For APPTYPE(*NRF) and APPTYPE(*APPINIT) support, *ATTACH maps to 1 minute.
*NOMAX

No maximum inactivity time is tracked (no inactivity timer is to be enforced).

*SEC15

A 15-second time-out period is used.

*SEC30

A 30-second time-out period is used.

inactivity-timer

Specifies a time-out value in minutes.

SNA pass-through device desc (SNPTDEV)

Specifies the name of the associated SNA pass-through device that is attached to a host or advanced program-to-program communications (APPC) controller.

*NONE

No name is specified.

associated-device-name

Specify the name of a device that is attached to a host or an APPC controller that is associated with this device.

SNA pass-through group name (SNPTGRP)

Specifies the name configured for a group of host devices in a configuration list (see CRTCFGL command). This indicates that this device is associated with any one of the devices in that group which is available.

*NONE

No name is specified.

group-name

Specify the name configured for a group of host devices that must be associated with this device.

Host signon/logon command (LOGON)

Specifies the sign-on (logon) text. This parameter is allowed when DEVCLS(*SNPT) or APPTYPE(*NRF) is specified. APPTYPE(*NRF) specifies the logon string that is sent to the host system when a request is made to establish a session. DEVCLS(*SNPT) specifies the sign-on (logon) text that is sent to the host system after starting SNA pass-through support.

This parameter also specifies the logon string that is sent to the system services control point (SSCP) on the host network when the file is opened for *NRF.

*NONE

No text is sent to the host system.

host-logon-command

Specify text that is sent to the host system. The text must be enclosed in apostrophes if it contains blanks or other special characters. All apostrophes within the text must be represented by two apostrophes. A maximum of 256 characters can be specified.

Pacing value (PACING)

Specifies the SNA pacing value used for request/response units (RUs).

7

Specifies 7-bit word lengths.

pacing-value

Specify a value, ranging from 1 through 7.

Line speed (LINESPEED)

Specifies the line speed in bits per second (bps).

*TYPE
The system uses the suggested setting for this device type. *TYPE will select 19200 bits per second for all printers.
line-speed

Specify the line speed. Valid values are: 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, or 38400.

Word length (WORDLEN)

Specifies, for ASCII devices, the word length (bits per character) used to communicate over the attachment between the ASCII work station controller and the device. For modem and Post Telephone and Telegraph (PTT) attachments, the word length must be the same as the word length selected for the modem. For auxiliary printers connected to the auxiliary port of a display station, the word length must be the same as the word length specified for the display's device description.

Some devices do not support all word lengths; verify that your device supports the word length you intend to use.

*TYPE

The system uses the suggested setting for this device type.

*TYPE selects 8-bit word lengths for all printers.

7

Specifies 7-bit word lengths.

8

Specifies 8-bit word lengths.

Type of parity (PARITY)

Specifies, for ASCII devices, the type of parity used to communicate over the attachment between the ASCII work station controller and the device. For modem and Post Telephone and Telegraph (PTT) attachments, the type of parity must be the same as the type of parity selected for the modem. For auxiliary printers connected to the auxiliary port of a display station, the type of parity must be the same as the type of parity specified for the display's device description.

Some devices do not support all types of parity; verify that your device supports the type of parity you intend to use.

*TYPE

The system uses the suggested setting for this device type.

*TYPE will select *EVEN (Even parity) for all printers.

*EVEN

Specifies Even parity.

*ODD

Specifies Odd parity.

*NONE

Specifies that no parity bit is used.

*MARK

Specifies Mark parity (1 is used for the parity).

*SPACE

Specifies Space parity (0 is used for the parity).

Stop bits (STOPBITS)

Specifies, for ASCII devices, the number of stop bits used to communicate over the attachment between the ASCII work station controller and the device. For modem and Post Telephone and Telegraph (PTT) attachments, the number of stop bits must be the same as the number of stop bits selected for the modem. For auxiliary printers connected to the auxiliary port of a display station, the number of stop bits must be the same as the number of stop bits specified for the display's device description.

Some devices do not support all numbers of stop bits; verify that your device supports the number of stop bits you intend to use.

*TYPE

The system uses the suggested setting for this device type.

*TYPE will select 1 stop bit for all printers.

1

Specifies 1 stop bit.

2

Specifies 2 stop bits.

Host print transform (TRANSFORM)

Specifies whether the printer uses host print transform support.

*NO

The printer does not use host print transform support.

*YES

The printer uses host print transform support.

Manufacturer type and model (MFRTYPMDL)

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

character-value
Specify the corresponding manufacturer, type, and model for a printer.

The following list shows the values to be specified for the device you are using:

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

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
*IBM5575AMOV    IBM 5575 Printer Series (alternate
                version)
*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
*INFOPRINT4247  IBM Infoprint 4247 Printer Series
*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
*RICOHMP2352    Ricoh Aficio MP2352 Printer Series
*RICOHMP2500    Ricoh Aficio MP2500 Printer Series
*RICOHMP5000    Ricoh Aficio MP5000 Printer Series
*RICOHMP9000    Ricoh Aficio MP9000 Printer Series
*RICOHSP4100N   Ricoh Aficio SP4100N Printer Series
                Ricoh Aficio SP4110N Printer Series
*RICOHSP5200S   Ricoh Aficio SP5200S Printer Series
*RICOHSP6330N   Ricoh Aficio SP6330N Printer Series
*RICOHSP8200DN  Ricoh Aficio SP8200DN Printer Series
*RICOHSP9100DN  Ricoh Aficio SP9100DN Printer Series
*RICOHSPC430DN  Ricoh Aficio SPC430DN Color 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

Paper source 1 (PPRSRC1)

Specifies the type of paper used in paper source one.

*MFRTYPMDL

The system uses the suggested setting for this printer.

*LETTER

The paper for this source is letter-sized (8.5 x 11 inches).

*LEGAL

The paper for this source is legal-sized (8.5 x 14 inches).

*LEDGER

The paper for this source is ledger-sized (11 x 17 inches).

*EXECUTIVE

The paper for this source is executive-sized (7.25 x 10.5 inches).

*A3

The paper for this source is A3-sized (297mm x 420mm).

*A4

The paper for this source is A4-sized (210mm x 297mm).

*A5

The paper for this source is A5-sized (148 x 210mm).

*B4

The paper for this source is B4-sized (257mm x 364mm).

*B5

The paper for this source is B5-sized (182 x 257mm).

*CONT80

The paper for this source is continuous form (8.0 inches).

*CONT132

The paper for this source is continuous form (13.2 inches).

*NONE

No paper source number one is specified.

Paper source 2 (PPRSRC2)

Specifies the type of paper used in paper source two.

*MFRTYPMDL

The system uses the suggested setting for this printer.

*LETTER

The paper for this source is letter-sized (8.5 x 11 inches).

*LEGAL

The paper for this source is legal-sized (8.5 x 14 inches).

*LEDGER

The paper for this source is ledger-sized (11 x 17 inches).

*EXECUTIVE

The paper for this source is executive-sized (7.25 x 10.5 inches).

*A3

The paper for this source is A3-sized (297mm x 420mm).

*A4

The paper for this source is A4-sized (210mm x 297mm).

*A5

The paper for this source is A5-sized (148 x 210mm).

*B4

The paper for this source is B4-sized (257mm x 364mm).

*B5

The paper for this source is B5-sized (182 x 257mm).

*NONE

No paper source number one is specified.

Envelope source (ENVELOPE)

Specifies the type of envelopes used in the third paper source.

*MFRTYPMDL

The system uses the suggested setting for this printer.

*MONARCH

The envelopes for this source are monarch-sized (3.875 x 7.5 inches).

*NUMBER9

The envelopes for this source are number 9-sized (3.875 x 8.875 inches).

*NUMBER10

The envelopes for this source are number 10-sized (4.125 x 9.5 inches).

*B5

The envelopes for this source are B5-sized (176mm x 250mm).

*C5

The envelopes for this source are C5-sized (162mm x 229mm).

*DL

The envelopes for this source are DL-sized (110mm x 220mm).

*NONE

No envelope source is specified.

ASCII code page 899 support (ASCII899)

Specifies whether the printer has ASCII code page 899 installed.

*NO

The printer does not have ASCII code page 899 installed.

*YES

The printer has ASCII code page 899 installed.

Image configuration (IMGCFG)

Specifies the image configuration for this printer. An image configuration object provides transform services for a variety of image and print datastream formats.

*NONE

No image configuration specified.

image-configuration

Specify image configuration for a printer.

The following lists include the image configuration objects provided and suggested image configuration objects for many popular printers.

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

Maximum pending requests (MAXPNDRQS)

Specifies the maximum number of print requests that may be queued for printers. This parameter is used only if *YES is specified for the Advanced function printing (AFP) parameter.

6

Up to 6 print requests can be queued.

maximum-print-requests

Specify a number from 1 to 31, indicating the maximum number of print requests that can be queued.

Print while converting (PRTCVT)

Specifies whether a file using AFP must be completely converted to IPDS before printing can begin.

*YES

Printing begins prior to complete IPDS conversion.

*NO

Printing does not begin prior to complete IPDS conversion.

Print request timer (PRTRQSTMR)

Specifies the number of seconds to wait, after a print request has been sent to a printer using continuous forms, before the last pages of the output are forced out of the printer into the paper stacker. This parameter is used only if *YES is specified for the Advanced function printing (AFP) parameter and *CONT is specified for the Form feed (FORMFEED) parameter.

*NOMAX

No timer is used.

print-request-timer

Specify the number of seconds, from 1 to 3600, to wait after a print request has been sent before forcing the last pages of the output out of the printer.

Form definition (FORMDF)

Specifies the name of the form definition to be used in the absence of any other form definition specification for a print request. This parameter is used only if *YES is specified for the Advanced function printing (AFP) parameter.

F1C10110

Use form definition F1C10110.

form-definition-name

Specify the name of the form definition to be used.

*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 job is used to locate the form definition. If no current library exists in the library list, QGPL is used.
library-name
Specify the library where the form definition is located.

Character identifier (CHRID)

Specifies, for printers, the character identifier (graphic character set and code page) indicating which font is used to print the job and file separator pages when no separator page font is explicitly specified. This parameter is used only if *YES is specified for the Advanced function printing (AFP) parameter and *APPC is specified for the AFP attachment (AFPATTACH) parameter, or if *YES is specified for the Host print transform (TRANSFORM) parameter.

*SYSVAL
The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.

Element 1: Character Set

graphic-character-set

Specify the graphic character set values that match the attributes of this printer. Valid values range from 1 through 32767.

Element 2: Code Page

code-page

Specify the code page set values that match the attributes of the printer. Valid values range from 1 through 32767.

Remote location (RMTLOCNAME)

Specifies the remote location name of the printer device. This value may be an SNA network ID and control point name, an internet protocol (IP) host name, or an internet address.

An SNA remote location name is specified using the format nnnnnnnn.cccccccc, where nnnnnnnn is the network ID and cccccccc is the control point name. If only the control point name is specified, the RMTNETID parameter value is used as the value of the network ID.

An IP remote location name must be from 1 to 255 characters in length.

Note: This parameter is valid if AFP(*YES) and AFPATTACH(*APPC) both are specified, or when LANATTACH(*IP) or LANATTACH(*USRDFN) is specified. This parameter is required when APPTYPE(*APPINIT) is specified. The remote location name for an APPTYPE(*APPINIT) device is the Virtual Telecommunications Access Method/IBM Network Control Program (VTAM/NCP) name of the physical device.

remote-location-name

Specify the remote location name, remote system name, or internet address.

Local location (LCLLOCNAME)

Specifies the local location name. This parameter is valid only when AFP(*YES) and AFPATTACH(*APPC) are specified, or when APPTYPE(*APPINIT) is specified. The local location name for an APPTYPE(*APPINIT) device is the name of the independent logical unit (LU) in the IBM Network Control Program (NCP).

*NETATR
The LCLLOCNAME value specified in the system network attributes is used.
local-location-name

Specify the local location name.

Mode (MODE)

Specifies the name of the mode used to define the session limits and session characteristics for this device.

QSPWTR

The mode which exists specifically for use with printers.

*NETATR
The mode in the network attributes is used.
mode-name

Specify the name of the mode description to be used by this device.

DBCS feature (IGCFEAT)

Specifies which double-byte character set (DBCS) table is used in DBCS feature code format expressing device features and the last code point value. The table at the end of this parameter description shows valid device features and last code point values for DBCS-capable devices.

Note: This parameter is valid for DBCS-capable devices only.

Element 1: Features of the DBCS-Capable Devices

device-features

Specify the device character resolution, language, and relative buffer size device features using the format SSSSLR, where:

SSSS =
The resolution (number of matrix points used to create) of the character. For example, 2424 would be 24 matrix points of height and 24 matrix points of width available to formulate the character.
L =
The language code. The 4 language codes currently supported are:
  • J = Japanese
  • K = Korean
  • C = Traditional Chinese
  • S = Simplified Chinese
R =
The relative buffer size. The valid values are: 0, 1, 2, and 4.

Element 2: Last Code Point

last-code-point

Specify the 4-digit code point of the last double-byte character. This value can be blank.

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.

*NONE

No user-defined option is specified.

user-defined-option

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.

The possible Name of User-Defined Object values are:

*NONE

No user-defined object name is specified.

user-defined-object-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)

Data transform program (USRDTATFM)

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

Notes:

  1. This parameter must be *NONE when AFP(*YES) is specified.
  2. This parameter must be *NONE when TRANSFORM(*YES) is specified.
*NONE

No user-defined data transform program name is specified.

user-defined-data-transform-program-name

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

The possible library values are:

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

User-defined driver program (USRDRVPGM)

Specifies the qualified name of a user-defined driver program.

Note: This parameter is not valid when AFP(*YES) is specified, or when DEVCLS(*LAN), TYPE(3812) and LANATTACH(*IP) are specified.

*NONE

No user-defined driver program is specified.

user-defined-driver-program-name

Specify the name of a user-defined driver program.

The possible library values are:

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

System driver program (SYSDRVPGM)

Specifies the name of a system-defined driver program, which provides the capability for sending IBM i printer output to a printer attached over a TCP/IP network.

Note: This parameter is only valid when DEVCLS(*LAN), TYPE(3812) and LANATTACH(*IP) are specified.

*HPPJLDRV

An HP-compatible printer driver program is used.

*IBMPJLDRV

An IBM network printer driver program is used.

*NETSTNDRV

A network station driver program is used.

*IBMSNMPDRV

An IBM SNMP printer driver program is used.

*IBMIPPDRV

An IBM IPP printer driver program is used.

Start of change

Secure connection (SECURECNN)

End of change

Specifies whether a secure connection is established with the printer. A secure connection provides an encrypted communications session to ensure print data that passes over the connection remains private.

Note: This parameter is only valid when SYSDRVPGM(*IBMIPPDRV) is specified.

*NO

The connection with the printer is not secure.

*YES

The connection with the printer is secure. The printer must support SSL(Secure Sockets Layer) or TLS(Transport Layer Security) and must have a system digital certificate. More information about the secure connections can be found in the Printer Device Programming book.

Validation list (VLDL)

Specifies a validation list that is used is the printer requests authentication. The validation list is checked for the name of the user who created the spooled file, the name of the printer device, or the name of the system. Authentication information associated with the name is returned to the printer. More information about building a validation list can be found in the Printer Device Programming book.

Note: This parameter is only valid when SYSDRVPGM(*IBMIPPDRV) is specified.

*NONE

No validation list is specified.

validation-list-object

Specify the name of the validation list which contains authentication information.

*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.
Start of change

SNMP user name (SNMPUSR)

The name of the SNMP user. The user name has no direct correlation to an IBM i user profile. Refer to the Add User for SNMP (ADDUSRSNMP) command for more information.

Note: This parameter is only valid when DEVCLS(*LAN), and SYSDRVPGM(*IBMSNMPDRV) or LANATTACH(*USRDFN) are specified.

*NONE
No name is specified.
character-value
A name must be a minimum of 1 character and no more than 32 characters in length. A name cannot contain any leading or imbedded blanks.

SNMP context name (SNMPCNTX)

The name of the SNMP context. Not all SNMP agents require a context name to be specified.

Note: This parameter is only valid when DEVCLS(*LAN), and SYSDRVPGM(*IBMSNMPDRV) or LANATTACH(*USRDFN) are specified.

*NONE
No name is specified.
character-value
A name must be a minimum of 1 character and no more than 32 characters in length. A name cannot contain any leading or imbedded blanks.
End of change
Start of change

Publishing information (PUBLISHINF)

End of change

Specifies information about the printer device that could be published to a Lightweight Directory Access Protocol (LDAP) directory.

Element 1: Support Duplex

Specifies whether the printer supports printing on both sides of a sheet of paper.

*UNKNOWN
The value for this field is unknown.
*SIMPLEX
The printer device only supports printing on one side of a sheet of paper.
*DUPLEX
The printer device supports printing on both sides of a sheet of paper.

Element 2: Support Color

Specifies whether the printer device supports color ink printing.

*UNKNOWN
The value for this field is unknown.
*COLOR
The printer device does support color ink printing.
*NOCOLOR
The printer device does not support color ink printing.

Element 3: Pages per minute black

The number of pages per minute in black ink that the printer device can produce.

*UNKNOWN
The value for this field is unknown.
pages-count-black
The number of pages per minute in black ink that the printer device can produce. This field is an integer value ranging from 1 to 32767.

Element 4: Pages Per Minute Color

The number of pages per minute in color ink that the printer device can produce.

Note: The number of pages per minute in color ink is valid only when *COLOR is specified for element 2.

*UNKNOWN
The value for this field is unknown.
page-count-color
The number of pages per minute in color ink that the printer device can produce. This field is an integer value ranging from 1 to 32767.

Element 5: Location

Briefly describes the location of the printer device.

*BLANK
The location of the printer device is not specified.
location
Specify no more than 30 characters of text, enclosed in apostrophes, to describe where the printer is located.

Element 6: Data Streams Supported

Specifies the data stream formats supported by the printer device.

*UNKNOWN
The value for this field is unknown.
*PCL
The printer device supports PCL (Printer Command Language).
*PS
The printer device supports PostScript.
*PDF
The printer device supports PDF (Portable Document Format).
*IPDS
The printer device supports IPDS (Intelligent Printer Data Stream).
*SCS
The printer device supports SCS (SNA Character String).

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Dependent location name (DEPLOCNAME)

Specifies the dependent local location name used for Dependent LU Requester (DLUR), providing additional security for the connection. If this name is filled in, an activation request (SNA ACTLU) from a Dependent LU Server (DLUS) node must reference this name or it is rejected.

Remote DLUS nodes may optionally accept unsolicited reply PSIDs (Product Set IDs) from the IBM i for auto-definition of LUs at the DLUS node. If so, then this name will be sent to the DLUS node in the reply PSID and it will be returned on the ACTLU request.

If unsolicited reply PSIDs are not supported by the DLUS node, then there will have to be close coordination of the PU name definitions on both systems.

*NONE

No location name is defined.

dependent-location-name

Specify the dependent location name used for DLUR applications.

Remote network identifier (RMTNETID)

Specifies the identifier (ID) of the remote network. This parameter is required when AFP(*YES) and AFPATTACH(*APPC) are specified, or when APPTYPE(*APPINIT) is specified.

*NETATR
The remote network identifier specified in the network attributes is used.
*NONE

No remote network identifier (ID) is used.

remote-network-ID

Specify the ID of the remote network.

Workstation customizing object (WSCST)

Specifies the qualified name of a work station customizing object.

*NONE

No work station customizing object is specified.

work-station-customizing-object

Specify the work station customizing object.

Note: If a work station customizing object is specified for the WSCST parameter, all country keyboard identifiers are valid for ASCII devices except for the following: FQB, FQI, INB, INI, JEB, JEI, JKB, JUB, KAB, KOB, RCB, and TAB.

The possible library values are:

*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.
library-name
Specify the library where the object is located.

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.

*CHANGE
The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
*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.
*USE
The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
*EXCLUDE
The user cannot access the object.
*LIBCRTAUT
The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for 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

Start of change

Example 1: Creating a LAN Printer Device DescriptionEnd of change

Start of changeCRTDEVPRT   DEVD(PRT2)  DEVCLS(*LAN)  TYPE(3812)  MODEL(1)
            ADPTADR(999999999999)  FONT(011)
            MFRTYPMDL(*IBM3812)End of change

Start of change

This command creates a device description for a LAN printer named PRT2. It is a 3812 Model 1 Printer attached to IBM 3812 Pageprinter. It has an adapter address of 999999999999 and uses the Courier font.End of change

Start of change

Example 2: Creating a LAN Printer Device Description using a SNMP user nameEnd of change

Start of changeCRTDEVPRT DEVD(LANPRT) DEVCLS(*LAN) TYPE(3812)  MODEL(1)
          LANATTACH(*IP) PORT(9100) ONLINE(*YES) FONT(11 *NONE)
          FORMFEED(*AUTOCUT) INACTTMR(*SEC15) TRANSFORM(*YES)
          MFRTYPMDL(*HP5) CHRID(*SYSVAL)
          RMTLOCNAME('10.9.100.1')
          SYSDRVPGM(*IBMSNMPDRV) SNMPUSR(BOB)End of change

Start of change

This command creates a device description for a LAN printer named LANPRT. It is a 3812 Model 1 Printer attached to IBM 3812 Pageprinter. It is attached using an IP address and has an SNMP user name specified.End of change

Error messages

*ESCAPE Messages

CPDB12C
Remote location name &2 not in correct format.
CPF261A
Device description &1 not created due to errors.
CPF2631
Device type &2 not valid.
CPDB1B8
Combination of parameters not valid. Reason code is &2.