ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzau8_5.4.0.1/rzau8pathnames.htm

108 lines
6.2 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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="reference" />
<meta name="DC.Title" content="Path names" />
<meta name="abstract" content="This topic describes path names for optical volumes." />
<meta name="description" content="This topic describes path names for optical volumes." />
<meta name="DC.Relation" scheme="URI" content="tipsandtechniques.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2000, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2000, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzau8pathnames" />
<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</title>
</head>
<body id="rzau8pathnames"><a name="rzau8pathnames"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Path names</h1>
<div><p>This topic describes path names for optical volumes.</p>
<div class="section"><p>The term path refers to a file-system name, volume name, directory
name, and file name.</p>
</div>
<div class="section"><h4 class="sectiontitle">Path names for volumes in directly-attached devices</h4><div class="p">In
the path name for volumes in directly attached devices, the forward slash
(/) is used as a separator character. The path name must begin with a forward
slash and contain no more than 294 characters. See the following for an example
of the format for a path name on a directly-attached device:<pre>/QOPT/VOL_NAME/DIRECTORY_NAME/SUB_DIR1/.../SUB_DIRn/FILE_NAME</pre>
</div>
<div class="p"><samp class="codeph">QOPT</samp> refers to the optical file system. You must use
it to qualify the optical file system when issuing calls to optical support
through the HFS API or the Unix-type APIs. The portion of the path following
the file system name cannot contain more than 289 characters. For the rules
for using path names, see the following:<ul><li>A path name can consist of any EBCDIC characters, except the characters
that are listed below:<ul><li>X'00' through X'3F'</li>
<li>X'FF'</li>
<li>The quotation mark (″)</li>
<li>The asterisk (*)</li>
<li>The less than (&lt;) and greater than (&gt;) signs</li>
<li>The question mark (?)</li>
<li>The hyphen (-)</li>
<li>The back slash (\)</li>
</ul>
<p>When accessing UDF formatted volumes through the integrated file system
APIs, the only characters not valid are X00 through X3F, XFF, and back
slash.</p>
</li>
<li>The volume identifier can be a maximum of 32 characters for HPOFS media
format, and a maximum of 30 characters for UDF media format. The identifier
must contain only alphabetic characters (A through Z), numeric characters
(0 through 9), a hyphen (-), an underscore(_), or a period (.). The first
character must be alphabetic or numeric, and the identifier cannot contain
blanks.</li>
<li>You can include one or more directories in the path name, but it is not
required. The total number of characters in all of the subdirectories together
cannot exceed 256 characters.</li>
<li>The file name is the last element in the path. The directory length in
the path limits the file name length. The directory name and file name combined
cannot exceed 256 characters. The preceding forward slash of the directory
name is considered part of this 256 characters.</li>
</ul>
</div>
</div>
<div class="section"><h4 class="sectiontitle">Path names for volumes in LAN-attached devices</h4><div class="p">For
a path name on an optical volume in a LAN-attached optical device, the forward
slash (/) is used as a separator character. The path name must begin with
a forward slash and contain no more than 261 characters. See the following
for an example of the format for a path name on an optical volume in a LAN-attached
optical device:<pre>/QOPT/VOL_NAME/DIRECTORY_NAME/SUB_DIR1/.../SUB_DIRn/FILE_NAME</pre>
</div>
<div class="p"><samp class="codeph">QOPT</samp> refers
to the optical file system, and must be used to qualify the optical file system
when issuing calls to optical support through the HFS or integrated file system
APIs. The portion of the path following the file system name cannot contain
more than 256 characters. For the rules for using path names on LAN-attached
devices, see the following:<ul><li>See the <a href="http://www-1.ibm.com/support/docview.wss?uid=ssg1S7000193">IBM<sup>®</sup> 3995
LAN Optical Library Dataserver</a> book for the allowed characters for
path names.</li>
<li>The volume name is required and can contain a maximum of 32 characters.</li>
<li>One or more directories can be included in the path name, but it is not
required. The total number of characters in all of the subdirectories together
cannot exceed 254 characters.</li>
<li>The file name is the last element in the path. The file name length is
limited by the volume and directory length in the path. The volume name, directory
name, and file name combined cannot exceed 256 characters. The preceding forward
slashes of the volume and directory name are considered part of the 256 characters.</li>
</ul>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="tipsandtechniques.htm" title="The following techniques are often helpful in designing custom optical programs for your business.">Tips: Optical programming</a></div>
</div>
</div>
</body>
</html>