560 lines
21 KiB
HTML
560 lines
21 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>Apply Remote PTF (APYRMTPTF)</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="APYRMTPTF.Top_Of_Page"></a>
|
||
|
|
<h2>Apply Remote PTF (APYRMTPTF)</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="#APYRMTPTF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#APYRMTPTF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#APYRMTPTF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="APYRMTPTF"></a>
|
||
|
|
<p>The Apply Remote Program Temporary Fix (APYRMTPTF) command allows a service provider to remotely apply PTFs on the service requester's system. When using the APYRMTPTF command, you can request an IPL of the service requester's system. The apply PTF and IPL can be scheduled to occur at a later date and time.
|
||
|
|
</p>
|
||
|
|
<p><b>Note:</b>
|
||
|
|
</p>
|
||
|
|
<p>A change request is automatically submitted that can be viewed to determine the status of this command. You can use the Work with Submitted Change Request (WRKSBMCRQ) command to monitor the status.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>The apply and IPL functions of this command are only supported when the service requester has Managed System Services installed.
|
||
|
|
</li>
|
||
|
|
<li>PTFs that are not marked as delayed are applied immediately. PTFs marked as delayed are scheduled to be applied at the next IPL.
|
||
|
|
</li>
|
||
|
|
<li>PTFs marked as delayed can only be applied permanently if they have been previously applied temporarily. Notice that an IPL would have been required to apply them since they are delayed.
|
||
|
|
</li>
|
||
|
|
<li>Prerequisite PTFs of the same product must already be loaded on the service requester. However, prerequisite PTFs of another product must already be applied on the service requester. Corequisite PTFs of the same product and same option must already be loaded on the service requester. However, corequisite PTFs of another product or another option must already be applied on the service requester.
|
||
|
|
</li>
|
||
|
|
<li>If a NODL value is specified, the node list can only contain entries that have a value of *SNA for the address type.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="APYRMTPTF.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="4"><a href="#APYRMTPTF.PTFID"><b>PTFID</b></a></td>
|
||
|
|
<td valign="top">PTF description</td>
|
||
|
|
<td valign="top">Values (up to 300 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: PTF identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, *ALL</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Product</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*ONLY</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Release level</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#APYRMTPTF.DESTSRVRQS"><b>DESTSRVRQS</b></a></td>
|
||
|
|
<td valign="top">Destination service requester</td>
|
||
|
|
<td valign="top">Single values: *ALL, <b><u>*SELECT</u></b>, *NONE<br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Network identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, *NETATR</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Control point</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#APYRMTPTF.APY"><b>APY</b></a></td>
|
||
|
|
<td valign="top">Extent of change</td>
|
||
|
|
<td valign="top"><b><u>*TEMP</u></b>, *PERM</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#APYRMTPTF.DLYAPY"><b>DLYAPY</b></a></td>
|
||
|
|
<td valign="top">Delayed PTF apply</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#APYRMTPTF.NODL"><b>NODL</b></a></td>
|
||
|
|
<td valign="top">Node list name</td>
|
||
|
|
<td valign="top"><i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Node list name</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, *LIBL, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#APYRMTPTF.IPL"><b>IPL</b></a></td>
|
||
|
|
<td valign="top">IPL remote system</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#APYRMTPTF.PWRDWNOPT"><b>PWRDWNOPT</b></a></td>
|
||
|
|
<td valign="top">Power down option</td>
|
||
|
|
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#APYRMTPTF.PWRDWNDLY"><b>PWRDWNDLY</b></a></td>
|
||
|
|
<td valign="top">Power down delay</td>
|
||
|
|
<td valign="top">1-65535, <b><u>3600</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#APYRMTPTF.RMTAPYTIME"><b>RMTAPYTIME</b></a></td>
|
||
|
|
<td valign="top">Remote apply time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Time zone</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*LCLSYS</u></b>, *MGDSYS</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Start after</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*CURRENT</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *NEXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#APYRMTPTF.RMTIPLTIME"><b>RMTIPLTIME</b></a></td>
|
||
|
|
<td valign="top">Remote IPL time</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Time zone</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*LCLSYS</u></b>, *MGDSYS</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Start after</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Element list</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 1: Time</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Time</i>, <b><u>*CURRENT</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Element 2: Date</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Date</i>, <b><u>*CURRENT</u></b>, *NEXT</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="APYRMTPTF.PTFID"></a>
|
||
|
|
<h3>PTF description (PTFID)</h3>
|
||
|
|
<p>Specifies the PTF that is to be applied. A maximum of 300 PTF identifiers can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible PTF identifier values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>PTF-identifier</i></b></dt>
|
||
|
|
<dd>Specify a 7-character PTF identifier.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Applies all PTFs for the specified product.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible product identifier values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>Specifies that the PTF identifier is associated with only one product.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>product-id</i></b></dt>
|
||
|
|
<dd>Specify the product of the PTF. The product must be specified when PTF identifiers are not unique across products or the PTF identifier is *ALL.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible release level of product value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>release(VxRxMx)</i></b></dt>
|
||
|
|
<dd>Specify the release level of the product. The format is VxRxMx.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.DESTSRVRQS"></a>
|
||
|
|
<h3>Destination service requester (DESTSRVRQS)</h3>
|
||
|
|
<p>Specifies the service requester where this PTF function is to be performed. A single service requester or a list of service requesters can be specified.
|
||
|
|
</p>
|
||
|
|
<p>The possible network identifier values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SELECT</u></b></dt>
|
||
|
|
<dd>Shows a list of service requesters. From the list, you can select one or more service requesters. *SELECT is not valid when the command is used in a batch environment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>Specifies that this PTF function should occur on all of the service requesters that are defined for this service provider.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>The service requesters are identified in a node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The remote network identifier of the service requester is the same as the remote network identifier of this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>remote-network-identifier</i></b></dt>
|
||
|
|
<dd>Specify the remote network identifier of the service requester.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible control point value is:
|
||
|
|
</p>
|
||
|
|
<p>This element is not valid when the network identifier is *ALL, *SELECT, or *NONE.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>remote-control-point</i></b></dt>
|
||
|
|
<dd>Specify the remote control point name of the service requester.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.APY"></a>
|
||
|
|
<h3>Extent of change (APY)</h3>
|
||
|
|
<p>Specifies the extent of the change when the PTFs are applied.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*TEMP</u></b></dt>
|
||
|
|
<dd>Apply the PTFs temporarily on the service requester.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PERM</b></dt>
|
||
|
|
<dd>Apply the PTFs permanently on the service requester.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.DLYAPY"></a>
|
||
|
|
<h3>Delayed PTF apply (DLYAPY)</h3>
|
||
|
|
<p>Specifies how PTFs are applied. Apply immediate PTFs at the time the activity runs on the specified system or later during the next IPL.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Applies an immediate PTF at the time the activity runs. If the PTF is marked delayed, it is not applied until the next unattended IPL.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Applies both immediate or delayed PTFs during the next unattended IPL.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.NODL"></a>
|
||
|
|
<h3>Node list name (NODL)</h3>
|
||
|
|
<p>Specifies the node list object name that contains a list of service requesters where this PTF function is to be performed.
|
||
|
|
</p>
|
||
|
|
<p>The possible value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>The service requesters are identified in the DESTSRVRQS parameter.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible library values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBL</b></dt>
|
||
|
|
<dd>Searches all of the libraries in the user and system portions of the job's library list for the node list object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CURLIB</b></dt>
|
||
|
|
<dd>Searches for the node list object in the library for the current job.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library to be searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible node list name value is:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>node-list-name</i></b></dt>
|
||
|
|
<dd>Specify the node list name which contains the list of service requesters where this PTF function is to be performed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.IPL"></a>
|
||
|
|
<h3>IPL remote system (IPL)</h3>
|
||
|
|
<p>Specifies if an IPL of the service requester's system should occur.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>An IPL of the service requester's system should not occur.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>An IPL of the service requester's system should occur after all of the PTFs listed on the command are successfully applied on the service requester.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.PWRDWNOPT"></a>
|
||
|
|
<h3>Power down option (PWRDWNOPT)</h3>
|
||
|
|
<p>Specifies how to manage the end of active jobs during the IPL processing at service requester system. This parameter is valid only if IPL(*YES) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CNTRLD</u></b></dt>
|
||
|
|
<dd>All jobs end when the time specified in Power Down Delay (PWRDWDLY) parameter expires. Any current jobs that are running perform an end of batch processing.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*IMMED</b></dt>
|
||
|
|
<dd>Jobs end immediately.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.PWRDWNDLY"></a>
|
||
|
|
<h3>Power down delay (PWRDWNDLY)</h3>
|
||
|
|
<p>This parameter is valid only if IPL(*YES) and if PWRDWNOPT(*CNTRLD) are specified. Specifies the amount of time in seconds that the system allows a controlled end to be performed. If the end of job routines are not finished in the specified power down delay, any remaining jobs are ended immediately.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>3600</u></b></dt>
|
||
|
|
<dd>The amount of time in which to complete a controlled end of processing is limited to 3600 seconds.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>delay-time</i></b></dt>
|
||
|
|
<dd>Specify the maximum amount of delay time, in seconds, in which a controlled end can be performed. Valid values range from 1 through 65535 (65,535 seconds).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.RMTAPYTIME"></a>
|
||
|
|
<h3>Remote apply time (RMTAPYTIME)</h3>
|
||
|
|
<p>Specifies the date and the time when this PTF function can occur on the service requester. The current date and time values and the next date are determined, when this PTF function is processed on this system, based on this system's date and time.
|
||
|
|
</p>
|
||
|
|
<p>The possible time zone values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCLSYS</u></b></dt>
|
||
|
|
<dd>Specifies the remote start time in the time zone of this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MGDSYS</b></dt>
|
||
|
|
<dd>Specifies the remote start time in the time zone of the service requester.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>Starts this PTF function on the service requester system at any time on or after this PTF function request is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-time</i></b></dt>
|
||
|
|
<dd>Specify the time when this PTF function can be started on the service requester. The time can be entered as 4 or 6 digits, such as hhmm or hhmmss where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a separator. With a time separator, specify a string of 5 or 8 digits such as hh:mm:ss.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>Starts this PTF function on the service requester system on any date on or after the date this PTF function request is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>Starts this PTF function on the service requester system on any date after the date this PTF function is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-date</i></b></dt>
|
||
|
|
<dd>Specify the date when this PTF function can start on the service requester system. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The special values *CURRENT and *NEXT cannot be specified for the date and time if the time zone value *MGDSYS is specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="APYRMTPTF.RMTIPLTIME"></a>
|
||
|
|
<h3>Remote IPL time (RMTIPLTIME)</h3>
|
||
|
|
<p>Specifies the date and time when the IPL can occur on the service requester. The current date and time values and next date are determined, when this IPL request is processed on this system, based on this system's date and time.
|
||
|
|
</p>
|
||
|
|
<p>The possible time zone values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*LCLSYS</u></b></dt>
|
||
|
|
<dd>Specifies the remote start time in the time zone of this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MGDSYS</b></dt>
|
||
|
|
<dd>Specifies the remote start time in the time zone of the service requester's system.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after time values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>Starts the IPL on the service requester system at any time on or after this IPL request is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-time</i></b></dt>
|
||
|
|
<dd>Specify the time when the IPL can be started on the service requester. The time can be entered as 4 or 6 digits, such as hhmm or hhmmss where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a separator. With a time separator, specify a string of 5 or 8 digits such as hh:mm:ss.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible start after date values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>Starts the IPL on the service requester system on any date on or after the date the IPL request is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NEXT</b></dt>
|
||
|
|
<dd>Starts the IPL on the service requester system on any date after the date this IPL request is processed on this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-after-date</i></b></dt>
|
||
|
|
<dd>Specify the date when the IPL can start on the service requester system. The date must be specified in the job date format.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The special values *CURRENT and *NEXT cannot be specified for the date and time if the time zone value *MGDSYS is specified.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="APYRMTPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Applying a Temporary PTF</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
APYRMTPTF PTFID((123456 *ONLY V5R2M0)) DESTSRVRQS(*SELECT)
|
||
|
|
NODL(SRVPVDLIB/SRVRQSLIST)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Apply a PTF temporarily on the selected service requesters system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Applying Permanent PTFs</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
APYRMTPTF PTFID((*ALL PRODUCT1 V5R2M0)) DESTSRVRQS(*NONE)
|
||
|
|
NODL(SRVPVDLIB/SRVRQSLIST) APY(*PERM)
|
||
|
|
RMTAPYTIME((*MGDSYS (10:00:00 10/31/02))
|
||
|
|
IPL(*YES) RMTIPLTIME((*MGDSYS (01:00:00 11/01/02))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Apply all PTFs permanently for a specified product, and schedule when the apply and IPL should occur for all of the service requesters in the node list object.
|
||
|
|
</p>
|
||
|
|
<p>This example applies the PTFs on the service requesters starting at 10:00 a.m. on October 31, 2002. If the PTFs applied successfully, the IPL on the remote system starts at 1:00 a.m. on November 1, 2002. The times specified are in the time zone of the remote system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Applying a Delayed PTF</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
APYRMTPTF PTFID((987654 *ONLY V5R2M0)) DESTSRVRQS(*SELECT)
|
||
|
|
NODL(SRVPVDLIB/SRVRQSLIST) DLYAPY(*YES)
|
||
|
|
RMTAPYTIME((*MGDSYS (8:00:00 *CURRENT))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Apply a delayed PTF temporarily on the selected service requesters system, and schedule when the apply should occur for all of the service requesters in the node list object.
|
||
|
|
</p>
|
||
|
|
<p>This example applies the PTFs on the service requester systems starting at 8:00 am on the current date. The time specified is in the time zone of the remote system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Doing an IPL after Applying a PTF</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
APYRMTPTF PTFID((*ALL *ONLY V5R2M0)) DESTSRVRQS(*SELECT)
|
||
|
|
NODL(SRVPVDLIB/SRVRQSLIST) IPL(*YES)
|
||
|
|
RMTIPLTIME((*LCLSYS (*CURRENT 12/24/02))
|
||
|
|
PWRDWNOPT(*CNTRLD) PWRDWNDLY(1800)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Apply all PTFs temporarily for a specified product, and schedule when the IPL should occur for all of the service requesters in the node list object.
|
||
|
|
</p>
|
||
|
|
<p>This example applies the PTFs on the service requester systems. If the PTFs are applied successfully, the IPL on the remote system starts at the current time on December 24, 2002. The times specified are in the time zone of the locl system.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Applying a PTF with two Corequisite PTFs and one Prerequisite PTF</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
APYRMTPTF PTFID((SF00001 *ONLY V5R2M0)) DESTSRVRQS(*SELECT)
|
||
|
|
RMTAPYTIME(*LCLSYS (*CURRENT *CURRENT)) IPL(*NO)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Apply PTF SF00001. This PTF has two corequisite PTFs and one prerequisite PTF. PTFs SF00002 and SF00003 are corequisite PTFs for PTF SF00001. PTF SF00004 is a prerequisite for PTF SF00001. The system will remove PTFs SF00001, SF00002, SF00003, and SF00004. The system will determine all corequisite PTFs if they were not specified. No IPL will be performed, and this action applies the PTFs on the service requesters. The times specified are in the time zone of the local system.
|
||
|
|
</p>
|
||
|
|
<p>This example applies the PTFs on the service requesters system starting at 8:00 am on the current date. The time specified is in the time zone of the remote system.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="APYRMTPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF358A</b></dt>
|
||
|
|
<dd>PTF &1-&2 cannot be applied or removed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#APYRMTPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|