244 lines
7.9 KiB
HTML
244 lines
7.9 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>Retrieve Program Temporary Fix (RTVPTF)</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="RTVPTF.Top_Of_Page"></a>
|
||
|
|
<h2>Retrieve Program Temporary Fix (RTVPTF)</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="#RTVPTF.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RTVPTF.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RTVPTF.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RTVPTF"></a>
|
||
|
|
<p>The Retrieve Program Temporary Fix (RTVPTF) command allows a service provider to retrieve remote PTFs and cover letters 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>Restriction:</b>
|
||
|
|
</p>
|
||
|
|
<p>The retrieve function of this command is only supported when the service requester has the Managed System Services licensed program installed.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RTVPTF.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="#RTVPTF.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></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="#RTVPTF.DESTSRVRQS"><b>DESTSRVRQS</b></a></td>
|
||
|
|
<td valign="top">From service requester</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SELECT</u></b><br>Other values: <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="#RTVPTF.PTFPART"><b>PTFPART</b></a></td>
|
||
|
|
<td valign="top">PTF parts</td>
|
||
|
|
<td valign="top"><b><u>*ALL</u></b>, *PTF, *CVRLTR</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RTVPTF.CVRLTRLNG"><b>CVRLTRLNG</b></a></td>
|
||
|
|
<td valign="top">Cover letter language</td>
|
||
|
|
<td valign="top">Values (up to 40 repetitions): <i>Character value</i>, <b><u>*SRVPVDA</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RTVPTF.PTFID"></a>
|
||
|
|
<h3>PTF description (PTFID)</h3>
|
||
|
|
<p>Specifies the PTF that is to be retrieved. 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>
|
||
|
|
</dl>
|
||
|
|
<p>The possible product identifier values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ONLY</u></b></dt>
|
||
|
|
<dd>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.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible release level of product values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>release(VxRxMx)</i></b></dt>
|
||
|
|
<dd>Specify the release level of the product. The release level must be specified when PTF identifiers are not unique across products. The format is VxRxMx.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVPTF.DESTSRVRQS"></a>
|
||
|
|
<h3>From service requester (DESTSRVRQS)</h3>
|
||
|
|
<p>Specifies the service requester where the PTF should be retrieved. Only one service requester can be specified or selected.
|
||
|
|
</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, the user can select a service requester from where the PTF is retrieved. *SELECT is not valid when the command is used in a batch environment.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NETATR</b></dt>
|
||
|
|
<dd>The remove 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 value is:
|
||
|
|
</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="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVPTF.PTFPART"></a>
|
||
|
|
<h3>PTF parts (PTFPART)</h3>
|
||
|
|
<p>Specifies if PTFs or cover letters should be retrieved.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>Retrieve the PTF and its cover letter in the language specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PTF</b></dt>
|
||
|
|
<dd>Retrieve only the PTF.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CVRLTR</b></dt>
|
||
|
|
<dd>Retrieve only the cover letter in the language specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RTVPTF.CVRLTRLNG"></a>
|
||
|
|
<h3>Cover letter language (CVRLTRLNG)</h3>
|
||
|
|
<p>Specifies the cover letter language that should be retrieved.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SRVPVDA</u></b></dt>
|
||
|
|
<dd>The value set in the Change Service Provider Attributes (CHGSRVPVDA) command is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>cover-letter-language-ID</i></b></dt>
|
||
|
|
<dd>Specify the cover letter language code. Prompting (F4) on this field provides a list of all possible cover letter language codes.
|
||
|
|
<p><b>Note:</b>
|
||
|
|
</p>
|
||
|
|
<p>If the specified cover letter language is not found on the service requester's system, a default cover letter language of 2924 which is upper and lower case English, or 2950 which is upper case English, is retrieved if available.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVPTF.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Retrieving a PTF and Cover Letter</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RTVPTF PTFID(SF00001) DESTSRVRQS(*NETATR CHICAGO1)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command retrieves a PTF and a cover letter from a service requester. The cover letter language to be retrieved is defined as a service provider attribute.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Retrieving a Cover Letter</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RTVPTF PTFID(123456) DESTSRVRQS(*SELECT)
|
||
|
|
PTFPART(*CVRLTR) CVRLTRLNG(2962)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command retrieves a cover letter from a selected service requester in the 2962 language.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RTVPTF.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p>None
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RTVPTF.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|