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

226 lines
7.3 KiB
HTML
Raw Permalink 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>Change Line Desc (Fax) (CHGLINFAX)</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="CHGLINFAX.Top_Of_Page"></a>
<h2>Change Line Desc (Fax) (CHGLINFAX)</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="#CHGLINFAX.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGLINFAX.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGLINFAX.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGLINFAX"></a>
<p>The Change Line Description (Fax) (CHGLINFAX) command changes a line description for a facsimile (fax) line.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGLINFAX.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="#CHGLINFAX.LIND"><b>LIND</b></a></td>
<td valign="top">Line description</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINFAX.RSRCNAME"><b>RSRCNAME</b></a></td>
<td valign="top">Resource names</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 2 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINFAX.ONLINE"><b>ONLINE</b></a></td>
<td valign="top">Online at IPL</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINFAX.VRYWAIT"><b>VRYWAIT</b></a></td>
<td valign="top">Vary on wait</td>
<td valign="top">15-180, <b><u>*SAME</u></b>, *NOWAIT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLINFAX.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGLINFAX.LIND"></a>
<h3>Line description (LIND)</h3>
<p>Specifies the name of the line description
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINFAX.RSRCNAME"></a>
<h3>Resource names (RSRCNAME)</h3>
<p>Specifies the resource names that describe the fax ports.
</p>
<p>
<b>Note: </b>Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.
</p>
<p>The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01, the resource names for ports 1 and 2 are LIN011 and LIN012.
</p>
<p>The resource name for both ports of the fax IOA must be specified. All lines specified must be attached to the same input/output processor.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b><i>rsrcname-1</i></b></dt>
<dd>Specify the first resource name to be used to describe the fax ports.
</dd>
<dt><b><i>rsrcname-2</i></b></dt>
<dd>Specify the second resource name to be used to describe the fax ports.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINFAX.ONLINE"></a>
<h3>Online at IPL (ONLINE)</h3>
<p>Specifies whether this object is automatically varied on at initial program load (IPL).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The line is automatically varied on at initial program load (IPL).
</dd>
<dt><b>*NO</b></dt>
<dd>This line is not automatically varied on at IPL.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINFAX.VRYWAIT"></a>
<h3>Vary on wait (VRYWAIT)</h3>
<p>Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NOWAIT</b></dt>
<dd>The system does not wait for vary on completion. The line is varied on asynchronously.
</dd>
<dt><b><i>vary-on-wait</i></b></dt>
<dd>Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
</dd>
</dl>
<p><b>Notes:</b>
</p>
<ol>
<li>When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
</li>
<li>The time required to vary on a line is the time it takes to:
<ul>
<li>Put tasks in place to manage the line
</li>
<li>Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
</li>
<li>Establish the communications tasks and processes
</li>
</ul>
</li>
</ol>
<p>Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLINFAX.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the line description.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*BLANK</b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLINFAX.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGLINFAX LIND(FAXLINE) RSRCNAME(LIN031 LIN032)
</pre>
</p>
<p>This command changes the resource names for fax line description FAXLINE to LIN041 and LIN042.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLINFAX.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF261E</b></dt>
<dd>Line description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLINFAX.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>