746 lines
28 KiB
HTML
746 lines
28 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 Configuration (SAVCFG)</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="SAVCFG.Top_Of_Page"></a>
|
||
|
|
<h2>Save Configuration (SAVCFG)</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="#SAVCFG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVCFG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVCFG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVCFG"></a>
|
||
|
|
<p>The Save Configuration (SAVCFG) command saves all configuration and system resource management (SRM) objects without requiring a system in a restricted state. The information saved includes the following:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Line descriptions
|
||
|
|
</li>
|
||
|
|
<li>Controller descriptions
|
||
|
|
</li>
|
||
|
|
<li>Device descriptions
|
||
|
|
</li>
|
||
|
|
<li>Mode descriptions
|
||
|
|
</li>
|
||
|
|
<li>Class-of-service descriptions
|
||
|
|
</li>
|
||
|
|
<li>Network interface descriptions
|
||
|
|
</li>
|
||
|
|
<li>Network server descriptions
|
||
|
|
</li>
|
||
|
|
<li>NetBIOS descriptions
|
||
|
|
</li>
|
||
|
|
<li>Connection lists
|
||
|
|
</li>
|
||
|
|
<li>Configuration lists
|
||
|
|
</li>
|
||
|
|
<li>Hardware resource data
|
||
|
|
</li>
|
||
|
|
<li>Token-ring adaptor data
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Information saved can be restored with the Restore Configuration (RSTCFG) command.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>You must have save system (*SAVSYS) special authority to run this command.
|
||
|
|
</li>
|
||
|
|
<li>System resource management (SRM) objects are not saved if a Work with Hardware Products (WRKHDWPRD) job is running at the same time.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVCFG.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="#SAVCFG.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Single values: *SAVF<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVCFG.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</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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" rowspan="3"><a href="#SAVCFG.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"><a href="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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="#SAVCFG.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>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVCFG.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>
|
||
|
|
<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><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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.PRECHK"></a>
|
||
|
|
<h3>Object pre-check (PRECHK)</h3>
|
||
|
|
<p>Specifies whether the save configuration operation ends if any of the objects satisfy the following conditions:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The objects were previously found to be damaged.
|
||
|
|
</li>
|
||
|
|
<li>The objects are locked by another job.
|
||
|
|
</li>
|
||
|
|
<li>The user does not have authority to save the objects.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The save operation continues, saving only configuration and system resource management (SRM) objects that can be saved.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The save operation ends before any data is written to the media if any configuration objects or system resource manager objects cannot be saved.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVCFG.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="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVCFG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving Objects</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVCFG DEV(TAP01) CLEAR(*ALL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves system resource management objects (hardware resource data and token-ring adaptor data) and all configuration objects (including all line, controller, device, mode, class-of-service, and network descriptions, configuration lists, and connection lists). They are saved on the TAP01 tape drive. CLEAR(*ALL) automatically clears all uncleared tapes when they are encountered.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Saving Objects to a Specific Tape</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVCFG DEV(TAP01) VOL(ABC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves the SRM and configuration objects on the TAP01 tape drive, starting on the tape volume labeled ABC. If the save operation exceeds the storage capacity of one tape, a message requesting that another volume be put on the TAP01 tape drive is issued.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVCFG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2206</b></dt>
|
||
|
|
<dd>User needs authority to do requested function on object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF222E</b></dt>
|
||
|
|
<dd>&1 special authority is required.
|
||
|
|
</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>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>CPF3737</b></dt>
|
||
|
|
<dd>Save and restore data area &1 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF376D</b></dt>
|
||
|
|
<dd>Not all configuration objects saved to save file &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF376E</b></dt>
|
||
|
|
<dd>Not all configuration objects 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>CPF3782</b></dt>
|
||
|
|
<dd>File &1 in &2 not a save file.
|
||
|
|
</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>CPF3812</b></dt>
|
||
|
|
<dd>Save file &1 in &2 in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF384E</b></dt>
|
||
|
|
<dd>USEOPTBLK(*YES) not valid for CD-ROM premastering.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF388B</b></dt>
|
||
|
|
<dd>Optical file path name not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3894</b></dt>
|
||
|
|
<dd>Cancel reply received for message &1.
|
||
|
|
</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>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9847</b></dt>
|
||
|
|
<dd>Error occurred while closing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9850</b></dt>
|
||
|
|
<dd>Override of printer file &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9851</b></dt>
|
||
|
|
<dd>Overflow value for file &1 in &2 too small.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9860</b></dt>
|
||
|
|
<dd>Error occurred during output file processing.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVCFG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|