174 lines
7.0 KiB
HTML
174 lines
7.0 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>Release Remote Phase (RLSRMTPHS)</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="RLSRMTPHS.Top_Of_Page"></a>
|
||
|
|
<h2>Release Remote Phase (RLSRMTPHS)</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="#RLSRMTPHS.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#RLSRMTPHS.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#RLSRMTPHS.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="RLSRMTPHS"></a>
|
||
|
|
<p>The Release Remote Phase (RLSRMTPHS) command initiates a session between the iSeries and a System/370 NetView Distribution Manager (NDM) host system. After the phase is released by NDM (or an unsuccessful attempt is made to do so), the session is ended.
|
||
|
|
</p>
|
||
|
|
<p>The following considerations apply when running this command:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>The NDM plan specified by the PLAN parameter must exist and have been previously submitted to the NDM host application specified by the APPID parameter.
|
||
|
|
</li>
|
||
|
|
<li>The NDM phase specified by the PHASE parameter must exist and be part of the NDM plan specified by the PLAN parameter.
|
||
|
|
</li>
|
||
|
|
<li>The NDM phase specified by the PHASE parameter must be in a HELD state on the host system.
|
||
|
|
</li>
|
||
|
|
<li>The device specified by the DEV parameter must be a SNUF device and must be program start request (PSR) capable.
|
||
|
|
</li>
|
||
|
|
<li>This command runs only on a node which is currently functioning as a host interface node to the NDM host system. However, it is not restricted to releasing only those NDM phases whose destination is the node issuing the command. Any phase may be released for any node that shares the host interface node.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Restriction:</b> To use this command, the user must be signed on as QPGMR or QSYSOPR, or have *ALLOBJ authority.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="RLSRMTPHS.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="#RLSRMTPHS.PHASE"><b>PHASE</b></a></td>
|
||
|
|
<td valign="top">Phase</td>
|
||
|
|
<td valign="top"><i>Communications name</i></td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RLSRMTPHS.PLAN"><b>PLAN</b></a></td>
|
||
|
|
<td valign="top">Plan</td>
|
||
|
|
<td valign="top"><i>Communications name</i></td>
|
||
|
|
<td valign="top">Required, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RLSRMTPHS.APPID"><b>APPID</b></a></td>
|
||
|
|
<td valign="top">Application identifier</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RLSRMTPHS.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
|
||
|
|
<td valign="top">Remote location</td>
|
||
|
|
<td valign="top"><i>Communications name</i></td>
|
||
|
|
<td valign="top">Required, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#RLSRMTPHS.DEV"><b>DEV</b></a></td>
|
||
|
|
<td valign="top">Device</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Required, Positional 5</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="RLSRMTPHS.PHASE"></a>
|
||
|
|
<h3>Phase (PHASE)</h3>
|
||
|
|
<p>Specifies the name of the NetView Distribution Manager phase that is released. This phase must exist on the NDM host system as part of the plan specified by the PLAN parameter, and must be in a HELD state.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RLSRMTPHS.PLAN"></a>
|
||
|
|
<h3>Plan (PLAN)</h3>
|
||
|
|
<p>Specifies the name of the NetView Distribution Manager plan that contains the phase that is released. This plan must exist on the NDM host.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RLSRMTPHS.APPID"></a>
|
||
|
|
<h3>Application identifier (APPID)</h3>
|
||
|
|
<p>Specifies the name of the NetView Distribution Manager application under which the phase name specified by the PHASE parameter was submitted. This is the same name by which NDM was made known to MVS when it was generated.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RLSRMTPHS.RMTLOCNAME"></a>
|
||
|
|
<h3>Release Remote Phase (RMTLOCNAME)</h3>
|
||
|
|
<p>Specifies the name of the remote location with which this device communicates. This should be the same name that is entered in the RMTLOCNAME parameter of the device specified by the DEV parameter.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="RLSRMTPHS.DEV"></a>
|
||
|
|
<h3>Device description (DEV)</h3>
|
||
|
|
<p>Specifies the device name of the iSeries device to be used for the communications session started as a result of this command. The device must be a SNUF device and must be PSR capable.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RLSRMTPHS.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
RLSRMTPHS PHASE(MESSAGE) PLAN(ALEXPLAN) APPID(DSXNDM)
|
||
|
|
RMTLOCNAME(A083187) DEV(SNUFDEV)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command initiates a session using device SNUFDEV with remote location name A083187 to connect with the System/370 NetView Distribution Manager host application DSXNDM. After the session connection is made, phase MESSAGE, as part of plan ALEXPLAN, attempts to release. If the release is successful, message CPC8889 (Phase MESSAGE released by NetView Distribution Manager) is sent. If the release is not successful, message CPF8880 (Phase MESSAGE not released by Netview Distribution Manager) is sent.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="RLSRMTPHS.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF8880</b></dt>
|
||
|
|
<dd>Phase &1 not released by NetView Distribution Manager.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#RLSRMTPHS.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|