547 lines
23 KiB
HTML
547 lines
23 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 Library Members (RSTS36LIBM)</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="RSTS36LIBM.Top_Of_Page"></a>
|
||
|
|
<h2>Restore S/36 Library Members (RSTS36LIBM)</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="#RSTS36LIBM.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RSTS36LIBM.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RSTS36LIBM.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RSTS36LIBM"></a>
|
||
|
|
<p>The Restore System/36 Library Members (RSTS36LIBM) command reads a file containing library members, creates database source or data file members on this system, and copies the member data from the file into each restored member.
|
||
|
|
</p>
|
||
|
|
<p>The input file can be a diskette file, tape file, or database physical file on this system.
|
||
|
|
</p>
|
||
|
|
<p>The file could have been created on a System/36, a System/34, or a System/32 using either the FROMLIBR or SAVELIBR system operator control language (OCL) procedure (or the equivalent use of $MAINT), or by using the Save System/36 Library Members (SAVS36LIBM) command.
|
||
|
|
</p>
|
||
|
|
<p>Diskette files created on a System/34 using the BACKUP procedure or $BACK utility are not accepted by this command. Compressed SAVELIBR diskette files (used by IBM to distribute system libraries for System/36 after release 5.0) are not accepted by this command.
|
||
|
|
</p>
|
||
|
|
<p>In System/36 terms, the input file format could be a SAVELIBR diskette file or tape file, a record-mode LIBRFILE diskette file, tape file, or physical file, or a sector-mode LIBRFILE diskette file, tape file, or physical file. In other words, the input file can be any diskette file, tape file, or physical file created by the System/36 $MAINT SSP utility.
|
||
|
|
</p>
|
||
|
|
<p>If the library identified by the value specified for the <b>To library</b> prompt (TOLIB parameter) does not exist, it is created. Also, the source files QS36SRC and QS36PRC are created if they do not exist in the restore-to library. If the restore operation creates the library, the new library is owned by the user running the RSTS36LIBM command and the library is created with a default authority of *ALL (that is, the same as AUT(*ALL)).
|
||
|
|
</p>
|
||
|
|
<p>If a sector-mode FROMLIBR file or a SAVELIBR file created on a System/36 is being restored, data files QS36LOD and QS36SBR may also be created to hold restored load and subroutine members. Restored load and subroutine members are not converted on the current system.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions</b>:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The following authorities are required when running on a system using resource security:
|
||
|
|
<ol>
|
||
|
|
<li>*SECADM and *ALLOBJ authorities
|
||
|
|
</li>
|
||
|
|
<li>*USE authority for this command and *USE authority for the Create Library (CRTLIB) command if the library needs to be created
|
||
|
|
</li>
|
||
|
|
<li>*USE authority for the CRTSRCPF command if QS36SRC or QS36PRC must be created
|
||
|
|
</li>
|
||
|
|
<li>*USE authority for the CRTPF command if QS36LOD or QS36SBR must be created
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE authority for the library specified in the TOLIB parameter
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE and *OBJMGMT authority for file QS36SRC in the specified library if restoring source library members
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE and *OBJMGMT authority for file QS36PRC in the specified library if restoring procedure library members
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE and *OBJMGMT authority for file QS36LOD in the specified library if restoring load library members
|
||
|
|
</li>
|
||
|
|
<li>*CHANGE and *OBJMGMT authority for file QS36SBR in the specified library if restoring subroutine library members
|
||
|
|
</li>
|
||
|
|
<li>*USE authority for the diskette device description object, *USE authority for device file QSYSDKT in library QSYS if restoring from diskette
|
||
|
|
</li>
|
||
|
|
<li>*USE authority for the tape device description object and *USE authority for device file QSYSTAP in library QSYS, if 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>
|
||
|
|
</ol>
|
||
|
|
</li>
|
||
|
|
<li>No object-level or record-level operations should be active for files QS36SRC, QS36PRC, QS36SBR, and QS36LOD while members are being restored by RSTS36LIBM. If the necessary files cannot be allocated exclusively, no members are restored.
|
||
|
|
</li>
|
||
|
|
<li>The member name or generic member name specified (TOMBR parameter) must meet AS/400 system naming standards.
|
||
|
|
<p>If a generic member name or *ALL is specified, a member may be selected to be restored that has a name containing characters not allowed in an AS/400 system <i>simple</i> object name. In this case, the member name is restored using the AS/400 system <i>extended</i> name syntax (for example, A!B would become ''A!B'').
|
||
|
|
</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<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'-'3F' or hexadecimal 'FF'), these characters are replaced by underlines and the member is restored using the resulting simple or extended name (for example, A*/? would become A_/_ and A? would become A_).
|
||
|
|
</p>
|
||
|
|
<p>An informational message is sent each time invalid characters are replaced to get a valid name. An additional informational message is sent if the resulting name change caused a member to be replaced. No message is sent if a member is restored using the extended name syntax without replacing invalid characters.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RSTS36LIBM.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="#RSTS36LIBM.TOMBR"><b>TOMBR</b></a></td>
|
||
|
|
<td valign="top">To member</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.SRCMBRS"><b>SRCMBRS</b></a></td>
|
||
|
|
<td valign="top">S/36 source members</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *SRC, *PRC, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTS36LIBM.MBROPT"><b>MBROPT</b></a></td>
|
||
|
|
<td valign="top">Data base member option</td>
|
||
|
|
<td valign="top"><b><u>*NEW</u></b>, *OLD, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.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="#RSTS36LIBM.OBJMBRS"><b>OBJMBRS</b></a></td>
|
||
|
|
<td valign="top">S/36 object members</td>
|
||
|
|
<td valign="top"><b><u>*NONE</u></b>, *SBR, *LOD, *ALL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RSTS36LIBM.TOMBR"></a>
|
||
|
|
<h3>To member (TOMBR)</h3>
|
||
|
|
<p>Specifies the names of the members to restore.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All members of the specified member types are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>member-name</i></b></dt>
|
||
|
|
<dd>The members having the specified member name are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-member-name</i></b></dt>
|
||
|
|
<dd>All members that have the specified generic member name are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.TOLIB"></a>
|
||
|
|
<h3>To library (TOLIB)</h3>
|
||
|
|
<p>Specifies the library to contain the members to restore from the input file.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.DEV"></a>
|
||
|
|
<h3>Device (DEV)</h3>
|
||
|
|
<p>Specifies the names of the devices to use for the restore operation. A maximum of four device names may be specified.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PHYFILE</b></dt>
|
||
|
|
<dd>The input file is the database physical file 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 to be used for the restore operation. If more than one tape device is used, specify 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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.SRCMBRS"></a>
|
||
|
|
<h3>S/36 source members (SRCMBRS)</h3>
|
||
|
|
<p>Specifies which source member types (source and procedure members on System/36) are restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Restore all source and procedure members in the input file that match the member name specified on the <b>To member</b> prompt (TOMBR parameter).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SRC</b></dt>
|
||
|
|
<dd>Restore only System/36 source members (to file QS36SRC) that match the member name specified on the <b>To member</b> prompt (TOMBR parameter).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRC</b></dt>
|
||
|
|
<dd>Restore only System/36 OCL procedure members (to file QS36PRC) that match the member name specified on the <b>To member</b> prompt (TOMBR parameter).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Do not restore any System/36 source or procedure library members.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.MBROPT"></a>
|
||
|
|
<h3>Data base member option (MBROPT)</h3>
|
||
|
|
<p>Specifies, for database files currently on the system, which file members are restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NEW</u></b></dt>
|
||
|
|
<dd>Only new members (members that don't already exist in the appropriate file) are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OLD</b></dt>
|
||
|
|
<dd>Only old members (members that already exist in the appropriate file) are restored. The existing member is replaced by the copy of the member restored from the file.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All members are restored. Members that don't already exist are created, and members that do exist are replaced.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.IGCDTA"></a>
|
||
|
|
<h3>User specified DBCS data (IGCDTA)</h3>
|
||
|
|
<p>Specifies whether the source and procedure members being restored can contain double-byte character set (DBCS) data. This attribute is used if the restore operation needs to create source files QS36SRC and QS36PRC to hold the restored library members.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If the QS36SRC or QS36PRC source file already exists in the library specified on the <b>To library</b> prompt (TOLIB parameter) and the file's DBCS capability does not match this parameter, an error message is sent and no members are restored.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The source or procedure members being restored cannot contain double-byte character set data.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The source or procedure members being restored can contain double-byte character set data.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.FROMLABEL"></a>
|
||
|
|
<h3>File label (FROMLABEL)</h3>
|
||
|
|
<p>Specifies the label value (eight characters maximum) of the diskette or tape file that contains the members to be restored. If *PHYFILE is not specified for the <b>Device</b> prompt (DEV parameter), a value must be specified here.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.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 operation. If the specified file does not exist or is not a physical file, no library members are restored. 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="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RSTS36LIBM.OBJMBRS"></a>
|
||
|
|
<h3>S/36 object members (OBJMBRS)</h3>
|
||
|
|
<p>Specifies which object member types (load and subroutine members on System/36) are restored. Because the System/36 and the AS/400 system are not object compatible, any restored members are not immediately useable after the restore operation. IBM-supplied commands or user-written operations must be run to convert the object member to a useable AS/400 system object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>System/36 load or subroutine library members are not restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SBR</b></dt>
|
||
|
|
<dd>Only System/36 subroutine members (to file QS36SBR) that match the member name specified on the <b>To member</b> prompt (TOMBR parameter) are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LOD</b></dt>
|
||
|
|
<dd>Only System/36 load members (to file QS36LOD) that match the member name specified on the <b>To member</b> prompt (TOMBR parameter) are restored.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All load and subroutine members in the input file that match the member name specified on the <b>To member</b> prompt (TOMBR parameter) are restored.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTS36LIBM.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Restoring All Members</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTS36LIBM TOMBR(XYZ1) TOLIB(JOHNSON) DEV(I1)
|
||
|
|
SRCMBRS(*PRC) MBROPT(*ALL) FROMLABEL('XYZ1')
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command restores the single OCL procedure member XYZ1 as a member of source file QS36PRC in library JOHNSON. Assuming I1 refers to a diskette device, the input diskette file must have the label XYZ1.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Restoring Members from a File</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RSTS36LIBM TOMBR(X*) TOLIB(ORDER) DEV(*PHYFILE)
|
||
|
|
PHYFILE(NETLIB/S36SRC)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command restores all source and procedure members with names starting with the character 'X' and that do not already exist as members of QS36SRC and QS36PRC in library ORDER. The members are restored from file S36SRC in library NETLIB.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RSTS36LIBM.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>CPF2C41</b></dt>
|
||
|
|
<dd>&2 members restored, &3 members not restored, &4 members excluded.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2C42</b></dt>
|
||
|
|
<dd>No members restored to library &1, &4 members excluded.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2C46</b></dt>
|
||
|
|
<dd>Input file &1 cannot be processed by RSTS36LIBM.
|
||
|
|
</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>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>CPF2C57</b></dt>
|
||
|
|
<dd>DBCS attribute not same as existing file &1 in &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2C70</b></dt>
|
||
|
|
<dd>Input file &1 contains incorrect control statement record.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2C71</b></dt>
|
||
|
|
<dd>NAME keyword on COPY statement missing or incorrect.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2C72</b></dt>
|
||
|
|
<dd>LIBRARY keyword on COPY statement missing or incorrect.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9807</b></dt>
|
||
|
|
<dd>One or more libraries in library list deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9808</b></dt>
|
||
|
|
<dd>Cannot allocate one or more libraries on library list.
|
||
|
|
</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>CPF9824</b></dt>
|
||
|
|
<dd>Not authorized to command &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>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>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>CPI2C12</b></dt>
|
||
|
|
<dd>Copying file &1 in library &2 label &3 to work file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RSTS36LIBM.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|