The MultiNet TELNET utility uses the Internet-standard TELNET protocol to establish a virtual terminal connection between your terminal and a remote host. This appendix lists the commands you can use during a TELNET session.
The below table lists the TELNET commands:
|
Command: |
Description: |
|
ABORT |
Sends an ABORT OUTPUT sequence to the remote host. |
|
ATTACH |
Detaches the terminal from the calling process and reattaches it to another process. |
|
ATT |
Sends an INTERRUPT PROCESS sequence to the remote host. |
|
AYT |
Sends an ARE YOU THERE sequence to the remote host. |
|
BINARY |
Attempts to negotiate binary (8-bit) mode with the remote system. |
|
BREAK |
Sends a BREAK sequence to the remote host. |
|
BYE |
Closes any open TELNET connection and exits to DCL. |
|
CLOSE |
Closes the TELNET connection. |
|
CONNECT |
Establishes a TELNET connection to a host. |
|
CREATE-NTY |
Connects the local end of a TELNET connection to an NTY pseudo-terminal device. |
|
DEBUG |
Displays TELNET option negotiations. |
|
ECHO |
Turns on or off remote host character echoing. |
|
EXIT |
Closes any open TELNET connection and exits to DCL. EXIT is the same as BYE and QUIT. |
|
HELP |
Displays help information for the specified TELNET command. |
|
LOG_FILE |
Enables or disables logging of the TELNET session. |
|
PUSH |
Starts and attaches a DCL subprocess. |
|
QUIT |
Closes any open TELNET connection and exits to DCL. QUIT is the same as EXIT. |
|
SET ABORT-OUTPUT-CHARACTER |
Sets the character that TELNET maps to the ABORT OUTPUT sequence. |
|
SET ARE-YOU-THERE-CHARACTER |
Sets the character that TELNET maps to the ARE YOU THERE sequence. |
|
SET AUTO-FLUSH |
Turns auto-flushing on or off. |
|
SET BREAK-CHARACTER |
Sets the character that TELNET maps to the BREAK sequence. |
|
SET DEBUG |
Enables or disables the display of TELNET option negotiations. |
|
SET ERASE-CHARACTER-CHARACTER |
Sets the character that TELNET maps to the ERASE CHARACTER sequence. |
|
SET ERASE-LINE-CHARACTER |
Sets the character that TELNET maps to the ERASE LINE sequence. |
|
SET ESCAPE-CHARACTER |
Sets the character that switches TELNET to command mode. |
|
SET EXTENDED |
Causes TELNET to go into extended command mode automatically whenever you type the TELNET ESCAPE character, Ctrl+^ by default. |
|
SET INTERRUPT-PROCESS-CHARACTER |
Sets the character that TELNET maps to the INTERRUPT PROCESS sequence. |
|
SET LOCAL-FLOW-CONTROL |
Specifies whether or not Ctrl+S and Ctrl+Q should be treated by the local terminal driver as XON and XOFF. |
|
SET LOG-FILE |
Enables or disables logging of the TELNET session. |
|
SET REMOTE-USERNAME |
Specifies the user name to which you want to log in using Kerberos. |
|
SET UNIX-LINE-TERMINATOR |
Causes TELNET to use the 4.3BSD UNIX end-of-line specification, Ctrl+NULL. |
|
SPAWN |
Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. |
|
STATUS |
Displays the status of the current TELNET connection and parameters. |
|
TERMINAL-TYPE |
Specifies a terminal type for the TELNET session. |
|
VERSION |
Displays the TELNET version number. |
Sends an ABORT OUTPUT sequence to the remote host. If the remote host is running MultiNet, the TELNET ABORT OUTPUT sequence is treated as a Ctrl+O.
ABORT
Use this command only in extended mode.
This example sends the ABORT OUTPUT sequence to the remote system.
TELNET>abort
Detaches the terminal from the calling process and reattaches it to another process. Use the SPAWN SHOW PROCESS /SUBPROCESSES command to list the names of subprocesses. Use the DCL LOGOUT command to return to the original process. If the MULTINET_DISABLE_SPAWN logical is enabled, ATTACH does not work.
ATTACH process-name
process-name
Specifies the name of a process to which you want your terminal attached. (Not all subprocesses can be attached; some testing may be required.)
Sends an INTERRUPT PROCESS sequence to the remote host. If the remote host is also running MultiNet, the TELNET INTERRUPT PROCESS sequence is treated as a Ctrl+C.
ATTN
Use this command only in extended mode.
This example sends the INTERRUPT PROCESS sequence to the remote system.
TELNET>attn
Sends an ARE YOU THERE sequence to the remote host. If the remote host is also running MultiNet, the ARE YOU THERE sequence is treated as a Ctrl+T.
|
Note: AYT does not work if the terminal is not enabled for broadcasts. Invoke the DCL command SET TERMINAL /BROADCAST before using AYT if broadcasts have been disabled.
|
AYT
This example shows how to ensure the host is still active.
TELNET>ayt
EXAMPLE::_VTA81: 01:37:57 (DCL) CPU=00:00:01.83 PF=2298 IO=530 MEM=345
Attempts to negotiate binary (8-bit) mode with the remote system.
BINARY
Use this command only in extended mode.
TELNET>binary
Sends a BREAK sequence to the remote host. If the remote host is running MultiNet, the BREAK sequence is treated as a Ctrl+C.
BREAK
Use this command only in extended mode.
TELNET>break
Closes any open TELNET connection and exits to DCL. BYE is the same as EXIT.
BYE
TELNET>bye
$
Closes the TELNET connection.
CLOSE
If you specified the remote host in the DCL TELNET command, exit to DCL. If you connected to the remote host in TELNET command mode, return to general command mode.
On most remote hosts, closing the connection is seen as a modem-style terminal hang-up. If the remote host is also running MultiNet and OpenVMS virtual terminals are enabled, the remote login session becomes detached.
Use this command only in extended mode.
TELNET>close
Establishes a TELNET connection to a host. TELNET connections may be established using INTERNET protocols; the default is INTERNET.
CONNECT [protocol] host [port]
protocol
Specifies the protocol to use to establish the connection. The protocol is INTERNET (the default).
host
Specifies the host to which to establish the connection. With the INTERNET protocol, the host can be a name or a numeric IP address.
port
Specifies the remote port number or name to use for the connection. With the INTERNET protocol, the default is the TELNET port.
Do not use this command in extended mode.
This example shows how to connect to a remote system.
TELNET>connect internet unix
Trying... Connected to UNIX.EXAMPLE.COM
login:
Connects the local end of a TELNET connection to an NTY pseudo-terminal device. This device can be used by other applications such as KERMIT. This command includes the remote host and port number in the SHOW TERMINAL “remote port information” field.
CREATE-NTY
TELNET>create-nty
TELNET session now connected to _NTY3:
%DCL-I-ALLOC, _NTY3: allocated
$
Displays TELNET option negotiations.
DEBUG [mode]
mode
Specifies whether debugging is enabled (default) or disabled (OFF). Debug mode causes TELNET to display option negotiations between the local host and the foreign host.
This example shows how to enable DEBUG mode.
TELNET>debug on
Turns on or off remote host character echoing.
ECHO mode
mode
Specifies whether the server handles character echoing. If you specify OFF, TELNET performs local character echoing. If you specify ON, the remote system performs the echoing.
Use this command only in extended mode.
TELNET>echo off
Closes any open TELNET connection and exits to DCL. EXIT is the same as BYE and QUIT.
EXIT
This example shows how to exit TELNET.
TELNET>exit
$
Displays help information for the specified TELNET command. Type HELP ? to see a list of HELP topics, or type HELP with no argument to see general information regarding TELNET.
HELP [command]
command
Specifies information about this command.
TELNET>help
HELP
Displays help information for the specified TELNET command.
Type HELP ? to see a list of HELP topics, or type HELP with no
argument to see general information regarding TELNET.
Format
HELP [command]
Additional information available:
ATTACH BYE CONNECT
DEBUG EXIT HELP LOG-FILE
PUSH QUIT SET SPAWN STATUS TERMINAL-TYPE
VERSION
Topic?
Enables or disables logging of the TELNET session. If you specify a log_file, everything received by the local system from the remote system is copied into this file.
LOG-FILE log_file
log_file
Specifies a file to which to write a log of the TELNET session. If you do not specify a file, logging is enabled to the file TELNET.LOG. If you specify the file name NONE, logging is disabled.
LOG-FILE is not supported in 3270 or 5250 modes.
This example shows how to enable TELNET output to be logged to the file ST_TMP:DEBUG.LOG.
TELNET>log-file
st_tmp:debug.log
[Log file open (ST_TMP:<TMP>DEBUG.LOG.1)]
TELNET>
Starts and attaches a DCL subprocess. If a parent process exists, attach to it. To return from DCL, use the ATTACH or the LOGOUT command. To switch back from a DCL subprocess, use the ATTACH command. If the MULTINET_DISABLE_SPAWN logical is set, PUSH does not work.
PUSH
Closes any open TELNET connection and exits to DCL. QUIT is the same as EXIT.
QUIT
This example shows how to exit TELNET.
TELNET>quit
$
Sets the character that TELNET maps to the ABORT OUTPUT sequence. The value set by this command is not the character passed to the remote host. The remote host receives an ABORT OUTPUT sequence; SET ABORT-OUTPUT-CHARACTER defines the key you press to tell TELNET to send an ABORT OUTPUT sequence. This character can also be set by invoking TELNET with the /ABORT_OUTPUT_CHARACTER qualifier.
SET ABORT-OUTPUT-CHARACTER character
character
Specifies which character sends the ABORT OUTPUT sequence to the TELNET server. If you type the command without specifying character, it defaults to Ctrl+O.
This example sets the ABORT OUTPUT character to Ctrl+A.
TELNET>set
abort "^A"
[Abort Output character set to ^A]
TELNET>
Sets the character that TELNET maps to the ARE YOU THERE sequence. The value set by this command is not the character passed to the remote host. The remote host receives an ARE YOU THERE sequence; SET ARE-YOU-THERE-CHARACTER defines the key you press to tell TELNET to send an ARE YOU THERE sequence. This character can also be set by invoking TELNET with the /ARE_YOU_THERE_CHARACTER qualifier. The ARE YOU THERE sequence can be sent by pressing the ARE YOU THERE character or by issuing the TELNET AYT command.
|
Note: The ARE YOU THERE sequence only displays an information line from the host if broadcasts are enabled for the terminal.
|
SET ARE-YOU-THERE-CHARACTER character
character
Specifies which character sends the ARE YOU THERE sequence to the TELNET server. If you type the command without specifying character, it defaults to Ctrl+T.
This example sets the ARE YOU THERE character to Ctrl+T.
TELNET>set
are-you-there "^T"
[Are-You-There character set to ^T]
TELNET>
Turns auto-flushing on or off. You can also set this mode by invoking TELNET with the /AUTOFLUSH qualifier.
When you define an ABORT-OUTPUT character, enabling AUTO-FLUSH (SET AUTO-FLUSH ON) causes TELNET to flush any data which may be in the network buffers when the ABORT-OUTPUT character is typed. The TELNET client does this by sending a TIMING-MARK command to the TELNET server and discarding all data until one is received in response.
SET AUTO-FLUSH mode
mode
Turns auto-flush ON or OFF. If you do not specify mode, it defaults to ON.
This example sets the Auto Flush option on.
TELNET>set
auto-flush on
TELNET>
Sets the character that TELNET maps to the BREAK sequence. The value set by this command is not the character passed to the remote host. The remote host receives a BREAK sequence; SET BREAK-CHARACTER defines the key you press to tell TELNET to send a BREAK sequence. You can also set this character by invoking TELNET with the /BREAK_CHARACTER qualifier.
SET BREAK-CHARACTER character
character
Specifies which character sends the BREAK sequence to the TELNET server. If you type the command without specifying character, it defaults to Ctrl+A.
This example sets the BREAK character to Ctrl+A.
TELNET>set
break "^A"
[Break character set to ^A]
TELNET>
Enables or disables the display of TELNET option negotiations. You can also set this mode by invoking TELNET with the /DEBUG qualifier.
SET DEBUG [mode]
mode
Turns debugging ON or OFF. If mode is not specified, the default is ON.
This example enables DEBUG mode.
TELNET>set debug on
Sets the character that TELNET maps to the ERASE CHARACTER sequence. The value set by this command is not the character passed to the remote host. SET ERASE-CHARACTER-CHARACTER defines the key you press to tell TELNET to send an ERASE CHARACTER sequence. This character can also be set by invoking TELNET with the /ERASE_CHARACTER_CHARACTER qualifier.
SET ERASE-CHARACTER-CHARACTER character
character
Specifies which character sends the ERASE CHARACTER sequence to the TELNET server. If you type this command without specifying character, it defaults to DEL.
This example sets the ERASE CHARACTER to Ctrl+A.
TELNET>set
erase "^A"
[Erase character set to "^A"]
TELNET>
Sets the character that TELNET maps to the ERASE LINE sequence. The value set by this command is not the character passed to the remote host; SET ERASE-LINE-CHARACTER defines the key you press to tell TELNET to send an ERASE LINE sequence. This character can also be set by invoking TELNET with the /ERASE_LINE_CHARACTER qualifier.
SET ERASE-LINE-CHARACTER character
character
Specifies which character sends the ERASE LINE sequence to the TELNET server. If you type the command without specifying character, it defaults to Ctrl+U.
This example sets the ERASE LINE character to Ctrl+U.
TELNET>set
erase-line “^U”
[Escape Line character set to ^U
TELNET>
Sets the character that switches TELNET to command mode. This character can also be set by invoking TELNET with the /ESCAPE_CHARACTER qualifier.
SET ESCAPE-CHARACTER character
character
Specifies which character is used as the TELNET ESCAPE character. If you type the command without specifying character, it defaults to Ctrl+^.
This example sets the ESCAPE character to Ctrl+^.
TELNET>set
escape "^\"
[Escape character set to ^\]
TELNET>
Causes TELNET to go into extended command mode automatically whenever you type the TELNET ESCAPE character, Ctrl+^ by default.
SET EXTENDED mode
mode
Turns extended mode ON or OFF. If you do not specify mode, it defaults to ON.
This example enables the extended option.
TELNET>set
extended on
TELNET>
Sets the character that TELNET maps to the INTERRUPT PROCESS sequence. The value set by this command is not the character passed to the remote host. The remote host receives an INTERRUPT PROCESS sequence; SET INTERRUPT-PROCESS-CHARACTER defines the key you press to tell TELNET to send an INTERRUPT PROCESS sequence. You can also set this character by invoking TELNET with the /INTERRUPT_PROCESS_CHARACTER qualifier.
SET INTERRUPT-PROCESS-CHARACTER character
character
Specifies which character sends the INTERRUPT PROCESS sequence to the TELNET server. If you type the command without specifying character, it defaults to Ctrl+C.
This example sets the INTERRUPT PROCESS character to Ctrl+C.
TELNET>set
interrupt-process "^C"
[Interrupt Process character set to ^C]
TELNET>
Specifies whether or not Ctrl+S
and Ctrl+Q should be treated by the local terminal
driver as XON and XOFF. You can also set this mode by invoking TELNET with the
/LOCAL_FLOW_CONTROL qualifier.
Use of this qualifier causes a more responsive XOFF, which helps prevent data loss, but the remote system is unable to see any Ctrl+S characters.
The default under the MultiNet TELNET utility is to use the current setting of the VMS terminal characteristic TT$_TTSYNC (set by the DCL command SET TERMINAL/TTSYNC), unless the remote host supports the TOGGLE-FLOW-CONTROL TELNET option. In that case, the LOCAL-FLOW-CONTROL option is set automatically by the TELNET server.
SET LOCAL-FLOW-CONTROL mode
mode
Turns local flow control ON or OFF. If mode is not specified, it defaults to ON.
This example enables local processing of Ctrl+S and Ctrl+Q.
TELNET>set
local-flow on
TELNET>
Enables or disables logging of the TELNET session. You can also set a log file by invoking TELNET with the /LOG_FILE qualifier.
SET LOG-FILE log_file
log_file
Specifies a file to which to write the log of the TELNET session. If you specify log_file, everything received by the local system from the remote system is copied into this file. If you do not specify a file, logging is enabled to the file TELNET.LOG. If you specify the file name NONE, logging is disabled.
log_file is not supported in 3270 and 5250 modes.
Specifies the user name to which you want to log in using Kerberos. If you are not logging in with the /AUTH qualifier, TELNET prompts you to supply a user name.
SET REMOTE-USERNAME username
username
Specifies the user name to which you want to log in using Kerberos.
Causes TELNET to use the 4.3BSD UNIX end-of-line specification, Ctrl+NULL. You can also set this mode by invoking TELNET with the /UNIX qualifier. This command is useful when using TELNET to connect to 4.3BSD UNIX systems whose TELNET server does not conform to the TELNET specification.
SET UNIX-LINE-TERMINATOR mode
mode
If mode is ON, TELNET uses the 4.3BSD UNIX end-of-line specification, Ctrl+NULL. If mode is OFF (the default), TELNET uses the standard end-of-line specification, Ctrl+LF.
This example enables use of a 4.3BSD UNIX-style line terminator.
TELNET>set
unix-line-terminator on
TELNET>
Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. To return from DCL, use the LOGOUT command. If the MULTINET_DISABLE_SPAWN logical is set, SPAWN does not work.
SPAWN [command]
command
Specifies a command to execute. If you omit command, a DCL command line subprocess is created.
/INPUT=file-spec
Specifies an input file to the command you enter with SPAWN.
/LOGICAL_NAMES
/NOLOGICAL_NAMES
Specifies that logical names and logical name tables are not copied to the subprocess.
/SYMBOLS
/NOSYMBOLS
Specifies that global and local names are not passed to the subprocess.
/WAIT
/NOWAIT
Returns control without waiting for the command to complete. Do not use this qualifier with commands that have prompts or screen displays.
/OUTPUT=file-spec
Specifies a file that retains the output of the command invoked with SPAWN. This qualifier only works when a single command is entered without creating a DCL subprocess. In addition, this qualifier is positional; you must enter it immediately after SPAWN or other qualifiers.
Displays the status of the current TELNET connection and parameters.
STATUS
TELNET>status
This is BIGBOOTE.EXAMPLE.COM, VMS Version V8.4
Connected to host CONE.EXAMPLE.COM, a VAXSTATION-4000-90 running VMS via TCP.
Remote host is echoing
Host is not sending binary
Client is not sending binary
NO Abort Output character
NO Interrupt Process character
NO Are-You-There character
NO Break Character character
NO Erase Character character
NO Erase Line character
Escape Character character is '^^'
Normal End Of Line mapping
Local Flow control
No log file
Terminal type is vt100
Remote host status reply:
BIGBOOTE::_VTA12: 16:40:02 (DCL) CPU=00:00:03.21 PF=686 IO=196 MEM=514
Specifies a terminal type for the TELNET session.
TERMINAL-TYPE type
type
Refer to RFC-1340 for a list of possible terminal types. RFCs are provided on the MultiNet CD-ROM. MultiNet TELNET permits you to specify any terminal type, even if the terminal type is not listed in the RFC. The TERMINAL-TYPE command has the same effect as invoking TELNET with the /TERMINAL_TYPE qualifier.
TELNET>terminal-type dec-vt220
Displays the TELNET version number.
VERSION
TELNET>version
This is MultiNet K5-TELNET V5.6(13)
TELNET>