INIT0100: Format of device description information

Here are the outlines about formats for creating or changing 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 information
Offset 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 IBM® i 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
The 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
The character set that the system uses for this interactive job. You can find valid values in national language support (NLS). This field is identical to the Character set parameter of the Open Virtual Terminal Path (QTVOPNVT) API.
Code page
The code page that the system uses for this interactive job. You can find valid values in NLS. This field is identical to the Code page parameter of the Open Virtual Terminal Path (QTVOPNVT) API.
Keyboard identifier
The 3-character keyboard identifier that the system uses for this interactive job. The keyboard identifier implicitly specifies the code page and character set to be used, unless it is overridden as part of the Code page and Character set parameters. You can find valid identifiers in NLS. This field is identical to the keyboard Language type parameter of the Open Virtual Terminal Path (QTVOPNVT) API.
Reserved
Reserved for future use.