에러 코드
본 장에서는 TCache 에러 코드 대한 내역 및 대처 방안에 대해 설명한다.
ERR_VER(-1)
설명 |
TCache 메모리 버전과 TCache 바이너리 버전이 불일치하는 경우 발생하는 오류이다. |
대응 방법 |
TCache 메모리를 재생성한다. |
ERR_UNAVAILABLE(-2)
설명 |
TCache 메모리를 Create 또는 Remove 작업하는 중 발생하는 오류이다. |
대응 방법 |
약간의 시간이 지나면 자동으로 해결된다. 동일 상황이 장시간 유지되고 있으면, TCache 메모리에 문제가 생긴 것이므로 재생성한다. |
ERR_NOACCESS(-3)
설명 |
"pfmtcacheadmin -t"를 사용하여, TCache 메모리를 사용 불가로 만든 상태에서 발생하는 오류이다. |
대응 방법 |
다시 pfmtcacheadmin -t를 사용하여 사용 가능 상태로 만들어 준다. 다음 명령을 사용하여 TCache 메모리 상태를 확인할 수 있다. $ pfmtcacheadmin -s | grep status
|
ERR_NOTFOUND(-101)
설명 |
TCache에 해당 데이터 존재하지 않는 경우 발생하는 오류이다. |
대응 방법 |
실제 Key 값에 데이터가 없다. |
ERR_SHM(-102)
설명 |
Shared Memory 핸들링 상의 문제가 발생한 경우이다. (create, attach, remove, detach 등등) |
대응 방법 |
TCache 메모리를 재생성한다. |
ERR_LOCK(-103)
설명 |
Lock 획득에 실패한 경우(비정상적인 원인으로 실패)에 발생하는 오류이다. |
대응 방법 |
TCache 메모리를 재생성한다. |
ERR_WRONG_INPUT(-104)
설명 |
잘못된 CacheName을 사용하거나, SIZE_KEY보다 작은 크기의 데이터를 사용할 때 발생하는 오류이다. |
대응 방법 |
입력값을 확인하거나 수정한다. |
ERR_OUTOFMEM(-105)
설명 |
pfmTCachePut를 수행할 때 TCache 메모리 부족으로 인해 발생하는 오류이다. |
대응 방법 |
약간의 시간이 지나면 자동으로 해결된다. 만약 특정 CacheName에서 계속 발생하는 경우 해당 캐시 설정의 SIZE_MEM 값을 늘린다. |
ERR_NOCONFIG(-106)
설명 |
TCACHECONF 환경변수가 설정되지 않았거나, TCache 환경설정 파일에 문제가 있는 경우 발생하는 오류이다. |
대응 방법 |
|
ERR_PARSE_CONF(-107)
설명 |
TCache 환경설정을 읽기 또는 처리 실패한 경우 발생하는 오류이다. |
대응 방법 |
|
ERR_INV(-108)
설명 |
현재 해당 Item이 Invalidate 처리 중인 경우 발생하는 오류이다. |
대응 방법 |
TCache 환경설정에 설정한 INV_TIMEOUT 값만큼의 시간이 흐르면 풀린다. INV_TIMEOUT의 단위는 초이다. |
ERR_SYS(-109)
설명 |
OS 또는 TP 관련 오류가 발생한 경우이다. |
대응 방법 |
|
ERR_INTERNAL(-111)
설명 |
pfmTCacheReplace를 수행할 때 발생하는 내부적인 오류이다. |
대응 방법 |
메모리 재생성 후에도 동일한 상황이 반복되는지 확인 후 지원 요청한다. |
ERR_BUSY(-112)
설명 |
Lock 획득에 실패한 경우(정상적인 LockWait 상황) 발생하는 오류이다. |
대응 방법 |
약간의 시간이 지나면 자동으로 해결된다. 만약 동일한 상황이 장시간 유지되면, TCache 메모리에 문제가 생긴 것이므로 재생성한다. |
ERR_OFFSET(-114)
설명 |
pfmTCacheReplace를 수행할 때 offset_data 값이 실제 데이터보다 클 경우 발생하는 오류이다. |
대응 방법 |
AP에서 데이터 크기를 확인한다. |
ERR_ARG(-115)
설명 |
TCache API를 수행할 때 Invalid argument를 사용한 경우 발생하는 오류이다. |
대응 방법 |
AP 코드를 확인한다. cacheName, key, data 포인터 등이 NULL인지 size가 양수가 아닌지 확인한다. |