PMDF popstore & MessageStore Manager's Guide


Previous Next Contents Index


copy

Create a new account which duplicates an existing account (popstore only).

Syntax

copy from-username to-username

Command Switches
-confirm
-flags=flags
-group_name=name
-log
-overdraft=value
-owner=owner
-password=password
-private=data
-prompt
-pwdexpired
-quota=value

Parameters

from-username

The name of the popstore account to copy.

to-username

The name of the popstore account to create.

Description

Use the copy command to create a new popstore account which duplicates an existing popstore account. Note that the new account will have its usage accounting fields set to zero (e.g., last connect, total connect, past block days, etc.). Also, the new account will not have any stored messages, even if the account being duplicated has stored messages. If the username of the new account conflicts with an existing account, no new account is created and an error message is issued. See also the rename command.

Note

Your PMDF-POPSTORE license controls the number of popstore user accounts which you can have at any one time. When you reach this limit, you will not be allowed to create additional accounts without first deleting some accounts or obtaining a new license with an increased limit. Sites without a PMDF-POPSTORE license are allowed to use the popstore and create up to ten user accounts. This limit does not include the default account. Use the show -count_users command to display the number of currently defined accounts as well as the limit allowed by your license.

Command Switches

-confirm

-noconfirm (default)

Prompt for positive confirmation before carrying out the indicated operation. -noconfirm is the default behavior.

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

Specify one or more usage flags to associate with the new 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

Place the new account into the specified management group. If not specified, the the management group of the account being copied is assumed. A manager can not create an account into a group which they cannot manage.

-log

-nolog (default)

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.

-overdraft=value

-nooverdraft

The -overdraft switch specifies the amount of message storage by which the new account can exceed its message storage quota. If the account is currently using less than its storage quota, then a new message can be stored provided that it will not result in the account's storage exceeding the sum of the its storage and overdraft quotas. 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 -nooverdraft switch is equivalent to -overdraft=0 and indicates that the new account has no overdraft quota. 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

A text string specifying the name of the owner of the new account. 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

Specifies the new account's access 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. Specifying -nopassword indicates that the new account does not require a password to access it. Note that passwords are case sensitive.

-private=data

Site-specific account data for the new account can be stored in the account profile file using this switch. 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 (default)

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 (the default), 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.

-quota=value

-noquota

The new 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. Specifying -noquota is equivalent to -quota=0. 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).

Examples

To create a new account jdoe for Jane Doe which duplicates the account bsmith but has different owner and password fields, use the command


popstore> copy bsmith jdoe -password=SeCrEt -owner="Jane Doe"


Previous Next Contents Index