137 lines
9.0 KiB
HTML
137 lines
9.0 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="Generic object names" />
|
||
|
|
<meta name="abstract" content="Generic object names can be used when referring to multiple objects with similar names." />
|
||
|
|
<meta name="description" content="Generic object names can be used when referring to multiple objects with similar names." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6objects.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../ifs/rzaaxkickoff.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../apiref/genericlibname.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6objnamrules.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbam6genericnames.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="rbam6genobj" />
|
||
|
|
<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>Generic object names</title>
|
||
|
|
</head>
|
||
|
|
<body id="rbam6genobj"><a name="rbam6genobj"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Generic object names</h1>
|
||
|
|
<div><p>Generic object names can be used when referring to multiple objects
|
||
|
|
with similar names.</p>
|
||
|
|
<p>A <em>generic object name</em> may refer to more than one object. That is,
|
||
|
|
a generic name contains one or more characters that are the first group of
|
||
|
|
characters in the names of several objects; the system then searches for all
|
||
|
|
the objects that have those characters at the beginning of their names and
|
||
|
|
are in the libraries named in the library list. A generic name is identified
|
||
|
|
by an asterisk (*) as the last character in the name.</p>
|
||
|
|
<p>A quoted generic name consists of a generic name enclosed in quotation
|
||
|
|
marks. Unlike quoted names, if there are no special characters between the
|
||
|
|
quotation marks, the quotation marks are not removed. The generic name "ABC*"
|
||
|
|
would cause the system to search for objects whose name begins with <em>"ABC</em>.</p>
|
||
|
|
<p>A generic name can also be qualified by a library name. If the generic
|
||
|
|
name is qualified, the system will search only the specified library for objects
|
||
|
|
whose names begin with that generic name.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> A generic name also can be qualified by one or more directories if it
|
||
|
|
is a path name. In a path name, letters can be specified before and after
|
||
|
|
the asterisk (*).</div>
|
||
|
|
<p>When you specify a generic name, the system performs the required function
|
||
|
|
on all objects whose names begin with the specified series of characters.
|
||
|
|
You must have the authority required to perform that function on every object
|
||
|
|
the generic name identifies. If you do not have the required authority for
|
||
|
|
an object, the function is not performed and a diagnostic message is issued
|
||
|
|
for each instance that the attempted generic function failed. A completion
|
||
|
|
message is issued for each object the generic function operates on successfully.
|
||
|
|
You must view the online low-level messages to see the completion messages.
|
||
|
|
Once the entire generic function is completed, a completion message is issued
|
||
|
|
that states that all objects were operated on successfully. If one or more
|
||
|
|
objects could not be successfully operated on an escape message is issued.
|
||
|
|
If an override is in effect for a specific device file, the single object
|
||
|
|
name specified on the override, rather than the generic name, is used to perform
|
||
|
|
the operation.</p>
|
||
|
|
<p>You may not be able to use a generic name for delete, move, or rename commands
|
||
|
|
if the library containing the objects is already locked. A search for generic
|
||
|
|
object names requires a more restrictive lock on the library containing the
|
||
|
|
objects than a search for full object names. The more restrictive lock is
|
||
|
|
necessary to prevent another user from creating an object with the same name
|
||
|
|
as the generic search string in the library while the delete, move, or rename
|
||
|
|
command is running. You can circumvent this problem by using the full name
|
||
|
|
of the objects instead of a generic name. Or you can end the job or subsystem
|
||
|
|
that has a lock on the library.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> Use the <span class="cmdname">Work with Object Locks (WRKOBJLCK)</span> command
|
||
|
|
to determine which jobs or subsystems have a lock on the library.</div>
|
||
|
|
<p>For some commands, a library qualifier can be specified with the generic
|
||
|
|
name to limit the scope of the operation. For example, a Change Print File
|
||
|
|
(CHGPRTF) command with <samp class="codeph">FILE(LIB1/PRT*)</samp> performs the desired
|
||
|
|
operation on printer files beginning with <samp class="codeph">PRT</samp> in library
|
||
|
|
<samp class="codeph">LIB1</samp> only; printer files in other libraries are not affected.</p>
|
||
|
|
<p>The limitations associated with the various library qualifiers are as follows:</p>
|
||
|
|
<ul><li> <em>library-name:</em> The operation is performed on generic object names
|
||
|
|
only in the specified library.</li>
|
||
|
|
<li>*LIBL: The operation is performed on generic object names in the library
|
||
|
|
list associated with the job that requested the generic operation.</li>
|
||
|
|
<li>*CURLIB: The operation is performed on generic object names in the current
|
||
|
|
library.</li>
|
||
|
|
<li> *ALL: The operation is performed on generic object names in all libraries
|
||
|
|
for which you are authorized. </li>
|
||
|
|
<li>*USRLIBL: The operation is performed on generic object names in the user
|
||
|
|
part of the library list for the job.</li>
|
||
|
|
<li>*ALLUSR: The operation is performed on all nonsystem libraries (libraries
|
||
|
|
that do not start with the letter Q), with some exceptions. <div class="note"><span class="notetitle">Note:</span> A different
|
||
|
|
library name, of the form QUSRVxRxMx, can be created by the user for each
|
||
|
|
release that IBM<sup>®</sup>
|
||
|
|
supports. VxRxMx is the version, release, and modification level of the library.</div>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 1. Generic object name </caption><thead align="left"><tr><th valign="top" width="24.579124579124578%" id="d0e87">Name Type</th>
|
||
|
|
<th valign="top" width="28.28282828282828%" id="d0e89">Name Syntax</th>
|
||
|
|
<th valign="top" width="47.13804713804714%" id="d0e91">Example</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="24.579124579124578%" headers="d0e87 ">Simple generic name</td>
|
||
|
|
<td valign="top" width="28.28282828282828%" headers="d0e89 ">generic-name*</td>
|
||
|
|
<td valign="top" width="47.13804713804714%" headers="d0e91 ">OBJ*</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="24.579124579124578%" headers="d0e87 ">Qualified generic name</td>
|
||
|
|
<td valign="top" width="28.28282828282828%" headers="d0e89 "> library-name/generic-name*</td>
|
||
|
|
<td valign="top" width="47.13804713804714%" headers="d0e91 ">LIB1/OBJ*</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="24.579124579124578%" headers="d0e87 ">Quoted generic name</td>
|
||
|
|
<td valign="top" width="28.28282828282828%" headers="d0e89 ">"generic-name*"</td>
|
||
|
|
<td valign="top" width="47.13804713804714%" headers="d0e91 ">"ABC*"</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbam6objects.htm" title="An i5/OS object is a named unit that exists (occupies space) in storage, and on which operations are performed by the operating system. i5/OS objects provide the means through which all data processing information is stored and processed by i5/OS.">Objects</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rbam6objnamrules.htm" title="This describes rules for naming i5/OS objects.">Object naming rules</a></div>
|
||
|
|
<div><a href="rbam6genericnames.htm" title="A generic name is one that contains at least one initial character that is common to a group of objects, followed by an asterisk.">Generic names (*GENERIC)</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../ifs/rzaaxkickoff.htm">Integrated file systems</a></div>
|
||
|
|
<div><a href="../apiref/genericlibname.htm">Generic library names</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|