내용 목차
본 장에서는 에러처리 방법과 디버그 방법에 대해서 설명한다.
Tmax의 API는 에러가 발생하는 경우 상황에 따른 적절한 에러 번호를 설정한다. 에러 메시지를 참고하면 에러에 대한 원인 규명에 많은 도움이 된다. 이외에 API 내부 시스템 콜 레벨의 에러 정보가 알고 싶다면 tuxinc/Uunix.h에 정의되어 있는 에러 메시지와 API들을 참고한다.
Tmax에서는 애플리케이션 레벨이 아닌 Tmax 시스템 운영 상에 발생하는 문제를 도출하는 데 도움을 주기 위해 운영 상의 여러 가지 정보를 콘솔에 보여주는 디버깅용 CLH를 제공하므로 참고한다.
Tmax 운영 중에 발생하는 에러 메시지는 "Tmax Error Message Reference"를 참고한다.
Tmax API가 실패하는 경우의 반환값은 API마다 다르며 전역변수 tperrno에는 에러 상황에 대한 에러 번호가 설정된다.
서버와 클라이언트에서 사용되는 함수로, 에러 번호에 해당하는 메시지를 출력한다. Tmax 함수 이용 중 에러가 발생할 경우 해당 에러 코드는 tperrno라는 전역변수에 설정된다. tpstrerror() 함수는 tperrno에 설정된 에러에 대한 메시지를 출력하는 함수이다.
프로토타입
# include <atmi.h> char *tpstrerror (int tperrno)
파라미터
| 파라미터 | 설명 |
|---|---|
| tperrno | 에러 메시지를 출력하고자 하는 에러 코드이다. |
반환값
| 반환값 | 설명 |
|---|---|
| 에러 메시지 | 에러 코드에 대한 메시지가 있는 경우이다. |
| NULL | 에러 코드에 대한 메시지가 없는 경우이다. |
예제
#include <stdio.h>
#include <usrinc/atmi.h>
void main(int argc, char *argv[])
{
int ret;
char buf;
TPSTART_T *tpinfo;
tpinfo = (TPSTART_T *)tpalloc(“TPSTART”, NULL, sizeof(TPSTART_T));
if (tpinfo==NULL) { error processing }
strcpy(tpinfo->dompwd, “tuxedo”);
if (tpstart(tpinfo) == -1){
printf(“tpstart fail , err = %s\n”, tpstrerror(tperrno));
exit(1);
}
buf = (char *)tpalloc(“CARRAY”, NULL, 20);
if (buf==NULL) {error processing };
data process....
tpfree((char *) buf);
tpend();
}
Tmax API는 많은 시스템 호출을 사용한다. 운영체제나 플랫폼 상에 문제가 있어서 특정 시스템 호출에서 에러가 발생하는 경우 이를 확인하고 싶을 경우나 에러 메시지가 다른 이종 플랫폼으로 포팅하고자 하는 경우 에러 메시지를 통합하여 관리하고 싶을 때 아래에 소개하는 API를 사용하면 도움이 된다. 헤더 파일의 위치는 다음과 같다.
TMAXDIR/tuxinc/Uunix.h
ATMI API 호출이 실패하고 tperrno가 TPEOS로 설정된 경우 시스템 에러의 종류를 stderr로 출력하는 함수이다.
프로토타입
# include <Uunix.h> void Uunix_err (char *msg)
파라미터
| 파라미터 | 설명 |
|---|---|
| msg | 에러가 발생한 시스템 호출에 앞서 추가하고 싶은 메시지이다. 일반적으로 프로그램명을 기록한다. 다음 중에 하나가 출력된다. UCLOSE, UCREAT, UEXEC, UFCTNL, UFORK, ULSEEK, UMSGCTL, UMSGGET, UMSGSND, UMSGRCV, UOPEN, UPLOCK, UREAD, USEMCTL, USEMGET, USEMOP, USHMCTL, USHMGET, USHMAT, USHMDT, USTAT, UWRITE, USBRK, USYSMUL, UWAIT, UKILL, UTIME, UMKDIR, ULINK, UUNLINK, UUNAME, UNLIST |
예제
ret=tmaxreadenv("NO THAT FILE", "TMAX");
if (ret<0) {
Uunix_err("myprog");
exit(1);
}
다음은 앞의 예제를 수행한 결과이다.
mypog: UOPEN
시스템 에러 코드(errno)에 대한 통합 에러 메시지를 반환하는 함수이다.
프로토타입
# include <Uunix.h> char * Ustrerror(int err);
파라미터
| 파라미터 | 설명 |
|---|---|
| err | 알고 싶은 에러 메시지의 통합 에러 번호이다. |
반환값
함수 호출에 성공하는 경우 errno에 대한 통합 에러 메시지의 포인터 주소가 반환된다.
다음 목록 중 하나가 chr * 타입 포인터로 반환된다.
UCLOSE, UCREAT, UEXEC, UFCTNL, UFORK, ULSEEK, UMSGCTL, UMSGGET, UMSGSND, UMSGRCV, UOPEN, UPLOCK, UREAD, USEMCTL, USEMGET, USEMOP, USHMCTL, USHMGET, USHMAT, USHMDT, USTAT, UWRITE, USBRK, USYSMUL, UWAIT, UKILL, UTIME, UMKDIR, ULINK, UUNLINK, UUNAME, UNLIST
예제
ret=tmaxreadenv("NO THAT FILE", "TMAX");
if (ret<0)
{
printf("%d->%s\n", Uunixerr, Ustrerror(Uunixerr));
exit(1);
}
다음은 앞의 예제를 수행한 결과이다.
11->UOPEN
TMAXDIR/bin 디렉터리에 위치한 clh.dbg라는 파일을 clh로 이름을 변경하여 사용하면 CLH에서 이루어지는 모든 메시지 전달의 내용을 확인할 수 있다. 반드시 원본 clh를 백업해둔다.
/home/navis/tmax/bin> tmboot
TMBOOT for node(aix5l) is starting:
Welcome to Tmax demo system: it will expire 2002/9/15
Today: 2002/7/16
TMBOOT: TMM is starting: Tue Jul 16 22:39:13 2002
TMBOOT: CLL is starting: Tue Jul 16 22:39:13 2002
TMBOOT: CLH is starting: Tue Jul 16 22:39:13 2002
COM: waiting for TMM reply
LIB: read 96 bytes
(I) CLH Current Tmax Configuration:
Number of client handler(MINCLH) = 1
Supported maximum user per node = 3944
Supported maximum user per handler = 3944
LIB: read 96 bytes
CLH: bootpid = 31202
TMBOOT: SVR(sub) is starting: Tue Jul 16 22:39:13 2002
TMBOOT: SVR(svr2) is starting: Tue Jul 16 22:39:13 2002
CLH: request_from_server: clh = 0, ind = 0, fd = 8
CLH: msg from server: msgtype = 101, svcname = , len = 0
CLH: register_from_server, spri = 32, svri = 0, maxtms = 32
CLH: reply_to_server: clh = 0, ind = 32, fd =8
CLH: msg to server: msgtype = 1101, svcname = , len = 0
CLH: request_from_server: clh = 0, ind = 0, fd = 9
CLH: msg from server: msgtype = 135, svcname = , len = 0
.....
TMAXDIR/lib 디렉터리에 libsvrd.a / libsvrd.so라는 라이브러리가 존재한다. libsvr.a / libsvr.so 대신에 이들 라이브러리를 사용하면 콘솔 화면을 통해 여러 가지 데이터 값이 출력되므로 서버 라이브러리에서 발생하는 흐름을 파악할 수 있고 에러가 발생하는 시점을 찾는 데도 편리하다. libsvrd.a의 경우는 재컴파일을 필요로 하고, libsvrd.so의 경우에는 이름만 변경하면 된다.
/oracle/navis/tmax385/lib> tmboot TMBOOT for node(tmaxc1) is starting: Welcome to Tmax demo system: it will expire 2002/9/30 ........ GETOPT1: -b 255859 GETOPT1: -s svr2 GETOPT1: -d -1 SVR: delay = -1, _use_lock = 1 COM: waiting for TMM reply LIB: read 96 bytes register_to_tmm success init_shm(78990, 139364) success init_svctab success SVR: my info--1 32 0 0 -3 init_clh success LIB: read 96 bytes register_to_clh success init_txinfo success check_node success _tmax_init = 1 GETOPT1: -b 255859 GETOPT1: -s fdltest GETOPT1: -d -1 SVR: delay = -1, _use_lock = 1 COM: waiting for TMM reply LIB: read 96 bytes register_to_tmm success ......