3500 lines
99 KiB
HTML
3500 lines
99 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">
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
|
<title>Restore Object List (QSRRSTO) API</title>
|
|
<!-- Begin Header Records =========================================== -->
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<!-- Change history: -->
|
|
<!-- 031105 DRH v5r4 XPF D99654 New API - Restore Spool -->
|
|
<!-- End Header Records -->
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body>
|
|
<a name="Top_Of_Page"></a>
|
|
<!-- Java sync-link-->
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
|
</script>
|
|
|
|
<h2><img src="delta.gif" alt="Start of change">Restore Object List (QSRRSTO) API</h2>
|
|
|
|
<div class="box" style="width: 80%;">
|
|
<br>
|
|
Required Parameter Group:<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
<table width="100%">
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="50%">Qualified user space name</td>
|
|
<td align="left" valign="top" width="20%">Input</td>
|
|
<td align="left" valign="top" width="20%">Char(20)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Error Code</td>
|
|
<td align="left" valign="top">I/O</td>
|
|
<td align="left" valign="top">Char(*)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
Default Public Authority: *USE<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
Threadsafe: No<br>
|
|
<!-- iddvc RMBR -->
|
|
<br>
|
|
</div>
|
|
|
|
<p>The Restore Object List (QSRRSTO) API restores
|
|
a list of objects or spooled files
|
|
specified by the user. The list of objects,
|
|
as well as any additional information needed
|
|
for the restore operation, is specified by the
|
|
user in a user space.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Authorities and Locks</h3>
|
|
|
|
<dl>
|
|
<dt><strong><em>User Space</em></strong></dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>User Space Authority</em></dt>
|
|
|
|
<dd>*USE</dd>
|
|
|
|
<dt><em>User Space Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>User Space Lock</em></dt>
|
|
|
|
<dd>*SHRNUP</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt><strong><em>Objects to Be Restored</em></strong><br>
|
|
The following authorities are needed if the user does not have
|
|
save system (*SAVSYS) special authority.
|
|
To allow any object differences,
|
|
you need *ALLOBJ special authority.</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Object Authority</em></dt>
|
|
|
|
<dd>*OBJEXIST</dd>
|
|
|
|
<dt><em>Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE, *READ, and *ADD</dd>
|
|
|
|
<dt><em>Object Lock</em></dt>
|
|
|
|
<dd>*EXCL</dd>
|
|
|
|
<dt><em>Library Lock</em></dt>
|
|
|
|
<dd>*SHRUPD</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt><strong><em>Spooled Files to Be Restored</em></strong><br>
|
|
If the user has save system (*SAVSYS)
|
|
special authority, the following authorities are not needed.</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output Queue Authority</em></dt>
|
|
|
|
<dd>*OBJEXIST</dd>
|
|
|
|
<dt><em>Output Queue Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Output Queue Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<p><strong>Note:</strong> Additional authority may be needed to
|
|
change spooled file attributes.
|
|
See <a href="#HDRNEWATTRS">New Attributes Format</a>
|
|
for more information.</p>
|
|
|
|
<dl>
|
|
<dt><strong><em>Devices</em></strong></dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Save File Authority</em></dt>
|
|
|
|
<dd>*USE</dd>
|
|
|
|
<dt><em>Save File Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Save File Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
|
|
<dt><em>Tape or Optical<!--, or Diskette--> Authority</em></dt>
|
|
|
|
<dd>*USE</dd>
|
|
|
|
<dt><em>Tape or Optical<!--, or Diskette--> Lock</em></dt>
|
|
|
|
<dd>*EXCL</dd>
|
|
|
|
<dt><em>Media Library Device Lock</em></dt>
|
|
|
|
<dd>*SHRUPD</dd>
|
|
|
|
<dt><em>Media Definition Authority</em></dt>
|
|
|
|
<dd>*USE</dd>
|
|
|
|
<dt><em>Media Definition Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
|
|
<dt><em>Media Definition Lock</em></dt>
|
|
|
|
<dd>*EXCLRD</dd>
|
|
|
|
<dt><em>Auxiliary
|
|
Storage Pool (ASP)</em></dt>
|
|
|
|
<dd>*USE
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt><strong><em>Output Files</em></strong></dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output File Lock</em></dt>
|
|
|
|
<dd>*SHRRD</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>If the output file does not exist:</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output File Library Authority</em></dt>
|
|
|
|
<dd>*READ and *ADD</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>If the output file exists and a new member will be added:</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output File Authority</em></dt>
|
|
|
|
<dd>*OBJMGT, *OBJOPR, and *ADD</dd>
|
|
|
|
<dt><em>Output File Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE and *ADD</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>If the output file exists and an existing member will be appended:</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output File Authority</em></dt>
|
|
|
|
<dd>*OBJMGT and *ADD</dd>
|
|
|
|
<dt><em>Output File Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>If the output file exists and an existing member will be replaced:</dt>
|
|
|
|
<dd>
|
|
<dl>
|
|
<dt><em>Output File Authority</em></dt>
|
|
|
|
<dd>*OBJMGT, *OBJOPR, *ADD, and *DLT</dd>
|
|
|
|
<dt><em>Output File Library Authority</em></dt>
|
|
|
|
<dd>*EXECUTE</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Required Parameter Group</h3>
|
|
|
|
<dl>
|
|
<dt><strong>Qualified user space name</strong></dt>
|
|
|
|
<dd>INPUT; CHAR(20)
|
|
|
|
<p>The user space that is to hold all the information for the restore operation.
|
|
The first 10 characters contain the user space name. The second 10 characters
|
|
contain the name of the library where the user space is located. See <a href=
|
|
"#HDRUSRSPC">User space format</a> for the format of the information in the
|
|
user space.</p>
|
|
|
|
<p>You can use the following special values for the library name. It should be
|
|
noted, however, that the library name that is actually used is not passed back
|
|
to the user. Care should be taken when using these special values to avoid
|
|
unexpected results.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
user space. If no library is specified as the current library for the job, the
|
|
QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list is used to locate the user
|
|
space.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)
|
|
|
|
<p>The structure in which to return error information. For the format of the
|
|
structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRUSRSPC">User Space Format</a></h3>
|
|
|
|
<p>The following defines the format for the information in the user space. For
|
|
detailed descriptions of the fields in the user space format, see <a href=
|
|
"#HDRUSFDS">Field Descriptions</a>.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number of variable length
|
|
records</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> These fields
|
|
repeat for each variable length record.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of variable length record</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Key</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of data</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Data</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>If you specify a data length that is longer than the key field's defined
|
|
data length, the data is truncated at the right. No error message is
|
|
returned.</p>
|
|
|
|
<p>If you specify a data length that is shorter than the key field's defined
|
|
data length, an error message is returned for binary fields. If the field is a
|
|
character field, the data is padded with blanks.</p>
|
|
|
|
<p><strong>Note:</strong> This does not apply to keys that allow a list of
|
|
values to be specified. In these cases, the amount of data read is based on the
|
|
specified number of entries in the list.</p>
|
|
|
|
<p>If keys are duplicated in the user space, only the last value for a given
|
|
key is used for the restore operation.</p>
|
|
|
|
<p>It is recommended, but not required, to align each variable length record
|
|
on a 4-byte boundary. That is, you should make the length of each variable
|
|
length record a multiple of 4, even if the data length is not a multiple
|
|
of 4.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRUSFDS">Field Descriptions</a></h3>
|
|
|
|
<strong>Data.</strong> The data used to specify the value for the given key.
|
|
|
|
<p><strong>Key.</strong> The parameter of the Restore Object (RSTOBJ) command to
|
|
specify. See <a href="#HDRKEYFLD">Valid Keys</a> for the list of valid
|
|
keys.</p>
|
|
|
|
<p><strong>Length of data.</strong> The length of the data used to specify the
|
|
value for the given parameter.</p>
|
|
|
|
<p><strong>Length of variable length record.</strong> The length of the
|
|
variable length record.</p>
|
|
|
|
<p><strong>Number of variable length records.</strong> The number of variable
|
|
length records that are passed in the user space.
|
|
The valid range is from 2 through 27.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRKEYFLD">Valid Keys</a></h3>
|
|
|
|
The following table lists the valid keys for the key field area of the variable
|
|
length record. For detailed descriptions of the keys, see <a href=
|
|
"#HDRSOLDESC">Field Descriptions</a>.
|
|
|
|
<p>Some messages for this API refer to parameters and values of the Restore Object
|
|
(RSTOBJ) command. This table can also be used to locate the key names that
|
|
correspond to the RSTOBJ command parameters. The field descriptions contain, in
|
|
addition to detailed descriptions, the corresponding parameter values.</p>
|
|
|
|
<p>The library key and the device key are required keys. The other keys are
|
|
optional.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom">Key</th>
|
|
<th align="left" valign="bottom">Type</th>
|
|
<th align="left" valign="bottom">Field</th>
|
|
<th align="left" valign="bottom">RSTOBJ Command Parameter</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">1</td>
|
|
<td align="left" valign="top" width="20%">CHAR(*)</td>
|
|
<td align="left" valign="top" width="35%">Object information</td>
|
|
<td align="left" valign="top" width="35%">OBJ, OBJTYPE</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Saved library</td>
|
|
<td align="left" valign="top">SAVLIB</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Device</td>
|
|
<td align="left" valign="top">DEV</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Save file</td>
|
|
<td align="left" valign="top">SAVF</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Volume identifier</td>
|
|
<td align="left" valign="top">VOL</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">7</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Sequence number</td>
|
|
<td align="left" valign="top">SEQNBR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Label</td>
|
|
<td align="left" valign="top">LABEL</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">End of media option</td>
|
|
<td align="left" valign="top">ENDOPT</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">17</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">File member</td>
|
|
<td align="left" valign="top">FILEMBR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">23</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Output</td>
|
|
<td align="left" valign="top">OUTPUT</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Qualified output file</td>
|
|
<td align="left" valign="top">OUTFILE</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">25</td>
|
|
<td align="left" valign="top">CHAR(11)</td>
|
|
<td align="left" valign="top">Output member</td>
|
|
<td align="left" valign="top">OUTMBR</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">26</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Type of output information</td>
|
|
<td align="left" valign="top">INFTYPE</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">27</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Optical file</td>
|
|
<td align="left" valign="top">OPTFILE</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">29</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Omit libraries</td>
|
|
<td align="left" valign="top">OMITLIB</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Omit object information</td>
|
|
<td align="left" valign="top">OMITOBJ</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">31</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Media definition</td>
|
|
<td align="left" valign="top">MEDDFN</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">35</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Spooled file data</td>
|
|
<td align="left" valign="top">SPLFDTA</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">36</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Option</td>
|
|
<td align="left" valign="top">OPTION</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">37</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Database member option</td>
|
|
<td align="left" valign="top">MBROPT</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">38</td>
|
|
<td align="left" valign="top">CHAR(7)</td>
|
|
<td align="left" valign="top">Save date</td>
|
|
<td align="left" valign="top">SAVDATE</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">39</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">Save time</td>
|
|
<td align="left" valign="top">SAVTIME</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Allow object differences</td>
|
|
<td align="left" valign="top">ALWOBJDIF</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">41</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Force object conversion</td>
|
|
<td align="left" valign="top">FRCOBJCVN</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">42</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Restore to library</td>
|
|
<td align="left" valign="top">RSTLIB</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">43</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Restore to ASP device</td>
|
|
<td align="left" valign="top">RSTASPDEV</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Restore to ASP number</td>
|
|
<td align="left" valign="top">RSTASP</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSOLDESC">Field Descriptions</a></h3>
|
|
|
|
<p>The values shown in parentheses are the corresponding values for the RSTOBJ
|
|
command parameters.</p>
|
|
|
|
<p><strong>Allow object differences.</strong> Whether differences are allowed
|
|
between the saved objects and the restored objects.
|
|
The default is a single value of 0. For the format of this key,
|
|
see <a href="#HDRALWOBJDIF">Allow Object Differences Key Format</a>.</p>
|
|
|
|
<p><strong>Database member option.</strong> Which members are restored
|
|
for database files that exist on the system.
|
|
The default is 4. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">All the members in the saved file are
|
|
restored. (*ALL)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">Only the members in the saved file that do
|
|
not exist in the current version of the file
|
|
on the system are restored. (*NEW)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">Only the members in the saved file that do
|
|
exist in the current version of the file
|
|
on the system are restored. (*OLD)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>4</em></td>
|
|
<td align="left" valign="top">The saved members are restored if the list
|
|
of the members where they exist match, member
|
|
for member, the lists of the current system
|
|
version. (*MATCH)</td>
|
|
</tr>
|
|
|
|
</table>
|
|
|
|
<p><strong>Device.</strong> The names of the devices used for the restore
|
|
operation. The device must already be known on the system by a device
|
|
description. For the format of this key, see <a href="#HDRDEVKEY">Device Key
|
|
Format</a>.</p>
|
|
|
|
<p><strong>End of media option.</strong> The operation that is performed
|
|
automatically on the tape or optical volume after the restore operation ends. If
|
|
more than one volume is used, this key applies only to the last volume used;
|
|
all other volumes are unloaded when the end of the volume is reached. The
|
|
default is 0.</p>
|
|
|
|
<p><strong>Note:</strong> This parameter is valid only if a tape or optical
|
|
device name is specified. For optical devices, 2 is the only value supported; 0
|
|
and 1 are ignored.</p>
|
|
|
|
<p>The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The tape is automatically rewound, but not
|
|
unloaded, after the operation ends. (*REWIND)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The tape does not rewind or unload after the
|
|
operation ends. It remains at the current position on the tape drive.
|
|
(*LEAVE)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The tape is automatically rewound and unloaded
|
|
after the operation ends. Some optical devices eject the volume after the
|
|
operation ends. (*UNLOAD)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>File member.</strong> A list of the database files and their members
|
|
that are to be restored. Each database file specified here must also be specified
|
|
in the list of objects to be restored. If this key is not specified, the default
|
|
of *ALL will be used for both the file name and the member name. For the format
|
|
of this key, see <a href="#HDRFILMKEY">File Member Key Format</a>.</p>
|
|
|
|
<p><strong>Force object conversion.</strong> Whether to convert user objects
|
|
to the format required for use in the current
|
|
version of the operating system when the
|
|
objects are restored. The default is 2 (*SYSVAL). For the format
|
|
of this key, see <a href="#HDRFRCKEY">Force Object Conversion Key Format</a>.</p>
|
|
|
|
<p><strong>Notes:</strong></p>
|
|
|
|
<ol type="a">
|
|
<li>This key applies only to user objects of the *MODULE, *PGM, *SRVPGM,
|
|
and *SQLPKG object types.</li>
|
|
<li>An object must have creation data (either observable or unobservable)
|
|
to be converted.</li>
|
|
<li>If an object needs to be converted, but is not
|
|
converted during the restore operation, the object is automatically converted
|
|
the first time it is used.</li>
|
|
</ol>
|
|
|
|
<p><strong>Label.</strong> The name that identifies the data file on the tape.
|
|
Although the label key is defined as CHAR(*), the maximum length
|
|
of a label is currently 17. If the length of data field is specified as more
|
|
than 17, the label is truncated such that only the first 17 characters are
|
|
used. The default is *SAVLIB.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAVLIB</em></td>
|
|
<td align="left" valign="top">The file label is the
|
|
name of the library specified for the saved library key.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>Data file identifier</em></td>
|
|
<td align="left" valign="top">The data file identifier of the data file used.
|
|
This option is valid only for a single-library restore operation.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Media definition.</strong> The name and library of the media
|
|
definition that identifies the devices and media used to contain the restored
|
|
data. For information about creating and using a media definition, see the <a
|
|
href="../books/sc415304.pdf" target="_blank">Backup and Recovery</a><img
|
|
src="wbpdf.gif" alt="Link to PDF"> book and the <a href="qsrcrtmd.htm">Create
|
|
Media Definition</a> (QSRCRTMD, QsrCreateMediaDefinition) API. The first 10
|
|
characters contain the media definition name; the second 10 characters contain
|
|
the library in which the media definition is located.</p>
|
|
|
|
<p>You can use these special values for the library name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
media definition. If no library is specified as the current library for the
|
|
job, the QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object information.</strong> A list of the name and type of the
|
|
objects to be restored. If *ALL is specified for the object name and object type,
|
|
the list cannot contain other entries. The default for both the object name and
|
|
the object type is *ALL. For the format of this key, see <a href=
|
|
"#HDROBJKEY">Object Information Key Format</a>.</p>
|
|
|
|
<p><strong>Omit libraries.</strong> A list of the libraries to be omitted from
|
|
the restore operation. The default is *NONE. For the format of this key, see <a
|
|
href="#HDROLIBKEY">Omit Library Key Format</a>.</p>
|
|
|
|
<p><strong>Omit object information.</strong> A list of the name and type of the
|
|
objects and library to be omitted from the restore operation. If *ALL is specified
|
|
for the object name and object type, the list cannot contain other entries. The
|
|
default for both the object name and the object type is *ALL. For the format of
|
|
this key, see <a href="#HDROBJOMIT">Omit Object Information Key Format</a>.</p>
|
|
|
|
<p><strong>Optical file.</strong> The name that identifies the file on the
|
|
optical volume. Although the optical file is defined as CHAR(*), the maximum
|
|
length of an optical file name is currently 256 characters. If the length of
|
|
data field is specified as more than 256 characters, the name is truncated such
|
|
that only the first 256 characters are used. The default is '*'. The possible
|
|
values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>'*'</em></td>
|
|
<td align="left" valign="top">The system generates an optical file name in the
|
|
root directory of the optical volume.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>'Optical-directory-path-name/*'</em></td>
|
|
<td align="left" valign="top">The system generates an optical file name in the
|
|
specified directory of the optical volume.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Optical file path name</em></td>
|
|
<td align="left" valign="top">The path name of the optical file that is used
|
|
for the restore operation, beginning with the root directory of the volume.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Option.</strong> Which objects are restored.
|
|
The default is 1. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">All the objects in the saved library are
|
|
restored. (*ALL)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">Only the objects in the saved library that do
|
|
not exist in the current version of the library
|
|
on the system are restored. (*NEW)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">Only the objects in the saved library that do
|
|
exist in the current version of the library
|
|
on the system are restored. (*OLD)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>4</em></td>
|
|
<td align="left" valign="top">Only the objects in the saved library that do
|
|
exist in the current version of the library
|
|
on the system with their storage freed are restored. (*FREE)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Output.</strong> Whether a list of information about the restored
|
|
objects is created. The default is 0. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">No output listing is created. (*NONE)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The output is printed with the job's spooled
|
|
output. (*PRINT)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The output is directed to the database file
|
|
specified with the output file key. (*OUTFILE)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Output member.</strong> The name of the database file member used to
|
|
save the object information. This field also determines whether to replace or
|
|
add the data if the member already exists. The defaults are *FIRST for the
|
|
output member name field and 0 for the option field. For the format of this
|
|
key, see <a href="#HDROUTPKEY">Output Member Key Format</a>.</p>
|
|
|
|
<p><strong>Qualified output file.</strong> The qualified name of the database
|
|
file to which the information about the objects is directed. This key is
|
|
required only if the output key is set to 2. The first 10 characters contain
|
|
the output file name; the second 10 characters contain the output file library.
|
|
The possible values for output file library are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
output file. If no library is specified as the current library for the job, the
|
|
QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list is used to locate the output
|
|
file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>Library name</em></td>
|
|
<td align="left" valign="top">The name of the library where the output file is
|
|
located.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Restore to ASP device.</strong> The name of the
|
|
auxiliary storage pool (ASP) device to which objects are restored.
|
|
The default is *SAVASPDEV. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAVASPDEV</em></td>
|
|
<td align="left" valign="top">The data is restored to the independent ASP
|
|
from which it was saved.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>ASP device name</em></td>
|
|
<td align="left" valign="top">The name of the independent ASP where the
|
|
data will be restored.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Restore to ASP number.</strong> The number of the
|
|
auxiliary storage pool (ASP) to which objects are restored.
|
|
The default is 0. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The data is restored to the ASP
|
|
from which it was saved. (*SAVASP)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>1-32</em></td>
|
|
<td align="left" valign="top">The number of the ASP where the
|
|
data will be restored.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Restore to library.</strong> The name of the library
|
|
to which objects are restored.
|
|
The default is *SAVLIB. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAVLIB</em></td>
|
|
<td align="left" valign="top">The data is restored to library
|
|
from which it was saved.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>Library name</em></td>
|
|
<td align="left" valign="top">The name of the library where the
|
|
data will be restored.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Save date.</strong> The date the objects were saved. If the most
|
|
recently saved version is the one being restored, or if multiple saved versions
|
|
reside on the media, specify the date that identifies which version of the
|
|
objects to restore. If this key is not specified, the restored version of the
|
|
objects is the first version found. The possible value is:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>date</em></td>
|
|
<td align="left" valign="top">The date the objects were saved, in the format
|
|
CYYMMDD:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
|
and 1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Save file.</strong> The name and library of the save file that
|
|
contains the saved data. The first 10 characters contain the save file
|
|
name; the second 10 characters contain the library where the save file is
|
|
located.</p>
|
|
|
|
<p>You can use these special values for the library name:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
save file. If no library is specified as the current library for the job, the
|
|
QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Save time.</strong> The time the objects were saved. If this key is
|
|
not specified, the version of the objects to be restored is the first version
|
|
on the volume.</p>
|
|
|
|
<p><strong>Note:</strong></p>
|
|
|
|
<ol>
|
|
<li>This key is valid only if the save date key is specified.</li>
|
|
|
|
<li>This key is ignored when the sequence number key is specified.</li>
|
|
</ol>
|
|
|
|
<p>The possible value is:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>time</em></td>
|
|
<td align="left" valign="top">The time the objects were saved in the format
|
|
HHMMSS:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Saved library.</strong> A list of libraries that contain the saved
|
|
objects. If more than one library is specified, *ALL must be the only object
|
|
name specified (object information key) and the device cannot be *SAVF. For the
|
|
format of this key, see <a href="#HDRLIBKEY">Saved Library Key Format</a>.</p>
|
|
|
|
<p><strong>Sequence number.</strong> The sequence number to use for the restore
|
|
operation when tape is used. The default is -1. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>-1</em></td>
|
|
<td align="left" valign="top">The restore operation searches the tape volume
|
|
for the file to be restored. (*SEARCH)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1-16777215</em></td>
|
|
<td align="left" valign="top">The sequence number of the file to be used for
|
|
the restore operation.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Spooled file data.</strong> A description of spooled file data to be
|
|
restored. The default is new spooled file data;
|
|
for each output queue that is restored,
|
|
spooled file data that was saved with the output queue is restored,
|
|
if it does not already exist on the system.
|
|
For the format of this key, see <a href="#HDRSPLFKEY">Spooled File
|
|
Data Key Format</a>.</p>
|
|
|
|
<p><strong>Type of output information.</strong> The type of information that is
|
|
printed or directed to the output database file. The default is 0. The possible
|
|
values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The list contains an entry for each object
|
|
requested to be restored. (*OBJ)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The list contains an entry for each object,
|
|
database file member, and spooled file requested to be restored. (*MBR)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Volume identifier.</strong> The volume identifiers of the tape
|
|
volumes<!--, diskette volumes,--> or optical volumes from which the object data is to be
|
|
restored. The volume identifiers must be entered in the order in which the data
|
|
was saved. The default is *MOUNTED. For the format of this field, see <a href=
|
|
"#HDRVOLKEY">Volume Identifier Key Format</a>.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRALWOBJDIF">Allow Object Differences Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> This field
|
|
repeats for each allow object difference value.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Allow object difference</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Allow object difference.</strong> Whether differences are allowed
|
|
between the saved object and the restored object. The differences include:</p>
|
|
|
|
<ul>
|
|
<li>Authorization list: The saved object had an authorization list,
|
|
and either the object exists on the system but does not have the
|
|
same authorization list, or the object does not exist and it is
|
|
being restored to a different system than the save system.
|
|
<p><strong>Note:</strong> This key has no effect when the saved object
|
|
did not have an authorization list. If the object exists, it is restored
|
|
with the authorization list of the existing object. If it does not exist,
|
|
it is restored with no authorization list.</p>
|
|
</li>
|
|
<li>File level id: The creation date and time
|
|
of the database file on the system does no
|
|
match the creation date and time of the file
|
|
that was saved.</li>
|
|
<li>Member level id: The creation date and time
|
|
of the database file member on the system
|
|
does not match the creation date and time
|
|
of the member that was saved.</li>
|
|
<li>Ownership: The owner of an object on the
|
|
system is different than the owner of an
|
|
object from the save operation.</li>
|
|
<li>Primary group: The primary group of an object
|
|
on the system is different than the primary
|
|
group of an object from the save operation.</li>
|
|
</ul>
|
|
|
|
<p><strong>Note:</strong> To specify any value other than 0, you need
|
|
all object (*ALLOBJ) special authority.</p>
|
|
|
|
<p>The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">No differences are allowed between the saved
|
|
object and the restored object. If 0 is specified for the allow object
|
|
difference field, 1 must be specified for the number in array field.
|
|
(*NONE)
|
|
<p>If an object already exists on the system with a different
|
|
file level id, member level id, owner, or primary group
|
|
than the saved object, the object is not restored.</p>
|
|
<p>If the saved object had an authorization list and the object
|
|
exists on the system but does not have the same authorization list,
|
|
the object is not restored.</p>
|
|
<p>If the saved object had an authorization list and the object
|
|
does not exist and it is being restored to a different system than
|
|
the save system, the object is restored, but it is not linked to the
|
|
authorization list, and the public authority is set to *EXCLUDE.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">All differences are allowed between the saved
|
|
object and the restored object. If 1 is specified for the allow object
|
|
difference field, 1 must be specified for the number in array field. (*ALL)
|
|
<p>If an object already exists on the system with a different
|
|
owner or primary group than the saved object,
|
|
the object is restored with the existing values.</p>
|
|
<p>If the saved object had an authorization list and the object
|
|
exists on the system but does not have the same authorization list,
|
|
the object is restored with the authorization list of the existing object.</p>
|
|
<p>If the saved object had an authorization list and the object
|
|
does not exist and it is being restored to a different system than
|
|
the save system, the object is restored and it is linked to the
|
|
authorization list. If the authorization list does not exist,
|
|
the public authority of the object is set to *EXCLUDE.</p>
|
|
<p>If a database file already exists on the system with a different
|
|
file level id than the saved object, the existing file is renamed
|
|
and the saved version of the file is restored</p>
|
|
<p>If a database file already exists on the system with a different
|
|
member level id than the saved object, the existing member is renamed
|
|
and the saved version of the member is restored</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">Authorization list differences are allowed.
|
|
(*AUTL)
|
|
<p>If the saved object had an authorization list and the object
|
|
exists on the system but does not have the same authorization list,
|
|
the object is restored with the authorization list of the existing object.</p>
|
|
<p>If the saved object had an authorization list and the object
|
|
does not exist and it is being restored to a different system than
|
|
the save system, the object is restored and it is linked to the
|
|
authorization list. If the authorization list does not exist,
|
|
the public authority of the object is set to *EXCLUDE.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">Ownership differences are allowed. (*OWNER)
|
|
<p>If an object already exists on the system with a different
|
|
owner than the saved object,
|
|
the object is restored with the existing value.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>4</em></td>
|
|
<td align="left" valign="top">Primary group differences are allowed. (*PGP)
|
|
<p>If an object already exists on the system with a different
|
|
primary group than the saved object,
|
|
the object is restored with the existing value.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>5</em></td>
|
|
<td align="left" valign="top">File level id and member level id
|
|
differences are allowed. (*FILELVL)
|
|
<p>If a physical file already exists on the system with a different
|
|
file level id or member level id than the saved object,
|
|
but it has the same format level id as the saved object,
|
|
the data is restored to the existing file.</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of allow object difference
|
|
values. The possible values are 1 through 4.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRDEVKEY">Device Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> This field
|
|
repeats for each device name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Device name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRMORFDS">Field Descriptions</a></h3>
|
|
|
|
<p><strong>Device name.</strong> The name of the device used for the restore
|
|
operation. The possible values for each element of the array are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAVF</em></td>
|
|
<td align="left" valign="top">The restore operation is done using the save file
|
|
specified by the save file key. If specified, it must be the only element in
|
|
the array.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*MEDDFN</em></td>
|
|
<td align="left" valign="top">The restore operation is done by using the devices
|
|
and media that are identified in the media definition, which is specified by
|
|
the media definition key. If specified, it must be the only element in the
|
|
array.</td>
|
|
</tr>
|
|
|
|
<!-- <tr>
|
|
<td align="left" valign="top"><em>Diskette device name</em></td>
|
|
<td align="left" valign="top">The name of the diskette device used for the restore
|
|
operation. If specified, it must be the only element in the array.</td>
|
|
</tr> -->
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Media library device name</em></td>
|
|
<td align="left" valign="top">The name of the media library device used for the
|
|
restore operation. If specified, it must be the only element in the array.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Optical device name</em></td>
|
|
<td align="left" valign="top">The name of the optical device used for the restore
|
|
operation. If specified, it must be the only element in the array.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Tape device name</em></td>
|
|
<td align="left" valign="top">The name of the tape device used for the restore
|
|
operation. A maximum of four tape devices may be used. They must be specified
|
|
in the order in which they should be used.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of devices to be used during
|
|
the restore operation. The possible values are 1 through 4.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRFILMKEY">File Member Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> These fields
|
|
repeat for each file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">File name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top">Reserved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Number of members</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> This field
|
|
repeats for each member associated with the given file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Member</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>File name.</strong> The name of the file being restored. The possible
|
|
values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">The list of member names that follow this value
|
|
applies to all files indicated in the list of objects to restore. If *ALL is
|
|
specified for the file name, it must be the only file name in the list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Database file name</em></td>
|
|
<td align="left" valign="top">The name of the database file from which the
|
|
listed members are restored.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Member.</strong> The name of the member to restore. The possible values
|
|
are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All members are restored from the specified file. If
|
|
*ALL is specified for member name, it must be the only member name for that
|
|
file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No members are restored from the specified file.
|
|
Only the file description is restored.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Member name</em></td>
|
|
<td align="left" valign="top">The name of the member to restore. It may be either
|
|
a simple name or a generic name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of file and member structures
|
|
used during the restore operation. The possible values are 1 through 50.</p>
|
|
|
|
<p><strong>Number of members.</strong> The number of member names for the given
|
|
file name. Possible values are 1 through 50.</p>
|
|
|
|
<p><strong>Reserved.</strong> An ignored field.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRFRCKEY">Force Object Conversion Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="center" valign="bottom">Dec</th>
|
|
<th align="center" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Convert during restore</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Objects to convert</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Convert during restore.</strong> Whether objects should be converted on the
|
|
restore operation. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The objects are not converted during the restore
|
|
operation. (*NO)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The objects are converted during the restore
|
|
operation. (*YES)
|
|
|
|
<p><strong>Note:</strong> This value increases the time of the restore
|
|
operation, but avoids the need to convert the objects when they are first
|
|
used.</p>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The objects are converted based on the value of
|
|
the QFRCCVNRST system value. (*SYSVAL)
|
|
|
|
<p><strong>Note:</strong> If this value is specified and the system value
|
|
QFRCCVNRST has a value of 1, the restore operation proceeds as if 1 were
|
|
specified for the force conversion field and 2 were specified for the objects
|
|
to convert field.</p>
|
|
|
|
<p>If QFRCCVNRST has a value of 0, the restore operation proceeds as if 0 were
|
|
specified for the force conversion field.</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Objects to convert.</strong> Which objects should be converted on the
|
|
restore operation. The default is 2. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">All objects are converted regardless of their
|
|
current format. Even if the objects are in the current format, they are
|
|
converted again. However, if the objects are not observable, the objects are
|
|
not restored. (*ALL)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The objects are converted only if they require
|
|
conversion to be used by the current operating system. If the objects are not
|
|
observable, the objects are restored but not converted. (*RQD)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<h3><a name="HDROBJKEY">Object Information Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> These fields
|
|
repeat for each object name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object type</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<strong>Number in array.</strong> The number of objects that are specified for
|
|
this key. There is no limit for the number in array field. The total amount of
|
|
information in the user space, however, cannot exceed 16MB.
|
|
|
|
<p><strong>Object name.</strong> The name of the object that is to be restored.
|
|
The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All the objects in the specified libraries,
|
|
depending on the values specified for object type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Object name</em></td>
|
|
<td align="left" valign="top">Either a simple name or a generic name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object type.</strong> The type of the object that is to be restored.
|
|
The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All objects with the specified object name that
|
|
are valid types for the RSTOBJ command on the current release of the
|
|
system.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Object type</em></td>
|
|
<td align="left" valign="top">A valid type for the RSTOBJ command on the
|
|
current release of the system</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROLIBKEY">Omit Library Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> This field
|
|
repeats for each library name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Library name.</strong> The name of the library containing the
|
|
objects to omit. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*NONE</em></td>
|
|
<td align="left" valign="top">No libraries are excluded from the
|
|
restore operation.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Library name</em></td>
|
|
<td align="left" valign="top">Either a simple or generic library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of libraries to omit from
|
|
the restore operation. The possible values are 1 through 300.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROBJOMIT">Omit Object Information Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> These fields
|
|
repeat for each object name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Library name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Object type</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<strong>Library name.</strong> The name of the library that is to be omitted.
|
|
The possible values are:
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All the libraries, depending on the values
|
|
specified for object and object type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Library name</em></td>
|
|
<td align="left" valign="top">Either a simple name or a generic name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of values that are specified
|
|
for this key. The possible values are 1 through 300.</p>
|
|
|
|
<p><strong>Object name.</strong> The name of the object that is to be omitted.
|
|
The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All the objects in the specified libraries,
|
|
depending on the values specified for object type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Object name</em></td>
|
|
<td align="left" valign="top">Either a simple name or a generic name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Object type.</strong> The type of the object that is to be omitted.
|
|
The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All objects with the specified object name that
|
|
are valid types for the RSTOBJ command on the current release of the
|
|
system</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Object type</em></td>
|
|
<td align="left" valign="top">A valid type for the RSTOBJ command on the
|
|
current release of the system</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDROUTPKEY">Output Member Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Output member name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top">Option</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<strong>Option.</strong> An indicator of whether to add to or replace the
|
|
existing member. The possible values are:
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The existing records in the specified database
|
|
file member are replaced by the new records. (*REPLACE)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The new records are added to the existing
|
|
information in the database file member. (*ADD)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Output member name.</strong> The name of the file member that
|
|
receives the output. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*FIRST</em></td>
|
|
<td align="left" valign="top">The first member in the file is used and receives
|
|
the output.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Member name</em></td>
|
|
<td align="left" valign="top">If the member does not exist, the system creates
|
|
it.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRLIBKEY">Saved Library Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> This field
|
|
repeats for each library name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Library name.</strong> The name of the library containing the
|
|
objects. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ANY</em></td>
|
|
<td align="left" valign="top">Restores objects from the first version
|
|
of all saved libraries found on the tape beginning with the sequence
|
|
number specified for the sequence number key, or restores objects from
|
|
all saved libraries found on the optical media in the directory
|
|
specified for the optical file key.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SPLF</em></td>
|
|
<td align="left" valign="top">Spooled file data that was saved with
|
|
the QSRSAVO API with library name *SPLF specified is to be restored.
|
|
If this value is specified, it must be the only element in the array,
|
|
the spooled file data key must be specified,
|
|
and *ALL must be specified for the object name and object type.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Library name</em></td>
|
|
<td align="left" valign="top">Either a simple or generic library name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of libraries used during the
|
|
restore operation. The possible values are 1 through 300.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSPLFKEY">Spooled File Data Key Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Spooled file data</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of spooled file data header</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to spooled file selection list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Length of spooled file data header.</strong> The length of the
|
|
spooled file data header information. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>8</em></td>
|
|
<td align="left" valign="top">The header information ends with the
|
|
length field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>12</em></td>
|
|
<td align="left" valign="top">The header information ends with the
|
|
offset to selection list field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Offset to spooled file selection list.</strong> The offset from the
|
|
start of the user space to the first
|
|
<a href="#HDRSPLFSEL">spooled file selection list entry</a>.
|
|
The default is 0.
|
|
If the value of the spooled file data field is 2, the value of this field
|
|
must be greater than 0. Otherwise, the value must be 0.</p>
|
|
|
|
<p><strong>Spooled file data.</strong> Whether to save spooled file
|
|
data and attributes. The default is 3. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">No spooled file data is restored. (*NONE)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">Selected spooled file data is restored.
|
|
The offset to selection list field must be specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>3</em></td>
|
|
<td align="left" valign="top">For each output queue that is restored,
|
|
spooled file data that was saved with the output queue is restored,
|
|
if it does not already exist on the system. (*NEW)</td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSPLFSEL">Spooled File Selection List Entry Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of spooled file selection list entry</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to next spooled file selection list entry</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Include or omit</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">12</td>
|
|
<td align="center" valign="top">C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Selection criteria format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">16</td>
|
|
<td align="center" valign="top">10</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to selection criteria</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">20</td>
|
|
<td align="center" valign="top">14</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Offset to new attributes</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Include or omit.</strong> Whether the spooled files selected
|
|
by this entry are included or omitted from the save operation. Omit takes
|
|
precedence over include. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Spooled files that match all of the values
|
|
specified in the selection criteria are omitted from the restore operation.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Spooled files that match all of the values
|
|
specified in the selection criteria are included in the restore operation,
|
|
unless another entry omits them.
|
|
At least one entry must have this value.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of spooled file selection list entry.</strong> The length of the
|
|
spooled file selection list entry information. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>20</em></td>
|
|
<td align="left" valign="top">The selection list entry ends with the
|
|
offset to selection criteria field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>24</em></td>
|
|
<td align="left" valign="top">The selection list entry ends with the
|
|
offset to new attributes field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Offset to new attributes.</strong> The
|
|
offset from the start of the user space to the new attributes
|
|
for the spooled files included by this selection list entry.
|
|
The value must be 0 if the Include or omit field value is 0.
|
|
For the format of the new attributes, see
|
|
<a href="#HDRNEWATTRS">New Attributes Format</a>.</p>
|
|
|
|
<p><strong>Offset to next spooled file selection list entry.</strong> The
|
|
offset from the start of the user space to the next
|
|
spooled file selection list entry.
|
|
The value must be 0 for the last entry in the list.</p>
|
|
|
|
<p><strong>Offset to selection criteria.</strong> The
|
|
offset from the start of the user space to the selection criteria.</p>
|
|
|
|
<p><strong>Selection criteria format.</strong> The format of the
|
|
spooled file selection criteria. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The selection criteria is specified by the
|
|
<a href="#HDRSPLFID">Spooled File ID Format</a>. This format identifies
|
|
exactly one spooled file.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The selection criteria is specified by the
|
|
<a href="#HDRSPLFATTRS">Spooled File Attributes Format</a>. This format
|
|
identifies any number of spooled files.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSPLFID">Spooled File ID Format</a></h3>
|
|
|
|
<p>This is the format of the spooled file selection criteria
|
|
when a value of 1 is specified for the
|
|
selection criteria format field.
|
|
The criteria specified must uniquely
|
|
identify a single spooled file.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">0</td>
|
|
<td align="center" valign="top">0</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of Spooled file ID</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">4</td>
|
|
<td align="center" valign="top" width="10%">4</td>
|
|
<td align="left" valign="top" width="20%">CHAR(26)</td>
|
|
<td align="left" valign="top" width="60%">Qualified job name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">30</td>
|
|
<td align="center" valign="top">1E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Spooled file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">40</td>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Spooled file number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="center" valign="top">2C</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Job system name</td>
|
|
</tr>
|
|
<tr>
|
|
<td align="center" valign="top">52</td>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="left" valign="top">CHAR(7)</td>
|
|
<td align="left" valign="top">Creation date</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">59</td>
|
|
<td align="center" valign="top">3B</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">Creation time</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Creation date and time.</strong> The date and time the spooled file
|
|
was created. The date and time must be specified in the format CYYMMDDHHMMSS:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
|
and 1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Job system name.</strong> The name of the system where the
|
|
job that created the spooled file ran.</p>
|
|
|
|
<p><strong>Length of spooled file ID.</strong> The length of the
|
|
spooled file ID information. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>65</em></td>
|
|
<td align="left" valign="top">The spooled file ID ends with
|
|
the creation time field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Qualified job name.</strong> The name of the job that owns
|
|
the spooled file. The qualified job name has three parts:</p>
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top">Job name</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">A specific job name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">User name</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">A specific user profile name.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Job number</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">A specific job number.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Spooled file name.</strong> The name of the spooled file.</p>
|
|
|
|
<p><strong>Spooled file number.</strong> The unique number of the
|
|
spooled file. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top" nowrap><em>1-999999</em></td>
|
|
<td align="left" valign="top">The number of the spooled file for the
|
|
specified qualified job name and spooled file name.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRSPLFATTRS">Spooled File Attributes Format</a></h3>
|
|
|
|
<p>This is the format of the spooled file selection criteria
|
|
when a value of 2 is specified for the
|
|
selection criteria format field.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="center" valign="top" width="10%">0</td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Length of spooled file attributes</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Qualified output queue</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">24</td>
|
|
<td align="center" valign="top">18</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Spooled file name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">34</td>
|
|
<td align="center" valign="top">22</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Job name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">44</td>
|
|
<td align="center" valign="top">2C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">54</td>
|
|
<td align="center" valign="top">36</td>
|
|
<td align="left" valign="top">CHAR(6)</td>
|
|
<td align="left" valign="top">Job number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">60</td>
|
|
<td align="center" valign="top">3C</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">User-specified data</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">70</td>
|
|
<td align="center" valign="top">46</td>
|
|
<td align="left" valign="top">CHAR(8)</td>
|
|
<td align="left" valign="top">Job system name</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">78</td>
|
|
<td align="center" valign="top">4E</td>
|
|
<td align="left" valign="top">CHAR(10)</td>
|
|
<td align="left" valign="top">Form type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">88</td>
|
|
<td align="center" valign="top">58</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Starting creation date and time</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">101</td>
|
|
<td align="center" valign="top">65</td>
|
|
<td align="left" valign="top">CHAR(13)</td>
|
|
<td align="left" valign="top">Ending creation date and time</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Ending creation date and time.</strong> Spooled files with a
|
|
creation date and time less than or equal to this date and time are
|
|
selected. The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Ending creation date and time are not used
|
|
to select spooled files.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The date and time must be specified in the format CYYMMDDHHMMSS:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
|
and 1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Form type.</strong> Spooled files with this form type are
|
|
selected. Either a specific value or generic value may be specified.
|
|
The default is *ALL. The following special values are allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files with any form
|
|
type are selected.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*STD</em></td>
|
|
<td align="left" valign="top">Spooled files that specify the standard form
|
|
type are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Job name.</strong> Spooled files owned by this job are
|
|
selected. Either a specific name or generic name may be specified.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files owned by any job
|
|
are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Job number.</strong> Spooled files owned by a job with
|
|
this job number are selected. If a job number is specified, then
|
|
a specific job name and a specific user name must also be specified.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files owned by a job with
|
|
any job number are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Job system name.</strong> Spooled files owned by a job on
|
|
this system are selected.
|
|
Either a specific name or generic name may be specified.
|
|
The default is *ALL. The following special values are allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files owned on
|
|
any system are selected.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURRENT</em></td>
|
|
<td align="left" valign="top">Spooled files owned by a job on
|
|
the current system are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of spooled file attributes.</strong> The length of the
|
|
spooled file data attributes information. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>24</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the qualified output queue field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>34</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the spooled file name field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>44</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the job name field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>54</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the user name field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>60</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the job number field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>70</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the user-specified data field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>78</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the job system name field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>88</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the form type field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>101</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the starting creation date and time field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>114</em></td>
|
|
<td align="left" valign="top">The spooled file attributes end with
|
|
the ending creation date and time field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Qualified output queue.</strong> Spooled files on this
|
|
output queue are selected, if they were saved with the data selected
|
|
by the saved library and object information keys.
|
|
The qualified output queue has two parts:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top">Object name</td>
|
|
<td align="left" valign="top">CHAR(10). A specific or generic
|
|
output queue name or the following special value:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files on all
|
|
output queues that satisfy the library name are selected.</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Library name</td>
|
|
<td align="left" valign="top">CHAR(10). A specific or generic
|
|
library name, or one of the following special values:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">All libraries.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library.
|
|
If no library is specified as the current library for the job, the
|
|
QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The libraries in the library list.</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Spooled file name.</strong> Spooled files with this name are
|
|
selected. Either a specific name or generic name may be specified.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files with any name
|
|
are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Starting creation date and time.</strong> Spooled files with a
|
|
creation date and time greater than or equal to this date and time are
|
|
selected.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Starting creation date and time are not used
|
|
to select spooled files.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The date and time must be specified in the format CYYMMDDHHMMSS:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>C</em></td>
|
|
<td align="left" valign="top">Century, where 0 indicates years 19<em>xx</em>
|
|
and 1 indicates years 20<em>xx</em>.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>YY</em></td>
|
|
<td align="left" valign="top">Year</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Month</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>DD</em></td>
|
|
<td align="left" valign="top">Day</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>HH</em></td>
|
|
<td align="left" valign="top">Hour</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>MM</em></td>
|
|
<td align="left" valign="top">Minute</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>SS</em></td>
|
|
<td align="left" valign="top">Second</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>User name.</strong> Spooled files owned by this user
|
|
are selected. Either a specific name or generic name may be specified.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files with any user
|
|
are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>User-specified data.</strong> Spooled files with this
|
|
user-specified data value are selected.
|
|
Either a specific value or generic value may be specified.
|
|
The default is *ALL. The following special value is allowed:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*ALL</em></td>
|
|
<td align="left" valign="top">Spooled files with any user-specified
|
|
data value are selected.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRNEWATTRS">New Attributes Format</a></h3>
|
|
|
|
<p>This is the format of new attributes to be assigned
|
|
to the selected spooled files.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">0</td>
|
|
<td align="center" valign="top">0</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of new attributes</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Expiration days</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">CHAR(20)</td>
|
|
<td align="left" valign="top">Qualified output queue</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">28</td>
|
|
<td align="center" valign="top">1C</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Restore existing spooled file</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Expiration days.</strong> The number of days from
|
|
the start of the operation when the selected spooled files
|
|
will expire. The default is 0.</p>
|
|
|
|
<p><strong>Note:</strong> The user needs additional
|
|
authority to use any value other than 0. The default value of 0
|
|
will be used for any spooled files which the user is not
|
|
authorized to change. The user is authorized to change the
|
|
expiration date of a spooled file if any of the following
|
|
conditions are met.</p>
|
|
|
|
<ul>
|
|
<li>The user owns the spooled file.</li>
|
|
<li>The user has spool control (*SPLCTL) special authority.</li>
|
|
<li>The user has job control (*JOBCTL) special authority, and
|
|
the output queue to which the spooled file is being restored is
|
|
specified as OPRCTL(*YES).</li>
|
|
<li>The user owns the output queue to which the spooled file is being
|
|
restored, and the output queue is specified as AUTCHK(*OWNER).</li>
|
|
<li>The user has read, add, and delete authorities to
|
|
the output queue to which the spooled file is being restored,
|
|
and the output queue is specified as AUTCHK(*DTAAUT).</li>
|
|
</ul>
|
|
|
|
<p>The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>-1</em></td>
|
|
<td align="left" valign="top">The expiration date for the selected
|
|
spooled files will be set to *NONE (no expiration date).</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The saved expiration date for the selected
|
|
spooled files will be used. If a saved expiration date has already
|
|
passed, a value of -1 will be used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1-366</em></td>
|
|
<td align="left" valign="top">The expiration date for the selected
|
|
spooled files will set to the number of days specified past the date
|
|
that the restore operation begins.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of new attributes.</strong> The length
|
|
of the new attributes information. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>8</em></td>
|
|
<td align="left" valign="top">The new attributes end with
|
|
the expiration days field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>28</em></td>
|
|
<td align="left" valign="top">The new attributes end with
|
|
the qualified output queue field.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>32</em></td>
|
|
<td align="left" valign="top">The new attributes end with
|
|
the restore existing spooled file field.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Qualified output queue.</strong> Spooled files are restored
|
|
to this output queue, if it is found in the ASP specified for the
|
|
restore to ASP device key or the restore to ASP number key.
|
|
The default is *SAME. The qualified output queue has two parts:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top">Object name</td>
|
|
<td align="left" valign="top">CHAR(10). A specific output queue name
|
|
or the following special value:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAME</em></td>
|
|
<td align="left" valign="top">Spooled files are
|
|
restored to the output queues from which they were saved.
|
|
The rest of the qualified output queue must be blank.</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Library name</td>
|
|
<td align="left" valign="top">CHAR(10). A specific library name,
|
|
or blanks when the object name is *SAME,
|
|
or one of the following special values:
|
|
|
|
<table cellpadding="5">
|
|
<tr>
|
|
<td align="left" valign="top"><em>*CURLIB</em></td>
|
|
<td align="left" valign="top">The job's current library is used to locate the
|
|
output queue. If no library is specified as the current library for the job, the
|
|
QGPL library is used.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*LIBL</em></td>
|
|
<td align="left" valign="top">The library list is used to locate the output
|
|
queue.</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Restore existing spooled file.</strong> Whether to
|
|
restore a spooled file that already exists on the system.
|
|
The default is 0. The possible values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">A spooled file that already exists on
|
|
the system is not restored.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">If a spooled file already exists on
|
|
the system, a duplicate copy of the spooled file is restored
|
|
to the specified output queue with a new creation date and time.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRVOLKEY">Volume Identifier Format</a></h3>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="center" valign="bottom" colspan="2">Offset</th>
|
|
<th align="left" valign="bottom" rowspan="2">Type</th>
|
|
<th align="left" valign="bottom" rowspan="2">Field</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<th align="left" valign="bottom">Dec</th>
|
|
<th align="left" valign="bottom">Hex</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="center" valign="top" width="10%"> </td>
|
|
<td align="left" valign="top" width="20%">BINARY(4)</td>
|
|
<td align="left" valign="top" width="60%">Number in array</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="4"><strong>Note:</strong> These fields
|
|
repeat for each volume identifier.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top">Length of volume identifier</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="center" valign="top"> </td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Volume identifier</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<strong>Length of volume identifier.</strong> The character length of the
|
|
identifier of the volume. The possible value is:
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>n</em></td>
|
|
<td align="left" valign="top">The size of a single volume identifier. The
|
|
maximum size of a tape<!-- or diskette--> volume identifier is 6 characters. The
|
|
maximum size of an optical volume identifier is 32 characters. If a volume
|
|
identifier larger than the maximum size is entered for this key, it is
|
|
truncated to the maximum size. If the volume identifier is *MOUNTED, this value
|
|
must be 8. If the volume identifier is *SAVVOL, this value must be 7.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Number in array.</strong> The number of volume identifiers used
|
|
during the restore operation. The possible values are 1 through 75.</p>
|
|
|
|
<p><strong>Volume identifier.</strong> The identifier of a volume. The possible
|
|
values are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*MOUNTED</em></td>
|
|
<td align="left" valign="top">The volume currently placed in the device is
|
|
used. If *MOUNTED is specified, it must be the only value specified. This value
|
|
cannot be specified for an optical media library device. *MOUNTED cannot be
|
|
specified for a tape media library device unless a category is set with the Set
|
|
Tape Category (SETTAPCGY) command.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SAVVOL</em></td>
|
|
<td align="left" valign="top">The system, by using the save or restore history
|
|
information, determines which volumes contain the most recently saved version
|
|
of the objects. If *SAVVOL is specified, it must be the only value specified.
|
|
The history information contains only the first 6 characters of any volume name.
|
|
If the name of an optical volume exceeds 6 characters,
|
|
you should not use this value.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>Volume identifier</em></td>
|
|
<td align="left" valign="top">The identifier of a volume.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRKEYDPD">Dependencies between Keys</a></h3>
|
|
|
|
<p>The following two tables list the dependencies between the different keys.
|
|
If the dependency holds only for a certain value, then that value is also shown
|
|
(key = <em>n</em>, where <em>n</em> is the value). Otherwise, if the
|
|
dependency is true for all values of the key, then only the name of the key is
|
|
given.</p>
|
|
|
|
<p>The following table lists the conditions where specifying a certain key
|
|
forces the use of another key.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="left" valign="top">If you specify...</th>
|
|
<th align="left" valign="top">...must be specified</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="50%">More than one library name,<br>
|
|
Generic library name,<br>
|
|
or Library name = *ANY</td>
|
|
<td align="left" valign="top" width="50%">Object name = *ALL<br>
|
|
Device <> *SAVF<br>
|
|
Restore library = *SAVLIB<sup>1</sup><br>
|
|
Label = *SAVLIB<sup>1</sup><br>
|
|
Optical file = '*'<sup>1</sup> or 'directory/*'</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Device = tape device</td>
|
|
<td align="left" valign="top">Volume identifier <sup>1</sup><br>
|
|
Sequence number <sup>1</sup><br>
|
|
Label <sup>1</sup><br>
|
|
End of media option <sup>1</sup></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Device = optical device</td>
|
|
<td align="left" valign="top">Volume identifier<br>
|
|
Optical file <sup>1</sup></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Device = media definition</td>
|
|
<td align="left" valign="top">Media definition</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Output = 1</td>
|
|
<td align="left" valign="top">Type of output information = 0<sup>1</sup></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Output = 2</td>
|
|
<td align="left" valign="top">Output file<br>
|
|
Output member <sup>1</sup><br>
|
|
Type of output information <sup>1</sup></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Save time</td>
|
|
<td align="left" valign="top">Save date</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Volume identifier = *SAVVOL</td>
|
|
<td align="left" valign="top">Label = *SAVLIB<sup>1</sup></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Library name = *SPLF</td>
|
|
<td align="left" valign="top">Object name = *ALL<sup>1</sup><br>
|
|
Object type = *ALL<sup>1</sup><br>
|
|
Spooled file data = 2</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Spooled file data = 2</td>
|
|
<td align="left" valign="top">Object name = *ALL<sup>1</sup><br>
|
|
Object type = *ALL<sup>1</sup><br>
|
|
Library name = *SPLF<br>
|
|
or<br>
|
|
Object type = *OUTQ<br>
|
|
Library name <> *SPLF</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" colspan="2"><strong>Notes:</strong>
|
|
|
|
<ol type="1">
|
|
<li>This key does not have to be explicitly specified. The default may be taken
|
|
to satisfy this dependency.</li>
|
|
</ol>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>The following table lists the conditions where specifying a certain key
|
|
excludes the user from using another key, or a particular value of that
|
|
key.</p>
|
|
|
|
<table border width="80%">
|
|
<tr>
|
|
<th align="left" valign="top">If you specify...</th>
|
|
<th align="left" valign="top">...cannot be specified</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="50%">Save file</td>
|
|
<td align="left" valign="top" width="50%">Volume identifier<br>
|
|
Sequence number<br>
|
|
Label<br>
|
|
End of media option<br>
|
|
Optical file<br>
|
|
Media definition</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Media definition</td>
|
|
<td align="left" valign="top">Volume identifier<br>
|
|
Sequence number<br>
|
|
Optical file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Tape, optical, or media<br>
|
|
definition for the device</td>
|
|
<td align="left" valign="top">Save file</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Output = 0</td>
|
|
<td align="left" valign="top">Output file<br>
|
|
Output member<br>
|
|
Type of output information</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Optical file</td>
|
|
<td align="left" valign="top">Label<br>
|
|
Sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Allow object differences = 1</td>
|
|
<td align="left" valign="top">Database member option = 0</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Volume identifier = *SAVVOL</td>
|
|
<td align="left" valign="top">Sequence number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Database member option = 0</td>
|
|
<td align="left" valign="top">File member</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">Restore ASP</td>
|
|
<td align="left" valign="top">Restore ASP device name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Relationship to RSTOBJ Command</h3>
|
|
|
|
<p>Because of the relationship between the QSRRSTO API and the RSTOBJ
|
|
command, the following situations should be noted:</p>
|
|
|
|
<ul>
|
|
<li>Message text: Several messages produced by this API refer to parameters or
|
|
values of the RSTOBJ command. To determine which key a
|
|
given parameter corresponds to, see <a href="#HDRKEYFLD">Valid Keys</a>. To
|
|
determine which key value a given parameter value corresponds to, see <a href=
|
|
"#HDRSOLDESC">Field Descriptions</a>.</li>
|
|
|
|
<li>Command type: The command type listed for the API on headings of displays
|
|
and print files is RSTOBJ, not QSRRSTO.</li>
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
|
|
<h3>Error Messages</h3>
|
|
|
|
<table width="100%" cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<th align="left" valign="top">Message ID</th>
|
|
<th align="left" valign="top">Error Message Text</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top" width="15%">CPF222E E</td>
|
|
<td align="left" valign="top" width="85%">&1 special authority is required.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF24B4 E</td>
|
|
<td align="left" valign="top">Severe error while addressing parameter
|
|
list.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3700 E</td>
|
|
<td align="left" valign="top">All CPF37xx messages could be signalled. xx is
|
|
from 01 to FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3800 E</td>
|
|
<td align="left" valign="top">All CPF38xx messages could be signalled. xx is
|
|
from 01 to FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C31 E</td>
|
|
<td align="left" valign="top">Object type &1 is not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C4D E</td>
|
|
<td align="left" valign="top">Length &1 for key &2 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C81 E</td>
|
|
<td align="left" valign="top">Value for key &1 not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C82 E</td>
|
|
<td align="left" valign="top">Key &1 not valid for API &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C83 E</td>
|
|
<td align="left" valign="top">Key &1 not allowed with value specified for
|
|
key &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C84 E</td>
|
|
<td align="left" valign="top">Key &1 required with value specified for key
|
|
&2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C85 E</td>
|
|
<td align="left" valign="top">Value for key &1 not allowed with value for
|
|
key &2.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C86 E</td>
|
|
<td align="left" valign="top">Required key &1 not specified.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C87 E</td>
|
|
<td align="left" valign="top">Key &1 allows one value with special
|
|
value.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3C90 E</td>
|
|
<td align="left" valign="top">Literal value cannot be changed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF3CF1 E</td>
|
|
<td align="left" valign="top">Error code parameter not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF5729 E</td>
|
|
<td align="left" valign="top">Not able to allocate object &1.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF9800 E</td>
|
|
<td align="left" valign="top">All CPF98xx messages could be signaled. xx is
|
|
from 01 to FF.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPFB8ED E</td>
|
|
<td align="left" valign="top">Device description &1 not correct for
|
|
operation.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<img src="deltaend.gif" alt="End of change">
|
|
|
|
<hr>
|
|
API introduced: V5R4
|
|
|
|
<hr>
|
|
<table align="center" cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
|
|
"back1.htm">Backup and Recovery APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
</body>
|
|
</html>
|
|
|