598 lines
24 KiB
HTML
598 lines
24 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 Save Files using BRM (SAVSAVFBRM)</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="SAVSAVFBRM.Top_Of_Page"></a>
|
||
|
|
<h2>Save Save Files using BRM (SAVSAVFBRM)</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="#SAVSAVFBRM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#SAVSAVFBRM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#SAVSAVFBRM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="SAVSAVFBRM"></a>
|
||
|
|
<p>The Save Save Files using BRM (SAVSAVFBRM) command saves save files created during BRMS processing to tape.
|
||
|
|
</p>
|
||
|
|
<p>Various parameters allow you to select which save files that you want to copy to tape. For instance, you can select a range of save file creation dates to include in the save files that you want to copy to tape with further qualification of control group and media class.
|
||
|
|
</p>
|
||
|
|
<p>You can schedule the SAVSAVFBRM command through the system job scheduler, through another job scheduler or on demand.
|
||
|
|
</p>
|
||
|
|
<p>Expired save files that are not waiting to be copied to tape are deleted when the SAVSAVFBRM command processes.
|
||
|
|
</p>
|
||
|
|
<p>Data in a save file created with device *NONE will not be copied to tape unless a device is specified on the <b>Device (DEVICE) </b>parameter when using this command.
|
||
|
|
</p>
|
||
|
|
<p>Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The <b>Device (DEV) </b>parameter is limited on only one device or *MEDCLS special value for serial operations.
|
||
|
|
</li>
|
||
|
|
<li>Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE authority is required to the image catalogs.
|
||
|
|
</li>
|
||
|
|
<li>Execute (*X) authority is required to each directory in the image catalog path name.
|
||
|
|
</li>
|
||
|
|
<li>Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
|
||
|
|
</li>
|
||
|
|
<li>*USE authority is required to the virtual devices using the image catalogs.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions: </b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have authority to the SAVSAVFDTA command to use this command. The SAVSAVFBRM command does not support the transfer of saved file data to TSM (ADSM) media.
|
||
|
|
</li>
|
||
|
|
<li>This command should not be used by control group *EXIT item processing as results will be unpredictable.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="SAVSAVFBRM.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="#SAVSAVFBRM.CTLGRP"><b>CTLGRP</b></a></td>
|
||
|
|
<td valign="top">Control group</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i>, *NONE, *ARCGRP, *BKUGRP, *SYSGRP, *SYSTEM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.LIB"><b>LIB</b></a></td>
|
||
|
|
<td valign="top">Library</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 50 repetitions): <i>Generic name, name</i>, *MEDINF</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.MEDCLS"><b>MEDCLS</b></a></td>
|
||
|
|
<td valign="top">Media class</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, <b><u>*ALL</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#SAVSAVFBRM.PERIOD"><b>PERIOD</b></a></td>
|
||
|
|
<td valign="top">Time period for save files</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="7">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Start time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BEGIN</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: End time and date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*AVAIL</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*END</u></b>, *CURRENT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAVF</u></b><br>Other values (up to 4 repetitions): <i>Name</i>, *MEDCLS</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.MEDPCY"><b>MEDPCY</b></a></td>
|
||
|
|
<td valign="top">Media policy</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*SAVF</u></b>, *SYSPCY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.SEQNBR"><b>SEQNBR</b></a></td>
|
||
|
|
<td valign="top">Sequence number</td>
|
||
|
|
<td valign="top">1-16777215, <b><u>1</u></b>, *END</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.ENDOPT"><b>ENDOPT</b></a></td>
|
||
|
|
<td valign="top">End of tape option</td>
|
||
|
|
<td valign="top"><b><u>*UNLOAD</u></b>, *LEAVE, *REWIND</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.USEOPTBLK"><b>USEOPTBLK</b></a></td>
|
||
|
|
<td valign="top">Use optimum block size</td>
|
||
|
|
<td valign="top"><b><u>*BKUPCY</u></b>, *DEV, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.CLEAR"><b>CLEAR</b></a></td>
|
||
|
|
<td valign="top">Clear</td>
|
||
|
|
<td valign="top">*AFTER, *ALL, *NONE, <b><u>*SAVF</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.COMPACT"><b>COMPACT</b></a></td>
|
||
|
|
<td valign="top">Data compaction</td>
|
||
|
|
<td valign="top"><b><u>*SAVF</u></b>, *DEV, *NO</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#SAVSAVFBRM.ALWADLSAVE"><b>ALWADLSAVE</b></a></td>
|
||
|
|
<td valign="top">Add subsequent saves</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="SAVSAVFBRM.CTLGRP"></a>
|
||
|
|
<h3>Control group (CTLGRP)</h3>
|
||
|
|
<p>Specifies the name of the control group that was processed to create the save files that you want to copy to removable media.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Save files created by any control group that meet the other parameters are copied to removable media.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 50 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No control group is used to copy save files to removable media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-control-group-name</i></b></dt>
|
||
|
|
<dd>Specify a generic control group name. For example, specifying WEEK* would cause all control groups whose names begin with WEEK to be included in the control groups whose save files are copied to removable media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-group-name</i></b></dt>
|
||
|
|
<dd>Specify the control group whose save files are copied to removable media. You can specify up to 50 control group names.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>You can specify an existing control group name, or a name that you want to be associated with the save operation, even if the name is not an existing control group. The control group name is saved with the media information and can be used with the control group name parameter in recovery processing by control group.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.LIB"></a>
|
||
|
|
<h3>Library (LIB)</h3>
|
||
|
|
<p>Specifies the name of the library that is saved in save files that you want to copy to removable media.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All libraries that are saved in save files and meet the other parameter specifications are copied to removable media.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 50 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDINF</b></dt>
|
||
|
|
<dd>You want to copy BRMS media information saved in save files to removable media. The QUSRBRM library contains the BRMS media information.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-library-name</i></b></dt>
|
||
|
|
<dd>Specify a generic library name. For example, specifying APP* would cause all libraries whose names begin with APP to be included in the libraries that are saved in save files to be copied to removable media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library that is saved in save files that you want to copy to removable media. You can specify up to 50 library names.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.MEDCLS"></a>
|
||
|
|
<h3>Media class (MEDCLS)</h3>
|
||
|
|
<p>Specifies the name of the media class associated with the control groups whose save files you want to move to removable media.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Save files with any media class that meet the other parameter specification are copied to removable media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-media-class-name</i></b></dt>
|
||
|
|
<dd>Specify that the media class name is generic. For example, specifying CART* would cause all media classes whose names begin with CART to be included in the media classes associated with save files that are copied to removable media.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>media-class-name</i></b></dt>
|
||
|
|
<dd>Specify the media class associated with save files that you want to copy to removable media.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.PERIOD"></a>
|
||
|
|
<h3>Time period for save files (PERIOD)</h3>
|
||
|
|
<p>Specifies the period of time for which the save files are selected to save to tape.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Start time and date </b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the beginning creation time at which or after save files are included. Any save files created before the specified time and date are not included in the selected save files for copy to removable media.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Beginning time </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any time that is available for the beginning date is included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>begin-time</i></b></dt>
|
||
|
|
<dd>Specify the beginning time for the specified beginning date that indicates which save files are to be included.
|
||
|
|
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes and ss=seconds. Hours, minutes, and seconds must each be exactly 2 digits (using leading zeros if necessary).
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Beginning date </b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the beginning date on which or after which the save files must have been created. Any entries created before the specified date are not included in the copy to tape.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BEGIN</u></b></dt>
|
||
|
|
<dd>Save files from the beginning of the save file media content information are copied to tape.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>Save files with a current date creation date and between the specified beginning and ending times (if specified) are copied to tape.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>begin-date</i></b></dt>
|
||
|
|
<dd>Specify the beginning date. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: End time and date </b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending time before which save files are included. Any save files created after the specified time and date are not included in the items selected for copy to tape.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Ending time </b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any time that is available for the ending date is included.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-time</i></b></dt>
|
||
|
|
<dd>Specify the ending time for the specified ending date that indicates which save files are to be included.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Ending date </b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending date on which or before which the save files must have been created. Any save files created after the specified date are not included in the copy to tape operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*END</u></b></dt>
|
||
|
|
<dd>The save files to the end of the save file media content information are copied to tape.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURRENT</b></dt>
|
||
|
|
<dd>The save files with a current day creation date is the last day for which save files are copied to tape.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-date</i></b></dt>
|
||
|
|
<dd>Specify the ending date. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the name of the device to which you want to copy selected save files.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVF</u></b></dt>
|
||
|
|
<dd>Save files are copied to the device specified when the save files were created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values (up to 4 repetitions)</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*MEDCLS</b></dt>
|
||
|
|
<dd>BRMS determines the media class specified for the save file. Once the media class is determined, a device that supports that media class is selected to copy the save file.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>device-name</i></b></dt>
|
||
|
|
<dd>Specify the device to which you want to copy the selected save files.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.MEDPCY"></a>
|
||
|
|
<h3>Media policy (MEDPCY)</h3>
|
||
|
|
<p>Specifies the name of the media policy that BRMS should use when it selects media to contain the save file data.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVF</u></b></dt>
|
||
|
|
<dd>Media is assigned using the media policy specified when the save files were created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SYSPCY</b></dt>
|
||
|
|
<dd>Media is assigned using the media policy specified in the system policy.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>media-policy</i></b></dt>
|
||
|
|
<dd>Specify the media policy that you want to use for selected save files.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies, when tape is used, the sequence to use for the save operation.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you are saving to a BRMS volume that is expired, BRMS will begin writing information at the beginning of the volume, even though you have specified *END.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If you are saving to a BRMS BRMS will redirect the output to begin at the logical end of the output volume (after the end of the last active file), depending on the output device that you are using. For example, a 3490 device can write to any sequence number whereas a 6525 device can only write to sequence number 1 or *END.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>1</u></b></dt>
|
||
|
|
<dd>The first file is to be sequence number 1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*END</b></dt>
|
||
|
|
<dd>The save operation begins after the sequence number of the last active file on the volume.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>file-sequence-number</i></b></dt>
|
||
|
|
<dd>Specify the sequence number of the file to be used for the save operation. Sequence numbers can range from 1 to 16,777,215.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.ENDOPT"></a>
|
||
|
|
<h3>End of tape option (ENDOPT)</h3>
|
||
|
|
<p>Specifies, when tape is used, what positioning operation is automatically done on the volume after the save operation ends. If more than one volume is included, this parameter applies only to the last volume used; all other volumes are rewound and unloaded when the end of the volume is reached.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If no objects are saved, the volume is not opened and the ENDOPT parameter is ignored.
|
||
|
|
</p>
|
||
|
|
<p>If you specify *LEAVE and the device is a shared device, the device will not be varied off after the save operation. If you specify *LEAVE and the device is not a shared device, the device will be varied off after the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*UNLOAD</u></b></dt>
|
||
|
|
<dd>The volume is automatically rewound and unloaded after the save operation ends.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LEAVE</b></dt>
|
||
|
|
<dd>The volume does not rewind or unload after the operation ends. It remains at the current position on the device.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*REWIND</b></dt>
|
||
|
|
<dd>The volume is rewound, but not unloaded.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.USEOPTBLK"></a>
|
||
|
|
<h3>Use optimum block size (USEOPTBLK)</h3>
|
||
|
|
<p>Specifies whether or not the optimum block size is used for the save operation.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BKUPCY</u></b></dt>
|
||
|
|
<dd>Use the value from the backup policy for the <b>Use optimum block size </b>parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*DEV</b></dt>
|
||
|
|
<dd>Use the value specified on the Work with Devices display for the <b>Use optimum block size </b>parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<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 or the Duplicate Media using BRM (DUPMEDBRM) command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The optimum block size supported by the device is used for Save commands. If the block size 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) and Duplicate Media using BRM (DUPMEDBRM) 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 Data Compression (DTACPR) parameter is ignored.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.CLEAR"></a>
|
||
|
|
<h3>Clear (CLEAR)</h3>
|
||
|
|
<p>Specifies whether uncleared volumes or save files encountered during the save operation are automatically cleared.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVF</u></b></dt>
|
||
|
|
<dd>Uses the value specified when the save file was created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*AFTER</b></dt>
|
||
|
|
<dd>All the uncleared volumes after the initial volume are automatically cleared. If the operation cannot proceed because the first volume is uncleared, an inquiry message is sent to the system operator, allowing him to end the operation or to specify that the currently selected volume be cleared so the operation can continue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All the uncleared volumes or save files encountered during the save operation are automatically cleared. If tapes are used and a sequence number is specified, the volume is cleared and, starting with that sequence number, all volumes following the first volume are cleared.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>None of the uncleared volumes or save files encountered during the save operation are automatically cleared. If the save operation cannot proceed because an uncleared volume is encountered, an inquiry message is sent to the operator, allowing the ending of the save operation, or specifying that the currently selected volume be cleared so the operation can continue.
|
||
|
|
<p>If a save file is not cleared, the inquiry message is sent to the work station message queue for an interactive job, or to the operator for a batch job. All volumes used to perform the save operation should be cleared, or the save file must be empty, before the save command is issued.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.COMPACT"></a>
|
||
|
|
<h3>Data compaction (COMPACT)</h3>
|
||
|
|
<p>Specifies whether data compaction is performed.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAVF</u></b></dt>
|
||
|
|
<dd>Uses the data compaction value specified when the save file was created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DEV</b></dt>
|
||
|
|
<dd>Device data compaction is performed if the data is saved to tape and all devices specified on the <b>Device (DEV)</b> parameter support the compaction feature.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>No data compaction is performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="SAVSAVFBRM.ALWADLSAVE"></a>
|
||
|
|
<h3>Allow subsequent saves (ALWADLSAVE)</h3>
|
||
|
|
<p>Specifies whether you intend to save save files to tape in subsequent save file operations.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>You do not intend to save save files on subsequent save operations. The save files will be deleted from the system when maintenance is run after these save files are saved to tape or when these save files expire.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>You intend to save save files on subsequent save operations. The save files will not be deleted from the system when maintenance is run. If you specify this value, you must run a subsequent SAVSAVFBRM command using ALWADLSAVE(*NO) to enable removal of these save files from the system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVSAVFBRM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Saving Save Files to Removable Media</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
SAVSAVFBRM CTLGRP(BACK*) MEDCLS(QIC1000) BEGIN(*AVAIL '1/1/03')
|
||
|
|
END(*AVAIL *CURRENT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command saves all backup control groups whose name begins with the BACK that created save files with media class QIC1000. The device to which the save files are to be saved is specified in the save file itself and is thus not specified in the command. The save files that are to be included are save files that were created between 1/1/2003 and the current date. Creation time does not matter. Expired save files that are not waiting to be copied to tape are deleted when the command processes.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="SAVSAVFBRM.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>BRM1500</b></dt>
|
||
|
|
<dd>Save file processing is canceled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1502</b></dt>
|
||
|
|
<dd>Save file processing is canceled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1504</b></dt>
|
||
|
|
<dd>Save file processing is canceled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1506</b></dt>
|
||
|
|
<dd>Save file processing is canceled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1520</b></dt>
|
||
|
|
<dd>Operation canceled by user reply.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1646</b></dt>
|
||
|
|
<dd>Save operation canceled.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1917</b></dt>
|
||
|
|
<dd>Feature not installed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1921</b></dt>
|
||
|
|
<dd>Feature not licensed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM1941</b></dt>
|
||
|
|
<dd>Operation canceled because of reply to check of expired media.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM2265</b></dt>
|
||
|
|
<dd>Errors occurred initiating session using device &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM4040</b></dt>
|
||
|
|
<dd>Access denied for user &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>BRM40A2</b></dt>
|
||
|
|
<dd>BRMS product initialization required.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3700</b></dt>
|
||
|
|
<dd>All CPF37xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF3800</b></dt>
|
||
|
|
<dd>All CPF38xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9800</b></dt>
|
||
|
|
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#SAVSAVFBRM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|