131 lines
8.6 KiB
HTML
131 lines
8.6 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="Path names (*PNAME)" />
|
|
<meta name="abstract" content="A path name is a character string that can be used to locate objects in the integrated file system." />
|
|
<meta name="description" content="A path name is a character string that can be used to locate objects in the integrated file system." />
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6objnamrules.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6objexpand.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../rzaiu/rzaiurzaiu151.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../ifs/rzaaxaccessifs.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6label.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rbam6pathnames" />
|
|
<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>Path names (*PNAME)</title>
|
|
</head>
|
|
<body id="rbam6pathnames"><a name="rbam6pathnames"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Path names (*PNAME)</h1>
|
|
<div><p>A path name is a character string that can be used to locate objects
|
|
in the integrated file system. </p>
|
|
<p>The string can consist of one or more elements, each separated by a slash
|
|
(/). Each element is typically a directory or equivalent, except for the last
|
|
element, which can be a directory, another object such as a file, or a generic
|
|
presentation of an object or objects to be located.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> <img src="./delta.gif" alt="Start of change" />Some CL commands will also allow the back slash (\) to be
|
|
used as a separator by automatically converting the back slash (\) to a slash
|
|
(/). Some other CL commands however will treat the back slash (\) no differently
|
|
than they would any other character. Therefore, the back slash (\) separator
|
|
should be used with caution.<img src="./deltaend.gif" alt="End of change" /></div>
|
|
<p>The / and \ characters and nulls cannot be used in the individual components
|
|
of the path name when the / and \ characters are used as separators. The name
|
|
may or may not be changed to uppercase, depending on whether the file system
|
|
containing the object is case-sensitive and whether the object is being created
|
|
or searched for. If the parameter is defined as CASE(*MONO) (the default),
|
|
any values that are not enclosed in single quotes will be changed to uppercase
|
|
by the command analyzer.</p>
|
|
<p>A separator character (for example, /) at the beginning of a path name
|
|
means that the path begins at the top most directory, the "root" (/) directory.
|
|
If the path name does not begin with a separator character, the path is assumed
|
|
to begin at the current directory of the user entering the command.</p>
|
|
<p>The path name must be represented in the CCSID currently in effect for
|
|
the job. If the CCSID of the job is 65535, the path name must be represented
|
|
in the default CCSID of the job. Hard-coded path names in programs are encoded
|
|
in CCSID 37. Therefore, the path name should be converted to the job CCSID
|
|
before being passed to the command. The maximum length of the path name character
|
|
string on the CL commands is 5000 characters.</p>
|
|
<p>When operating on objects in the QSYS.LIB file system, the component names
|
|
must be of the form name.object-type; for example:</p>
|
|
<pre>'/QSYS.LIB/PAY.LIB/TAX.FILE'</pre>
|
|
<p>Path names must be enclosed in apostrophe (') marks when entered on a command
|
|
line if they contain special characters. These marks are optional when path
|
|
names are entered on displays. If the path name includes any quoted strings
|
|
or special characters; however, the enclosing '' marks must be included. The
|
|
following are rules for using special characters:</p>
|
|
<ul><li>A tilde (~) character followed by a separator character (for example,
|
|
/) at the beginning of a path name means that the path begins at the home
|
|
directory of the user entering the command.</li>
|
|
<li>A tilde (~) character followed by a user name and then a separator character
|
|
(for example, /) at the beginning of a path name means that the path begins
|
|
at the home directory of the user identified by the user name.</li>
|
|
<li>In some commands, an asterisk (*) or a question mark (?) can be used in
|
|
the last component of a path name to search for patterns of names. The * tells
|
|
the system to search for names that have any number of characters in the position
|
|
of the * character. The ? tells the system to search for names that have a
|
|
single character in the position of the ? character.</li>
|
|
<li>To avoid confusion with i5/OS™ special values, path names cannot start with
|
|
a single asterisk (*) character. To perform a pattern match at the beginning
|
|
of a path name, use two asterisks (**). <div class="note"><span class="notetitle">Note:</span> This only applies to relative
|
|
path names where there are no other characters before the asterisk.</div>
|
|
</li>
|
|
<li>The path name must be enclosed in apostrophes (') <strong>and</strong> quotation
|
|
marks (") if any of the following characters are used in a component name:
|
|
<ul><li>Asterisk (*)<div class="note"><span class="notetitle">Note:</span> To avoid confusion with iSeries™ server special values, path names
|
|
should not start with a single asterisk (*) character.</div>
|
|
</li>
|
|
<li>Question mark (?)</li>
|
|
<li>Apostrophe (')</li>
|
|
<li>Quotation mark (")</li>
|
|
<li>Tilde (~), if used as the first character in the first component name
|
|
of the path name (if used in any other position, the tilde is interpreted
|
|
as just another character) </li>
|
|
</ul>
|
|
<div class="note"><span class="notetitle">Note:</span> Using the above characters as the first character in the first
|
|
component name of the path name is not recommended because the meaning of
|
|
the character in a command string could be confused and it is more likely
|
|
that the command string will be entered incorrectly.</div>
|
|
</li>
|
|
<li>Do not use a colon (:) in path names. It has a special meaning within
|
|
the system.</li>
|
|
<li>The processing support for commands and associated user displays does
|
|
not recognize code points below hexadecimal 40 as characters that can be used
|
|
in command strings or on displays. If these code points are used, they must
|
|
be entered as a hexadecimal representation, such as the following: <pre>crtdir dir(X'02')</pre>
|
|
<p>Therefore, use of code points below hexadecimal 40 in path
|
|
names is not recommended. This restriction applies only to commands and associated
|
|
displays, not to APIs. In addition, a value of hexadecimal 00 is not allowed
|
|
in path names. </p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbam6objnamrules.htm" title="This describes rules for naming i5/OS objects.">Object naming rules</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rbam6objexpand.htm" title="The object (OBJ) parameter specifies the names of one or more objects affected by the command in which this parameter is used.">OBJ parameter</a></div>
|
|
<div><a href="rbam6label.htm" title="Command labels identify particular commands for branching purposes in a CL program. Labels can also be used to identify statements in CL programs that are being debugged. They can identify statements used either as breakpoints or as starting and ending statements for tracing purposes.">Command label</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../rzaiu/rzaiurzaiu151.htm">Specifying the device name</a></div>
|
|
<div><a href="../ifs/rzaaxaccessifs.htm">Access the integrated file system</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |