HELPLIB.HLB  —  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 Format

      RSH  host [/EIGHTBIT ] [ remote_command ]

           [ /ESCAPE_CHARACTER=character ]

           [ /LOG_FILE=file ]

           [ /[NO]LOWERCASE ]

           [ /PASSWORD[=password] ]

           [ /[NO]SYSERROR ]

           [ /TERMINAL_SPEED=n ]

           [ /TERMINAL_TYPE=type ]

           [ /TRUNCATE_USER_NAME ]

           [ /USER_NAME=remote_user_name ]

    UNIX Format

      rsh  host [ -l remote_user_name ] [ remote_command ]

1  –  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 parameter must be the last item on the
       command line.

2  –  Qualifiers

2.1    /EIGHTBIT

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

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

2.2    /ESCAPE_CHARACTER

       /ESCAPE_CHARACTER=character

    Optional. Default: Tilde (~).

    RSH escape character. This character lets you exit the RSH
    process without entering the remote host's typical logout
    sequence, such as 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>

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

2.4    /LOWERCASE

       /LOWERCASE
       /NOLOWERCASE

    Optional. Default: /LOWERCASE.

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

    To send your user name in uppercase letters, do one 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.5    /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.

2.6    /

       /[NO]SYSERROR

    Optional. Default: /NOSYSERROR

    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.

2.7    /TERMINAL_SPEED

       /TERMINAL_SPEED=n

    Optional. Default: your terminal's current speed.

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

2.8    /TERMINAL_TYPE

       /TERMINAL_TYPE=type

    Optional. Default: your terminal's current type.

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

2.9    /TRUNCATE_USER_NAME

       /TRUNCATE_USER_NAME

    Optional. Default: User names are not truncated

    Abbreviates the user name sent to the remote host to eight
    characters.

2.10    /USER_NAME

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

    Optional. Default: same name on local host, but in lowercase
    letters.

    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 letters, do one 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.$ 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.
Close Help