225 lines
13 KiB
HTML
225 lines
13 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="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>
|