192 lines
8.7 KiB
HTML
192 lines
8.7 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 Storage (SAVSTG)</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="SAVSTG.Top_Of_Page"></a>
|
|
<h2>Save Storage (SAVSTG)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>Interactive environments (*INTERACT *IPGM *IREXX *EXEC)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#SAVSTG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SAVSTG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SAVSTG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SAVSTG"></a>
|
|
<p>The Save Storage (SAVSTG) command saves a copy of the licensed internal code and the contents of auxiliary storage (except unused space and temporary objects) to tape. This function is intended for disaster recovery backup. Individual libraries or objects cannot be restored from a save storage tape.
|
|
</p>
|
|
<p>This command issues the PWRDWNSYS (Power Down System) command with OPTION(*IMMED) and RESTART(*YES) specified. While the system is powered down, a dedicated service tool (DST) that saves all system storage is called. At that time, a standard labeled tape volume must be placed in the tape device. Additional volumes are requested as needed. Hardware data compression is used if it is supported by the tape device. After the save system storage function is complete, an initial program load (IPL) takes place.
|
|
</p>
|
|
<p>During the IPL after a save storage operation, a completion message is sent to the system operator message queue. The save history information for the data area QSAVSTG in library QSYS is updated with the date and time when the system storage data was saved. To show the information in this data area, use the Display Object Description (DSPOBJD) command with DETAIL(*FULL).
|
|
</p>
|
|
<p>The restore storage operation is done using the appropriate option on the DST menu. During the IPL, after a restore storage operation, a completion message is sent to the system operator message queue, and the last restore date and time history information in the QSAVSTG data area is updated with the current date and time. In addition, the data portion of the QSAVSTG data area is updated with the date of the save storage tape used in the restore system storage operation.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>Because media errors cause the save operation to start over from the last tape volume, use of this command is recommended for smaller systems only.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have save system (*SAVSYS) special authority to run this command.
|
|
</li>
|
|
<li>The system cannot be running any other jobs; run the End Subsystem (ENDSBS) specifying SBS(*ALL) or run the End System (ENDSYS) command to end all other jobs except the job running the SAVSTG command.
|
|
</li>
|
|
<li>Tapes created using this command that will be used for installation should be initialized with a density that is supported by the current alternate IPL device. If this is not done, the current IPL tape will have to be changed to a tape device that supports the density of the created SAVSTG tapes before installation can begin.
|
|
</li>
|
|
<li>Tapes created using the SAVSTG command should not be used for automatic installation.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SAVSTG.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="#SAVSTG.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Tape device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVSTG.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="#SAVSTG.CLEAR"><b>CLEAR</b></a></td>
|
|
<td valign="top">Clear</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SAVSTG.DEV"></a>
|
|
<h3>Tape device (DEV)</h3>
|
|
<p>Specifies the tape device that is used for the save storage operation.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the tape device to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVSTG.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>
|
|
<dl>
|
|
<dt><b><u>*PERM</u></b></dt>
|
|
<dd>The tape files are protected permanently.
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date when protection for the tape files ends. The date must be specified in the job date format.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVSTG.CLEAR"></a>
|
|
<h3>Clear (CLEAR)</h3>
|
|
<p>Specifies whether uncleared tapes encountered during the save operation are automatically cleared. An uncleared tape is one containing a file with an expiration date later than the date of the save operation, which includes files protected permanently using EXPDATE(*PERM).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter does not control initializing the tapes. The tapes used to perform the save operation should be initialized to a standard label format before the save command is issued. You can use the Initialize Tape (INZTAP) command and specify a value for the NEWVOL parameter to initialize a tape to a standard label format. If a tape volume that is not initialized is encountered during the save operation, an inquiry message is sent and an operator can initialize the tape volume.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>None of the uncleared tapes encountered during the save operation are automatically cleared. If the save operation cannot proceed because an uncleared tape is encountered, an inquiry message is sent to the operator, who is allowed to end the save operation or to specify that the selected tape be cleared so the operation can continue.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All uncleared tapes encountered during the save operation are automatically cleared.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVSTG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Specifying Expiration Date</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVSTG DEV(TAP01) EXPDATE(122290) CLEAR(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command saves the system storage on the tape put on the TAP01 tape drive. Each uncleared tape is cleared automatically. The tape files written are protected and cannot be overwritten until December 22, 1990.
|
|
</p>
|
|
<p><b>Example 2: Saving System Storage</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVSTG DEV(TAP02)
|
|
</pre>
|
|
</p>
|
|
<p>The system storage is saved on tape drive TAP02. CLEAR was not specified, so uncleared tapes encountered during the save operation cause an inquiry message to be sent to the operator, who either ends the save operation or specifies that the currently selected tape be cleared so the operation can continue. Because EXPDATE also was not specified, the tape files being written are protected permanently.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVSTG.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>CPF376A</b></dt>
|
|
<dd>System must not be in manual mode.
|
|
</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>CPF3785</b></dt>
|
|
<dd>Not all subsystems ended.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVSTG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|