Set VT Mapping Tables (SETVTTBL)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Set VT Mapping Tables (SETVTTBL) command sets ASCII full-screen mapping for the current TELNET session.

Top

Parameters

Keyword Description Choices Notes
CCSID Coded character set identifier 1-65533, *MULTINAT, *BRITISH, *DUTCH, *FINNISH, *FRENCH, *FRENCHCAN, *GERMAN, *ITALIAN, *NORDAN, *SPANISH, *SWEDISH, *SWISS Optional, Positional 1
TBLVTOUT Outgoing EBCDIC/ASCII table Single values: *CCSID, *DFT
Other values: Qualified object name
Optional
Qualifier 1: Outgoing EBCDIC/ASCII table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TBLVTIN Incoming ASCII/EBCDIC table Single values: *CCSID, *DFT
Other values: Qualified object name
Optional
Qualifier 1: Incoming ASCII/EBCDIC table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Coded character set identifier (CCSID)

Specifies the coded character set identifier that identifies the ASCII character encoding in use on the VT100 or VT220 terminal.

Use the CCSID value to change the default mapping for your current TELNET session only. Mapping can optionally be done with mapping tables defined in the TBLVTOUT and TBLVTIN parameters. The TBLVTOUT and TBLVTIN parameters have a default value of *CCSID. The default value of *CCSID indicates mapping is determined by the CCSID parameter. If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLVTOUT parameter. The table object specified in the TBLVTOUT parameter is used instead of the CCSID value.

Incoming mapping can be changed by specifying a table object in the TBLVTIN parameter. This mapping table overrides the specified CCSID value and is used for incoming mapping.

*MULTINAT
The Digital Equipment Company (DEC) multinational character set is in use.
*BRITISH
The DEC British national replacement character set is in use.
*DUTCH
The DEC Dutch national replacement character set is in use.
*FINNISH
The DEC Finnish national replacement character set is in use.
*FRENCH
The DEC French national replacement character set is in use.
*FRENCHCAN
The DEC French Canadian national replacement character set is in use.
*GERMAN
The DEC German national replacement character set is in use.
*ITALIAN
The DEC Italian national replacement character set is in use.
*NORDAN
The DEC Norwegian/Danish national replacement character set is in use.
*SPANISH
The DEC Spanish national replacement character set is in use.
*SWEDISH
The DEC Swedish national replacement character set is in use.
*SWISS
The DEC Swiss national replacement character set is in use.
1-65533
The requested CCSID value is used. This value is validated to ensure a valid ASCII CCSID was requested.

Note: Only ISO 7-bit and ISO 8-bit ASCII CCSID values can be specified.

Top

Outgoing EBCDIC/ASCII table (TBLVTOUT)

Specifies the table object that is to be used to map outgoing TELNET data when in VT100 or VT220 full-screen mode. All outgoing data is mapped from EBCDIC to ASCII.

If a table object is specified for TBLVTOUT, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.

Single values

*CCSID
The table object to be used is determined by using the CCSID parameter and the current language of the user.
*DFT
The default EBCDIC-to-ASCII mapping is used. The value specified for the TBLVTOUT parameter of the Change TELNET Attributes (CHGTELNA) command is used here.

Qualifier 1: Outgoing EBCDIC/ASCII table

name
Specify the name of the table object used for mapping outgoing TELNET data.

Qualifier 2: Library

*LIBL
The library list is used to locate the outgoing mapping table.
*CURLIB
The current library for the job is used to locate the outgoing mapping table. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library where the outgoing mapping table is located.
Top

Incoming ASCII/EBCDIC table (TBLVTIN)

Specifies the table object used to map all incoming TELNET data when in VT100 or VT220 full-screen mode. All incoming data is mapped from ASCII to EBCDIC.

If a table object is specified for TBLVTIN, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping.

Single values

*CCSID
The table object to be used is determined by using the CCSID parameter and the current language of the user.
*DFT
The default ASCII-to-EBCDIC mapping table is used. The value specified for the TBLVTIN parameter of the Change TELNET Attributes (CHGTELNA) command is used here.

Qualifier 1: Incoming ASCII/EBCDIC table

name
Specify the name of the table object used for mapping incoming TELNET data.

Qualifier 2: Library

*LIBL
The library list is used to locate the incoming mapping table.
*CURLIB
The current library for the job is used to locate the incoming mapping table. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library where the incoming table is located.
Top

Examples

SETVTTBL   TBLVTOUT(*DFT)  TBLVTIN(*DFT)

This command sets the EBCDIC-to-ASCII and ASCII-to-EBCDIC mapping tables to the values currently specified for the TBLVTOUT and TBLVTIN parameters of the Change TELNET Attributes (CHGTELNA) command.

Top

Error messages

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9808
Cannot allocate one or more libraries on library list.
CPF9810
Library &1 not found.
CPF9820
Not authorized to use library &1.
CPF9830
Cannot assign library &1.
Top