TotalNET Advanced Server 5.2 Reference Manual

ruren

This command renames files on a remote server.

Location

TNHOME/usr/bin

Usage

ruren [-u username] [{-p password|-P}] [-C charset]
 	[-a{s|h}] //servername/object/path1 path2

Options

-u username

Specify the name of the user for the remote server.  

-p password

Specify username's password on the command line. No subsequent password prompt appears.

-P 

Prompt for username's password. The password does not display as you type it. This option proves especially if you want to include the command but not the password in a batch file.

-C charset

Specify the client character set. If not specified, the character set defaults to builtin-codepage-437. Valid character sets include:

builtin-mac-roman

builtin-iso-latin-1

builtin-unicode

builtin-codepage-437

You can use additional character sets if you install TAS. 

-a 

Include files of one or both of the following types: 

s -- System files

h -- Hidden files

servername

Specify the name of the remote server. 

object

Specify the name of a shared object on a remote LM-NT-OS/2 server. 

path1

Specify a full or relative source directory and file on the remote server. This option permits the use of wildcards. 

path2

Specify a full or relative target directory and file on the remote server. With path2 a relative directory, the server assumes this variable relates to the object's top directory if it starts with a slash (/); otherwise, it relates to path1. This option permits the use of wildcards. 

Notes

If you include no -a options, this command finds only the files marked Read-Only, Directory, and Archive.

Examples

  1. Use the following command to rename the file autoexec.bat in the top directory of the shared object root on the server kathserver to autoexec.old, prompt for a password, and use the character set "builtin-unicode":


    ruren -P -C builtin-unicode //kathserver/root/autoexec.bat autoexec.old
  2. Use the following command to access the remote server and rename the file prog.c in the subdirectory apps of the shared object root on the server monaserver into the subdirectory sources if the object has no password:


    ruren //monaserver/root/apps/prog.c /sources/prog.c