Create Device Desc (Display) (CRTDEVDSP)

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

The Create Device Description (Display) (CRTDEVDSP) command creates a device description for a display device.

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

Top

Parameters

Keyword Description Choices Notes
DEVD Device description Name Required, Positional 1
DEVCLS Device class *LCL, *RMT, *VRT, *SNPT Required, Positional 2
TYPE Device type 3101, 3151, 3161, 3162, 3163, 3164, 3179, 3180, 3196, 3197, 3277, 3278, 3279, 3476, 3477, 3486, 3487, 5150, 5251, 5291, 5292, 5555, D220, T910, T925, T955, V100, V220, W30, W50, W60, *CALC, *NVT Required, Positional 3
MODEL Device model 0, 1, 2, 4, 5, 11, 3, 12, 23, 31, 32, 41, *ASCII, *DHCF, A1, A2, B1, B2, BA, B01, C01, E01, F01, G01, G02, C1, C2, D1, D2, EA, FA, FC, FD, EC, FE, FG, FW, HC, HG, HA, HW, W1, W2, 0000, 0001, 0002, 0004, 0005, 0011, 0003, 0012, 0023, 0031, 0032, 0041 Required, Positional 4
EMLDEV Emulated twinaxial device 3196A2, 3197D2, *TYPE Optional
PORT Port number 0-17 Optional
SWTSET Switch setting 0, 1, 2, 3, 4, 5, 6 Optional
SHRSSNNBR Shared session number 0, 1, 2, 3 Optional
LOCADR Local location address 00-FE 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
KBDTYPE Keyboard language type *SYSVAL, AGB, AGE, AGI, AGM, ALI, ALM, BGB, BGE, BLI, BLM, BRB, BRE, CAB, CAE, CAI, CAM, CLB, CLE, CSB, CSE, CYB, DMB, DME, DMI, DMM, ESB, FAB, FAE, FAI, FAM, FNB, FNE, FNI, FNM, FQB, FQI, GKB, GNB, GNE, HIB, HNB, HNE, ICB, ICE, ICI, ICM, INB, INI, IRB, ITB, ITE, ITI, ITM, JEB, JEI, JKB, JPB, JPE, JUB, KAB, KOB, LAB, LAE, LTB, LVB, MKB, MKE, NCB, NCE, NEB, NEE, NEI, NEM, NWB, NWE, NWI, NWM, PLB, PLE, PKB, PKE, PRB, PRE, PRI, PRM, RCB, RMB, RME, ROB, ROE, RUB, RUE, SFI, SFM, SGI, SGM, SKB, SKE, SPB, SPE, SPI, SPM, SQB, SQE, SSB, SSE, SSM, SSI, SWB, SWE, SWI, SWM, TAB, THB, THE, TKB, TKE, TRB, TRE, UAB, UAE, UKB, UKE, UKI, UKM, USB, USE, USI, USM, VNB, VNE, YGI, YGM Optional
DROP Drop line at signoff *YES, *NO Optional
ALWBLN Allow blinking cursor *YES, *NO Optional
AUXDEV Auxiliary device Values (up to 31 repetitions): Element list Optional
Element 1: Auxiliary device type 6180, 6182, 6184, 6185, 6186M1, 6186M2, 7371, 7372
Element 2: Auxiliary device address 1-31
PRINTER Printer Name Optional
MAXLENRU Maximum length of request unit *CALC, 241, 245, 247, 256 Optional
APPTYPE Application type *NONE, *NRF, *CTLSSN, *DEVINIT, *APPINIT Optional
ACTTMR Activation timer 1-2550, 170 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
LINESPEED Line speed *TYPE, *CALC, 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, 38400 Optional
WORDLEN Word length *TYPE, *CALC, 7, 8 Optional
PARITY Type of parity *TYPE, *CALC, *EVEN, *ODD, *NONE, *MARK, *SPACE Optional
STOPBITS Stop bits *TYPE, 1, 2 Optional
MAXOUT Maximum outstanding frames 1-7, 7 Optional
IDLTMR Idle timer 10-250, 40 Optional
NRMPOLLTMR NRM poll timer 2-100, 3 Optional
FRAMERTY Frame retry 5-64, 15 Optional
RMTLOCNAME Remote location Communications name Optional
LCLLOCNAME Local location Communications name, *NETATR Optional
RMTNETID Remote network identifier Communications name, *NETATR, *NONE Optional
IGCFEAT DBCS feature Element list Optional
Element 1: Device features Character value
Element 2: Last code point 4141-FFFE
TEXT Text 'description' Character value, *BLANK Optional
DEPLOCNAME Dependent location name Communications name, *NONE Optional
CHRID Character identifier Single values: *SYSVAL, *KBDTYPE
Other values: Element list
Optional
Element 1: Graphic character set 1-32767
Element 2: Code page 1-32767
PRTDEV Print device Name, *SYSVAL Optional
OUTQ Output queue Single values: *DEV
Other values: Qualified object name
Optional
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PRTFILE Printer file Qualified object name Optional
Qualifier 1: Printer file Name, QSYSPRT
Qualifier 2: Library Name, *LIBL, *CURLIB
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
Top

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Top

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 display station. Through a virtual display station, users can access (pass through to) their own system from a remote system. A virtual display station allows the remote system or a personal computer to emulate the interface of the user's own system.

*SNPT

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

Note: ASCII devices must be configured with a device class of *LCL (including ASCII devices attached with modems). To use ASCII display stations as virtual devices, create a virtual device description with the device type of the twinaxial display station that the ASCII display station emulates (for example, a virtual device of device type 3196 for an ASCII display station).

Top

Device type (TYPE)

Specifies the type of device this description represents.

The following type codes are valid for ASCII devices:

Note: Specifying *CALC allows port sharing for ASCII devices. ASCII port sharing allows different device types, using different physical parameters, to use the same port (at different times) without needing to manually reconfigure the port. If *CALC is specified for this parameter, the system automatically calculates the device types for displays attached to this port.

More information on ASCII port sharing is in the Local Device Configuration book, SC41-5121 book or the ASCII Work Station Reference, SA41-3130.

The following are trademarks of Data General, TeleVideo, DEC, Wyse and are valid for ASCII devices:

TYPE
Description
D220
Data General Dasher D220
T910
TeleVideo 910
T925
TeleVideo 925
T955
TeleVideo 955
V100
DEC VT-100
V220
DEC VT-220
W30
Wyse WY30
W50
Wyse WY50
W60
Wyse WY60
Top

Device model (MODEL)

Specifies the model number of the device for this description.

This is a required parameter.

The possible values for the device model for each device type are:

TYPE
MODEL
3179
2
3180
2
3196
A1, A2, B1, B2
3197
C1, C2, D1, D2, W1, W2
3277
0, *DHCF
3278
0, 4, 5, *DHCF
3279
0, 5, *DHCF
3476
EA, EC
3477
FA, FC, FD, FE, FG, FW
3486
BA
3487
HA, HC, HG, HW
5150
1, 2, 3, 4, A1
5251
11
5291
1, 2
5292
1, 2
5555
B01, E01, C01, F01, G01, G02
*NVT
0000

For ASCII devices only:

*ASCII

Specify this value if the model number cannot be easily determined for this display station. 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 display station; see the following table to determine the model number which will be assigned by using *ASCII. It is recommended that you determine your display station's model number if at all possible, and enter that number.

The possible choices are:

TYPE
MODEL
3101
23 (*ASCII)
3151
11 (*ASCII), 31, 41
3161
11 (*ASCII), 12
3162
11 (*ASCII), 12, 31, 32
3163
11 (*ASCII), 12
3164
11 (*ASCII), 12
*CALC
(*ASCII)

The following are trademarks of Data General, TeleVideo, DEC, Wyse and are valid for ASCII devices:

TYPE
Description
D220
Data General Dasher D220
T910
TeleVideo 910
T925
TeleVideo 925
T955
TeleVideo 955
V100
DEC VT-100
V220
DEC VT-220
W30
Wyse WY30
W50
Wyse WY50
W60
Wyse WY60
Top

Emulated device (EMLDEV)

Specifies the twinaxial device emulation to be used by an IBM 3151 or IBM 3162 display. The available emulations are 3196A2, which permits an 80-column display, and 3197D2, which permits a 132-column display.

Note: 3197D2 emulation for an IBM 3151 model 31/41 requires the installation of a "cartridge for expansion" (part number 81X5575) in addition to the appropriate setting of this parameter.

*TYPE

The default value for this parameter is 3196A2.

3196A2

An 80-column display is used.

3197D2

A 132-column display is used.

Top

Port number (PORT)

Specifies the port number for local devices.

For twinaxial devices: Possible values range from 0 through 7.

For ASCII devices: Possible values range from 0 through 17 and indicate the port on the ASCII work station controller to which this device is attached. Without the 12-port expansion feature, ports 0 through 5 are valid. With the 12-port expansion feature, ports 6 through 17 are added.

Top

Switch setting (SWTSET)

Specifies the switch setting for local twinaxial devices.

Valid values range from 0 to 6.

Top

Shared session number (SHRSSNNBR)

Specifies the shared session number for a twinaxial display station. This parameter is valid only for 3486 and 3487 configured device types.

Note: Displays that share session addresses can be attached only to the 2661, 6050, 9146, or the 915A local work station controllers, or to the 5494 remote work station controller.

0

The shared session number is 0.

1

The shared session number is 1.

2

The shared session number is 2.

3

The shared session number is 3.

Top

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
Top

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.

Top

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.

Top

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.

Note: This parameter is ignored when specified on the console or alternate console description.

Top

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.

Top

Keyboard language type (KBDTYPE)

Specifies the country keyboard language identifier for this display station.

NOTES:

  1. When DEVCLS(*RMT) is specified and when TYPE(3277), TYPE(3278), or TYPE(3279) is specified, the following values can be specified: *SYSVAL, AGI, ALI, BGB, BLI, CAI, CSB, DMI, FNI, FAI, HNB, IRB, ITI, JPB, MKB, NWI, PLB, PRI, RMB, RUB, SKB, SPI, SQB, SSI, SWI, TRB, USB, USI, or YGI. Otherwise, this parameter is not valid when DEVCLS(*RMT) is specified.
  2. When TYPE(3486) or TYPE(3487) is specified, the following values can be specified: *SYSVAL, AGB, AGI, ALI, BGB, BLI, CAB, CAI, CLB, CSB, DMB, DMI, FAB, FAI, FNB, FNI, GNB (or GKB), HNB, ICB, ICI, IRB, ITB, ITI, JPB, KAB, MKB, NCB, NEB, NEI, NWB, PLB, PRB, PRI, RMB, RUB, SFI, SGI, SKB, SPB, SPI, SQB, SSB, SSI, SWB, SWI, TKB, TRB, UKB, UKI, USB, USI, or YGI.
  3. This parameter is optional for the combination of DEVCLS(*LCL) and TYPE(5150).
*SYSVAL

Instructs the system to use the QKBDTYPE system value.

keyboard language-type

Specify the 3-character country identifier (used for EBCDIC and ASCII) for this display station.

The following two tables can be used to confirm the appropriate value for this parameter, or to determine which ASCII display devices can be used with a specified language.

For example, assume a user wants to create a 3101 display device. The ASCII displays and device groups table shows that a 3101 display supports ASCII device group A. The Keyboard Mapping table shows that the valid language identifiers that can be used with device group A include AGB, AGI, CAB, CAI, FAB, FAI, ITB, ITI, UKB, UKI, USB, and USI.

The following keyboards can be specified by ASCII displays only if a customizing object is also used: ALI, BGB, CSB, ESB, HNB, LTB, LVB, MKB, PKB, PLB, RMB, RUB, SKB, SQB, TRB, UAB, and YGI.

Identifier
Language(Country) - ASCII Device Groups
ALI
Albania
ALM
Albania Euro Currency
CLB
Arabic X/Basic - D*
CLE
Arabic X/Basic Euro Currency
AGB
Austria/Germany - A, B
AGE
Austria/Germany Euro Currency
AGI
Austria/Germany Multinational - A, B
AGM
Austria/Germany Multinational Euro Currency
BLI
Belgium Multinational - B
BLM
Belgium Multinational Euro Currency
BRB
Brazilian Portuguese
BRE
Brazilian Portuguese Euro Currency
BGB
Bulgaria
BGE
Bulgaria Euro Currency
CAB
Canadian French - A, B
CAE
Canadian French Euro Currency
CAI
Canadian French Multinational - A, B
CAM
Canadian French Multinational Euro Currency
SPB
Catalan
RCB
Chinese (Simplified)
TAB
Chinese (Traditional)
YGI
Croatia
YGM
Croatia Euro Currency
CYB
Cyrillic
CSB
Czech Republic
CSE
Czech Republic Euro Currency
DMB
Denmark - B
DME
Denmark Euro Currency
DMI
Denmark Multinational - B
DMM
Denmark Multinational Euro Currency
ESB
Estonia
FNB
Finland/Sweden - B
FNE
Finland/Sweden Euro Currency
FNI
Finland/Sweden Multinational - B
FNM
Finland/Sweden Multinational Euro Currency
FAB
France (Azerty) - A, B
FAE
France (Azerty) Euro Currency
FAI
France (Azerty) Multinational - A, B
FAM
France (Azerty) Multinational Euro Currency
FQB
France (Qwerty)
FQI
France (Qwerty) International
GNB
Greek (see note)
GNE
Greek Euro Currency
NCB
Hebrew - D*
NCE
Hebrew Euro Currency
HIB
Hindi
HNB
Hungary
HNE
Hungary Euro Currency
ICB
Iceland
ICE
Iceland Euro Currency
ICI
Iceland Multinational
ICM
Iceland Multinational Euro Currency
INB
International
INI
International Multinational
IRB
Iran (Farsi)
ITB
Italy - A, B
ITE
Italy Euro Currency
ITI
Italy Multinational - A, B
ITM
Italy Multinational Euro Currency
JEB
Japan English
JEI
Japan English Multinational
JKB
Japan Kanji
JPB
Japan Latin Extended
JPE
Japan Latin Extended Euro Currency
JUB
Japan U.S. Basic
KAB
Japan Katakana
KOB
Korea
LAB
Lao People's Democratic Republic
LAE
Lao People's Democratic Republic Euro Currency
ROB
Latin-2/ROECE
ROE
Latin-2/ROECE Euro Currency
LVB
Latvia
LTB
Lithuania
MKB
FYR Macedonia (Former Yugoslav Republic)
MKE
FYR Macedonia Euro Currency
NEB
Netherlands
NEE
Netherlands Euro Currency
NEI
Netherlands Multinational
NEM
Netherlands Multinational Euro Currency
NWB
Norway - B
NWE
Norway Euro Currency
NWI
Norway Multinational - B
NWM
Norway Multinational Euro Currency
PLB
Poland
PLE
Poland Euro Currency
PRB
Portugal - B
PRE
Portugal Euro Currency
PRI
Portugal Multinational - B
PRM
Portugal Multinational Euro Currency
RMB
Romania
RME
Romania Euro Currency
RUB
Russia
RUE
Russia Euro Currency
SQB
Serbia (Cyrillic)
SQE
Serbia (Cyrillic) Euro Currency
YGI
Serbia (Latin)
YGM
Serbia (Latin) Euro Currency
SKB
Slovakia
SKE
Slovakia Euro Currency
YGI
Slovenia
YGM
Slovenia Euro Currency
SPB
Spain - B
SPE
Spain Euro Currency
SPI
Spain Multinational - B
SPM
Spain Multinational Euro Currency
SSB
Spanish Speaking - B
SSE
Spanish Speaking Euro Currency
SSI
Spanish Speaking Multinational - B
SSM
Spanish Speaking Multinational Euro Currency
SWB
Sweden - B
SWE
Sweden Euro Currency
SWI
Sweden Multinational - B
SWM
Sweden Multinational Euro Currency
SFI
Switzerland/France Multinational - B
SFM
Switzerland/France Multinational Euro Currency
SGI
Switzerland/Germany Multinational - B
THB
Thailand
THE
Thailand Euro Currency
TKB
Turkey (Qwerty)
TKE
Turkey (Qwerty) Euro Currency
TRB
Turkey (F)
TRE
Turkey (F) Euro Currency
UAB
Ukraine
UAE
Ukraine Euro Currency
UKB
United Kingdom - A, B
UKE
United Kingdom Euro Currency
UKI
United Kingdom Multinational - A, B
UKM
United Kingdom Multinational Euro Currency
USB
United States/Canada - A, B, C
USE
United States/Canada Euro Currency
USI
United States/Canada Multinational - A, B, C
USM
United States/Canada Multinational Euro Currency
PKB
Urdu
PKE
Urdu Euro Currency
VNB
Vietnam
VNE
Vietnam Euro Currency
YGI
Languages of the former Yugoslavia
YGM
Languages of the former Yugoslavia Euro Currency

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.

ASCII Displays and Devices Groups

Display
ASCII Device Group
3101
A
3151
B
3161
B
3162
B
3163
B
3164
B

The following devices are trademarks by TeleVideo, DEC, or Wyse, and must only specify languages in ASCII Device Group C or D:

Display
Description
D220
Data General Dasher D220
T910
TeleVideo 910
T925
TeleVideo 925
T955
TeleVideo 955
V100
DEC VT-100
V220
DEC VT-220 (supports ASCII Device Group D and C)
W30
Wyse WY30
W50
Wyse WY50
W60
Wyse WY60
Top

Drop line at signoff (DROP)

Specifies, for remote display stations, whether the line is disconnected by the system when all devices on the line are no longer in use.

The value specified in the device description can be overridden by a user signing off at the device if the user specifies the Drop line at signoff (DROP) parameter on the SIGNOFF command.

*YES

The switched line to the controller to which this device is attached is disconnected when this device and all other attached devices are no longer in use.

*NO

The switched line is not disconnected from the controller when all of its attached devices are no longer in use.

Top

Allow blinking cursor (ALWBLN)

Specifies whether the (program controlled) blinking cursor is suppressed.

Note: The value specified for this parameter can be overridden by display stations that have a keyboard setup capability that allows the blinking cursor attribute to be changed.

*YES

Allows the cursor to blink for the 3179, 3180, 3196, 3197, 3476, 3477, 3486, 3487, 5251, 5291, and 5292 display devices.

*NO

The blinking cursor is suppressed.

Top

Auxiliary device (AUXDEV)

Specifies the device type and address of an additional device (if any) that is attached to the IEEE-488 port on the 5292 Model 2 device. Up to 31 plotters can be attached to the same IEEE-488 AUXDEV port on the 5292 Model 2, but at different IEEE-488 addresses. The valid additional device types are: 7371 (IBM 7371 Plotter), the 7372 (IBM 7372 Plotter), the 6180 (IBM 6180 Plotter), the 6182 (IBM 6182 Plotter), the 6184 (IBM 6184 Plotter), the 6185 (IBM 6185 Plotter), the 6186M1 (IBM 6186M1 Plotter), and the 6186M2 (IBM 6186M2 Plotter). The valid additional device address is a number from 1 to 31.

You can enter multiple values for this parameter.

Top

Printer (PRINTER)

Specifies, for a remote display station, the device name of the printer associated with the display device. The device description of the work station printer named in this parameter must have already been created and must currently exist on the system. Both the printer and the display device must be attached to the same controller.

Top

Maximum length of request unit (MAXLENRU)

Specifies, for remote display stations and printers, the maximum request unit (RU) length (in bytes) allowed.

*CALC

The system determines the best value to use.

This is the recommended value.

maximum-length-request-unit

Specify 241 or 247. These values are valid only for devices attached to X.25 networks. If the recommended value of *CALC is not specified, it is recommended that 241 be used for ELLC and 247 be used for QLLC. The values 245 and 256 can be specified, but the result is the same as specifying *CALC.

Top

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.

*CTLSSN

The device controls the sessions with *DEVINIT devices.

*DEVINIT

The device starts (initiates) the session.

*APPINIT

The application program starts (initiates) the session.

Top

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.

This parameter is valid only when *SNPT is specified for the DEVCLS parameter.

170

Specifies the activate time of 170 seconds.

activate-time

Specify a number ranging from 1 through 2550 indicating the number of seconds before the device is considered not available.

Top

Inactivity timer (INACTTMR)

Specifies an inactivity timer (time-out) value for display devices. 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 a connection using SNA pass-through (*SNPT) device class support, the default of *ATTACH maps to *NOMAX.

For a device with an application type value of *APPINIT, *CLTSSN, *DEVINIT, or *NRF, the default of *ATTACH maps to 1 minute.

For Post Telephone and Telegraph (*PTT) attachment, valid inactivity timer values are *SEC15 (15 seconds), *SEC30 (30 seconds), and 1 to 10 minutes. *ATTACH maps to *SEC30 (30 seconds).

For all other attachments, valid inactivity timer values are 1 to 30 minutes and *NOMAX. *ATTACH maps to *NOMAX for these attachments.

*ATTACH

This value varies by the value specified on the Physical attachment (ATTACH) parameter and certain values on the Application type (APPTYPE) parameter and Device class (DEVCLS) parameter.

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

Top

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.

Top

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.

Top

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.

Top

Line speed (LINESPEED)

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

*TYPE

The system uses the suggested setting for this device type.

*TYPE selects 19200 bits per second for all display stations except the 3101 display station for which 9600 bits per second is selected. For a 5150 A1 device or a device type of *CALC, *TYPE selects 1200 bits per second.

*CALC

The system automatically calculates the line speed for displays attached to this port. If *CALC is specified, it must also be specified on the Type of parity (PARITY) parameter and the Word length (WORDLEN) parameter.

Note: Specifying *CALC allows port sharing for ASCII devices. ASCII port sharing allows different device types, using different physical parameters, to use the same port (at different times) without needing to manually reconfigure the port.

More information on ASCII port sharing is in the Local Device Configuration book, SC41-5121 book or the ASCII Work Station Reference, SA41-3130.

line-speed

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

Top

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 display stations except the 3101 and D220 display stations which select 7 bit word lengths.
7

Specifies 7-bit word lengths.

8

Specifies 8-bit word lengths.

*CALC

Specifies port sharing. If *CALC is specified, the system automatically calculates the word lengths for displays attached to this port.

More information on ASCII port sharing is in the Local Device Configuration book, SC41-5121 book or the ASCII Work Station Reference, SA41-3130.

Top

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 selects *EVEN (Even parity) for all display stations except for the D220 which selects *MARK. For a 5150 A1 device, *TYPE selects *NONE for an 8 bit word length and *EVEN for a 7 bit word length. If *CALC is specified for the Device type (TYPE) parameter, *TYPE selects *NONE.

*CALC

Specifies port sharing. If *CALC is specified, the system automatically calculates the parity for displays attached to this port.

More information on ASCII port sharing is in the Local Device Configuration book, SC41-5121 book and the ASCII Work Station Reference, SA41-3130.

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

Top

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 selects 1 stop bit for all displays except the DEC VT-100 display station, for which a setting of 2 stop bits is selected.

1

Specifies 1 stop bit.

2

Specifies 2 stop bits.

Top

Maximum outstanding frames (MAXOUT)

Specifies the maximum number of frames that are sent sequentially to a remote system before the remote system (the 5150 work station) must respond. The maximum number of frames must be between 1 and 7. This parameter is valid only if 5150 is specified for the Device type (TYPE) parameter and A1 is specified for the Device model (MODEL) parameter or if ASCII port sharing is being used.

7

The default number of frames sent is 7.

maximum-outstanding-frames

Specify a value from 1 to 7 for the number of frames.

Top

Idle timer (IDLTMR)

Specifies the time (in 0.1 second intervals) that the system waits for a response. If no response is received in the specified amount of time, then error recovery procedures are started. This parameter is valid only if the number is between 10 and 250, and if 5150 is specified for the Device type (TYPE) parameter and A1 is specified for the Device model (MODEL) parameter, or if ASCII port sharing is being used.

40

The default is 4.0 seconds.

idle-timer

Specify a value from 10 to 250 in 0.1 second intervals.

Top

NRM poll timer (NRMPOLLTMR)

Specifies the interval (in 0.1 second intervals) for polling this device when it is in normal response mode (NRM). This parameter is valid only if 5150 is specified for the Device type (TYPE) parameter and A1 is specified for the Device model (MODEL) parameter or if ASCII port sharing is being used.

3

The default is 0.3 seconds.

NRM-poll-timer

Specify a value from 2 to 100 in 0.1 second intervals.

Top

Frame retry (FRAMERTY)

Specifies the number of retries for an unanswered command frame or unacknowledged information frame. This parameter is valid only if 5150 is specified for the Device type (TYPE) parameter and A1 is specified for the Device model (MODEL) parameter or if ASCII port sharing is being used.

15

The default value is 15 retries.

frame-retry

Specify a value from 5 to 64 for the number of retries.

Top

Remote location (RMTLOCNAME)

Specifies the remote location name of the system with which this object communicates.

Note: This parameter is required for APPTYPE(*APPINIT) devices. The remote location name for APPTYPE(*APPINIT) devices is the VTAM/NCP (Virtual Telecommunications Access Method/Network Control Program) name of the physical device.

Top

Local location (LCLLOCNAME)

Specifies the local location name. When this parameter is specified with APPTYPE(*CTLSSN) or APPTYPE(*APPINIT), the remote location name is the name of the independent logical unit (LU) in the network control program (NCP).

*NETATR

The LCLLOCNAME value specified in the system network attributes is used.

local-location-name

Specify the local location name.

Top

Remote network identifier (RMTNETID)

Specifies the name of the remote network identifier (ID). This parameter can be specified for APPTYPE(*APPINIT) devices.

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

Top

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.

Top

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

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.

Top

Character identifier (CHRID)

Specifies the character identifier (graphic character set and code page) that a work station display device supports.

*KBDTYPE

The system determines the graphic character set and code page value that corresponds to the country keyboard language identifier value specified for the Keyboard language type (KBDTYPE) parameter.

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

Specify the graphic character set and code page values that match the attributes of this display device. The graphic character set and code page values must be numbers in the range of 1 through 32767.

Top

Print device (PRTDEV)

Specifies the name of the default printer device for this workstation. If the printer file being used to create the output specifies to spool the file, the spooled file is placed on the device's output queue, which is named the same as the device.

Note: This assumes the defaults are specified on the OUTQ parameter for the printer file, job description, user profile and workstation.

*SYSVAL

The default system printer specified in the system value QPRTDEV is used.

printer-device-name

Specify the name of a printer that is used to print the output.

Top

Output queue (OUTQ)

Specifies the output queue (*OUTQ) object.

The possible output queue name values are:

*DEV

The output queue associated with the printer specified on the DEV parameter of the printer file is used. The output queue has the same name as the printer. (The printer file DEV parameter is determined by the CRTPRTF, CHGPRTF, or the OVRPRTF command).

Note: This assumes the defaults were specified on the OUTQ parameter for the printer file, job description, user profile, and workstation.

output-queue-name

Specify the name of the output queue.

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 is used to locate the output queue. If no current library entry exists in the library list, QGPL is used.

library-name

Specify the name of the library where the output queue is located.

Top

Printer file (PRTFILE)

Specifies an alternative printer device file to be used for processing the Print key on this display station.

The printer file is specified by its qualified name (library-name/print-file-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 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.
Top

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

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

Examples

CRTDEVDSP   DEVD(DSP4)  TYPE(3180)  MODEL(2)
            DEVCLS(*LCL)  PORT(0)
            SWTSET(4)  CTL(CTL01)  KBDTYPE(USB)

This command creates a 3180 Model 2 local device description called DSP4. The display station is located on port 0 of the local work station controller CTL01. The device has an address of 4, with a United States/Canadian keyboard.

Top

Error messages

*ESCAPE Messages

CPF261A
Device description &1 not created due to errors.
CPF2631
Device type &2 not valid.
Top