1796 lines
74 KiB
HTML
1796 lines
74 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>Save Library (SAVLIB)</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="SAVLIB.Top_Of_Page"></a>
|
||
|
|
<h2>Save Library (SAVLIB)</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="#SAVLIB.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVLIB.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVLIB.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVLIB"></a>
|
||
|
|
<p>The Save Library (SAVLIB) command allows you to save a copy of one or more libraries.
|
||
|
|
</p>
|
||
|
|
<p>When saving to a save file, only one library can be specified.
|
||
|
|
</p>
|
||
|
|
<p>This command saves the entire library, including the library description, the object descriptions, and the contents of the objects in the library. For job queues, message queues, and logical files, only the object definitions are saved, not the contents. However, logical file access paths can be saved by specifying *YES for the <b>Save access paths (ACCPTH)</b> parameter. The contents of spooled files on output queues can be saved by specifying *ALL for the <b>Spooled file data (SPLFDTA)</b> parameter. The contents of a save file can be saved by specifying *YES for the <b>Save file data (SAVFDTA)</b> parameter or using the Save Save File Data (SAVSAVFDTA) command. The contents of a data queue can be saved by specifying *DTAQ for the <b>Queue data (QDTA)</b> parameter. The libraries and their objects are not affected in the system unless the command specifies that the storage is to be freed. However, unless *NO is specified for the <b>Update history (UPDHST)</b> parameter, the description of each library and each object is updated with the date, place, and time it was last saved. If a group of libraries is saved by specifying *NONSYS, *ALLUSR, or *IBM for the LIB parameter, the date, time, and place are updated in the history information for a data area in QSYS (data area QSAVLIBALL, QSAVALLUSR, or QSAVIBM).
|
||
|
|
</p>
|
||
|
|
<p>The types of objects saved by this command are the same as those listed in the OBJTYPE parameter description in "Commonly used parameters: Expanded descriptions" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter, with the addition of *DTADCT. Certain operating system objects that are not contained in user libraries (such as user profiles) are not saved by this command. They can be saved by the Save System (SAVSYS) or Save Security Data (SAVSECDTA) commands.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This command ignores all file overrides currently in effect for the job, except for the listing file.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You must either have save system (*SAVSYS) special authority or the following object authorities:
|
||
|
|
<ul>
|
||
|
|
<li>read (*READ) authority for, or be the owner of, each library specified
|
||
|
|
</li>
|
||
|
|
<li>object existence (*OBJEXIST) authority for each object in the library (for spooled file data, *OBJEXIST authority for the output queue)
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>If you do not have *SAVSYS special authority, only those libraries and objects that you have authority for are saved.
|
||
|
|
</li>
|
||
|
|
<li>When saving to a tape or optical volume, you must have use (*USE) authority to the associated device description.
|
||
|
|
</li>
|
||
|
|
<li>When saving to a save file, you must have add (*ADD) and use (*USE) authorities to the save file.
|
||
|
|
</li>
|
||
|
|
<li>When using a media definition, you must have *USE authority to the media definition and execute (*EXECUTE) authority to the library where the media definition is located.
|
||
|
|
</li>
|
||
|
|
<li>When using the OUTFILE parameter to save to an existing database file, you must have *EXECUTE authority to the output file library.
|
||
|
|
</li>
|
||
|
|
<li>No library being saved, or the objects in it, can be updated by a job that is running at the time the save operation occurs unless save-while-active is used.
|
||
|
|
</li>
|
||
|
|
<li>When the contents of a save file are being saved to the same save file by specifying SAVFDTA(*YES), only the description of the save file is saved.
|
||
|
|
</li>
|
||
|
|
<li>When the contents of a save file are saved, by specifying *YES for the <b>Save file data (SAVFDTA)</b> parameter, the save file must be restored before objects contained in it can be restored.
|
||
|
|
</li>
|
||
|
|
<li>When using the <b>Command user space (CMDUSRSPC)</b> parameter, you must have *USE authority to the user space and *EXECUTE authority to the user space library.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVLIB.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="#SAVLIB.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top">Single values: *NONSYS, *ALLUSR, *IBM, *USRSPC<br>Other values (up to 300 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Single values: *SAVF, *MEDDFN<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.VOL"><b>VOL</b></a></td>
|
||
|
|
<td valign="top">Volume identifier</td>
|
||
|
|
<td valign="top">Single values: <b><u>*MOUNTED</u></b><br>Other values (up to 75 repetitions): <i>Character value</i></td>
|
||
|
|
<td valign="top">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.SEQNBR"><b>SEQNBR</b></a></td>
|
||
|
|
<td valign="top">Sequence number</td>
|
||
|
|
<td valign="top">1-16777215, <b><u>*END</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.LABEL"><b>LABEL</b></a></td>
|
||
|
|
<td valign="top">Label</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*LIB</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.EXPDATE"><b>EXPDATE</b></a></td>
|
||
|
|
<td valign="top">File expiration date</td>
|
||
|
|
<td valign="top"><i>Date</i>, <b><u>*PERM</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.ENDOPT"><b>ENDOPT</b></a></td>
|
||
|
|
<td valign="top">End of media option</td>
|
||
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.STRLIB"><b>STRLIB</b></a></td>
|
||
|
|
<td valign="top">Starting library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.SAVF"><b>SAVF</b></a></td>
|
||
|
|
<td valign="top">Save file</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Save file</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.MEDDFN"><b>MEDDFN</b></a></td>
|
||
|
|
<td valign="top">Media definition</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Media definition</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.OPTFILE"><b>OPTFILE</b></a></td>
|
||
|
|
<td valign="top">Optical file</td>
|
||
|
|
<td valign="top"><i>Path name</i>, <b><u>*</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.USEOPTBLK"><b>USEOPTBLK</b></a></td>
|
||
|
|
<td valign="top">Use optimum block</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.TGTRLS"><b>TGTRLS</b></a></td>
|
||
|
|
<td valign="top">Target release</td>
|
||
|
|
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.UPDHST"><b>UPDHST</b></a></td>
|
||
|
|
<td valign="top">Update history</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.CLEAR"><b>CLEAR</b></a></td>
|
||
|
|
<td valign="top">Clear</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL, *AFTER, *REPLACE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.PRECHK"><b>PRECHK</b></a></td>
|
||
|
|
<td valign="top">Object pre-check</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.SAVACT"><b>SAVACT</b></a></td>
|
||
|
|
<td valign="top">Save active</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *LIB, *SYNCLIB, *SYSDFN</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#SAVLIB.SAVACTWAIT"><b>SAVACTWAIT</b></a></td>
|
||
|
|
<td valign="top">Save active wait time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object locks</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>120</u></b>, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Pending record changes</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>*LOCKWAIT</u></b>, *NOCMTBDY, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Other pending changes</td>
|
||
|
|
<td valign="top">
|
||
|
|
0-99999, <b><u>*LOCKWAIT</u></b>, *NOMAX</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.SAVACTMSGQ"><b>SAVACTMSGQ</b></a></td>
|
||
|
|
<td valign="top">Save active message queue</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Save active message queue</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b>, *WRKSTN</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.ACCPTH"><b>ACCPTH</b></a></td>
|
||
|
|
<td valign="top">Save access paths</td>
|
||
|
|
<td valign="top"><b><u>*SYSVAL</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.SAVFDTA"><b>SAVFDTA</b></a></td>
|
||
|
|
<td valign="top">Save file data</td>
|
||
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.SPLFDTA"><b>SPLFDTA</b></a></td>
|
||
|
|
<td valign="top">Spooled file data</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.QDTA"><b>QDTA</b></a></td>
|
||
|
|
<td valign="top">Queue data</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *DTAQ</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.STG"><b>STG</b></a></td>
|
||
|
|
<td valign="top">Storage</td>
|
||
|
|
<td valign="top"><b><u>*KEEP</u></b>, *FREE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.DTACPR"><b>DTACPR</b></a></td>
|
||
|
|
<td valign="top">Data compression</td>
|
||
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO, *YES, *LOW, *MEDIUM, *HIGH</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.COMPACT"><b>COMPACT</b></a></td>
|
||
|
|
<td valign="top">Data compaction</td>
|
||
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.OMITLIB"><b>OMITLIB</b></a></td>
|
||
|
|
<td valign="top">Libraries to omit</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b>, *USRSPC<br>Other values (up to 300 repetitions): <i>Generic name, name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#SAVLIB.OMITOBJ"><b>OMITOBJ</b></a></td>
|
||
|
|
<td valign="top">Objects to omit</td>
|
||
|
|
<td valign="top">Single values: *USRSPC<br>Other values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Object</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Object</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*NONE</u></b>, *ALL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Object type</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ALL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.ASPDEV"><b>ASPDEV</b></a></td>
|
||
|
|
<td valign="top">ASP device</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*</u></b>, *SYSBAS, *CURASPGRP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *PRINT, *OUTFILE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.OUTFILE"><b>OUTFILE</b></a></td>
|
||
|
|
<td valign="top">File to receive output</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: File to receive output</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.OUTMBR"><b>OUTMBR</b></a></td>
|
||
|
|
<td valign="top">Output member options</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Member to receive output</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i>, <b><u>*FIRST</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Replace or add records</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*REPLACE</u></b>, *ADD</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVLIB.INFTYPE"><b>INFTYPE</b></a></td>
|
||
|
|
<td valign="top">Type of output information</td>
|
||
|
|
<td valign="top"><b><u>*OBJ</u></b>, *LIB, *MBR, *ERR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#SAVLIB.CMDUSRSPC"><b>CMDUSRSPC</b></a></td>
|
||
|
|
<td valign="top">Command user space</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Command user space</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr></table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVLIB.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies which libraries are saved.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The system libraries QDOC, QDOCxxxx, QRCYxxxxx, QRECOVERY, QRPLOBJ, QRPLxxxxx, QSPL, QSPLxxxx, QSRV, QSYS, QSYSxxxxx, and QTEMP cannot be saved with this command. xxxx is a basic user ASP number, and xxxxx is an independent ASP number.
|
||
|
|
</li>
|
||
|
|
<li>If you specify *ALLUSR or *IBM on this parameter, this command should be run when the specified libraries are not being used. If objects in a library are in use while the library is being saved, the objects are not saved unless you use SAVACT. To ensure a complete save of all libraries, run this command with the system in a restricted state. For example, if SAVLIB LIB(*ALLUSR) is run when the subsystem QSNADS is active, the QAO* files are not saved in library QUSRSYS. To save the QAO* files, end the QSNADS subsystem before running SAVLIB LIB(*ALLUSR).
|
||
|
|
</li>
|
||
|
|
<li>Doing a SAVLIB LIB(*IBM) and then doing a SAVLIB LIB(*ALLUSR) saves the same libraries as a SAVLIB LIB(*NONSYS), but requires two restore commands.
|
||
|
|
</li>
|
||
|
|
<li>Libraries are saved alphabetically by ASP device name for each value specified. Libraries on independent ASPs are saved before libraries on the system and basic user ASPs. For values *NONSYS and *ALLUSR, libraries QSYS2, QGPL, QUSRSYS, and QSYS2xxxxx (where xxxxx is an independent ASP number) are saved first, if they are located on the ASPs specified by the ASPDEV parameter.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONSYS</b></dt>
|
||
|
|
<dd>All libraries except the system libraries are saved. All subsystems must be ended by the End Subsystem (ENDSBS) or End System (ENDSYS) command before this option is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>All user libraries are saved. All libraries with names that do not begin with the letter Q are saved except for the following:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered "user libraries," and are also saved:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
|
||
|
|
QGPL QSRVAGT QUSRINFSKR
|
||
|
|
QGPL38 QSYS2 QUSRNOTES
|
||
|
|
QMGTC QSYS2xxxxx QUSROND
|
||
|
|
QMGTC2 QS36F QUSRPOSGS
|
||
|
|
QMPGDATA QUSER38 QUSRPOSSA
|
||
|
|
QMQMDATA QUSRADSM QUSRPYMSVR
|
||
|
|
QMQMPROC QUSRBRM QUSRRDARS
|
||
|
|
QPFRDATA QUSRDIRCL QUSRSYS
|
||
|
|
QRCL QUSRDIRDB QUSRVI
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IBM</b></dt>
|
||
|
|
<dd>Saves all IBM-supplied libraries except for the following:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
QDOC QRCYxxxxx QTEMP QUSRRDARS
|
||
|
|
QDOCxxxx QRECOVERY QUSER38 QUSRSYS
|
||
|
|
QDSNX QRPLOBJ QUSRADSM QUSRVI
|
||
|
|
QGPL QRPLxxxxx QUSRBRM QUSRVxRxMx
|
||
|
|
QGPL38 QSPL QUSRDIRCL
|
||
|
|
QMGTC QSPLxxxx QUSRDIRDB
|
||
|
|
QMGTC2 QSRV QUSRIJS
|
||
|
|
QMPGDATA QSRVAGT QUSRINFSKR
|
||
|
|
QMQMDATA QSYS QUSRNOTES
|
||
|
|
QMQMPROC QSYSxxxxx QUSROND
|
||
|
|
QPFRDATA QSYS2 QUSRPOSGS
|
||
|
|
QRCL QSYS2xxxxx QUSRPOSSA
|
||
|
|
QRCLxxxxx QS36F QUSRPYMSVR
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
|
||
|
|
</p>
|
||
|
|
<p>The following libraries with names that do not begin with the letter Q are also saved:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRSPC</b></dt>
|
||
|
|
<dd>The libraries identified in the user space specified for the <b>Command user space (CMDUSRSPC)</b> parameter are saved. Only one library can be specified in the user space when saving to a save file. Special value *SPLF cannot be specified in the user space.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries to be saved. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all libraries with names that begin with the generic prefix, for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete library name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be saved. Only one library name can be saved when saving to a save file. A system library name cannot be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the name of the device used for the save operation. The device name must already be known on the system by a device description.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SAVF</b></dt>
|
||
|
|
<dd>The save operation is done using the save file specified for the <b>Save file (SAVF)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDDFN</b></dt>
|
||
|
|
<dd>The save operation is done using the devices and media identified in the media definition specified for the <b>Media definition (MEDDFN)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the optical device used for the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>tape-media-library-device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the tape media library device used for the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>tape-device-name</i></b></dt>
|
||
|
|
<dd>Specify the names of one or more tape devices used for the save operation. If a virtual tape device is used, it must be the only device specified. If multiple tape devices are used, they must have compatible media formats and their names must be specified in the order in which they are used. Using more than one tape device permits one tape volume to be rewound and unloaded while another tape device processes the next tape volume. To use more than one device in parallel, a media definition must be specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.VOL"></a>
|
||
|
|
<h3>Volume identifier (VOL)</h3>
|
||
|
|
<p>Specifies the volume identifiers of the volumes, or the cartridge identifiers of tapes in a tape media library device, on which the data is saved. The volumes must be placed in the device in the same order as specified for this parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
||
|
|
<dd>The data is saved on the volumes placed in the device. For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value cannot be specified when using an optical media library device.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 75 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the identifiers of one or more volumes in the order in which they are placed in a device and used to save the data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies, when tape is used, the sequence number to use as the starting point for the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>The save operation begins after the last sequence number on the first tape. If the first tape is full, an error message is issued and the operation ends.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>1-16777215</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the file to be used for the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>If *NONSYS, *ALLUSR, or *IBM is specified for the LIB parameter, the save operation for the set of libraries begins at the sequence number specified. The first file saved in this set is the QFILE file. The QFILE file contains the list of libraries saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.LABEL"></a>
|
||
|
|
<h3>Label (LABEL)</h3>
|
||
|
|
<p>Specifies the name that identifies the data file on the tape volume that is to be used for the save operation. If this parameter is used on the save command, the same label must be specified on the restore command.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You cannot specify *SAVLIB on this parameter, since it is a special value for the <b>Label (LABEL)</b> parameter of the restore command and would prevent you from restoring what you saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIB</u></b></dt>
|
||
|
|
<dd>The file label is created by the system using the name of the library specified for the <b>Library (LIB)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the data file identifier of the data file used for the save operation. A maximum of 17 characters can be used. This option is valid only for a single-library save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.EXPDATE"></a>
|
||
|
|
<h3>File expiration date (EXPDATE)</h3>
|
||
|
|
<p>Specifies the expiration date of the file created by the save operation. If a date is specified, the file is protected and cannot be overwritten until the specified expiration date.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This parameter is valid for tape and optical files.
|
||
|
|
</li>
|
||
|
|
<li>Specifying this parameter does not protect against a later save operation specifying CLEAR(*ALL).
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*PERM</u></b></dt>
|
||
|
|
<dd>The file is protected permanently.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>date</i></b></dt>
|
||
|
|
<dd>Specify the date when protection for the file ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.ENDOPT"></a>
|
||
|
|
<h3>End of media option (ENDOPT)</h3>
|
||
|
|
<p>Specifies the operation that is automatically done on the tape or optical volume after the save operation ends. If more than one volume is used, this parameter applies only to the last volume used; all other volumes are unloaded when the end of the volume is reached.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified for the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REWIND</u></b></dt>
|
||
|
|
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LEAVE</b></dt>
|
||
|
|
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*UNLOAD</b></dt>
|
||
|
|
<dd>The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.STRLIB"></a>
|
||
|
|
<h3>Starting library (STRLIB)</h3>
|
||
|
|
<p>Specifies the library with which to begin the save operation.
|
||
|
|
</p>
|
||
|
|
<p>If an unrecoverable media error occurs during the save operation, this parameter can be used to restart the operation.
|
||
|
|
</p>
|
||
|
|
<p>The basic steps for restarting a save operation are:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Check the job log to determine the library where the previous save operation failed. Find the last library saved, which is indicated by a successful completion message.
|
||
|
|
</li>
|
||
|
|
<li>Load the next tape and ensure the tape is initialized.
|
||
|
|
</li>
|
||
|
|
<li>Add the following to your original save command:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
STRLIB(library-name) OMITLIB(library-name)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>where the <i>library-name</i> for the STRLIB and OMITLIB parameters is the last library successfully saved. This starts the save operation on the library after the last successfully saved library.
|
||
|
|
</p>
|
||
|
|
<p>To restore the libraries, you will need to perform a separate restore operation for each save operation that was performed.
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The save operation begins with the first library value specified for the <b>Library (LIB)</b> parameter. If the first value is a generic name or special value, the save operation begins with the first library that matches this value.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library with which to begin the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SAVF"></a>
|
||
|
|
<h3>Save file (SAVF)</h3>
|
||
|
|
<p>Specifies the save file that is used to contain the saved data. The save file must be empty, unless *ALL is specified for the <b>Clear (CLEAR)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A value must be specified for this parameter if *SAVF is specified for the <b>Device (DEV)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Save file</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of save file to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the save file is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.MEDDFN"></a>
|
||
|
|
<h3>Media definition (MEDDFN)</h3>
|
||
|
|
<p>Specifies the media definition (*MEDDFN) object that identifies the devices and media used to contain the saved data. For information about creating and using a media definition, see the Backup and Recovery book, SC41-5304, and the Create Media Definition API in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
<p>If a media definition is specified, the VOL, SEQNBR, SAVF, and OPTFILE parameters cannot be specified. The volume identifiers and sequence numbers are specified in the media definition.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: Media definition</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the media definition to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OPTFILE"></a>
|
||
|
|
<h3>Optical file (OPTFILE)</h3>
|
||
|
|
<p>Specifies the path name of the optical file that is used for the save operation, beginning with the root directory of the volume.
|
||
|
|
</p>
|
||
|
|
<p>For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The system generates an optical file name in the root directory of the optical volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'optical-directory-path-name/*'</i></b></dt>
|
||
|
|
<dd>The system generates an optical file name in the specified directory of the optical volume.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>'optical-file-path-name'</i></b></dt>
|
||
|
|
<dd>Specify the path name of the optical file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.USEOPTBLK"></a>
|
||
|
|
<h3>Use optimum block (USEOPTBLK)</h3>
|
||
|
|
<p>Specifies whether or not the optimum block size is used for the save operation.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Specifying USEOPTBLK(*YES) may result in a tape that can be duplicated only to a device that supports the same block size.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The optimum block size supported by the device is used for Save commands. If the block size that is used is larger than a block size that is supported by all device types, then:
|
||
|
|
<ul>
|
||
|
|
<li>Performance may improve.
|
||
|
|
</li>
|
||
|
|
<li>The tape file that is created is only compatible with a device that supports the block size used. Commands such as Duplicate Tape (DUPTAP) do not duplicate files unless the files are being duplicated to a device which supports the same block size that was used.
|
||
|
|
</li>
|
||
|
|
<li>The value for the DTACPR parameter is ignored.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The optimum block size supported by the device is not used. Save commands use the default block size supported by all device types. The tape volume can be duplicated to any media format using the Duplicate Tape (DUPTAP) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.TGTRLS"></a>
|
||
|
|
<h3>Target release (TGTRLS)</h3>
|
||
|
|
<p>Specifies the release of the operating system on which you intend to restore and use the object.
|
||
|
|
</p>
|
||
|
|
<p>When specifying the <b>target-release</b> value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.
|
||
|
|
</p>
|
||
|
|
<p>Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.
|
||
|
|
</p>
|
||
|
|
<p>To specify that an object be saved for distribution to a system at a different release level than the system on which the save operation is to occur, the procedure differs for program or non-program objects and by the release level on which a program object is created. If, for example, you are saving an object for distribution to a target system running on an earlier release, you have the following choices:
|
||
|
|
</p>
|
||
|
|
<p><b>For program objects:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>If the program object was created at a release level more current than the targeted earlier release, you must:
|
||
|
|
<ol>
|
||
|
|
<li>create the program object again specifying the targeted earlier release
|
||
|
|
</li>
|
||
|
|
<li>save the program object specifying the targeted earlier release
|
||
|
|
</li>
|
||
|
|
<li>restore the program object on the target system.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li>If the program object was created at the same release level as the target system, you can:
|
||
|
|
<ol>
|
||
|
|
<li>save the program object specifying the targeted earlier release
|
||
|
|
</li>
|
||
|
|
<li>restore the program object on the target system.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>For non-program objects:</b>
|
||
|
|
</p>
|
||
|
|
<p>You can:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>save the object specifying the targeted earlier release
|
||
|
|
</li>
|
||
|
|
<li>restore the object on the target system.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The object is to be restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRV</b></dt>
|
||
|
|
<dd>The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to a system with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>If LIB(*NONSYS), LIB(*ALLUSR), or LIB(*IBM) is specified, only the current release can be the target release.
|
||
|
|
</li>
|
||
|
|
<li>Not all objects can be targeted to another release. To find out which objects are supported, see the chart in the Backup and Recovery book, SC41-5304.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.UPDHST"></a>
|
||
|
|
<h3>Update history (UPDHST)</h3>
|
||
|
|
<p>Specifies whether the save history information of each saved object is changed with the date, time, and location of this save operation. The save history information for an object is displayed using the Display Object Description (DSPOBJD) command. The save history information is used to determine which journal entries are processed when RCVRNG(*LASTSAVE) and FROMENT(*LASTSAVE) or FROMENTLRG(*LASTSAVE) are used on the Apply Journaled Changes (APYJRNCHG) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The last save date, time, and location is updated in each object saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The save history information contained in the description of each object saved is not updated.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>UPDHST(*NO) should be used for a save operation that is not intended for recovery. For example, if the save data is sent, record by record, to another system and the save file immediately deleted, the save history information is probably not to be updated.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.CLEAR"></a>
|
||
|
|
<h3>Clear (CLEAR)</h3>
|
||
|
|
<p>Specifies whether active data on the media is automatically cleared or replaced. Active data is any file on the media that has not expired. For saves to tape, clearing active data will make any files on the tape volume beyond the last file written by the save operation no longer accessible. For saves to optical, the files written by the save operation can be automatically replaced while other files on the volume remain active, or all active files can be automatically cleared. Clearing does not erase the data, it just makes the files no longer accessible.
|
||
|
|
</p>
|
||
|
|
<p><b>Notes:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>Clearing a tape does not initialize it. You should initialize tapes to a standard label format before the save command is issued by using the Initialize Tape (INZTAP) command and specifying a value for the NEWVOL parameter.
|
||
|
|
</li>
|
||
|
|
<li>Clearing an optical volume does initialize it.
|
||
|
|
</li>
|
||
|
|
<li>If a volume that is not initialized is encountered during the save operation, an inquiry message is sent and an operator can initialize the volume.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>None of the media is automatically cleared. If the save operation encounters active data on a tape volume or in a save file, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All of the media is automatically cleared.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>If tapes are used and a sequence number is specified for the SEQNBR parameter, the first tape is cleared beginning at that sequence number. All tapes following that first tape are completely cleared. To clear the entire first tape, SEQNBR(1) must be specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*AFTER</b></dt>
|
||
|
|
<dd>All media after the first volume is automatically cleared. If the save operation encounters active data on the first tape volume, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file on the first volume, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The *AFTER value is not valid for save files.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*REPLACE</b></dt>
|
||
|
|
<dd>Active data on the media is automatically replaced. Optical volumes are not initialized. Other media is automatically cleared in the same way as the *ALL value.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.PRECHK"></a>
|
||
|
|
<h3>Object pre-check (PRECHK)</h3>
|
||
|
|
<p>Specifies whether the save operation for a library ends if any of the following are true:
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The objects do not exist
|
||
|
|
</li>
|
||
|
|
<li>The library or the objects were previously found to be damaged
|
||
|
|
</li>
|
||
|
|
<li>The library or the objects are locked by another job
|
||
|
|
</li>
|
||
|
|
<li>The requester of the save operation does not have authority for the library or to save the objects.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The save operation for a library continues, saving only those objects that can be saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>If, after all specified objects are checked, one or more objects cannot be saved, the save operation for a library ends before any data is written. If multiple libraries are specified, the save operation continues with the next library. However, if PRECHK(*YES) and SAVACT(*SYNCLIB) are specified and an object in any library to be saved does not meet the preliminary check conditions, the save operation ends and no objects are saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SAVACT"></a>
|
||
|
|
<h3>Save active (SAVACT)</h3>
|
||
|
|
<p>Specifies whether an object can be updated while it is being saved.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If your system is in a restricted state and the SAVACT parameter is specified, the save operation is performed as if SAVACT(*NO) was specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Objects that are in use are not saved. Objects cannot be updated while being saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIB</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. All of the objects in a library reach a checkpoint together and are saved in a consistent state in relationship to each other.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYNCLIB</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. All of the objects and all of the libraries in the save operation reach a checkpoint together and are saved in a consistent state in relationship to each other.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you specify this value and you are saving many libraries, it can take a long time to reach a checkpoint for all of the objects and libraries in the save operation.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSDFN</b></dt>
|
||
|
|
<dd>Objects in a library can be saved while they are in use by another job. Objects in a library may reach checkpoints at different times and may not be in a consistent state in relationship to each other.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SAVACTWAIT"></a>
|
||
|
|
<h3>Save active wait time (SAVACTWAIT)</h3>
|
||
|
|
<p>Specifies the amount of time to wait for an object that is in use, or for transactions with pending changes to reach a commit boundary, before continuing the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Object locks</b>
|
||
|
|
</p>
|
||
|
|
<p>For each object that is in use, specifies the amount of time to wait for the object to become available. If an object remains in use for the specified time, the object is not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>120</u></b></dt>
|
||
|
|
<dd>The system waits up to 120 seconds for each individual object lock before continuing the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for each individual object lock before continuing the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Pending record changes</b>
|
||
|
|
</p>
|
||
|
|
<p>For each group of objects that are checkpointed together, specifies the amount of time to wait for transactions with pending record changes to reach a commit boundary. The <b>Save active (SAVACT)</b> parameter determines which objects are checkpointed together. If 0 is specified, all objects being saved must be at commit boundaries. If any other value is specified, all objects that are journaled to the same journals as the objects being saved must reach commit boundaries. If a commit boundary is not reached in the specified time, the save operation is ended, unless the value *NOCMTBDY is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCKWAIT</u></b></dt>
|
||
|
|
<dd>The system waits up to the value specified for Element 1 for transactions with pending record changes to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOCMTBDY</b></dt>
|
||
|
|
<dd>The system will save objects without requiring transactions with pending record changes to reach a commit boundary. Therefore, objects may be saved with partial transactions.
|
||
|
|
<p>If you restore an object that was saved with partial transactions, you cannot use the object until you apply or remove journal changes (APYJRNCHG or RMVJRNCHG command) to reach commit boundaries. You will need all journal receivers that contain information about the partial transactions to apply or remove the changes. Until you apply or remove the changes, any future save of that object will include the partial transactions, even if you do not specify *NOCMTBDY.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value cannot be specified if the <b>Target release (TGTRLS)</b> parameter value is earlier than V5R3M0.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for transactions with pending record changes to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 3: Other pending changes</b>
|
||
|
|
</p>
|
||
|
|
<p>For each library, specifies the amount of time to wait for transactions with other pending changes to reach a commit boundary. Other pending changes include the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Data Definition Language (DDL) object level changes for that library.
|
||
|
|
</li>
|
||
|
|
<li>Any API commitment resource that was added without the option to allow normal save processing. For more information, see the Add Commitment Resource (QTNADDCR) API in the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If a commit boundary is not reached for a library in the specified time, the library is not saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LOCKWAIT</u></b></dt>
|
||
|
|
<dd>The system waits up to the value specified for Element 1 for the types of transactions that are listed above to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOMAX</b></dt>
|
||
|
|
<dd>No maximum wait time exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>0-99999</i></b></dt>
|
||
|
|
<dd>Specify the number of seconds to wait for the types of transactions that are listed above to reach a commit boundary.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SAVACTMSGQ"></a>
|
||
|
|
<h3>Save active message queue (SAVACTMSGQ)</h3>
|
||
|
|
<p>Specifies the message queue that the save operation uses to notify the user that the checkpoint processing for a library is complete. A separate message is sent for each library to be saved when the *SYSDFN or *LIB value is specified for the <b>Save active (SAVACT)</b> parameter. When *SYNCLIB is specified for the SAVACT parameter, one message is sent for all libraries in the save operation.
|
||
|
|
</p>
|
||
|
|
<p>This parameter can be used to save the objects at a known, consistent boundary to avoid additional recovery procedures following a restore operation. Applications can be stopped until the checkpoint processing complete message is received.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No notification message is sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*WRKSTN</b></dt>
|
||
|
|
<dd>The notification message is sent to the work station message queue. This value is not valid in batch mode.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Save active message queue</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue to be used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the message queue. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the message queue is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.ACCPTH"></a>
|
||
|
|
<h3>Save access paths (ACCPTH)</h3>
|
||
|
|
<p>Specifies whether the logical file access paths that are dependent on the physical files being saved are also saved. The access paths are saved only in the case of the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>All members on which the access paths are built are included in this save operation.
|
||
|
|
</li>
|
||
|
|
<li>The access paths are not invalid or damaged at the time of the save.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>The system checks to ensure the integrity of the access paths. Any discrepancies found by the system will result in the access paths being rebuilt.
|
||
|
|
</p>
|
||
|
|
<p>Informational messages are sent indicating the number of logical file access paths saved with each physical file. All physical files on which an access path is built must be in the same library. This parameter does not save logical file objects; it only controls the saving of the access paths. More information on the restoring of saved access paths is in the Backup and Recovery book, SC41-5304.
|
||
|
|
</p>
|
||
|
|
<p><b>ATTENTION: If the based-on physical files and the logical files are in different libraries, the access paths are saved. However, if the logical files and the based-on physical files are in different libraries and the logical files or physical files do not exist at restore time (such as during disaster recovery or the files were deleted) the access paths are not restored. They are rebuilt. For the fastest possible restore operation for logical files, the logical files and the based-on physical files must be in the same library and must be saved at the same time.</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
||
|
|
<dd>The QSAVACCPTH system value determines whether to save the logical file access paths that are dependent on the physical files that are being saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Only those objects specified on the command are saved. No logical file access paths are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The specified physical files and all eligible logical file access paths over them are saved.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>Specifying this value does not save the logical files.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SAVFDTA"></a>
|
||
|
|
<h3>Save file data (SAVFDTA)</h3>
|
||
|
|
<p>Specifies, for save file objects, whether the description of a save file, or both the description and the contents of a save file, are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*YES</u></b></dt>
|
||
|
|
<dd>The description and contents of a save file are saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Only the description of a save file is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.SPLFDTA"></a>
|
||
|
|
<h3>Spooled file data (SPLFDTA)</h3>
|
||
|
|
<p>Specifies whether to save spooled file data and attributes for output queues that are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No spooled file data is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>For each output queue that is saved, all available spooled file data on the output queue is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.QDTA"></a>
|
||
|
|
<h3>Queue data (QDTA)</h3>
|
||
|
|
<p>Specifies, for queue objects, whether the description of a queue, or both the description and the contents of a queue, are saved.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>Only the description of a queue is saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DTAQ</b></dt>
|
||
|
|
<dd>The description and contents of a standard data queue are saved. Only the description of a Distributed Data Management (DDM) data queue is saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.STG"></a>
|
||
|
|
<h3>Storage (STG)</h3>
|
||
|
|
<p>Specifies whether the system storage that is occupied by the data portion of the specified members (except for save files), modules, programs, service programs, Structured Query Language (SQL) packages, and journal receivers in the library being saved is freed as part of the save operation. Only the data portion of the objects is freed, not the descriptions of the objects.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*KEEP</u></b></dt>
|
||
|
|
<dd>The storage occupied by the data portion of the objects being saved is not freed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*FREE</b></dt>
|
||
|
|
<dd>The storage occupied by the data portion of the specified objects being saved is freed as part of the save operation. The storage for all the objects in a library is freed only after all the objects in that library are saved successfully.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To prevent the possible abnormal end of a program, the program being saved must not be running in the system when *FREE is specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.DTACPR"></a>
|
||
|
|
<h3>Data compression (DTACPR)</h3>
|
||
|
|
<p>Specifies whether data compression is used. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *DEV is specified for both this parameter and the <b>Data compaction (COMPACT)</b> parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed.
|
||
|
|
</p>
|
||
|
|
<p>If *YES is specified for this parameter and *DEV is specified for the COMPACT parameter, both device data compaction and device data compression are performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. Otherwise, no data compression is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compression is performed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. If compression is not supported, or if the save data is written to optical media or to a save file, software compression is performed. Low software compression is used for all devices except optical DVD, which uses medium software compression.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOW</b></dt>
|
||
|
|
<dd>If the save operation is to a save file or optical, software data compression is performed with the SNA algorithm. Low compression is usually faster and the compressed data is usually larger than if medium or high compression is used.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value is not valid for tape.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MEDIUM</b></dt>
|
||
|
|
<dd>If the save operation is to a save file or optical, software data compression is performed with the TERSE algorithm. Medium compression is usually slower than low compression but faster than high compression. The compressed data is usually smaller than if low compression is used and larger than if high compression is used.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value is not valid for tape.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HIGH</b></dt>
|
||
|
|
<dd>If the save operation is to a save file or optical, software data compression is performed with the LZ1 algorithm. High compression is usually slower and the compressed data is usually smaller than if low or medium compression is used.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This value is not valid for tape.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.COMPACT"></a>
|
||
|
|
<h3>Data compaction (COMPACT)</h3>
|
||
|
|
<p>Specifies whether device data compaction is performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*DEV</u></b></dt>
|
||
|
|
<dd>Device data compaction is performed if the data is saved to tape and all tape devices specified for the <b>Device (DEV)</b> parameter support the compaction feature.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If *DEV is specified for both the <b>Data compression (DTACPR)</b> parameter and this parameter, only device data compaction is performed if device data compaction is supported on the device. Otherwise, data compression is performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
<p>If *YES is specified for the DTACPR parameter and *DEV is specified for this parameter, both device data compaction and device data compression are performed if supported on the device.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Device data compaction is not performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OMITLIB"></a>
|
||
|
|
<h3>Libraries to omit (OMITLIB)</h3>
|
||
|
|
<p>Specifies the names of one of more libraries, or the generic names of each group of libraries, to be excluded from the save operation.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No libraries are excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USRSPC</b></dt>
|
||
|
|
<dd>The libraries identified in the user space specified for the <b>Command user space (CMDUSRSPC)</b> parameter are excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries to be excluded. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) substitutes for any valid characters. A generic name specifies all libraries with names that begin with the generic prefix, for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete library name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OMITOBJ"></a>
|
||
|
|
<h3>Objects to omit (OMITOBJ)</h3>
|
||
|
|
<p>Specifies the objects to be excluded from the operation. Up to 300 objects or generic object values can be specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USRSPC</b></dt>
|
||
|
|
<dd>The objects identified in the user space specified for the <b>Command user space (CMDUSRSPC)</b> parameter are excluded from the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 300 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Object</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 1: Object</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No objects are excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All objects of the specified object type are excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the objects to be excluded.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the object to be excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>The specified objects are excluded from all libraries that are part of the operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the libraries that contain objects to be excluded.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>A generic name is specified as a character string that contains one or more characters followed by an asterisk (*). If a generic name is specified, then all objects that have names with the same prefix as the generic object name are selected.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library that contains the object to be excluded from the operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Object type</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All object types are excluded from the operation, depending on the value specified for the object name.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>character-value</i></b></dt>
|
||
|
|
<dd>Specify the object type of the objects to be excluded from the operation.
|
||
|
|
<p>To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.ASPDEV"></a>
|
||
|
|
<h3>ASP device (ASPDEV)</h3>
|
||
|
|
<p>Specifies the auxiliary storage pool (ASP) device to be included in the save operation. This parameter is used to subset the list of objects which qualify for the SAV based on the OBJ parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>The operation includes the system ASP (ASP number 1), all basic user ASPs (ASP numbers 2-32), and, if the current thread has an ASP group, all independent ASPs in the ASP group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSBAS</b></dt>
|
||
|
|
<dd>The system ASP and all basic user ASPs are included in the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURASPGRP</b></dt>
|
||
|
|
<dd>If the current thread has an ASP group, all independent ASPs in the ASP group are included in the save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the ASP device to be included in the save operation.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether a list with information about the saved objects is created. The information can be printed with the job's spooled output or directed to a database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No output listing is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*OUTFILE</b></dt>
|
||
|
|
<dd>The output is directed to the database file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You must specify a database file name for the <b>File to receive output (OUTFILE)</b> parameter when OUTPUT(*OUTFILE) is specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OUTFILE"></a>
|
||
|
|
<h3>File to receive output (OUTFILE)</h3>
|
||
|
|
<p>Specifies the database file to which the information is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter. If the file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses QASAVOBJ in QSYS with the format name QSRSAV as a model.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: File to receive output</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the database file to which output from the command is directed. If this file does not exist, it is created in the specified library.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the thread is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.OUTMBR"></a>
|
||
|
|
<h3>Output member options (OUTMBR)</h3>
|
||
|
|
<p>Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the <b>Output (OUTPUT)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Member to receive output</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*FIRST</u></b></dt>
|
||
|
|
<dd>The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified for the <b>File to receive output (OUTFILE)</b> parameter.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.
|
||
|
|
<p>If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Replace or add records</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
||
|
|
<dd>The existing records in the specified database file member are replaced by the new records.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ADD</b></dt>
|
||
|
|
<dd>The new records are added to the existing information in the specified database file member.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.INFTYPE"></a>
|
||
|
|
<h3>Type of information (INFTYPE)</h3>
|
||
|
|
<p>Specifies the type of information which is printed or directed to the database file.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*OBJ</u></b></dt>
|
||
|
|
<dd>The list contains an entry for each object requested to be saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ERR</b></dt>
|
||
|
|
<dd>The list contains information about the command, an entry for each library, and an entry for each object that was not successfully saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIB</b></dt>
|
||
|
|
<dd>The list contains a library entry for each library requested to be saved
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MBR</b></dt>
|
||
|
|
<dd>The list contains an entry for each object, database file member, and spooled file requested to be saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVLIB.CMDUSRSPC"></a>
|
||
|
|
<h3>Command user space (CMDUSRSPC)</h3>
|
||
|
|
<p>Specifies a user space containing the values for the parameters which have *USRSPC specified for this command. The user space allows up to 32767 list values for each parameter, while the command parameters only allow up to 300 list values. The user space must define the parameters in the format used by the Save Object List (QSRSAVO) API.
|
||
|
|
</p>
|
||
|
|
<p><b>Qualifier 1: User space</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the user space containing the values for the parameters which have *USRSPC specified for this command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 2: Library</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LIBL</u></b></dt>
|
||
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>The current library for the job is used to locate the user space. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the user space is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVLIB.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving a Library on a Tape Device</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(JOE) DEV(TAP01)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves the library named JOE on the tape that is in the tape device named TAP01. The storage occupied by JOE in the system is not freed, because the STG parameter default (*KEEP) was assumed.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Saving on Multiple Volumes</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(QGPL) DEV(OPT01) VOL(ABC DEF GHI)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The general purpose library (QGPL) is saved on the optical volumes in the device named OPT01. The optical volumes used must have the volume names ABC, DEF, and GHI. If the save operation is not finished when volume ABC is full, a message is issued to the operator asking for volume DEF to be placed in the device.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Freeing Storage when Saving Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(CUSTDATA) DEV(TAP01)
|
||
|
|
VOL(CUSTNM CUSTAD) STG(*FREE)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The library named CUSTDATA is saved on volumes CUSTNM and CUSTAD, which are put in the tape device TAP01. The storage occupied by the specified members, modules, programs, service programs, SQL packages, and journal receivers in the CUSTDATA library is freed after it is saved.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Saving on Multiple Devices Serially</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(USRLIB) DEV(TAP01 TAP02 TAP03)
|
||
|
|
VOL(USRA USRB USRC USRD) ENDOPT(*UNLOAD)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The library named USRLIB is saved on four tape volumes on three tape devices. The volume named USRA is put on the device named TAP01, the volume named USRB on the device named TAP02, the volume named USRC on the device named TAP03, and the volume named USRD on the device named TAP01. The volume named USRA is rewound, and must be unloaded by the operator when processing is complete so that the device named TAP01 can be used for the volume named USRD.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Saving on Multiple Devices in Parallel</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(USRLIB) DEV(*MEDDFN) MEDDFN(LIBA/MEDDFNA)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>The library named USRLIB is saved on the devices specified in the media definition named MEDDFNA in library LIBA. For information about creating and using a media definition, see the <b>Backup, Recovery, and Availability</b> topic in the Information Center.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Saving a Library with a Media File Label</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(LIB1) DEV(TAP01) LABEL(MONDAYBACKUP)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command uses the tape device named TAP01 to save the library named LIB1 on tape. The library is saved with a media file label of MONDAYBACKUP. This label must be specified when restoring the library or any of its objects.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 7: Specifying Where the Save Operation Starts</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(*NONSYS) DEV(TAP01 TAP02)
|
||
|
|
STRLIB(MIKESLIB) ASPDEV(*SYSBAS)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all libraries that are located on the system and basic user ASPS, beginning with the library named MIKESLIB on tape devices named TAP01 and TAP02. System libraries and libraries that are normally saved first (QSYS2, QGPL, and QUSRSYS) are not saved.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 8: Saving User Libraries in an Independent ASP Group</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(*ALLUSR) DEV(TAP01) ASPDEV(*CURASPGRP)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all user libraries on the independent ASPs that are in the ASP group for the current thread. It does not save libraries on the system ASP (ASP number 1) or on basic user ASPs (ASP numbers 2-32).
|
||
|
|
</p>
|
||
|
|
<p><b>Example 9: Saving Spooled Files</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVLIB LIB(MYLIB) DEV(TAP01) SPLFDTA(*ALL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves the library named MYLIB, including the spooled file data for any output queues in the library.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVLIB.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF3701</b></dt>
|
||
|
|
<dd>&1 objects saved from &3. &2 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3703</b></dt>
|
||
|
|
<dd>&2 &1 in &3 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3708</b></dt>
|
||
|
|
<dd>Save file &1 in &2 too small.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3709</b></dt>
|
||
|
|
<dd>Tape devices do not support same densities.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3727</b></dt>
|
||
|
|
<dd>Duplicate device &1 specified on device name list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3728</b></dt>
|
||
|
|
<dd>Device &1 specified with other devices.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3730</b></dt>
|
||
|
|
<dd>Not authorized to &2 &1 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3731</b></dt>
|
||
|
|
<dd>Cannot use &2 &1 in library &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3733</b></dt>
|
||
|
|
<dd>&2 &1 in &3 previously damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3735</b></dt>
|
||
|
|
<dd>Storage limit exceeded for user profile &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3738</b></dt>
|
||
|
|
<dd>Device &1 used for save or restore is damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3749</b></dt>
|
||
|
|
<dd>Objects from library &2 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3751</b></dt>
|
||
|
|
<dd>Some libraries not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3767</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3768</b></dt>
|
||
|
|
<dd>Device &1 not valid for command.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF377D</b></dt>
|
||
|
|
<dd>Save ended because of read error on internal system resource.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF377E</b></dt>
|
||
|
|
<dd>Not enough storage for save-while-active request.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF377F</b></dt>
|
||
|
|
<dd>Save-while-active request prevented by pending record changes.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3770</b></dt>
|
||
|
|
<dd>No objects saved or restored for library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3771</b></dt>
|
||
|
|
<dd>&1 objects saved from &3. &2 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3777</b></dt>
|
||
|
|
<dd>&1 libraries saved, &6 partially saved, &2 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF378A</b></dt>
|
||
|
|
<dd>Message queue not available.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF378C</b></dt>
|
||
|
|
<dd>SAVACTMSGQ(*WRKSTN) not valid for batch job.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF378E</b></dt>
|
||
|
|
<dd>Library &1 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3781</b></dt>
|
||
|
|
<dd>Library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3782</b></dt>
|
||
|
|
<dd>File &1 in &2 not a save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3785</b></dt>
|
||
|
|
<dd>Not all subsystems ended.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3789</b></dt>
|
||
|
|
<dd>Only one library allowed with specified parameters.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF379E</b></dt>
|
||
|
|
<dd>Not enough storage available to save library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3793</b></dt>
|
||
|
|
<dd>Machine or ASP storage limit reached.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3794</b></dt>
|
||
|
|
<dd>Save or restore operation ended unsuccessfully.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3797</b></dt>
|
||
|
|
<dd>Objects from library &3 not saved. Save limit exceeded.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF37AB</b></dt>
|
||
|
|
<dd>*NOCMTBDY not allowed with target release.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF37AC</b></dt>
|
||
|
|
<dd>Library not allowed with *NOCMTBDY.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF37B1</b></dt>
|
||
|
|
<dd>SPLFDTA not allowed with target release.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF37B4</b></dt>
|
||
|
|
<dd>User space &1 in &2 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF380B</b></dt>
|
||
|
|
<dd>Save cannot be completed at this time.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3812</b></dt>
|
||
|
|
<dd>Save file &1 in &2 in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3815</b></dt>
|
||
|
|
<dd>Save file &1 in &2 too small for save operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3818</b></dt>
|
||
|
|
<dd>Starting library &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF384E</b></dt>
|
||
|
|
<dd>USEOPTBLK(*YES) not valid for CD-ROM premastering.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3871</b></dt>
|
||
|
|
<dd>No objects saved or restored; &3 objects not included.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF388B</b></dt>
|
||
|
|
<dd>Optical file path name not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3892</b></dt>
|
||
|
|
<dd>&2 &1 in &3 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3894</b></dt>
|
||
|
|
<dd>Cancel reply received for message &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF38A2</b></dt>
|
||
|
|
<dd>ASP device &1 not correct.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF38A3</b></dt>
|
||
|
|
<dd>File &1 in &2 not valid with ASPDEV.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF38A4</b></dt>
|
||
|
|
<dd>ASP device &1 not correct.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF5729</b></dt>
|
||
|
|
<dd>Not able to allocate object &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9809</b></dt>
|
||
|
|
<dd>Library &1 cannot be accessed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9812</b></dt>
|
||
|
|
<dd>File &1 in library &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9814</b></dt>
|
||
|
|
<dd>Device &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9820</b></dt>
|
||
|
|
<dd>Not authorized to use library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9822</b></dt>
|
||
|
|
<dd>Not authorized to file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9825</b></dt>
|
||
|
|
<dd>Not authorized to device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9833</b></dt>
|
||
|
|
<dd>*CURASPGRP or *ASPGRPPRI specified and thread has no ASP group.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPFB8ED</b></dt>
|
||
|
|
<dd>Device description &1 not correct for operation.
|
||
|
|
</dd>
|
||
|
|
<dt><b>OPT1332</b></dt>
|
||
|
|
<dd>Optical volume not found in device &1.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b><u>*STATUS Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF3770</b></dt>
|
||
|
|
<dd>No objects saved or restored for library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3771</b></dt>
|
||
|
|
<dd>&1 objects saved from &3. &2 not saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3871</b></dt>
|
||
|
|
<dd>No objects saved or restored; &3 objects not included.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVLIB.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|