1  RSH
   Sends a command to a remote host for execution, including a
   command that invokes a remote shell script or remote command
   procedure. Any command recognized by the remote host is valid.
   When using the RSH command, consider the following:

   o  If you omit a command for remote execution, RSH initiates a
      remote login session (see the RLOGIN command).

   o  If you specify the /PASSWORD qualifier, with or without a
      value, RSH executes the REXEC facility.

   DCL-Style Format

     RSH  host [/EIGHTBIT ] [ remote_command ]

          [ /ESCAPE_CHARACTER=character ]

          [ /LOG_FILE=file ]

          [ /[NO]LOWERCASE ]

          [ /PASSWORD[=password] ]

          [ /[NO]SYSERROR ]

          [ /TERMINAL_SPEED=n ]

          [ /TERMINAL_TYPE=type ]

          [ /[NO]TRUNCATE_USER_NAME ]

          [ /USER_NAME=remote_user_name ]

   UNIX Style Format

     rsh  host [ -l remote_user_name ] [ remote_command ]

   This format is valid only on UNIX systems.
 

2  Parameters
 

host

   Required.

   Remote host at which you want the command to execute.
 

remote_command

   Optional. Default: none.

   Command you are sending to the remote host for execution.

                                  NOTE

      The remote_command must be the last item on the command
      line.
 

2  Qualifiers
 

/EIGHTBIT

   Optional. Default: only 7-bit data is sent.

   Accepts 8-bit data from the terminal and sends it to the remote
   system.
 

/ESCAPE_CHARACTER

      /ESCAPE_CHARACTER=character

   Optional. Default: ~ (tilde).

   New RLOGIN escape character. This character lets you exit the
   RLOGIN process without typing the remote host's typical logout
   sequence, for example, LOGOUT or Ctrl/D.

   Typing the escape character and a period (.) breaks the
   connection with the remote host, for example:

   remote> ~. (characters not echoed)

   %RSH-S-LCLCLOSED, Local connection closed
   local_vms>
 

/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.

   Not valid with /SYSERROR.
 

/LOWERCASE

      /LOWERCASE
      /NOLOWERCASE

   Optional. Default: /LOWERCASE.

   Sends your local user name to the remote host in lowercase.

   To send your user name in uppercase, use either of the following
   ways:

   o  Specify /NOLOWERCASE.

   o  Enclose the user name in quotation marks ( " " ). (See /USER_
      NAME.)

   To send your user name in mixed case, enclose it in quotation
   marks ( " " ).
 

/PASSWORD

      /PASSWORD[=password]

   Optional.

   Your password on the remote host.

   Invokes the local REXEC facility that directs your RSH command
   to the REXEC server on the remote host. This server does
   authentication checking using the user name and password that
   you specified on the RSH command line.

   o  Enclose the password in quotation marks ( " " ) if it is
      lowercase or mixed case.

   o  If you omit password, RSH (REXEC) prompts you for one.

   o  Do not use this qualifier if you want to initiate an RLOGIN
      session.

   Directs diagnostics to SYS$ERROR and output to SYS$OUTPUT.

   When SYS$ERROR and SYS$OUTPUT both output to the same terminal,
   the output might be garbled.

   /NOSYSERROR directs output only to SYS$OUTPUT.
 

/TERMINAL_SPEED

      /TERMINAL_SPEED=n

   Optional. Default: your terminal's current speed.

   Terminal speed passed to the remote host during an RLOGIN
   session.
 

/TERMINAL_TYPE

      /TERMINAL_TYPE=type

   Optional. Default: your terminal's current type.

   Terminal type passed to the remote host during an RLOGIN session.
 

/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).
 

/USER_NAME

      /USER_NAME=remote_user_name
      -l remote_user_name (UNIX style, valid only on UNIX systems)

   Optional. Default: same 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, use either of the following
   ways:

   o  Specify /NOLOWERCASE.

   o  Enclose the user name in quotation marks ( " " ).

   To send your user name in mixed case, enclose it in quotation
   marks ( " " ).
 

2  Examples

   1.$ RSH HENCE MAN CP

      cp(1)

        Name
          cp - copy file data

        Syntax
          cp [ -f ] [ -i ] [ -p ] file1 file2
        .
        .
        .
        See Also
          cat(1), pr(1), mv(1)
     $

     A user sends the man cp command to UNIX host hence for
     execution.

   2.$ RSH /USER_NAME=ROGERS DELPHI LS

     OpenVMS user PHILIPS enters the ls command for execution at
     remote UNIX host delphi. PHILIPS is accessing an account called
     rogers.

   3.$ RSH /PASSWORD=BLOOMER AVOC8N DIRECTORY

     OpenVMS user PANTO sends the DIRECTORY command to remote
     OpenVMS host AVOC8N. The remote directory listing is of PANTO's
     home directory.

     RSH /PASSWORD invokes REXEC, which authenticates PANTO's remote
     password.

   4.$ RSH /PASSWORD MAGIC CAT BUZZ.TXT
     REXEC password:        (password not echoed)<Return>

     A user sends the cat command to host magic. /PASSWORD invokes
     REXEC, which requires a password. Because the password was
     omitted from the command line, REXEC prompts the user for it.