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 ]
1 – 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
2.1 /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.
2.2 /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.
2.3 /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.
2.4 /DELETE_SESSION
Optional. Default: None.
Specifies that TELNET should delete the specified pseudo device
(network terminal). For additional information, see the DELETE_
SESSION command.
2.5 /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.
2.6 /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.
2.7 /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.
2.8 /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.
2.9 /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.
2.10 /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
2.11 /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.
3 – 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.