ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahh_5.4.0.1/ifspath.htm

225 lines
13 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="Integrated file system path names for server objects" />
<meta name="abstract" content="Your Java program must use integrated file system names to refer to server objects, such as programs, libraries, commands, or spooled files. The integrated file system name is the name of a server object as it might be accessed in the library file system of the integrated file system on the iSeries server." />
<meta name="description" content="Your Java program must use integrated file system names to refer to server objects, such as programs, libraries, commands, or spooled files. The integrated file system name is the name of a server object as it might be accessed in the library file system of the integrated file system on the iSeries server." />
<meta name="DC.Relation" scheme="URI" content="progtips.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="ifspath" />
<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>Integrated file system path names for server objects</title>
</head>
<body id="ifspath"><a name="ifspath"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Integrated file system path names for server objects</h1>
<div><p>Your Java™ program must use integrated file system names to
refer to server objects, such as programs, libraries, commands, or spooled
files. The integrated file system name is the name of a server object as
it might be accessed in the library file system of the integrated file system
on the iSeries™ server.</p>
<div class="section"><p>The path name may consist of the following components:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr class="tablemainheaderbar"><th valign="top" width="50%" id="d0e27">Path name component</th>
<th valign="top" width="50%" id="d0e29">Description</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="50%" headers="d0e27 ">library</td>
<td valign="top" width="50%" headers="d0e29 ">The library in which the object resides. The library is a <strong>required</strong> portion
of an integrated file system path name. The library name must be 10 or fewer
characters and be followed by <strong>.lib</strong>.</td>
</tr>
<tr><td valign="top" width="50%" headers="d0e27 ">object</td>
<td valign="top" width="50%" headers="d0e29 ">The name of the object that the integrated file system path name represents.
The object is a <strong>required</strong> portion of an integrated file system path
name. The object name must be 10 or fewer characters and be followed by <strong>.type</strong>,
where <strong>type</strong> is the type of the object. Types can be found by prompting
for the OBJTYPE parameter on control language (CL) commands, such as the
Work with Objects (WRKOBJ) command.</td>
</tr>
<tr><td valign="top" width="50%" headers="d0e27 ">type</td>
<td valign="top" width="50%" headers="d0e29 ">The type of the object. The type of the object must be specified when
specifying the <strong>object</strong>. (See <strong>object</strong> above.) The type name must
be 6 or fewer characters.</td>
</tr>
<tr><td valign="top" width="50%" headers="d0e27 ">member</td>
<td valign="top" width="50%" headers="d0e29 ">The name of the member that this integrated file system path name represents.
The member is an <strong>optional</strong> portion of an integrated file system path
name. It can be specified only when the <strong>object type</strong> is <strong>FILE</strong>.
The member name must be 10 or fewer characters and followed by <strong>.mbr</strong>.</td>
</tr>
</tbody>
</table>
</div>
<p>Follow these conditions when determining and specifying the integrated
file system name:</p>
<ul><li>The forward slash (/) is the path separator character.</li>
<li>The root-level directory, called QSYS.LIB, contains the server library
structure.</li>
<li>Objects that reside in the server library QSYS have the following format:</li>
</ul>
<pre> /QSYS.LIB/object.type</pre>
<ul><li>Objects that reside in other libraries have the following format:</li>
</ul>
<pre> /QSYS.LIB/library.LIB/object.type</pre>
<ul><li>The object type extension is the server abbreviation used for that type
of object.</li>
</ul>
<p>To see a list of these types, enter a CL command that has object type
as a parameter and press <strong>F4</strong> (Prompt) for the type. For example, the
Work with Objects (WRKOBJ) command has an object type parameter.</p>
<p>The
following table is a list of some commonly used object types and the abbreviation
for each type:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr class="tablemainheaderbar"><th valign="top" width="55.55555555555556%" id="d0e117">Object type</th>
<th valign="top" width="44.44444444444444%" id="d0e119">Abbreviation</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">command</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.CMD</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">data queue</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.DTAQ</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">file</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.FILE</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">font resource</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.FNTRSC</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">form definition</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.FORMDF</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">library</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.LIB</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">member</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.MBR</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">overlay</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.OVL</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">page definition</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.PAGDFN</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">page segment</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.PAGSET</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">program</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.PGM</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">output queue</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.OUTQ</td>
</tr>
<tr><td valign="top" width="55.55555555555556%" headers="d0e117 ">spooled file</td>
<td valign="top" width="44.44444444444444%" headers="d0e119 ">.SPLF</td>
</tr>
</tbody>
</table>
</div>
<p>Use the following descriptions to help you determine how to specify
integrated file system path names:</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr class="tablemainheaderbar"><th valign="top" width="50%" id="d0e195">Integrated file system name</th>
<th valign="top" width="50%" id="d0e197">Description</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="50%" headers="d0e195 ">/QSYS.LIB/MY_LIB.LIB/MY_PROG.PGM</td>
<td valign="top" width="50%" headers="d0e197 ">Program MY_PROG in library MY_LIB on the server</td>
</tr>
<tr><td valign="top" width="50%" headers="d0e195 ">/QSYS.LIB/MY_LIB.LIB/MY_QUEUE.DTAQ</td>
<td valign="top" width="50%" headers="d0e197 ">Data queue MY_QUEUE in library MY_LIB on the server</td>
</tr>
<tr><td valign="top" width="50%" headers="d0e195 ">/QSYS.LIB/YEAR1998.LIB/MONTH.FILE/JULY.MBR</td>
<td valign="top" width="50%" headers="d0e197 ">Member JULY in file MONTH in library YEAR1998 on the server</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="ifspath__specialvalues"><a name="ifspath__specialvalues"><!-- --></a><h4 class="sectiontitle">Integrated file system special values</h4><p>Various IBM<sup>®</sup> Toolbox
for Java classes
recognize special values in integrated file system path names. The traditional
format for these special values (as used on an iSeries command line) begins with an
asterisk (<strong>*ALL</strong>). However, in a Java program that uses IBM Toolbox for Java classes,
the format for these special values begins and ends with percent signs (<strong>%ALL%</strong>).</p>
<div class="note"><span class="notetitle">Note:</span> In
the integrated file system, an asterisk is a wildcard character. </div>
</div>
<div class="section"><p>The following table shows which of these special values the IBM Toolbox
for Java classes
recognize for particular path name components. The table also shows how the
traditional format for these special values differ from the format used in IBM Toolbox
for Java classes.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr class="tablemainheaderbar"><th valign="top" width="31.666666666666664%" id="d0e268">Path name component</th>
<th valign="top" width="30%" id="d0e270">Traditional format</th>
<th valign="top" width="38.333333333333336%" id="d0e272">IBM Toolbox
for Java format</th>
</tr>
</thead>
<tbody><tr><td rowspan="5" valign="top" width="31.666666666666664%" headers="d0e268 ">Library name</td>
<td valign="top" width="30%" headers="d0e270 ">*ALL</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%ALL%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*ALLUSR</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%ALLUSR%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*CURLIB</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%CURLIB%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*LIBL</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%LIBL%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*USRLIBL</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%USRLIBL%</td>
</tr>
<tr><td valign="top" width="31.666666666666664%" headers="d0e268 ">Object name</td>
<td valign="top" width="30%" headers="d0e270 ">*ALL</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%ALL%</td>
</tr>
<tr><td rowspan="4" valign="top" width="31.666666666666664%" headers="d0e268 ">Member name</td>
<td valign="top" width="30%" headers="d0e270 ">*ALL</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%ALL%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*FILE</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%FILE%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*FIRST</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%FIRST%</td>
</tr>
<tr><td valign="top" width="30%" headers="d0e270 ">*LAST</td>
<td valign="top" width="38.333333333333336%" headers="d0e272 ">%LAST%</td>
</tr>
</tbody>
</table>
</div>
<p>See the <a href="qsyspath.htm#qsyspath">QSYSObjectPathName</a> class
for information about building and parsing integrated file system names.</p>
<p>For
more information about integrated file system concepts, see <a href="../ifs/rzaaxbasics.htm">Integrated file system concepts</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="progtips.htm" title="This section features a variety of tips that can help you use IBM Toolbox for Java.">Tips for programming</a></div>
</div>
</div>
</body>
</html>