A description that provides detail about the current state of the client-principal object.
Data type: CHARACTER
Access: Read-only
Applies to: Client-principal object handle
The AVM sets the value of this attribute, along with the LOGIN-STATE attribute, whenever the state of a client-principal object changes. You can also set the value of this attribute when calling the AUTHENTICATION-FAILED( ) method to place a client-principal object in an authentication failed state in order to specify a reason for the authentication failure.