Add Directory Entry (ADDDIRE)

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

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:

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:

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

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 topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/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.

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 IBM i 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.