Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide

commadmin user modify

The commadmin user modify command modifies attributes of a single user’s directory entry. To modify multiple user, use the -i option.


commadmin user modify -D login -n domain -l userid -w password
   [-A [+|-]attributename:value] [-d domain] [-h] [-?] [-i inputfile] [-p AM port]
   [-s] [-v] [-V] [-X AM host]
   [-S mail -H mailhost [-E email]]
   [-S cal [-B DWPHost] [-E email] [-k calid_type] [-J First Day of Week] 
   [-T time zone]]


The following options are mandatory:



-D login

The user ID of the user with permission to execute this command. 

-n domain

Domain of the user specified with the -D option.

-w password

The password of user specified with the -D option.

-l userid

User’s login ID. 

The following options are non-mandatory:



-A [+ | -]attributename:value

An attribute to modify. The attributename is defined in the LDAP schema and value replaces any and all current values for this attribute in the directory. You can repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.

A “+” before the attributename indicates adding the value to the current list of attributes.

A “-” indicates removing the value. 

If the “-” is used, it must be preceded by two backslashes if the command is specified on the command line. If the option is provided within an input file, one backslash must precede the “-” sign. 

-d domain

Domain of the user or group. If -d is not specified, the domain specified by -n is used.

-h, -?

Prints command usage syntax. 

-i inputfile

Reads the command information from a file instead of the command line. 

-p AM port

Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default AM port is used, or Port 80 is used if no default was configured at install time.


Use SSL (Secure Socket Layer) to connect to the Access Manager. 


Enable debugging output. 


Prints information about the utility and its version. 

-X AM host

Specifies the host on which the Access Manager is running. If not specified, the default AM host is used, or the localhost if no default was configured at install time.

-S service

Adds the specified services to the user after validating whether the user has the service specified with -S option.If the user already has the service an error message is displayed.

services can have the value of a single service or multiple services. The valid service values are mail and cal. These values are case-insensitive.

The list of services is separated by the comma (,) delimiter. 

For Example: 

-S mail,cal

The following options are only allowed if the -S mail option is specified:


-E email

Specifies the email address of the user. 

-H mailhost

The mail host of the user. 

This option is mandatory if the -S mail option is specified.

The following options are only allowed if the -S cal option is specified:


-B DWPHost

Specifies the DNS name of the backend calendar server that hosts this user’s calendars. 

Note: This attribute can only be added and cannot be modified if it already exists. 

-E email

Specifies the email address for the calendar user. 

-J First Day of Week

The first day of the week shown when the calendar is displayed in the calendar server user interface. The valid values are 0-6 (0 is Sunday, 1 is Monday, and so on). 

-k calid_type

Specifies the type of calendar id that is created (when adding the calendar service). The accepted values are legacy and hosted. If -k legacy is specified, only the calendar id is used (for example, jsmith). If -k hosted is specified, the calendar id plus domain is used (for example,

If the -k option is not specified, the default is to use the calendar id plus domain (hosted).

You can set the value of the calendar id type that is created if the -k option is not specified. To do so, add the following parameter to the file:


where value is “hosted” | “legacy”.

The file is located in the following directory:

da_base/data/WEB-INF/classes/sun/comm/cli/ \ server/servlet/

-T time zone

A user’s calendar is displayed in this time zone. 

See Calendar Time Zone Strings for a list of the valid time zone strings.


The following example adds a mail service for the user smith:

commadmin user modify -D chris -n -w bolton -l smith \
-A description:"new description" -S mail -H

In this example, a mail forwarding address is added for user smith:

commadmin user modify -D chris -n -w bolton -l smith \