CL Command Reference - CHGDIRE
CL Command List > CHGDIRE Reference
Description:
The Change Directory Entry (CHGDIRE) command allows you to change the data for a specific entry in the system distribution directory.
This command provides support for the X.400 product (X.400). The X.400 is a limited program offering (LPO) developed for the &sys. system as an Open System Interconnect (OSI) application. It implements the X.400 series of recommendations developed by the International Telegraph and Telephone Consultative Committee (CCITT) to allow the interchange of messages (mail) between users on systems from different vendors (for example, IBM and DEC).
The CHGDIRE command does not provide interactive display support. This is provided by the Work with Directory Entries (WRKDIRE) command.
NOTES:
1. To prevent the system from changing lowercase characters to uppercase characters, enclose the values in apostrophes. This does not apply to user ID/address, system name/group, department, or X.400 originator/recipient (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 specify *DEVD to display the device description.
3. Double-byte character set (DBCS) characters can be entered for the following system directory entry parameters:
. USRD
. LSTNAM
. FSTNAM
. MIDNAM
. PREFNAM
. FULNAM
. DEPT
. TITLE
. CMPNY
. LOCATION
. BLDG
. OFC
. ADDR1
. ADDR2
. ADDR3
. ADDR4
. TEXT
. USRDFNFLD
4. Administrators have authority to update any directory entry. Users who are not administrators are restricted to changing specific fields on their own directory entry. If users who are not administrators run this command and specify a USRID other than their own, an error message is returned. If a non-administrator requests a change to any of the following fields, an error message is returned, indicating the person running the command is not authorized to update these fields.
. Description (USRD)
. User profile (USER)
. System name (SYSNAME)
. Indirect user (INDUSR)
. Receiving personal mail (PRTPERS)
. Last name (LSTNAM)
. First name (FSTNAM)
. Middle name (MIDNAM)
. Preferred name (PREFNAM)
. Full name (FULNAM)
. Department (DEPT)
. Forward from (FWDFRM)
. Network user ID (NETUSRID)
. Allow synchronization (ALWSYNC)
. DLO Owner (DLOOWN)
. X.400 O/R name fields (COUNTRY, ADMD, PRMD, ORG, SURNAM, GIVENNAM, INITIALS, GENQUAL, ORGUNIT AND DMNDFNATR)
. Mail service level (MSFSRVLVL) v Preferred address (PREFADR)
Restrictions: You must have administrator authority to update any of the data contained in a directory entry, except the user ID and address. If you are not an administrator, you can update only a limited number of fields in your own directory entry.
Examples:
Example 1: Changing a User¡¯s Telephone Number
CHGDIRE USRID(HURST PAYROLL) USER(*SAME) TELNBR1(¡¯456-4489¡¯)
Assume the user who runs the command has user ID HURST PAYROLL and does not have security administrator authority. The primary telephone number for the user is changed. All other information remains the same. This command works the same if someone other than HURST PAYROLL runs the command and has security administrator authority. If the person running the command is not HURST PAYROLL and does not have security administrator authority, an error message is returned.
Example 2: Changing a User¡¯s Address, Telephone Number, and Text Information
CHGDIRE USRID(BYRD NEWYORK) USER(AJBYRD) SYSNAME(*LCL)
ADDR1(¡¯Dept55N/025-3¡¯) ADDR2(¡¯IBM Rochester¡¯)
ADDR3(*NONE) ADDR4(*NONE) TELNBR1(¡¯456-4489¡¯)
LOC(Rochester) TEXT(¡¯User transferred from Boca¡¯)
Assume the person running this command has security administrator authority. The user (BYRD NEWYORK) has transferred from a remote user to a local user. The profile name must now be specified since the user is now a local user. The user¡¯s address, telephone number, and text information are updated
Example 3: Changing a User¡¯s Full Name, Department, and Office
CHGDIRE USRID(JANE CHICAGO) LSTNAM(¡¯Smith¡¯) MIDNAM(¡¯Allen¡¯)
FULNAM(*DFT) DEPT(55N) OFC(L305)
Assume the person running this command has security administrator authority. The user JANE CHICAGO has changed her name and at the same time has moved to a new office and department. Jane¡¯s full name is changed to ¡¯Smith, Jane Allen¡¯. If FULNAM(*SAME) is specified or is used as the default, Jane¡¯s full name remains the same, even though her first and middle names are changed.