Set password for remote authentication, e.g., POP client (APOP), IMAP client (CRAM), or mailbox filter authentication.

Syntax

PMDF PASSWORD [password]

Command Qualifiers	Defaults
/CREATE	/CREATE
/DELETE	/CREATE
/SERVICE=keyword	/SERVICE=DEFAULT
/SHOW	/CREATE
/TEST	/CREATE

restrictions

All operations other than setting, deleting, or verifying one's own password require privileges.

prompts

Parameters

password

The password to set. Note that password entries are case sensitive. And at the protocol level, note that passwords used for APOP and CRAM-MD5 authentication are case sensitive. If specifying the password on the DCL command line, be sure to quote any password containing lower case characters; DCL will forcibly upper case the password value if it is not quoted.

Description

The PMDF PASSWORD utility is used to add and change password entries in the PMDF password database. Such entries can be used for special authorization purposes. Whether you need to use this utility will depend on your site's configuration. If you use the VMS MAIL message store from POP or IMAP clients, then you might need to. Otherwise you probably will not; for instance, PMDF MessageStore users and PMDF popstore users typically do not need to be concerned with password database entries. See Section 10.1 for a further discussion of the PMDF PASSWORD utility as it relates to POP and IMAP client usage. And check with your system administrators if you are uncertain about whether you need to use this utility (to set a PMDF password database entry or entries).

Typically, if you use the PMDF PASSWORD utility at all you would use it to create just a DEFAULT service entry. However, it is possible to instead have service specific entries; a single user can have separate entries for separate services, such as an entry for the IMAP service (preferentially used when authenticating during IMAP connections), and an entry for the POP service (preferentially used when authenticating during POP connections). Authentication checks preferentially for an appropriate service specific entry, but if a service specific entry is not present then falls through to checking the DEFAULT service entry.

Command Qualifiers

/CREATE

Add a new password database entry. This qualifier is the default.

/DELETE

Delete a user/password entry pair from the PMDF password database.

/SERVICE=keyword

Specify for what service a particular password method and password value apply. The default service keyword is DEFAULT; POP3 and IMAP are other possible keywords.

/SHOW

Show a user/service/password-method entry in the PMDF password database. Note that this command does not show the password value.

/TEST

Compare a specified password against a password stored in the PMDF password database.

EXAMPLES

To set your password, with prompting so that the password is not displayed on the screen as you type it, issue the command:

$ PMDF PASSWORD Password:

ERROR MESSAGES

%PMDF-E-CANOPNPASS, Password file does not exist or cannot be opened 
      

The PMDF password database does not exist, or could not be opened. Check with your system administrator.

%PMDF-E-ENTLONGPASS, Entry too long to fit in password file 
      

The password entry is too long; try using a shorter password value.

%SYSTEM-F-NOWORLD, operation requires WORLD privilege 
      

You have insufficient privileges for the attempted operation.