573 lines
27 KiB
HTML
573 lines
27 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Restore S/36 File (RSTS36F)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="RSTS36F.Top_Of_Page"></a>
|
|
<h2>Restore S/36 File (RSTS36F)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#RSTS36F.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RSTS36F.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RSTS36F.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RSTS36F"></a>
|
|
<p>The Restore System/36 File (RSTS36F) command restores to the system a single file or a group of files from a save all set. A single file can be restored from a database physical file, a diskette file or a tape file. A group of files can be restored from a save all set on diskette or tape.
|
|
</p>
|
|
<p>The restore operation reads the description of the file from the database physical file, diskette, or tape, creates a database physical or logical file and copies any data from the database physical file, diskette file or tape file into the new database file. The database physical file must have been created with the Save System/36 File (SAVS36F) command. The diskette or tape file may have been created on a System/36 using the SAVE system operator control language (OCL) procedure (or the equivalent OCL use of the $COPY SSP utility), or by using the Save System/36 File (SAVS36F) command. The Restore System/36 File (RSTS36F) command accepts diskette or tape files created on a System/34 or System/32 using the $COPY utility.
|
|
</p>
|
|
<p>The RSTS36F command accepts a diskette file created as a compressed file.
|
|
</p>
|
|
<p>If the file being restored does not exist in the library specified on the TOLIB parameter, it is created. A physical file member is added using the name syntax 'Myymmdd', which identifies the original creation date of the file. This naming convention is needed by the System/36 environment in order to support date-differentiated files.
|
|
</p>
|
|
<p>If a file name is specified for the TOFILE parameter, the name must meet the AS/400 system naming standards. For more information about AS/400 system naming conventions, see Chapter 2, "Control Language Syntax", in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>If TOFILE(*SET) is specified, the files that are restored may have names that contain characters not allowed in an AS/400 simple object name. In this case, the file name is changed to an AS/400 system extended name and the file is restored.
|
|
</p>
|
|
<p>If the name contains a blank, a single quotation mark, a double quotation mark, an asterisk, a question mark, or a device control character (hexadecimal 00 through 3F or hexadecimal FF), the invalid characters are replaced with underlines. The file is then restored using the resulting simple or extended name; for example, A_? would become "A_"). If a file already exists with this new name, it is handled like any other name (see the MBROPT parameter).
|
|
</p>
|
|
<p>If a file name is changed because of invalid characters, an informational message (CPF 2C1F) is sent to the recursion level above the program that is running this command. If the name is changed from a simple name to an extended name, no message is sent.
|
|
</p>
|
|
<p>If the restore function creates the file and the file was not previously secured, the new file is owned by the user issuing the RSTS36F command and the file is created with a default authority of *ALL (that is the same as AUT(*ALL)).
|
|
</p>
|
|
<p>If the file was saved from the S/36 where the attributes were an extend value of zero or no value specified, then a default value of 32 767 divided by the record length is assigned. If an extend value of zero is required, use the change physical file (CHGPF) command (after the restore is completed) to set SIZE(*EXTEND) to zero. If the file was saved from the AS/400 system, the file is restored and the extend value does not change.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This function is intended only for exchanging files with a System/36.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>The following authorities are required when running on a system using resource security:
|
|
<ul>
|
|
<li>*USE, *SECADM, and *ALLOBJ authorities for this command
|
|
</li>
|
|
<li>*USE authority for the library specified in the TOLIB parameter
|
|
</li>
|
|
<li>*CHANGE authority for the library specified in the TOLIB parameter when restoring a file that does not already exist on the system
|
|
</li>
|
|
<li>*CHANGE and *OBJMGMT authority for the existing file (needed to add a new member) when restoring a date-differentiated physical file and a file by the same name but with a different creation date
|
|
</li>
|
|
<li>*ALL authority for the file when restoring to an existing physical file with the same creation date and MBROPT(*REPLACE) specified
|
|
</li>
|
|
<li>*CHANGE authority for the based-on physical file (this physical file was referred to as the <i>parent file</i> on System/36) if the file being restored is a System/36 alternative index file (that is, a logical file)
|
|
</li>
|
|
<li>*USE authority for the diskette device description object and *USE authority for device file QSYSDKT in library QSYS, when restoring from diskette
|
|
</li>
|
|
<li>*USE authority for the tape device description object and *USE authority for device file QSYSTAP in library QSYS, when restoring from tape
|
|
</li>
|
|
<li>*USE authority for the file and *USE authority for the library that contains the file (PHYFILE parameter) if restoring from a database physical file
|
|
</li>
|
|
<li>If the file doesn't exist on the system but a file authorization holder object by the same name does exist, *ALL authority or ownership for the authorization holder object
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>There is no replace function supported when restoring System/36 alternative index files (logical files). If restoring an alternative index file, no file object by the same name can already exist in the specified library.
|
|
</li>
|
|
<li>If restoring a logical file, the based-on physical file must already exist in the library specified for the TOLIB parameter.
|
|
</li>
|
|
<li>The AS/400 system files that are the same as the System/36 date-differentiated files are multiple-member physical files. Date-differentiated alternative index files are not supported. The data for a physical file is stored in a member that is named using the syntax 'Myymmdd' where 'yymmdd' represents the original creation date (in year/month/day format) of the file.
|
|
<p>Because all members of a physical file share the same file attributes (for example, record length and key information), date-differentiated files with the same name that are restored to the same library are required to have the same file attributes. If an attribute mismatch is present, the files are not restored.
|
|
</p>
|
|
</li>
|
|
<li>Object-level and record-level functions, including read operations, should not be used for a file being restored by the RSTS36F command. If another operation is being done at the same time on the file (for example, moving the file or reading or adding records), the restore operation stops if it cannot allocate the file.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RSTS36F.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.TOFILE"><b>TOFILE</b></a></td>
|
|
<td valign="top">To file</td>
|
|
<td valign="top"><i>Name</i>, *SET</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.TOLIB"><b>TOLIB</b></a></td>
|
|
<td valign="top">To library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top">Single values: *PHYFILE<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
|
<td valign="top">Required, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.SET"><b>SET</b></a></td>
|
|
<td valign="top">Set identifier</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>#SAVE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.IGCDTA"><b>IGCDTA</b></a></td>
|
|
<td valign="top">User specified DBCS data</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.FROMLABEL"><b>FROMLABEL</b></a></td>
|
|
<td valign="top">File label</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.CRTDATE"><b>CRTDATE</b></a></td>
|
|
<td valign="top">Creation date</td>
|
|
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.SEQNBR"><b>SEQNBR</b></a></td>
|
|
<td valign="top">Sequence number</td>
|
|
<td valign="top">1-9999, <b><u>*SEARCH</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top">Values (up to 50 repetitions): <i>Character value</i>, <b><u>*MOUNTED</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.ENDOPT"><b>ENDOPT</b></a></td>
|
|
<td valign="top">End of tape option</td>
|
|
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTS36F.PHYFILE"><b>PHYFILE</b></a></td>
|
|
<td valign="top">Physical file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Physical file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RSTS36F.MBROPT"><b>MBROPT</b></a></td>
|
|
<td valign="top">Data base member option</td>
|
|
<td valign="top"><b><u>*NOREPLACE</u></b>, *REPLACE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTS36F.DATDIFF"><b>DATDIFF</b></a></td>
|
|
<td valign="top">Date differentiated file</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RSTS36F.TOFILE"></a>
|
|
<h3>To file (TOFILE)</h3>
|
|
<p>Specifies the name given to a single file when it is restored to the system or to a group of files from a save all set that are restored to the system. If a single file is restored, this parameter allows the file to be renamed at the time it is restored to the system.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SET</b></dt>
|
|
<dd>Specifies that a group of files from a save all set on diskette or tape are restored to the system.
|
|
</dd>
|
|
<dt><b><i>file-name</i></b></dt>
|
|
<dd>Specifies the file name that is given to a single file when the file is restored to the system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.TOLIB"></a>
|
|
<h3>To library (TOLIB)</h3>
|
|
<p>Specifies which library should contain the file being restored.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of a diskette unit, the names of one or more tape devices, or an indication that the file to be restored is in a database physical file. A maximum of four tape device names can be specified. If more than one tape device is used, enter the names of the devices in the order in which they are used. Each device name must be already known on the system by a device description.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*PHYFILE</b></dt>
|
|
<dd>The file to be restored is in a database physical file. The name of the database physical file is specified by the <b>Physical file</b> prompt (PHYFILE parameter).
|
|
</dd>
|
|
<dt><b><i>device-name</i></b></dt>
|
|
<dd>Specify the name of the diskette unit or the names of one or more tape devices that are used for the restore operation. If more than one tape device is used, enter the names of the devices in the order in which they are used. A maximum of four tape device names can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.SET"></a>
|
|
<h3>Set identifier (SET)</h3>
|
|
<p>Specifies the name used to identify the save all set files saved on the diskette or tape by the SAVE procedure or the $COPY utility on the System/36, System/34, or System/32.
|
|
</p>
|
|
<dl>
|
|
<dt><b>#SAVE</b></dt>
|
|
<dd>The files are restored from a save all set with a set identifier of <b>#SAVE</b>.
|
|
</dd>
|
|
<dt><b><i>set-identifier</i></b></dt>
|
|
<dd>Specifies the set-identifier of the save all set. The set-identifier can be from 1-8 characters long. The first character must be alphabetic (A through Z, #, $, or @). The remaining characters can be any combination of characters (numeric, alphabetic, and special) except commas(,), apostrophes('), and blanks.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.IGCDTA"></a>
|
|
<h3>User specified DBCS data (IGCDTA)</h3>
|
|
<p>Specifies whether the file contains double-byte character set (DBCS) data.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If a file already exists by the name specified on the <b>To file</b> prompt (TOFILE parameter), the double-byte character set (DBCS) capability of the existing file is not changed by the restore operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The files being restored may not contain DBCS data. If a file already exists in the specified library with the same name as the file being restored, and the file allows DBCS data, an informational message is sent, and the restore operation continues. The resulting file allows DBCS data (the file's IGC attributes are not changed by the restore operation).
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The files being restored may contain DBCS data. If a file already exists in the specified library with the same name as the file being restored, and the file does not allow DBCS data, an informational message is sent, and the restore operation continues. The resulting file will not allow DBCS data (the file's IGC attributes are not changed by the restore operation).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.FROMLABEL"></a>
|
|
<h3>File label (FROMLABEL)</h3>
|
|
<p>For a single file restore operation, this parameter can be used to specify the label of the diskette or tape file that contains the file that is to be restored to the system. If no value is specified, the file name specified for the <b>To file</b> prompt (TOFILE parameter) is used as the diskette or tape file label.
|
|
</p>
|
|
<p>For a group restore operation, this parameter can be used to specify the diskette or tape file label within a save all set where the restore operation is to begin. If no value is specified, the restore operation begins with the first file in the set.
|
|
</p>
|
|
<p>If a label is specified, it must be a maximum of eight characters long.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.CRTDATE"></a>
|
|
<h3>Creation date (CRTDATE)</h3>
|
|
<p>Specifies the creation date of the diskette file or tape file used for the restore operation. The specified date is changed to Julian format (cyyddd) for tape or international format (yymmdd) for diskette.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.SEQNBR"></a>
|
|
<h3>Sequence number (SEQNBR)</h3>
|
|
<p>Specifies, when tape is used, which sequence number is used for the restore operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SEARCH</u></b></dt>
|
|
<dd>The volume in the device is searched for a data file with an identifier that matches the FROMLABEL parameter value; when a match is found, the object is restored. If the last operation on the device specified *LEAVE for the <b>End of tape option (ENDOPT)</b> parameter, indicating that the tape is positioned at the location where the last operation ended, the file search starts with the first data file beyond the current tape position. If *LEAVE was not used for the <b>End of tape option (ENDOPT)</b> parameter of the last operation, or if the tape was manually rewound since the operation, the search starts with the first data file on the volume.
|
|
</dd>
|
|
<dt><b><i>1-16777215</i></b></dt>
|
|
<dd>Specify the sequence number of the file to be used for the restore operation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifiers of the tapes or diskettes used for restoring the file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
|
<dd>The volume currently placed in the device is used.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the volume identifiers of the tapes or diskettes used for restoring the file. A maximum of 50 volume identifiers can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.ENDOPT"></a>
|
|
<h3>End of tape option (ENDOPT)</h3>
|
|
<p>Specifies, only when tape is used, what positioning operation is automatically performed on the tape volume after the restore operation ends. This parameter applies only to the last reel used.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*REWIND</b></dt>
|
|
<dd>The tape is rewound, but not unloaded.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LEAVE</b></dt>
|
|
<dd>The tape is not rewound.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The tape is automatically rewound and unloaded after the operation ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.PHYFILE"></a>
|
|
<h3>Physical file (PHYFILE)</h3>
|
|
<p>Specifies the name of the database physical file that is used as the input file for the restore process. If the specified file does not exist, or is not a physical file, or the file contains no members, a message is sent. If the file contains multiple members, the first member of the file is used.
|
|
</p>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the file.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.MBROPT"></a>
|
|
<h3>Data base member option (MBROPT)</h3>
|
|
<p>Specifies whether the data of an existing physical file member is replaced.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NOREPLACE</u></b></dt>
|
|
<dd>Data in an existing physical file member with the same name is <i>not</i> replaced, and an error message is sent to the user.
|
|
</dd>
|
|
<dt><b>*REPLACE</b></dt>
|
|
<dd>Data in an existing physical file member with the same name is replaced.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTS36F.DATDIFF"></a>
|
|
<h3>Date differentiated file (DATDIFF)</h3>
|
|
<p>Specifies whether the restore operation allows multiple files with the same name but different file creation dates.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Multiple files with the same name but different file creation dates are not allowed.
|
|
<p>If the restore operation is done with *NO specified, and a file already exists in the specified library with the same name, the following actions are taken:
|
|
</p>
|
|
<ul>
|
|
<li>If the MBROPT parameter specifies the member should be replaced (*REPLACE), the data in the member is replaced with the data from the saved file.
|
|
</li>
|
|
<li>If the MBROPT parameter specifies the member should not be replaced (*NOREPLACE), a message is sent and the file is not restored.
|
|
</li>
|
|
<li>If no file exists by the name specified on the TOFILE parameter in the specified library, the file is restored normally.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Multiple files with the same name but different file creation dates are allowed.
|
|
<p>If the restore operation is done with *YES specified, and a file already exists in the specified library with the same name, the following actions are taken:
|
|
</p>
|
|
<ul>
|
|
<li>If a member does not exist with the name of 'Myymmdd', where 'yymmdd' is the creation date of the saved file, a new member is added to the file and the data from the saved file is copied to it.
|
|
</li>
|
|
<li>If a member does exist with the name of 'Myymmdd', where 'yymmdd' is the creation date of the saved file, and the MBROPT parameter specifies the member should be replaced (*REPLACE), the data in the member is replaced with the data from the saved file.
|
|
</li>
|
|
<li>If a member does exist with the name of 'Myymmdd', where 'yymmdd' is the creation date of the saved file, and the MBROPT parameter specifies the member should not be replaced (*NOREPLACE), a message is sent and the file is not restored.
|
|
</li>
|
|
</ul>
|
|
<p>If a file does not already exist in the specified library with the same name, a new file is created, a member is added to the file and the data from the saved file is copied into the new member.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTS36F.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Restoring From Diskette</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTS36F TOFILE(ACCTRCV) TOLIB(QS36F) DEV(I1)
|
|
CRTDATE('01/22/85') VOL(SAVE1)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the file ACCTRCV into library QS36F. Assuming that I1 is the name of a diskette device description object, the file is restored from the diskette placed in the diskette device. The diskette must have a volume name of SAVE1. The diskette file used for the restore must have a file label of ACCTRCV and a creation date of January 22, 1985 (assuming the job date format is *MDY and the date separator is a '/').
|
|
</p>
|
|
<p><b>Example 2: Restoring From Tape</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTS36F TOFILE(PAY.VIEW) TOLIB(PAYLIB) DEV(T1) FROMLABEL('P*V')
|
|
ENDOPT(*LEAVE)
|
|
</pre>
|
|
</p>
|
|
<p>The file P*V is restored from device T1 as a file named PAY.VIEW in library PAYLIB. Assuming T1 is a tape device, the file is copied from one or more tapes that are on device T1. No check is made on the tape volume name. When the restore operation ends, the tape is left positioned at the end of tape file P*V.
|
|
</p>
|
|
<p><b>Example 3: Restoring from a Physical File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTS36F TOFILE(ACCTPAY) TOLIB(QS36F) DEV(*PHYFILE)
|
|
PHYFILE(NETLIB/SENDFILE)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the file ACCTPAY in library QS36F from physical file SENDFILE in library NETLIB.
|
|
</p>
|
|
<p><b>Example 4: Specifying Sequence Numbers</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTS36F TOFILE(*SET) TOLIB(QS36F) DEV(T1 T2)
|
|
SET(PAYFILES) FROMLABEL(FILE10)
|
|
MBROPT(*REPLACE) DATDIFF(*YES)
|
|
SEQNBR(*SEARCH) VOL(*MOUNTED) ENDOPT(*REWIND)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores a subset of the files in the save all set called PAYFILES to library QS36F from tape. The restore operation begins with a tape file whose label is file 10. If one of the files being restored already exists in library QS36F with the same creation date as the saved file, the file is replaced. If a file already exists in library QS36F with a different creation date, a new date-differentiated number is added to the file. The restore operation uses the tape volumes that are placed in tape drives T1 and T2. After the restore operation is complete, the last tape volume is rewound to the beginning of the tape.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTS36F.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2C4A</b></dt>
|
|
<dd>Device &1 not correct for command.
|
|
</dd>
|
|
<dt><b>CPF2C4B</b></dt>
|
|
<dd>Duplicate device &1 specified in device name list.
|
|
</dd>
|
|
<dt><b>CPF2C4C</b></dt>
|
|
<dd>Diskette device &1 included in multiple device specification.
|
|
</dd>
|
|
<dt><b>CPF2C4D</b></dt>
|
|
<dd>Not all files were restored.
|
|
</dd>
|
|
<dt><b>CPF2C4E</b></dt>
|
|
<dd>Restore operation ended before all files were restored.
|
|
</dd>
|
|
<dt><b>CPF2C45</b></dt>
|
|
<dd>Input file &1 cannot be processed by RSTS36F.
|
|
</dd>
|
|
<dt><b>CPF2C47</b></dt>
|
|
<dd>Existing file &1 or member &3 in library &2 not replaced.
|
|
</dd>
|
|
<dt><b>CPF2C48</b></dt>
|
|
<dd>Input file &1 in &2 not correct for command.
|
|
</dd>
|
|
<dt><b>CPF2C49</b></dt>
|
|
<dd>Output file &1 in &2 not correct for command.
|
|
</dd>
|
|
<dt><b>CPF2C5A</b></dt>
|
|
<dd>Alternate index file &1 in library &2 not replaced.
|
|
</dd>
|
|
<dt><b>CPF2C5E</b></dt>
|
|
<dd>Input file &1 in &2 not correct for command.
|
|
</dd>
|
|
<dt><b>CPF2C50</b></dt>
|
|
<dd>File description for file &1 is not available.
|
|
</dd>
|
|
<dt><b>CPF2C52</b></dt>
|
|
<dd>Error occurred during attempt to create file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF2C53</b></dt>
|
|
<dd>Member &3 not added to file &1 in library &2 because error occurred.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9814</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
<dt><b>CPF9826</b></dt>
|
|
<dd>Cannot allocate file &2.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9831</b></dt>
|
|
<dd>Cannot assign device &1.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9848</b></dt>
|
|
<dd>Cannot open file &1 in library &2 member &3.
|
|
</dd>
|
|
<dt><b>CPF9849</b></dt>
|
|
<dd>Error while processing file &1 in library &2 member &3.
|
|
</dd>
|
|
</dl>
|
|
<p><b><u>*STATUS Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPI2C11</b></dt>
|
|
<dd>Copying records to file &1 in library &2 member &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTS36F.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|