ONSITE, ON(1t,C)            AIX Commands Reference             ONSITE, ON(1t,C)



-------------------------------------------------------------------------------
onsite, on



PURPOSE

Runs a command at a specific site in a TCF cluster.

SYNTAX


      one of
+-----------------+  +------+   +- sitename ---+
| /usr/bin/onsite |--|      |---+- sitenumber -+--- command --- argument ---|
| /usr/bin/on     |  +- -v -+   +- sitetype ---+             ^            |
+-----------------+                                          +------------+


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

The onsite command runs command with optional arguments on the site specified
by sitename, sitenumber, or sitetype.  Site names, numbers and types are
defined in the site data base, /etc/site.  The following types are valid:

  i386, i370, xa370

When a sitetype is specified, onsite selects a machine of the specified type on
which to run command.

The onsite command is essentially a setlocal followed by an rexecve. (See the
AIX Operating System Technical Reference.)  The arguments to these operations
are derived from information contained in the site data base, /etc/site.  The
setlocal call indicates that the destination site's <LOCAL> is to be used to
interpret command and as an environment in which command will run (see local).
In particular, if command references files in /tmp, it references files in its
local /tmp.

A particularly useful command to run with onsite is a shell.  In a remote
shell, commands are executed on the remote site almost exactly as though the
terminal is attached to the remote machine.  One noticeable exception is that
Ctrl-T (which gives machine status, load and uptime) gives information about
the machine to which the terminal is really connected and not the remote site.

It is possible to use onsite and specify the local site and guarantee that
command is executed locally or not at all.

Note:  Both the csh and sh have a built in version of onsite.  This permits the
       alias mechanisms of both shells to be supported properly.  This version
       does not properly handle commands which are aliases.  Furthermore, all



Processed November 8, 1990     ONSITE, ON(1t,C)                               1

ONSITE, ON(1t,C)            AIX Commands Reference             ONSITE, ON(1t,C)



       wild card expansions are done in the context of the invoking process,
       not of the new site.

FLAG

-v      Verbose option; displays the name of the site on which the command is
        being run.

RESTRICTION

Shell files that do not begin with '#!' cannot be run with onsite since the
kernel doesn't recognize these as command files.  Again, this problem is
eliminated if you use the onsite that is built into the shells.

RELATED INFORMATION

See the following commands:  "anet,"  "csh,"  "sh, Rsh," "fast, fastsite," and
"loads."

See in the AIX Technical Reference Vol 1:  "setlocal", "rexecve".

See in the AIX Technical Reference Vol II:  "site" in the File formats.

































Processed November 8, 1990     ONSITE, ON(1t,C)                               2