108 lines
6.2 KiB
HTML
108 lines
6.2 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="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 (<) and greater than (>) 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 X’00’ through X’3F’, X’FF’, 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>
|