Remote Shell Command

The Remote UNIX Shell command allows you to execute UNIX commands on a remote system, without using REMLOG.

The rush Command

The rush command connects to a remote host, executes the specified command and terminates when the command terminates.

Syntax

rush System { -l UserId{,Password}} { -t Timeout} Command
- or -
rush { -l UserId{,Password}} { -t Timeout} System Command

Note

The alternative syntax is not available on versions of UNIX-Connect earlier than 1.3 Revision H.

Syntax Elements

System The name of the remote system on which Command will be executed. It must be the system name of a destination entry in the ROUTE-FILE.

-l UserId {,Password }
This must be a user-id (and optional password) on the remote system. If this option is omitted, the user-id is obtained from the USERS-FILE.

-t TimeoutWhen executed, rush starts a server process on the remote system, and this executes the specified command. Normally, this server process terminates when the remote command completes.

This option instructs the server to delay termination until the specified timeout has expired. If another rush command with the same remote user-id is executed within this timeout period, it will connect to this server, instead of starting a new instance of the server process. This can improve performance when several rush commands are executed one after another.

Timeout is the required timeout in minutes (maximum 255).

Note

This feature is not available on versions of UNIX-Connect earlier than 1.3 Revision G.

Command This is the command to be executed on the remote system.

Remarks

rush copies its standard input to the remote command, the standard output of the remote command to its standard output, and the standard error of the remote command to its standard error. rush terminates with the termination status of the remote command.

Examples

rush HOST2 mkdir dummy

This example creates a directory called dummy on a remote UNIX system called HOST2. The remote user-id and password are taken from the USERS-FILE.

rush HOST2 -l paulg,passwd ls -c dummy

This example lists, in columns on the local screen, all the files in the dummy directory on the remote system.