362 lines
13 KiB
HTML
362 lines
13 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 Configuration Source (RTVCFGSRC)</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="RTVCFGSRC.Top_Of_Page"></a>
|
|
<h2>Retrieve Configuration Source (RTVCFGSRC)</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="#RTVCFGSRC.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#RTVCFGSRC.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#RTVCFGSRC.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="RTVCFGSRC"></a>
|
|
<p>The Retrieve Configuration Source (RTVCFGSRC) command is used to retrieve the CL source statements which describe existing configuration objects. These source statements are placed into a source file member. The CL source may be used to re-create the configuration objects.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="RTVCFGSRC.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="#RTVCFGSRC.CFGD"><b>CFGD</b></a></td>
|
|
<td valign="top">Configuration description</td>
|
|
<td valign="top">Single values: *ALL<br>Other values (up to 256 repetitions): <i>Generic name, name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVCFGSRC.CFGTYPE"><b>CFGTYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top">*ALL, *NWSD, *NWID, *LIND, *CTLD, *DEVD, *MODD, *COSD, *CNNL, *NTBD</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#RTVCFGSRC.SRCFILE"><b>SRCFILE</b></a></td>
|
|
<td valign="top">Source file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Source file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QCLSRC</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#RTVCFGSRC.SRCMBR"><b>SRCMBR</b></a></td>
|
|
<td valign="top">Source member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*CFGD</u></b></td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVCFGSRC.RTVOPT"><b>RTVOPT</b></a></td>
|
|
<td valign="top">Retrieve option</td>
|
|
<td valign="top"><b><u>*NET</u></b>, *OBJ</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVCFGSRC.MBROPT"><b>MBROPT</b></a></td>
|
|
<td valign="top">Member option</td>
|
|
<td valign="top">*ADD, <b><u>*REPLACE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#RTVCFGSRC.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*CFGDTXT</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="RTVCFGSRC.CFGD"></a>
|
|
<h3>Configuration description (CFGD)</h3>
|
|
<p>Specifies the names of configuration objects to be retrieved.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All configuration objects of the specified configuration type (CFGTYPE parameter) are retrieved.
|
|
</dd>
|
|
<dt><b><i>generic-configuration-object-name</i></b></dt>
|
|
<dd>Specify the generic name of the configuration description name. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name.
|
|
</dd>
|
|
<dt><b><i>configuration-description-name</i></b></dt>
|
|
<dd>Specify the user-defined name of the configuration description.
|
|
</dd>
|
|
</dl>
|
|
<p>Up to 256 names can be specified. These can be any combination of configuration object and generic names.
|
|
</p>
|
|
<p>You can enter multiple values for this parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.CFGTYPE"></a>
|
|
<h3>Type (CFGTYPE)</h3>
|
|
<p>Specifies the type of configuration object to be retrieved.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All network servers, network interfaces, lines, controllers, devices, connection lists, modes, classes-of-service, and NetBIOS descriptions matching the specified names are retrieved in the following order:
|
|
<ol>
|
|
<li>Connection Lists
|
|
</li>
|
|
<li>Network server descriptions
|
|
</li>
|
|
<li>Network Interfaces
|
|
</li>
|
|
<li>Non-TDLC line descriptions
|
|
</li>
|
|
<li>Non-TDLC controller descriptions
|
|
</li>
|
|
<li>TDLC line descriptions
|
|
</li>
|
|
<li>TDLC controller descriptions
|
|
</li>
|
|
<li>Device descriptions
|
|
</li>
|
|
<li>Mode descriptions
|
|
</li>
|
|
<li>Class-of-service descriptions
|
|
</li>
|
|
<li>NetBIOS descriptions
|
|
</li>
|
|
<li>SWTCTLLST for line descriptions
|
|
</li>
|
|
<li>SWTLINLST for controller descriptions
|
|
</li>
|
|
<li>SWTNWILST for line descriptions
|
|
</li>
|
|
<li>Printer for remote displays
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NWSD</b></dt>
|
|
<dd>All network server descriptions matching the specified names are retrieved.
|
|
</dd>
|
|
<dt><b>*NWID</b></dt>
|
|
<dd>All network interface descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*LIND</b></dt>
|
|
<dd>All line descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*CTLD</b></dt>
|
|
<dd>All controller descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*DEVD</b></dt>
|
|
<dd>All device descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*MODD</b></dt>
|
|
<dd>All mode descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*COSD</b></dt>
|
|
<dd>All class-of-service descriptions that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*CNNL</b></dt>
|
|
<dd>All connection lists that match the name specified on the <b>Configuration description</b> prompt (CFGD parameter) are retrieved.
|
|
</dd>
|
|
<dt><b>*NTBD</b></dt>
|
|
<dd>All NetBIOS descriptions matching the specified names are retrieved.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.SRCFILE"></a>
|
|
<h3>Source file (SRCFILE)</h3>
|
|
<p>Specifies the name and library of the previously created database source file that contains the source file member.
|
|
</p>
|
|
<p>The possible <b>source-file</b> values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QCLSRC</u></b></dt>
|
|
<dd>The source file named QCLSRC is used.
|
|
</dd>
|
|
<dt><b><i>source-file</i></b></dt>
|
|
<dd>Specify the name of a source file.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the source file. If no library is specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the source file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.SRCMBR"></a>
|
|
<h3>Source member (SRCMBR)</h3>
|
|
<p>Specifies the name of the database source file member into which the CL source statements are written.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CFGD</u></b></dt>
|
|
<dd>The name of the source member is the configuration object name if there is only one name specified and the name is not generic or *ALL. Otherwise, the name is CFGSRC.
|
|
</dd>
|
|
<dt><b><i>source-member-name</i></b></dt>
|
|
<dd>Specify the name of the source file member that contains the CL source statements.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.RTVOPT"></a>
|
|
<h3>Retrieve option (RTVOPT)</h3>
|
|
<p>Specifies which attachment information is retrieved for the specified objects.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NET</u></b></dt>
|
|
<dd>For network interfaces, each network interface description and the descriptions of its attached nonswitched lines, controllers, and devices are retrieved. For lines, each line description and the descriptions of its attached nonswitched controllers and devices are retrieved. For controllers, each controller description and the descriptions of its attached devices are retrieved. For network interfaces, lines, and controllers, switched attachment information is also retrieved.
|
|
</dd>
|
|
<dt><b>*OBJ</b></dt>
|
|
<dd>Each specified configuration object description is retrieved with all attachment information.
|
|
</dd>
|
|
</dl>
|
|
<p>RTVOPT is ignored if the CFGTYPE parameter is *ALL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.MBROPT"></a>
|
|
<h3>Member option (MBROPT)</h3>
|
|
<p>Specifies whether the new records replace or are added to the existing records.
|
|
</p>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><u>*REPLACE</u></b></dt>
|
|
<dd>The system clears the existing member and adds the new records.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ADD</b></dt>
|
|
<dd>The system adds the new records to the end of the existing records.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="RTVCFGSRC.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CFGDTXT</u></b></dt>
|
|
<dd>The text description is the same as the text description of the object specified by the CFGD parameter unless there is more than one object specified or the name is a generic name. In this case, *BLANK is used for the text description.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</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="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVCFGSRC.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
RTVCFGSRC CFGD(CTL*) CFGTYPE(*CTLD)
|
|
SRCMBR(CTLS) RTVOPT(*OBJ)
|
|
</pre>
|
|
</p>
|
|
<p>This command places CL source statements in the file member CTLS in the source file QCLSRC. These source statements can be used to re-create object descriptions for all existing controllers with names beginning with CTL.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="RTVCFGSRC.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF263E</b></dt>
|
|
<dd>File member &1 contains its maximum sequence number.
|
|
</dd>
|
|
<dt><b>CPF263F</b></dt>
|
|
<dd>No objects found.
|
|
</dd>
|
|
<dt><b>CPF264A</b></dt>
|
|
<dd>Record length of &1 in library &2 is too small.
|
|
</dd>
|
|
<dt><b>CPF264C</b></dt>
|
|
<dd>Source file member &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9810</b></dt>
|
|
<dd>Library &1 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9848</b></dt>
|
|
<dd>Cannot open file &1 in library &2 member &3.
|
|
</dd>
|
|
<dt><b>CPF9849</b></dt>
|
|
<dd>Error while processing file &1 in library &2 member &3.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#RTVCFGSRC.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|