| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
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:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTSYS | Remote system | Character value, *INTNETADR | Required, Positional 1 |
| INTNETADR | Internet address | Character value | 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, 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, LAE, MKB, MKE, NCB, NCE, NEB, NEE, NEI, NEM, NWB, NWE, NWI, NWM, 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, UAE, UKB, UKE, UKI, UKM, USB, USE, USI, USM, 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 |
| PORT | Port | 1-65534, *DFT | Optional |
| RMTVRTDSP | Remote virtual display | Name, *DFT | Optional |
| RMTUSER | Remote user | Name, *NONE, *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 |
| Top |
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.
| Top |
Specifies the internet address of the remote system to which TELNET is started. The internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An 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. 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.
| Top |
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.
| Top |
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.
Note: For example, KBDTYPE(USB) indicates a keyboard using the basic United States/Canada character set.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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
Qualifier 1: Outgoing EBCDIC/ASCII table
Qualifier 2: Library
| Top |
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
Qualifier 1: Incoming ASCII/EBCDIC table
Qualifier 2: Library
| Top |
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
Qualifier 1: Outgoing 3270 mapping table
Qualifier 2: Library
| Top |
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
Qualifier 1: Incoming 3270 mapping table
Qualifier 2: Library
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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
Qualifier 1: ASCII full screen draw out
Qualifier 2: Library
| Top |
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
Qualifier 1: ASCII full screen draw in
Qualifier 2: Library
| Top |
Specifies the setup options. This parameter is applicable only in VT100 or VT220 full-screen mode.
Single values
Other values (up to 3 repetitions)
| Top |
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.
| Top |
Specifies whether paging is used in this session. This parameter is applicable only in VT100 or VT220 mode.
| Top |
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.
| Top |
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
Other values
| Top |
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.
| Top |
Specifies which operating mode the client-TELNET session will be initialized in when VT220 full-screen mode is negotiated.
| Top |
Specifies a certain port that an application on the target server system is listening on (if it's other than well-known port 23 for TELNET).
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.
| Top |
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.
Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.
| Top |
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.
Note: An invalid combination of Remote keyboard type, Remote character set and Remote code page will result in unpredictable results.
| Top |
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 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.
| Top |
*ESCAPE Messages
| Top |