Exception Classes in com.novell.asam.JAscAuth

The following exceptions, along with java/lang/NullPointerException, are the exceptions that are thrown by the methods of JAscAuth.

InvalidJAscException

Thrown when a method requires an authentication environment, but a valid authentication environment does not exist.

Most methods of com.novell.asam.JAscAuth.JAscAuth require that you call the init method before you call them. InvalidJAscException is thrown if you do not do so.

Corresponds to a return code of 16, AS_NOAUTHENV, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscAttrNotFoundException

Thrown when the attribute specified to the readAttr method was not found for the specified object.

Corresponds to a return code of 13, AS_ATTRNOTFOUND, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscAuthenticationException

Thrown when the password specified to the checkPassword method is not valid.

Corresponds to a return code of 1, AS_NO, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscBadClientException

Thrown when the network address used by the platform to contact a core driver for a method call does not match the network address listed in the Platform Configuration object in the ASAM System container.

Corresponds to a return code of 4, AS_BADCLIENT, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscChangePasswordException

Thrown by changePassword when the password cannot be changed.

Also thrown by changePassword if the old password given is not valid.

Corresponds to a return code of 1, AS_NO, and a return code of 4, AS_BADCLIENT, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscException

Thrown by most method calls when an unexpected or indeterminate error condition occurs.

JAscInsufficientRightsException

Thrown by adminResetPassword if the administrative user does not exist, if the administrative user password specified is not valid, or if the administrative user does not have rights to change the password.

Also thrown by adminResetPassword if the network address used by the platform to contact a core driver does not match the network address listed in the Platform Configuration object in the ASAM System container.

Corresponds to a return code of 24, AS_INSUFFICIENTRIGHTS from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscIntruderException

Thrown by checkPassword and changePassword when the specified user is locked because of intruder detection.

Corresponds to a return code of 6, AS_INTRUDER, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscInvalidArgsException

Thrown when a parameter passed to a method is null or not valid.

Corresponds to a return code of 7, AS_INVALIDARGS, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscInvalidObjException

Thrown when an object passed to a method is not found or is not of the correct type.

Corresponds to a return code of 8, AS_INVALIDOBJ, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscInvalidObjLenException

Thrown when an object name passed to a method is longer than the maximum allowable name.

Corresponds to a return code of 9, AS_INVALIDOBJLEN, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscInvalidReqException

Thrown when a method call is not known by the core driver.

Corresponds to a return code of 22, AS_INVALIDREQ, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscKeyExpiredException

Thrown when the DES encryption key used by a non-SSL platform has expired.

Corresponds to a return code of 23, AS_KEYEXPIRED, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscNoAgentException

Thrown when no core driver could be contacted to process a method call.

Corresponds to a return code of 3, AS_NOAGENT, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscNoUserException

Thrown when the user specified to a method call is inactive or not in the Census.

Corresponds to a return code of 2, AS_NOUSER, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscPassDuplicateException

Thrown by changePassword when the new password has been previously used for the user object, and the user is required to use unique passwords.

Corresponds to a return code of 10, AS_PASSDUPLICATE, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscPassTooShortException

Thrown by changePassword when the new password is shorter than the minimum password length set for the user.

Corresponds to a return code of 11, AS_PASSTOOSHORT, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscProductExpiredException

Thrown when the expiration date for the platform has passed.

Corresponds to a return code of 17, AS_PRODUCTEXPIRED, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.

JAscRevokedException

Thrown by checkPassword and changePassword when the specified user is disabled.

Corresponds to a return code of 5, AS_REVOKED, from the AS Client API. For more information, see Section A.0, Troubleshooting the API.