PRINTSPATH(1,C) AIX Commands Reference PRINTSPATH(1,C)
-------------------------------------------------------------------------------
printspath
PURPOSE
Displays the site path of the current process.
SYNTAX
printspath ---|
Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.
DESCRIPTION
The printspath command displays your current site path. Your site path
controls where in a TCF cluster AIX will be running your commands. You can
change your site path using the setspath built-in command of your shell.
When you ask AIX to run a command, AIX first selects which command to run and
then picks which TCF cluster site should be used to run your program. Both the
selection of the command and the selection of the TCF cluster site use your
site path.
If the command is installed inside a hidden directory, the site path along with
your experimental version prefix (see setxvers) controls which element within
the hidden directory is selected.
Then, your site path is consulted again to select the machine on which to run
your command.
Your site path is made up of the following types of entries:
LOCAL indicates the local site. This entry is often the first item in
your site path so that commands that can run on the local system
are run there.
cpu_type indicates the type of cpu on which you would want your command run.
The possible values for cpu_type are i386, i370 and xa370.
site_name name of a site in your TCF cluster.
For example, suppose you are logged onto an AIX PS/2 system "pooh" and have the
following site path:
Processed November 8, 1990 PRINTSPATH(1,C) 1
PRINTSPATH(1,C) AIX Commands Reference PRINTSPATH(1,C)
LOCAL
i386
tigger
i370
where "tigger" is the name of an AIX/370 system in your cluster. If you then
run the command cat, AIX will run this command on your local system "pooh"
because it finds "LOCAL" first on your site path and finds /bin/cat@/i386, a
program that can run on your local system.
Suppose you next run the command uvcp, for which there is only an AIX/370
version of the program (/usr/bin/uvcp@/i370). AIX will see that it cannot run
this on the "LOCAL" system, and will then look at other elements in our site
path. This command cannot be run on any AIX PS/2 system, so the "i386" element
is skipped. The command will run on "tigger", so that is where AIX runs your
command.
If the site "tigger" was down when you run the uvcp command, however, AIX would
have next considered the "i370" element in your site path. This would instruct
AIX to select any of the remaining AIX/370 systems. This selection does not
necessarily select the least loaded AIX/370 system. To do this, you would need
to use the fast command (see "fast, fastsite").
You can override your site path and select a particular site on which to run
your command by using the onsite command (see the "onsite" command in this book
on page onsite-1).
RELATED INFORMATION
"onsite" on page onsite-1, "fast, fastsite" on page fast-1, "printxvers" on
page printxvers-1, and the "setspath" sections in "csh", page csh-21, and
"sh", page sh-24.
"getspath, setspath", and "getxvers, setxvers" in the AIX Operating System
Technical Reference.
Processed November 8, 1990 PRINTSPATH(1,C) 2