HP 3000 Manuals HP 3000 Manuals
Chapter 3 TELNET/iX Client Commands: Quick Reference This chapter provides a quick reference of the syntax and usage of the TELNET/iX Client commands. The commands are listed in alphabetic order.
NOTE TELNET/iX Client commands can only be entered in TELNET/iX command mode (at the telnet> prompt); entering a command at the remote host's prompt when connected to a remote host will result in an error.
TELNET/iX Client commands can be entered in upper case or lower case letters. Command abbreviations are not supported. While connected to a remote host, TELNET/iX command mode can be entered by typing [CTRL]-] (the default value). Once you are in TELNET/iX command mode and have entered a client command, you are automatically returned to remote host control (except for when entering the ? or HELP command). However, you will not see the remote host's prompt until you press the [Return] key. If you entered the ? or HELP command in TELNET/iX command mode, you will remain in command mode and can enter another client command. Alternatively, you can return to the remote host's prompt by pressing the [Return] key twice. To close a TELNET/iX session, type close in TELNET/iX command mode. If the session was started from command mode, you return to command mode; otherwise, you exit the TELNET/iX Client and return to the MPE/iX prompt. To close any open TELNET/iX session and automatically exit the TELNET/iX Client, regardless of where the session was started, type quit at the telnet> prompt.
NOTE The TELNET/iX Client supports eight-bit characters when communicating with the remote host. To use eight-bit characters, you may need to reconfigure your terminal or the remote host. Additionally, you may need to enable the binary option to allow an eight-bit data stream between the TELNET/iX Client and the remote host. Note that some remote hosts may not support eight-bit characters. ? [command] Displays a list of valid TELNET/iX Client commands and corresponding one-line command descriptions. If command is specified, TELNET/iX displays a one-line description of that command only. Equivalent to HELP command. !mpecommand From within a TELNET/iX session you can execute an MPE/iX command or program by entering an exclamation point (!) followed by the command or program name. After the command is executed, or the program is exited, you are returned to your active session. CLOSE Closes the active session. If the session was started from command mode, TELNET/iX returns to command mode; otherwise, you exit the program. DISPLAY [argument] Displays all set and toggle values. If argument is specified, TELNET/iX will display the set or toggle value for that argument only. HELP [command] Displays a list of valid TELNET/iX Client commands and corresponding one-line command descriptions. If command is specified, TELNET/iX displays a one-line description of that command only. Equivalent to ? command. MODE [mode] Changes the user input mode to the mode specified. The value of mode can be character, for "character at a time" mode, or line, for "line by line" mode. The TELNET/iX Client asks the remote host for permission to go into the requested mode. If the remote host is capable of entering that mode, the protocol enters the requested mode. In character mode, TELNET/iX sends each character to the remote host as it is typed. In line mode, TELNET/iX accumulates user input into lines and transmits each line to the remote host when the user types the [Return] key, a linefeed, or EOF (default is [CTRL]-D). Be aware that setting line mode also sets local echo. Applications that expect to interpret user input character by character (such as UNIX utilities: more, csh, ksh, and vi) do not function correctly in line mode. OPEN Opens a connection to the named host at the [remotehostname] specified port. If port is not specified, [port] the TELNET/iX Client attempts to contact a server at the standard TELNET port (23). remotehostname can be either the official name or an alias, or an Internet address specified in the dot notation (refer to the HP 3000/iX Network Planning and Configuration Guide for more information on Internet addresses). If remotehostname is not specified, TELNET/iX prompts for one. QUIT Closes any open session and exits the TELNET/iX Client. SEND [argument] Sends one or more special character sequences to the remote host (more than one argument can be specified at a time). An open connection must already exist in order to use this command. The following are the arguments which can be specified: ? Displays help information for the SEND command. ao Sends the TELNET AO (Abort Output) sequence which should (if the remote system supports this sequence) cause the remote system to flush all output from the remote system to the user's terminal. ayt Sends the TELNET AYT (Are You There) sequence to which the remote system should (if the remote system supports this sequence) respond. brk Sends the TELNET BRK (Break) sequence which will (if the remote system supports this sequence) have significance to the remote system. ec Sends the TELNET EC (Erase Character) sequence which should (if the remote system supports this sequence) cause the remote system to erase the last character entered. el Sends the TELNET EL (Erase Line) sequence which should (if the remote system supports this sequence) cause the remote system to erase the line currently being entered. escape Sends the TELNET escape character (default is [CTRL]-]). ga Sends the TELNET GA (Go Ahead) sequence which has significance to the remote system only in the rare case when the connection to the remote system is half duplex. ip Sends the TELNET IP (Interrupt Process) sequence which should (if the remote system supports this sequence) cause the remote system to abort the currently running process. nop Sends the TELNET NOP (No OPeration) sequence. synch Sends the TELNET SYNCH sequence which causes the remote system to discard all previously typed (but not yet read) input. This sequence is sent as TCP urgent data. This argument may not be supported on some remote systems; and r will be echoed on the user's terminal if it is not supported. SET [argument] Sets argument entered to value. The special [value] value off turns off the function associated with the variable. There is no special value on which turns the function back on; you must assign a value to the variable. Use the DISPLAY command to list the current values of arguments. Arguments whose values may be specified include: echo In "line by line" mode, echo toggles between performing local echoing of entered characters (for normal processing) and suppressing echoing of entered characters (for entering a password, for instance). Default is [CTRL]-E. eof Entering eof as the first character on a line will result in an EOF being sent to the remote system if the TELNET/iX Client is operating in line mode (see MODE [mode] command). Default is [CTRL]-D. erase erase sends the TELNET EC sequence to the remote host if the TELNET/iX Client is in localchars mode (see TOGGLE [argument] command) and in character mode (see MODE [mode] command). Default is [CTRL]-H. escape escape represents the escape character which enables you to enter into TELNET/iX command mode when connected to a remote system. Default is [CTRL]-]. flushoutput flushoutput sends the TELNET AO sequence to the remote host if the TELNET/iX Client is in localchars mode (see TOGGLE [argument] command). Default is [CTRL]-O. interrupt interrupt sends the TELNET IP sequence to the remote host if the TELNET/iX Client is in localchars mode (see TOGGLE [argument] command). Default is [CTRL]-Y. kill kill sends the TELNET EL sequence to the remote host if the TELNET/iX Client is in localchars mode (see TOGGLE [argument] command) and in character mode (see MODE [mode] command). Default is [CTRL]-X. quit quit sends the TELNET BRK sequence to the remote host if the TELNET/iX Client is in localchars mode (see TOGGLE [argument] command). Default is [CTRL]-\. STATUS Shows current status of the TELNET/iX Client. The program reports the current escape character. If there is no TELNET/iX connection, the program reports No connection. If there is an open TELNET/iX connection, the program reports the host to which it is connected and the current mode. TOGGLE [argument] Toggles argument value between TRUE and FALSE which affects how the TELNET/iX Client responds to events. More than one argument may be specified. Use the DISPLAY command to list the current values of arguments. Valid arguments include: ? Help. Displays the supported TOGGLE commands. autoflush Toggles autoflush mode. If autoflush and localchars are both TRUE, then when the ao, inter, or quit characters are recognized and transformed into TELNET sequences, the TELNET/iX Client will not display any data on the user's terminal until the remote system acknowledges (via a TELNET Timing Mark option) that it has processed those TELNET sequences. Default is FALSE. autosynch Toggles autosynch mode. If autosynch and localchars are both TRUE, then when either the intr or quit characters is typed, the associated TELNET sequence sent is followed by the TELNET SYNCH sequence. This procedure should (if supported by the remote system) cause the remote system to begin discarding all previously typed input until both of the TELNET sequences have been read and acted upon. Default is FALSE. binary Toggles binary mode. If this is TRUE, binary mode is enabled. This option should be enabled to send and receive 8-bit characters to and from the TELNET server. Default is FALSE. crlf Toggles carriage return/line feed mode. If this is TRUE, carriage returns will be sent as <CR><LF>. If this is FALSE, carriage returns will be sent as <CR><NUL>. Default is FALSE. crmod Toggles carriage return mode. If this is TRUE, any carriage return characters received from the remote host are mapped into a carriage return and a line feed. This mode does not affect those characters typed by the user, but rather, only those received. This mode is only required for some hosts that require the client to do local echoing but output carriage returns without linefeeds. Default is FALSE. debug Toggles the debug tracing option. If this is TRUE, you will create socket trace files (named SOCK####). The trace files are formatted using NMDUMP. For information on using NMDUMP see the NS3000/iX Operations and Maintenance Reference Manual (36922-90035). echo Toggles local echo mode or remote echo mode. If this is TRUE, local echo mode is enabled and user input is echoed to the user's terminal before being transmitted to the remote host. If this is FALSE, remote echo mode is enabled and any echoing of user input is done by the remote host. Applications that handle echoing of user input themselves, such as UNIX utilities csh, ksh, and vi, will not function properly with local echo. Default is FALSE. localchars Toggles local characters mode. If this is TRUE, the flush, interrupt, quit, erase, and kill characters (see SET[argument] [value] command) are recognized locally and transformed into appropriate TELNET control sequences ao, ip, brk, ec, and el, respectively). Default is TRUE in line mode and FALSE in character mode. netdata Toggles the display of all network data (in hexadecimal format). If this is TRUE, all network data is displayed. Default is FALSE. options Toggles viewing of TELNET options processing. If this is TRUE, options viewing is enabled and all option negotiations are displayed. Options sent by the TELNET/iX Client are displayed as SENT, while options received from the remote host are displayed as RCVD. Default is FALSE. Z Suspends the TELNET/iX Client and returns you to the MPE/iX session command line where you first invoked the program. Issuing this command is equivalent to pressing the [Break] key. The RESUME or ABORT command can then be used on this program.