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

1559 lines
58 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 Directory Entry (ADDDIRE)</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="ADDDIRE.Top_Of_Page"></a>
<h2>Add Directory Entry (ADDDIRE)</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="#ADDDIRE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#ADDDIRE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#ADDDIRE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="ADDDIRE"></a>
<p>The Add Directory Entry (ADDDIRE) command allows you to add new entries to the system distribution directory. The directory contains information about a user, such as the user ID and address, system name, user profile name, mailing address, telephone, number, and other user information. The ADDDIRE command provides a parameter for each of the fields contained in the directory.
</p>
<p>The ADDDIRE command does not provide interactive display support. This is provided by the Work with Directory Entries (WRKDIRE) command.
</p>
<p>An X.400 originator/recipient (O/R) name can be added to the directory with this command. X.400 is an international standard for communications and the O/R name is the addressing information used in X.400 communications. The X.400 O/R name must be in character set 1169 and code page 500. This set includes A through Z, 0 through 9, and some special characters. Additional information on characters allowed is in the Globalization information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
</p>
<p><b>NOTES</b>
</p>
<ol>
<li>To prevent the system from changing lowercase characters to uppercase, enclose the values in apostrophes. This does not apply to user ID/address, system name/group, department, or X.400 O/R name.
</li>
<li>Only the user ID/address, system name/group, department, and X.400 O/R name are translated from the graphic character identifier (GCID) specified by the CMDCHRID parameter. All other parameters are stored exactly as they are entered and the GCID is stored with them. The default GCID value is taken from the QCHRID system value. The user can override the defaults by specifying a character set and code page or by specifying *DEVD for the display device description.
</li>
<li>Double-byte character set (DBCS) characters can be entered for the following system directory entry parameters:
<p>
<pre>
USRD LOCATION
LSTNAM BLDG
FSTNAM OFC
MIDNAM ADDR1
PREFNAM ADDR2
FULNAM ADDR3
DEPT ADDR4
TITLE TEXT
CMPNY USRDFNFLD
</pre>
</p>
</li>
</ol>
<p><b>Restriction:</b> You must have security administrator authority or be a security officer to use this command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="ADDDIRE.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="#ADDDIRE.USRID"><b>USRID</b></a></td>
<td valign="top">User identifier</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: User ID</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Address</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.USRD"><b>USRD</b></a></td>
<td valign="top">User description</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.USER"><b>USER</b></a></td>
<td valign="top">User profile</td>
<td valign="top"><i>Name</i>, *NONE</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDDIRE.SYSNAME"><b>SYSNAME</b></a></td>
<td valign="top">System name</td>
<td valign="top">Single values: <b><u>*LCL</u></b>, *PC, *ERROR<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: System name</td>
<td valign="top">
<i>Character value</i></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="#ADDDIRE.NETUSRID"><b>NETUSRID</b></a></td>
<td valign="top">Network user ID</td>
<td valign="top"><i>Character value</i>, <b><u>*USRID</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.LSTNAM"><b>LSTNAM</b></a></td>
<td valign="top">Last name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.FSTNAM"><b>FSTNAM</b></a></td>
<td valign="top">First name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.MIDNAM"><b>MIDNAM</b></a></td>
<td valign="top">Middle name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.PREFNAM"><b>PREFNAM</b></a></td>
<td valign="top">Preferred name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.FULNAM"><b>FULNAM</b></a></td>
<td valign="top">Full name</td>
<td valign="top"><i>Character value</i>, <b><u>*DFT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.DEPT"><b>DEPT</b></a></td>
<td valign="top">Department</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.TITLE"><b>TITLE</b></a></td>
<td valign="top">Job title</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.CMPNY"><b>CMPNY</b></a></td>
<td valign="top">Company</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.TELNBR1"><b>TELNBR1</b></a></td>
<td valign="top">Telephone number 1</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.TELNBR2"><b>TELNBR2</b></a></td>
<td valign="top">Telephone number 2</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.FAXTELNBR"><b>FAXTELNBR</b></a></td>
<td valign="top">FAX telephone number</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.LOC"><b>LOC</b></a></td>
<td valign="top">Location</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.BLDG"><b>BLDG</b></a></td>
<td valign="top">Building</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.OFC"><b>OFC</b></a></td>
<td valign="top">Office</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ADDR1"><b>ADDR1</b></a></td>
<td valign="top">Address line 1</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ADDR2"><b>ADDR2</b></a></td>
<td valign="top">Address line 2</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ADDR3"><b>ADDR3</b></a></td>
<td valign="top">Address line 3</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ADDR4"><b>ADDR4</b></a></td>
<td valign="top">Address line 4</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.INDUSR"><b>INDUSR</b></a></td>
<td valign="top">Indirect user</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.PRTPERS"><b>PRTPERS</b></a></td>
<td valign="top">Print private mail</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.PRTCOVER"><b>PRTCOVER</b></a></td>
<td valign="top">Print cover page</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.NFYMAIL"><b>NFYMAIL</b></a></td>
<td valign="top">Mail notification</td>
<td valign="top"><b><u>*SPECIFIC</u></b>, *ALLMAIL, *NOMAIL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.NFYPTYPERS"><b>NFYPTYPERS</b></a></td>
<td valign="top">Priority, private, important</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.NFYMSGS"><b>NFYMSGS</b></a></td>
<td valign="top">Messages</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDDIRE.CMDCHRID"><b>CMDCHRID</b></a></td>
<td valign="top">Command character identifier</td>
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Graphic character set</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top">Element 2: Code page</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.COUNTRY"><b>COUNTRY</b></a></td>
<td valign="top">Country or region ID</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ADMD"><b>ADMD</b></a></td>
<td valign="top">Administration domain</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.PRMD"><b>PRMD</b></a></td>
<td valign="top">Private management domain</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.SURNAM"><b>SURNAM</b></a></td>
<td valign="top">Surname</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *LSTNAM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.GIVENNAM"><b>GIVENNAM</b></a></td>
<td valign="top">Given name</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b>, *FSTNAM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.INITIALS"><b>INITIALS</b></a></td>
<td valign="top">Initials</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.GENQUAL"><b>GENQUAL</b></a></td>
<td valign="top">Generation qualifier</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ORG"><b>ORG</b></a></td>
<td valign="top">Organization</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ORGUNIT"><b>ORGUNIT</b></a></td>
<td valign="top">Organizational units</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 4 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDDIRE.DMNDFNATR"><b>DMNDFNATR</b></a></td>
<td valign="top">Domain-defined attributes</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 4 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Type</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Value</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDDIRE.USRDFNFLD"><b>USRDFNFLD</b></a></td>
<td valign="top">User-defined fields</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 100 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Field name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Product ID</td>
<td valign="top">
<i>Character value</i>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: Value</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#ADDDIRE.MSFSRVLVL"><b>MSFSRVLVL</b></a></td>
<td valign="top">Mail service level</td>
<td valign="top">Single values: <b><u>*USRIDX</u></b>, *SYSMS, *DOMINO<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Field name</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top">Element 2: Product ID</td>
<td valign="top">
<i>Character value</i>, *NONE</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#ADDDIRE.PREFADR"><b>PREFADR</b></a></td>
<td valign="top">Preferred address</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Field name</td>
<td valign="top">
<i>Character value</i>, <b><u>*USRID</u></b>, *ORNAME, *SMTP</td>
</tr>
<tr>
<td valign="top">Element 2: Product ID</td>
<td valign="top">
<i>Character value</i>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: Address type</td>
<td valign="top">
<i>Character value</i></td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.CCMAILADR"><b>CCMAILADR</b></a></td>
<td valign="top">cc:Mail address</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.CCMAILCMT"><b>CCMAILCMT</b></a></td>
<td valign="top">cc:Mail comment</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.ALWSYNC"><b>ALWSYNC</b></a></td>
<td valign="top">Allow synchronization</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#ADDDIRE.DLOOWN"><b>DLOOWN</b></a></td>
<td valign="top">DLO owner</td>
<td valign="top"><b><u>*USRPRF</u></b>, *GRPPRF</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="ADDDIRE.USRID"></a>
<h3>User identifier (USRID)</h3>
<p>Specifies the user ID and address for the new user. Both parts must be provided. The user ID and address are changed to upper case characters and are translated to the common character set and code page '697 500'. More information about specifying the user ID and address can be found in the SNA Distribution Services book, SC41-5410.
</p>
<p>*ANY can be entered for the user ID and address. *ANY is the default entry that is used in distributions when an exact match is not made on the user ID and address, but the address matches a *ANY address. For example, *ANY CHICAGO is valid. HURST *ANY is not valid. Only one *ANY *ANY default entry is allowed in the directory.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>user-id address</i></b></dt>
<dd>Specify the user ID and address. A maximum of 8 characters can be used in each field.
</dd>
</dl>
<p>If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.USRD"></a>
<h3>User description (USRD)</h3>
<p>Specifies the description associated with the user ID and address. For example, the description can contain the user's name or job title. By using a consistent naming convention such as "last name, first name" for the description, entries can be easily located while sorting by description from the Work with Directory display.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>user-description</i></b></dt>
<dd>Specify a maximum of 50 characters for the description associated with the user ID and address. The directory can contain more than one description for the same user ID and address, but each description must be unique for the same user ID and address.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.USER"></a>
<h3>User profile (USER)</h3>
<p>Specifies the user profile of the user being added to the directory. If the user being added is a local user, a valid profile must exist on the local system (and it must be specified). If the user is a remote user, no profile exists on the local system and *NONE should be specified.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The user being added to the directory is a remote user and has no local profile.
</dd>
<dt><b><i>user-profile-name</i></b></dt>
<dd>Specify a maximum of 10 characters for the valid system user profile name. The user profile name is required for all local users. If a profile name is specified for a remote user, the profile name must be valid. In the latter case, mail is sent to the user at the remote location, but the user has local library access.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.SYSNAME"></a>
<h3>System name (SYSNAME)</h3>
<p>Specifies the one- or two-part name of the system on which the user works. If a two-part system name is specified on the command line, up to 8 characters make up both the system name and the system group name. The parts should be separated by at least one space.
</p>
<p>A remote user can be added to the directory before the system name and system group are defined in the network tables, but distributions cannot be sent to that user until the remote system name and system group are defined. The remote system name and system group name are defined by using the Configure Distribution Services (CFGDSTSRV) command. Additional information on defining a remote system name and group name is in the SNA Distribution Services book, SC41-5410.
</p>
<dl>
<dt><b><u>*LCL</u></b></dt>
<dd>The system name defaults to the local name. All local users being added to the directory should have *LCL specified as the system name.
</dd>
<dt><b>*PC</b></dt>
<dd>*PC is for a distributed systems node executive (DSNX) user with a personal computer (PC) attached to this system.
</dd>
</dl>
<dl>
<dt><b>*ERROR</b></dt>
<dd>Use this value if your network contains a central system that receives all unresolved distributions. In this type of network, you may encounter distribution looping when a distribution cannot find a specific user ID on the intended system and the intended system has a <b>*ANY *ANY</b> entry directing distributions to the central system. The central system also has a default <b>*ANY address</b> entry directing unresolved distributions to the intended system. To prevent distribution looping, specify *ERROR as the system name for the default entry you are adding or changing. When a distribution cannot find a specific user ID, but matches this default entry, the distribution is handled as a user that is not valid, just as if no directory match were found.
<p>*ERROR is valid only when <b>*ANY address</b> or <b>*ANY *ANY</b> is specified on the <b>User identifier (USRID)</b> parameter.
</p>
</dd>
</dl>
<dl>
<dt><b><i>system-name-group</i></b></dt>
<dd>Specify the one- or two-part name of the system to which distributions are sent. If a two-part system name is specified, each part can have a maximum of 8 characters. The name and group are changed to upper case characters and are translated to the common character set and code page '697 500'.
<p>A remote user can be added to the directory before the system name and system group are defined in the network tables, but distributions cannot be sent to that user until the system name and system group are defined. The remote system name and system group are defined by using the Configure Distribution Services (CFGDSTSRV) command.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.NETUSRID"></a>
<h3>Network user ID (NETUSRID)</h3>
<p>Specifies the unique network user ID for this directory entry. This ID is used during directory shadowing to uniquely identify a user in a network.
</p>
<dl>
<dt><b><u>*USRID</u></b></dt>
<dd>Set the network user ID to the user ID and address associated with this directory entry.
</dd>
<dt><b><i>network-user-ID</i></b></dt>
<dd>Specify the network user ID for the user. A maximum of 47 characters can be specified.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.LSTNAM"></a>
<h3>Last name (LSTNAM)</h3>
<p>Specifies the last name of the user. If no names are provided (last, first, middle, preferred, or full) but a value is specified on the <b>Department (DEPT)</b> parameter, the last name defaults to an asterisk (*).
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No last name is specified for the user.
</dd>
<dt><b><i>last-name</i></b></dt>
<dd>Specify a maximum of 40 characters for the last name of the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.FSTNAM"></a>
<h3>First name (FSTNAM)</h3>
<p>Specifies the first name of the user.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No first name is specified for the user.
</dd>
<dt><b><i>first-name</i></b></dt>
<dd>Specify a maximum of 20 characters for the first name of the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.MIDNAM"></a>
<h3>Middle name (MIDNAM)</h3>
<p>Specifies the middle name of the user.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No middle name is specified for the user.
</dd>
<dt><b><i>middle-name</i></b></dt>
<dd>Specify a maximum of 20 characters for the middle name of the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.PREFNAM"></a>
<h3>Preferred name (PREFNAM)</h3>
<p>Specifies the name by which the user likes to be addressed.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No preferred name is specified for the user.
</dd>
<dt><b><i>preferred-name</i></b></dt>
<dd>Specify a maximum of 20 characters for the preferred name of the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.FULNAM"></a>
<h3>Full name (FULNAM)</h3>
<p>Specifies the user's full name. This field can be entered by an administrator, or it can be built by the system. If the administrator enters data in this field, it is stored in the format in which it is entered. If the full name is not specified, it is created by the system as follows:
</p>
<ul>
<li>Last, First Middle (Preferred)
</li>
<li>If parts of the full name are not provided, the missing parts are removed from this format.
</li>
<li>The preferred name, when it is specified, is always enclosed in parentheses.
</li>
<li>If a preferred name is specified but it does not fit in the 50 characters after the last, first, and middle names, the preferred name occupies the last positions of the full name field, replacing the characters in those positions. Therefore, if a preferred name is specified, it always appears.
</li>
</ul>
<p>
<b>Note: </b>Only an administrator can change this field.
</p>
<dl>
<dt><b><u>*DFT</u></b></dt>
<dd>The full name is built by the system from the values entered for the last name, first name, middle name, and preferred name.
</dd>
<dt><b><i>full-name</i></b></dt>
<dd>Specify a maximum of 50 characters for the full name of the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.DEPT"></a>
<h3>Department (DEPT)</h3>
<p>Specifies the name or number of the department of which the user is a member.
</p>
<p><b>Restriction:</b> Only an administrator can change this field.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No department is specified for the user.
</dd>
<dt><b><i>department-name</i></b></dt>
<dd>Specify a maximum of 10 characters for the name of the user's department.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.TITLE"></a>
<h3>Job title (TITLE)</h3>
<p>Specifies the user's job title, such as marketing director, account manager, or production engineer.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No job title is specified for the user.
</dd>
<dt><b><i>job-title</i></b></dt>
<dd>Specify a maximum of 40 characters for the user's job title.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.CMPNY"></a>
<h3>Company (CMPNY)</h3>
<p>Specifies the name of the company for which the user works.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No company name is specified for the user.
</dd>
<dt><b><i>company</i></b></dt>
<dd>Specify a maximum of 50 characters for the company name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.TELNBR1"></a>
<h3>Telephone number 1 (TELNBR1)</h3>
<p>Specifies the user's primary telephone number. The telephone number can be specified in any format appropriate to the user, including an international telephone number format.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No telephone number is specified.
</dd>
<dt><b><i>telephone-number-1</i></b></dt>
<dd>Specify a maximum of 26 characters for the user's primary telephone number.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.TELNBR2"></a>
<h3>Telephone number 2 (TELNBR2)</h3>
<p>Specifies the user's secondary telephone number. The telephone number can be specified in any format appropriate to the user, including an international telephone number format.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A secondary telephone number is not specified.
</dd>
<dt><b><i>telephone-number-2</i></b></dt>
<dd>Specify a maximum of 26 characters for the user's secondary telephone number.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.FAXTELNBR"></a>
<h3>FAX telephone number (FAXTELNBR)</h3>
<p>Specifies the user's facsimile telephone number. The facsimile telephone number can be specified in any format appropriate for the user, including an international telephone number format.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>A facsimile telephone number is not specified.
</dd>
<dt><b><i>facsimile-telephone-number</i></b></dt>
<dd>Specify a maximum of 32 characters for the user's facsimile telephone number.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.LOC"></a>
<h3>Location (LOC)</h3>
<p>Specifies the location of the user's business or system.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No location is specified.
</dd>
<dt><b><i>location</i></b></dt>
<dd>Specify a maximum of 40 characters for the location.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.BLDG"></a>
<h3>Building (BLDG)</h3>
<p>Specifies the name of the building in which the user works.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No building is specified.
</dd>
<dt><b><i>building</i></b></dt>
<dd>Specify a maximum of 20 characters for the name of the building in which the user works.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.OFC"></a>
<h3>Office (OFC)</h3>
<p>Specifies the name or number of the user's office.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No office is specified.
</dd>
<dt><b><i>office</i></b></dt>
<dd>Specify a maximum of 16 characters for the user's office.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ADDR1"></a>
<h3>Address line 1 (ADDR1)</h3>
<p>Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No address line is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the user's mailing address in any format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ADDR2"></a>
<h3>Address line 2 (ADDR2)</h3>
<p>Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No address line is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the user's mailing address in any format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ADDR3"></a>
<h3>Address line 3 (ADDR3)</h3>
<p>Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No address line is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the user's mailing address in any format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ADDR4"></a>
<h3>Address line 4 (ADDR4)</h3>
<p>Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No address line is specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the user's mailing address in any format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.INDUSR"></a>
<h3>Indirect user (INDUSR)</h3>
<p>Specifies whether the user being added is an indirect user. An indirect user is a local user who does not sign on the system to receive mail. Mail is automatically printed for the indirect user. Each indirect user must have a profile on the local system.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The user is not an indirect user.
</dd>
<dt><b>*YES</b></dt>
<dd>The user is an indirect user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.PRTPERS"></a>
<h3>Print private mail (PRTPERS)</h3>
<p>Specifies whether private mail for an indirect user is printed. Consideration should be given to restricting public access to the printer when private mail is printed. This parameter is ignored if the user is not an indirect user.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>No private mail is printed for this indirect user.
</dd>
<dt><b>*YES</b></dt>
<dd>Private mail is printed for this indirect user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.PRTCOVER"></a>
<h3>Print cover page (PRTCOVER)</h3>
<p>Specifies whether a cover page is printed when a mail item is printed. This parameter is ignored when a remote user is added to the directory because remote users do not receive mail on this system.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>A cover page is printed when a mail item is printed.
</dd>
<dt><b>*NO</b></dt>
<dd>A cover page is not printed when a mail item is printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.NFYMAIL"></a>
<h3>Mail notification (NFYMAIL)</h3>
<p>Specifies whether the user is notified of the arrival of mail by receiving a message on the user's message queue. This parameter is ignored when a remote user is added to the directory because remote users do not receive mail on this system.
</p>
<dl>
<dt><b><u>*SPECIFIC</u></b></dt>
<dd>The user is notified only when the types of mail specified on the <b>Priority, private, important (NFYPTYPERS)</b> parameter and <b>Messages (NFYMSGS)</b> parameter arrive. These types of mail can include priority and personal mail, and messages.
</dd>
<dt><b>*ALLMAIL</b></dt>
<dd>The user is notified of the arrival of all types of mail.
</dd>
<dt><b>*NOMAIL</b></dt>
<dd>The user is not notified of the arrival of mail.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.NFYPTYPERS"></a>
<h3>Priority, private, important (NFYPTYPERS)</h3>
<p>Specifies whether the user is notified of the arrival of priority, private, and important mail. This parameter is ignored if *NOMAIL or *ALLMAIL is specified on the <b>Mail notification (NFYMAIL)</b> parameter.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The user is notified of the arrival of priority, private, and important mail.
</dd>
<dt><b>*NO</b></dt>
<dd>The user is not notified of the arrival of priority, private, and important mail.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.NFYMSGS"></a>
<h3>Messages (NFYMSGS)</h3>
<p>Specifies whether the user is notified of the arrival of messages. This parameter is ignored if *NOMAIL or *ALLMAIL is specified on the <b>Mail notification (NFYMAIL)</b> parameter.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>The user is notified of the arrival of messages.
</dd>
<dt><b>*NO</b></dt>
<dd>The user is not notified of the arrival of messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>text</i></b></dt>
<dd>Specify a maximum of 50 characters of text, enclosed in apostrophes, to describe additional information about the user.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.CMDCHRID"></a>
<h3>Command character identifier (CMDCHRID)</h3>
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values. The value you specify on this parameter applies to the <b>User identifier (USRID)</b> parameter, <b>System name (SYSNAME)</b> parameter, <b>Department (DEPT)</b> parameter, and to all of the X.400 O/R name parameters.
</p>
<p><b>Note:</b>
</p>
<ul>
<li>Only the user ID and address, system name and group, department, and the X.400 O/R parameters are translated to the graphic character set identifier (GCID) specified on this parameter. All other parameter values that you specify are stored exactly as they are entered; the GCID value is stored with them.
</li>
<li>If this command is run interactively, the default GCID value is taken from the display device description. If it is run in batch, the default GCID value is taken from the QCHRID system value. You can override these values by specifying a specific character set and code page on this parameter.
</li>
</ul>
<p><b>Note:</b> Double byte character set (DBCS) characters can be entered on the following system directory entry parameters:
</p>
<ul>
<li><b>User description (USRD)</b>
</li>
<li><b>Last name (LSTNAM)</b>
</li>
<li><b>First name (FSTNAM)</b>
</li>
<li><b>Middle name (MIDNAM)</b>
</li>
<li><b>Preferred name (PREFNAM)</b>
</li>
<li><b>Full name (FULNAM)</b>
</li>
<li><b>Department (DEPT)</b>
</li>
<li><b>Job title (TITLE)</b>
</li>
<li><b>Company (CMPNY)</b>
</li>
<li><b>Location (LOC)</b>
</li>
<li><b>Building (BLDG)</b>
</li>
<li><b>Office (OFC)</b>
</li>
<li><b>Address line 1 (ADDR1)</b>
</li>
<li><b>Address line 2 (ADDR2)</b>
</li>
<li><b>Address line 3 (ADDR3)</b>
</li>
<li><b>Address line 4 (ADDR4)</b>
</li>
<li><b>Text (TEXT)</b>
</li>
</ul>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SYSVAL</u></b></dt>
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
</dd>
</dl>
<dl>
<dt><b>*DEVD</b></dt>
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
</dd>
</dl>
<p><b>Element 1: Graphic character set</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the graphic character set to use.
</dd>
</dl>
<p><b>Element 2: Code page</b>
</p>
<dl>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the code page to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.COUNTRY"></a>
<h3>Country or region. (COUNTRY)</h3>
<p>Specifies the country or region part of the X.400 Originator/Recipient (O/R) name.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No country or region is specified.
</dd>
<dt><b><i>country or region-code</i></b></dt>
<dd>Specify an ISO 3166 Alpha-2 code or a CCITT country or region code from the ISO X.400 Code List Table. Refer to the COUNTRY parameter description in "Expanded descriptions" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for the ISO X.400 Code List Table.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ADMD"></a>
<h3>Administration domain (ADMD)</h3>
<p>Specifies the administration management domain part of the X.400 O/R name.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No administration management domain is specified.
</dd>
<dt><b><i>administration-management-domain</i></b></dt>
<dd>Specify a maximum of 16 characters for the description of the administration management domain. An administration management domain is a public organization that handles a management domain, which is a set of message transfer agents and user agents that comprise a system capable of handling messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.PRMD"></a>
<h3>Private management domain (PRMD)</h3>
<p>Specifies the private management domain part of the X.400 O/R name.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No private management domain is specified.
</dd>
<dt><b><i>private-management-domain</i></b></dt>
<dd>Specify a maximum of 16 characters for the description of the private management domain. A private management domain is a private company or noncommercial organization that handles a management domain, which is a set of message transfer agents and user agents that comprise a system capable of handling messages.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.SURNAM"></a>
<h3>Surname (SURNAM)</h3>
<p>Specifies the X.400 user last name part of the personal name within the X.400 O/R name.
</p>
<p>
<b>Note: </b>This parameter is required when a value is specified on the GIVENNAM, INITIALS or GENQUAL, parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No surname is specified.
</dd>
<dt><b>*LSTNAM</b></dt>
<dd>The user last name specified in the directory entry is used as the surname.
</dd>
<dt><b><i>surname</i></b></dt>
<dd>Specify a maximum of 40 characters for the surname.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.GIVENNAM"></a>
<h3>Given name (GIVENNAM)</h3>
<p>Specifies the X.400 user first name part of the personal name within the X.400 O/R name.
</p>
<p>
<b>Note: </b>The SURNAM parameter is required when a value is specified on this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No given name is specified.
</dd>
<dt><b>*FSTNAM</b></dt>
<dd>The user first name specified in the directory entry is used as the given name. It is truncated to 16 characters.
</dd>
<dt><b><i>given-name</i></b></dt>
<dd>Specify a maximum of 16 characters for the given name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.INITIALS"></a>
<h3>Initials (INITIALS)</h3>
<p>Specifies the initials part of the personal name within the X.400 O/R name. For example, the initials for 'John Henry Smith' are 'JH.'
</p>
<p>
<b>Note: </b>The SURNAM parameter is required when a value is specified on this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No initials are specified.
</dd>
<dt><b><i>initials</i></b></dt>
<dd>Specify a maximum of 5 characters for the initials.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.GENQUAL"></a>
<h3>Generation qualifier (GENQUAL)</h3>
<p>Specifies the generation qualifier part of the personal name within the X.400 O/R name. For example, the generation qualifier in the name 'John R. Smith, III' is 'III.'
</p>
<p>
<b>Note: </b>The SURNAM parameter is required when a value is specified on this parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No generation qualifier is specified.
</dd>
<dt><b><i>generation-qualifier</i></b></dt>
<dd>Specify a maximum of 3 characters for the generation qualifier.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ORG"></a>
<h3>Organization (ORG)</h3>
<p>Specifies the organization name part of the X.400 O/R name.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No organization name is specified.
</dd>
<dt><b><i>organization</i></b></dt>
<dd>Specify a maximum of 64 characters for the organization name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ORGUNIT"></a>
<h3>Organizational units (ORGUNIT)</h3>
<p>Specifies the organization-defined unit part of the X.400 O/R name.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No organizational unit is specified.
</dd>
<dt><b><i>'organizational-unit'</i></b></dt>
<dd>Specify a maximum of 32 characters for the name of an organizational unit. Up to 4 organizational units can be listed in order of descending significance.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.DMNDFNATR"></a>
<h3>Domain-defined attributes (DMNDFNATR)</h3>
<p>Specifies the type and value of a domain-defined attribute not specified by X.400 standards but allowed in the X.400 O/R name to accommodate existing systems of sending messages. A maximum of 4 sets of attributes can be specified.
</p>
<p>
<b>Note: </b>To specify an X.121 address, type <u> X.121</u> in the <u> Type</u> field, and then type the X.121 address in the <u> Value</u> field. A maximum of 15 numeric characters can be specified for the X.121 address.
</p>
<p>If you are specifying other domain-defined attributes, the X.121 pair must be the last attribute specified. You must also specify a value for the <u> Country or region</u> field if you specify an X.121 address.
</p>
<p>X.121 is a CCITT Recommendation that provides a method for the international numbering of X.25 packet-switching data networks.
</p>
<p>The possible <b>type</b> values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No domain-defined type is specified.
</dd>
<dt><b><i>type</i></b></dt>
<dd>Specify a maximum of 8 characters for the type of the domain-defined attribute.
</dd>
</dl>
<p>The possible <b>value</b> values are:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No domain-defined value is specified.
</dd>
<dt><b><i>value</i></b></dt>
<dd>Specify a maximum of 128 characters for the value of the domain-defined attribute.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.USRDFNFLD"></a>
<h3>User-defined fields (USRDFNFLD)</h3>
<p>Specifies the user-defined field names and values. A list of these user-defined field names can be displayed using the CHGSYSDIRA command and prompting with the F4 key. Up to 100 user-defined fields can be specified.
</p>
<p>
<b>Note: </b>The following SMTP user-defined fields are not always displayed when the CHGSYSDIRA command is prompted, but they can still be used in the user-defined field (USRDFNFLD) parameter to add SMTP information to the system distribution directory.
</p>
<ul>
<li>SMTPAUSRID SMTP
</li>
<li>SMTPDMN SMTP
</li>
<li>SMTPRTE SMTP
</li>
</ul>
<p>The possible single value is:
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No user-defined fields are specified.
</dd>
</dl>
<p>The possible User-Defined Field Name value is:
</p>
<dl>
<dt><b><i>field-name</i></b></dt>
<dd>Specify up to 10 characters for the user-defined field name.
</dd>
</dl>
<p>The possible User-Defined Field Product ID values are:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No user-defined field product ID is specified.
</dd>
<dt><b><i>product-ID</i></b></dt>
<dd>Specify up to 7 characters for the user-defined field product ID.
</dd>
</dl>
<p>The possible User-Defined Field Value value is:
</p>
<dl>
<dt><b><i>'value'</i></b></dt>
<dd>Specify up to 512 characters for the value of the user-defined field value. Blanks are padded on the right.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.MSFSRVLVL"></a>
<h3>Mail service level (MSFSRVLVL)</h3>
<p>Specifies the mail server framework service level for a local user. This value is ignored for a remote user. It indicates where mail is stored on the system.
</p>
<dl>
<dt><b><u>*USRIDX</u></b></dt>
<dd>The mail is stored in a user index.
</dd>
<dt><b>*SYSMS</b></dt>
<dd>The mail is stored in the Post Office Protocol (POP) mailbox, which can be accessed by POP clients on the personal computer through the iSeries POP server using the POP interface.
</dd>
<dt><b>*DOMINO</b></dt>
<dd>The mail is stored in the Lotus Domino mail database.
</dd>
</dl>
<p>The possible Mail service level field-name value is:
</p>
<dl>
<dt><b><i>field-name</i></b></dt>
<dd>Specify the field name when another mail service is used for this user. Specify up to 10 characters for the field name. This value should contain a user-defined field in the system directory that has been defined by the Change System Directory Attributes (CHGSYSDIRA) in the USRDFNFLD parameter with a field type of *MSFSRVLVL. The user-defined field specified here should then contain information needed by the mail server framework user exit program when the program is determining where to store the mail. The address resolution exit point name is QIBM_QZMFMSF_ADR_RSL. See the AnyMail/400 Mail Server Framework Support book, SC41-5411 for more information. This field could just be used as an indicator and the value does not have to be a user-defined field. When ever possible, the value specified here should be a user-defined field.
</dd>
</dl>
<p>The possible mail service level product-ID values are:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No user-defined-field product ID is specified.
</dd>
<dt><b><i>Product-ID</i></b></dt>
<dd>Specify up to 7 characters for the user-defined field product ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.PREFADR"></a>
<h3>Preferred address (PREFADR)</h3>
<p>Specifies the preferred address for a user. This tells the mail server framework what fields to use in the system distribution directory for the preferred address of a user. Specify *USERID for SNADS. SNADS handles all the mail that goes to a user index including the gateway for X.400 O/R names and Simple Mail Transfer Protocol (SMTP) names.
</p>
<p>The possible single values are:
</p>
<dl>
<dt><b><u>*USRID</u></b></dt>
<dd>The user ID/address is the preferred address for this user.
</dd>
<dt><b>*ORNAME</b></dt>
<dd>The X.400 O/R name is the preferred address for this user.
</dd>
<dt><b>*SMTP</b></dt>
<dd>The SMTP name is the preferred address for this user.
</dd>
</dl>
<p>The possible Preferred address field-name value is:
</p>
<dl>
<dt><b><i>field-name</i></b></dt>
<dd>Specify up to 10 characters for the field name. This value should contain an IBM-defined or a user-defined field in the system directory that has been defined by the Change System Directory Attributes (CHGSYSDIRA) command on the USRDFNFLD parameter with a field type of *ADDRESS. The field specified here should then contain information needed by the mail server framework user exit program when the program is determining where to store the mail. This field could just be used as an indicator and the value does not have to be an IBM-defined or user-defined field. Whenever possible, the value specified here should be an IBM-defined or a user-defined field.
</dd>
</dl>
<p>The possible Preferred address product-ID values are:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>No user-defined field product ID is specified.
</dd>
<dt><b>*IBM</b></dt>
<dd>The field name is an IBM-defined field in the system distribution directory. Allowed IBM-defined field names are:
<ul>
<li>USER (user profile)
</li>
<li>CCMAILADR (cc:Mail** address)
</li>
<li>FULNAM (full name)
</li>
<li>NETUSRID (network user ID)
</li>
<li>TELNBR1 (telephone number 1)
</li>
<li>TELNBR2 (telephone number 2)
</li>
<li>FAXTELNBR (facsimile telephone number)
</li>
</ul>
</dd>
<dt><b><i>Product-ID</i></b></dt>
<dd>Specify up to 7 characters for the user-defined field product ID.
</dd>
</dl>
<p>The possible Preferred address address-type values are:
</p>
<dl>
<dt><b><i>address-type</i></b></dt>
<dd>Specify up to 8 characters for the address type. The address type is a mail server framework type name that is specified on the Add Mail Framework Type Configuration (QzmfAddMailCfg) API. Whenever possible, this value should be one of the mail server framework configuration type names. When an address type is specified for a preferred address that a is special value, specify *N for the product ID.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.CCMAILADR"></a>
<h3>cc:Mail address (CCMAILADR)</h3>
<p>Specifies the cc:Mail address for this user.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No cc:Mail address is specified.
</dd>
<dt><b><i>'cc:Mail-address'</i></b></dt>
<dd>Specify the cc:Mail address. The address field has a maximum of 126 characters. If the address includes both a remote post office name and an alias name, the limit is 126 characters for each, with a space separating them (total 253). If the remote post office name contains spaces, the name needs to be put in quotation marks. This adds two characters to the limit for a total of 128 or 255 with the alias name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.CCMAILCMT"></a>
<h3>cc:Mail comment (CCMAILCMT)</h3>
<p>Specifies the cc:Mail comment for this user.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No cc:Mail comment is specified.
</dd>
<dt><b><i>'cc:Mail-comment'</i></b></dt>
<dd>Specify up to 126 characters for the cc:Mail comment field.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.ALWSYNC"></a>
<h3>Allow synchronization (ALWSYNC)</h3>
<p>Specifies whether synchronization of this entry with other directories should be allowed.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Synchronization is allowed.
</dd>
<dt><b><i>*NO</i></b></dt>
<dd>Synchronization is not allowed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="ADDDIRE.DLOOWN"></a>
<h3>DLO owner (DLOOWN)</h3>
<p>Specifies if the user profile or the group profile will be assigned the ownership of the Document Library Objects (DLOs) for this directory entry.
</p>
<p>
<b>Note: </b>If this directory entry does not have a user profile in the User profile field, the value in the DLO owner field will be ignored.
</p>
<dl>
<dt><b><u>*USRPRF</u></b></dt>
<dd>The user profile associated with this directory entry is the owner of the newly created Document Library Objects (DLOs).
</dd>
<dt><b><i>*GRPPRF</i></b></dt>
<dd>The group profile specified in the user profile associated with this directory entry is made the owner of newly created DLOs and has all authority to the DLOs. If the group profile value is *NONE in the user profile, then the owner of the DLO is the user profile.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDIRE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Adding a Local User</b>
</p>
<p>
<pre>
ADDDIRE USRID(HURST PAYROLL)
USRD('Manager of Payroll') USER(ABHURST)
LSTNAM(Hurst) FSTNAM(Arthur) PREFNAM(Art) DEPT(55K)
ADDR1('Dept55K/025-3')
ADDR2('IBM Rochester')
ADDR3('Highway 52 North')
ADDR4('Rochester, MN 55904')
LOC('Main Office') BLDG(025-3) OFC(E219)
TELNBR1('435-422-2120') TELNBR2('435-422-1012')
FAXTELNBR('435-422-3296') DLOOWN(*GRPPRF)
</pre>
</p>
<p>This command adds a local user to the distribution directory by allowing the system name parameter to default to *LCL. Since this is a local user, the user profile is specified. Address lines, location, and telephone numbers have been specified. Since the TEXT parameter is not used, it defaults to *NONE. This user is not an indirect user since the INDUSR parameter defaulted to *NO.
</p>
<p>The user's last, first, and preferred names are specified. The full name was not specified, so FULNAM(*DFT) is used and will be created as, 'Hurst, Arthur (Art)'. This user has been added as a member of the department named 55K. If this department is searched, then 'Hurst, Arthur (Art)' will be included on the search list.
</p>
<p>Any newly created DLOs associated with this directory entry, HURST PAYROLL, will be owned by the group profile specified in the Group Profile field in user profile ABHURST. The user entry is added to the directory if each one of the following is true:
</p>
<ol>
<li>A user ID and address HURST PAYROLL is not already in the directory.
</li>
<li>The user profile name ABHURST is not already in the directory.
</li>
</ol>
<p><b>Example 2: Adding a Remote User</b>
</p>
<p>
<pre>
ADDDIRE USERID(BYRD NEWYORK) USRD('Arthur J. Byrd')
USER(*NONE) SYSNAME(BOCA)
LOC('Boca Raton, Florida') DEPT(61Q)
</pre>
</p>
<p>This command adds a remote user entry to the distribution directory. Since this is a remote user, the USER(*NONE) parameter is specified. The system name without the system group is specified. Except for the location, all of the parameters use default values. If the user-ID and address are unique, the user entry is added to the directory as a remote user.
</p>
<p>If you are using directory shadowing, you do not need to add remote users as these users can be shadowed to your system.
</p>
<p>If a department value is specified for this user, but no user name is specified, the last name is set to '*'. The full name is also '*' because it is created from the last name. This is done because the directory requires a non-blank name with department.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="ADDDIRE.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF8360</b></dt>
<dd>Not enough storage for commitment control operation.
</dd>
<dt><b>CPF89A3</b></dt>
<dd>Operation not successful due to authority reasons.
</dd>
<dt><b>CPF89A4</b></dt>
<dd>Operation not successful due to data validation reasons.
</dd>
<dt><b>CPF8AA1</b></dt>
<dd>Library QUSRSYS not completely installed.
</dd>
<dt><b>CPF90A8</b></dt>
<dd>*SECADM special authority required to do requested operation.
</dd>
<dt><b>CPF9009</b></dt>
<dd>System requires file &amp;1 in &amp;2 be journaled.
</dd>
<dt><b>CPF9024</b></dt>
<dd>System cannot get correct record to finish operation.
</dd>
<dt><b>CPF905C</b></dt>
<dd>Error occurred trying to find a translation table.
</dd>
<dt><b>CPF9082</b></dt>
<dd>User ID and address &amp;1 &amp;2 not added to directory.
</dd>
<dt><b>CPF9096</b></dt>
<dd>Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
</dd>
<dt><b>CPF9810</b></dt>
<dd>Library &amp;1 not found.
</dd>
<dt><b>CPF9838</b></dt>
<dd>User profile storage limit exceeded.
</dd>
<dt><b>CPF9845</b></dt>
<dd>Error occurred while opening file &amp;1.
</dd>
<dt><b>CPF9846</b></dt>
<dd>Error while processing file &amp;1 in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#ADDDIRE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>