Error processing

When an error condition is encountered, the program issues an error message, if possible, and terminates processing with the appropriate return code. When a warning condition is encountered, the program issues a warning message and continues processing. When a warning or error is the result of an Information Management REXX/HLAPI call, a message appropriate to the reason code is displayed. If an Information Management message chain is available, the associated messages are also displayed.

The program initiates REXX/HLAPI with logging enabled. Error conditions are both printed to the session log and returned to the program in message chains, as appropriate.

For warning message instigated by the Information Management API interface, the program returns a return code of zero because SCLM considers any nonzero return code as an indication of failure. For API errors with return code 8 or higher, the program issues the appropriate messages and return code 8.

The program specifically tests for and reports the following input parameter errors:

No input parameters.
Missing or invalid REXX/HLAPI table name.
Missing or invalid Information Management Class name.
Missing or invalid Information Management Session ID.
Missing or invalid User ID.
Missing or invalid Change Code.
Problem Record not found in the database.
Problem Record Problem Status not "OPEN".
Problem Record Assignee Name does not match User ID.
Input parameters specified as "Ignored" are checked for presence and valid format, and a warning message is issued if warranted. However, the return code presented is zero.