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 ISAM contain a PDMessages object. A 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 Security Verify Access for Web: Error Message Reference contains a list of the messages issued by ISAM 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.
Parent topic: Use the administration API