printlocal(1t) — AIX PS/2 1.2.1



PRINTLOCAL(1t,C)            AIX Commands Reference             PRINTLOCAL(1t,C)



-------------------------------------------------------------------------------
printlocal



PURPOSE

Displays the <LOCAL> alias of the current process.

SYNTAX


printlocal ---|


DESCRIPTION

The printlocal command displays the current setting of your <LOCAL> directory
alias.  Your <LOCAL> directory alias controls which file you access when you
use a symbolic link beginning with "<LOCAL>" to access the file.

If your AIX system is not a member of a Transparent Computing Facility cluster,
your <LOCAL> alias will always refer to the <LOCAL> directory of your system.
If your AIX system is part of a TCF cluster, your <LOCAL> alias will usually
refer to the <LOCAL> directory of your system; but on occasion it may be set to
refer to the <LOCAL> directory of another cluster site.

By convention, the <LOCAL> directory is usually named /site_name.  To determine
the actual <LOCAL> directory of your system, use the sitelocal command.

By using the <LOCAL> alias inside symbolic links, AIX allows users on different
TCF cluster sites to access different files and directories using the same
pathname.  For instance, each site requires its own devices (/site_name/dev)
and temporary file space (/site_name/tmp) and AIX provides the symbolic links

   /dev  ->  <LOCAL>/dev

and

   /tmp  ->  <LOCAL>/tmp

so that users can use the shorthand names such as /dev/tty0 and /tmp/myfile to
refer to /site_name/dev/tty0 and /site_name/tmp/myfile, respectively.  Users on
other cluster sites must use the full path names to access devices and
temporary files on your system, just as you would have to use the full path
names to access devices and temporary files on another site in the cluster.

When you execute a command on another cluster site using the onsite command,
onsite changes your <LOCAL> alias to refer to the new site's <LOCAL> directory,
just as though you had logged on to that site directly.  See the onsite command
man page for more information on remote command execution in TCF.




Processed November 8, 1990     PRINTLOCAL(1t,C)                               1



PRINTLOCAL(1t,C)            AIX Commands Reference             PRINTLOCAL(1t,C)



When a program migrates, however, from one site in the cluster to another, the
<LOCAL> alias is not changed.  Because of this, a program which is running can
continue to access temporary files and terminal devices after it is migrated
using the same path names it used before being migrated.  If the printlocal
command is run from a program which has been migrated, you will see that the
<LOCAL> directory alias has been unchanged.  See the migrate built-in commands
on the sh and csh man pages for more information on process migration in TCF.

Note:  If you migrate an interactive csh or sh shell, the shell will notice
       that it is being migrated and will set its <LOCAL> alias to be the
       <LOCAL> directory for the site to which it is migrated.  Only
       non-interactive shell scripts are allowed to continue running with the
       <LOCAL> alias different from the site's default <LOCAL> directory.

RELATED INFORMATION

See the following commands:  "csh,"  "onsite, on," and  "sh, Rsh."

See getlocal in the AIX Operating System Technical Reference.




































Processed November 8, 1990     PRINTLOCAL(1t,C)                               2

Museum

Related Articles