friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/insptf.htm

453 lines
17 KiB
HTML
Raw Permalink Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Install Program Temporary Fix (INSPTF)</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="INSPTF.Top_Of_Page"></a>
<h2>Install Program Temporary Fix (INSPTF)</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="#INSPTF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#INSPTF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#INSPTF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="INSPTF"></a>
<p>The Install Program Temporary Fix (INSPTF) command allows the user to load and apply PTFs for multiple products with a single command. PTF groups will be copied to the system when they do not already exist on the system or when the level of the PTF group on the media is higher than the level of the PTF group that exists on the system. If LICPGM(*ALL) is specified, any special handling PTFs listed in PTF groups on the media will be used during the install.
</p>
<p>The OMIT and HIPER parameters are supplied to allow the user of the INSPTF command to be more selective. These parameters apply only to the PTF loading activity. Any PTF already loaded on the system will be applied.
</p>
<p>The INSTYP parameter controls the apply of the PTFs. Using the different special values allows immediate and delayed apply combinations as well as starting an IPL.
</p>
<p>INSPTF does not support loading PTFs from tape for products that have multiple releases of the base option installed on the system. If PTFs for such a product exist on the tape, the INSPTF will not load those PTFs and will return an error.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="INSPTF.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" rowspan="3"><a href="#INSPTF.LICPGM"><b>LICPGM</b></a></td>
<td valign="top">Product description</td>
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: Product</td>
<td valign="top">
<i>Character value</i>, *ALL</td>
</tr>
<tr>
<td valign="top">Element 2: Release</td>
<td valign="top">
<i>Character value</i>, <b><u>*ONLY</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top"><i>Name</i>, <b><u>*SERVICE</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.INSTYP"><b>INSTYP</b></a></td>
<td valign="top">PTF apply type</td>
<td valign="top"><b><u>*SRVATT</u></b>, *DLYIPL, *DLYALL, *IMMONLY, *IMMDLY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#INSPTF.OMIT"><b>OMIT</b></a></td>
<td valign="top">PTF omit list</td>
<td valign="top">Values (up to 50 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Product</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: PTF identifier</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 3: Release</td>
<td valign="top">
<i>Character value</i>, <b><u>*ONLY</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.HIPER"><b>HIPER</b></a></td>
<td valign="top">HIPER PTFs only</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.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"><a href="#INSPTF.RESTART"><b>RESTART</b></a></td>
<td valign="top">Restart type</td>
<td valign="top"><b><u>*IPLA</u></b>, *SYS, *FULL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.PMTMED"><b>PMTMED</b></a></td>
<td valign="top">Prompt for media</td>
<td valign="top"><b><u>*SNGVOLSET</u></b>, *MLTVOLSET, *MLTSRV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#INSPTF.CPYPTF"><b>CPYPTF</b></a></td>
<td valign="top">Copy PTFs</td>
<td valign="top"><b><u>*SRVATT</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="INSPTF.LICPGM"></a>
<h3>Product description (LICPGM)</h3>
<p>Specifies the product ID, version, release, and modification level of the products for which PTFs should be installed.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>The available PTFs for all installed products are installed. This must be the first and only value if specified. All values specified after it are ignored.
</dd>
</dl>
<p>The possible Licensed Program value is:
</p>
<dl>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify the product ID of the PTFs to be installed. A maximum of 300 product IDs can be specified.
</dd>
</dl>
<p>The possible Release Level of the Licensed Program values are:
</p>
<dl>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level of the base product option in the format VxRyMz, where Vx is the version number, Ry is the release number, and Mz is the modification level.
</dd>
<dt><b>*ONLY</b></dt>
<dd>This value is valid only when one release of the product's base option is installed on the system. PTFs for all installed options of the product are loaded and applied regardless of the release-level of the option.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the device from which the PTFs are loaded. The device name must already be known on the system by a device description.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SERVICE</u></b></dt>
<dd>The PTFs sent from the service support system are installed.
</dd>
<dt><b>*NONE</b></dt>
<dd>No PTFs are loaded. Any PTF already loaded on the system will be applied. This special value is used after the IPL following an incomplete PTF install. Special handling PTFs in a PTF group being installed must be applied and active before the remaining PTFs in the PTF group can be applied.
</dd>
<dt><b><i>tape-device-name</i></b></dt>
<dd>Specify the name of the tape device from which the PTFs are installed.
</dd>
<dt><b><i>optical-device-name</i></b></dt>
<dd>Specify the name of the optical device from which the PTFs are installed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.INSTYP"></a>
<h3>PTF apply type (INSTYP)</h3>
<p>Specifies the type of install to perform.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SRVATT</u></b></dt>
<dd>The type of install depends on the service attribute setting.
<p><b>Attention:</b>
</p>
<p>The service attribute is shipped with *DLYIPL as the default. Use the Change Service Attributes (CHGSRVA) command to change the default.
</p>
</dd>
<dt><b>*DLYIPL</b></dt>
<dd>All PTFs are marked for delayed apply and an initial program load (IPL) is done on the system.
</dd>
<dt><b>*DLYALL</b></dt>
<dd>All PTFs are marked for delayed apply and an initial program load (IPL) is not done on the system.
</dd>
<dt><b>*IMMDLY</b></dt>
<dd>The immediate PTFs are applied and the delayed PTFs are marked for apply at the next initial program load (IPL).
</dd>
<dt><b>*IMMONLY</b></dt>
<dd>All PTFs are loaded, but only the immediate PTFs are applied and an initial program load (IPL) is not done on the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.OMIT"></a>
<h3>PTF omit list (OMIT)</h3>
<p>Specifies the product ID, version, release, modification level, and PTF ID for PTFs that should not be loaded. The current state of the PTF is not checked before being passed to LODPTF. If the PTF is already loaded it is applied. A maximum of 50 PTFs can be omitted.
</p>
<p>The possible Licensed-Program value is:
</p>
<dl>
<dt><b><i>licensed-program</i></b></dt>
<dd>Specify the product ID for the PTFs that should not be loaded.
</dd>
</dl>
<p>The possible PTF-Number values is:
</p>
<dl>
<dt><b><i>PTF-number</i></b></dt>
<dd>Specify the PTF ID for the PTFs that should not be installed.
</dd>
</dl>
<p>The possible Release Level values are:
</p>
<dl>
<dt><b><i>release-level</i></b></dt>
<dd>Specify the release level of the base product option or the release level of the PTF for the PTFs that should not be loaded. The release level must be specified in VxRyMz format, where Vx is the version number, Ry is the release number, and Mz is the modification level.
</dd>
<dt><b>*ONLY</b></dt>
<dd>The only release of the product selected on the LICPGM parameter.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.HIPER"></a>
<h3>HIPER PTFs only (HIPER)</h3>
<p>Specifies whether only high-impact pervasive (HIPER) PTFs should be loaded when installing from a media.
</p>
<p>
<b>Note: </b>This parameter is ignored if DEV(*SERVICE) is specified. This is valid only when installing IBM cumulative/preventive PTF packages.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>All PTFs, other than those listed in the omit list, should be installed.
</dd>
<dt><b>*YES</b></dt>
<dd>Only HIPER PTFs that are not on the omit list should be installed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.ENDOPT"></a>
<h3>End of media option (ENDOPT)</h3>
<p>Specifies the operation that is automatically performed on the tape or optical volume after the PTF operation ends.
</p>
<p>
<b>Note: </b>This parameter is valid only if a tape or optical device name is specified on the DEV parameter. For optical devices, *UNLOAD is the only special value supported, *REWIND and *LEAVE will be ignored.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
</dd>
<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>
<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="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.RESTART"></a>
<h3>Restart type (RESTART)</h3>
<p>Specifies the point from which the initial program load (IPL) restarts when the PTF apply type (INSTYP) parameter indicates an IPL will be performed.
</p>
<p>
<b>Note: </b>This is valid only when INSTYP(*DLYIPL) is specified or when INSTYP(*SRVATT) is specified and the PTF install type (PTFINSTYP) service attribute is set to *DLYIPL.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*IPLA</u></b></dt>
<dd>The value specified on the Change IPL Attributes (CHGIPLA) command is used. To determine the current setting for this value, use the Display IPL Attributes (DSPIPLA) command.
</dd>
<dt><b>*SYS</b></dt>
<dd>Specifies that the system determines how much of the system to restart.
<p>The operating system is always restarted. The hardware is restarted only if a PTF that requires a restart is applied. Other hardware functions, such as some configuration changes, that occur during a *FULL IPL are not processed.
</p>
<p>*SYS can result in a shorter IPL time than if you specify *FULL.
</p>
</dd>
<dt><b>*FULL</b></dt>
<dd>All portions of the system, including the hardware, are restarted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.PMTMED"></a>
<h3>Prompt for media (PMTMED)</h3>
<p>Specifies whether the user will be prompted for additional PTF volume sets and load PTFs from *SERVICE after loading PTFs from a device.
</p>
<p>
<b>Note: </b>This parameter is ignored if DEV(*SERVICE) or DEV(*NONE) is specified.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SNGVOLSET</u></b></dt>
<dd>The user will be prompted to mount each volume in a single volume set when loading the PTFs. If a virtual optical device is specified on the DEV parameter, all mounted PTF volumes will be processed.
</dd>
<dt><b>*MLTVOLSET</b></dt>
<dd>The user will be prompted for volumes in multiple volume sets when loading the PTFs.
</dd>
<dt><b>*MLTSRV</b></dt>
<dd>The user will be prompted for volumes in multiple volume sets when loading the PTFs. After PTFs are loaded from the last volume set, PTFs will be loaded from the service support system (*SERVICE).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="INSPTF.CPYPTF"></a>
<h3>Copy PTFs (CPYPTF)</h3>
<p>Specifies whether to copy PTF save files and cover letters into *SERVICE when PTFs are loaded. PTF save files must be in *SERVICE when distributing PTFs to other systems or when using the Save System Information (SAVSYSINF) command.
</p>
<p>
<b>Note: </b>This parameter is ignored if DEV(*SERVICE) or DEV(*NONE) is specified.
</p>
<dl>
<dt><b><u>*SRVATT</u></b></dt>
<dd>Use the Copy PTFs (CPYPTF) service attribute to determine if PTF save files and cover letters will be copied into *SERVICE when PTFs are loaded. The Display Service Attributes (DSPSRVA) command displays information about how the system is set up. This includes whether PTF save files and cover letters will be copied into *SERVICE when PTFs are loaded. The Change Service Attributes (CHGSRVA) command can be used to change the CPYPTF service attribute.
</dd>
<dt><b>*YES</b></dt>
<dd>PTF save files and cover letters that do not already exist are copied into *SERVICE when PTFs are loaded.
</dd>
<dt><b>*NO</b></dt>
<dd>PTF save files and cover letters are not copied into *SERVICE when PTFs are loaded.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INSPTF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Omitting PTFs</b>
</p>
<p>
<pre>
INSPTF LICPGM((*ALL)) DEV(*SERVICE) INSTYP(*IMMDLY)
OMIT((5722999 MF12345 V5R4M0) (5722SS1 SI12345 V5R4M0))
</pre>
</p>
<p>This command will load all PTFs that are in *SERVICE for all products installed on the system except MF12345 and SI12345. It will then apply all PTFs in loaded status that can be applied immediately and mark the rest for delayed apply.
</p>
<p><b>Example 2: Installing HIPER only</b>
</p>
<p>
<pre>
INSPTF LICPGM((5722PT1 V5R4M0)) DEV(TAP01) INSTYP(*IMMONLY)
HIPER(*YES)
</pre>
</p>
<p>This command will search the media for PTFs for the V5R4M0 Performance Tools product in the HIPER section. Each PTF that can be applied immediately will be. Delayed PTFs will be loaded, but not marked for apply.
</p>
<p><b>Example 3: Installing Only Immediate PTFs</b>
</p>
<p>
<pre>
INSPTF LICPGM((*ALL)) DEV(TAP01) INSTYP(*IMMONLY)
ENDOPT(*LEAVE)
</pre>
</p>
<p>This command will load all PTFs for the products that are installed on the system, from the device TAP01. All PTFs in loaded status on the system that can be applied immediately will be. No delayed PTFs will be set for apply.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="INSPTF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF358A</b></dt>
<dd>Release not valid.
</dd>
<dt><b>CPF358F</b></dt>
<dd>LICPGM parameter contains duplicate entries.
</dd>
<dt><b>CPF35EB</b></dt>
<dd>Multiple releases of product &amp;1 installed.
</dd>
<dt><b>CPF3586</b></dt>
<dd>List of PTFs not correct.
</dd>
<dt><b>CPF36B7</b></dt>
<dd>PTF install processing incomplete; IPL required.
</dd>
<dt><b>CPF3606</b></dt>
<dd>Product &amp;1 &amp;2 not installed.
</dd>
<dt><b>CPF361A</b></dt>
<dd>PTFs installed successfully, but actions pending.
</dd>
<dt><b>CPF361B</b></dt>
<dd>PTF install processing failed, and there are actions pending.
</dd>
<dt><b>CPF361C</b></dt>
<dd>No PTFs installed.
</dd>
<dt><b>CPF3615</b></dt>
<dd>PTF install processing failed.
</dd>
<dt><b>CPF3618</b></dt>
<dd>The mode is not set at Normal.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#INSPTF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink