CRTDEVDSP (Create Device Description (Display))

CRTDEVDSP Command syntax diagram

 

Purpose

The Create Device Description (Display) (CRTDEVDSP) command creates a device description for a display device. More information about using this command is in the Local Device Configuration book for local display stations and in the Communications Configuration book for remote and virtual display stations.

Restriction: If the display device is created as a shared-port device (*CALC is specified on TYPE parameter and/or the LINESPEED, WORDLEN, and PARITY parameters), the device cannot be changed (with the CHGDEVDSP command) to a nonshared-port device. Conversely, if the device is created as a non-port shared device, the device cannot be changed to a shared-port device. Additional information on sharing ports is in the Communications Configuration

book and the Local Device Configuration book.

 

Required Parameters

DEVD
Specifies the name of the device description being created.

DEVCLS
Specifies the device class for this display station.

*LCL: This device description is for a display station connected to a local work station controller.

*RMT: This device description is for a display station 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.

TYPE
Specifies the type of device this description represents.

*CALC: The system determines the value to use.

device-type: Specify one of the following 4-character type codes that describes this type of device.

  • 3179

  • 3180

  • 3196

  • 3197

  • 3277

  • 3278

  • 3279

  • 3476

  • 3477

  • 3486

  • 3487

  • 5150 (any display station attached by a TDLC link)

  • 5251

  • 5291

  • 5292

  • 5555 (on systems supporting DBCS (double-byte character set))

  • *NVT (TCP/IP TELNET Network Virtual Terminal)

The following type codes are valid for ASCII devices:

  • 3101

  • 3151

  • 3161

  • 3162

  • 3163

  • 3164

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

  • *CALC

    Note: The value *CALC allows ASCII devices to share a port. ASCII port sharing allows a port to be used by different ASCII device types with different parameters without being manually reconfigured.

The DEC VT-100 can be configured with a device class of *VRT.

MODEL
Specifies the model number of the device for this description. Specify one of the following model numbers for the device.

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, and FW
3486
BA
3487
HA, HC, HG, and HW
5150
1, 2, 3, A1
5251
11
5291
1, 2
5292
1 Color
5292
2 Graphics
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 assigns a model number (if the device has a model number). The model number (number assigned by the system) may not be the actual model number of the user's display station. It is recommended that the user determine the display station's model number if at all possible, and enter that number.

The possible choices for device model for each device type are as follows:

Type
Model
3101
23
3151
11(*ASCII), 31, 41
3161
11(*ASCII), 12
3162
11(*ASCII), 12, 31, 32
3163
11(*ASCII), 12
3164
11(*ASCII), 12

Type
Model
D220 (Data General Dasher D220)
*ASCII
T910 (TeleVideo 910)
*ASCII
T925 (TeleVideo 925)
*ASCII
T955 (TeleVideo 955)
*ASCII
V100 (DEC VT-100)
*ASCII
V220 (DEC VT-220)
*ASCII
W30 (Wyse WY30)
*ASCII
W50 (Wyse WY50)
*ASCII
W60 (Wyse WY60)
*ASCII
*CALC
*ASCII

 

Optional Parameters

EMLDEV
Specifies the twinaxial display emulation 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 requires the installation of a "cartridge for expansion" in addition to the appropriate setting of this parameter.

*TYPE: The default value for this parameter is 3196A2.

3196A2: An 80-column display results.

3197D2: A 132-column display results.

PORT
Specifies, for local display stations, the port number for this device. Valid values range from 0 through 17.

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

For display stations attached to the ASCII work station controller: Valid values range from 0 through 17 and indicate the port of the ASCII work station controller to which this display station 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.

SWTSET
Specifies for local twinaxial display stations the switch setting or device address for this device. Valid values range from 0 through 6.

SHRSSNNBR
Specifies the shared session number for a twinaxial display station.

Note: Displays that share session addresses can be attached only to the 6050, 2661, 9146 or the 915A local work station controllers, or to the 5494 remote work station controller. This is valid only for 3486 and 3487 device types.

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.

LOCADR
Specifies the local location address. Specify a 2-character hexadecimal value ranging from 00 through FE. The type of controller to which the device is being attached determines which values are valid.

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

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:

ATTACH
LINESPEED
WORDLEN
PARITY
STOPBITS

These restrictions may not apply to ASCII devices emulating supported ASCII device types because the emulating device may have a wider range of choices for these parameters than the emulated ASCII device.

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 is also responsible for verifying that the values selected are valid for the device being configured.

*NO: The device being configured is one of the supported ASCII device types (TYPE parameter), and the device-specific restrictions for the physical attachment, line speed, word length, and stop bits parameters are enforced.

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

ATTACH
Specifies the physical attachment of the display station to the ASCII work station controller. This is a required parameter for displays attached to an ASCII work station controller.

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

*DIRECT: The EIA-232 direct attachment is used.

*MODEM: The EIA-232 modem attachment is used.

*PTT: The Post Telephone and Telegraph (PTT) attachment is used.

*WIRE3: The EIA-232 3-wire attachment is used.

*WIRE4: The EIA-232 4-wire attachment is used.

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

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

*YES: The device is automatically varied on at IPL.

*NO: This device is not automatically varied on at IPL.

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

KBDTYPE
Specifies the country or region 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: The system uses the QKBDTYPE system value.

keyboard-language-type: Specify the 3-character country or region 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.

  • The Keyboard Mapping table shows valid country or region identifiers, the language represented by each identifier, and the ASCII device groups, if applicable, for each language.

  • The ASCII Displays and Device Groups table shows the valid display devices and their associated ASCII device groups.

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, HNB, MKB, PLB, RMB, RUB, SKB, SQB, TRB, and YGI.

Table 1. Keyboard Mapping

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

Table 2. ASCII Displays and Device Groups

 
ASCII
Display		  
 
 		 ASCII
Device
Group
3101 A
3151 B
3161 B
3162 B
3163 B
3164 B
D220 (Data General Dasher** D220) C
T910 (TeleVideo** 910) C
T925 (TeleVideo 925) C
T955 (TeleVideo 955) C
V100 (DEC** VT-100) C
V220 (DEC VT-220) C, D
W30 (Wyse** WY30**) C
W50 (Wyse WY50**) C
W60 (Wyse WY60**) C

DROP
Specifies, for remote display stations, whether the line is disconnected by the system when all display stations on the line are no longer in use. When multiple display stations are attached to the same controller, the line is disconnected only if: (1) the device description for this device specifies DROP (*YES), or DROP (*YES) is specified on the SIGNOFF command when the user signs off the device; (2) all of the other display stations connected to the controller have signed off or are not in use; and (3) all printers attached to the controller are not in use.

The value specified in the device description can be overridden by a user signing off at the device if the DROP parameter on the SIGNOFF command is used.

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

CHRID
Specifies the character identifier (graphic character set and code page) that a work station display device supports. When a display file that was created with the CHRID DDS keyword is used with the device, the system converts data sent to and received from the device to ensure that the correct characters are shown and that the correct hexadecimal byte values are returned to the application program. More information about display file CHRID processing and the translation tables that are used to convert data sent to and received from the display are in the Application Display Programming book.

The CHRID value specified must be based on the attributes of the display device. The Character Identifier Values for Display Devices (CHRID Parameter) table at the end of this parameter description shows CHRID values that are appropriate for each work station display keyboard type. For some display devices, it is not necessary to specify the KBDTYPE parameter, but the KBDTYPE value for the equivalent keyboard can be used to determine the CHRID value for the device.

All characters included in the graphic character sets listed for the Limited CHRID values can be entered at the keyboard or displayed by the device. All characters associated with the Full CHRID values can be entered at the display station (including the use of hexadecimal representations), but the device may not be able to display all the characters.

Values shown in the Limited CHRID column must be used for 5291 and 5292 display stations; all other display stations must use the value shown in the Full CHRID column. All display stations that are to use the OfficeVision licensed program, including 5291 and 5292 display stations, must use the value in the Full CHRID column.

Note: When using keyboard type values (KBDTYPE parameter) for devices that support both single-byte and double-byte data (JKB, KOB, RCB, and TAB), the CHRID values listed are for single-byte data only.

*KBDTYPE: The system determines the best graphic character set and code page for the keyboard specified on the KBDTYPE parameter.

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

Element 1: Character Set

graphic-character-set: Specify the graphic character set values that match the attributes of the display device. 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 display device. Valid values range from 1 through 32767.

Table 3. Character Identifier Values for Display Devices (CHRID Parameter)

Language/ Country or Region Country or Region Keyboard Language Identifier (KDBTYPE) Limited CHRID Full CHRID
International and US ASCII INB 103 038 697 500
Multinational (Latin-1) ALI AGI BLI CAI DMI FAI FNI FQI ICI INI ITI JEI NEI NWI PRI SFI SGI SPI SSI SWI UKI USI   697 500
Multinational (Latin-1) Euro Currency ALM AGM BLM CAM DMM FAM FNM ICM ITM NEM NWM PRM SFM SGM SPM SSM SWM UKM USM   695 1148
Euro Currency BRE NEE PRE USE   695 1140
Euro Currency DME NWE   695 1142
Euro Currency FNE SWE   695 1143
Euro Currency SSE SPE   695 1145
Albania ALI   697 500
Arabic CLB CLE   235 420
Austria/ Germany AGB 265 273 697 273
Austria/ Germany Euro Currency AGE 695 1141
Belgium
Multinational		 BLI   697 500
Brazilian Portuguese BRB   697 037
Bulgaria BGB   1150 1025
Bulgaria Euro Currency BGE   1150 1154
Canada/French CAB CAE 277 260 341 260
Catalan SPB   697 284
Chinese
(Simplified)		 RCB   1174 836
Chinese
(Traditional)		 TAB   101 037
Croatia YGI   959 870
Croatia Euro Currency YGM   959 1153
Cyrillic CYB   960 880
Czech Republic CSB   959 870
Czech Republic Euro Currency CSE   959 1153
Denmark/ Norway DMB NWB 281 277 697 277
Estonia ESB   1307 1122
Finland/Sweden FNB SWB 285 278 697 278
France FAB (Azerty)
FQB (Qwerty)		 288 297 697 297
France Euro Currency FAE   695 1147
Greece GKB GNB GNE   925 875
Hebrew NCB NCE   941 424
Hindi HIB   1467 1137
Hungary HNB   959 870
Hungary Euro Currency HNE   959 1153
Iceland ICB   697 871
Iceland Euro Currency ICE   695 1149
Iran (Farsi) IRB   1219 1097
Italy ITB 293 280 697 280
Italy Euro Currency ITE 695 1144
Japan/English JEB 297 281 697 281
Japan/Latin JPB   1172 1027
Japan/Latin Euro Currency JPE   1172 1399
Japan/Kanji JKB (For Personal System/55*, 5295 and 3477-J display stations)   1172 290
Japan/Katakana KAB KAE (For 5251, 5291, 5292, and 3180 Katakana display stations)   332 290
Japan/United States Basic JUB 697 037
Korean KOB   1173 833
Lao People's Democratic Republic / Euro Currency LAB LAE   1341 1132
Latin 2 ROB   959 870
Latin 2 Euro Currency ROE   959 1153
Latvia LVB   1305 1112
Lithuania LTB   1305 1112
FYR Macedonia (Former Yugoslav Republic) MKB   1150 1025
FYR Macedonia (Former Yugoslav Republic) Euro Currency MKE   1150 1154
Netherlands NEB   697 037
Norway NWB 281 277 697 277
Poland PLB   959 870
Poland Euro Currency PLE   959 1153
Portugal PRB 301 037 697 037
Romania RMB   959 870
Romania Euro Currency RME   959 1153
Russia RUB   1150 1025
Russia Euro Currency RUE   1150 1154
Serbia (Cyrillic) SQB   1150 1025
Serbia (Cyrillic) Euro Currency SQE   1150 1154
Serbia (Latin) YGI   959 870
Serbia (Latin) Euro Currency YGM   959 1153
Slovakia SKB   959 870
Slovakia Euro Currency SKE   959 1153
Slovenia YGI   959 870
Slovenia Euro Currency YGM   959 1153
Spain SPB 305 284 697 284
Spanish Speaking SSB 309 284 697 284
Sweden SWB 285 278 697 278
Switzerland/ French Multinational SFI   697 500
Switzerland/ German Multinational SGI   697 500
Thai THB   1176 838
Thai Euro Currency THE   1176 1160
Turkey TKB (Qwerty)
TRB (F)		   1152 1026
Turkey Euro Currency TKE (Qwerty)
TRE (F)		   1152 1155
Ukraine UAB   1326 1123
Ukraine Euro Currency UAE   1326 1158
United Kingdom/ English UKB 313 285 697 285
United Kingdom/ English Euro Currency UKE   695 1146
United States/ English USB 101 037 697 037
Urdu / Euro Currency PKB PKE   1160 918
Vietnam VNB   1336 1130
Vietnam Euro Currency VNE   1336 1164
Languages of the former Yugoslavia YGI   959 870
Languages of the former Yugoslavia Euro Currency YGM   959 1153

ALWBLN
Specifies whether the (program controlled) blinking cursor is used. For 3179, 3180, 3196, 3197, 3476, 3477, 3486, 3487, 5251, 5291, and 5292 display devices, allowing the cursor to blink may distract the operator.

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

*NO: The blinking cursor is suppressed.

Note: For displays that have the capability of changing the blinking cursor attribute using the keyboard setup feature, the value for ALWBLN in the device description can be overridden.

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 (or a PS/2 emulating a 5292 Model 2 graphics display). Up to 31 plotters can be attached to the same IEEE-488 AUXDEV port on the 5292 Model 2, but they must have different IEEE-488 addresses.

Element 1: Auxiliary Device Types

auxiliary-device-type: Specify the auxiliary device (IBM plotter) that is attached. Valid plotters include the following: 

     7371    6180    6184    6186-1
     7372    6182    6185    6186-2

Element 2: Auxiliary Device Address

auxiliary-device-address: Specify the address ranging from 1 through 31 of the auxiliary device (plotter). Each plotter must have a unique address.

OUTQ
Specifies the qualified name of the output queue used by this user. The output queue must already exist.

*DEV: The output queue specified on the PRTDEV parameter is used.

The name of the output queue can be qualified by one of the following library values:

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

output-queue-name: Specify the name of the output queue.

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 value specified in the system value QPRTDEV is used.

printer-device-name: Specify the name of a printer that is used to print the output for this user.

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 display station must be attached to the same controller. The relationship created by this parameter is used when a related printer (PRINT keyword in DDS) is referred to in a device file used to access this display station.

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

The name of the printer file can be qualified by one of the following library values:

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

QSYSPRT: If a file name is not specified, the precompiler printout is directed to the IBM-supplied printer file QSYSPRT.

print-file-name: Specify the name of the printer device file that performs Print key processing for this display station.

MAXLENRU
Specifies the maximum request unit (RU) length (in bytes) allowed.

*CALC: The system determines the value to use.

maximum-length-request-unit: Specify the maximum length for incoming request units. Values 241 and 256 are valid only for X.25 devices.

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:

  • For display stations attached to an ASCII work station controller, the user's job is canceled when the display station is inactive (no data is sent or received) for a period of time that exceeds the time-out value. The display station is automatically varied off and on again, resulting in a new sign-on display.

  • For display devices connected using SNA pass-through (SNPT) support, the user is informed by a message to QSYSOPR and the session is ended when the amount of time that the device is not bound to a host application exceeds the time-out value. The user must reestablish the connection and session.

  • For display devices with an application type value of *APPINIT, *DEVINIT, or *NRF, the session is ended when the device is inactive (the file opened against the device is closed and no additional requests to open files are received for the device) for a period of time that exceeds the time-out value.


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 Post Telephone and Telegraph (*PTT) attachment, the valid values are *SEC15, *SEC30, and from 1 through 10 minutes. The default of *ATTACH maps to *SEC30 (30 seconds).

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 all other attachments, valid values range from 1 through 30 minutes. The default of *ATTACH has a value of *NOMAX.

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

*NOMAX: Maximum inactivity time is not tracked.

*SEC15: A 15-second time-out period is used.

*SEC30: A 30-second time-out period is used.

inactivity-timer: Specify a time-out value.

APPTYPE
Specifies the application type being used.

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

LINESPEED
Specifies, for display stations attached to the ASCII work station controller, the line speed (in bits per second) used to communicate over the interface (attachment) between the ASCII work station controller and the display station.

*TYPE: The system uses the suggested setting for this device type. If *CALC is specified on the TYPE parameter, *TYPE defaults to 1200.

*CALC: The system determines the value to use.

line-speed: Specify a line speed.

WORDLEN
Specifies, for display stations attached to an ASCII work station controller, the word length (in bits per character) used to communicate with this display station. All display stations support both 7-bit and 8-bit word lengths except for the 3101 and the D220, which only supports 7-bit word lengths.

For modem and PTT attachments (ATTACH(*MODEM) or ATTACH(*PTT)), the word length specified must be the word length selected for the modem.

*TYPE: The system uses the suggested setting for this display station. The value *TYPE specifies 8-bit word lengths for all displays stations, except for the 3101 and the D220 for which 7-bit word lengths are specified.

Note: If *CALC is specified on the TYPE parameter, WORDLEN(*TYPE) defaults to eight.

*CALC: The system determines the value to use.

7: 7-bit word lengths are used.

8: 8-bit word lengths are used.

PARITY
Specifies, for display stations attached to an ASCII work station controller, the type of parity used to communicate with this display station. *TYPE specifies *EVEN for all display stations except for D220; *TYPE specifies *MARK for the D220.

For modem and PTT attachments (ATTACH(*MODEM) or ATTACH(*PTT)), the parity specified must be the parity selected for the modem. *TYPE specifies *EVEN parity for all display stations except the D220. For the D220, *TYPE specifies *MARK. If *CALC is specified on the TYPE parameter, PARITY(*TYPE) defaults to even parity.

*TYPE: The system uses the suggested setting for this display station.

*EVEN: Even parity is used.

*MARK: Mark parity is used.

*NONE: No parity bit is used.

*ODD: Odd parity is used.

*SPACE: Space parity is used.

*CALC: The system determines the value to use.

STOPBITS
Specifies, for display stations attached to an ASCII work station controller, the number of stop bits used to communicate with this display station. All display stations support both 1 and 2 stop bits except for the DEC VT-100, which only supports 2, and the D220, which supports only 1. *TYPE specifies 1 stop bit for all display stations except DEC VT-100 (which is 2). For modem and PTT attachments (ATTACH(*MODEM) or ATTACH(*PTT)), the stop bits specified must be the stop bits selected for the modem. If *CALC is specified on the TYPE parameter but not on the LINESPEED parameter, STOPBITS(*TYPE) defaults to one.

*TYPE: The system uses the suggested setting for this display station.

1: One stop bit is used.

2: The page width is 132 printed characters per line.

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.

This parameter is valid only if TYPE(5150) MODEL(A1) is specified.

7: Rotation of the text is done 270 degrees clockwise from the 0 degree writing position.

maximum-outstanding-frames: Specify a value ranging from 1 through 7 for the maximum number of frames sent before the remote system must respond.

IDLTMR
Specifies the time (in 0.1 second intervals) that the system waits for a response. If no response is received, error recovery procedures are started. This parameter is valid only if TYPE(5150) MODEL(A1) is specified.

40: The system waits 4.0 seconds.

idle-timer: Specify a value ranging from 10 through 250 in 0.1-second intervals.

NRMPOLLTMR
Specifies the interval (in 0.1 second intervals) for polling this device when it is in normal response mode (NRM).

3: Normal response mode polling is done at 0.3-second intervals.

NRM-poll-timer: Specify a value ranging from 2 through 100 in 0.1-second intervals.

This parameter is valid only if TYPE(5150) MODEL(A1) is specified.

FRAMERTY
Specifies the number of retries for an unanswered command frame or unacknowledged information frame. This parameter is valid only if TYPE(5150) MODEL(A1) is specified.

15: The default value is 15 retries.

frame-retry: Specify a value ranging from 5 through 64 for the number of retries.

WSCST
Specifies the qualified name of a work station customizing object to be created.

*NONE: No work station customizing object is specified.

The name of the work station customizing object can be qualified by one of the following library values:

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

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 or region keyboard identifiers are valid for ASCII devices except for the following: FQB, FQI, INB, INI, JEB, JEI, JKB, JUB, KAB, KOB, RCB, and TAB. See the Keyboard Mapping table for a list of the country or region keyboard identifiers.

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.

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.

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

*NETATR: The RMTNETID value specified in the system network attributes is used.

*NONE: No remote network identifier (ID) is used.

remote-network-ID: Specify the name of the remote network identifier.

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 Device

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 (or Taiwan)
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.

Table 4. DBCS-Capable Display Device Features (IGCFEAT Parameter)

Type of Physical Work Station Type-Model Device Feature/ Last Code Point
Japanese Display Stations
5295-001 Display Station 5555-B01 2424J4 55FE
5295-002 Display Station 5555-B01 2424J4 68FE
InfoWindow 3477-J Display Station 5555-B01, C01 2424J4 68FE
Personal System/55* running 5250PC 5555-B01 2424J4 68FE
Personal System/55 running graphics-capable 5250PC 5555-G01 2424J4 68FE
Personal System/55 running graphics-capable 5250PC 5555-G02 2424J4 68FE
Personal System/55 running 5250PC/2 5555-E01 2424J0
Personal System/55 running Client Access/400 by OS/400 System 5555-B01 2424J0
3270-type Display Stations* 3279-0 2424J0
Korean Display Stations
5250-Type Display Stations 5555-B01 2424K0
3270-type Display Stations* 3279-0 2424K0
Traditional Chinese Display Stations
5250-Type Display Stations 5555-B01 2424C0
3270-type Display Stations* 3279-0 2424C0
Simplified Chinese Display Stations
5250-Type Display Stations 5555-B01 2424S0
3270-type Display Stations* 3279-0 2424S0

ACTTMR
Specifies, for switched lines, the amount of time (in seconds) that the SNA pass-through support waits for the device to respond to the activation request from the host iSeries 400. If the device does not respond within this time, it is considered not available.

170: Specifies the activate time of 170 seconds.

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

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.

SNPTGRP
Specifies the name configured for a group of host devices in a configuration list. 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.

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 text that is sent to the host system after starting SNA pass-through support.

Specifies the logon string that is sent to the system services control point (SSCP) on the host network when the file is opened.

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

DEPLOCNAME
Specifies the dependent local location name used for dependent LU requestor (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 iSeries 400 for auto-definition of LUs at the DLUS node. If so, then this name is sent to the DLUS node in the reply PSID and it is 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.

AUT
Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 device description.

*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the device description.

authorization-list-name: Specify the name of the authorization list used.

TEXT
Specifies the text that briefly describes the device file. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTDEVDSP 

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.

Error messages for CRTDEVDSP

*ESCAPE Messages

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