This topic outlines how to create or change the device
used for a Telnet session.
The following table shows the format of the device description
information, which describes the characteristics of the device to be associated
with this session.
Table 1. Format of the device description informationOffset dec |
Offset hex |
Type |
Field |
0 |
0 |
CHAR(10) |
Device name |
10 |
A |
CHAR(8) |
Device format |
18 |
12 |
CHAR(2) |
Reserved |
20 |
14 |
BINARY(4) |
Offset to device attributes structure |
24 |
18 |
BINARY(4) |
Length of device attributes structure |
28 |
1C |
CHAR(*) |
Device attributes structure |
Device description information field descriptions
- Device name
- The specific virtual device to be associated with this
Telnet session. For DISPLAY devices, if the QAUTOVRT auto-create device system
value allows for it, the device is auto-created by the system if it does not
already exist, and varied on. For PRINT devices, the system auto-creates the
device if it does not already exist. If the exit program supplies no value,
the Telnet server returns to the default of using the traditional Telnet virtual
device selection methods. This should be a valid DISPLAY or PRINT device description
name and must adhere to standard i5/OS® object-naming conventions.
- Device format
- The specific virtual device type that is associated with this Telnet session.
Currently only display devices that the system supports.
- DSPD0100
- Device is a display. The system returns display attributes.
- Reserved
- Reserved for future use.
- Offset to device attributes structure
- The offset from the start of the device description information to the
start of the device attributes structure.
- Length of device attributes structure
- The length in the user space of the device attributes structure.
- INIT0100: Format of display device description information (DSPD0100)
- The following table shows the format of the display device description
information, which describes the characteristics of the device to be associated
with this session.
Table 2. Format of display device description information
(DSPD0100)Offset dec |
Offset hex |
Type |
Field |
0 |
0 |
CHAR(3) |
Keyboard identifier |
3 |
3 |
CHAR(1) |
Reserved |
4 |
4 |
BINARY(4) |
Code page |
8 |
8 |
BINARY(4) |
Character set |
DSPD0100 field descriptions
- Character set
- Specifies the character set that the system is to use for this interactive
job. You can find valid values in National Language Support. This field is
identical to the Character set parameter of the Open Virtual Terminal Path
QTVOPNVT API.
- Code page
- Specifies the code page that the system is to use for this interactive
job. You can find valid values in National Language Support. This field is
identical to the Code page parameter of the Open Virtual Terminal Path QTVOPNVT
API.
- Keyboard identifier
- Specifies the 3 character keyboard identifier that the system is to use
for this interactive job. The keyboard identifier implicitly specifies the
code page and character set to be used, unless overridden as part of the Code
page and Character set parameters. You can find valid identifiers in National
Language Support. This field is identical to the keyboard Language type parameter
of the Open Virtual Terminal Path QTVOPNVT API.
- Reserved
- Reserved for future use