Change characteristics of one or more existing accounts.

Syntax

modify username

Command Switches
-confirm
-flags=flags
-group=name
-group_name=name
-last_connect
-last_disconnect
-log
-message_count=value
-overdraft=value
-owner=owner
-password=password
-past_block_days=value
-private=data
-prompt
-pwdexpired
-quota=value
-received_bytes=value
-received_messages=value
-total_connect=value
-total_connections=value

Parameters

username

Name of the account for which to make the modifications. Can contain wild card characters.

Description

The modify command changes one or more characteristics of an existing account. Characteristics not specified with switches in the command are left unchanged. When the username parameter contains wild card characters, all matching accounts within the manager's management group and subgroups thereof will be modified. The -group switch can be used to further constrain which accounts are modified.

Command Switches

-confirm

-noconfirm

Prompt for positive confirmation before carrying out the indicated operation. When wild cards are not used, -noconfirm is the default. When wild cards are used, -confirm is the default and a prompt is issued for each account to be operated upon. Moreover, when wild cards are used, -noconfirm causes only a single prompt to be issued.

-flags=(flag[,...])

Change the usage flags associated with the account. The recognized flags are as follows:

dismail	User is not allowed to receive new mail messages.
disuser	User is not allowed to access their account.
lockpwd	User is not allowed to change their password.
manage	User is allowed to manage popstore accounts.
migrated	Internal flag used by the PMDF migration utilities.
pwd_elsewhere	Password information is stored outside of the popstore.
nodismail	User is allowed to receive new mail messages.
nodisuser	User is allowed to access their account.
nolockpwd	User is allowed to change their password.
nomanage	User is not allowed to manage popstore accounts.
nomigrated	Internal flag used by the PMDF migration utilities.
nopwd_elsewhere	Password information is stored within the popstore.

-group=name

Name of a management group to constrain the operation to. This switch can be used in conjunction with a username parameter containing wild card characters so as to further constrain the modify operation.

-group_name=name

Change the accounts to be in the specified management group. A manager can not change an account's management group to be a group outside of the manager's group.

-last_connect

Clear the user's last connect time field.

-last_disconnect

Clear the user's last disconnect time field.

-log

-nolog

When the operation is successful, output a status message stating that the operation succeeded. Note that error messages are always indicated. -nolog is the default behavior.

-message_count=value

Reduce the user's message count to the specified value, deleting stored messages if necessary. The act of deleting stored message will change the past block days field.

-overdraft=value

-nooverdraft

Change the account's overdraft quota which is the amount of message storage by which the account can exceed its primary message storage quota. By default, this quantity is specified in units of kbytes; however, the set storage_units command can be used to change the units used. Specifying -nooverdraft is equivalent to specifying -overdraft=0. The maximum value is 4 gigabytes minus 1. If the value specified exceeds the maximum, the value is set to zero (no overdraft quota).

-owner=owner

Change the accounts ownership field. The length of the string can not exceed 40 bytes. The owner field is not used by the popstore itself; it is generally used by humans to associate account usernames with the actual owner of the account.

-password=password

-nopassword

Change the account's password. The length of the password can not exceed 32 bytes. Access by non-managers to the account requires knowledge of this password. For instance, to access the account from a POP3 client, the correct username and password associated with the account must be supplied. When -nopassword is specified, the account is changed to not require any password in order to access it. Note that passwords are case sensitive.

-past_block_days=value

Set the user's past block days field to the specified, integer value. Changing this value clears the past block days remainder field.

-private=data

Change the site-specific account data stored in the account profile file. The data string can not exceed a length of 64 bytes. This data is not used by the popstore itself but can be used by site-developed procedures which access account profiles.

-prompt (default)

-noprompt

By default if a wildcard is used, even if -noconfirm is specified, one confirmation prompt is issued. If -noprompt is specified, there is no prompting at all.

-pwdexpired

-nopwdexpired

If -pwdexpired is specified, then the account is marked as pre-expired. This means that if password expiration is enabled through the PASSWORD_LIFETIME option, then the user must change their password immediately.

If -nopwdexpired is specified, then the account is marked as not pre-expired. The time of last password change is set to the current time. If password expiration is enabled, then the user does not have to change the password until the PASSWORD_LIFETIME has run out.

The default is to not change the pre-expired status of the account.

-quota=value

-noquota

Change the account's message storage quota. The account can continue to receive new messages so long as the storage consumed by its currently stored messages does not exceed its message storage quota. See also -overdraft. A quota value of zero, conveys unlimited storage. That is, to grant an account unlimited storage set its quota to zero. This can be done by specifying either -quota=0 or -noquota. By default, this quantity is specified in units of kbytes; however, the set storage_units command can be used to change the units used. The maximum value is 4 gigabytes minus 1. If the value specified exceeds the maximum, the value is set to zero (unlimited quota).

-received_bytes=value

Set the cumulative count of received message bytes to the specified, integer value. By default, this quantity is specified in units of kbytes; however, the set storage_units command can be used to change the units used. The maximum value is 4 gigabytes minus 1. If the value specified exceeds the maximum, the value is set to zero.

-received_messages=value

Set the cumulative count of received messages to the specified, integer value.

-total_connect=value

Set the user's total connect field to the specified, integer value.

-total_connections=value

Set the user's count of total connections to the specified, integer value.

Examples

In the following example, the quota and password fields are changed for the user jdoe:

popstore> modify jdoe -password=TodaY -quota=20000