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

444 lines
14 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>Verify Link supporting LPDA-2 (VFYLNKLPDA)</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="VFYLNKLPDA.Top_Of_Page"></a>
<h2>Verify Link supporting LPDA-2 (VFYLNKLPDA)</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="#VFYLNKLPDA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#VFYLNKLPDA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#VFYLNKLPDA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="VFYLNKLPDA"></a>
<p>The Verify Link Supporting LPDA-2 (VFYLNKLPDA) command allows you to run any of the LPDA-2 tests and to receive the results in a format you specify.
</p>
<p><b>Restriction:</b> This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, or QSRVBAS user profiles have private authorities to use the command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="VFYLNKLPDA.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="#VFYLNKLPDA.LINE"><b>LINE</b></a></td>
<td valign="top">Line</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.TEST"><b>TEST</b></a></td>
<td valign="top">Test</td>
<td valign="top"><b><u>*DCELINSTS</u></b>, *DCELINTST, *ANZLIN, *SNDRCV</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.LCLDCEADR"><b>LCLDCEADR</b></a></td>
<td valign="top">Local DCE address</td>
<td valign="top">01-FB, <b><u>*LCL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.RMTDCEADR"><b>RMTDCEADR</b></a></td>
<td valign="top">Remote DCE address</td>
<td valign="top">01-FB, <b><u>*ANY</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.SEQCOUNT"><b>SEQCOUNT</b></a></td>
<td valign="top">Number of sequences</td>
<td valign="top">1-3, <b><u>1</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.DTEPORT"><b>DTEPORT</b></a></td>
<td valign="top">Remote DTE port</td>
<td valign="top"><b><u>A</u></b>, B, C, D</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.DTERTY"><b>DTERTY</b></a></td>
<td valign="top">DTE retry</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.DCERTY"><b>DCERTY</b></a></td>
<td valign="top">DCE retry</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#VFYLNKLPDA.VRYLNKSTS"><b>VRYLNKSTS</b></a></td>
<td valign="top">Link status after test</td>
<td valign="top"><b><u>*SAME</u></b>, *ON, *OFF</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="VFYLNKLPDA.LINE"></a>
<h3>Line (LINE)</h3>
<p>Specifies the name of the line (nonswitched *SDLC) on the link to be tested.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.TEST"></a>
<h3>Test (TEST)</h3>
<p>Specifies which of the four tests is to be run.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*DCELINSTS</u></b></dt>
<dd>Line status of the data circuit-terminating equipment (DCE) is returned.
</dd>
<dt><b>*DCELINTST</b></dt>
<dd>Line testing of the data circuit-terminating equipment (DCE) is done.
</dd>
<dt><b>*ANZLIN</b></dt>
<dd>The analyze line test is done. This test is for analog lines only.
</dd>
<dt><b>*SNDRCV</b></dt>
<dd>The send/receive test is done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.LCLDCEADR"></a>
<h3>Local DCE address (LCLDCEADR)</h3>
<p>Specifies the local data circuit-terminating equipment (DCE) address. By convention, bits 4-7 of this byte indicate the Link Segment Level (LSL) of the local DCE and remote DCE. Bits 0-3 are used to uniquely identify a local DCE among several on the same LSL. The address is set in the local DCE during configuration and should follow this convention.
</p>
<p>
<b>Note: </b>X'00' is not a valid address for a local DCE.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LCL</u></b></dt>
<dd>X'01', the address for the local DCE on LSL 1, is used.
</dd>
<dt><b><i>local-DCE-address</i></b></dt>
<dd>Specify the local DCE address. Valid values range from X'01' through X'FB'.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.RMTDCEADR"></a>
<h3>Remote DCE address (RMTDCEADR)</h3>
<p>Specifies the remote data circuit-terminating equipment (DCE) address.
</p>
<p>This parameter must be specified if you are testing a multipoint link.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*ANY</u></b></dt>
<dd>X'FD', the global remote DCE address is used. If the remote DCE is not idle, it will respond regardless of its previously configured address.
<p>
<b>Note: </b>Multipoint tributary DCEs will not respond to an address of *ANY.
</p>
</dd>
<dt><b><i>remote-DCE-address</i></b></dt>
<dd>Specify the remote DCE address. Valid values range from X'01' through X'FB'.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</dd>
</dl>
<dl>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.SEQCOUNT"></a>
<h3>Number of sequences (SEQCOUNT)</h3>
<p>Specifies the number of sequences to transmit for the send/receive test. A sequence is a group of 16 blocks, with the block length dependent on the configuration of the DCE.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>1 sequence is sent during the test.
</dd>
<dt><b><i>number-of-sequences</i></b></dt>
<dd>Specify the number of sequences to send. Valid values range from 1 through 3.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.DTEPORT"></a>
<h3>Remote DTE port (DTEPORT)</h3>
<p>Specifies the data terminal equipment (DTE) port of the remote DCE for which status will be returned. This parameter is valid only when working with line status and line testing of DCEs. This parameter is meaningful only for multiple port DCEs.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>A</u></b></dt>
<dd>Status will be returned for the A-port.
</dd>
<dt><b>B</b></dt>
<dd>Status will be returned for the B-port.
</dd>
<dt><b>C</b></dt>
<dd>Status will be returned for the C-port.
</dd>
<dt><b>D</b></dt>
<dd>Status will be returned for the D-port.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.DTERTY"></a>
<h3>DTE retry (DTERTY)</h3>
<p>Specifies that this command is a retry of a link operation from the system DTE to the local DCE due to a bad response or no response received from the local DCE.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>This command is not a retry.
</dd>
<dt><b>*YES</b></dt>
<dd>This command is a retry.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.DCERTY"></a>
<h3>DCE retry (DCERTY)</h3>
<p>Specifies whether the local DCE should retry the command to the remote DCE if a bad response or no response is received from the remote DCE.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The local DCE should not retry the command.
</dd>
<dt><b>*YES</b></dt>
<dd>The local DCE should retry the command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="VFYLNKLPDA.VRYLNKSTS"></a>
<h3>Link status after test (VRYLNKSTS)</h3>
<p>Specifies the desired status of the link (varied on or varied off) after the test completes.
</p>
<p>
<b>Note: </b>After running a test on a manually switched link, the link should in most cases be left varied on to allow further information to be received on the same connection. If the switched link is varied off, the failing connection will be lost and no further analysis can be done.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The specified link is returned to the status it was in immediately prior to testing.
</dd>
<dt><b>*ON</b></dt>
<dd>The link remains varied on.
</dd>
<dt><b>*OFF</b></dt>
<dd>The link is varied off.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="VFYLNKLPDA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Checking Line Status</b>
</p>
<p>
<pre>
VFYLNKLPDA LINE(LINE1) DTEPORT(B)
</pre>
</p>
<p>This command retrieves the DCE line status from synchronous data link control (SDLC) line, LINE1, and displays the status. The remote DCEs DTE line connection status of port B is returned if the user is verifying a multiport DCE. An error message will be returned if the remote DTE has only a single port, for example, port A. The default VRYLNKSTS(*SAME) causes the line named LINE1 to return to the status prior to the test.
</p>
<p><b>Example 2: Analyzing a Line</b>
</p>
<p>
<pre>
VFYLNKLPDA LINE(LINE2) TEST(*ANZLIN) OUTPUT(*PRINT)
LCLDCEADR(02) VRYLNKSTS(*ON)
</pre>
</p>
<p>This command analyzes the SDLC line, LINE2. The second LSL is used; the lower four bits of the local DCE address (LCLDCEADR) are 2. The results are sent to a spooled file. After the test, LINE2 remains varied on to allow for more testing.
</p>
<p><b>Example 3: Testing Sending and Receiving Capabilities</b>
</p>
<p>
<pre>
VFYLNKLPDA LINE(LINE3) TEST(*SNDRCV) SEQCOUNT(3)
RMTDCEADR(21) DCERTY(*YES)
</pre>
</p>
<p>This command tests the sending and receiving capabilities on the multipoint line, LINE3. Three sequences of 16 blocks are sent between the local (control) DCE and the remote (tributary) DCE with the address of X'21'. If the local DCE fails to receive a response on the first attempt, the local DCE will retry this command to the remote DCE.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="VFYLNKLPDA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1BAF</b></dt>
<dd>Error occurred while processing VFYLNKLPDA command.
</dd>
<dt><b>CPF1BA9</b></dt>
<dd>Line &amp;1 vary off failed.
</dd>
<dt><b>CPF1BCC</b></dt>
<dd>Test cannot be run at this time.
</dd>
<dt><b>CPF1BCD</b></dt>
<dd>DCE self test failed.
</dd>
<dt><b>CPF1BCE</b></dt>
<dd>Sense byte returned is not valid.
</dd>
<dt><b>CPF1BC1</b></dt>
<dd>Error detected while processing VFYLNKLPDA command.
</dd>
<dt><b>CPF1BC3</b></dt>
<dd>Test cannot run in switched network backup mode.
</dd>
<dt><b>CPF1BC4</b></dt>
<dd>Requested test is not supported.
</dd>
<dt><b>CPF1BC5</b></dt>
<dd>Required feature not installed.
</dd>
<dt><b>CPF1BC6</b></dt>
<dd>Required feature not operational.
</dd>
<dt><b>CPF1BC7</b></dt>
<dd>Test is not compatible with DCE configuration.
</dd>
<dt><b>CPF1BC8</b></dt>
<dd>DTEPORT parameter cannot be specified.
</dd>
<dt><b>CPF1BD1</b></dt>
<dd>Line description &amp;1 is not *SDLC.
</dd>
<dt><b>CPF1BD2</b></dt>
<dd>System Service Tools is active.
</dd>
<dt><b>CPF1BD4</b></dt>
<dd>Not authorized to line description &amp;1.
</dd>
<dt><b>CPF1BD7</b></dt>
<dd>VFYLNKLPDA command does not support switched lines.
</dd>
<dt><b>CPF1B8A</b></dt>
<dd>Line &amp;1 failed during test.
</dd>
<dt><b>CPF1B8B</b></dt>
<dd>No response received for test request.
</dd>
<dt><b>CPF1B8C</b></dt>
<dd>Test cannot be run on line &amp;1.
</dd>
<dt><b>CPF1B8D</b></dt>
<dd>Error occurred while processing VFYLNKLPDA command.
</dd>
<dt><b>CPF1B8E</b></dt>
<dd>Test cannot be run at this time.
</dd>
<dt><b>CPF1B8F</b></dt>
<dd>Test request failed. Test already active on line.
</dd>
<dt><b>CPF1B80</b></dt>
<dd>Line description &amp;1 does not exist.
</dd>
<dt><b>CPF1B81</b></dt>
<dd>Error occurred while getting configuration information.
</dd>
<dt><b>CPF1B83</b></dt>
<dd>Line &amp;1 is not in proper state for test.
</dd>
<dt><b>CPF1B89</b></dt>
<dd>Test cannot be run on line &amp;1.
</dd>
<dt><b>CPF1B9F</b></dt>
<dd>Line &amp;1 cannot be varied off at this time.
</dd>
<dt><b>CPF1B93</b></dt>
<dd>Line &amp;1 did not vary on.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#VFYLNKLPDA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>