Start TCP/IP TELNET (TELNET)

The Start TCP/IP TELNET (STRTCPTELN) command is used to start a TELNET client session with a remote system. TELNET is an application protocol that allows a user at one site to access another user at a remote system. This is done as though the remote system were locally attached. TELNET uses the Transmission Control Protocol/Internet Protocol (TCP/IP) to connect to a remote system. The QSYSWRK subsystem must be started before this command can be used.

The operating modes for the TELNET client are:

Parameters

Keyword Description Choices Notes
RMTSYS Remote system Character value, *INTNETADR Required, Positional 1
INTNETADR Internet address Character value Optional
PORT Port 1-65534, *DFT Optional
SSL Secure connection *ENVVAR, *YES, *NO Optional
CTLCHAR Control character key Character value, '&' Optional
KBDTYPE Keyboard language type *LCL, 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, PKB, PKE, PLB, PLE, 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, SSI, SSM, 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, *TRNTBL Optional
PAGEUP Page Up (Roll Down) key *PA2, *PA1, *PA3, *NONE, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24, *CLEAR, *ERASEINP, *CSRSLT Optional
PAGEDOWN Page Down (Roll Up) key *PA1, *PA2, *PA3, *NONE, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24, *CLEAR, *ERASEINP, *CSRSLT Optional
CSRSLT Cursor Select key *NONE, *F1, *F2, *F3, *F4, *F5, *F6, *F7, *F8, *F9, *F10, *F11, *F12, *F13, *F14, *F15, *F16, *F17, *F18, *F19, *F20, *F21, *F22, *F23, *F24 Optional
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
TBL3270OUT Outgoing 3270 mapping table Single values: *KBDTYPE
Other values: Qualified object name		 Optional
Qualifier 1: Outgoing 3270 mapping table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TBL3270IN Incoming 3270 mapping table Single values: *KBDTYPE
Other values: Qualified object name		 Optional
Qualifier 1: Incoming 3270 mapping table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
INZWAIT Timeout wait for host 1-32767, 120, *NOMAX Optional
NUMLCK Numeric lock keyboard *NO, *YES Optional
NULLS Handle nulls *BLANK, *REMOVE Optional
TBLVTDRWO ASCII full screen draw out Single values: *DFT
Other values: Qualified object name		 Optional
Qualifier 1: ASCII full screen draw out Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TBLVTDRWI ASCII full screen draw in Single values: *DFT
Other values: Qualified object name		 Optional
Qualifier 1: ASCII full screen draw in Name
Qualifier 2: Library Name, *LIBL, *CURLIB
VTOPT ASCII full screen options Single values: *NONE, *ALL
Other values (up to 3 repetitions): *LOCALECHO, *AUTOWRAP, *NEWLINE		 Optional
DSPCHRATTR Display character attributes *NO, *YES Optional
PAGESCROLL ASCII page scroll feature *NO, *YES Optional
ANSWERBACK ASCII answerback feature Character value, *NONE Optional
TABSTOP ASCII tab stops Single values: *DFT, *NONE
Other values (up to 10 repetitions): 0-133		 Optional
CCSID Coded character set identifier 1-65533, *MULTINAT, *BRITISH, *DUTCH, *FINNISH, *FRENCH, *FRENCHCAN, *GERMAN, *ITALIAN, *NORDAN, *SPANISH, *SWEDISH, *SWISS Optional
ASCOPRMOD ASCII operating mode ID *VT220B7, *VT220B8, *VT100, *VT52 Optional
RMTVRTDSP Remote virtual display Name, *DFT Optional
RMTUSER Remote user Name, *NONE, *KERBEROS, *CURRENT Optional
RMTPWD Remote password Character value, *NONE Optional
RMTPWDENC Remote password encryption *DES7, *SHA1, *NONE Optional
RMTINLPGM Remote initial program Name, *RMTUSRPRF, *NONE Optional
RMTINLMNU Remote initial menu Name, *RMTUSRPRF, *SIGNOFF Optional
RMTCURLIB Remote current library Name, *RMTUSRPRF Optional
RMTKBDTYPE Remote keyboard type *RMTSYS, *LCL Optional
RMTCODPAG Remote codepage *RMTSYS, *LCL Optional
RMTCHRSET Remote character set *RMTSYS, *LCL Optional
ENBWIDE Enable 3270 wide-screen *CFG, *YES, *NO Optional
NBRFLDS Number of 3270 input fields 126-9999, *CFG, *DFT, *RPY Optional

Remote system (RMTSYS)

Specifies the remote system name. The name must be valid, and the remote system must provide TELNET server support. You can assign names to an internet address. Use the Work with TCP/IP host table entries option on the Configure TCP/IP menu (CFGTCP command). A remote name server also maps remote system names to internet addresses. You can use the Change remote name server option on the CFGTCP menu to specify a remote name server.

This is a required parameter.

*INTNETADR
The remote system is identified by the value specified for the Internet address (INTNETADR) parameter.
character-value
Specify the remote system name to which TELNET is to be started.

Internet address (INTNETADR)

Specifies the IPv4 or IPv6 internet address of the remote system to which TELNET is started.

An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

If the internet address is entered from a command line, the address must be enclosed in apostrophes.

Note: A value must be specified for this parameter if *INTNETADR is specified for the Remote system (RMTSYS) parameter.

character-value
Specify the internet address of the remote system.

Port (PORT)

Specifies a certain port that an application on the target server system is listening on (if it's other than a well-known port for TELNET).

*DFT
This default value uses the well-known port of the TELNET session The well-known ports for TELNET are 23 for a normal connection, and 992 for a secure connection. The SSL KEYWORD determines whether this is a normal or secure connection.
1-65534
Specify the port number to be used. You should be aware of the specific port the remote server application is listening on. Otherwise, a port that is specified (other than 23) can result in the remote host rejecting the open attempt.

Secure connection (SSL)

Specifies whether the TELNET client should attempt to secure the datastream immediately after connecting to the port specified by the PORT keyword. Encryption is provided with either the Secure Sockets Layer (SSL) or the Transport Layer Security (TLS). The selection of TLS or SSL is determined by the outcome of the security negotiation between the TELNET client and server.

Note: The TELNET client must be assigned an appropriate certificate in the Digital Certificate Manager (DCM) or the connection will fail. If the server does not support implicit TLS/SSL on the specified port, or the TLS/SSL negotiation fails for any reason the connection will be closed.

*ENVVAR
Establish a connection based on the QIBM_TELNET_CLIENT_SSL environment variable. If the environment variable value is Y then a secure connection will be established. If the value is not Y or the environment variable does not exist then a normal connection will be established. If the environment variable is set and the PORT KEYWORD is 23 or *DFT, port 992 will be used instead.
*YES
Establish a secure connection.
*NO
Establish normal connection.

Control character key (CTLCHAR)

Specifies the character that is used to represent the control (Ctrl) key on an ASCII keyboard. When this character is used, TELNET interprets the next character as a control character that is to be sent to a remote system. For example, the characters &C indicate that ASCII control character X '03' is sent. This parameter takes effect only if the user is in ASCII line mode, VT100 full-screen mode, or VT220 full-screen mode.

&
An ampersand is used to represent the control key on an ASCII keyboard.
character-value
Specify the control character that represents the control key on an ASCII keyboard. The remote system determines which control characters are valid. However, the ASCII mapping table used by TELNET determines which ASCII character is sent to the remote system.

Keyboard language type (KBDTYPE)

Specifies the type of keyboard used on the display device. This parameter also determines which mapping table is used. This parameter is used for the 3270 and 5250 full-screen modes. This parameter is ignored when the user is in ASCII line mode or VT100 or VT220 full-screen mode. The type of keyboard device is specified by a 3-character value.

*LCL
The device is a local display device. The keyboard type is determined from the display device description.
*TRNTBL
User-defined mapping tables are used for working in the 3270 full-screen mode. The character translation is defined by the mapping tables specified for the Incoming 3270 mapping table (TBL3270IN) and Outgoing 3270 mapping table (TBL3270OUT) parameters. Both the TBL3270IN and TBL3270OUT parameters must be specified when KBDTYPE(*TRNTBL) is specified. KBDTYPE(*TRNTBL) is valid for both local and remote display devices.
display-keyboard-identifier
Specify the three-character keyboard identifier for the language group associated with the display device from which TELNET is entered. This identifier is ignored if the user is requesting to emulate a local 3270 display device.
Albania
ALB
Albania Multinational (Euro)
ALM
Arabic X/Basic
CLB
Arabic (Euro)
CLE
Austria/Germany
AGB
Austria/Germany (Euro)
AGE
Austria/Germany Multinational
AGI
Austria Multinational (Euro)
AGM
Belgium Multinational
BLI
Belgium Multinational (Euro)
BLM
Brazilian Portuguese
BRB
Brazilian Portuguese (Euro)
BRE
Bulgaria
BGB
Bulgaria Multinational (Euro)
BGE
Canadian French
CAB
Canadian French (Euro)
CAM
Canadian French (Euro)
CAE
Canadian French Multinational
CAI
Croatia
YGI
Cyrillic
CYB
Czech Republic
CSB
Czech Republic (Euro)
CSE
Denmark
DMB
Denmark (Euro)
DME
Denmark Multinational
DMI
Denmark Multinational (Euro)
DMM
Estonia
ESB
Finland/Sweden
FNB
Finland/Sweden (Euro)
FNE
Finland/Sweden Multinational
FNI
Finland Multinational (Euro)
FNM
France (Azerty)
FAB
France (Azerty) (Euro)
FAE
France (Azerty) Multinational
FAI
France (Azerty) Multinational (Euro)
FAM
France (Qwerty)
FQB
France (Qwerty) Multinational
FQI
Greece
GNB
Greece (new) (Euro)
GNE
Greece
GKB
Hebrew
NCB
Hebrew (Euro)
NCE
Hindi
HIB
Hungary
HNB
Hungary (Euro)
HNE
Iceland
ICB
Iceland (Euro)
ICE
Iceland Multinational
ICI
Iceland Multinational (Euro)
ICM
International
INB
International Multinational
INI
Iran (Farsi)
IRB
Italy
ITB
Italy (Euro)
ITE
Italy Multinational
ITI
Italy Multinational (Euro)
ITM
Japan
JPB
Japan/English
JPE
Japan (Euro)
JEB
Japan/English Multinational
JEI
Japan/Kanji. (For PS/55* and 5295 display stations)
JKB
Japan United States Basic
JUB
Japan/Katakana. (For 5251, 5291, 5292, and 3180 Katakana display stations)
KAB
Korea
KOB
Lao People's Democratic Republic
LAB
Lao (Euro)
LAE
Lithuania
LTB
Latvia
LVB
Latin 2
ROB
Latin 2 (Euro)
ROE
Macedonia
MKB
Macedonia (Euro)
MKE
Netherlands
NEB
Netherlands (Euro)
NEE
Netherlands Multinational
NEI
Netherlands Multinational (Euro)
NEM
Norway
NWB
Norway (Euro)
NWE
Norway Multinational
NWI
Norway Multinational (Euro)
NWM
Poland
PLB
Poland (Euro)
PLE
Portugal
PRB
Portugal (Euro)
PRE
Portugal Multinational
PRI
Portugal Multinational (Euro)
PRM
Romania
RMB
Romanian (Euro)
RME
Russia/Ukraine
RUB
Russia Multinational (Euro)
RUE
Serbia (Cyrillic)
SQB
Serbia Multinational (Euro)
SQE
Serbia (Latin)
YGI
Simplified Chinese
RCB
Slovakia
SKB
Slovakia (Euro)
SKE
Slovenia
YGI
Spain
SPB
Spain (Euro)
SPE
Spain Multinational
SPI
Spain Multinational (Euro)
SPM
Spanish Speaking
SSB
Spanish Speaking (Euro)
SSE
Spanish Speaking Multinational
SSI
Spanish Speak Multinational (Euro)
SSM
Sweden
SWB
Sweden (Euro)
SWE
Sweden Multinational
SWI
Sweden Multinational (Euro)
SWM
Switzerland/French Multinational
SFI
Switzerland/French (Euro)
SFM
Switzerland/German (Euro)
SGM
Switzerland/German Multinational
SGI
Thailand
THB
Thailand (Euro)
THE
Traditional Chinese
TAB
Turkey (Qwerty)
TKB
Turkey (old) (Euro)
TKE
Turkey (F)
TRB
Turkey (new) (Euro)
TRE
Ukraine
UAB
Ukraine (Euro)
UAE
United Kingdom/English
UKB
United Kingdom (Euro)
UKE
United Kingdom Multinational
UKI
United Kingdom Multinational (Euro)
UKM
United States/Canada
USB
United States/Canada (Euro)
USE
United States/Canada Multinational
USI
United States/Canada Multinational (Euro)
USM
Urdu
PKB
Urdu (Euro)
PKE
Vietnam
VNB
Vietnam (Euro)
VNE
Croatia, Serbia (Latin), and Slovenia
YGI
Croatia, Serbia (Latin), and Slovenia (Euro)
YGM

Note: For example, KBDTYPE(USB) indicates a keyboard using the basic United States/Canada character set.

Page Up (Roll Down) key (PAGEUP)

Specifies which key to assign to the 5250 keyboard Page Up key when it is emulating a 3270 full-screen display device. This parameter is useful because the 3270 does not have a Page Up key. Therefore, when a 5250 display device user is emulating a 3270 display device, the user can continue to benefit from the Page Up key by assigning one of the 3270 keyboard keys to it. This parameter takes effect only in 3270 full-screen mode when the user uses TELNET from a 5250 display device.

*PA2
The PA2 key is assigned to the Page Up key.
*NONE
No key is assigned to the Page Up key.
*F-KEY
A function key (F1 through F24) is assigned to the Page Up key.
*PA1
The PA1 key is assigned to the Page Up key.
*PA3
The PA3 key is assigned to the Page Up key.
*CLEAR
The Clear key is assigned to the Page Up key.
*ERASEINP
The Erase Input key is assigned to the Page Up key.
*CSRSLT
The Cursor Select key is assigned to the Page Up key.

Page Down (Roll Up) key (PAGEDOWN)

Specifies which key to assign to the 5250 keyboard Page Down key when it is emulating a 3270 full-screen display. This parameter is useful because the 3270 does not have a Page Down key. Therefore, when a 5250 display device user is emulating a 3270 display device, the user can continue to benefit from the Page Down key by assigning one of the 3270 keyboard keys to it. This parameter takes effect only in 3270 full-screen mode when the user uses TELNET from a 5250 display device.

*PA1
The PA1 key is assigned to the Page Down key.
*NONE
No key is assigned to the Page Down key.
*F-KEY
A function key (F1 through F24) is assigned to the Page Down key.
*PA2
The PA2 key is assigned to the Page Down key.
*PA3
The PA3 key is assigned to the Page Down key.
*CLEAR
The Clear key is assigned to the Page Down key.
*ERASEINP
The Erase Input key is assigned to the Page Down key.
*CSRSLT
The Cursor Select key is assigned to the Page Down key.

Cursor Select key (CSRSLT)

Specifies which key on the 5250 keyboard is used to emulate a 3270 keyboard Cursor Select key. This parameter takes effect only in 3270 full-screen mode when the user uses TELNET from a 5250 display device.

*NONE
No key is assigned to be the Cursor Select key.
*F-KEY
A function key (F1 through F24) is assigned to be the Cursor Select key.

Outgoing EBCDIC/ASCII table (TBLVTOUT)

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

The remote system controls whether the standard ASCII character set or the ASCII special characters and line drawing character set is in effect.

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

Single values

*CCSID
The CCSID parameter is used to determine outgoing mapping.
*DFT
The CCSID parameter is used to determine outgoing mapping.

Qualifier 1: Outgoing EBCDIC/ASCII table

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

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Incoming ASCII/EBCDIC table (TBLVTIN)

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

The remote system controls whether the standard ASCII character set or the ASCII special characters and line drawing character set is in effect.

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

Single values

*CCSID
The CCSID parameter is used to determine incoming mapping.
*DFT
The CCSID parameter is used to determine incoming mapping.

Qualifier 1: Incoming ASCII/EBCDIC table

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

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Outgoing 3270 mapping table (TBL3270OUT)

Specifies the outgoing mapping table used to translate characters sent to the remote system when in 3270 full-screen mode. This parameter takes effect for 3270 full-screen mode sessions only. This parameter is valid only when *TRNTBL is specified for the Keyboard language type (KBDTYPE) parameter.

Single values

*KBDTYPE
Translation is done by using the language keyboard type specified for the KBDTYPE parameter.

Qualifier 1: Outgoing 3270 mapping table

name
Specify the name of the outgoing mapping table.

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Incoming 3270 mapping table (TBL3270IN)

Specifies the incoming mapping table used to translate characters sent from the remote system when in 3270 full-screen mode. This parameter takes effect for 3270 full-screen mode sessions only. This parameter is valid only when *TRNTBL is specified for the Keyboard language type (KBDTYPE) parameter.

Single values

*KBDTYPE
Translation is done by using the language keyboard type specified for the KBDTYPE parameter.

Qualifier 1: Incoming 3270 mapping table

name
Specify the name of the incoming mapping table.

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Timeout wait for host (INZWAIT)

Specifies the amount of time (in seconds) that a local system waits for a connection to the remote system to be established. If a connection with the remote system does not occur within the time specified by the user, the TELNET session ends, and a message is returned to the user requesting the connection.

120
TELNET waits 120 seconds for the first display from the remote system.
*NOMAX
There is no limit to the amount of time the local system waits for the establishment of the connection with the remote system. Specifying this value can be useful if the requester is uncertain whether the remote system is active.
1-32767
Specify the number of seconds the local system waits for establishing a connection between the local system and the remote system.

Numeric lock keyboard (NUMLCK)

Specifies whether the numeric input fields allow only numeric data on the 5250 display device. This parameter specifies whether the numeric shift lock key, which is used for numeric input fields received from the remote system, is set automatically on the 5250 display device. This parameter takes effect only when the user is in 3270 full-screen mode and is using TELNET from a 5250 display device with a data entry keyboard.

*NO
Numeric input fields are displayed on the 5250 display device with the keyboard shift at the lower setting.
*YES
Numeric input fields are displayed on the 5250 display device with the numeric shift locked at the upper setting. The user can press the Alpha key on the keyboard to reset the numeric shift lock at the lower setting. NUMLCK(*YES) is not valid for 5250 display devices configured with a typewriter keyboard.

Handle nulls (NULLS)

Specifies how the 3270 data stream nulls are processed before being sent to the remote system. This parameter takes effect only in 3270 full-screen mode sessions.

*BLANK
The beginning and embedded nulls are changed to blanks.
*REMOVE
The beginning and embedded nulls are removed from the data stream.

ASCII full screen draw out (TBLVTDRWO)

Specifies the outgoing mapping table used to map outgoing TELNET data when in VT100 or VT220 full-screen mode. All outgoing data is mapped from EBCDIC to ASCII characters and the ASCII line drawing character set. VT100 and VT220 control sequences are not mapped. The remote system controls whether the standard ASCII character set (or national language character set in VT220 mode) or the ASCII special drawing character set is in effect. The mapping table specified for this parameter is used when the special line drawing character set is in effect.

Single values

*DFT
The default EBCDIC-to-ASCII special line drawing mapping table is used.

Qualifier 1: ASCII full screen draw out

name
Specify the name of the outgoing mapping table.

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

ASCII full screen draw in (TBLVTDRWI)

Specifies the incoming mapping table used to map incoming TELNET data when in VT100 or VT220 full-screen mode. All incoming data is mapped from ASCII to EBCDIC characters and the ASCII line drawing character set. VT100 and VT220 control sequences are not mapped. The remote system controls whether the standard ASCII character set (or national language character set in VT220 mode) or the ASCII special drawing character set is in effect. The mapping table specified for this parameter is used when the special line drawing character set is in effect.

Single values

*DFT
The default ASCII-to-EBCDIC special line drawing mapping table is used.

Qualifier 1: ASCII full screen draw in

name
Specify the name of the incoming mapping table.

Qualifier 2: Library

*LIBL
All libraries in the user and system portions of the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

ASCII full screen options (VTOPT)

Specifies the setup options. This parameter is applicable only in VT100 or VT220 full-screen mode.

Single values

*NONE
None of the available setup options are selected.
*ALL
All of the available setup options are selected.

Other values (up to 3 repetitions)

*LOCALECHO
The local echo option is selected. This option allows you to specify whether the remote system or the local terminal displays typed characters.
*NEWLINE
The new line option is selected. This option allows you to specify which characters are transmitted when you press the Enter key. When the NEWLINE option is off, the Enter key transmits a carriage return. When the NEWLINE option is on, the Enter key transmits a carriage return followed by a line feed.
*AUTOWRAP
The automatic wrap option is selected. This option allows you to specify where the next character appears when the cursor reaches the right margin. When the automatic wrap option is on and the cursor is in the last character position of a line, the next character received is put in the first position of the next line. When the automatic wrap option is off and the cursor is in the last character position of a line, the next character received replaces the character in the current position of the cursor.

Display character attributes (DSPCHRATTR)

Specifies whether character attributes are displayed. This parameter is applicable only in VT100 or VT220 full-screen mode. This parameter is not applicable when using a display that supports extended attributes (such as a 3477). Character attributes can be displayed without data loss on such displays.

*YES
Character attributes are displayed.
*NO
Character attributes are not displayed.

ASCII page scroll feature (PAGESCROLL)

Specifies whether paging is used in this session. This parameter is applicable only in VT100 or VT220 mode.

*NO
Paging is not used. Data is displayed as fast as the system allows when received from the remote system.
*YES
Paging is used. Data is displayed one page at a time, and you must press the Page Down (Roll Up) key to move on to the next page of data.

ASCII answerback feature (ANSWERBACK)

Specifies the answerback message. This parameter is applicable only in VT100 or VT220 full-screen mode. You can store an identifying message of up to 20 characters in length that is sent to the remote system when that system transmits an enquire (ENQ) character.

*NONE
No answerback message is specified.
character-value
Specify an answerback message of up to 20 characters in length.

ASCII tab stops (TABSTOP)

Specifies which columns are to contain tab stops. This parameter is applicable only in VT100 or VT220 full-screen mode. A maximum of 10 tab stops can be specified.

Single values

*DFT
The VT100 or VT220 default tab stops are used.
*NONE
No tab stops are specified.

Other values

0-133
Specify the column numbers to contain tab stops.

Coded character set identifier (CCSID)

Specifies the ASCII coded character set identifier (CCSID) in use. This parameter is the default used by the STRTCPTELN command for VT100 and VT220 full-screen mapping. The ASCII CCSID value is used to map between the EBCDIC CCSID of the job and the National Replacement Character set, or the ASCII CCSID value selected with the CCSID parameter.

Mapping can be done optionally with mapping tables defined in the TBLVTOUT and TBLVTIN parameters. The default value for the TBLVTOUT and TBLVTIN parameters is *CCSID, which indicates mapping is determined by the CCSID parameter.

If a mapping table is to be used for outgoing mapping, you can specify a table object in the TBLVTOUT parameter. The table object in the TBLVTOUT parameter is used for outgoing mapping 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.

The special values allowed for the CCSID parameter for the national replacement character set are the Digital Equipment Corporation (DEC) standard character sets. A numeric CCSID value can optionally be used to identify the required ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. If a numeric CCSID value is chosen, the value is validated to ensure it is a valid ASCII CCSID value that is available on the current system.

*MULTINAT
The default is the 8-bit DEC multinational translation table, which consists of the 7-bit compatible standard ASCII Graphics Set (US) and the 8-bit compatible DEC supplemental graphics set.
*BRITISH
British national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*DUTCH
Dutch national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*FINNISH
Finnish national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*FRENCH
French national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*FRENCHCAN
French Canadian national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*GERMAN
German national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*ITALIAN
Italian national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*NORDAN
Norwegian/Danish national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*SPANISH
Spanish national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*SWEDISH
Swedish national language mapping will be initialized when VT100 or VT220 mode is negotiated.
*SWISS
Swiss national language mapping will be initialized when VT100 or VT220 mode is negotiated.
1-65533
Specify the CCSID value to be used. This value is validated to ensure a valid ASCII CCSID was requested.

ASCII operating mode ID (ASCOPRMOD)

Specifies which operating mode the client-TELNET session will be initialized in when VT220 full-screen mode is negotiated.

*VT220B7
The default mode is VT220 7-bit, which transmits all escape sequences using standard VT220 7-bit ASCII communications and can receive and run standard 7-bit ANSI functions.
*VT220B8
VT220-8 bit mode transmits all escape sequences using 8-bit ASCII characters and can receive and run standard 8-bit ANSI functions.
*VT100
VT100 mode transmits all escape sequences using standard VT100 7-bit ASCII communications and can receive and run standard 7-bit ANSI functions.
*VT52
VT52 mode transmits all escape sequences using standard VT52 7-bit ASCII communications. Standard ANSI functions are not supported.

Remote virtual display (RMTVRTDSP)

Specifies a unique device name to be requested on the remote server system.

Note: This parameter is only valid for 5250 connections to servers which support the device naming enhancement as defined in the TN5250E RFC.

*DFT
A device using the default device naming (QPADEVnnn) will be created depending on system values in effect at the remote server system.
name
Specify the device name to be used. A device using this specific name, if not already in use on the target remote system, will be created and assigned to this session.

Remote user (RMTUSER)

Specifies the user profile for automatic sign-on to the remote server system. If a profile is specified for this parameter and password security is active on the target system, *NONE is not valid for the Remote password (RMTPWD) parameter.

If you are connecting to an OS/400 TELNET server, the QRMTSIGN system value must be set to *SAMEPRF or *VERIFY. For TELNET, the *SAMEPRF setting is treated the same as the *VERIFY setting because the TELNET server only receives the user profile name specified on the STRTCPTELN command. It does not receive the user profile name of the job using the STRTCPTELN command and cannot enforce the profiles being the same on both systems.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

*NONE
No user profile is sent and no automatic sign-on occurs.
*KERBEROS
Authentication occurs using Kerberos. The default credentials cache file for the current user is used to locate existing Kerberos ticket-granting tickets. The Add Kerberos Ticket (ADDKRBTKT) command or the Qshell kinit tool can be used to create or refresh expired tickets.

Note: Kerberos needs to be configured on both systems for this authentication method to be used.

*CURRENT
The user profile of the job using the STRTCPTELN command is sent. If the target system allows it, and the user profile exists on the target system, and the password specified for the Remote password (RMTPWD) parameter is valid for the profile, the user is automatically signed on. Otherwise, the user is presented with a sign-on display on the target system, or a failure message on the source system, depending on the configuration of the target system.
name
Specify the name of the user profile to use (that exists) on the target system. If the target system allows it, and the user profile exists on the target system, and the password specified for the Remote password (RMTPWD) parameter is valid for the profile, the user is automatically signed on. Otherwise, the user is presented with a sign-on display on the target system, or a failure message on the source system, depending on the configuration of the target system. If a profile is specified and password security is active on the target system, a password must be specified, even if the profile specified is the same as the current profile.

Remote password (RMTPWD)

Specifies the password being sent to the target system.

If you are connecting to an OS/400 TELNET server, then the QRMTSIGN system value must be set to *SAMEPRF or *VERIFY. For TELNET, the *SAMEPRF setting is treated the same as the *VERIFY setting because the TELNET server only receives the user profile name specified on the STRTCPTELN command. It does not receive the user profile name of the job using the STRTCPTELN command and cannot enforce the profiles being the same on both systems.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

*NONE
The system does not send a password. This value is only valid when *NONE is specified for the Remote user (RMTUSER) parameter, and indicates that no automatic sign-on is to be performed on the target system.
character-value
Specify a password to be sent to the target system to verify the sign-on of the user specified for the RMTUSER parameter. The Remote password encryption (RMTPWDENC) parameter will be used to determine whether or not the password is encrypted prior to sending it to the target system. Choosing *NONE for the RMTPWDENC parameter will result in the password being sent "in the clear" on the network. This will result in traces, like the communications trace, showing the actual password.

Remote password encryption (RMTPWDENC)

Specifies whether the password being sent to the target system should be encrypted prior to sending it to the remote system.

This parameter is only valid when the Remote password (RMTPWD) parameter has a value other than *NONE.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

If the remote system is running OS/400, you should set this parameter based on the release level of the remote system and the system value QPWDLVL on the remote system.

If the encryption algorithm used does not match what is expected by the remote system, the automatic sign-on will fail and the user is presented with a sign-on display on the target system, or a failure message on the source system, depending on the configuration of the target system.

It is strongly recommended that you use the *DES7 or *SHA1 value for this parameter if you are connecting to an OS/400 TELNET server which will accept encrypted passwords. Using the *DES7 or *SHA1 value will ensure that the password cannot be viewed in traces, such as the communications trace.

*DES7
Encrypt the password, using the DES-7 algorithm, prior to sending it to the target system.
*SHA1
Encrypt the password, using the SHA-1 algoritm, prior to sending it to the target system.
*NONE
Do not encrypt the password prior to sending it to the target system. Selecting this value will result in the password being passed "in the clear" on the network. This can result in traces, such as the communications trace, showing the actual password value.

Remote initial program (RMTINLPGM)

Specifies the program that is called immediately after you are automatically signed on to the remote target system.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

*RMTUSRPRF
The initial program specified in the remote user profile is called immediately after automatic sign-on.
*NONE
No program is run before the initial menu is shown, even if an initial program is specified in the remote user profile.
name
Specify the name of the program that is called immediately after automatic sign-on.

Remote initial menu (RMTINLMNU)

Specifies the menu shown when you are automatically signed on to the target system after the initial program is run.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

*RMTUSRPRF
The initial menu specified in the remote user profile is shown immediately after the initial program is run.
*SIGNOFF
A menu is not shown after the initial program is run, even if an initial menu is specified in the remote user profile. After the initial program ends, the user is signed off, and the TELNET session ends.
name
Specify the name of the menu that is shown immediately after the initial program is run.

Remote current library (RMTCURLIB)

Specifies the library that becomes the current library in the library list of the job after automatic sign-on.

Note: This parameter is only valid for 5250 connections to servers which support the automatic sign-on enhancement as defined in the TN5250E RFC.

*RMTUSRPRF
The current library specified in the remote user profile becomes the current library after automatic sign-on.
name
Specify the name of the library that becomes the current library in the library list after automatic sign-on.

Remote keyboard type (RMTKBDTYPE)

Specifies the type of keyboard used on the display device created on the remote server system.

Note: This parameter is only valid for 5250 connections to servers which support the remote keyboard enhancement as defined in the TN5250E RFC.

*RMTSYS
Use the default keyboard type defined on the remote target system.
*LCL
Use the same keyboard type defined in the display device description for this local device.

Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.

Remote codepage (RMTCODPAG)

Specifies the code page on the display device created on the remote server system.

Note: This parameter is only valid for 5250 connections to servers which support the remote code page enhancement as defined in the TN5250E RFC.

*RMTSYS
Use the default code page defined on the remote target system.
*LCL
Use the same code page defined in the display device description for this local device.

Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.

Remote character set (RMTCHRSET)

Specifies the character set on the display device created on the remote server system.

Note: This parameter is only valid for 5250 connections to servers which support the remote character set enhancement as defined in the TN5250E RFC.

*RMTSYS
Use the default character set defined on the remote target system.
*LCL
Use the same character set defined in the display device description for this local device.

Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.

Enable 3270 wide-screen (ENBWIDE)

Specifies whether Telnet 3270 wide-screen support is enabled. This parameter takes effect only for 3270 full-screen mode sessions.

*CFG
The Enable 3270 wide-screen setting configured by the Change TELNET Attributes (CHGTELNA) command is used.
*YES
The Telnet 3270 full-screen mode wide-screen is enabled when the current job work station device supports a 27x132 screen.
*NO
Telnet 3270 full-screen mode will use a 24x80 display.

Number of 3270 input fields (NBRFLDS)

Specifies number of Telnet client 3270 input fields. This parameter takes effect only for 3270 full-screen mode sessions.

*CFG
The Number 3270 input fields setting configured by the Change TELNET Attributes (CHGTELNA) command is used.
*DFT
The system default of 126 input fields is used.
*RPY
The number of input fields defined by the current job work station device and the number provided via 3270 Query Reply.
126-9999
Specify the number of 3270 input fields provided.

Examples

Example 1: Starting a TELNET Client Session 

STRTCPTELN   RMTSYS(CHICAGO)

This command starts a TELNET client session on remote system CHICAGO. The remote name server currently being used by TCP/IP will map the name CHICAGO to an internet address.

Example 2: Starting a TELNET Session Using an IPV4 Internet Address 

STRTCPTELN   RMTSYS(*INTNETADR)  INTNETADR('5.37.197.43')

This command starts a TELNET client session on the remote system that has 5.37.197.43 as its internet address.

Example 3: Starting a TELNET Session Using an IPV6 Internet Address 

STRTCPTELN   RMTSYS(*INTNETADR)  INTNETADR('2001:DB8::1234')

This command starts a TELNET client session on the remote system that has 2001:DB8:0:0:0:0:0:1234 as its internet address.

Error messages

*ESCAPE Messages

CPD87DC
&1 is not a valid keyword on this display.
CPD87DD
Hexadecimal string not valid.
CPD87DF
Character string not valid.
CPF87DA
STRTCPTELN command not allowed from Send TELNET Control Functions Menu
CPF87DB
STRTCPTELN not allowed in pass-through environment.
CPF87D1
The keyboard language type could not be determined.
CPF87D2
Parameter value &3 not valid.
CPF87D3
Internal system error occurred in program &1.
CPF87D4
Data sent exceeded the corresponding I/O request.
CPF87D5
Selected option &1 not valid.
CPF87D6
Selected option &1 not valid.
CPF87D7
Cannot automatically select virtual device.
CPI87DE
Data received from remote system not recognized.