<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html lang="en-us" xml:lang="en-us"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="security" content="public" /> <meta name="Robots" content="index,follow" /> <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' /> <meta name="DC.Type" content="concept" /> <meta name="DC.Title" content="Home directory" /> <meta name="abstract" content="The home directory is used as the current directory when you sign on the system. The name of the home directory is specified in your user profile." /> <meta name="description" content="The home directory is used as the current directory when you sign on the system. The name of the home directory is specified in your user profile." /> <meta name="DC.subject" content="home directory, home" /> <meta name="keywords" content="home directory, home" /> <meta name="DC.Relation" scheme="URI" content="rzaaxdir.htm" /> <meta name="DC.Relation" scheme="URI" content="../cl/chgcurdir.htm" /> <meta name="DC.Relation" scheme="URI" content="../apis/chdir.htm" /> <meta name="DC.Relation" scheme="URI" content="../apis/fchdir.htm" /> <meta name="DC.Relation" scheme="URI" content="../apiref/api.htm" /> <meta name="DC.Relation" scheme="URI" content="rzaaxtmpdir.htm" /> <meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" /> <meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" /> <meta name="DC.Format" content="XHTML" /> <meta name="DC.Identifier" content="rzaaxhomedir" /> <meta name="DC.Language" content="en-us" /> <!-- All rights reserved. Licensed Materials Property of IBM --> <!-- US Government Users Restricted Rights --> <!-- Use, duplication or disclosure restricted by --> <!-- GSA ADP Schedule Contract with IBM Corp. --> <link rel="stylesheet" type="text/css" href="./ibmdita.css" /> <link rel="stylesheet" type="text/css" href="./ic.css" /> <title>Home directory</title> </head> <body id="rzaaxhomedir"><a name="rzaaxhomedir"><!-- --></a> <!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script> <h1 class="topictitle1">Home directory</h1> <div><p>The <dfn class="term">home directory</dfn> is used as the current directory when you sign on the system. The name of the home directory is specified in your user profile.</p> <p>When your job is started, the system looks in your user profile for the name of your home directory. If a directory by that name does not exist on the system, the home directory is changed to the <span class="q">"root"</span> (/) directory.</p> <p>Typically, the system administrator who creates the user profile for a user would also create the user's home directory. Creating individual home directories for each user under the <samp class="codeph">/home</samp> directory is preferable. The <samp class="codeph">/home</samp> directory is a subdirectory under the <span class="q">"root"</span> (/) directory. The system default expects the name of the home directory of a user to be the same name as the user profile.</p> <p>For example, the command <samp class="codeph">CRTUSRPRF USRPRF(John) HOMEDIR(*USRPRF)</samp> will assign the home directory for John to <samp class="codeph">/home/JOHN</samp>. If the directory <samp class="codeph">/home/JOHN</samp> does not exist, the "root" (/) directory becomes the home directory for John.</p> <p>You can specify a directory other than the home directory as your current directory at any time after you sign on by using the Change Current Directory (CHGCURDIR) CL command, the chdir( ) API, or the fchdir() API.</p> <p>The home directory chosen during process initiation will remain each thread's home directory by default. This is regardless of whether your active user profile for the thread has changed after initiation. However, there is support provided by the <span class="apiname">Change Job (QWTCHGJB)</span> API that can be used to change the home directory being used for a thread to that thread's current user profile's home directory (or the "root" (/) directory if that home directory does not exist). Secondary threads will always inherit the home directory of the thread that created it. Note that the process' current directory does not change when you use <span class="apiname">QWTCHGJB</span> to change the thread's home directory. The current directory is scoped to the process level, and the home directory is scoped to the thread level. Changing the current working directory in any thread changes it for the whole process. Changing the home directory for a thread does not change its current working directory.</p> </div> <div> <div class="familylinks"> <div class="parentlink"><strong>Parent topic:</strong> <a href="rzaaxdir.htm" title="A directory is a special object that is used to locate objects by names that you specify. Each directory contains a list of objects that are attached to it. That list can include other directories.">Directory</a></div> </div> <div class="relconcepts"><strong>Related concepts</strong><br /> <div><a href="rzaaxtmpdir.htm" title="The integrated file system creates these directories when the system is restarted if they do not already exist.">Provided directories</a></div> </div> <div class="relinfo"><strong>Related information</strong><br /> <div><a href="../cl/chgcurdir.htm">Change current directory (CHGCURDIR) command</a></div> <div><a href="../apis/chdir.htm">chdir()</a></div> <div><a href="../apis/fchdir.htm">fchdir()</a></div> <div><a href="../apiref/api.htm">Application programming interfaces (APIs)</a></div> </div> </div> </body> </html>