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.

The ADDDIRE command does not provide interactive display support. This is provided by the Work with Directory Entries (WRKDIRE) command.

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.

NOTES

1. 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.
2. 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.
3. Double-byte character set (DBCS) characters can be entered for the following system directory entry parameters:

   USRD       LOCATION
   LSTNAM     BLDG
   FSTNAM     OFC
   MIDNAM     ADDR1
   PREFNAM    ADDR2
   FULNAM     ADDR3
   DEPT       ADDR4
   TITLE      TEXT
   CMPNY      USRDFNFLD
   

Restriction: You must have security administrator authority or be a security officer to use this command.

Parameters

Keyword	Description	Choices	Notes
USRID	User identifier	Element list	Required, Positional 1
	Element 1: User ID	Character value
	Element 2: Address	Character value
USRD	User description	Character value	Required, Positional 2
USER	User profile	Name, *NONE	Optional, Positional 3
SYSNAME	System name	Single values: *LCL, *PC, *ERROR Other values: Element list	Optional
	Element 1: System name	Character value
	Element 2: System group	Character value
NETUSRID	Network user ID	Character value, *USRID	Optional
LSTNAM	Last name	Character value, *NONE	Optional
FSTNAM	First name	Character value, *NONE	Optional
MIDNAM	Middle name	Character value, *NONE	Optional
PREFNAM	Preferred name	Character value, *NONE	Optional
FULNAM	Full name	Character value, *DFT	Optional
DEPT	Department	Character value, *NONE	Optional
TITLE	Job title	Character value, *NONE	Optional
CMPNY	Company	Character value, *NONE	Optional
TELNBR1	Telephone number 1	Character value, *NONE	Optional
TELNBR2	Telephone number 2	Character value, *NONE	Optional
FAXTELNBR	FAX telephone number	Character value, *NONE	Optional
LOC	Location	Character value, *NONE	Optional
BLDG	Building	Character value, *NONE	Optional
OFC	Office	Character value, *NONE	Optional
ADDR1	Address line 1	Character value, *NONE	Optional
ADDR2	Address line 2	Character value, *NONE	Optional
ADDR3	Address line 3	Character value, *NONE	Optional
ADDR4	Address line 4	Character value, *NONE	Optional
INDUSR	Indirect user	*NO, *YES	Optional
PRTPERS	Print private mail	*NO, *YES	Optional
PRTCOVER	Print cover page	*YES, *NO	Optional
NFYMAIL	Mail notification	*SPECIFIC, *ALLMAIL, *NOMAIL	Optional
NFYPTYPERS	Priority, private, important	*YES, *NO	Optional
NFYMSGS	Messages	*YES, *NO	Optional
TEXT	Text	Character value, *NONE	Optional
CMDCHRID	Command character identifier	Single values: *SYSVAL, *DEVD Other values: Element list	Optional
	Element 1: Graphic character set	Integer
	Element 2: Code page	Integer
COUNTRY	Country or region ID	Character value, *NONE	Optional
ADMD	Administration domain	Character value, *NONE	Optional
PRMD	Private management domain	Character value, *NONE	Optional
SURNAM	Surname	Character value, *NONE, *LSTNAM	Optional
GIVENNAM	Given name	Character value, *NONE, *FSTNAM	Optional
INITIALS	Initials	Character value, *NONE	Optional
GENQUAL	Generation qualifier	Character value, *NONE	Optional
ORG	Organization	Character value, *NONE	Optional
ORGUNIT	Organizational units	Single values: *NONE Other values (up to 4 repetitions): Character value	Optional
DMNDFNATR	Domain-defined attributes	Single values: *NONE Other values (up to 4 repetitions): Element list	Optional
	Element 1: Type	Character value
	Element 2: Value	Character value
USRDFNFLD	User-defined fields	Single values: *NONE Other values (up to 100 repetitions): Element list	Optional
	Element 1: Field name	Character value
	Element 2: Product ID	Character value, *NONE
	Element 3: Value	Character value
MSFSRVLVL	Mail service level	Single values: *USRIDX, *SYSMS, *DOMINO Other values: Element list	Optional
	Element 1: Field name	Character value
	Element 2: Product ID	Character value, *NONE
PREFADR	Preferred address	Element list	Optional
	Element 1: Field name	Character value, *USRID, *ORNAME, *SMTP
	Element 2: Product ID	Character value, *NONE
	Element 3: Address type	Character value
CCMAILADR	cc:Mail address	Character value, *NONE	Optional
CCMAILCMT	cc:Mail comment	Character value, *NONE	Optional
ALWSYNC	Allow synchronization	*YES, *NO	Optional
DLOOWN	DLO owner	*USRPRF, *GRPPRF	Optional

Top

User identifier (USRID)

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.

*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.

This is a required parameter.

user-id address

Specify the user ID and address. A maximum of 8 characters can be used in each field.

If any lowercase characters are specified, the system changes them to, and stores them as, uppercase characters.

User description (USRD)

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.

This is a required parameter.

user-description

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.

User profile (USER)

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.

*NONE

The user being added to the directory is a remote user and has no local profile.

user-profile-name

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.

System name (SYSNAME)

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.

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.

*LCL

The system name defaults to the local name. All local users being added to the directory should have *LCL specified as the system name.

*PC

*PC is for a distributed systems node executive (DSNX) user with a personal computer (PC) attached to this system.

*ERROR

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 *ANY *ANY entry directing distributions to the central system. The central system also has a default *ANY address 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.

*ERROR is valid only when *ANY address or *ANY *ANY is specified on the User identifier (USRID) parameter.

system-name-group

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'.

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.

Network user ID (NETUSRID)

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.

*USRID

Set the network user ID to the user ID and address associated with this directory entry.

network-user-ID

Specify the network user ID for the user. A maximum of 47 characters can be specified.

Last name (LSTNAM)

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 Department (DEPT) parameter, the last name defaults to an asterisk (*).

*NONE

No last name is specified for the user.

last-name

Specify a maximum of 40 characters for the last name of the user.

First name (FSTNAM)

Specifies the first name of the user.

*NONE

No first name is specified for the user.

first-name

Specify a maximum of 20 characters for the first name of the user.

Middle name (MIDNAM)

Specifies the middle name of the user.

*NONE

No middle name is specified for the user.

middle-name

Specify a maximum of 20 characters for the middle name of the user.

Preferred name (PREFNAM)

Specifies the name by which the user likes to be addressed.

*NONE

No preferred name is specified for the user.

preferred-name

Specify a maximum of 20 characters for the preferred name of the user.

Full name (FULNAM)

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:

• Last, First Middle (Preferred)
• If parts of the full name are not provided, the missing parts are removed from this format.
• The preferred name, when it is specified, is always enclosed in parentheses.
• 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.

Note: Only an administrator can change this field.

*DFT

The full name is built by the system from the values entered for the last name, first name, middle name, and preferred name.

full-name

Specify a maximum of 50 characters for the full name of the user.

Department (DEPT)

Specifies the name or number of the department of which the user is a member.

Restriction: Only an administrator can change this field.

*NONE

No department is specified for the user.

department-name

Specify a maximum of 10 characters for the name of the user's department.

Job title (TITLE)

Specifies the user's job title, such as marketing director, account manager, or production engineer.

*NONE

No job title is specified for the user.

job-title

Specify a maximum of 40 characters for the user's job title.

Company (CMPNY)

Specifies the name of the company for which the user works.

*NONE

No company name is specified for the user.

company

Specify a maximum of 50 characters for the company name.

Telephone number 1 (TELNBR1)

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.

*NONE

No telephone number is specified.

telephone-number-1

Specify a maximum of 26 characters for the user's primary telephone number.

Telephone number 2 (TELNBR2)

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.

*NONE

A secondary telephone number is not specified.

telephone-number-2

Specify a maximum of 26 characters for the user's secondary telephone number.

FAX telephone number (FAXTELNBR)

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.

*NONE

A facsimile telephone number is not specified.

facsimile-telephone-number

Specify a maximum of 32 characters for the user's facsimile telephone number.

Location (LOC)

Specifies the location of the user's business or system.

*NONE

No location is specified.

location

Specify a maximum of 40 characters for the location.

Building (BLDG)

Specifies the name of the building in which the user works.

*NONE

No building is specified.

building

Specify a maximum of 20 characters for the name of the building in which the user works.

Office (OFC)

Specifies the name or number of the user's office.

*NONE

No office is specified.

office

Specify a maximum of 16 characters for the user's office.

Address line 1 (ADDR1)

Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.

*NONE

No address line is specified.

character-value

Specify the user's mailing address in any format.

Address line 2 (ADDR2)

Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.

*NONE

No address line is specified.

character-value

Specify the user's mailing address in any format.

Address line 3 (ADDR3)

Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.

*NONE

No address line is specified.

character-value

Specify the user's mailing address in any format.

Address line 4 (ADDR4)

Specifies the user's mailing address. A maximum of 40 characters can be entered into each of these fields.

*NONE

No address line is specified.

character-value

Specify the user's mailing address in any format.

Indirect user (INDUSR)

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.

*NO

The user is not an indirect user.

*YES

The user is an indirect user.

Print private mail (PRTPERS)

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.

*NO

No private mail is printed for this indirect user.

*YES

Private mail is printed for this indirect user.

Print cover page (PRTCOVER)

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.

*YES

A cover page is printed when a mail item is printed.

*NO

A cover page is not printed when a mail item is printed.

Mail notification (NFYMAIL)

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.

*SPECIFIC

The user is notified only when the types of mail specified on the Priority, private, important (NFYPTYPERS) parameter and Messages (NFYMSGS) parameter arrive. These types of mail can include priority and personal mail, and messages.

*ALLMAIL

The user is notified of the arrival of all types of mail.

*NOMAIL

The user is not notified of the arrival of mail.

Priority, private, important (NFYPTYPERS)

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 Mail notification (NFYMAIL) parameter.

*YES

The user is notified of the arrival of priority, private, and important mail.

*NO

The user is not notified of the arrival of priority, private, and important mail.

Messages (NFYMSGS)

Specifies whether the user is notified of the arrival of messages. This parameter is ignored if *NOMAIL or *ALLMAIL is specified on the Mail notification (NFYMAIL) parameter.

*YES

The user is notified of the arrival of messages.

*NO

The user is not notified of the arrival of messages.

Text (TEXT)

Specifies the text that briefly describes the object.

*NONE

No text is specified.

text

Specify a maximum of 50 characters of text, enclosed in apostrophes, to describe additional information about the user.

Command character identifier (CMDCHRID)

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 User identifier (USRID) parameter, System name (SYSNAME) parameter, Department (DEPT) parameter, and to all of the X.400 O/R name parameters.

Note:

• 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.
• 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.

Note: Double byte character set (DBCS) characters can be entered on the following system directory entry parameters:

• User description (USRD)
• Last name (LSTNAM)
• First name (FSTNAM)
• Middle name (MIDNAM)
• Preferred name (PREFNAM)
• Full name (FULNAM)
• Department (DEPT)
• Job title (TITLE)
• Company (CMPNY)
• Location (LOC)
• Building (BLDG)
• Office (OFC)
• Address line 1 (ADDR1)
• Address line 2 (ADDR2)
• Address line 3 (ADDR3)
• Address line 4 (ADDR4)
• Text (TEXT)

Single values

*SYSVAL

The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.

*DEVD

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.

Element 1: Graphic character set

1-32767

Specify the graphic character set to use.

Element 2: Code page

1-32767

Specify the code page to use.

Country or region. (COUNTRY)

Specifies the country or region part of the X.400 Originator/Recipient (O/R) name.

*NONE

No country or region is specified.

country or region-code

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.

Administration domain (ADMD)

Specifies the administration management domain part of the X.400 O/R name.

*NONE

No administration management domain is specified.

administration-management-domain

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.

Private management domain (PRMD)

Specifies the private management domain part of the X.400 O/R name.

*NONE

No private management domain is specified.

private-management-domain

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.

Surname (SURNAM)

Specifies the X.400 user last name part of the personal name within the X.400 O/R name.

Note: This parameter is required when a value is specified on the GIVENNAM, INITIALS or GENQUAL, parameter.

*NONE

No surname is specified.

*LSTNAM

The user last name specified in the directory entry is used as the surname.

surname

Specify a maximum of 40 characters for the surname.

Given name (GIVENNAM)

Specifies the X.400 user first name part of the personal name within the X.400 O/R name.

Note: The SURNAM parameter is required when a value is specified on this parameter.

*NONE

No given name is specified.

*FSTNAM

The user first name specified in the directory entry is used as the given name. It is truncated to 16 characters.

given-name

Specify a maximum of 16 characters for the given name.

Initials (INITIALS)

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.'

Note: The SURNAM parameter is required when a value is specified on this parameter.

*NONE

No initials are specified.

initials

Specify a maximum of 5 characters for the initials.

Generation qualifier (GENQUAL)

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.'

Note: The SURNAM parameter is required when a value is specified on this parameter.

*NONE

No generation qualifier is specified.

generation-qualifier

Specify a maximum of 3 characters for the generation qualifier.

Organization (ORG)

Specifies the organization name part of the X.400 O/R name.

*NONE

No organization name is specified.

organization

Specify a maximum of 64 characters for the organization name.

Organizational units (ORGUNIT)

Specifies the organization-defined unit part of the X.400 O/R name.

*NONE

No organizational unit is specified.

'organizational-unit'

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.

Domain-defined attributes (DMNDFNATR)

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.

Note: To specify an X.121 address, type X.121 in the Type field, and then type the X.121 address in the Value field. A maximum of 15 numeric characters can be specified for the X.121 address.

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 Country or region field if you specify an X.121 address.

X.121 is a CCITT Recommendation that provides a method for the international numbering of X.25 packet-switching data networks.

The possible type values are:

*NONE

No domain-defined type is specified.

type

Specify a maximum of 8 characters for the type of the domain-defined attribute.

The possible value values are:

*NONE

No domain-defined value is specified.

value

Specify a maximum of 128 characters for the value of the domain-defined attribute.

User-defined fields (USRDFNFLD)

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.

Note: 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.

• SMTPAUSRID SMTP
• SMTPDMN SMTP
• SMTPRTE SMTP

The possible single value is:

*NONE

No user-defined fields are specified.

The possible User-Defined Field Name value is:

field-name

Specify up to 10 characters for the user-defined field name.

The possible User-Defined Field Product ID values are:

*NONE

No user-defined field product ID is specified.

product-ID

Specify up to 7 characters for the user-defined field product ID.

The possible User-Defined Field Value value is:

'value'

Specify up to 512 characters for the value of the user-defined field value. Blanks are padded on the right.

Mail service level (MSFSRVLVL)

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.

*USRIDX

The mail is stored in a user index.

*SYSMS

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.

*DOMINO

The mail is stored in the Lotus Domino mail database.

The possible Mail service level field-name value is:

field-name

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.

The possible mail service level product-ID values are:

*NONE

No user-defined-field product ID is specified.

Product-ID

Specify up to 7 characters for the user-defined field product ID.

Preferred address (PREFADR)

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.

The possible single values are:

*USRID

The user ID/address is the preferred address for this user.

*ORNAME

The X.400 O/R name is the preferred address for this user.

*SMTP

The SMTP name is the preferred address for this user.

The possible Preferred address field-name value is:

field-name

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.

The possible Preferred address product-ID values are:

*NONE

No user-defined field product ID is specified.

*IBM

The field name is an IBM-defined field in the system distribution directory. Allowed IBM-defined field names are:

• USER (user profile)
• CCMAILADR (cc:Mail** address)
• FULNAM (full name)
• NETUSRID (network user ID)
• TELNBR1 (telephone number 1)
• TELNBR2 (telephone number 2)
• FAXTELNBR (facsimile telephone number)

Product-ID

Specify up to 7 characters for the user-defined field product ID.

The possible Preferred address address-type values are:

address-type

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.

cc:Mail address (CCMAILADR)

Specifies the cc:Mail address for this user.

*NONE

No cc:Mail address is specified.

'cc:Mail-address'

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.

cc:Mail comment (CCMAILCMT)

Specifies the cc:Mail comment for this user.

*NONE

No cc:Mail comment is specified.

'cc:Mail-comment'

Specify up to 126 characters for the cc:Mail comment field.

Allow synchronization (ALWSYNC)

Specifies whether synchronization of this entry with other directories should be allowed.

*YES

Synchronization is allowed.

*NO

Synchronization is not allowed.

DLO owner (DLOOWN)

Specifies if the user profile or the group profile will be assigned the ownership of the Document Library Objects (DLOs) for this directory entry.

Note: 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.

*USRPRF

The user profile associated with this directory entry is the owner of the newly created Document Library Objects (DLOs).

*GRPPRF

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.

Examples

Example 1: Adding a Local User

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)

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.

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.

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:

1. A user ID and address HURST PAYROLL is not already in the directory.
2. The user profile name ABHURST is not already in the directory.

Example 2: Adding a Remote User

ADDDIRE   USERID(BYRD NEWYORK)  USRD('Arthur J. Byrd')
          USER(*NONE)  SYSNAME(BOCA)
          LOC('Boca Raton, Florida')  DEPT(61Q)

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.

If you are using directory shadowing, you do not need to add remote users as these users can be shadowed to your system.

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.

Error messages

*ESCAPE Messages

CPF8360

Not enough storage for commitment control operation.

CPF89A3

Operation not successful due to authority reasons.

CPF89A4

Operation not successful due to data validation reasons.

CPF8AA1

Library QUSRSYS not completely installed.

CPF90A8

*SECADM special authority required to do requested operation.

CPF9009

System requires file &1 in &2 be journaled.

CPF9024

System cannot get correct record to finish operation.

CPF905C

Error occurred trying to find a translation table.

CPF9082

User ID and address &1 &2 not added to directory.

CPF9096

Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.

CPF9810

Library &1 not found.

CPF9838

User profile storage limit exceeded.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.