Table 7 describes the error status constants returned when an Outline API call fails. These values are defined in the Outline API C language header file esserror.h.
For a more complete list, see esserror.h.
Table 7. C Outline API Error Return Values
| Value | Description |
|---|---|
| OTLAPI_BAD_ALIASTABLE | Illegal alias table |
| OTLAPI_BAD_CONSOL | Invalid consolidation type (+,-,etc.) |
| OTLAPI_BAD_GENLEVELNAME | Invalid generation or level name |
| OTLAPI_BAD_HOUTLINE | Invalid outline handle passed to EssOtl... function |
| OTLAPI_BAD_MBRNAME | Invalid member name |
| OTLAPI_BAD_MEMBER | Invalid member handle |
| OTLAPI_BAD_MOVE | Illegal move of member. Can't move member to its descendant. |
| OTLAPI_BAD_OBJTYPE | Illegal object type |
| OTLAPI_BAD_OUTLINETYPE | Invalid outline type |
| OTLAPI_BAD_PERSPECTIVE2 | Invalid perspective |
| OTLAPI_BAD_RENAMESHARE | A shared member cannot be renamed |
| OTLAPI_BAD_RESTRUCTTYPE | Invalid restructure type |
| OTLAPI_BAD_SCA_VALIDITYSET_TYPE | Perspectives/validity sets do not support this validity set type |
| OTLAPI_BAD_SMARTLISTNAME | Invalid text list name |
| OTLAPI_BAD_SORT COMPAREFUNC | Invalid sorting compare function |
| OTLAPI_BAD_SORTTYPE | Invalid sort type |
| OTLAPI_BAD_TRANSTYPE | Unknown transaction type when creating a transaction (internal error) |
| OTLAPI_BAD_USERATTR | Invalid user attribute |
| OTLAPI_CUR_NOACCOUNTS | There is no Accounts dimension. You need an Accounts dimension to create a currency database. |
| OTLAPI_CUR_NOCOUNTRY | There is no Country dimension. You need a Country dimension to create a currency database. |
| OTLAPI_CUR_NOTIME | There is no Time dimension. You need a Time dimension to create a currency database. |
| OTLAPI_ERR_ADDDELETEDIMDYNAMICCALC | Member in which to store data is type Dynamic Calc |
| OTLAPI_ERR_ADDNAMEUSED | Member name already used (add operation) |
| OTLAPI_ERR_ALIASTABLEEXISTS | Alias table already exists |
| OTLAPI_ERR_ALIASLANGUAGE_UNAVAILABLE | Alias table languages are unavailable for outline versions before 11.1.2.0.00. |
| OTLAPI_ERR_ALIASTABLENAME | Illegal alias table name |
| OTLAPI_ERR_ALREADY CURRENCY | The outline is a currency outline. You are trying to create a currency outline, and the initial outline is already a currency outline. |
| OUTAPI_ERR_ASO_COMPRESSIONMUSTBEDYNAMIC | Aggregate storage outlines require compression dimension to be a single dynamic hierarchy |
| OUTAPI_ERR_ASO_DIFFERENTNUMBEROFSHARES | This prototype should have same number of shared members as its previous sibling |
| OUTAPI_ERR_ASO_SHAREDMEMBERSNOTINSAMEORDER | This prototype must have each of its shared members as next sibling to its previous sibling's shared members |
| OTLAPI_ERR_ATTR_ATTACHED_WRONGLEVEL | This attribute is attached at wrong level at least once |
| OTLAPI_ERR_ATTRMBR_ALREADYASSOCIATED | Base member already associated with an attribute member from the same dimension |
| OTLAPI_ERR_BADDIM | Invalid dimension argument |
| OTLAPI_ERR_BADHIER | Invalid hierarchy type |
| OTLAPI_ERR_BADHIER_TOP | Invalid hierarchy member designation - Member must be at generation 1 or 2 |
| OTLAPI_ERR_BADSHARE | Illegal share value |
| OTLAPI_ERR_BADSKIP | Illegal time balance skip value |
| OTLAPI_ERR_BADSTORAGE | Illegal dimension storage value |
| OTLAPI_ERR_BADSTORAGECATEGORY | Illegal storage category |
| OTLAPI_ERR_BADTIMEBAL | Illegal time balance value |
| OTLAPI_ERR_BSO_SOLVEORDER | Block storage outlines that have not been enabled for member types cannot have a solve order |
| OTLAPI_ERR_CANTIDENTIFYMBR_DUPLICATEDNAME | Cannot uniquely identify a member because the name is duplicated |
| OTLAPI_ERR_CNTS_INDEP_LAST | Independent dimension list must be ordered with continuous independent dimensions last |
| OTLAPI_ERR_CONFIGTOOMANYDIMS | Too many dimensions to configure automatically |
| OTLAPI_ERR_COPYALIASTABLE | Source and destination tables are the same |
| OTLAPI_ERR_CREATETEMP | Cannot create temporary file name. You are probably trying to create it on a read-only drive. We create a temporary file on the client every time you open or write an outline from/to the server. |
| OTLAPI_ERR_CURTOOMANYDIMS | Too many dimensions in a currency outline. A currency outline is limited to four dimensions. |
| OTLAPI_ERR_DELETEDEFALIAS | Cannot delete the default alias table |
| OTLAPI_ERR_DISCRETE_DIFFERENT | An independent range must have the same discrete start and end members |
| OTLAPI_ERR_DISCRETE_OR_CNTS | Independent dimension types must be either discrete or continuous |
| OTLAPI_ERR_DUP_LANGCODE | The language code is assigned to another alias table within the same database |
| OTLAPI_ERR_DUPLICATEALIAS | Duplicate alias |
| OTLAPI_ERR_DUPLICATENAME | Duplicate member name |
| OTLAPI_ERR_DUPGENLEVNAME | Cannot add, rename, or set a member name or alias that duplicates a generation or level name |
| OTLAPI_ERR_EXPORT_INCORRECT_FLAGS | There are invalid export flags. Export cannot be enabled to limit extraction to the tree and alias table |
| OTLAPI_ERR_EXPORT_INVALID_ALIASTABLE | An invalid alias table is specified in the export options |
| OTLAPI_ERR_EXPORT_INVALID_DIMLIST | The number of dimensions or the dimension list specified in the export options is invalid |
| OTLAPI_ERR_EXPORT_INVALIDDIM_DIMLIST | The dimension name specified in the export options dimension list is invalid |
| OTLAPI_ERR_EXPORT_INVALID_VERSION | This export version is invalid. Enter a valid export version |
| OTLAPI_ERR_EXPORT_UNABLE_FILE | Cannot open the file to export the outline |
| OTLAPI_ERR_EXPORT_UNABLE_PROCESS | Cannot process the outline because of unsupported outline type |
| OTLAPI_ERR_FAILED_GET_ALIASNAMES | Failed to get all alias names due to failed alias identifier lookup |
| OTLAPI_ERR_FEATURE_UNAVAILABLE | The feature is unavailable in this outline version; please migrate outline first |
| OTLAPI_ERR_FILEIO | Could not read from or write to file |
| OTLAPI_ERR_FILEOPEN | Could not open file |
| OTLAPI_ERR_FORMATSTRING_MISMATCH | Implied share or label-only member has a different format string than the original member; original member's format string will be applied |
| OTLAPI_ERR_FORMATSTRING_NOT_MEMBTYPE_ENABLED | The use of format strings require the outline to be member-type enabled. This outline is not member type enabled |
| OTLAPI_ERR_FORMATSTRINGTOOLONG | Format String too long for single locale configuration |
| OTLAPI_ERR_FUNCTION_OBSOLETE | Function is obsolete |
| OTLAPI_ERR_GENLEVELEXISTS | Generation or level already has a name |
| OTLAPI_ERR_GENLEVELNAMEEXISTS | Generation or level name already exists |
| OTLAPI_ERR_GENLEVELVALUE | Illegal generation or level value |
| OTLAPI_ERR_GENLEVNAMEMBR | Cannot add a generation or level name that duplicates a member name or alias |
| OTLAPI_ERR_ILLEGALALIAS STRING | Illegal member combinational for alias |
| OTLAPI_ERR_ILLEGALCOMBOALIAS | Illegal combinational alias name |
| OTLAPI_ERR_ILLEGALCURRENCY | Illegal currency member |
| OTLAPI_ERR_ILLEGALDEFALIAS | Illegal default alias name |
| OTLAPI_ERR_ILLEGALNAME | Illegal member name |
| OTLAPI_ERR_ILLEGALTAG | Illegal dimension tag (category) |
| OTLAPI_ERR_ILLEGALOPTION | Occurs when the user passes in an invalid option to EssOtlGetGenNames() or EssOtlGetLevelNames() |
| OTLAPI_ERR_IMPLIED_SHARE_OLD_VERSION | The outline version is too old to set Implied Share |
| OTLAPI_ERR_INCORRECT_MEMBERTYPE | Member type can be only set to numeric or date types |
| OTLAPI_ERR_INVALID_SMARTLIST_HANDLE | Invalid text list handle |
| OTLAPI_ERR_INVALID_SMARTLIST_IMPORTFILE | Input file for importing text lists is invalid |
| OTLAPI_ERR_INVALIDID_SMARTLIST_IMPORTFILE | Invalid or duplicate ID in text list import file |
| OTLAPI_ERR_LANGCODE_TOOLONG | Alias table language code exceeds the maximum length |
| OTLAPI_ERR_LEAFLABEL | Leaf member defined as a label member |
| OTLAPI_ERR_MAXALIASTABLES | Maximum number of alias tables has been reached |
| OTLAPI_ERR_MEMBERCALC | Illegal member formula |
| OTLAPI_ERR_MEMBERTYPE_OFF | Cannot turn off the member type enabled setting of an outline |
| OTLAPI_ERR_MBRCOMMENTEXLEN | Extended member comment is too long |
| OTLAPI_ERR_MISSINGTEXT_SMARTLIST_IMPORTFILE | Missing text for ID in text list import file |
| OTLAPI_ERR_MULT_DATE_DIMS | An outline can have at most one dimension with date types on static members |
| OTLAPI_ERR_MULTIHIER_NOT_ENABLED | Cannot set hierarchy type; multiple hierarchies not enabled for dimension |
| OTLAPI_ERR_MULT_SMARTLIST_DIMS | An outline can have at most one dimension with smartlists on static members |
| OTLAPI_ERR_MUSTSAVE_BEFORE_EDIT | The outline must be saved and re-opened before it can be edited |
| OTLAPI_ERR_NOALIAS | No alias for this member |
| OTLAPI_ERR_NOALIASCODE | Get/Set alias table language code is not yet implemented |
| OTLAPI_ERR_NOALIASCOMBO | No alias combination |
| OTLAPI_ERR_NOATTRONCOMPRESSEDDIM | Attributes are not allowed on the compressed dimension |
| OTLAPI_ERR_NOFORMULA | No formula for this member |
| OUTAPI_ERR_NOMEMBTYPE | This outline version does not support typed members |
| OTLAPI_ERR_NOSHAREPROTO | Shared member with no actual member |
| OUTAPI_ERR_NOSMARTLISTS | This outline version does not support text lists |
| OTLAPI_ERR_NOTADIM | Dimension name expected |
| OTLAPI_ERR_NOT_A_TIME_MBR | Invalid argument passed. Not a date-time dimension member |
| OTLAPI_ERR_NOT_LINKEDATTRIBUTEDIM | Not a linked attribute dimension handle |
| OTLAPI_ERR_NOT_MEMBTYPE_ENABLED | This outline is not member type enabled |
| OTLAPI_ERR_NOTIMEDIM | No time dimension defined (can't do time balance operations without a time dimension) |
| OTLAPI_ERR_NOTVERIFIED | Outline has errors (when saving to the server) |
| OTLAPI_ERR_OBJ_NOTFOUND | Object not found |
| OTLAPI_ERR_OBJTYPE_NOTSUPPORTED | Function not supported in server side edit mode |
| OTLAPI_ERR_OPENMODE | File was opened in the wrong mode to make this call. If you call EssOtlOpenOutlineQuery() to open the outline, not all of the calls will work. |
| OTLAPI_ERR_OTLDATEFORMAT | Invalid outline property: date format |
| OTLAPI_ERR_OTLSHARED_FORMAT | Outline member's format string cannot be set for shared members |
| OTLAPI_ERR_OTLSHARED_TYPE | Outline member's type cannot be set for shared members |
| OTLAPI_ERR_QUERYHINT_INVALIDARRAYSIZE | Invalid query hint array size |
| OTLAPI_ERR_RENAMEDEFALIAS | Cannot rename the default alias table |
| OTLAPI_ERR_RENAMENAMEUSED | Member name already used (rename operation) |
| OTLAPI_ERR_SCA_NOT_ENABLED | This outline is not enabled for varying attributes |
| OTLAPI_ERR_SCA_UNAVAILABLE | Varying attributes feature is unavailable in this version |
| OTLAPI_ERR_SHAREDMEMBERFORMULA | Shared member cannot have a formula |
| OTLAPI_ERR_SHARENOTLEVEL0 | Shared member not at level 0 (a shared member cannot be a parent of another member) |
| OTLAPI_ERR_SHAREUDA | Cannot set a user attribute for a shared member |
| OTLAPI_ERR_SMARTLISTNAMEUSED | Cannot add text list; text list name already used |
| OTLAPI_ERR_SMARTLIST_MAPMAXREACHED | Cannot add more than n text list texts to id mappings |
| OTLAPI_ERR_SMARTLISTMAXREACHED | Cannot add text list; n maximum text lists supported |
| OTLAPI_ERR_SMARTLIST_MISSING | Missing text list association for text-typed member |
| OTLAPI_ERR_TBTAGS_WITH_DYN_HIERARCHY | This member has a TB-Tag. That requires TIME dimension to only have STORED hierarchies |
| OTLAPI_ERR_TIMESPARSE | Accounts dimension is dense and time dimension sparse-is not used |
| OTLAPI_ERR_TYPED_ATTR_LEVEL0 | Attribute members and non level-0 aggregate storage members cannot be set to Date or Text type |
| OTLAPI_ERR_TYPED_DIMS | Text typed members, date typed members, and stored members with format strings should be specified along the same dimension |
| OTLAPI_ERR_UNKNOWNDTSMBR | Unknown DTS member |
| OTLAPI_ERR_VALIDITYSET_MATCH | The validity set must match an existing set in the outline |
| OTLAPI_ERR_VIRTLEV0NOFORMULA | Dynamic Calc members must have formulas or children, or else they cannot be calculated |
| OTLAPI_ERR_VIRTBADPARENT | When a single child member is Dynamic Calc or Dynamic Calc and Store, the parent must also be Dynamic Calc or Dynamic Calc and Store |
| OTLAPI_ERR_VIRTTOOMANYCHILDREN | Dynamic Calc member has more than 100 children |
| OTLAPI_FAILED_ASSIGN_DEFAULTGENNAMES | Failed to set time related generation names for the date-time dimension created |
| OTLAPI_ILLEGAL_SCA_TYPE_2 | Varying attribute outlines do not allow duplicate names, and cannot be a currency outline |
| OTLAPI_INVALID_ARG | Invalid argument passed to ESSOTL function |
| OTLAPI_INVALID_QUERYID | Invalid query id argument passed |
| OTLAPI_INVALID_QUERY_OPTIONS | Invalid query options passed. Will be ignored |
| OTLAPI_NO_GENLEVELNAME | Cannot find generation or level name |
| OTLAPI_NO_USERATTR | Cannot find user attribute |
| OTLAPI_NULL_ARG | NULL argument passed to EssOtl... function |
| OTLAPI_OUTLINE_TOO_NEW | Outline is of a newer version than this program can understand |
| OTLAPI_SORT_TOOMANY | Too many members to sort (64K / 4 members is the maximum sorting capacity) |
| OTLAPI_SMARTLIST_ASSOC_EXISTS | Cannot delete a text list with existing associations |
| OTLAPI_SMARTLIST_DUP_IDORNAME | Duplicate text list element ID or name |
| OTLAPI_SMARTLIST_INVALID_TEXT | Invalid text list text |
| OTLAPI_WRONG_INDEPDIM_NM | The number of independent dimensions given in perspective does not match the outline |