629 lines
26 KiB
HTML
629 lines
26 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>Create Configuration List (CRTCFGL)</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="CRTCFGL.Top_Of_Page"></a>
|
||
|
|
<h2>Create Configuration List (CRTCFGL)</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="#CRTCFGL.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTCFGL.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTCFGL.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTCFGL"></a>
|
||
|
|
<p>The Create Configuration List (CRTCFGL) command creates a configuration list.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTCFGL.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="#CRTCFGL.TYPE"><b>TYPE</b></a></td>
|
||
|
|
<td valign="top">Configuration list type</td>
|
||
|
|
<td valign="top">*APPNDIR, *APPNLCL, *APPNRMT, *APPNSSN, *ASYNCADR, *ASYNCLOC, *RTLPASTHR, *SNAPASTHR</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCFGL.CFGL"><b>CFGL</b></a></td>
|
||
|
|
<td valign="top">Configuration list</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCFGL.DFTFTRACN"><b>DFTFTRACN</b></a></td>
|
||
|
|
<td valign="top">Default filter action</td>
|
||
|
|
<td valign="top">*ACCEPT, <b><u>*REJECT</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCFGL.APPNRMTFTR"><b>APPNRMTFTR</b></a></td>
|
||
|
|
<td valign="top">APPN remote CFGL filter</td>
|
||
|
|
<td valign="top"><b><u>*ACCEPT</u></b>, *NONE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCFGL.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTCFGL.APPNLCLE"><b>APPNLCLE</b></a></td>
|
||
|
|
<td valign="top">APPN local location entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Local location name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Entry 'description'</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="13"><a href="#CRTCFGL.APPNRMTE"><b>APPNRMTE</b></a></td>
|
||
|
|
<td valign="top">APPN remote location entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="13">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Remote location name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Generic name, name</i>, *ANY</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Remote network identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b>, *NONE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Local location name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Remote control point</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 5: Control point net ID</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b>, *NONE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 6: Location password</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 7: Secure location</td>
|
||
|
|
<td valign="top">
|
||
|
|
*YES, <b><u>*NO</u></b>, *VFYENCPWD</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 8: Single session</td>
|
||
|
|
<td valign="top">
|
||
|
|
*YES, <b><u>*NO</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 9: Locally controlled session</td>
|
||
|
|
<td valign="top">
|
||
|
|
*YES, <b><u>*NO</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 10: Pre-established session</td>
|
||
|
|
<td valign="top">
|
||
|
|
*YES, <b><u>*NO</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 11: Entry 'description'</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 12: Number of conversations</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-512, <b><u>10</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTCFGL.ASYNCADRE"><b>ASYNCADRE</b></a></td>
|
||
|
|
<td valign="top">Async network address entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Network address</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Dial retry</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-255, <b><u>2</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Entry 'description'</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#CRTCFGL.ASYNCLOCE"><b>ASYNCLOCE</b></a></td>
|
||
|
|
<td valign="top">Async remote location entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Remote location name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Remote location identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Entry 'description'</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#CRTCFGL.RTLPASTHRE"><b>RTLPASTHRE</b></a></td>
|
||
|
|
<td valign="top">Retail pass-through entry</td>
|
||
|
|
<td valign="top">Single values: <b><u>*PROMPT</u></b><br>Other values (up to 50 repetitions): <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Retail device</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: SNUF device</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 3: Default host program</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 4: Entry 'description'</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCFGL.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*CHANGE</u></b>, *ALL, *USE, *EXCLUDE, *LIBCRTAUT</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTCFGL.TYPE"></a>
|
||
|
|
<h3>Configuration list type (TYPE)</h3>
|
||
|
|
<p>Specifies one of five possible configuration list types.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*APPNDIR</b></dt>
|
||
|
|
<dd>An advanced peer-to-peer networking (APPN) directory search filter configuration list is used. Only the text description (TEXT) and default action (DFTACN) parameters can be changed using this command.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To change an entry in an APPN directory configuration list, use the Change Configuration List Entry (CHGCFGLE) command.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPNLCL</b></dt>
|
||
|
|
<dd>Advance peer-to-peer networking (APPN) local location list. Up to 476 APPN local location entries are allowed in the configuration list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPNRMT</b></dt>
|
||
|
|
<dd>APPN remote location list. Up to 1898 APPN remote location entries are allowed in the configuration list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*APPNSSN</b></dt>
|
||
|
|
<dd>An APPN session end point filter configuration list is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASYNCADR</b></dt>
|
||
|
|
<dd>An asynchronous network address list is created. Up to 294 Asynchronous network address entries are allowed in the configuration list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ASYNCLOC</b></dt>
|
||
|
|
<dd>An asynchronous remote location list is created. Up to 32000 Asynchronous remote location entries are allowed in the configuration list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RTLPASTHR</b></dt>
|
||
|
|
<dd>Retail pass-through list. Up to 450 Retail pass-through entries are allowed in the configuration list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*SNAPASTHR</b></dt>
|
||
|
|
<dd>An SNA pass-through list. Up to 254 SNA pass-through entries are allowed in the configuration list. Only the text description for an SNA configuration list can be specified using this command.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>To add an entry to an SNA configuration list, use the Add Configuration List Entry (ADDCFGLE) command.
|
||
|
|
</p>
|
||
|
|
<p>To add a device name and description to an existing entry, use the Change Configuration List Entry (CHGCFGLE) command.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.CFGL"></a>
|
||
|
|
<h3>Configuration list (CFGL)</h3>
|
||
|
|
<p>Specifies the name of the configuration list. This value is required and valid only when the configuration list is an asynchronous network address list (*ASYNCADR is specified for the <b>Configuration list type (TYPE)</b> parameter). The list types have system-supplied names: QAPPNLCL, QAPPNRMT, QASYNCADR, QASYNCLOC, QRTLPASTHR, and QSNAPASSTHR.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.DFTFTRACN"></a>
|
||
|
|
<h3>Default filter action (DFTFTRACN)</h3>
|
||
|
|
<p>Specifies the default filter action for APPN requests being handled by the local system. This filter action applies to all directory search requests and session endpoint requests that are not specifically listed in the configuration list.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if TYPE(*APPNDIR) or TYPE(*APPNSSN) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*REJECT</u></b></dt>
|
||
|
|
<dd>The request is rejected.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ACCEPT</b></dt>
|
||
|
|
<dd>The request is accepted.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.APPNRMTFTR"></a>
|
||
|
|
<h3>APPN remote CFGL filter (APPNRMTFTR)</h3>
|
||
|
|
<p>Specifies whether APPN remote configuration list entries should be used when filtering session endpoint requests.
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This parameter is valid only if TYPE(*APPNSSN) is specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ACCEPT</u></b></dt>
|
||
|
|
<dd>Session endpoint requests for entries specified in the APPN remote configuration list are accepted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>Session endpoint requests will not be filtered using the entries specified in the APPN remote configuration list.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the text that briefly describes the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is 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="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.APPNLCLE"></a>
|
||
|
|
<h3>APPN local location entry (APPNLCLE)</h3>
|
||
|
|
<p>Specifies the APPN local location entry. This value is required if *APPNLCL is specified for the <b>Configuration list type</b> prompt (TYPE parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PROMPT</b></dt>
|
||
|
|
<dd>The special value of *PROMPT allows you to add, remove, and change entries using a full screen entry panel.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>local-location-name</i></b></dt>
|
||
|
|
<dd>Specify the location name residing on the local system. This name is used by APPN to determine if the request coming in is for this system or another system in the network. The local location name must be unique and cannot already exist as a remote location name used by configuration list QAPPNRMT, or be specified on another system as a local location in the same APPN network.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>entry-description</i></b></dt>
|
||
|
|
<dd>Specify a short description of 20 characters or less for each local entry.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.APPNRMTE"></a>
|
||
|
|
<h3>APPN remote location entry (APPNRMTE)</h3>
|
||
|
|
<p>Specifies the APPN remote location entry. This value is required if *APPNRMT is specified for the <b>Configuration list type</b> prompt (TYPE parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PROMPT</b></dt>
|
||
|
|
<dd>The special value of *PROMPT allows you to add, remove, and change entries using a full screen entry panel.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
||
|
|
<dd>Specify the full name of a remote location or a generic name ending with an asterisk (*). The generic location name is used to allow one directory entry to be defined for all locations, on a single control point, whose name matches the characters preceding the asterisk. You can also specify *ANY so the system will accept all requests sent through it. Generic entries are only allowed from network nodes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>remote-network-identifier</i></b></dt>
|
||
|
|
<dd>Specify the network identifier of the network in which the remote location resides. The default of *NETATR uses the LCLNETID value from the system network attributes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>local-location-name</i></b></dt>
|
||
|
|
<dd>Specify the location name residing on the local system. This name is used by APPN to match a local/remote location pair entry. The default of *NETATR uses the LCLLOCNAME value from the system network attributes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-point-name</i></b></dt>
|
||
|
|
<dd>Specify the control point providing network functions for the remote location. By using this control point name (directory entry for the remote location), the network is searched more efficiently to find the location. This field is required if the remote location name is generic. The default is *NONE.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-point-network-identifier</i></b></dt>
|
||
|
|
<dd>Specify the network identifier of the network in which the control point resides. The default of *NETATR uses the LCLNETID value from the system network attributes.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>location-password</i></b></dt>
|
||
|
|
<dd>Specify the password that is used when establishing sessions on the local location/remote location name pair. This value must contain an even number of hexadecimal characters. The default is *NONE.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>secure-location</i></b></dt>
|
||
|
|
<dd>Specifies how security information is handled for program start requests received from remote systems. The value is sent to the remote system when sessions are established. It is used in determining how allocate or evoke requests should be built. The value only applies to conversations started with the SECURITY(SAME) level of security.
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>The remote system is not a secure location. Security validation done by the remote system is not accepted. SECURITY(SAME) conversations are treated as SECURITY(NONE). No security information will be sent with allocate or evoke requests.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The remote system is a secure location and the local system will accept security validation done by remote systems. For SECURITY(SAME) conversations, the local system allows the remote system to verify user passwords. On the remote system, user IDs are retrieved from the operating system. The user IDs are then sent with an already verified indicator in the allocate or evoke requests.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*VFYENCPWD</b></dt>
|
||
|
|
<dd>The remote system is not a secure location. For SECURITY(SAME) conversations, the remote system is not allowed to send the already verified indicator. On the remote system, user IDs and passwords are retrieved from the operating system. Passwords are then encrypted and sent with the user IDs in the allocate or evoke requests, to be verified by the local system. This value should only be used if the remote system is using i5/OS V3R2M0 or later. If the remote system does not support password protection then session establishment will not be allowed. For remote systems that support password protection, but do not support verification of encrypted passwords (VFYENCPWD), conversations will be treated as SECURITY(NONE).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>number-of-conversations</i></b></dt>
|
||
|
|
<dd>Specify the number of conversations for a single session connection. The default number of conversations is 10. The default value must be used if single session is *NO. The valid range for the number of conversations is 1 through 512.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>locally-controlled-session</i></b></dt>
|
||
|
|
<dd>Specify YES or NO to indicate whether a locally controlled session is allowed for this local location/remote location name pair. The default is *NO.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>pre-established-session</i></b></dt>
|
||
|
|
<dd>Specify YES or NO to indicate whether the session is automatically bound when a connection is made between the local and remote location. The default is *NO.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>entry-description</i></b></dt>
|
||
|
|
<dd>Specify a short description for each remote entry. The default is *BLANK.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The combination of remote location name, network identifier, and local location name must be unique. Also, the remote location name can not already exist as a local location in configuration list QAPPNLCL, or as the current value for LCLLOCNAME or LCLCPNAME network attribute.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.ASYNCADRE"></a>
|
||
|
|
<h3>Async network address entry (ASYNCADRE)</h3>
|
||
|
|
<p>Specifies the asynchronous network address entry. This value is required if *ASYNCADR is specified for the <b>Configuration list type</b> prompt (TYPE parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PROMPT</b></dt>
|
||
|
|
<dd>The special value of *PROMPT allows you to add, remove, and change entries using a full screen entry panel.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>network-address</i></b></dt>
|
||
|
|
<dd>Specify the X.25 network address. This value must contain only digits 0-9.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>dial-retry</i></b></dt>
|
||
|
|
<dd>Specify the number of times that dialing will be tried again when errors occur while dialing, before attempting to dial the next number on the list. The valid range of dial retries is 1-255.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>entry-description</i></b></dt>
|
||
|
|
<dd>Specify a short description for each network address entry.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.ASYNCLOCE"></a>
|
||
|
|
<h3>Async remote location entry (ASYNCLOCE)</h3>
|
||
|
|
<p>Specifies the asynchronous remote location entry. This value is required if *ASYNCLOC is specified for the <b>Configuration list type</b> prompt (TYPE parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PROMPT</b></dt>
|
||
|
|
<dd>The special value of *PROMPT allows you to add, remove, and change entries using a full screen entry panel.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>remote-location-name</i></b></dt>
|
||
|
|
<dd>Specify the name that, when combined with the remote location identifier, determines whether to accept an incoming call. It is the same as the name used in the remote system as it's local name. This value must be unique.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>remote-location-identifier</i></b></dt>
|
||
|
|
<dd>Specify an identifier that, when combined with the remote location name, determines if an incoming call will be accepted. This identifier must be the same as the remote system has for its local identifier.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>entry-description</i></b></dt>
|
||
|
|
<dd>Specify a short description for each remote location entry. The default is *BLANK.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.RTLPASTHRE"></a>
|
||
|
|
<h3>Retail pass-through entry (RTLPASTHRE)</h3>
|
||
|
|
<p>Specifies the retail pass-through entry. This value is required if *RTLPASTHR is specified for the <b>Configuration list type</b> prompt (TYPE parameter).
|
||
|
|
</p>
|
||
|
|
<p>You can enter multiple values for this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*PROMPT</b></dt>
|
||
|
|
<dd>The special value of *PROMPT allows you to add, remove, and change entries using a full screen entry panel.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
</dl>
|
||
|
|
<p>A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>retail-device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the retail device that communicates with the host. This value must be unique.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>SNUF-device-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the SNUF device through which the retail device communicates with the host. This value must be unique.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>Default-host-program-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the program to be started on the host if the program name is not present in the SNA command (INIT-SELF) that requests a session to be started.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>entry-description</i></b></dt>
|
||
|
|
<dd>Specify a short description for each retail pass-through entry. The default is *BLANK.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCFGL.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CHANGE</u></b></dt>
|
||
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*EXCLUDE</b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*LIBCRTAUT</b></dt>
|
||
|
|
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTCFGL.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTCFGL TYPE(*APPNLCL)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command brings up a full-screen entry display that allows the user to add new entries to configuration list QAPPNLCL.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTCFGL.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2182</b></dt>
|
||
|
|
<dd>Not authorized to library &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF260D</b></dt>
|
||
|
|
<dd>Configuration list &1 already exists.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF260E</b></dt>
|
||
|
|
<dd>Configuration list &1 not created.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF261C</b></dt>
|
||
|
|
<dd>Index for configuration list &1 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF261D</b></dt>
|
||
|
|
<dd>Index for configuration list &1 not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF261F</b></dt>
|
||
|
|
<dd>Configuration list &1 has been deleted.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2625</b></dt>
|
||
|
|
<dd>Not able to allocate object &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2634</b></dt>
|
||
|
|
<dd>Not authorized to object &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9838</b></dt>
|
||
|
|
<dd>User profile storage limit exceeded.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCFGL.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|