Recoverable Errors

Hi,

in the last meeting we talked about adding the concept of recoverable
errors to the SceMiErrorType type. In the discussion we touched upon
the possibility of enumerating a bunch of recoverable errors that
should be standardized. I went through the spec and came up with the
following first cut:

  SceMi::Init() [return NULL on error]

    Incorrect version argument
    NULL parameters argument [?]

  SceMi::BindMessageInPort() [return NULL on error]

    Transactor not found
    Port not found
    transactorName argument NULL [?]
    portName argument NULL [?]

  SceMi::BindMessageOutPort() [return NULL on error]

    Transactor not found
    Port not found
    transactorName argument NULL [?]
    portName argument NULL [?]

  SceMiParameters::SceMiParameters()

    Parameter file not found [?]
    paramsFile argument NULL [?]

  SceMiParameters::NumberOfObjects() [return 0 on error]

    Object kind not found [actually I think it is better just to
      return 0 in this case, i.e., not an error]
    objectKind argument NULL [?]

  SceMiParameters::AttributeIntegerValue() [return 0 on error]

    Object kind not found
    Index out of bounds
    Attribute not found
    objectKind argument NULL [?]
    attributeName argument NULL [?]

  SceMiParameters::AttributeStringValue() [return NULL on error]

    Object kind not found
    Index out of bounds
    Attribute not found
    objectKind argument NULL [?]
    attributeName argument NULL [?]

  SceMiParameters::OverrideAttributeIntegerValue() [void return value]

    Object kind not found
    Index out of bounds
    Attribute not found
    objectKind argument NULL [?]
    attributeName argument NULL [?]

  SceMiParameters::OverrideAttributeStringValue() [void return value]

    Object kind not found
    Index out of bounds
    Attribute not found
    objectKind argument NULL [?]
    attributeName argument NULL [?]

  SceMiMessageData::Set() [void return value, do nothing on error]

    Index out of bounds

  SceMiMessageData::SetBit() [void return value, do nothing on error]

    Index out of bounds

  SceMiMessageData::SetBitRange() [void return value, do nothing on
    error]

    Index out of bounds
    Index + range out of bounds

  SceMiMessageData::Get() [return 0 on error]

    Index out of bounds

  SceMiMessageData::GetBit() [return 0 on error]

    Index out of bounds

  SceMiMessageData::GetBitRange() [return 0 on error]

    Index out of bounds
    Index + range out of bounds

That's it. I think the above is a good start.

Enjoy,
Per

-- 
Per Bojsen                                Email: <bojsen@zaiqtech.com>
Zaiq Technologies, Inc.                   WWW:   http://www.zaiqtech.com
78 Dragon Ct.                             Tel:   781 721 8229
Woburn, MA 01801                          Fax:   781 932 7488