Create a new account which duplicates an existing account
(popstore only).
Syntax
COPY from-username to-username[,...]
Command Qualifiers Defaults
/CONFIRM
/FLAGS=flags
/GROUP_NAME=name
/LOG
/OVERDRAFT=value
/OWNER=owner
/PASSWORD=password
/PRIVATE=data
/PROMPT
/PWDEXPIRED
/QUOTA=value
1 – Parameters
from-username
The name of the popstore account to copy.
to-username
The name of the popstore account or accounts to create.
2 – 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.
3 – Command Qualifiers
3.1 /CONFIRM
/CONFIRM
/NOCONFIRM (default)
Prompt for positive confirmation before carrying out the
indicated operation. /NOCONFIRM is the default behavior.
3.2 /FLAGS
/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_ Password information is stored outside of the
ELSEWHERE 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_ Password information is stored within the
ELSEWHERE popstore.
3.3 /GROUP_NAME
/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.
3.4 /LOG
/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.
3.5 /OVERDRAFT
/OVERDRAFT=value
/NOOVERDRAFT
The /OVERDRAFT qualifier 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 qualifier is equivalent to /OVERDRAFT=0 and
specifies 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).
3.6 /OWNER
/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.
3.7 /PASSWORD
/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.
The /NOPASSWORD qualifier specifies that the new account does not
require a password to access it.
Note that passwords are case sensitive. Note further that the
command line reader will convert to lower case any string not
enclosed in quotes. As such, a password containing upper case
characters must be enclosed in quotes.
3.8 /PRIVATE
/PRIVATE=data
Site-specific account data for the new account can be stored in
the account profile file using this qualifier. 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.
3.9 /PROMPT
/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.
3.10 /PWDEXPIRED
/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.
3.11 /QUOTA
/QUOTA=value
/NOQUOTA
The /QUOTA qualifier specifies 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, as specified with either /QUOTA=0 or
/NOQUOTA, conveys unlimited storage. That is, to grant an account
unlimited storage set its quota to zero.
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).
4 – 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"