Nitido Inc.

com.nitido.nimx.nuggets.wcap
Class WcapServerException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by com.nitido.nim.NiMException
              extended by com.nitido.nimx.nuggets.wcap.WcapException
                  extended by com.nitido.nimx.nuggets.wcap.WcapServerException
All Implemented Interfaces:
java.io.Serializable

public class WcapServerException
extends WcapException

Indicates the iPlanet Calendar Server has just returned an unexpected error code.

The constants defined in this objects are the error codes used by SunONE Calendar Server 6.0. For iPlanet Calendar Server 5.X, only the error code less than or equal to 45 (NOT_ALLOWED_TO_REQUEST_PUBLISH) are used.

See Also:
Serialized Form

Field Summary
static int ACCESS_DENIED
          Generated if a non-admin user tries to read or set the calendar-owned list or the calendar-subscribed list of some other user, or if the option is not turned on in the server.
static int ACCESS_DENIED_TO_CALENDAR
          The command has failed because the user has no privilege to access the calendar.
static int ADDLINK_FAILED
          The command has failed.
static int ANONYMOUS_NOT_ALLOWED
          Command cannot be executed as anonymous.
static int ATTENDEE_GROUP_EXPANSION_CLIPPED
          An LDAP group being expanded was too large and exceeded the maximum number allowed in an expansion.
static int BAD_ARGUMENTS
          Currently used when attendee or organizer specified does not have a valid email address.
static int BAD_ORG_ARGUMENTS
          The command enountered bad organizer arguments.
static int CALENDAR_DISABLED
          The command has failed because the specified calendar has been disabled in the server's database.
static int CALENDAR_DOES_NOT_EXIST
          The command has failed because the calendar does not exist.
static int CALID_NOT_SPECIFIED
          The calendar ID has not been specified.
static int CANNOT_MODIFY_LINKED_EVENTS
          The storeEvent command failed because the target event was a linked event.
static int CANNOT_MODIFY_LINKED_TODOS
          The storeTodos command failed because the target todo was a linked todo.
static int CANNOT_SENT_EMAIL
          The email notification failed.
static int CAPI_NOT_SUPPORTED
          Failed to read the CS&T calendar data.
static int CDWP_ERR_BAD_DATA
          Bad data received from DWP connection.
static int CDWP_ERR_CANNOT_CONNECT
          Cannot connect to back end.
static int CDWP_ERR_CANNOT_RESOLVE_CALENDAR
          Front end cannot resolve calendar to a particular back end.
static int CDWP_ERR_DWPHOST_CTX_DOES_NOT_EXIST
          For the back end host, context doesn't exist in the context table.
static int CDWP_ERR_HOSTNAME_NOT_RESOLVABLE
          DNS/NIS/files or hostname resolver is not set up properly or machine does not exist.
static int CDWP_ERR_MAX_CONNECTION_REACHED
          Maximum connections to back end database reached.
static int CHANGE_PASSWORD_FAILED
          The command has failed.
static int COMPONENT_NOT_FOUND
          Returned when a fetch or delete is attempted that does not exist.
static int CREATECALENDAR_ALREADY_EXISTS_FAILED
          The command has failed because a calendar with that name already exists in the database.
static int CREATECALENDAR_FAILED
          The command has failed.
static int DELETE_EVENTS_BY_ID_FAILED
          The command has failed.
static int DELETE_TODOS_BY_ID_FAILED
          The command has failed.
static int DELETECALENDAR_FAILED
          The command has failed.
static int DELETECOMPONENTS_BY_RANGE_FAILED
          The command has failed.
static int DELETEEVENTS_BY_RANGE_FAILED
          The command has failed.
static int DELETETODOS_BY_RANGE_FAILED
          The command has failed.
static int FETCH_BY_ALARM_RANGE_FAILED
          The command has failed.
static int FETCH_BY_ATTENDEE_ERROR_FAILED
          The command has failed.
static int FETCH_BY_LAST_MODIFIED_FAILED
          The command has failed.
static int FETCH_DELETEDCOMPONENTS_FAILED
          Fetch deleted components failed.
static int FETCH_DELETEDCOMPONENTS_PARTIAL_RESULT
          Success but partial result.
static int FETCH_EVENTS_BY_ID_FAILED
          The command has failed.
static int FETCH_TODOS_BY_ID_FAILED
          The command has failed.
static int FETCHBYDATERANGE_FAILED
          The command has failed.
static int FETCHCOMPONENTS_FAILED_BAD_TZID
          Command failed to find correct tzid.
static int GET_ALL_TIMEZONES_FAILED
          The command has failed.
static int GET_CALPROPS_FAILED
          The command has failed.
static int GET_FREEBUSY_FAILED
          The command has failed.
static int GET_INVITE_COUNT_FAILED
          Error in getting invite count (for getCalProps(), fetchEventsByRange() and fetchToDosByRange() commands).
static int GET_USERPREFS_FAILED
          The getUserPrefs command failed.
static int GETTIME_FAILED
          Get server time failed.
static int ILLEGAL_CALID_NAME
          The command has failed because the calendar ID is invalid.
static int INSUFFICIENT_PARAMETERS
          The caller tried to invoke verifyEventsByIds, or verifyToDosByIds with insufficient arguments (mismatched number of uids and rids).
static int LDAP_ERROR
          For getCalProps, when there is an error is getting LDAP derived token values (X-S1CS-CALPROPS-FB-INCLUDE, X-S1CS-CALPROPS-COMMON-NAME).
static int LIST_FAILED
          The list command failed.
static int LIST_SUBSCRIBED_FAILED
          The listSubscriber command failed.
static int LOGIN_FAILED
          Login failed, session ID timed out.
static int LOGIN_OK_DEFAULT_CALENDAR_NOT_FOUND
          Login was successful, but the default calendar for this user was not found.
static int LOGOUT
          The user session has been logout successfully.
static int MUSTBEOWNER_OPERATION
          The user needs to be an owner or co-owner of the calendar in questions to complete this operation.
static int NOT_ALLOWED_TO_REQUEST_PUBLISH
          The requester was not an organizer of the event, and, therefore, is not allowed to edit the component using the PUBLISH or REQUEST method.
static int OK
          The command was successful.
static int SEARCH_CALPROPS_FAILED
          The command has failed.
static int SET_USERPREFS_FAILED
          The command has failed.
static int SETCALPROPS_FAILED
          The command has failed.
static int STORE_FAILED_DOUBLE_BOOKED
          If double booking is not allowed in the calendar, storeEvent and storeToDo will fail with this error when attempting to store an event/todo in a time slot that was already filled.
static int STORE_FAILED_RECUR_SAMEDAY
          Two instances of a recurring event can't occur on the same day.
static int STORE_FAILED_RECUR_SKIP
          One instance of a recurring event skips over another.
static int STOREEVENTS_FAILED
          The command has failed.
static int STORETODOS_FAILED
          The command has failed.
static int SUBSCRIBE_FAILED
          The subscribe command failed.
static int UNSUBSCRIBE_FAILED
          The unsubscribe command failed.
static int USERPREFS_ACCESS_DENIED
          Either the server does not allow this administrator access to get/modify user preferences, or the requester is not an administrator.
static int WCAP_CREATE_EXISTS
          The storeEvent command issued with storetype set to 1 (WCAP_STORE_TYPE_CREATE) and the event already exists.
static int WCAP_MODIFY_CANT_MAKE_COPY
          The storeEvent command issued and copy of event failed during processing.
static int WCAP_MODIFY_NO_EVENT
          The storeEvent command issued with storeytype set to 2 (WCAP_STORE_TYPE_MODIFY) and the event doesn't exist.
static int WCAP_NO_SUCH_FORMAT
          Returned in any of the commands when supplied fmt-out is not a supported format.
static int WRITE_IMPORT_FAILED
          The import failed while writing files to the server.
 
Constructor Summary
WcapServerException(java.lang.String msg, int errorCode)
           
 
Method Summary
 int getErrorCode()
          Get the error code returned by iCS.
 
Methods inherited from class com.nitido.nim.NiMException
toString
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

LOGOUT

public static final int LOGOUT
The user session has been logout successfully. The actual value is -1.

See Also:
Constant Field Values

OK

public static final int OK
The command was successful. The actual value is 0.

See Also:
Constant Field Values

LOGIN_FAILED

public static final int LOGIN_FAILED
Login failed, session ID timed out. Invalid session ID. The actual value is 1.

See Also:
Constant Field Values

LOGIN_OK_DEFAULT_CALENDAR_NOT_FOUND

public static final int LOGIN_OK_DEFAULT_CALENDAR_NOT_FOUND
Login was successful, but the default calendar for this user was not found. A new default calendar set to the userid was created. The actual value is 2.

See Also:
Constant Field Values

DELETE_EVENTS_BY_ID_FAILED

public static final int DELETE_EVENTS_BY_ID_FAILED
The command has failed. The actual value is 6.

See Also:
Constant Field Values

SETCALPROPS_FAILED

public static final int SETCALPROPS_FAILED
The command has failed. The actual value is 8.

See Also:
Constant Field Values

FETCH_EVENTS_BY_ID_FAILED

public static final int FETCH_EVENTS_BY_ID_FAILED
The command has failed. The actual value is 9.

See Also:
Constant Field Values

CREATECALENDAR_FAILED

public static final int CREATECALENDAR_FAILED
The command has failed. The actual value is 10.

See Also:
Constant Field Values

DELETECALENDAR_FAILED

public static final int DELETECALENDAR_FAILED
The command has failed. The actual value is 11.

See Also:
Constant Field Values

ADDLINK_FAILED

public static final int ADDLINK_FAILED
The command has failed. The actual value is 12.

See Also:
Constant Field Values

FETCHBYDATERANGE_FAILED

public static final int FETCHBYDATERANGE_FAILED
The command has failed. The actual value is 13.

See Also:
Constant Field Values

STOREEVENTS_FAILED

public static final int STOREEVENTS_FAILED
The command has failed. The actual value is 14.

See Also:
Constant Field Values

STORETODOS_FAILED

public static final int STORETODOS_FAILED
The command has failed. The actual value is 15.

See Also:
Constant Field Values

DELETE_TODOS_BY_ID_FAILED

public static final int DELETE_TODOS_BY_ID_FAILED
The command has failed. The actual value is 16.

See Also:
Constant Field Values

FETCH_TODOS_BY_ID_FAILED

public static final int FETCH_TODOS_BY_ID_FAILED
The command has failed. The actual value is 17.

See Also:
Constant Field Values

FETCHCOMPONENTS_FAILED_BAD_TZID

public static final int FETCHCOMPONENTS_FAILED_BAD_TZID
Command failed to find correct tzid. Applies to fetchEventsbyRange, fetchToDosByRange, fetchEventsById and fetchToDosById. The actual value is 18.

See Also:
Constant Field Values

SEARCH_CALPROPS_FAILED

public static final int SEARCH_CALPROPS_FAILED
The command has failed. The actual value is 19.

See Also:
Constant Field Values

GET_CALPROPS_FAILED

public static final int GET_CALPROPS_FAILED
The command has failed. The actual value is 20.

See Also:
Constant Field Values

DELETECOMPONENTS_BY_RANGE_FAILED

public static final int DELETECOMPONENTS_BY_RANGE_FAILED
The command has failed. The actual value is 21.

See Also:
Constant Field Values

DELETEEVENTS_BY_RANGE_FAILED

public static final int DELETEEVENTS_BY_RANGE_FAILED
The command has failed. The actual value is 22.

See Also:
Constant Field Values

DELETETODOS_BY_RANGE_FAILED

public static final int DELETETODOS_BY_RANGE_FAILED
The command has failed. The actual value is 23.

See Also:
Constant Field Values

GET_ALL_TIMEZONES_FAILED

public static final int GET_ALL_TIMEZONES_FAILED
The command has failed. The actual value is 24.

See Also:
Constant Field Values

CREATECALENDAR_ALREADY_EXISTS_FAILED

public static final int CREATECALENDAR_ALREADY_EXISTS_FAILED
The command has failed because a calendar with that name already exists in the database. The actual value is 25.

See Also:
Constant Field Values

SET_USERPREFS_FAILED

public static final int SET_USERPREFS_FAILED
The command has failed. The actual value is 26.

See Also:
Constant Field Values

CHANGE_PASSWORD_FAILED

public static final int CHANGE_PASSWORD_FAILED
The command has failed. The actual value is 27.

See Also:
Constant Field Values

ACCESS_DENIED_TO_CALENDAR

public static final int ACCESS_DENIED_TO_CALENDAR
The command has failed because the user has no privilege to access the calendar. The actual value is 28.

See Also:
Constant Field Values

CALENDAR_DOES_NOT_EXIST

public static final int CALENDAR_DOES_NOT_EXIST
The command has failed because the calendar does not exist. The actual value is 29.

See Also:
Constant Field Values

ILLEGAL_CALID_NAME

public static final int ILLEGAL_CALID_NAME
The command has failed because the calendar ID is invalid. The actual value is 30.

See Also:
Constant Field Values

CANNOT_MODIFY_LINKED_EVENTS

public static final int CANNOT_MODIFY_LINKED_EVENTS
The storeEvent command failed because the target event was a linked event. The actual value is 31.

See Also:
Constant Field Values

CANNOT_MODIFY_LINKED_TODOS

public static final int CANNOT_MODIFY_LINKED_TODOS
The storeTodos command failed because the target todo was a linked todo. The actual value is 32.

See Also:
Constant Field Values

CANNOT_SENT_EMAIL

public static final int CANNOT_SENT_EMAIL
The email notification failed. It is usually caused by the server not being properly configured to send email. This error can occur in storeEvent, storeToDo, deleteEventsById and deleteToDosById. The actual value is 33.

See Also:
Constant Field Values

CALENDAR_DISABLED

public static final int CALENDAR_DISABLED
The command has failed because the specified calendar has been disabled in the server's database. The actual value is 34.

See Also:
Constant Field Values

WRITE_IMPORT_FAILED

public static final int WRITE_IMPORT_FAILED
The import failed while writing files to the server. The actual value is 35.

See Also:
Constant Field Values

FETCH_BY_LAST_MODIFIED_FAILED

public static final int FETCH_BY_LAST_MODIFIED_FAILED
The command has failed. The actual value is 36.

See Also:
Constant Field Values

CAPI_NOT_SUPPORTED

public static final int CAPI_NOT_SUPPORTED
Failed to read the CS&T calendar data. The actual value is 37.

See Also:
Constant Field Values

CALID_NOT_SPECIFIED

public static final int CALID_NOT_SPECIFIED
The calendar ID has not been specified. The actual value is 38.

See Also:
Constant Field Values

GET_FREEBUSY_FAILED

public static final int GET_FREEBUSY_FAILED
The command has failed. The actual value is 39.

See Also:
Constant Field Values

STORE_FAILED_DOUBLE_BOOKED

public static final int STORE_FAILED_DOUBLE_BOOKED
If double booking is not allowed in the calendar, storeEvent and storeToDo will fail with this error when attempting to store an event/todo in a time slot that was already filled. The actual value is 40.

See Also:
Constant Field Values

FETCH_BY_ALARM_RANGE_FAILED

public static final int FETCH_BY_ALARM_RANGE_FAILED
The command has failed. The actual value is 41.

See Also:
Constant Field Values

FETCH_BY_ATTENDEE_ERROR_FAILED

public static final int FETCH_BY_ATTENDEE_ERROR_FAILED
The command has failed. The actual value is 42.

See Also:
Constant Field Values

ATTENDEE_GROUP_EXPANSION_CLIPPED

public static final int ATTENDEE_GROUP_EXPANSION_CLIPPED
An LDAP group being expanded was too large and exceeded the maximum number allowed in an expansion. The expansion stopped at the specified maximum limit. The maximum limit defaults to 200. To change the maximum limit, set the server configuration preference calstore.group.attendee.maxsize. The actual value is 43.

See Also:
Constant Field Values

USERPREFS_ACCESS_DENIED

public static final int USERPREFS_ACCESS_DENIED
Either the server does not allow this administrator access to get/modify user preferences, or the requester is not an administrator. The actual value is 44.

See Also:
Constant Field Values

NOT_ALLOWED_TO_REQUEST_PUBLISH

public static final int NOT_ALLOWED_TO_REQUEST_PUBLISH
The requester was not an organizer of the event, and, therefore, is not allowed to edit the component using the PUBLISH or REQUEST method. The actual value is 45.

See Also:
Constant Field Values

INSUFFICIENT_PARAMETERS

public static final int INSUFFICIENT_PARAMETERS
The caller tried to invoke verifyEventsByIds, or verifyToDosByIds with insufficient arguments (mismatched number of uids and rids). The actual value is 46.

(NOTE: this error code should never occur in the WcapNugget, as it does not support verifyXXX methods yet).

See Also:
Constant Field Values

MUSTBEOWNER_OPERATION

public static final int MUSTBEOWNER_OPERATION
The user needs to be an owner or co-owner of the calendar in questions to complete this operation. (Probably related to private or confidential component.) The actual value is 47.

See Also:
Constant Field Values

GETTIME_FAILED

public static final int GETTIME_FAILED
Get server time failed. The actual value is 55.

See Also:
Constant Field Values

FETCH_DELETEDCOMPONENTS_FAILED

public static final int FETCH_DELETEDCOMPONENTS_FAILED
Fetch deleted components failed. The actual value is 56.

See Also:
Constant Field Values

FETCH_DELETEDCOMPONENTS_PARTIAL_RESULT

public static final int FETCH_DELETEDCOMPONENTS_PARTIAL_RESULT
Success but partial result. The actual value is 57.

See Also:
Constant Field Values

WCAP_NO_SUCH_FORMAT

public static final int WCAP_NO_SUCH_FORMAT
Returned in any of the commands when supplied fmt-out is not a supported format. The actual value is 58.

See Also:
Constant Field Values

COMPONENT_NOT_FOUND

public static final int COMPONENT_NOT_FOUND
Returned when a fetch or delete is attempted that does not exist. The actual value is 59.

See Also:
Constant Field Values

BAD_ARGUMENTS

public static final int BAD_ARGUMENTS
Currently used when attendee or organizer specified does not have a valid email address. The actual value is 60.

See Also:
Constant Field Values

GET_USERPREFS_FAILED

public static final int GET_USERPREFS_FAILED
The getUserPrefs command failed. The following error conditions will return error code 61: The actual value is 61.

See Also:
Constant Field Values

WCAP_MODIFY_NO_EVENT

public static final int WCAP_MODIFY_NO_EVENT
The storeEvent command issued with storeytype set to 2 (WCAP_STORE_TYPE_MODIFY) and the event doesn't exist. The actual value is 62.

See Also:
Constant Field Values

WCAP_CREATE_EXISTS

public static final int WCAP_CREATE_EXISTS
The storeEvent command issued with storetype set to 1 (WCAP_STORE_TYPE_CREATE) and the event already exists. The actual value is 63.

See Also:
Constant Field Values

WCAP_MODIFY_CANT_MAKE_COPY

public static final int WCAP_MODIFY_CANT_MAKE_COPY
The storeEvent command issued and copy of event failed during processing. The actual value is 64.

See Also:
Constant Field Values

STORE_FAILED_RECUR_SKIP

public static final int STORE_FAILED_RECUR_SKIP
One instance of a recurring event skips over another. The actual value is 65.

See Also:
Constant Field Values

STORE_FAILED_RECUR_SAMEDAY

public static final int STORE_FAILED_RECUR_SAMEDAY
Two instances of a recurring event can't occur on the same day. The actual value is 66.

See Also:
Constant Field Values

BAD_ORG_ARGUMENTS

public static final int BAD_ORG_ARGUMENTS
The command enountered bad organizer arguments. The arguments orgCalid or orgEmail must be passed if any other org parameter is sent. That is, orgUID can't be sent alone on a storeEvent or a storeToDo command if it is trying about to "create" the event or task. Note, if no org information is passed, the organizer defaults to the calid being passed with the command. The actual value is 67.

See Also:
Constant Field Values

LDAP_ERROR

public static final int LDAP_ERROR
For getCalProps, when there is an error is getting LDAP derived token values (X-S1CS-CALPROPS-FB-INCLUDE, X-S1CS-CALPROPS-COMMON-NAME). The actual value is 69.

See Also:
Constant Field Values

GET_INVITE_COUNT_FAILED

public static final int GET_INVITE_COUNT_FAILED
Error in getting invite count (for getCalProps(), fetchEventsByRange() and fetchToDosByRange() commands). The actual value is 70.

See Also:
Constant Field Values

LIST_FAILED

public static final int LIST_FAILED
The list command failed. The actual value is 71.

(NOTE: this error code should never occur in the WcapNugget, as it does not support listXXX methods yet).

See Also:
Constant Field Values

LIST_SUBSCRIBED_FAILED

public static final int LIST_SUBSCRIBED_FAILED
The listSubscriber command failed. The actual value is 72.

(NOTE: this error code should never occur in the WcapNugget, as it does not support listXXX methods yet).

See Also:
Constant Field Values

SUBSCRIBE_FAILED

public static final int SUBSCRIBE_FAILED
The subscribe command failed. The actual value is 73.

(NOTE: this error code should never occur in the WcapNugget, as it does not support subscribe method yet).

See Also:
Constant Field Values

UNSUBSCRIBE_FAILED

public static final int UNSUBSCRIBE_FAILED
The unsubscribe command failed. The actual value is 74.

(NOTE: this error code should never occur in the WcapNugget, as it does not support unsubscribe method yet).

See Also:
Constant Field Values

ANONYMOUS_NOT_ALLOWED

public static final int ANONYMOUS_NOT_ALLOWED
Command cannot be executed as anonymous. Used only for list, listSubscribed, subscribe and unsubscribe commands. The actual value is 75.

(NOTE: this error code should never occur in the WcapNugget, as it does not support the mentioned methods yet).

See Also:
Constant Field Values

ACCESS_DENIED

public static final int ACCESS_DENIED
Generated if a non-admin user tries to read or set the calendar-owned list or the calendar-subscribed list of some other user, or if the option is not turned on in the server. The actual value is 76.

See Also:
Constant Field Values

CDWP_ERR_MAX_CONNECTION_REACHED

public static final int CDWP_ERR_MAX_CONNECTION_REACHED
Maximum connections to back end database reached. As connections are freed up users will be allowed to connect to back end. The actual value is 11000.

See Also:
Constant Field Values

CDWP_ERR_CANNOT_CONNECT

public static final int CDWP_ERR_CANNOT_CONNECT
Cannot connect to back end. Back end machine may be down or DWP server is not up and running. The actual value is 11001.

See Also:
Constant Field Values

CDWP_ERR_CANNOT_RESOLVE_CALENDAR

public static final int CDWP_ERR_CANNOT_RESOLVE_CALENDAR
Front end cannot resolve calendar to a particular back end. The actual value is 11002.

See Also:
Constant Field Values

CDWP_ERR_BAD_DATA

public static final int CDWP_ERR_BAD_DATA
Bad data received from DWP connection. The actual value is 11003.

See Also:
Constant Field Values

CDWP_ERR_DWPHOST_CTX_DOES_NOT_EXIST

public static final int CDWP_ERR_DWPHOST_CTX_DOES_NOT_EXIST
For the back end host, context doesn't exist in the context table. Solution is to add back end host to ics.conf and restart front end. The actual value is 11004.

See Also:
Constant Field Values

CDWP_ERR_HOSTNAME_NOT_RESOLVABLE

public static final int CDWP_ERR_HOSTNAME_NOT_RESOLVABLE
DNS/NIS/files or hostname resolver is not set up properly or machine does not exist. The actual value is 11005.

See Also:
Constant Field Values
Constructor Detail

WcapServerException

public WcapServerException(java.lang.String msg,
                           int errorCode)
Method Detail

getErrorCode

public int getErrorCode()
Get the error code returned by iCS.

Overrides:
getErrorCode in class NiMException
Returns:
The error code.

Nitido NiM 2.5 Java API

These JavaDoc pages are generated for release/nim_2_5-2.5.44

Copyright © 1999-2009 Nitido Inc.    Proprietary and Confidential.    All Rights Reserved.