UUX(1C)			 HP-UX 5.0		       UUX(1C)

     NAME
	  uux - HP-UX-to-HP-UX system command execution

     SYNOPSIS
	  uux [ options ] command-string

     HP-UX COMPATIBILITY
	  Level:    HP-UX/STANDARD

	  Origin:   System V

     DESCRIPTION
	  Uux will gather zero or more	files  from  various  systems,
	  execute  a  command  on  a  specified	 system	 and then send
	  standard output to a file on a specified system.  Note that,
	  for security reasons, many installations will limit the list
	  of commands executable on behalf of an incoming request from
	  uux.	Many sites will permit little more than the receipt of
	  mail (see mail(1)) via uux.

	  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

	  (1)  a full path name;

	  (2)  a path name preceded by ~xxx where xxx is a login  name
	       on  the specified system and is replaced by that user's
	       login directory;

	  (3)  anything else is prefixed by the current directory.

	  As an example, the command

	       uux "!diff usg!/usr/dan/f1 pwba!/a4/dan/f1 > !f1.diff"

	  will	get  the  f1  files  from  the	``usg''	 and  ``pwba''
	  machines,  execute  a	 diff  command	and put the results in
	  f1.diff in the local directory.

	  Any special shell characters such as <>;| should  be	quoted
	  either  by quoting the entire command-string, or quoting the
	  special characters as individual arguments.

	  Uux will attempt to get all files to the  execution  system.
	  For  files  which  are  output  files, the file name must be
	  escaped using parentheses.  For example, the command

	       uux a!uucp b!/usr/file \(c!/usr/file\)
	  will send a uucp command to system ``a''  to	get  /usr/file
	  from system ``b'' and send it to system ``c''.

	  Uux will notify you if the requested command on  the	remote
	  system  was  disallowed.   The response comes by remote mail
	  from the remote machine.  The amount	of  mail  notification
	  can be reduced with the -z option, which notifies the remote
	  system only if the  command  failed.	 Notification  can  be
	  disabled  totally  with  the -n option.  Executable commands
	  are listed in /usr/lib/uucp/L.cmds  on  the  remote  system.
	  The format of the L.cmds file is:

	       cmd,machine1,machine2,...

	  If no machines are specified, then any machine  can  execute
	  cmd.	 If  machines  are specified, only the listed machines
	  can execute cmd.  If the desired command is  not  listed  in
	  L.sys then no machine can execute that command.

	  Redirection  of  standard  input  and	 output	  is   usually
	  restricted  to  files	 in  PUBDIR.   Directories  into which
	  redirection	is    allowed	 must	 be    specified    in
	  /usr/lib/uucp/USERFILE by the system administrator.  See the
	  HP-UX System Administrator Guide for details.

	  The following options are interpreted by uux:

	  -    The standard input to uux is made the standard input to
	       the command-string.

	  -n   Send no notification to user.

	  -z   Send notification only of failures to user.

	  -mfile
	       Report status of the  transfer  in  file.  If  file  is
	       omitted,	 send  mail  to the requester when the copy is
	       completed.

	  -j   Control writing of the  uucp  job  number  to  standard
	       output.

	  -r   Queue job but do not start the file  transfer  process.
	       By default a file transfer process is started each time
	       uux is evoked.

	  Uux associates a job number with  each  request.   This  job
	  number  can  be used by uustat to obtain status or terminate
	  the job.

	  The environment variable JOBNO and the -j option are used to
	  control  the	listing	 of  the  uux  job  number on standard
	  output.  If the environment variable JOBNO is	 undefined  of
	  set to OFF, the job number will not be listed (default).  If
	  uuco is then invoked with the -j option, the job number will
	  be  listed.	If the environment variable JOBNO is set to ON
	  and is exported, a job number will be	 written  to  standard
	  output  each	time  uux  is  invoked.	  In this case, the -j
	  option will suppress output of the job number.

     FILES
	  /usr/spool/uucp	     spool directory
	  /usr/spool/uucppublic	     public directory (PUBDIR)
	  /usr/lib/uucp/*	     other data and programs

     SEE ALSO
	  mail(1), uuclean(1M), uucp(1C).

     BUGS
	  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 * will  probably  not  do
	  what	you want it to do.  The shell tokens << and >> are not
	  implemented.
	  Any excess characters are ignored.