PRINTLOCAL(1t,C) AIX Commands Reference PRINTLOCAL(1t,C) ------------------------------------------------------------------------------- printlocal PURPOSE Displays the alias of the current process. SYNTAX printlocal ---| DESCRIPTION The printlocal command displays the current setting of your directory alias. Your directory alias controls which file you access when you use a symbolic link beginning with "" to access the file. If your AIX system is not a member of a Transparent Computing Facility cluster, your alias will always refer to the directory of your system. If your AIX system is part of a TCF cluster, your alias will usually refer to the directory of your system; but on occasion it may be set to refer to the directory of another cluster site. By convention, the directory is usually named /site_name. To determine the actual directory of your system, use the sitelocal command. By using the 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 -> /dev and /tmp -> /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 alias to refer to the new site's 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 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 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 alias to be the directory for the site to which it is migrated. Only non-interactive shell scripts are allowed to continue running with the alias different from the site's default 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