uux(1c) 																   uux(1c)

Name
       uux - unix to unix command execution

Syntax
       uux [-] command-string

Description
       The  command gathers 0 or more files from various systems, executes a command on a specified system, and sends standard output to a file on
       a specified system.

       The command-string is made up of one or more arguments that look like a shell command line, except that the command and file names  may	be
       prefixed by system-name!.  A null system-name is interpreted as the local system.

       File names may be one of the following:

       o    A pathname

       o    A pathname preceded by ~xxx, where xxx is a userid on the specified system and is replaced by that user's login directory

       o    Any other syntax that is prefixed by the current directory.

       For  example,  the  following  command  line  gets  the f1 files from the usg and pwba machines, executes a command and puts the results in
       f1.diff in the local directory.
       uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff"

       When using special shell characters such as <>'!, you should either quote the entire command-string, or you should quote the special  char-
       acters as individual arguments.

       The  command  attempts  to  get all files to the execution system.  If both the file and command are located on different remote sites, the
       file is first brought to the local system and is then transferred to the execution system.

       If you want to include files as arguments to a command, but you do not want those files to be processed by enclose the filename	in  paren-
       theses.	For example:
       uux a!uucp b!/usr/file (c!/usr/file)
       The  previous  example  sends  a  command  to  system The is transferred from system to the local system, and then is passed to system When
       arrives at system the command executes and sends to system

       If the request is not allowed on the remote system, the command notifies you.  This response is sent through remote mail  from  the  remote
       machine.

Options
       -c, -l
	  Do not copy local file to the spool directory for transfer to the remote machine.  This is the default.

       -ggrade
	  Specifies  the  grade which is a single letter or number from 0 to 9, A to Z, or a to z.  The highest grade is 0, the lowest grade is z.
	  The default is A.  Lower grades should be specified for high-volume jobs, such as news.

       -n Sends no notification to user.

       -p, -
	  Reads stdin.

       -r Queues the job, but does not start the file transfer.

       -xdebug
	  Produces debugging output on stdout.	The debug option is a number between 0 and 9.  Higher numbers provide more  detailed  information.
	  Debugging is permitted only for those users with read access to

       -z Notify the user if the command fails.

Warning
       An installation may limit the list of commands executable on behalf of an incoming request from Typically, a restricted site permits little
       other than the receipt of mail through

Restrictions
       Only the first command of a shell pipeline may have a system-name!.  All other commands are executed on the system of the first command.

       The use of the shell metacharacter asterisk (*) shell metacharacter may not behave as you expect.  The shell tokens (<<	>>) are not imple-
       mented.

       You are not notified when execution on a remote machine is denied.  Only commands listed in on the remote system are executed at the remote
       system.

Files
       /usr/spool/uucp	   spool directory
       /usr/lib/uucp/*	   other data and programs

See Also
       uucp(1c)
       "Uucp Implementation Description" ULTRIX Supplementary Documents Vol. III: System Manager

																	   uux(1c)