Error Codes

This appendix describes TCache error codes and how to handle them.

  • ERR_VER(-1)

    Description

    TCache memory version does not match TCache binary version.

    Action

    Recreate TCache memory.

  • ERR_UNAVAILABLE(-2)

    Description

    It fails to create or remove TCache memory.

    Action

    It will be resolved automatically after some time. If the same situation is maintained for a long time, recreate TCache memory because there is an issue in the memory.

  • ERR_NOACCESS(-3)

    Description

    TCache memory is not available because "pfmtcacheadmin -t" is executed.

    Action

    Execute "pfmtcacheadmin -t" again to make TCache memory available.

    To check TCache memory status, use the following command.

    $ pfmtcacheadmin -s | grep status

    • status = AVAILABLE (normal)

    • status = NO ACCESS (unavailable)

  • ERR_NOTFOUND(-101)

    Description

    The data does not exist in TCache.

    Action

    Check whether there is an actual key value.

  • ERR_SHM(-102)

    Description

    There is a shared memory handling issue (create, attach, remove, detach, etc.).

    Action

    Recreate TCache memory.

  • ERR_LOCK(-103)

    Description

    It fails to get a lock due to an abnormal reason.

    Action

    Recreate TCache memory.

  • ERR_WRONG_INPUT(-104)

    Description

    Invalid CacheName is used, or data that is smaller than SIZE_KEY is used.

    Action

    Check and modify the input value.

  • ERR_OUTOFMEM(-105)

    Description

    TCache memory is insufficient to use pfmTCachePut.

    Action

    It will be resolved automatically after some time. If the same situation occurs repeatedly in a specific CacheName, increase the SIZE_MEM value in the cache settings.

  • ERR_NOCONFIG(-106)

    Description

    The TCACHECONF environment variable is not set, or TCache configuration file has an issue.

    Action

    • Check whether the environment variable and the configuration file exist.

    • Check whether the file status is normal.

    • Check the read permission.

    • Check whether the file can open with vi.

  • ERR_PARSE_CONF(-107)

    Description

    It fails to read or set TCache configuration.

    Action

    • Check whether required items are set appropriately in the configuration file.

    • Check whether the number of caches exceeds 128.

  • ERR_INV(-108)

    Description

    The item is currently being invalidated.

    Action

    It is resolved after the amount of time as long as the INV_TIMEOUT value set in TCache environment configuration elapses. INV_TIMEOUT is set in seconds.

  • ERR_SYS(-109)

    Description

    An OS-related or a TP-related error occurs.

    Action

    • Check system status.

    • If this error occurs while executing pfmTCacheInvalidate, check TP settings. Check whether SPFMAGENT is set appropriately.

  • ERR_INTERNAL(-111)

    Description

    Internal error that occurs when pfmTCacheReplace is executed.

    Action

    Recreate the memory. Request support from TmaxSoft if this error occurs repeatedly even after recreating the memory.

  • ERR_BUSY(-112)

    Description

    It fails to get a lock due to a normal lock waiting status.

    Action

    It will be resolved automatically after some time. If the same situation is maintained for a long time, recreate TCache memory because there is an issue in the memory.

  • ERR_OFFSET(-114)

    Description

    When executing pfmTCacheReplace, the offset_data value is larger than actual data.

    Action

    Check the data size from the application.

  • ERR_ARG(-115)

    Description

    An invalid argument is used when TCache API is executed.

    Action

    Check the application code. Check whether CacheName, key, data pointer, and other items are not null or their sizes are positive.