rush

This command establishes a remote utility shell session to provide an environment for performing several remote commands without having to reconnect with each command.

Location

TNHOME/usr/bin

Usage

rush [-u username] [{-p password|-P}] [-C charset]
 	[+{a|s|h|r}] [-{a|s|h|r}] //servername/object/path

Options

Notes

1. Once you establish the connection, the name of the remote server displays in the prompt. The remote utilities shell enables the commands shown in the following table:

   ! unix_command	Executes a local UNIX command.
   ? [command] or  help [command]	Acquires information on a remote utilities command.
   attr [+{a|s|h|r}]   [-{a|s|h|r}]	Shows, sets, or clears remote file attributes.
   cd path	Changes current remote directory.
   del path	Deletes remote files.
   dir [-p] [+{a|s|h|r}]  [-{a|s|h|r}]	Lists remote files.
   exit  or  quit	Exits the remote utilities shell.
   get [-v] [-c] [-s] path1 [path2]	Copies files from the remote server.
   lcd path	Changes current local directory.
   lpwd	Shows current local directory.
   md path	Creates a remote directory.
   msg text	Sends a message to the remote server.
   pwd	Shows current remote directory.
   ren path1 path2	Rename remote file(s).
   rd path	Removes a remote directory.
   set [value [options]]	Sets a global value.
   time [-s]	Displays remote system time.
   type path	Displays a remote text file on the local monitor.

2. All commands entered in the remote utilities shell use the password, server name, and object specified in the rush command. To change one of these parameters, you must terminate the shell and issue a new rush command.

Examples

1. Use the following command, as user joe, to connect to the object outnet on the server netserver with path yellowbrick and password joepass using the client character set "iso-greek" for all SMB requests:

   rush -u joe -p joepass -C iso-greek //netserver/outnet/yellowbrick

2. Use the following command to execute the UNIX command ls by temporarily escaping to a UNIX shell:

   ! ls

3. Use one of the commands below to display information about the remote utilities shell pwd, as listed in the table. If you do not specify a command, the screen displays the list of commands available.

   ? pwd

   help pwd

4. Use the following command to display, set, or clear file attributes for dorothy.txt on server far:

   attr //far/dorothy.txt

5. Use the following command to change the current remote directory to skip/hop/jump:

   cd skip/hop/jump

6. Use the command below to delete the remote files ink.doc and inker.doc. This command works like the remote utilities rudel command. It permits wildcards.

   del ink.doc inker.doc

7. Use the command below to list the contents of the remote directory at jump/hop/skip, display the output one screen at a time, and include system and hidden files. Press e to display the next page.

   dir -p -ash jump/hop/skip

8. Use one of the following commands to terminate the current remote utilities shell session and return to the UNIX prompt:

   exit quit

9. Use the command below to copy the remote files turtle.txt and schmurtle.gif to the file bagpipe on the local computer, display the file names as they copy, convert text files from DOS to UNIX format, and display the contents of the files. This works like the remote utilities rucopy command. If a target file already exists, the system prompts you for action as with the remote utilities rucopy command, in which o = "overwrite", a = "overwrite all without further prompting", c = "continue without copying", and n = "use new file name".

   get -v -c -s turtle.txt schmurtle.gif bagpipe

10. Use the command below to temporarily change the local current directory to rainy/rainier/rainiest. This change lasts only as long as the remote utilities shell remains active:

    lcd rainy/rainier/rainiest

11. Use the following command to display the name of the current local directory:

    lpwd

12. Use the command below to create a remote directory using the path seed/sapling/tree. This works like the remote utilities rumd command.

    md seed/sapling/tree

13. Use the command below to send the message "The end draweth nigh" to the remote server. This works like the remote utilities rumessage command. The message appears at the server only if the server can receive messages. Desk To Desk and some other DOS and OS/2 servers can receive and display messages, whereas UNIX-based LM-NT-OS/2 servers cannot.

    msg The end draweth nigh

14. Use the command below to copy the file fingers from the local computer to toes on the remote computer. This works like the remote utilities rucopy command and has the same options as the get command.

    put fingers toes

15. Use the following command to show the current remote directory:

    pwd

16. Use the command below to rename the file good to better. This works like the remote utilities ruren command.

    ren good better

17. Use the command below to remove the directory urg from the remote server. This works like the remote utilities rurd command.

    rd urg

18. Use the sequence of commands below to avoid having to include the -ah option in the dir command. The current attribute setting appears when the command completes. This command defaults to d, the directory attribute.

    set attribute +h

    dir

    The listing includes files with hidden attributes, the same as if you entered:

    dir -ah

19. Use the command below to avoid having to include the -v option on commands to display the names of files as they copy. To turn off the verbose attribute, enter the above command again.

    set verbose

20. Use the command below to reset the prompt so that only the remote server name appears. Enter the same command again to resume the default behavior.

    set prompt

21. Use the command below to generate a trace file called rutrace.txt for Syntax Technical Support that includes incoming and outgoing SMB packets, program procedures, and program errors at a moderate level of tracing detail. To turn tracing off, use set tracing off.

    set tracing -zin=5 -zout=5 -zproc-5 -ztracefile=rutrace.txt

    Use the command below to display and synchronize local time with the remote server's system time. Only the superuser can use the -s option. This option only works if the remote server supports the request.

    time [-s]

22. Use the command below to display the contents of the remote file roland.txt, at the server gunslingers, on the local monitor screen. This command has the same effect as get -s when you do not specify a destination path.

    type //gunslingers/roland.txt