193 lines
5.7 KiB
HTML
193 lines
5.7 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>Hold Communications Device (HLDCMNDEV)</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="HLDCMNDEV.Top_Of_Page"></a>
|
|
<h2>Hold Communications Device (HLDCMNDEV)</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="#HLDCMNDEV.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#HLDCMNDEV.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#HLDCMNDEV.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="HLDCMNDEV"></a>
|
|
<p>The Hold Communications Device (HLDCMNDEV) command allows the operator to hold communication through the specified device. Communications are restarted with the Release Communications Device (RLSCMNDEV) command or by varying the device off and then on with the Vary Configuration (VRYCFG) command.
|
|
</p>
|
|
<p><b>Restriction:</b> This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="HLDCMNDEV.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="#HLDCMNDEV.DEV"><b>DEV</b></a></td>
|
|
<td valign="top">Device</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#HLDCMNDEV.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top"><b><u>*CNTRLD</u></b>, *IMMED</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="HLDCMNDEV.DEV"></a>
|
|
<h3>Device (DEV)</h3>
|
|
<p>Specifies the name of the device whose communications are to be held. Devices whose communications are held are:
|
|
</p>
|
|
<dl>
|
|
<dt><b>DEV Value</b></dt>
|
|
<dd><b> Device
|
|
</b></dd>
|
|
<dt><b>3180</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>3277</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>3278</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>3279</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>3287</b></dt>
|
|
<dd>Printer (work station)
|
|
</dd>
|
|
<dt><b>5219</b></dt>
|
|
<dd>Printer (work station)
|
|
</dd>
|
|
<dt><b>5224</b></dt>
|
|
<dd>Printer (work station)
|
|
</dd>
|
|
<dt><b>5225</b></dt>
|
|
<dd>Printer (work station)
|
|
</dd>
|
|
<dt><b>5251</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>5252</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>5256</b></dt>
|
|
<dd>Printer (work station)
|
|
</dd>
|
|
<dt><b>5291</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>5292</b></dt>
|
|
<dd>Display station
|
|
</dd>
|
|
<dt><b>PLU1</b></dt>
|
|
<dd>Primary logical unit, type 1 (for SNA)
|
|
</dd>
|
|
<dt><b>BSC</b></dt>
|
|
<dd>Binary synchronous device (Base and RJE)
|
|
</dd>
|
|
<dt><b>BSCT</b></dt>
|
|
<dd>This &sys. system as a BSC multipoint tributary station
|
|
</dd>
|
|
<dt><b>APPC</b></dt>
|
|
<dd>Logical unit in advanced program-to-program communications (APPC) network
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="HLDCMNDEV.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies the manner in which communication is held with this device.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CNTRLD</u></b></dt>
|
|
<dd>The specified device is not capable of communications at the next OPEN or ACQUIRE operation. The controlled option allows any program using the communications device to continue to do input/output operations, but no new uses of the device are started.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The specified device is not capable of communications at the next READ, WRITE, OPEN, or ACQUIRE operation. The immediate option stops a communications device immediately, and a permanent input/output error is sent to the program.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDCMNDEV.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
HLDCMNDEV DEV(WSPR05)
|
|
</pre>
|
|
</p>
|
|
<p>This command holds the communications capability of the device WSPR05 at the time of the next OPEN or ACQUIRE operation.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="HLDCMNDEV.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF5920</b></dt>
|
|
<dd>Device &1 varied off or in diagnostic mode.
|
|
</dd>
|
|
<dt><b>CPF5921</b></dt>
|
|
<dd>Device &1 not a communications device.
|
|
</dd>
|
|
<dt><b>CPF5922</b></dt>
|
|
<dd>Device &1 already held with option *IMMED.
|
|
</dd>
|
|
<dt><b>CPF5935</b></dt>
|
|
<dd>Error occurred during command processing.
|
|
</dd>
|
|
<dt><b>CPF5984</b></dt>
|
|
<dd>Not authorized to perform function.
|
|
</dd>
|
|
<dt><b>CPF9814</b></dt>
|
|
<dd>Device &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9825</b></dt>
|
|
<dd>Not authorized to device &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#HLDCMNDEV.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|