643 lines
26 KiB
HTML
643 lines
26 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Save Licensed Program (SAVLICPGM)</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="SAVLICPGM.Top_Of_Page"></a>
|
|
<h2>Save Licensed Program (SAVLICPGM)</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="#SAVLICPGM.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SAVLICPGM.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SAVLICPGM.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SAVLICPGM"></a>
|
|
<p>The Save Licensed Program (SAVLICPGM) command saves a copy of all of the objects that make up a licensed program. It saves the licensed program in a form that can be restored by the Restore Licensed Program (RSTLICPGM) command.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>To use this command, you must have *ALLOBJ authority or have specific authority from the security officer.
|
|
</li>
|
|
<li>A standard labeled tape volume must be on the tape device.
|
|
</li>
|
|
<li>Some licensed programs can only be saved if the user is enrolled in the system distribution directory. See the publication for each licensed program for a description of this restriction.
|
|
</li>
|
|
<li>This command does not save code or language objects for the base operating system.
|
|
</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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SAVLICPGM.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="#SAVLICPGM.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="#SAVLICPGM.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="#SAVLICPGM.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Optional part to be saved</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="#SAVLICPGM.RLS"><b>RLS</b></a></td>
|
|
<td valign="top">Release</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ONLY</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.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>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *PGM, *LNG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.CHKSIG"><b>CHKSIG</b></a></td>
|
|
<td valign="top">Check signature</td>
|
|
<td valign="top"><b><u>*SIGNED</u></b>, *ALL, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.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="#SAVLICPGM.SEQNBR"><b>SEQNBR</b></a></td>
|
|
<td valign="top">Sequence number</td>
|
|
<td valign="top">1-16777215, <b><u>*END</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.EXPDATE"><b>EXPDATE</b></a></td>
|
|
<td valign="top">File expiration date</td>
|
|
<td valign="top"><i>Date</i>, <b><u>*PERM</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.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="#SAVLICPGM.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"><a href="#SAVLICPGM.TGTRLS"><b>TGTRLS</b></a></td>
|
|
<td valign="top">Target release</td>
|
|
<td valign="top"><b><u>*CURRENT</u></b>, *PRV, V5R2M0, V5R3M0, V5R4M0</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.CLEAR"><b>CLEAR</b></a></td>
|
|
<td valign="top">Clear</td>
|
|
<td valign="top"><b><u>*NONE</u></b>, *ALL, *AFTER, *REPLACE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.DTACPR"><b>DTACPR</b></a></td>
|
|
<td valign="top">Data compression</td>
|
|
<td valign="top"><b><u>*DEV</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#SAVLICPGM.LICACPRQD"><b>LICACPRQD</b></a></td>
|
|
<td valign="top">License acceptance required</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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SAVLICPGM.LICPGM"></a>
|
|
<h3>Product (LICPGM)</h3>
|
|
<p>Specifies the seven-character identifier of the licensed program that is saved.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the names of the tape or optical devices used for the save licensed program operation. Each 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 product is saved in the save file 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 to be used for the save 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 save operation.
|
|
</dd>
|
|
<dt><b><i>tape-device-name</i></b></dt>
|
|
<dd>Specify the name of one or more tape devices to use for the save operation. 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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.OPTION"></a>
|
|
<h3>Optional part to be saved (OPTION)</h3>
|
|
<p>Specifies the optional parts of the licensed program given in the <b>Product</b> prompt (LICPGM parameter) that are saved.
|
|
</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 saved.
|
|
</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 saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.RLS"></a>
|
|
<h3>Release (RLS)</h3>
|
|
<p>Specifies which version, release, and modification level of the licensed program is saved.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ONLY</u></b></dt>
|
|
<dd>Only one version, release, and modification level is installed for the licensed program option.
|
|
</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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.LNG"></a>
|
|
<h3>Language for licensed program (LNG)</h3>
|
|
<p>Specifies which national language version (NLV) is used for the save operation.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This parameter is ignored when OBJTYPE(*PGM) is specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRIMARY</u></b></dt>
|
|
<dd>The primary language is saved. The primary language is the language of the operating system.
|
|
<p>
|
|
<b>Note: </b>Use GO LICPGM with option 20 to display the primary language of the operating system.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All languages are saved.
|
|
</dd>
|
|
<dt><b><i>feature-code</i></b></dt>
|
|
<dd>Specify the NLV identifier for the language that is saved for the licensed program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the type of licensed program objects being saved.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Program and language objects specified on the LNG parameter are saved.
|
|
</dd>
|
|
<dt><b>*PGM</b></dt>
|
|
<dd>Only the program objects for the licensed program are saved.
|
|
</dd>
|
|
<dt><b>*LNG</b></dt>
|
|
<dd>The objects associated with the NLV identified on the LNG parameter are saved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.CHKSIG"></a>
|
|
<h3>Check signature (CHKSIG)</h3>
|
|
<p>Specifies if the digital signatures of objects being saved with the licensed program are to be checked.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SIGNED</u></b></dt>
|
|
<dd>Objects with digital signatures are checked. Objects that are not digitally signed will not have their signatures verified. Any signed object with a signature that is not valid will be identified in a message in the job log and the save will fail.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All objects that can be digitally signed are checked. Any object that can be signed but has no signature will be identified in a message in the job log. The save will not be terminated for unsigned objects. Any signed object with an invalid digital signature will be identified in a message in the job log and the save will fail.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Digital signatures of objects will not be checked.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.VOL"></a>
|
|
<h3>Volume identifier (VOL)</h3>
|
|
<p>Specifies the volume identifiers of the tape volumes on which the licensed program data is saved. The volumes must be placed in the same order as the volume identifiers are specified on this parameter. Up to 75 entries can be specified.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MOUNTED</u></b></dt>
|
|
<dd>The volume currently placed in the device is used.
|
|
</dd>
|
|
</dl>
|
|
<p>For a media library device, the volume to be used is the next cartridge in the the category mounted by the Set Tape Category (SETTAPCGY) command.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This value cannot be specified when using an optical media library device.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>volume-identifier</i></b></dt>
|
|
<dd>Specify the identifiers of one or more volumes in the order in which they are placed in the device and used to save the licensed program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.SEQNBR"></a>
|
|
<h3>Sequence number (SEQNBR)</h3>
|
|
<p>Specifies, when tape is used, the sequence number to use as the starting point for the save operation.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*END</u></b></dt>
|
|
<dd>The save operation begins after the last sequence number on the first tape. If the first tape is full, an error message is issued and the operation ends.
|
|
</dd>
|
|
<dt><b><i>1-16777215</i></b></dt>
|
|
<dd>Specify the sequence number of the file to be used for the save operation.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.EXPDATE"></a>
|
|
<h3>File expiration date (EXPDATE)</h3>
|
|
<p>Specifies the expiration date of the tape created by the save operation. If a date is specified, the file is protected and cannot be overwritten until the specified expiration date.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PERM</u></b></dt>
|
|
<dd>The file is protected permanently.
|
|
</dd>
|
|
<dt><b><i>date</i></b></dt>
|
|
<dd>Specify the date when protection for the file ends.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.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 save 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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.SAVF"></a>
|
|
<h3>Save file (SAVF)</h3>
|
|
<p>Specifies the qualified name of the existing save file to which the product is saved. The save file must be empty, unless *ALL is specified on the Clear prompt (CLEAR parameter).
|
|
</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 is located.
|
|
</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="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.TGTRLS"></a>
|
|
<h3>Target release (TGTRLS)</h3>
|
|
<p>Specifies the release level of the operating system on which you intend to restore and use the product. In the examples given for the *CURRENT and *PRV values, and when specifying the <b>target-release</b> value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V4R1M0 is version 4 release 1 modification level 0.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This value is limited by the minimum operating system release specified when the product was created.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
|
<dd>The product is to be restored to, and used on, the release of the operating system currently running on your system. The product can also be restored to a system with any subsequent release of the operating system installed.
|
|
</dd>
|
|
<dt><b>*PRV</b></dt>
|
|
<dd>The product is to be restored to the previous release with modification level 0 of the operating system. The product can also be restored to a system with any subsequent release of the operating system installed.
|
|
</dd>
|
|
<dt><b><i>target-release</i></b></dt>
|
|
<dd>Specify the release in the format VxRxMx. The product can be restored to a system with the specified release or with any subsequent release of the operating system installed.
|
|
<p>Valid values depend on the current version, release, and modification level, and they change with each new release. Press F4 to see a list of valid target release values.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.CLEAR"></a>
|
|
<h3>Clear (CLEAR)</h3>
|
|
<p>Specifies whether active data on the media is automatically cleared or replaced. Active data is any file on the media that has not expired. For saves to tape, clearing active data will make any files on the tape volume beyond the last file written by the save operation no longer accessible. For saves to optical, the files written by the save operation can be automatically replaced while other files on the volume remain active, or all active files can be automatically cleared. Clearing does not erase the data, it just makes the files no longer accessible.
|
|
</p>
|
|
<p><b>Notes:</b>
|
|
</p>
|
|
<ol>
|
|
<li>Clearing a tape does not initialize it. You should initialize tapes to a standard label format before the save command is issued by using the Initialize Tape (INZTAP) command and specifying a value for the NEWVOL parameter.
|
|
</li>
|
|
<li>Clearing an optical volume does initialize it.
|
|
</li>
|
|
<li>If a volume that is not initialized is encountered during the save operation, an inquiry message is sent and an operator can initialize the volume.
|
|
</li>
|
|
</ol>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>None of the media is automatically cleared. If the save operation encounters active data on a tape volume or in a save file, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All of the media is automatically cleared.
|
|
</dd>
|
|
</dl>
|
|
<p>If tapes are used and a sequence number is specified for the SEQNBR parameter, the first tape is cleared beginning at that sequence number. All tapes following that first tape are completely cleared. To clear the entire first tape, SEQNBR(1) must be specified.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*AFTER</b></dt>
|
|
<dd>All media after the first volume is automatically cleared. If the save operation encounters active data on the first tape volume, an inquiry message is sent, allowing the operator to either end the save operation or clear the media. If the save operation encounters the specified optical file on the first volume, an inquiry message is sent, allowing the operator to either end the save operation or replace the file.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b></b></dt>
|
|
<dd>
|
|
<p>
|
|
<b>Note: </b>The *AFTER value is not valid for save files.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*REPLACE</b></dt>
|
|
<dd>Active data on the media is automatically replaced. Optical volumes are not initialized. Other media is automatically cleared in the same way as the *ALL value.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.DTACPR"></a>
|
|
<h3>Data compression (DTACPR)</h3>
|
|
<p>Specifies whether data compression is used.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><u>*DEV</u></b></dt>
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. Otherwise, no data compression is performed.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No data compression is performed.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>If the save is to tape and the target device supports compression, hardware compression is performed. If compression is not supported, or if the save data is written to a diskette or save file, software compression is performed. If the save is running while other jobs on the system are active and software compression is used, the overall system performance may be affected.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SAVLICPGM.LICACPRQD"></a>
|
|
<h3>License acceptance required (LICACPRQD)</h3>
|
|
<p>Specifies whether or not the user will be prompted for license acceptance when the saved licensed program is restored. If the licensed program being saved does not have online software agreements, no prompt will be done at restore time. This parameter does not affect the license acceptance status of the licensed program currently installed.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>License acceptance will not be required when the saved licensed program is restored.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>License acceptance will be required when the saved licensed program is restored, if the licensed program being saved has online software agreements.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVLICPGM.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Tapes Cleared Automatically</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(5722WDS) DEV(TAP01) CLEAR(*ALL)
|
|
</pre>
|
|
</p>
|
|
<p>This command saves the *BASE option of the WebSphere Development Studio licensed program (5722WDS). It is saved on the tape that is in the TAP01 tape drive. Each uncleared tape is cleared automatically when it is encountered, and the save operation continues without operator intervention.
|
|
</p>
|
|
<p><b>Example 2: Saving on Labeled Tape Volume</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(5722WDS) DEV(TAP01) VOL(ABCDE)
|
|
</pre>
|
|
</p>
|
|
<p>The *BASE option of the WebSphere Development Studio licensed program (5722WDS) is saved on the TAP01 tape drive, starting on the tape volume labeled ABCDE. If the save operation exceeds the storage capacity of one tape, a message requesting that another volume be placed in the TAP01 tape drive is shown to the operator.
|
|
</p>
|
|
<p><b>Example 3: Saving on Multiple Volumes</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(5722SS1) OPTION(2) DEV(TAP01 TAP02)
|
|
</pre>
|
|
</p>
|
|
<p>The online help option of the i5/OS licensed program (5722SS1) is saved on tape drives TAP01 and TAP02 in alternating order. If the save operation exceeds the storage capacity of two tapes, a message requesting that another volume be put on TAP01 is shown to the operator. The tapes are rewound at the completion of the save operation.
|
|
</p>
|
|
<p><b>Example 4: Saving to Save Files Cleared Automatically</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(5722WDS) DEV(*SAVF)
|
|
CLEAR(*ALL) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>This command saves the base option of the WebSphere Development Studio licensed program (5722WDS). It is saved to the save file MYSAVF in the library MYLIB. The save file MYSAVF is cleared automatically and the save operation continues without operator intervention.
|
|
</p>
|
|
<p><b>Example 5: Saving program objects to a save file</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(1MYPROD) OPTION(*BASE)
|
|
DEV(*SAVF) RLS(*ONLY)
|
|
OBJTYPE(*PGM) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>The 1MYPROD product consists of two libraries and does not have any folders. Only the program objects for 1MYPROD product will be saved in the save file, MYSAVF, in MYLIB library.
|
|
</p>
|
|
<p><b>Example 6: Saving all objects in one library to a save file</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(1MYPROD) OPTION(*BASE)
|
|
DEV(*SAVF) RLS(*ONLY)
|
|
LNG(2924) OBJTYPE(*ALL) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>The 1MYPROD product consists of only one library and does not have any folders. The program objects and language objects for the NLV 2924 of 1MYPROD product will be saved in the save file, MYSAVF, in MYLIB library.
|
|
</p>
|
|
<p><b>Example 7: Saving all objects in two libraries to a save file</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(1MYPROD) OPTION(*BASE)
|
|
DEV(*SAVF) RLS(*ONLY)
|
|
LNG(2924) OBJTYPE(*ALL) SAVF(MYLIB/MYSAVF)
|
|
</pre>
|
|
</p>
|
|
<p>The 1MYPROD product consists of two libraries and has one root folder with the *PGM objects, and one subfolder of that root folder with the *LNG objects. The program objects and language objects for the NLV 2924 of 1MYPROD product will be saved in the save file, MYSAVF, in MYLIB library.
|
|
</p>
|
|
<p><b>Example 8: Saving for a previous release.</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SAVLICPGM LICPGM(1MYPROD) DEV(TAP01) TGTRLS(*PRV)
|
|
</pre>
|
|
</p>
|
|
<p>The 1MYPROD product will be saved to TAP01 and may be restored on a system with the previous release of the operating system installed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SAVLICPGM.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<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>CPF3884</b></dt>
|
|
<dd>Licensed program &1 option &2 not processed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SAVLICPGM.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|