242 lines
8.4 KiB
HTML
242 lines
8.4 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Change Link List (CHGLNKLBRM)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CHGLNKLBRM.Top_Of_Page"></a>
|
|
<h2>Change Link List (CHGLNKLBRM)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CHGLNKLBRM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGLNKLBRM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGLNKLBRM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGLNKLBRM"></a>
|
|
<p>The Change Link List (CHGLNKLBRM) allows you to change a list of object to be used in backup or archive processing. You can include the fully qualified object name and whether you want to include or exclude the object from the list.
|
|
</p>
|
|
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
|
|
</p>
|
|
<p><b>Restrictions: </b>
|
|
</p>
|
|
<ol>
|
|
<li>The CHGLNKLBRM command uses the i5/OS Save Object (SAV) and Restore Object (RST) commands to process the lists that you enter into the CHGLNKLBRM command. These restrictions can be reviewed in the SAV and RST command help information.
|
|
</li>
|
|
<li>You cannot save QDLS or QSYS.LIB using the Save Object using BRM (SAVBRM) command.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGLNKLBRM.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLNKLBRM.LIST"><b>LIST</b></a></td>
|
|
<td valign="top">List</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLNKLBRM.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Usage type</td>
|
|
<td valign="top"><b><u>*BKU</u></b>, *ARC</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGLNKLBRM.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Objects</td>
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Name</td>
|
|
<td valign="top">
|
|
<i>Path name</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Include or omit</td>
|
|
<td valign="top">
|
|
<b><u>*INCLUDE</u></b>, *OMIT</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLNKLBRM.SUBTREE"><b>SUBTREE</b></a></td>
|
|
<td valign="top">Directory subtree</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *DIR, *NONE, *OBJ</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGLNKLBRM.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGLNKLBRM.LIST"></a>
|
|
<h3>List (LIST)</h3>
|
|
<p>The name of the list being changed to contain integrated file system objects. The list must be an existing BRMS link list.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLNKLBRM.TYPE"></a>
|
|
<h3>Usage type (TYPE)</h3>
|
|
<p>Specifies the intended usage type of the items that you are grouping together for processing.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BKU</u></b></dt>
|
|
<dd>The list is used in backup processing.
|
|
</dd>
|
|
<dt><b>*ARC</b></dt>
|
|
<dd>The list is used in archive processing.
|
|
<p>
|
|
<b>Note: </b>The BRMS Advanced feature (Option 2) is required to use this value.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLNKLBRM.OBJ"></a>
|
|
<h3>Objects (OBJ)</h3>
|
|
<p>Specifies the objects that you want to include or exclude from a list of objects you want to save. A maximum of 300 object name patterns can be specified.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Element 1: Name</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>'*'</b></dt>
|
|
<dd>The objects in the current directory are saved.
|
|
</dd>
|
|
<dt><b><i>'object-path-name-pattern'</i></b></dt>
|
|
<dd>Specify an object path name or a pattern that can match many names.
|
|
<p><b>Restriction: </b>
|
|
</p>
|
|
<ul>
|
|
<li>You cannot list QDLS or QSYS.LIB objects in a link list. Use the appropriate *OBJ or *FLR list for objects in these file systems. To create lists of objects in these file systems, use the Work with Lists using BRMS (WRKLBRM) command.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Include or omit</b>
|
|
</p>
|
|
<p>The second part specifies whether names that match the pattern should be included or omitted from the operation. Note that in determining whether a name matches a pattern, relative name patterns are always treated as relative to the current working directory. The <b>Directory subtree (SUBTREE)</b> parameter determines whether the subtrees are included or omitted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INCLUDE</u></b></dt>
|
|
<dd>Objects that match the object name pattern are to be saved, unless overridden by an *OMIT specification.
|
|
</dd>
|
|
<dt><b>*OMIT</b></dt>
|
|
<dd>Objects matching the object name pattern are not to be saved. This overrides a *INCLUDE specification and is intended to be used to omit a subset of a previously selected pattern.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLNKLBRM.SUBTREE"></a>
|
|
<h3>Directory subtree (SUBTREE)</h3>
|
|
<p>Specifies whether directory subtrees should be processed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>The entire subtree for each directory that matches the object name pattern will be processed.
|
|
</dd>
|
|
<dt><b>*DIR</b></dt>
|
|
<dd>Objects in the first level of each directory that matches the object name pattern will be processed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No subtrees are included in the save operation. If a directory matches the object name pattern specified, the objects in the directory are included. If the directory has subdirectories, neither the subdirectories nor the objects in the subdirectories are included.
|
|
</dd>
|
|
<dt><b>*OBJ</b></dt>
|
|
<dd>Only the objects that exactly match the object name pattern will be processed. If the object name pattern specifies a directory, objects in the directory are not included.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGLNKLBRM.TEXT"></a>
|
|
<h3>Text (TEXT)</h3>
|
|
<p>Specifies the text that describes the integrated file system object list.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>text</i></b></dt>
|
|
<dd>Specify the text that describes the integrated file system object list.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGLNKLBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing a Link List</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGLNKLBRM LIST(MYLIST) USE(*BKU)
|
|
OBJ(('/*' *INCLUDE) ('/QSYS.LIB/' *OMIT)
|
|
('/QDLS/' *OMIT) ('/NOTES/DATA/' *OMIT))
|
|
</pre>
|
|
</p>
|
|
<p>In this example a list of integrated file system objects includes the entire system except the QSYS.LIB and QDLS file systems, and the /NOTES/DATA directories.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGLNKLBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>BRM1917</b></dt>
|
|
<dd>Feature not installed.
|
|
</dd>
|
|
<dt><b>BRM1921</b></dt>
|
|
<dd>Feature not licensed.
|
|
</dd>
|
|
<dt><b>BRM40A2</b></dt>
|
|
<dd>BRMS product initialization required.
|
|
</dd>
|
|
<dt><b>CPF9800</b></dt>
|
|
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGLNKLBRM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|