| 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.
| Top |
| 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 |
Specifies the name of the device description.
This is a required parameter.
| Top |
Specifies the device class for this display station or printer.
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 |
Specifies the type of device which the 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:
| Top |
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:
For ASCII devices only:
The possible choices are:
The following devices are trademarks by Data General, TeleVideo, DEC, Wyse and must have a model number of *ASCII specified:
| Top |
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.
| 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.
| 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, 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.
| Top |
Specifies, for ASCII display stations, the physical attachment of the display station to the ASCII work station controller.
| Top |
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.
| Top |
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 |
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 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, 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, for remote display stations and printers, the maximum request unit (RU) length (in bytes) allowed.
| Top |
Specifies the application type used by this device.
| Top |
Specifies, for switched connections, 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.
This parameter is valid only when *SNPT is specified for the DEVCLS parameter.
| 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. The default of *ATTACH maps to *SEC30 (30 seconds).
For all other attachments, valid inactivity timer values are 1 to 30 minutes and *NOMAX. The default of *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).
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.
| 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.
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 |
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.
More information on ASCII port sharing is in the Local Device Configuration book, SC41-5121 book and the ASCII Work Station Reference, SA41-3130.
| 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 |
Specifies the text that briefly describes the object.
| Top |
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 iSeries 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.
| Top |
Specifies the character identifier (graphic character set and code page) that a work station display device supports.
| Top |
Specifies the qualified 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 output queue (*OUTQ) object.
The possible output queue name values are:
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 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 the qualified name of a work station customizing object to be created.
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 |
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.
| Top |
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 |
*ESCAPE Messages
| Top |