764 lines
32 KiB
HTML
764 lines
32 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 Licensed Program (RSTLICPGM)</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="RSTLICPGM.Top_Of_Page"></a>
|
|
<h2>Restore Licensed Program (RSTLICPGM)</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="#RSTLICPGM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RSTLICPGM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RSTLICPGM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RSTLICPGM"></a>
|
|
<p>The Restore Licensed Program (RSTLICPGM) command loads or restores a licensed program for initial installation, for new-release installation, or for recovery.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command is shipped with public *EXCLUDE authority.
|
|
</li>
|
|
<li>To use this command, the user must have *SECADM and *ALLOBJ authority.
|
|
</li>
|
|
<li>If this command is used to restore a program in the licensed program, the copy of the program currently in the system should not be running while the program is being restored. If this occurs, the processing program is ended abnormally.
|
|
</li>
|
|
<li>If other objects of the licensed program are in use, they are not restored.
|
|
</li>
|
|
<li>With the exception of overrides for the restore operation printing OUTPUT(*PRINT), this command ignores all file overrides currently in effect for the job.
|
|
</li>
|
|
<li>Some licensed programs are restored only if the user is enrolled in the system distribution directory. See the publications for each licensed program for a description of this restriction.
|
|
</li>
|
|
<li>This command does not restore code and language objects for the base operating system.
|
|
</li>
|
|
<li>This command does not support the use of user ASPs (auxiliary storage pools). All objects supplied by a licensed program must remain in the system ASP.
|
|
</li>
|
|
<li>At most one optical device, one save file, one virtual tape device or one tape media library device can be specified.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RSTLICPGM.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="#RSTLICPGM.LICPGM"><b>LICPGM</b></a></td>
|
|
<td valign="top">Product</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top">Single values: *SAVF<br>Other values (up to 4 repetitions): <i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Optional part to be restored</td>
|
|
<td valign="top"><b><u>*BASE</u></b>, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 01, 02, 03, 04, 05, 06, 07, 08, 09</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.RSTOBJ"><b>RSTOBJ</b></a></td>
|
|
<td valign="top">Type of object to be restored</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *PGM, *LNG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.LNG"><b>LNG</b></a></td>
|
|
<td valign="top">Language for licensed program</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*PRIMARY</u></b>, *SAVVOL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.RLS"><b>RLS</b></a></td>
|
|
<td valign="top">Release</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.REPLACERLS"><b>REPLACERLS</b></a></td>
|
|
<td valign="top">Replace release</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.VOL"><b>VOL</b></a></td>
|
|
<td valign="top">Volume identifier</td>
|
|
<td valign="top">Single values: <b><u>*MOUNTED</u></b><br>Other values (up to 75 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.SEQNBR"><b>SEQNBR</b></a></td>
|
|
<td valign="top">Sequence number</td>
|
|
<td valign="top">1-16777215, <b><u>*SEARCH</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.ENDOPT"><b>ENDOPT</b></a></td>
|
|
<td valign="top">End of media 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="#RSTLICPGM.SAVF"><b>SAVF</b></a></td>
|
|
<td valign="top">Save 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: Save 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" rowspan="12"><a href="#RSTLICPGM.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="12">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Library 1</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Library 2</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Library 3</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 4: Library 4</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 5: Library 5</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 6: Library 6</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 7: Library 7</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 8: Library 8</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 9: Library 9</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 10: Library 10</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 11: Library 11</td>
|
|
<td valign="top">
|
|
<i>Name</i>, <b><u>*SAME</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.LNGLIB"><b>LNGLIB</b></a></td>
|
|
<td valign="top">Language library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.FLR"><b>FLR</b></a></td>
|
|
<td valign="top">Folder</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.CODHOMEDIR"><b>CODHOMEDIR</b></a></td>
|
|
<td valign="top">Code home directory</td>
|
|
<td valign="top">Single values: *PROMPT<br>Other values (up to 300 repetitions): <i>Path name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RSTLICPGM.LNGHOMEDIR"><b>LNGHOMEDIR</b></a></td>
|
|
<td valign="top">Language home directory</td>
|
|
<td valign="top">Single values: *PROMPT<br>Other values (up to 300 repetitions): <i>Path name</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RSTLICPGM.FRCOBJCVN"><b>FRCOBJCVN</b></a></td>
|
|
<td valign="top">Force object conversion</td>
|
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *NO<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Convert during restore</td>
|
|
<td valign="top">
|
|
<b><u>*YES</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Objects to convert</td>
|
|
<td valign="top">
|
|
<b><u>*RQD</u></b>, *ALL</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RSTLICPGM.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the seven-character identifier of the licensed program that is restored.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device used for the restore of the licensed program. The device name must already be known on the system by a device description. Use the Work with Device Descriptions (WRKDEVD) command to display the names of the devices available on this system.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*SAVF</b></dt>
|
|
<dd>The restore operation is done using the save file name specified on the save file (SAVF) parameter.
|
|
</dd>
|
|
<dt><b><i>optical-device-name</i></b></dt>
|
|
<dd>Specify the name of the optical device used for the restore operation.
|
|
</dd>
|
|
<dt><b><i>tape-media-library-device-name</i></b></dt>
|
|
<dd>Specify the name of the tape media library device used for the restore operation.
|
|
</dd>
|
|
<dt><b><i>tape-device-name</i></b></dt>
|
|
<dd>Specify the name of one or more tape devices to use to restore the licensed program. If a virtual tape device is used, it must be the only device specified. If multiple tape devices are used, they must have compatible media formats and their names must be specified in the order in which they are used. Using more than one tape device permits one tape volume to be rewound and unloaded while another tape device processes the next tape volume.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.OPTION"></a>
|
|
<h3>Optional part to be restored (OPTION)</h3>
|
|
<p>Specifies which one of the optional parts of the licensed program given in the <b>Product</b> prompt (LICPGM parameter) is to be restored.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BASE</u></b></dt>
|
|
<dd>Only the base part of the licensed program is to be restored.
|
|
</dd>
|
|
<dt><b><i>number-of-licensed-program-option</i></b></dt>
|
|
<dd>Specify the number of the optional part of the listed licensed program that is to be restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.RSTOBJ"></a>
|
|
<h3>Type of object to be restored (RSTOBJ)</h3>
|
|
<p>Specifies the type of licensed program objects to be restored.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All of the objects for the licensed program are restored. This includes both program objects and the language objects specified on the <b>Language for licensed program</b> prompt (LNG parameter).
|
|
<p>If a tape device is specified on the DEV parameter, then the RSTOBJ(*ALL) value is used when the saving of the licensed program has been done with the SAVLICPGM command such that the language objects immediately follow the program objects on the tape media. If the language objects (*LNG) and programming objects (*PGM) are not in consecutive order on the distribution tape, *ALL cannot be used in most cases. Instead, the program and language objects must be restored separately. The DSPTAP command can be used to determine the order of the objects on the tape. An example of how to restore language and program objects separately is in the "Examples" section at the end of this command.
|
|
</p>
|
|
<p>If *SAVF is specified on the DEV parameter, then the RSTOBJ(*ALL) value can be used when the saving of the licensed program has been done with the SAVLICPGM command using OBJTYPE(*ALL).
|
|
</p>
|
|
</dd>
|
|
<dt><b>*PGM</b></dt>
|
|
<dd>Only the program objects for the licensed program are restored. *PGM should be used when restoring program objects from a distribution media where the program objects and selected language objects are not on the same distribution media or are not in consecutive order.
|
|
</dd>
|
|
<dt><b>*LNG</b></dt>
|
|
<dd>Only the language objects for a licensed program are restored. The <b>Language for licensed program</b> prompt (LNG parameter) determines if the objects are associated with the licensed program library or with a multilingual library.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.LNG"></a>
|
|
<h3>Language for licensed program (LNG)</h3>
|
|
<p>Specifies the national language version (NLV) to be used for restoring the licensed program. If the language feature of the licensed program on the save media matches the system language feature, the language objects are restored to the licensed program's libraries. If the language features do not match, the language objects are restored into the multilingual library for that language feature.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRIMARY</u></b></dt>
|
|
<dd>The language feature of the operating system is restored for the specified licensed program.
|
|
<p>
|
|
<b>Note: </b>Use GO LICPGM with option 20 to display the primary language of the operating system.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*SAVVOL</b></dt>
|
|
<dd>The language file on the mounted volume is to be restored for the licensed program. This option is not valid with DEV(*SAVF).
|
|
</dd>
|
|
<dt><b><i>feature-codes</i></b></dt>
|
|
<dd>Specify the NLV identifier for the language file that is to be restored for the licensed program. More information on feature identifications and a list of IBM-supplied feature codes is in the Install, upgrade, or delete i5/OS and related software book, SC41-5120.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether a listing that shows information about the status of the objects is created. The listing shows the parameter values that were specified and shows all objects, restored and not restored. Information about each object's security is listed for the restored objects.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No output is created.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.RLS"></a>
|
|
<h3>Release (RLS)</h3>
|
|
<p>Specifies the version, release, and modification level of the licensed program being restored.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first version, release, and modification level found on the distribution media is restored.
|
|
</dd>
|
|
<dt><b><i>release-level</i></b></dt>
|
|
<dd>Specify the release level in VxRyMz format, where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.REPLACERLS"></a>
|
|
<h3>Replace release (REPLACERLS)</h3>
|
|
<p>Specifies the version, release, and modification level of the licensed program being replaced.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>Replace only the version, release, and modification level of the licensed program currently installed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The licensed program currently installed on the system is not replaced. The licensed program being restored must be a different release than the one currently installed. If the licensed program being restored exists in the same libraries as the installed program, an override parameter must be specified indicating to which libraries the licensed program is restored.
|
|
</dd>
|
|
<dt><b><i>release-level</i></b></dt>
|
|
<dd>Specify the release level in VxRyMz format, where Vx is the version number, Ry is the release number, and Mz is the modification level. The variables x and y can be a number from 0 through 9, and the variable z can be a number from 0 through 9 or a letter from A through Z.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifiers of the media or the cartridge identifiers of tapes in a tape media library device, from which the objects are being restored. The volumes must be in the same order as they were when the data was saved. The volume that contains the beginning of the file to be restored should be placed in the device.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
|
<dd>The licensed program is restored from the volumes that are currently on the device specified on the <b>Device</b> prompt (DEV parameter). For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command.
|
|
<p>
|
|
<b>Note: </b>This value cannot be specified when using an optical media library device.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the identifiers of one or more volumes in the order they are put on the device and used to restore the licensed program. A maximum of 75 volume identifiers can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.SEQNBR"></a>
|
|
<h3>Sequence number (SEQNBR)</h3>
|
|
<p>Specifies which sequence number to use for the restore process. This option is only valid for tape devices.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SEARCH</u></b></dt>
|
|
<dd>The volume that is placed in the device is searched for a data file with an identifier that matches the label for the specified licensed program or licensed program option. When a match is found, the objects are restored. If the last operation on the device specified *LEAVE on the <b>End of media option</b> prompt (ENDOPT 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 media option</b> prompt (ENDOPT 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>file-sequence-number</i></b></dt>
|
|
<dd>Specify the sequence number of the file that is used for the restore process. Valid values range from 1 through 16777215.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.ENDOPT"></a>
|
|
<h3>End of media option (ENDOPT)</h3>
|
|
<p>Specifies the operation that is automatically done on the tape or optical volume after the restore operation ends. If more than one volume is used, this parameter applies only to the last volume used; all other volumes are unloaded when the end of the volume is reached.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified for the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*REWIND</u></b></dt>
|
|
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*LEAVE</b></dt>
|
|
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*UNLOAD</b></dt>
|
|
<dd>The tape is automatically rewound and unloaded after the operation ends. Some optical devices will eject the volume after the operation ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.SAVF"></a>
|
|
<h3>Save file (SAVF)</h3>
|
|
<p>Specifies the qualified name of the save file containing the product.
|
|
</p>
|
|
<p>The name of the save file can be qualified by one of the following library values:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library where the save file exists.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>save-file-name</i></b></dt>
|
|
<dd>Specify the name of the save file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the libraries into which the licensed program is being restored. This function is not supported by all licensed programs.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The licensed program is restored into the specified library.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the library into which the licensed program is being restored. A maximum of 11 libraries can be specified.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.LNGLIB"></a>
|
|
<h3>Language library (LNGLIB)</h3>
|
|
<p>Specifies the secondary language library into which the secondary language objects are restored. This function is not supported by all licensed programs.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The licensed program is restored into the specified secondary language library.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the name of the secondary language library into which the licensed program is restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.FLR"></a>
|
|
<h3>Folder (FLR)</h3>
|
|
<p>Specifies the name of the root folder into which the licensed program is being restored. This function is not supported by all licensed program.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>Use the specified root folder.
|
|
</dd>
|
|
<dt><b><i>folder-name</i></b></dt>
|
|
<dd>Specify the name of the root folder. The root folder is the folder on the system containing all of the other folders.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.CODHOMEDIR"></a>
|
|
<h3>Code home directory (CODHOMEDIR)</h3>
|
|
<p>Specifies the directories into which the code part of the product is being restored. This function is not supported by all products.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is mutually exclusive with the FLR parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The code part of the product is restored into the directories specified when packaged or already installed. *SAME may be specified as the only parameter value or within a list of directories. If used within a list, *SAME specifies that a particular directory is unchanged, though other directories may be different than when the product was packaged or previously installed.
|
|
</dd>
|
|
<dt><b>*PROMPT</b></dt>
|
|
<dd>The code directories to be used are displayed. If the product is not currently installed, the directory names can be changed.
|
|
</dd>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the home path directory name into which the code part of the product is being restored. Up to 300 directories may be specified. For directory name entries which are unchanged, *SAME can be specified for the path name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.LNGHOMEDIR"></a>
|
|
<h3>Language home directory (LNGHOMEDIR)</h3>
|
|
<p>Specifies the directories into which the language part of the product is being restored. This function is not supported by all products.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is mutually exclusive with the FLR parameter.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The language part of the product is restored into the directories specified when packaged or already installed. *SAME may be specified as the only parameter value or within a list of directories. If used within a list, *SAME specifies that a particular directory is unchanged, though other directories may be different than when the product was packaged or previously installed.
|
|
</dd>
|
|
<dt><b>*PROMPT</b></dt>
|
|
<dd>The language directories to be used are displayed. If the product is not currently installed, the directory names can be changed.
|
|
</dd>
|
|
<dt><b><i>path-name</i></b></dt>
|
|
<dd>Specify the home path directory name into which the language part of the product is being restored. Up to 300 directories may be specified. For directory name entries which are unchanged, *SAME can be specified for the path name.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RSTLICPGM.FRCOBJCVN"></a>
|
|
<h3>Force object conversion (FRCOBJCVN)</h3>
|
|
<p>Specifies whether to convert user objects to the format required for use in the current version of the operating system when the objects are restored.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This parameter 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 (because it is formatted for an earlier version of the operating system), but is not converted during this restore operation, the object is automatically converted the first time it is used.
|
|
</li>
|
|
</ol>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
|
<dd>The objects are converted based on the value of the QFRCCVNRST system value.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The objects are not converted during the restore operation.
|
|
<p>
|
|
<b>Note: </b>If FRCOBJCVN(*NO) is specified, then the QFRCCVNRST system value must have a value of either "0" or "1".
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Convert during restore</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The objects are converted during the restore operation.
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>If FRCOBJCVN(*YES *RQD) is specified, then the QFRCCVNRST system value must have a value of "0", "1", or "2". FRCOBJCVN(*YES *RQD) will override a QFRCCVNRST value of "0" or "1". If FRCOBJCVN(*YES *ALL) is specfied, then QFRCCVNRST can have any valid value and FRCOBJCVN(*YES *ALL) overrides the QFRCCVNRST system value.
|
|
</li>
|
|
<li>Specifying this value increases the time of the restore operation, but avoids the need to convert the objects when they are first used.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Objects to convert</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*RQD</u></b></dt>
|
|
<dd>The objects are converted only if they require conversion to be used by the current operating system. If the objects do not have all creation data (either observable or unobservable), the objects cannot be converted and will not be restored.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects are converted regardless of their current format, including objects already in the current format. However, if the objects do not have all creation data (either observable or unobservable), the objects cannot be converted and will not be restored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTLICPGM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Restoring Program Using Defaults</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLICPGM LICPGM(5722WDS) DEV(TAP01)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the WebSphere Development Studio (5722WDS) licensed program to the system. The tape containing the licensed program objects must be put on the TAP01 tape drive. Because no other parameters are specified, the defaults are used for the command.
|
|
</p>
|
|
<p><b>Example 2: Restoring a Third Version of a Product</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLICPGM LICPGM(1MYPROD) OPTION(*BASE)
|
|
DEV(TAP01) RLS(V5R2M0)
|
|
REPLACERLS(*NO) LIB(A B C)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the base part of the V5R2M0 1MYPROD product to the system if the base of the V5R2M0 1MYPROD product is not currently installed on the system.
|
|
</p>
|
|
<p><b>Example 3: Restoring One Version of a Product Over Another Version</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLICPGM LICPGM(2MYPROD) OPTION(*BASE)
|
|
DEV(TAP01) RLS(*FIRST)
|
|
REPLACERLS(*ONLY)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the first version release modification level of the base part of the 2MYPROD product that is found on the tape in the TAP01 drive. It does not matter if the version release modification level of the base of the product on the tape matches the version release modification level of the base of the product on the system.
|
|
</p>
|
|
<p><b>Example 4: Restoring Product From Save File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLICPGM LICPGM(5722WDS) DEV(*SAVF) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the WebSphere Development Studio (5722WDS) licensed program to the system from the save file MYSAVF in MYLIB. Because no other parameters are specified, the defaults are used for the command.
|
|
</p>
|
|
<p><b>Example 5: Restoring a Third Version of a Product From a Save File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
RSTLICPGM LICPGM(1MYPROD) OPTION(*BASE)
|
|
DEV(*SAVF) RLS(V5R2M0)
|
|
REPLACERLS(*NO) LIB(A B C) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>This command restores the base part of the V5R2M0 1MYPROD product to the system from save file MYSAVF in MYLIB if the base of the V5R2M0 1MYPROD product is not currently installed on the system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RSTLICPGM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF3D94</b></dt>
|
|
<dd>No product found in save file.
|
|
</dd>
|
|
<dt><b>CPF3D96</b></dt>
|
|
<dd>Objects for product &1 option &2 release &4 not restored.
|
|
</dd>
|
|
<dt><b>CPF37A2</b></dt>
|
|
<dd>Installation cannot be performed.
|
|
</dd>
|
|
<dt><b>CPF3728</b></dt>
|
|
<dd>Device &1 specified with other devices.
|
|
</dd>
|
|
<dt><b>CPF3733</b></dt>
|
|
<dd>&2 &1 in &3 previously damaged.
|
|
</dd>
|
|
<dt><b>CPF3739</b></dt>
|
|
<dd>Database file &1 member in &3 damaged.
|
|
</dd>
|
|
<dt><b>CPF3820</b></dt>
|
|
<dd>&4 objects for &1 option &2 not restored.
|
|
</dd>
|
|
<dt><b>CPF3880</b></dt>
|
|
<dd>No language objects exist.
|
|
</dd>
|
|
<dt><b>CPF3884</b></dt>
|
|
<dd>Licensed program &1 option &2 not processed.
|
|
</dd>
|
|
<dt><b>CPI36C9</b></dt>
|
|
<dd>Error occurred while removing PTFs.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RSTLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|