ibm-information-center/dist/eclipse/plugins/i5OS.ic.ifs_5.4.0.1/rzaaxhomedir.htm

86 lines
5.8 KiB
HTML

<?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>