Change Device Desc (Display) (CHGDEVDSP)

The Change Device Description (Display) (CHGDEVDSP) command changes a device description for a display device.

Restrictions: This command cannot be used to remove port sharing (when *CALC was specified for the TYPE and/or LINESPEED parameters of the CRTDEVDSP command). Port sharing for a display device must be removed by first deleting and then recreating its device description.

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
PORT Port number 0-17, *SAME Optional
SWTSET Switch setting 0-6, *SAME Optional
SHRSSNNBR Shared session number *SAME, 0, 1, 2, 3 Optional
LOCADR Local location address 00-FE, *SAME Optional
ONLINE Online at IPL *SAME, *YES, *NO Optional
KBDTYPE Keyboard language type *SAME, *SYSVAL, *NONE, 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, SSI, SSM, 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 *SAME, *YES, *NO Optional
CHRID Character identifier Single values: *KBDTYPE, *SYSVAL, *SAME
Other values: Element list		 Optional
Element 1: Graphic character set 1-32767
Element 2: Code page 1-32767
ALWBLN Allow blinking cursor *SAME, *YES, *NO Optional
AUXDEV Auxiliary device Single values: *SAME, *NONE
Other 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
PRTDEV Print device Name, *SAME, *SYSVAL Optional
OUTQ Output queue Single values: *SAME, *DEV
Other values: Qualified object name		 Optional
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PRINTER Printer Name, *SAME, *NONE Optional
PRTFILE Printer file Single values: *SAME
Other values: Qualified object name		 Optional
Qualifier 1: Printer file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MAXLENRU Maximum length of request unit *SAME, *CALC, 241, 245, 247, 256 Optional
ACTTMR Activation timer 1-2550, *SAME Optional
INACTTMR Inactivity timer 1-30, *SAME, *ATTACH, *NOMAX, *SEC15, *SEC30 Optional
SNPTDEV SNA pass-through device desc Name, *NONE, *SAME Optional
SNPTGRP SNA pass-through group name Name, *NONE, *SAME Optional
LOGON Host signon/logon command Character value, *NONE, *SAME Optional
LINESPEED Line speed *SAME, *TYPE, 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, 38400 Optional
WORDLEN Word length *SAME, *TYPE, 7, 8 Optional
PARITY Type of parity *SAME, *TYPE, *EVEN, *ODD, *NONE, *MARK, *SPACE Optional
STOPBITS Stop bits *SAME, *TYPE, 1, 2 Optional
MAXOUT Maximum outstanding frames 1-7, *SAME Optional
IDLTMR Idle timer 10-250, *SAME Optional
NRMPOLLTMR NRM poll timer 2-100, *SAME Optional
FRAMERTY Frame retry 5-64, *SAME Optional
RMTLOCNAME Remote location Communications name, *SAME Optional
LCLLOCNAME Local location Communications name, *SAME, *NETATR Optional
RMTNETID Remote network identifier Communications name, *SAME, *NETATR, *NONE Optional
IGCFEAT DBCS feature Single values: *SAME
Other values: Element list		 Optional
Element 1: Device features Character value
Element 2: Last code point 4141-FFFE
TEXT Text 'description' Character value, *SAME, *BLANK Optional
WSCST Workstation customizing object Single values: *NONE, *SAME
Other values: Qualified object name		 Optional
Qualifier 1: Workstation customizing object Name
Qualifier 2: Library Name, *LIBL, *CURLIB

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

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.

For LAN printers: Valid values range from 0 through 65535 and indicate to which port the external LAN adapter is attached.

*SAME
The value does not change.
port-number

Specify the port number. Valid values range from 0 through 65535.

Switch setting (SWTSET)

Specifies the switch setting for local twinaxial devices.

Valid values range from 0 to 6.

*SAME
The value does not change.

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.

*SAME
The value does not change.
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.

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
*SAME
The value does not change.

Online at IPL (ONLINE)

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

*SAME
The value does not change.
*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

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
*SAME
The value does not change.
*NONE

No country keyboard language identifier is set for this display station. This is only valid for displays where the keyboard type is not required.

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.

*SAME
The value does not change.
*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.

Character identifier (CHRID)

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

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
*NONE

There are no auxiliary devices.

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.

*SAME
The value does not change.
*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.

Output queue (OUTQ)

Specifies the name and library of the output queue that is used by the user. The output queue must already exist.

*SAME

The value does not change.

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

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.

*SAME
The value does not change.
*NONE

No printer is associated with this display station.

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

*SAME
The value does not change.

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.

Maximum length of request unit (MAXLENRU)

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

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
activate-time

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

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.

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
*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.

*SAME
The value does not change.
*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.

*SAME
The value does not change.
*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.

Line speed (LINESPEED)

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

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
*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.

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

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.
maximum-outstanding-frames

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

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.

*SAME
The value does not change.
idle-timer

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

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.

*SAME
The value does not change.
NRM-poll-timer

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

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.

*SAME
The value does not change.
frame-retry

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

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.

*SAME
The value does not change.

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

*SAME
The value does not change.
*NETATR

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

local-location-name

Specify the local location name.

Remote network identifier (RMTNETID)

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

*SAME
The value does not change.
*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.

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.

*SAME
The value does not change.

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.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text (if any) does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Workstation customizing object (WSCST)

Specifies the qualified name of a work station customizing object.

*SAME
The value does not change.
*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.

Examples 

CHGDEVDSP   DEVD(DSP4)  PORT(1)  SWTSET(5)

This command moves display station DSP4 to port 1 and changes its address to 5. No other device can exist at this location on the same controller.

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.