This attribute is a boolean value which controls how the AST_MAPGET... functions behave if the requested key is not found in the KeyMap. If KeyError is zero (the default), then these functions will return .FALSE. but no error will be reported. If KeyError is non-zero, then the same values are returned but an error is also reported.

KeyMap

• When setting a new value for KeyError, the supplied value is propagated to any KeyMaps contained within the supplied KeyMap.

• When clearing the KeyError attribute, the attribute is also cleared in any KeyMaps contained within the supplied KeyMap.