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 ---+ ^ | +-----------------+ +------------+ 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 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 July 12, 1991 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. See Chapter 18 of the AIX Programming Tools and Interfaces for general information on using commands in an MBCS environment. Processed July 12, 1991 ONSITE, ON(1t,C) 2