8. RLOGIN: Logging in to a Remote Host

Introduction

RLOGIN is the Berkeley R Command utility you can use to log in to a remote host. RLOGIN provides a functionality similar to TELNET except that RLOGIN follows more of a UNIX format.

This chapter is a basic use summary of the RLOGIN command.

Before you use RLOGIN, be sure your host or username is registered in the remote system's ~/.rhosts file (if UNIX) or SYS$LOGIN:.RHOSTS file.

See the TCPware Management Guide, Chapter 16, Managing R Commands, for information on host equivalence files.

To close an RLOGIN connection, simply log out of the remote system.

 

 

 

 


 

RLOGIN

Logs in to a remote host from your local host without entering a remote username and password. The remote host must provide the login service.

You can log in to the remote host with a different username by specifying the /USER qualifier.

When RLOGIN starts up, it processes the flow control characters Ctrl+S and Ctrl+Q locally unless the remote host instructs otherwise. RLOGIN passes all other keystrokes directly to the remote process and perform according to conventions established on the remote host.

The special RLOGIN commands in the below table are available once you start the connection to the remote host. Enter the special RLOGIN commands as the first character on a line.

Command

Purpose

~.

Closes the connection and exits RLOGIN.

~^Z

Spawns a subprocess on the local host and connects SYS$INPUT, SYS$OUTPUT, and SYS$ERROR to that process. When the subprocess logs out, control returns to the remote session.

 

Note that you cannot spawn with CAPTIVE accounts.

~~

Sends a single tilde to the remote system.

 

Format

RLOGIN host

 

Parameter

 

host

Name or internet address of the remote host where you want to log in.

 

Qualifiers

 

/EIGHTBIT

Accepts eight-bit data from the terminal and sends it to the remote system. The default is that only seven-bit data is sent.

 

/ESCAPE_CHARACTER=char

New escape character for issuing special RLOGIN commands. The default escape character is the ~ (tilde) character.

To close your session from your local host, use a period (.) as the escape command.

 

/LOG=file

Logs a copy of the output to the specified file. Output continues to be directed to SYS$OUTPUT while it is being recorded in the log file. The default is no logging.

 

/LOWERCASE
/NOLOWERCASE

/LOWERCASE sends your local username to the remote host in lowercase (the default).  /NOLOWERCASE preserves any uppercase characters in the local username.

 

/TERMINAL_SPEED=baud

Terminal speed in baud rate. The default is the current speed of your terminal.

 

/TERMINAL_TYPE=type

Resets the current terminal type to the specified type. The allowable types you can use to override the current type are VT100, VT200, VT300, and VT400.

The remote terminal type is the same as the local terminal type. If the terminal's virtual size (rows, columns, or pixels) changes during the RLOGIN session, RLOGIN provides the remote host with the new information.

 

/TRUNCATE[=n]

Truncates the local OpenVMS username to n number of characters. The n value must be greater than zero or the command aborts with an error. The default is eight characters.

If the local username is also the remote username (if you omit the /USER qualifier), TCPware also truncates the remote username to the indicated length. However, it never truncates a remote username specified explicitly with the /USER qualifier.

 

/USER=remote-username

Username on the remote host that is different from the username with which you are currently logged in to the local host. TCPware never truncates an explicitly specified remote username (see the /TRUNCATE qualifier). The remote-username is converted to lowercase unless you enclose it in quotes or use the /NOLOWERCASE qualifier.

Example

Each of these equivalent commands opens a connection to host IRIS using standard authentication:

$ RLOGIN IRIS
$ RLOGIN /AUTH=NULL IRIS