Improvements to status code explanations requested

Question

There are some status code explanations in the 9.0.4.x
CSDK that could probably use some refinement to be more
useful to application developers.
Two examples:
1."CAPI_STAT_LIBRARY_INTERNAL_DATA = There was a corruption of data in the library."
This might not always indicate that data in the
calendar store is corrupted - which is the way we
initially interpreted this error - but rather that
data provided to be stored is in some way invalid.
Example: calling storeEvents() with an
iCalendar whose DTSTART property was after
DTEND (i.e. start date after ending date),
returned the status "CAPI_STAT_LIBRARY_INTERNAL_DATA".
Example: calling Session.storeEvents() with an iCalendar
whose start and end dates are in a non-UTC TZ in a format
similar to "DTSTART;TZID=US/Pacific:20040517T101500",
that method returned "CAPI_STAT_LIBRARY_INTERNAL_DATA".
Fix: include an appropriate VTIMEZONE component
for that timezone in the submitted iCalendar.
2. Any of the explanations below, which begin with
"Information about ..."
These often seem to indicate that a data format error
has occurred, and that the application developer
needs to modify the format of the data to have it
accepted. The "Information about ..." explanation
doesn't adequately convey that.
Examples:
When calling storeEvents() with an iCalendar with a
missing CR/LF between VEVENT components, that method
returned the status "CAPI_STAT_DATA_ICAL".
Some of the relevant status explanations include:
CAPI_STAT_DATA_COOKIE = Information about the supplied cookie.
CAPI_STAT_DATA_DATE = Information about a date.
CAPI_STAT_DATA_EMAIL = Information about email.
CAPI_STAT_DATA_ENCODING = Information about the encoding of supplied data.
CAPI_STAT_DATA_HOSTNAME = Information about a hostname.
CAPI_STAT_DATA_ICAL = Information about iCalendar data.
CAPI_STAT_DATA_MIME = Information about MIME data.
CAPI_STAT_DATA_UID = Information about a UID.
CAPI_STAT_DATA_USERID = Information about a userID.
In contrast, explanations like the following are much
clearer:
CAPI_STAT_DATA_USERID_FORMAT = The format of the UserId string was wrong.
CAPI_STAT_DATA_USERID_ID = There was a problem with the Id part of the UserId string.
Any improvements such as these in the status code
explanations returned would be welcome, and might help
save debugging time for those new to the CSDK.

Answer 1

Thanks Aaron,
Some notable improvements are coming in the next version of the Oracle Calendar application developer's guide, and your comments will be added for consideration.
Best regards,
Product Management