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
/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.
/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.
/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.
/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.
/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.
/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.
/TERMINAL_SPEED=baud Optional. Default: current speed of your terminal. Terminal speed in baud rate.
/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.
/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.)
/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.