Initiates an interactive login session with a remote host.
DCL Format
RLOGIN /DROP_TIMEOUT=seconds host
[ /EIGHTBIT ]
[ /ESCAPE_CHARACTER=character ]
[ /LOG_FILE=file ]
[ /[NO]LOWERCASE ]
[ /PROBE_TIMEOUT=seconds ]
[ /TERMINAL_SPEED=baud ]
[ /TERMINAL_TYPE=type ]
[ /[NO]TRUNCATE_USER_NAME ]
[ /USER_NAME=remote_user_name])
UNIX Format
rlogin host [ -8 ] [ -ec ] [ -l remote_user_name ]
1 – Parameters
host
Required.
Remote host to which you want to connect.
2 – Qualifiers
2.1 /DROP_TIMEOUT
/DROP_TIMEOUT=seconds
Required if you set /PROBE_TIMEOUT.
Maximum interval, in seconds, that your network link can be down
before the software closes it.
2.2 /EIGHTBIT
/EIGHTBIT
-8 (valid only on UNIX systems)
Optional. Default: only 7-bit data is sent.
Accepts 8-bit data from the terminal and sends it to the remote
system.
2.3 /ESCAPE_CHARACTER
/ESCAPE_CHARACTER=character
-ec (valid only on UNIX systems)
Optional. Default: ~ (tilde).
New escape character if you want to close your RLOGIN session
from the remote host.
To close your session from your local host, use a period ( . ) as
the escape command.
2.4 /LOG_FILE
/LOG_FILE=file
Optional. Default: no logging.
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.
2.5 /LOWERCASE
/LOWERCASE
/NOLOWERCASE
Optional. Default: /LOWERCASE.
Sends your local user name to the remote host in lowercase.
To send your user name in uppercase, do either of the following:
o Specify /NOLOWERCASE.
o Enclose the user name in quotation marks ( " " ). (See the
/USER_NAME qualifier.)
To send your user name in mixed case, enclose it in quotation
marks.
2.6 /PROBE_TIMEOUT
/PROBE_TIMEOUT=seconds
Required if you set /DROP_TIMEOUT.
Interval, in seconds, that TCP/IP Services checks to see whether
your network link and the remote host are still up.
2.7 /TERMINAL_SPEED
/TERMINAL_SPEED=baud
Optional. Default: current speed of your terminal.
Terminal speed in baud rate.
2.8 /TERMINAL_TYPE
/TERMINAL_TYPE=type
Optional. Default: type of physical terminal you are using.
Terminal type. Use this qualifier if the remote host does not
recognize your terminal.
2.9 /TRUNCATE_USER_NAME
/TRUNCATE_USER_NAME
/NOTRUNCATE_USER_NAME
Optional. Default: /NOTRUNCATE_USER_NAME.
Abbreviates the user name sent to the remote host to eight
characters. (Required for older UNIX hosts, which limit user
names to eight characters.)
2.10 /USER_NAME
/USER_NAME=remote_user_name
-l remote_user_name (valid only on UNIX systems)
Optional. Default: current name on local host, but in lowercase.
Your user name on the remote host. Specify this qualifier if your
user names on the remote host and local host are different.
To send your user name in uppercase, do either of the following:
o Specify /NOLOWERCASE.
o Enclose the user name in quotation marks ( " " ).
To send your user name in mixed case, enclose it in quotation
marks.
3 – Examples
1.$ RLOGIN /USER_NAME="BlissTon" ROLLS
An OpenVMS user logs in to account BlissTon on UNIX host rolls.
The mixed-case remote user name is enclosed in quotation marks
so that RLOGIN does not send it all lowercase. This example
assumes the user has a proxy account on the remote host.
2.$ RLOGIN /NOLOWERCASE /USER_NAME=DAVE PLETHORA
User DAVE starts an interactive login session with UNIX host
plethora. Because this user has an uppercase user name, it is
specified with the /NOLOWERCASE qualifier. This example assumes
the user has a proxy account on the remote host.
3.$ RLOGIN /ESCAPE_CHARACTER="+" PJARO <Return>
Password: (password not echoed)<Return>
Last login: Fri Aug 21 16:50:40 from world.wide.webber.com
Compaq Tru64 System - 4: Tues Aug 25 11:02:20 EST 2003
You have mail.
Tues Aug 25 11:02:20 EST 2002
pjaro> who <Return>
black ttyp0 Aug 20 11:02 grades.philosophy.ucd.edu.
bristow ttyp1 Aug 12 09:00 grades.biology.ucd.edu.
cutler ttyp2 Aug 24 08:55 grades.math.ucd.edu.
pjaro> pwd <Return>
/usr/users/black
pjaro> ls <Return>
bin Sem1.paper Sem2.paper
pjaro> +. (characters not echoed)
%RLOGIN-S-REMCLOSED, Remote connection closed
$
OpenVMS user BLACK, with UNIX user name black, logs in to UNIX
host pjaro and resets the escape character to a plus sign. By
default, TCP/IP Services passes the user name and commands to
the remote host in lowercase.
4.$ RLOGIN FANTAC <Return>
OpenVMS Version 7.3 - Unauthorized access is prohibited.
Username: TDERR <Return>
Password: (password not echoed) <Return>
.
.
.
$
User TDERR logs in to remote OpenVMS host FANTAC.
5.$ RLOGIN QANCE /DROP_TIMEOUT=45
%RLOGIN-E-INETERROR, Internet interface error
-RLOGIN-I-INETCALL, setsockopt(TCP_DROP_IDLE)
-SYSTEM-F-BADPARAM, bad parameter value
$
The command fails because the /DROP_TIMEOUT and /PROBE_TIMEOUT
qualifiers must both be set.