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

389 lines
13 KiB
HTML
Raw 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>Add Remote Definition (ADDRMTDFN)</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="ADDRMTDFN.Top_Of_Page"></a>
<h2>Add Remote Definition (ADDRMTDFN)</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="#ADDRMTDFN.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDRMTDFN.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDRMTDFN.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDRMTDFN"></a>
<p>The Add Remote Definition (ADDRMTDFN) command is used to define the attributes of a remote system and add them to the remote system definition table.
</p>
<p><b>Restriction:</b> The user must have *ALLOBJ authority.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDRMTDFN.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" rowspan="3"><a href="#ADDRMTDFN.SYSTEM"><b>SYSTEM</b></a></td>
<td valign="top">System name</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Element 1: System name</td>
<td valign="top">
<i>Character value</i>, *ANY</td>
</tr>
<tr>
<td valign="top">Element 2: System group</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.MTGNTCDOC"><b>MTGNTCDOC</b></a></td>
<td valign="top">Meeting notice document type</td>
<td valign="top"><b><u>*FFTDCA</u></b>, *EMN</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.CALDTASTM"><b>CALDTASTM</b></a></td>
<td valign="top">Calendar data stream</td>
<td valign="top">Single values: *NONE<br>Other values (up to 5 repetitions): <i>Communications name</i>, <b><u>*OV400</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.RMTCALPWD"><b>RMTCALPWD</b></a></td>
<td valign="top">Calendar password</td>
<td valign="top"><i>Simple name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.RMTUSRAUT"><b>RMTUSRAUT</b></a></td>
<td valign="top">Remote user authority</td>
<td valign="top"><b><u>*PRIVATE</u></b>, *PUBLIC, *MINIMUM, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location</td>
<td valign="top"><i>Communications name</i>, <b><u>*SYSTEM</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.LCLLOCNAME"><b>LCLLOCNAME</b></a></td>
<td valign="top">Local location</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.RMTNETID"><b>RMTNETID</b></a></td>
<td valign="top">Remote network identifier</td>
<td valign="top"><i>Communications name</i>, <b><u>*LOC</u></b>, *NETATR, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDRMTDFN.MODE"><b>MODE</b></a></td>
<td valign="top">Mode</td>
<td valign="top"><i>Communications name</i>, <b><u>*NETATR</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDRMTDFN.SYSTEM"></a>
<h3>System name (SYSTEM)</h3>
<p>Specifies the system name and system group of the remote system being defined.
</p>
<p>This is a required parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*ANY</b></dt>
<dd>Adds a default definition for all remote systems not covered by the other entries.
</dd>
</dl>
<p>The possible <b>System Name</b> value is:
</p>
<dl>
<dt><b><i>system-name</i></b></dt>
<dd>Specify the name of the remote system being defined.
</dd>
</dl>
<p>The possible <b>System Group</b> value is:
</p>
<dl>
<dt><b><i>system-group</i></b></dt>
<dd>Specify the group name of the remote system being defined. The system group name is blank if this value is not specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies text that describes the remote system definition.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>Text is not 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="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.MTGNTCDOC"></a>
<h3>Meeting notice document type (MTGNTCDOC)</h3>
<p>Specifies the type of meeting notice documents accepted by the remote system. If the system can accept Enterprise Meeting Notice Architecture documents (post-V2R1M1 AS/400 systems), you should specify *EMN for this parameter. If you are unsure, specify *FFTDCA for this parameter.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*FFTDCA</u></b></dt>
<dd>The remote system does not accept enterprise meeting notice documents, but does accept final-form text documents.
</dd>
<dt><b>*EMN</b></dt>
<dd>The remote system accepts enterprise meeting notice documents.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.CALDTASTM"></a>
<h3>Calendar data stream (CALDTASTM)</h3>
<p>Specifies the type of calendar data stream that the local system uses when sending a request for calendar information to this remote system. Each type of calendar data stream represents a format in which remote calendar requests are made from the local system to this remote system.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*OV400</u></b></dt>
<dd>The OfficeVision calendar data stream is used.
</dd>
<dt><b><i>calendar-data-stream</i></b></dt>
<dd>Specify the name of the calendar data stream that is used. The name of the data stream can be a maximum of 10 characters.
<p><b>Single Value:</b>
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>No calendar data stream is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.RMTCALPWD"></a>
<h3>Calendar password (RMTCALPWD)</h3>
<p>Specifies the password that is associated with user profile QRMTCAL on the remote system. This user profile is used to sign on to the remote system when processing a request for calendar information.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No password is used for user profile QRMTCAL.
</dd>
<dt><b><i>calendar-password</i></b></dt>
<dd>Specify the password that is defined for QRMTCAL. If the password is numeric, it must begin with a Q (for example, specify Q1234 when 1234 is the password).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.RMTUSRAUT"></a>
<h3>Remote user authority (RMTUSRAUT)</h3>
<p>Specifies the object authority for calendar objects on the local system to be used for incoming requests for calendar information from remote system users. This parameter is used by OfficeVision calendar processing to determine authority to calendars.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*PRIVATE</u></b></dt>
<dd>Private authority is used for requests from the remote system. If private authority does not exist, public authority is used.
</dd>
<dt><b>*PUBLIC</b></dt>
<dd>Public authority is used for requests from the remote system.
</dd>
<dt><b>*MINIMUM</b></dt>
<dd>The lesser of the private or the public authority is used for requests from the remote system.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>Local system objects cannot be accessed by users on the remote system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.RMTLOCNAME"></a>
<h3>Remote location (RMTLOCNAME)</h3>
<p>Specifies the remote location name of the remote system being added.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SYSTEM</u></b></dt>
<dd>The name specified on the SYSTEM parameter is used for the remote location name.
</dd>
<dt><b><i>remote-location-name</i></b></dt>
<dd>Specify the full name of a remote location.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.LCLLOCNAME"></a>
<h3>Local location (LCLLOCNAME)</h3>
<p>Specifies the location name that identifies the local system to the remote system being added.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The local location name associated with the remote location is used.
</dd>
<dt><b>*NETATR</b></dt>
<dd>The LCLLOCNAME value specified in the system network attributes is used.
</dd>
<dt><b><i>local-location-name</i></b></dt>
<dd>Specify the name of the local location.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.RMTNETID"></a>
<h3>Remote network identifier (RMTNETID)</h3>
<p>Specifies the remote network identifier (ID) for the remote system being added.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LOC</u></b></dt>
<dd>The remote network ID associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
</dd>
<dt><b>*NETATR</b></dt>
<dd>The RMTNETID value specified in the system network attributes is used.
</dd>
<dt><b>*NONE</b></dt>
<dd>No remote network ID is used.
</dd>
<dt><b><i>remote-network-ID</i></b></dt>
<dd>Specify the remote network ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDRMTDFN.MODE"></a>
<h3>Mode (MODE)</h3>
<p>Specifies the name of the mode that defines the device sessions used to request data from the remote system.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NETATR</u></b></dt>
<dd>The mode name specified in the network attributes is used.
</dd>
<dt><b><i>mode-name</i></b></dt>
<dd>Specify the name of the mode.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDRMTDFN.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Specific Remote Definition</b>
</p>
<p>
<pre>
ADDRMTDFN SYSTEM(ABCXYZ) TEXT('System XYZ') MTGNTCDOC(*EMN)
</pre>
</p>
<p>This command adds a definition for a remote system ABCXYZ and allows the system to accept enterprise meeting notice documents.
</p>
<p><b>Example 2: Allowing Final Form Text Documents</b>
</p>
<p>
<pre>
ADDRMTDFN SYSTEM(*ANY) MTGNTCDOC(*FFTDCA)
</pre>
</p>
<p>This command allows all remote systems that do not have specific remote definitions to accept final form text meeting notices.
</p>
<p><b>Example 3: Adding a Remote Definition with Password</b>
</p>
<p>
<pre>
ADDRMTDFN SYSTEM(DALLAS1) TEXT('SYSTEM1') MTGNTCDOC(*EMN)
RMTCALPWD(CALPWD) LCLLOCNAME(*NETATR)
</pre>
</p>
<p>This command adds a definition for the remote system DALLAS1, which accepts enterprise meeting notice documents. The password to sign on the system is CALPWD. The remote system will identify the local system by the name specified in the system network attributes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDRMTDFN.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF6DCA</b></dt>
<dd>SYSTEM parameter cannot be local system.
</dd>
<dt><b>CPF6DCB</b></dt>
<dd>Remote definition for system &amp;1 &amp;2 already exists.
</dd>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDRMTDFN.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>