| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Device Description (Display) (CHGDEVDSP) command changes a device description for a display device.
Restriction: 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.
| Top |
| 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 |
| Top |
Specifies the name of the device description being changed.
This is a required parameter.
| Top |
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.
| Top |
Specifies the switch setting for local twinaxial devices.
Valid values range from 0 to 6.
| Top |
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.
| Top |
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.
| Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
| Top |
Specifies the country keyboard language identifier for this display station.
NOTES:
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.
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
The following devices are trademarks by TeleVideo, DEC, or Wyse, and must only specify languages in ASCII Device Group C or D:
| Top |
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.
| Top |
Specifies the character identifier (graphic character set and code page) that a work station display device supports.
| Top |
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.
| Top |
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 |
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.
| Top |
Specifies the name and library of the output queue that is used by the user. The output queue must already exist.
Note: This assumes the defaults were specified on the OUTQ parameter for the printer file, job description, user profile, and workstation.
The possible library values are:
| Top |
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 |
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:
| Top |
Specifies, for remote display stations and printers, the maximum request unit (RU) length (in bytes) allowed.
| Top |
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 system. If the device does not respond within this time, it is considered not available.
| Top |
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.
| Top |
Specifies the name of the associated SNA pass-through device that is attached to a host or advanced program-to-program communications (APPC) controller.
| Top |
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.
| Top |
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.
| Top |
Specifies the line speed in bits per second (bps).
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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 |
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).
| Top |
Specifies the name of the remote network identifier (ID). This parameter can be specified for APPTYPE(*APPINIT) devices.
| Top |
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
Element 2: Last Code Point
| Top |
| Top |
Specifies the qualified name of a 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:
| Top |
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.
| Top |
| Top |