VTxxx key values

 

VTxxx key values provide keyboard mapping for support of VTxxx emulation. The client session support for both the VT100 and VT220 modes provides a primary and alternate keyboard map.

To accommodate the additional keypad capabilities of the VT220 mode, you can save your keyboard map. By using the F6 key from the Change VTxxx Keyboard Map display, you can save all changes to these keyboard maps for later sessions. The data saves in the user profile, and will automatically apply the next time Telnet VTxxx emulation is activated.

The keyboard option that you select from the Send Telnet Control Functions menu determines which keyboard map you use. Figures 2 through 9 show the VTxxx functions that correspond to the 5250 AID key. The following list gives the option number and the corresponding figures:

The level of support negotiated between the System i™ platform and the Telnet server determines which options display on the Send Telnet Control Functions menu. The menu displays options 6 and 7 if the VT100 full-screen mode support negotiates initially. The menu displays options 8 and 9 if the VT220 full-screen mode support negotiates initially.

There are no differences in the default values of the VT100 primary and alternate keyboard maps.

The following figures show the default keyboard mappings. You can change any of the values. If you press the Enter key, your changes are saved for the current session only. If you press F6 (Save), your changes are saved permanently and are in effect the next time you start a VTxxx Telnet session.

Figure 1. Change VT100 primary keyboard map (Display 1)
                           Change VT100 Primary Keyboard Map                    
 Type changes, press Enter:                                                     
 5250 key               VT100 function                                          
 Function Key 1 . . .   *PF1                                                    
 Function Key 2 . . .   *PF2                                                    
 Function Key 3 . . .   *PF3                                                    
 Function Key 4 . . .   *PF4                                                    
 Function Key 5 . . .   *ESC                                                    
 Function Key 6 . . .   *HIDE                                                   
 Function Key 7 . . .   *TAB                                                    
 Function Key 8 . . .   *CTLA                                                   
 Function Key 9 . . .   *CTLB                                                   
 Function Key 10  . .   *SHIFTDSP                                               
 Function Key 11  . .   *SENDWOCR                                               
 Function Key 12  . .   *CTLC                                                   
 Function Key 13  . .   *CSRUP                                                  
 Function Key 14  . .   *CSRDOWN                                                
 Function Key 15  . .   *CSRRIGHT                                               
 Function Key 16  . .   *CSRLEFT                                                
                                                                   More...      
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 
Figure 2. Change VT100 primary keyboard map (Display 2)
                            Change VT100 Primary Keyboard Map                    
  Type changes, press Enter:                                                    
  5250 key               VT100 function                                         
  Function Key 17  . .   *CTLD                                                  
  Function Key 18  . .   *CTLE                                                  
  Function Key 19  . .   *CTLF                                                  
  Function Key 20  . .   *CTLG                                                  
  Function Key 21  . .   *CTLH                                                  
  Function Key 22  . .   *CTLI                                                  
  Function Key 23  . .   *CTLJ                                                  
  Function Key 24  . .   *CTLK                                                  
  Rollup key . . . . .   *CTLL                                                  
  Rolldown key . . . .   *CTLM                                                  
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                    Bottom      
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 
Figure 3. Change VT100 alternate keyboard map (Display 1)
                            Change VT100 Alternate Keyboard Map                  
  Type changes, press Enter:                                                    
  5250 key               VT100 function                                         
  Function Key 1 . . .   *PF1                                                   
  Function Key 2 . . .   *PF2                                                   
  Function Key 3 . . .   *PF3                                                   
  Function Key 4 . . .   *PF4                                                   
  Function Key 5 . . .   *ESC                                                   
  Function Key 6 . . .   *HIDE                                                  
  Function Key 7 . . .   *TAB                                                   
  Function Key 8 . . .   *CTLA                                                  
  Function Key 9 . . .   *CTLB                                                  
  Function Key 10  . .   *SHIFTDSP                                              
  Function Key 11  . .   *SENDWOCR                                              
  Function Key 12  . .   *CTLC                                                  
  Function Key 13  . .   *CSRUP                                                 
  Function Key 14  . .   *CSRDOWN                                               
  Function Key 15  . .   *CSRRIGHT                                              
  Function Key 16  . .   *CSRLEFT                                               
                                                                    More...     
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 
Figure 4. Change VT100 alternate keyboard map (Display 2)
                            Change VT100 Alternate Keyboard Map                  
 Type changes, press Enter:                                                     
 5250 key               VT100 function                                          
 Function Key 17  . .   *CTLD                                                   
 Function Key 18  . .   *CTLE                                                   
 Function Key 19  . .   *CTLF                                                   
 Function Key 20  . .   *CTLG                                                   
 Function Key 21  . .   *CTLH                                                   
 Function Key 22  . .   *CTLI                                                   
 Function Key 23  . .   *CTLJ                                                   
 Function Key 24  . .   *CTLK                                                   
 Rollup key . . . . .   *CTLL                                                   
 Rolldown key . . . .   *CTLM                                                   
                                                                                                                                                                                             
                                                                                
                                                                                
                                                                                
                                                                      Bott      
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 

You can switch between the primary and alternate keyboard maps during a VTxxx session using the function key assigned to the *KEYPRI and *KEYALT keywords. You can assign these keywords to any of the available 5250 function keys. IBM recommends that you assign *KEYPRI to the Page Up 5250 function key and *KEYALT to the Page Down 5250 function key for both primary and alternate keyboard maps.

Figure 5. Change VT220 primary keyboard map (Display 1)
                            Change VT220 Primary Keyboard Map                    
  Type changes, press Enter:                                                    
  5250 key               VT220 function                                         
 Function Key 1 . . .   *PF1                                                    
 Function Key 2 . . .   *PF2                                                    
 Function Key 3 . . .   *PF3                                                    
 Function Key 4 . . .   *PF4                                                    
 Function Key 5 . . .   *ESC                                                    
 Function Key 6 . . .   *HIDE                                                   
 Function Key 7 . . .   *TAB                                                    
 Function Key 8 . . .   *CTLA                                                   
 Function Key 9 . . .   *CTLB                                                   
 Function Key 10  . .   *SHIFTDSP                                               
 Function Key 11  . .   *SENDWOCR                                               
 Function Key 12  . .   *CTLC                                                   
 Function Key 13  . .   *CSRUP                                                  
 Function Key 14  . .   *CSRDOWN                                                
 Function Key 15  . .   *CSRRIGHT                                               
 Function Key 16  . .   *CSRLEFT                                                
                                                                    More...     
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 
Figure 6. Change VT220 primary keyboard map (Display 2)
                            Change VT220 Primary Keyboard Map                    
 Type changes, press Enter:                                                     
 5250 key               VT220 function                                          
 Function Key 17  . .   *CTLD                                                   
 Function Key 18  . .   *CTLE                                                   
 Function Key 19  . .   *CTLF                                                   
 Function Key 20  . .   *CTLG                                                   
 Function Key 21  . .   *CTLH                                                   
 Function Key 22  . .   *CTLI                                                   
 Function Key 23  . .   *CTLJ                                                   
 Function Key 24  . .   *CTLK                                                   
 Page up (rolldown) .   *KEYPRI                                                 
 Page down (rollup) .   *KEYALT                                                 
                                                                    Bottom      
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 F3=Exit   F6=Save   F12=Cancel                                                 
Figure 7. Change VT220 alternate keyboard map (Display 1)
                            Change VT220 Alternate Keyboard Map                  
 Type changes, press Enter:                                                     
 5250 key               VT220 function                                          
 Function Key 1 . . .   *PF1                                                    
 Function Key 2 . . .   *PF2                                                    
 Function Key 3 . . .   *PF3                                                    
 Function Key 4 . . .   *PF4                                                    
 Function Key 5 . . .   *ESC                                                    
 Function Key 6 . . .   *HIDE                                                   
 Function Key 7 . . .   *TAB                                                    
 Function Key 8 . . .   *CTLA                                                   
 Function Key 9 . . .   *CTLB                                                   
 Function Key 10  . .   *SHIFTDSP                                               
 Function Key 11  . .   *SENDWOCR                                               
 Function Key 12  . .   *CTLC                                                   
 Function Key 13  . .   *CSRUP                                                  
 Function Key 14  . .   *CSRDOWN                                                
 Function Key 15  . .   *CSRRIGHT                                               
 Function Key 16  . .   *CSRLEFT                                                
                                                                   More...      
                                                                                
                                                                                
  F3=Exit   F6=Save   F12=Cancel                                                
Figure 8. Change VT220 alternate keyboard map (Display 2)
                            Change VT220 Alternate Keyboard Map                  
  Type changes, press Enter:                                                    
  5250 key               VT220 function                                         
  Function Key 17  . .   *CTLD                                                  
  Function Key 18  . .   *FINDKEY                                               
  Function Key 19  . .   *INSERTKEY                                             
  Function Key 20  . .   *REMOVEKEY                                             
  Function Key 21  . .   *SELECTKEY                                             
  Function Key 22  . .   *PREVSCN                                               
  Function Key 23  . .   *NEXTSCN                                               
  Function Key 24  . .   *CTLK                                                  
  Rollup key . . . . .   *KEYPRI                                                
  Rolldown key . . . .   *KEYALT                                                
                                                                    Bottom      
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
  F3=Exit   F6=Save   F12=Cancel                                                

You can enter several types of VTxxx information to change the keyboard map. Here are some examples:

Character data: You can assign a character string to a function key. For example, assume that you are on a System i model and are using Telnet to establish a connection with System p™ system. To assign the character string set term=vt100 to the following function key:

Function Key 24 ..   *CTLK

From the system you can type:

Function Key 24  . .   'set term=vt100'

This allows you to press a function key rather than always having to type that character string.

When you press the function key during a VTxxx session, the character string assigned to that function key transmits to the remote system with the carriage return, line feed characters added. If you type data before pressing the function key, the system adds the character string to the data that you type. This allows you to assign a frequently used command string to a function key. The character data that you type maps from EBCDIC to ASCII, before transmission to the remote system.

Control key keywords: You can assign a VTxxx control keystroke to a function key using a defined keyword. For example, if you wanted to assign a different VTxxx control keystroke to the following function key:

Function Key 24  . .   *CTLK

You can type:

Function Key 24  . .   *CTLZ

When you press the function key, the new control character assigned to the function key transmits to the remote system. If you type data before pressing the function key, the control character adds to the typed data and transmits to the remote system.

Hexadecimal data: You can assign a hexadecimal string to a function key. When you press the function key, the hexadecimal data transmits to the remote system. The carriage return, and line feed characters are not added to hexadecimal data. If you type data before pressing the function key, the hexadecimal data adds to the typed data and transmits to the remote system. This allows you to type a character that is not on the 5250 keyboard (for example, square brackets). To assign a hexadecimal string, type X followed by a quoted string of hexadecimal characters, for example, X'1A1A'. The hexadecimal data does not map before transmission to the remote system.

Local i5/OS® control functions: You can assign a keyword to be handled locally within the Telnet client session. These assignments or mappings might not result in the ASCII data stream traffic transmitting to the remote Telnet server session. These local control functions are *HIDE, *SHIFTDSP, *KEYPRI, and *KEYALT. The send without carriage return (*SENDWOCR) function is also a local function, but in this case, the ASCII data streams transmit to the remote Telnet server session.

 

Parent topic:

VTxxx Telnet client sessions

Related concepts
Starting a VTxxx Telnet client session

Related reference
VTxxx emulation options