Public methods

changePassword

void changePassword (const char* password,
                      const char* newPassword)

password
The user's existing password--a string of up to 8 characters
newPassword
The user's new password--a string of up to 8 characters.

Attempts to change the user's password.

Conditions

INVREQ, NOTAUTH, USERIDERR

daysUntilPasswordExpires

unsigned short daysUntilPasswordExpires() const

Returns the number of days before the password expires. This method is valid after a successful verifyPassword method call in this class.

ESMReason

unsigned long ESMReason() const

Returns the external security reason code of interest if a changePassword or verifyPassword method call is unsuccessful.

ESMResponse

unsigned long ESMResponse() const

Returns the external security response code of interest if a changePassword or verifyPassword method call is unsuccessful.

groupId

const IccGroupId& groupId() const

Returns a reference to the IccGroupId object that holds information on the user's group ID.

invalidPasswordAttempts

unsigned long invalidPasswordAttempts() const

Returns the number of times the wrong password has been entered for this user since the last successful signon. This method should only be used after a successful verifyPassword method.

language

const char* language() const

Returns the user's language after a successful call to signon in IccTerminal.

lastPasswordChange

const IccAbsTime& lastPasswordChange() const

Returns a reference to an IccAbsTime object that holds the time when the password was last changed. This method should only be used after a successful verifyPassword method.

lastUseTime

const IccAbsTime& lastUseTime() const

Returns a reference to an IccAbsTime object that holds the time when the user ID was last used. This method should only be used after a successful verifyPassword method.

passwordExpiration

const IccAbsTime& passwordExpiration() const

Returns a reference to an IccAbsTime object that holds the time when the password will expire. This method should only be used after a successful verifyPassword method.

setLanguage

void setLanguage(const char* language)

Sets the IBM®-defined national language code that is to be associated with this user. This should be a three character value.

verifyPassword

void verifyPassword(const char* password)

Checks that the supplied password matches the password recorded by the external security manager for this IccUser.

Conditions

INVREQ, NOTAUTH, USERIDERR

[[ Contents Previous Page | Next Page Index ]]