1 TELNET Starts a TELNET session and does one of the following: o Displays the TELNET prompt. o Establishes a connection to a remote host. o Establishes a connection to a remote host and runs TN3270. For help with individual TELNET commands, enter the following command: $ TELNET TELNET> HELP DCL Format TELNET [ host ] qualifier(s) [ port ] [unit ] [ /AUTHENTICATE] [ /BIND_SESSION network_device [ /CREATE_SESSION [ /[NO]TIMEOUT=option [/PERMANENT] /PROTOCOL=protocol]] [ /FORWARD UNIX Format telnet [ host ] 2 Parameters host Required with the /CREATE_SESSION qualifier; optional in all other cases. Default: None. Remote host to which you want to connect. Specify one of the following: o Host name o IP address port Required with the /CREATE_SESSION qualifier; ignored in all other cases. Default: None. Specifies the remote port to which you want to connect the pseudo device. unit Required with the /DELETE_SESSION qualifier; optional with the /CREATE_SESSION qualifier; ignored in all other cases. Default: 0. With the /CREATE_SESSION qualifier, specifies the unit number you want associated with the network terminal. The default of 0 allows the TELNET software to select the next available unit number. With the /DELETE_SESSION qualifier, specifies the unit number of the network terminal you want to delete. 2 Qualifiers /AUTHENTICATE Optional. Default: None. Specifies that you want the TELNET session to use Kerberos features. NOTE The /AUTHENTICATE qualifier also can be used with the TELNET commands OPEN and CONNECT. /BIND_SESSION /BIND_SESSION network_device Optional. Default: None. Binds a TELNET terminal device to an existing network device. If the bind is successful, the DCL symbol $TELNET_DEVICE contains the TNA device name. /CREATE_SESSION Optional. Default: None. Specifies that TELNET should create a pseudo device (network terminal) and connect it to the specified remote port. For additional information, see the CREATE_SESSION command. You can use the following qualifiers with CREATE_SESSION: o /NOTIMEOUT o /TIMEOUT=option Options include: NOIDLE IDLE=delta_time_interval Specifies the delta time interval to wait with no activity before closing the connection. The general delta time format is hh:mm:ss:cc. NORECONNECT RECONNECT=delta_time_interval Specifies the delta time interval to wait before retrying a connect request. The general delta time format is hh:mm:ss:cc. o /PERMANENT Optional. o /PROTOCOL=option Optional. Default: NONE. Options include: - NONE Data is sent with no interpretation (raw). - NVT Network Virtual Terminal (NVT), TELNET's internal representation of a standard network terminal. NVT format is standard 7-bit ASCII code transmitted in 8-bit octets, the canonical form of data representation used by both the client and the server. - TELNET Standard TELNET protocol. - RLOGIN Standard RLOGIN protocol. /DELETE_SESSION Optional. Default: None. Specifies that TELNET should delete the specified pseudo device (network terminal). For additional information, see the DELETE_ SESSION command. /FORWARD /FORWARD /NOFORWARD Optional. Default: /NOFORWARD. Forwards a copy of your Kerberos tickets to the remote host. The /NOFORWARD qualifier overrides any forwarding specified in your machine's configuration files. You must request forwardable tickets at the same time that you issue the KINIT command. You must use the /AUTHENTICATE qualifier when you specify the /FORWARD qualifier. /LOG_FILE /LOG_FILE=file Optional. Default: No logging. An optional log file that contains all session output. Using this option does not affect your terminal output. You cannot use this option for TN3270 sessions. /NOINTERACTIVE Optional. Default: TELNET command mode. Disables the capability of using the escape character to leave a session and return to the TELNET prompt. This option is useful when the TELNET command is referenced in a command procedure in a captive account. /PORT /PORT=n Optional. Default: 23. Remote port to which you want your TELNET process to connect. Use this qualifier only if you are connecting to a host that does not use the standard TELNET port. /REALM /REALM=realm-name Optional. Requests Kerberos tickets for the remote host in the specified realm, instead of determining the realm itself. You must use the /AUTHENTICATE qualifier when you specify the /REALM qualifier. /TERMINAL_TYPE /TERMINAL_TYPE=type Optional. Default: None. The type of terminal to emulate. Enter the full specification for one of these terminals: o IBM-3278-2 o IBM-3278-3 o IBM-3278-4 o IBM-3278-5 o VT100 o VT200 o VT300 o VT400 o VT500 /UNBIND_SESSION /UNBIND_SESSION network_device terminal_device Optional. Unbinds a network device (BGx:) from a TELNET terminal device (TNAx:) that was initially bound by a BIND_SESSION command or qualifier. 2 Examples 1.$ TELNET TELNET> ENABLE DEBUG TELNET> SET TERMINAL /DEVICE=VT300 Terminal type is set to VT300 TELNET> CONNECT DEBTS In this example, the TELNET command performs the following actions: o Starts TELNET. o Customizes the environment. o Establishes a connection to host DEBTS and sets up the terminal type as VT300. 2.$ TELNET MYCOM /TERMINAL_TYPE=IBM-3278-2 Establishes a TELNET connection to remote host MYCOM and runs TN3270. 3.$ TELNET 130.180.5.5 Establishes a TELNET connection to the host at IP address 130.180.5.5. 4.$ TELNET UCOM 31 Establishes a TELNET connection to remote host ucom at port 31. 5.$ TELNET/AUTHENTICATE/REALM=jet.mbs.com terse %TELNET-I-TRYING, Trying ... 15.21.308.11 %TELNET-I-SESSION, Session 01, host terse, port 23 %TELNET-I-ESCAPE, Escape character is ^] terse.ucx.ttg.mbs.com This example logs in to system terse with Kerberos credentials. 6.$ TELNET/AUTHENTICATE/FORWARD terse %TELNET-I-TRYING, Trying ... 15.21.308.11 %TELNET-I-SESSION, Session 01, host terse, port 23 %TELNET-I-ESCAPE, Escape character is ^] [Kerberos V5 accepts you as ''j_brown@terse.mbs.com'' ] [Kerberos V5 accepted forwarded credentials ] This example forwards credentials to host terse for user j_ brown.