Messages
All constructors, static methods, and instance
methods have an output parameter consisting of a PDMessages object.
This section describes the attributes of a PDMessages object.
In addition, exceptions generated by Verify Identity Access contain
a PDMessages object.
PDMessages object
can be empty or contain one or more PDMessages objects.
Each PDMessages object represents a single message
and consists of the following attributes: - Message code
- A hexadecimal number that uniquely identifies the message.
- Message text
- The localized text of the message.
- Severity
- An indication of the severity of the message:
- Informational
- Warning
- Error
The message text is localized based on the PDContext object
used when the method is invoked except in the case of read-only instance
method on a local administration object.
When a method completes successfully, check the PDMessages object
for any informational or warning messages associated with the action
performed. If an error is encountered during processing, a PDException exception
is thrown, which might have messages associated with it.
The same PDMessages object can be used on multiple
method invocations. Use the clear() method
to clear the contents of the PDMessages object between
method invocations.
The IBM Verify Identity Access for Web: Error Message Reference contains a list of the messages issued by Verify Identity Access along with an explanation of the message and the suggested corrective action. Messages are indexed by hexadecimal and decimal message number, as well as by message identifier.