Image Color Map: _onError

Image Color Map: _onError

Determines actions in case of an error

Syntax
Details
Example

Syntax

CALL SEND (object-id, '_onError', <message><abort>);

Argument Type Description

message
C the string MESSAGE or NOMESSAGE to indicate whether the default error message should be written to the log when an error occurs

abort
C the string ABORT or NOABORT to indicate whether the program should abort when an error occurs

Argument	Type	Description
message	C	the string MESSAGE or NOMESSAGE to indicate whether the default error message should be written to the log when an error occurs
abort	C	the string ABORT or NOABORT to indicate whether the program should abort when an error occurs

Details

If you specify either message or abort but not both, the omitted action defaults to its current value, which is the value last specified. For example, if you specify 'MESSAGE NOABORT ' and later you specify 'NOMESSAGE ', NOABORT remains in effect.

Example

This example overrides the default behavior so that the SCL program does not abort. When you do this, make sure to check SYSRC to see if each method completed successfully.

   /* Don't abort or print the default msg
      when an error occurs. */
call send(cmap_id,'_onError',
          'NOMESSAGE NOABORT');

call send(cmap_id,'_getColor', user_input,
          red, green, blue);
rc = sysrc();

   /* Print error if _getColor call
      failed. */
if (rc ne 0) then
   put "Invalid color index used for
    _getColor";

Chapter Contents
Previous
Next
Top of Page