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

855 lines
40 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 Network Attributes (RTVNETA)</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="RTVNETA.Top_Of_Page"></a>
<h2>Retrieve Network Attributes (RTVNETA)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVNETA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVNETA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVNETA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVNETA"></a>
<p>The Retrieve Network Attributes (RTVNETA) command is used in a CL program or REXX procedure to retrieve the network attributes of the system. The values are returned (copied) to the specified variables in the program.
</p>
<p><b>Restrictions:</b> The attributes of the network attribute and the receiving variable must be compatible.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVNETA.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="#RTVNETA.SYSNAME"><b>SYSNAME</b></a></td>
<td valign="top">CL var for SYSNAME (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.PNDSYSNAME"><b>PNDSYSNAME</b></a></td>
<td valign="top">CL var for PNDSYSNAME (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.LCLNETID"><b>LCLNETID</b></a></td>
<td valign="top">CL var for LCLNETID (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.LCLCPNAME"><b>LCLCPNAME</b></a></td>
<td valign="top">CL var for LCLCPNAME (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">CL var for LCLLOCNAME (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DFTMODE"><b>DFTMODE</b></a></td>
<td valign="top">CL var for DFTMODE (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.NODETYPE"><b>NODETYPE</b></a></td>
<td valign="top">CL var for NODETYPE (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DTACPR"><b>DTACPR</b></a></td>
<td valign="top">CL var for DTACPR (10 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DTACPRINM"><b>DTACPRINM</b></a></td>
<td valign="top">CL var for DTACPRINM (10 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.MAXINTSSN"><b>MAXINTSSN</b></a></td>
<td valign="top">CL var for MAXINTSSN (5 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.RAR"><b>RAR</b></a></td>
<td valign="top">CL var for RAR (5 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.NETSERVER"><b>NETSERVER</b></a></td>
<td valign="top">CL var for NETSERVER (85)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRSTS"><b>ALRSTS</b></a></td>
<td valign="top">CL var for ALRSTS (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRPRIFP"><b>ALRPRIFP</b></a></td>
<td valign="top">CL var for ALRPRIFP (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRDFTFP"><b>ALRDFTFP</b></a></td>
<td valign="top">CL var for ALRDFTFP (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRLOGSTS"><b>ALRLOGSTS</b></a></td>
<td valign="top">CL var for ALRLOGSTS (7)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRBCKFP"><b>ALRBCKFP</b></a></td>
<td valign="top">CL var for ALRBCKFP (16)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRRQSFP"><b>ALRRQSFP</b></a></td>
<td valign="top">CL var for ALRRQSFP (16)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRCTLD"><b>ALRCTLD</b></a></td>
<td valign="top">CL var for ALRCTLD (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRHLDCNT"><b>ALRHLDCNT</b></a></td>
<td valign="top">CL var for ALRHLDCNT (5 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRFTR"><b>ALRFTR</b></a></td>
<td valign="top">CL var for ALRFTR (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALRFTRLIB"><b>ALRFTRLIB</b></a></td>
<td valign="top">CL var for ALRFTRLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">CL var for MSGQ (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.MSGQLIB"><b>MSGQLIB</b></a></td>
<td valign="top">CL var for MSGQLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.OUTQ"><b>OUTQ</b></a></td>
<td valign="top">CL var for OUTQ (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.OUTQLIB"><b>OUTQLIB</b></a></td>
<td valign="top">CL var for OUTQLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.JOBACN"><b>JOBACN</b></a></td>
<td valign="top">CL var for JOBACN (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.MAXHOP"><b>MAXHOP</b></a></td>
<td valign="top">CL var for MAXHOP (5 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DDMACC"><b>DDMACC</b></a></td>
<td valign="top">CL var for DDMACC (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DDMACCLIB"><b>DDMACCLIB</b></a></td>
<td valign="top">CL var for DDMACCLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.PCSACC"><b>PCSACC</b></a></td>
<td valign="top">CL var for PCSACC (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.PCSACCLIB"><b>PCSACCLIB</b></a></td>
<td valign="top">CL var for PCSACCLIB (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DFTNETTYPE"><b>DFTNETTYPE</b></a></td>
<td valign="top">CL var for DFTNETTYPE (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.DFTCNNLST"><b>DFTCNNLST</b></a></td>
<td valign="top">CL var for DFTCNNLST (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALWANYNET"><b>ALWANYNET</b></a></td>
<td valign="top">CL var for ALWANYNET (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.NWSDOMAIN"><b>NWSDOMAIN</b></a></td>
<td valign="top">CL var for NWSDOMAIN (8)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALWVRTAPPN"><b>ALWVRTAPPN</b></a></td>
<td valign="top">CL var for ALWVRTAPPN (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALWHPRTWR"><b>ALWHPRTWR</b></a></td>
<td valign="top">CL var for ALWHPRTWR (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.VRTAUTODEV"><b>VRTAUTODEV</b></a></td>
<td valign="top">CL var for VRTAUTODEV (5 0)</td>
<td valign="top"><i>Decimal number</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.HPRPTHTMR"><b>HPRPTHTMR</b></a></td>
<td valign="top">CL var for HPRPTHTMR (40)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.ALWADDCLU"><b>ALWADDCLU</b></a></td>
<td valign="top">CL var for ALWADDCLU (10)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVNETA.MDMCNTRYID"><b>MDMCNTRYID</b></a></td>
<td valign="top">CL var for MDMCNTRYID (2)</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVNETA.SYSNAME"></a>
<h3>CL var for SYSNAME (8) (SYSNAME)</h3>
<p>Specifies the name of the CL variable that receives the current system name. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.PNDSYSNAME"></a>
<h3>CL var for PNDSYSNAME (8) (PNDSYSNAME)</h3>
<p>Specifies the name of the CL variable that receives the pending system name. The variable must be a character variable with a minimum length of 8 characters. If there is no pending system name, the value returned is blanks.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.LCLNETID"></a>
<h3>CL var for LCLNETID (8) (LCLNETID)</h3>
<p>Specifies the name of the CL variable that receives the local network ID. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.LCLCPNAME"></a>
<h3>CL var for LCLCPNAME (8) (LCLCPNAME)</h3>
<p>Specifies the name of the CL variable that receives the local control point name. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.LCLLOCNAME"></a>
<h3>CL var for LCLLOCNAME (8) (LCLLOCNAME)</h3>
<p>Specifies the name of the CL variable that receives the default local location name. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DFTMODE"></a>
<h3>CL var for DFTMODE (8) (DFTMODE)</h3>
<p>Specifies the name of the CL variable that receives the default mode name. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.NODETYPE"></a>
<h3>CL var for NODETYPE (8) (NODETYPE)</h3>
<p>Specifies the name of the CL variable that receives the APPN node type. The variable must be a character variable with a minimum length of 8 characters.
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*ENDNODE</b></dt>
<dd>The node does not provide network services to other nodes but can participate in the APPN network by using the services of an attached network server or can operate in a peer environment similar to low entry networking nodes.
</dd>
<dt><b>*NETNODE</b></dt>
<dd>The node provides intermediate routing, route selection services, and distributed directory services for local users and to end nodes and low entry networking nodes that it is serving.
</dd>
<dt><b>*BEXNODE</b></dt>
<dd>The node performs as a branch extender node. The node performs as an end node in the backbone APPN network, and performs as a network node server to end nodes within its local domain.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DTACPR"></a>
<h3>CL var for DTACPR (10 0) (DTACPR)</h3>
<p>Specifies the name of the CL variable that receives the current level of data compression. Specify the name of the decimal variable with a minimum length of 10 digits without decimal positions.
</p>
<p>The values that can be returned in the variable as the data compression level are:
</p>
<dl>
<dt><b>0</b></dt>
<dd>*NONE - Data compression is not allowed on the session.
</dd>
<dt><b>-1</b></dt>
<dd>*REQUEST - Data compression is requested on the session by the local system. However, the request can be refused or changed to a lower compression level by the remote system. Data compression is allowed on the session if requested by the remote system.
</dd>
<dt><b>-2</b></dt>
<dd>*ALLOW - Data compression is allowed on the session by the local system if requested by a remote system. The local system does not request compression.
</dd>
<dt><b>-3</b></dt>
<dd>*REQUIRE - Data compression is required on the session. If the remote system does not change the levels of compression to the local system's exact requested levels, the session is not established. The data compression levels that the local system requires are the specified levels.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DTACPRINM"></a>
<h3>CL var for DTACPRINM (10 0) (DTACPRINM)</h3>
<p>Specifies the name of the CL variable that receives the current level of intermediate node data compression. Specify the name of the decimal variable with a minimum length of 10 digits without decimal positions.
</p>
<p>The values that can be returned in the variable as the intermediate node data compression levels are:
</p>
<dl>
<dt><b>0</b></dt>
<dd>*NONE - The remote systems are not notified of a need to compress data when the system is an SNA intermediate node.
</dd>
<dt><b>-1</b></dt>
<dd>*REQUEST - The remote systems are requested to compress data when the system is an SNA intermediate node.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.MAXINTSSN"></a>
<h3>CL var for MAXINTSSN (5 0) (MAXINTSSN)</h3>
<p>Specifies the name of the CL variable that receives the maximum number of intermediate sessions. Specify the name of a decimal variable with a minimum length of 5 digits and no decimal positions.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.RAR"></a>
<h3>CL var for RAR (5 0) (RAR)</h3>
<p>Specifies the name of the CL variable that receives the route addition resistance. Specify the name of a decimal variable with a minimum length of 5 digits and no decimal positions.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.NETSERVER"></a>
<h3>CL var for NETSERVER (85) (NETSERVER)</h3>
<p>Specifies the name of the CL variable that receives the list of network node servers. Specify the name of a character variable with a minimum length of 85 characters. If the server name or network ID has fewer characters than the variable allows, the value is padded on the right with blanks. The list contains five node servers. Each server has the form: Network ID (9 characters) followed by the server name (8 characters). There are no separators. The network ID can contain the value *LCLNETID, which specifies that the current network ID is used. If there are less than five node servers specified, the remaining ones contain blanks for a name. As soon as the first blank name is encountered in the list, it is safe to assume that the remaining names are also blank.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRSTS"></a>
<h3>CL var for ALRSTS (10) (ALRSTS)</h3>
<p>Specifies the name of the CL variable that receives the alert status. Specify the name of a character variable with a minimum length of 10 characters. (If the alert status value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*ON</b></dt>
<dd>Alerts are created by the system for all alert conditions, except unattended conditions.
</dd>
<dt><b>*OFF</b></dt>
<dd>Alerts are not created by the system.
</dd>
<dt><b>*UNATTEND</b></dt>
<dd>Alerts are created by the system for all alert conditions, including messages for which *UNATTEND is specified for the <b>Alert options (ALROPT)</b> parameter of the Add Message Description (ADDMSGD) or Change Message Description (CHGMSGD) command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRPRIFP"></a>
<h3>CL var for ALRPRIFP (10) (ALRPRIFP)</h3>
<p>Specifies the name of the CL variable that receives the alert primary focal point. Specify the name of the CL variable with a minimum length of 10 characters. (If the alert primary focal point value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the variable:
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The system is not an alert primary focal point.
</dd>
<dt><b>*YES</b></dt>
<dd>The system is an alert primary focal point.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRDFTFP"></a>
<h3>CL var for ALRDFTFP (10) (ALRDFTFP)</h3>
<p>Specifies the name of the CL variable that receives the value for the alert default focal point. Specify a CL variable with a minimum length of 10 characters. (If the alert default focal point value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the variable:
</p>
<dl>
<dt><b>*NO</b></dt>
<dd>The system is not an alert default focal point.
</dd>
<dt><b>*YES</b></dt>
<dd>The system is an alert default focal point.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRLOGSTS"></a>
<h3>CL var for ALRLOGSTS (7) (ALRLOGSTS)</h3>
<p>Specifies the name of the CL variable that receives the alert logging status. The variable must be a character variable with a minimum length of 7 characters.
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No alerts are logged.
</dd>
<dt><b>*LOCAL</b></dt>
<dd>Only locally created alerts are logged.
</dd>
<dt><b>*RCV</b></dt>
<dd>Only alerts received from other nodes are logged.
</dd>
<dt><b>*ALL</b></dt>
<dd>Both locally created alerts and alerts received from other nodes are logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRBCKFP"></a>
<h3>CL var for ALRBCKFP (16) (ALRBCKFP)</h3>
<p>Specifies the name of the CL variable that receives the name of the system that provides alert focal point services if the primary focal point is unavailable. Specify the name of a character variable with a minimum length of 16 characters. (If the back up system name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRRQSFP"></a>
<h3>CL var for ALRRQSFP (16) (ALRRQSFP)</h3>
<p>Specifies the name of the CL variable that receives the name of the system that is requested to provide alert focal point services. Specify the name of a character variable with a minimum length of 16 characters. (If the requesting system name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRCTLD"></a>
<h3>CL var for ALRCTLD (10) (ALRCTLD)</h3>
<p>Specifies the name of the CL variable that receives the name of the controller through which alert messages are sent to another system when alert processing is active. Specify a CL variable with a minimum length of 10 characters. (If the alert controller name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the variable:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>There is no controller for alerts.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specifies the name of the controller being used for alerts in an alert controller session. This controller is ignored if the system has a primary or default alert focal point (if, for example, the node is in another system's sphere of control).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRHLDCNT"></a>
<h3>CL var for ALRHLDCNT (5 0) (ALRHLDCNT)</h3>
<p>Specifies the name of the CL variable that receives the maximum number of alerts that are created before the alerts are sent over the alert controller session (ALRCTLD network attribute). The alerts are held (queued) by the system until the specified number of alerts have been created. This parameter can be used to manage alerts that are sent over a limited resource by reducing the number of times alerts are sent.
</p>
<p>
<b>Note: </b>The ALRHLDCNT network attribute only applies when the ALRCTLD network attribute is used. When management services sessions, APPN, and sphere of control support are used, the ALRHLDCNT value is ignored.
</p>
<p>The maximum number of alerts that can be created before the alerts are sent is 32,767. Specify the name of a decimal variable with a total length of 5 digits without decimal positions.
</p>
<p>The following values can be returned in the variable:
</p>
<dl>
<dt><b>-2</b></dt>
<dd>This value represents *NOMAX. The alerts are held indefinitely. The current alert hold count is the maximum value. The alerts can be sent at a later time by changing the ALRHLDCNT value to a lower value.
</dd>
<dt><b><i>0-32767</i></b></dt>
<dd>Specifies the maximum number of alerts that can be created before being sent. Alerts have a "held" status until the maximum is reached. If the value 0 is specified, alerts are sent as soon as they are created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRFTR"></a>
<h3>CL var for ALRFTR (10) (ALRFTR)</h3>
<p>Specifies the name of the CL variable that receives the name of the active alert filter. Specify the name of a character variable with a minimum length of 10 characters. (If the alert filter name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALRFTRLIB"></a>
<h3>CL var for ALRFTRLIB (10) (ALRFTRLIB)</h3>
<p>Specifies the name of the CL variable that receives the name of the library that contains the alert filter definition. Specify the name of a character variable with a minimum length of 10 characters. If the library name has fewer characters than the variable allows, the value is padded on the right with blanks.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.MSGQ"></a>
<h3>CL var for MSGQ (10) (MSGQ)</h3>
<p>Specifies the name of the CL variable that receives the system default network message queue name. Specify the name of a character variable with a minimum length of 10 characters. (If the message queue name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.MSGQLIB"></a>
<h3>CL var for MSGQLIB (10) (MSGQLIB)</h3>
<p>Specifies the name of the CL variable that receives the name of the library that contains the system-default network message queue. Specify the name of a character variable with a minimum length of 10 characters. (If the library name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.OUTQ"></a>
<h3>CL var for OUTQ (10) (OUTQ)</h3>
<p>Specifies the name of the CL variable that receives the system default network output queue name. Specify the name of a character variable with a minimum length of 10 characters. (If the output queue name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.OUTQLIB"></a>
<h3>CL var for OUTQLIB (10) (OUTQLIB)</h3>
<p>Specifies the name of the CL variable that receives the name of the library that contains the system-default network output queue. Specify the name of a character variable with a minimum length of 10 characters. (If the library name has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.JOBACN"></a>
<h3>CL var for JOBACN (10) (JOBACN)</h3>
<p>Specifies the name of the CL variable that receives the current job action for job streams received through the network. Specify the variable with a minimum length of 10 characters. (If the job action value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*REJECT</b></dt>
<dd>The input stream is rejected by the system. This action allows you to secure your system from job streams received through the network.
</dd>
<dt><b>*FILE</b></dt>
<dd>The input stream is filed in the queue of network files received by the user to whom it was sent. That user can then view, end, or receive the input stream, or submit the input stream to a job queue.
</dd>
<dt><b>*SEARCH</b></dt>
<dd>The table of network job entries is searched to determine the action taken for the input stream.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.MAXHOP"></a>
<h3>CL var for MAXHOP (5 0) (MAXHOP)</h3>
<p>Specifies the name of the CL variable that receives the maximum number of times in the SNADS network that a distribution queue originating at this node can be received and rerouted on the path to its final destination. Specify the name of a decimal variable with a total length of 5 digits, and no decimal positions.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DDMACC"></a>
<h3>CL var for DDMACC (10) (DDMACC)</h3>
<p>Specifies the name of the CL variable that receives the current system action for DDM or DRDA requests from other systems. Specify the CL variable with a minimum length of 10 characters. (If the DDM access value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*REJECT</b></dt>
<dd>This system does not allow DDM and DRDA requests from remote systems. However, this system can still use DDM or DRDA to access files or SQL tables on remote systems. Source (client) systems cannnot access files or SQL tables on any other system that specifies *REJECT.
</dd>
<dt><b>*OBJAUT</b></dt>
<dd>If the user profile associated with the DDM or DRDA job is authorized to the files, all file or remote SQL requests are accepted. Object authorities such as read, write, or update must also exist for the files.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specifies the name of the customer validation program that can supplement object level security. This user-exit program can restrict user access to *PUBLIC and private files. The target DDM support calls the user program for each reference to a file. The user-exit program indicates to DDM if the request should proceed or end. In the case of DRDA use, the validation program is called only for connection requests, not for individual file access.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DDMACCLIB"></a>
<h3>CL var for DDMACCLIB (10) (DDMACCLIB)</h3>
<p>Specifies the name of the CL variable that receives the name of the library that contains the DDM access program. Specify the name of a character variable with a minimum length of 10 characters. (If the library name has fewer characters than the variable allows, the value is padded on the right with blanks.) If *REJECT or *OBJAUT is returned for the <b>CL var for DDMACC (10) (DDMACC)</b> parameter, the value for this parameter is all blanks.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.PCSACC"></a>
<h3>CL var for PCSACC (10) (PCSACC)</h3>
<p>Specifies the name of the CL variable that receives the current system action for iSeries Access requests. Specify a CL variable with a minimum length of 10 characters. (If the iSeries Access access value has fewer characters than the variable allows, the value is padded on the right with blanks.)
</p>
<p>The following values can be returned in the CL variable:
</p>
<dl>
<dt><b>*REJECT</b></dt>
<dd>The system does not allow any iSeries Access requests.
</dd>
<dt><b>*OBJAUT</b></dt>
<dd>All iSeries Access requests are allowed and controlled by the object authorizations on the system.
</dd>
<dt><b>*REGFAC</b></dt>
<dd>The registration facility is used to determine exit programs for the different servers. If no program is defined in the registration facility, *OBJAUT is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>The name of the customer supplied iSeries Access host system application exit program that can supplement system object level security.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.PCSACCLIB"></a>
<h3>CL var for PCSACCLIB (10) (PCSACCLIB)</h3>
<p>Specifies the name of the CL variable that receives the name of the library that contains the iSeries Access access program. You must specify the name of a character variable with a minimum length of 10 characters. (If the library name has fewer characters than the variable allows, the value is padded on the right with blanks.) If *REJECT, *REGFAC, or *OBJAUT is returned for the <b>CL var for PCSACC (10) (PCSACC)</b> parameter, the value for this parameter will be all blanks.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DFTNETTYPE"></a>
<h3>CL var for DFTNETTYPE (10) (DFTNETTYPE)</h3>
<p>Specifies the name of the CL variable that receives the system default value for the Integrated Services Digital Network (ISDN) network type. The operating system no longer uses this network attribute. Changes made to this network attribute have no effect. The variable must be a character variable with a minimum length of 10 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.DFTCNNLST"></a>
<h3>CL var for DFTCNNLST (10) (DFTCNNLST)</h3>
<p>Specifies the name of the CL variable that receives the system default value for the ISDN connection list. The operating system no longer uses this network attribute. Changes made to this network attribute have no effect. The variable must be a character variable with a minimum length of 10 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALWANYNET"></a>
<h3>CL var for ALWANYNET (10) (ALWANYNET)</h3>
<p>Specifies the name of the CL variable that receives the network attribute that allows the Communications APIs to use other communication transports that are not native for that API. Examples include ICF over TCP/IP or Sockets over SNA. The variable must be a character variable with a minimum length of 10 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.NWSDOMAIN"></a>
<h3>CL var for NWSDOMAIN (8) (NWSDOMAIN)</h3>
<p>Specifies the name of the CL variable that receives the LAN Server domain to which all integrated PC Servers, also knows as File Server Input/Output Processors(FSIOP), on the system belong. The variable must be a character variable with a minimum length of 8 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALWVRTAPPN"></a>
<h3>CL var for ALWVRTAPPN (10) (ALWVRTAPPN)</h3>
<p>Specifies the name of the CL variable that receives the current setting for the virtual APPN support. The character variable must have a minimum length of 10 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALWHPRTWR"></a>
<h3>CL var for ALWHPRTWR (10) (ALWHPRTWR)</h3>
<p>Specifies the name of the CL variable that receives the current setting for the HPR tower transport support. The character variable must have a minimum length of 10 characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.VRTAUTODEV"></a>
<h3>CL var for VRTAUTODEV (5 0) (VRTAUTODEV)</h3>
<p>Specifies the name of the CL variable that receives the current setting for the maximum amount of automatically created APPC devices allowed on a virtual controller. Specify the name of a decimal variable with a total length of 5 digits, and no decimal positions.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.HPRPTHTMR"></a>
<h3>CL var for HPRPTHTMR (40) (HPRPTHTMR)</h3>
<p>Specifies the name of the CL variable that receives the current settings for the maximum amount of time in minutes for the HPR path switch timers. This field requires a 40 character variable, each 10 characters represents one of the four timer values in the order of network, high, medium and low priority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.ALWADDCLU"></a>
<h3>CL var for ALWADDCLU (10) (ALWADDCLU)</h3>
<p>Specifies the name of the CL variable that receives the value that specifies whether this system will allow another system to add it as a node in a cluster. The character variable must have a minimum length of 10 characters.
</p>
<p>The values that can be returned in the variable for allow add to cluster are:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No other system can add this system as a node in a cluster.
</dd>
<dt><b>*ANY</b></dt>
<dd>Any other system can add this system as a node in a cluster.
</dd>
<dt><b>*RQSAUT</b></dt>
<dd>Any other system can add this system as a node in a cluster only after the cluster add request has been authenticated.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVNETA.MDMCNTRYID"></a>
<h3>CL var for MDMCNTRYID (2) (MDMCNTRYID)</h3>
<p>Specifies the name of the CL variable that receives the network attribute for the country or region identifier associated with a modem. The character variable must have a minimum length of 2 characters.
</p>
<p>MDMCNTRYID defines the country-specific or region-specific default characteristics for modems which are internal to system I/O adapters. This value must be configured correctly to insure proper operation and, in some countries or regions, meet legal requirements. The adapter will fail the vary on of the line if modem country or region ID is not set.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVNETA.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Retrieving Current System Name</b>
</p>
<p>
<pre>
DCL VAR(&amp;SNAME) TYPE(*CHAR) LEN(8)
RTVNETA SYSNAME(&amp;SNAME)
</pre>
</p>
<p>This command retrieves the current system name.
</p>
<p><b>Example 2: Retrieving Virtual APPN Support, APPC Device Limits, and HPR Path Switch Timers</b>
</p>
<p>
<pre>
DCL VAR(&amp;ALWVRTAPPN) TYPE(*CHAR) LEN(10)
DCL VAR(&amp;VRTAUTODEV) TYPE(*DEC) LEN(5 0)
DCL VAR(&amp;HPRPTHTMR) TYPE(*CHAR) LEN(40)
RTVNETA ALWVRTAPPN(&amp;ALWVRTAPPN) VRTAUTODEV(&amp;VRTAUTODEV)
HPRPTHTMR(&amp;HPRPTHTMR)
</pre>
</p>
<p>This command retrieves the current network attribute settings for allow virtual APPN support, automatically created APPC devices on a virtual controller, and the HPR path switch timers.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVNETA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1844</b></dt>
<dd>Cannot access network attribute &amp;1.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVNETA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>