ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dltrmtptf.htm

250 lines
8.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Delete Remote PTF (DLTRMTPTF)</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="DLTRMTPTF.Top_Of_Page"></a>
<h2>Delete Remote PTF (DLTRMTPTF)</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="#DLTRMTPTF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DLTRMTPTF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DLTRMTPTF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DLTRMTPTF"></a>
<p>The Delete Remote Program Temporary Fix (DLTRMTPTF) command allows a service provider to remotely delete PTFs from a service requester's system.
</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 delete function of this command is only supported when the service requester has Managed System Services licensed program installed.
</li>
<li>If NODL value is specified, the node list must contain only entries that have an address type equal to *SNA.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DLTRMTPTF.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="#DLTRMTPTF.PTFID"><b>PTFID</b></a></td>
<td valign="top">PTF description</td>
<td valign="top">Values (up to 50 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="#DLTRMTPTF.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" rowspan="3"><a href="#DLTRMTPTF.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></table>
<table width="100%">
<tr><td align="right"><a href="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DLTRMTPTF.PTFID"></a>
<h3>PTF description (PTFID)</h3>
<p>Specifies the PTF that is to be deleted. A maximum of 50 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>Deletes 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 specified product. The format is VxRxMx.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTRMTPTF.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 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 values are:
</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="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTRMTPTF.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 values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The service requesters are identified in the DESTSRVRQS parameter.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b>*LIBL</b></dt>
<dd>Searches all of the libraries in the user and in the 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="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTRMTPTF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Deleting a PTF</b>
</p>
<p>
<pre>
DLTRMTPTF PTFID((1234567 *ONLY V5R2M0))
</pre>
</p>
<p>This command shows how to delete a PTF on one or more service requesters. A list will be shown from which you select one or more service requesters.
</p>
<p><b>Example 2: Deleting a PTF on All Service Requesters</b>
</p>
<p>
<pre>
DLTRMTPTF PTFID((1234567 *ONLY V5R2M0)) DESTSRVRQS(*ALL)
</pre>
</p>
<p>This command shows how to delete a PTF from all service requesters supported by this service provider.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTRMTPTF.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTRMTPTF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>