개요

Tmax 시스템을 사용하기 위해서 제공하는 명령어와 함수를 사용해야 한다.

1. 명령어

다음은 Tmax에서 제공되는 명령어의 목록이다.

명령어 설명

cfl

텍스트 형태의 Tmax 환경 파일을 컴파일하여 tmconfig(이진 Tmax 환경 파일)을 생성한다.

fdlc

필드 키 테이블을 컴파일한다.

gst

이진 Tmax 환경 파일을 참조하여 서비스 테이블을 생성한다.

hkcfl

텍스트 형태의 Host-link 환경설정 파일을 컴파일하여 이진 Host-link 환경설정 파일(hlinkcfg)을 생성한다.

idlc

RPC 모듈의 정의 파일을 실제 프로그래밍 가능한 소스로 변환해 준다.

mkcli

Tmax 클라이언트 모듈을 생성한다.

mkacl

ACL(Access Control List)를 생성한다.

mkgrp

사용자 그룹을 생성한다.

mkpw

암호를 관리한다.

mksvr

Tmax 서버 모듈을 생성한다.

racd

멀티 노드로 분산된 환경에서 중앙 집중 관리한다.

racdr

멀티 노드, 멀티 도메인으로 분산된 환경에서 파일 복사, 기동을 수행한다.

rcakill

RCA를 종료하려는 경우 RCA가 사용하는 자원을 제거하기 위하여 사용한다.

rcastat

RCA의 설정 내용을 확인하거나 RCA에 접속한 클라이언트의 수 등을 모니터링 할 때 사용한다.

sdlc

구조체를 정의한 파일을 컴파일한다.

svcrpt

Tmax 시스템을 운용할 때 서비스 수행에 관련된 로그 기록을 분석하여 출력한다.

tdlclean

run 디렉터리의 구버전 라이브러리 파일이나 불필요한 파일을 정리한다.

tdlinit

TDL 공유 메모리 및 동적 모듈 초기화를 수행한다.

tdlnm

지정한 라이브러리에 대한 자동 export될 함수 목록을 조회한다.

tdlrm

TDL을 더 이상 사용하지 않을 경우에 공유 메모리를 완전히 제거한다.

tdlseqno

TDL의 시퀀스 번호를 조회한다.

tdlshm

TDL 공유 메모리 정보를 조회하거나, 통계 모니터링 활성화 여부 및 모듈 활성화 여부를 설정한다.

tdlsync

TDL 공유 메모리와 백업 파일 동기화를 수행한다.

tdltrace

TDL의 환경 정보와 통계 정보를 조회한다.

tdlupdate

지정한 동적 모듈을 업데이트한다.

tencrypt

환경설정의 OPENINFO절을 암호화한다.

tmadmin

Tmax 시스템 관리를 한다.

tmapm

시그알람을 사용할 수 없거나, 용이하지 않은 경우 서비스 타임아웃을 설정하고 사용할 수 있는 별도의 서버이다.

tmaxlibver

Tmax 라이브러리의 버전 정보를 조회한다.

tmaxtrace

애플리케이션에 대하여 Run time tracing을 한다.

tmboot

Tmax 시스템의 전체나 또는 일부분을 실행한다.

tmd

서버 프로그램을 테스트하기 위한 클라이언트 시뮬레이션을 한다.

tmdown

Tmax 시스템 전체 또는 일부분을 종료한다.

tmmbfgen

서비스 정보 파일(text)을 서비스 정보 바이너리 파일로 만든다.

tmsnmpd

표준 SNMP 프로토콜에 의해서 Tmax 구성 및 성능 정보를 조회한다.

tperr

Tmax 에러 번호와 에러 타입을 이용하여 에러에 관한 자세한 정보를 조회한다.

twagent

Tmax 웹 Agent와 연결하는 데몬 프로세스 기동을 위한 명령어이다.

uncfl

텍스트 형태의 Tmax 환경 파일을 컴파일하여 생성된 tmconfig를 텍스트 형태의 환경 파일로 만든다.

untmmbfgen

서비스 정보 바이너리 파일을 서비스 정보 파일(text)로 변환한다.

xwsdlgen

웹 서비스 스펙 중 명세서 역할을 하는 WSDL 문서를 생성한다.

2. 함수

다음은 각 용도별 사용되는 함수에 대한 설명이다.

2.1. 서버/클라이언트 함수

함수 설명

gettperrno

Tmax 시스템을 호출할 때 설정된 에러 코드(errno)를 반환한다.

tgstrerror

TmaxGrid API 사용할 때 발생하는 tgerrno에 해당하는 번호의 메시지를 출력한다.

tmax_chk_conn

클라이언트의 연결 상태를 체크하는 함수로 tpstart 수행 여부 체크, 소켓 상태 점검, 메시지 전달로서 연결 상태를 점검하는 역할을 한다.

tmax_get_sessionid

현 세션의 ID를 반환한다.

tmax_gq_count

GQ에 저장된 데이터의 개수를 반환한다.

tmax_gq_get

GQ에서 데이터를 가져오는 함수로 키를 지정하면 해당 키의 데이터를 가져온다.

tmax_gq_getkeylist

GQ의 키 리스트를 가져온다.

tmax_gq_keygen

시스템 키를 생성하고 가져온다.

tmax_gq_purge

GQ의 데이터를 삭제한다.

tmax_gq_put

데이터를 GQ에 저장하는 함수로 키와 데이터 값을 전달한다.

tmax_grid_count

전체 Key 개수를 참조한다.

tmax_grid_create

Key를 생성한다.

tmax_grid_create2

Key를 생성하고 Key에 value를 설정한다.

tmax_grid_dequeue

tmax_grid_enqueue()에 의해서 입력한 Value 중 가장 처음에 입력한 Value를 참조한다.

tmax_grid_destroy

Key를 삭제한다.

tmax_grid_enqueue

Key 이름으로 데이터를 입력한다.

tmax_grid_get

value를 가져오고 해당 Key의 Value는 삭제한다.

tmax_grid_get_child_with_index

자식 Key의 정보를 담고 있는 grid_KEYLIST_T 핸들러에서 nth번째의 Key에 대한 정보를 grid_KEYINFO_T 구조체에 저장한다.

tmax_grid_get_children

Key 이름으로 자식 Key 이름의 리스트를 참조한다.

tmax_grid_is_exist

Key가 존재하는지 검사한다.

tmax_grid_keylist_free

자식 Key의 정보를 담고 있는 grid_KEYLIST_T 핸들러의 자원을 해제한다.

tmax_grid_lock

Key 이름으로 Lock을 수행한다.

tmax_grid_set

Key에 value를 설정한다.

tmax_grid_unlock

Key 이름으로 Lock을 해제한다.

tmax_grid_set_watcher

해당 Key의 이벤트 발생할 때 호출하는 함수를 등록한다.

tmax_grid_wait_watcher

이벤트 발생할 때 까지 timeout으로 지정한 시간 동안 대기한다.

tmax_keylist_count

keylist 핸들로부터 키 리스트의 개수를 반환한다.

tmax_keylist_free

keylist 핸들의 메모리나 기타 자원들을 해제한다.

tmax_keylist_getakey

keylist 핸들로부터 n번째 키 정보를 가져온다.

tmax_sq_count

현재 SQ에 저장된 데이터 개수를 반환한다.

tmax_sq_get

데이터를 세션 큐에 저장한다.

tmax_sq_getkeylist

현 세션 SQ의 키 리스트를 가져온다.

tmax_sq_keygen

시스템 키를 생성하고 가져온다.

tmax_sq_purge

SQ의 데이터를 삭제한다.

tmax_sq_put

서버 데이터를 세션 큐에 저장한다.

tmaxlastsvc

가장 마지막에 수행된 조회하는 함수로 에러가 발생한 서비스명 또는 최후로 루틴을 수행한 서비스명을 반환한다.

tmaxreadenv

환경변수를 파일에서 접속할 시스템의 정보를 읽어서 환경변수에 새로운 값을 설정한다.

tp_sleep

데이터의 도착을 초 단위로 기다린다.

tp_usleep

데이터의 도착을 1000000(백만)분의 1초 단위로 기다린다.

tpabort

전역 트랜잭션을 rollback한다.

tpacall

비동기 서비스 요청을 송신한다.

tpacallsvg

COUSIN으로 묶인 멀티 서버 그룹 환경에서 특정 서버 그룹에 속하는 서비스에 비동기형 통신으로 서비스 요청을 송신한다.

tpalivechk

클라이언트의 연결 상태를 체크하는 함수로 소켓의 상태를 점검하는 역할을 한다.

tpalloc

유형 버퍼(typed buffer)를 할당한다.

tpbegin

트랜잭션 시간 설정 및 전역 트랜잭션을 시작한다.

tpbroadcast

Tmax 시스템에 등록된 클라이언트들에게 요청하지 않은 메시지를 송신한다.

tpcall

동기형 서비스 요청을 송수신한다.

tpcallsvg

특정 서버 그룹에 속하는 서비스를 서버와 클라이언트에서 호출한다.

tpcancel

응답을 취소한다.

tpcommit

전역 트랜잭션을 commit한다.

tpconnect

프로그램이 대화형 서비스 svc와 통신을 연결한다.

tpdeq

RQ로부터 데이터를 로드한다.

tpdeq_ctl

트랜잭션을 지원하며 RQ로부터 데이터를 로드한다.

tpdiscon

대화형 통신의 연결을 종료한다.

tpenq

RQ에 데이터를 저장한다.

tpenq_ctl

트랜잭션을 지원하며 RQ 데이터를 저장한다.

tperrordetail

서버와 클라이언트에서 Tmax 시스템 호출할 때 발생한 오류의 자세한 정보를 얻을 때 사용한다.

tpextsvcinfo

tpdeq()로 RQ에서 데이터를 읽은 경우 해당 데이터에 대한 상세한 정보를 제공한다.

tpextsvcname

RQ에 저장된 데이터 중 서비스명을 출력한다.

tpfree

유형 버퍼(typed buffer)에 할당된 메모리를 해제한다.

tpget_timeout

블록 타임아웃 시간을 반환한다.

tpgetactivesvr

현재 활성화되어 있는 서버들의 목록을 조회한다.

tpgetcliaddr

Tmax 시스템에 접속된 클라이언트 중 clid에 해당하는 클라이언트의 IP와 포트 번호를 얻는 함수이다.

tpgetcliaddr_ipv6

Tmax 시스템에 접속된 클라이언트 중 clid에 해당하는 클라이언트의 IP와 포트 번호를 얻는 함수로 IPv6 환경에서 사용한다.

tpgetclid

Tmax 시스템에 접속된 클라이언트의 번호를 알 수 있는 함수이다.

tpgetcliinfo

Tmax 시스템에 접속된 클라이언트 중 clid에 해당하는 클라이언트의 정보를 얻어 온다.

tpgetctxt

현재 컨텍스트를 반환한다.

tpgetenv

name이라는 이름으로 등록된 환경변수의 값을 반환한다.

tpgetlev

트랜잭션 모드에 있는지의 여부를 확인한다.

tpgetnodelist

현재 접속된 Tmax 시스템의 노드의 목록을 가져온다.

tpgetpeername

연결된 상대방의 소켓 주소를 얻어온다.

tpgetrcahseqno

tpgetsvrseqno API와 동일하게 RCAH 프로세스 번호를 반환한다.

tpgetrcainfo

RCAH의 Thread 정보를 알려준다.

tpgetrply

비동기적으로 요청한 서비스에 대한 응답을 수신한다.

tpgetsockname

Tmax 시스템 내부적으로 사용되는 소켓 주소를 얻는다.

tpgetsprlist

서버 프로세스 단위로 호출을 하기 위하여 해당 서비스가 속한 서버 프로세스의 인덱스를 가져오는 함수이다.

tpgetsvglist

해당 서비스가 속하는 서버 그룹과 이 서버 그룹의 COUSIN으로 설정된 서버 그룹들에 대한 정보를 제공한다.

tpgetsvglist_bynode

지정한 서비스를 제공하는 서버그룹 중에 지정한 노드명에 해당하는 서버그룹 목록을 가져온다.

tpgprio

요청받은 서비스의 우선순위를 보여주는 함수이다.

tpmcall

COUSIN으로 묶인 모든 서버 그룹 서버의 서비스를 호출한다.

tpmcallx

기존 tpmcall()의 확장 기능 제공을 목적으로 하는 함수로 기존과 달리 COUSIN 서버 그룹의 서비스들로부터 모두 응답을 받을 때까지 기다리는 함수이다.

tpnotify

서버에서 지정된 클라이언트에 비요청 메시지를 송신한다.

tppost

특정 사건을 발생시키고 메시지를 전달한다.

tpputenv

환경변수 값을 재설정한다.

tpqstat

RQ에 저장된 데이터의 통계를 요청한다.

tpqsvcstat

RQ에 저장된 데이터 중 지정한 서비스에 대한 통계를 요청하는 함수로 현재 RQ에 쌓여 있는 데이터의 통계를 구한다.

tprealloc

RQ에 저장된 데이터 건수를 조회한다.

tprecv

대화형 통신을 하는 경우 메시지를 수신한다.

tprecvfromcli

서버에서 클라이언트로 메시지를 요청하고 받는 함수이다.

tpreissue

해당 RQ의 Fail 큐에 쌓인 요청 데이터를 다시 Request 큐에 넣어주는 함수이다.

tpremoteconnect

리모트와 TCP로 연결하는 함수이다.

tpscmt

commit 방법을 재설정한다.

tpsend

대화형 통신에서 메시지를 송신한다.

tpset_timeout

블록 타임아웃 시간을 설정한다.

tpsetctxt

현재 컨텍스트를 설정한다.

tpsetfd

소켓 FD를 UCS 프로세스의 스케줄러에 등록한다.

tpsetsvctimeout

서버에서 사용되는 함수로 서버에 설정되어 있는 서비스 타임아웃 시간을 설정한다.

tpsleep

데이터가 도착할 때까지 대기한다.

tpspracall

tpgetsprlist()를 통해 얻어온 서버 프로세스의 인덱스 중 특정 프로세스에게 서비스를 호출한다.

tpspracall2

DYN 서버 타입용 함수로 tpgetsprlist() 를 통해 얻어온 starti로부터 spri 순번을 지정하여 해당 서버 프로세스에게 서비스를 호출한다.

tpsprio

서비스 요청의 우선순위를 설정한다.

tpstrerror

에러 번호에 해당하는 메시지를 출력한다.

tpsubqname

서브 큐 번호에 해당하는 큐의 이름을 반환한다.

tpsubscribe

특정 사건의 메시지에 대한 요청을 등록한다.

tptypes

버퍼의 유형 및 하위 유형에 대한 정보를 조회한다.

tpunsubscribe

특정 사건의 메시지에 대한 등록을 해제한다.

tuxgetenv

환경변수 값을 반환한다.

tuxputenv

환경변수를 적용한다.

tuxreadenv

파일의 환경변수를 읽어오는 함수이다.

tx_begin

전역 트랜잭션을 시작한다.

tx_commit

전역 트랜잭션을 Commit한다.

tx_info

전역 트랜잭션 정보를 반환한다.

tx_rollback

전역 트랜잭션을 rollback한다.

tx_set_commit_return

commit_return 특성을 설정한다.

tx_set_transaction_control

transaction_control 특성을 control 값으로 설정한다.

tx_set_transaction_timeout

transaction_timeout 특성을 타임아웃 값으로 설정한다.

ulogsync

메모리 버퍼의 ulog를 파일로 저장한다.

userlog

메모리 버퍼에 ulog를 저장한다.

UserLog

ulog를 즉시 파일에 저장한다.

2.2. 서버 함수

이름 설명

_tmax_check_license

AnyLink 및 OpenFrame에서 해당 라이선스가 발급되었는지 체크한다.

_tmax_event_handler

SVRTYPE이 EVT_SVR인 경우 SLOG가 발생하는 경우 호출되는 콜백 함수이다.

_tmax_main

사용자 프로그램에 main()이 포함되어 있는 경우 사용한다.

CliWatcherCallback

UCS 프로세스에서 사용되며 tpsetcliwatcher의 client 종료를 통지받을 콜백함수이다.

tmadmin

Tmax 시스템 관리 툴인 tmadmin에서 조회할 수 있는 통계정보를 출력한다.

tmax_get_db_passwd

현재 Tmax가 접속하고 있는 데이터베이스의 username에 대한 비밀번호를 조회한다.

tmax_get_db_tnsname

현재 Tmax가 접속하고 있는 데이터베이스의 tnsname을 조회한다.

tmax_get_db_usrname

현재 Tmax가 접속하고 있는 데이터베이스의 username을 조회한다.

tmax_get_svccnt

자신이 속한 서버의 서비스 개수를 반환한다.

tmax_get_svclist

자신이 속한 서버의 서비스 목록을 가져오기 위한 함수이다.

tmax_is_restarted

Tmax AP 서버 루틴 내에서 자신이 속한 서버 프로세스가 비정상적으로 종료된 후 재기동되었는지의 여부를 판단할 수 있도록 한다.

tmax_is_xa

현재 자신이 속한 서버가 XA인지 NON-XA인지 체크해 주는 함수이다.

tmax_my_rminfo

자기 자신이 속한 서버 그룹의 OPENINFO 정보를 가져온다.

tmax_my_svrinfo

서버 프로세스의 시스템 설정 정보를 획득한다.

tmgetsmgid

SysMaster trace 기능을 지원하기 위한 함수로 현재 자신의 GID를 얻어온다.

TPADMNTOI

tmadmin으로부터 admntoi 명령으로 들어오는 요청에 대해서 처리한다.

tmget_smtrclog

로깅 데이터를 구조체 버퍼에 저장한다.

tmget_smtrclog_count

데이터의 개수를 반환한다.

tpadvertise

서버 프로세스가 제공하는 서비스를 서버에 advertise한다.

tpcancelctx

서버 라이브러리 내의 CTX_T 구조체의 내용을 삭제한다.

tpchkclid

UCS 프로세스내에서 데이터를 송부하기에 앞서 해당 클라이언트가 정상적으로 접속되어 비요청 데이터를 수신할 수 있는지 판별한다.

tpclrcliwatcher

UCS 프로세스에서 사용되며 tpsetcliwatcher()으로 등록한 clid에 대해서 종료 이벤트 감지를 취소한다.

tpclrfd

UCS 방식 프로세스 내부의 fdset의 소켓 FD를 off시키는 데 사용된다.

tpclrfd_w

UCS 방식 프로세스 내부의 writable fdset의 소켓 FD를 off시키는 데 사용된다.

tpforward

서비스 요청을 또 다른 서비스 루틴으로 전달한다.

tpgetctx

서버 라이브러리 내의 CTX_T 구조체의 값을 사용자 변수에 저장한다.

tpgetdbsessionid

RM 세션 정보를 얻어오는 함수이다.

tpgetfclid

Tmax 시스템에 최소 서비스를 시작시킨 클라이언트 번호를 가져오는 함수이다.

tpgetmaxsvr

서버 프로세스의 최대 실행 개수를 출력한다.

tpgetmaxuser

서버 프로세스가 속한 노드의 최대 동시 접속자 수를 출력한다.

tpgetminsvr

서버 프로세스의 최소 실행 개수를 출력한다.

tpgetmynode

서버에서 특정 노드명과 노드 번호를 얻는 함수이다.

tpgetmysvgno

현재 자신이 속해 있는 서버 그룹의 번호를 알려주는 함수이다.

tpgetmysvrid

서버 프로세스 ID를 출력한다.

tpgetnodename

서버에서 지정된 노드명을 얻는 함수이다.

tpgetnodeno

서버에서 nodename을 가지는 노드의 번호를 얻는 함수이다.

tpgetorgclh

해당 클라이언트가 현재 접속되어 있는 CLH 번호를 알아내는 함수이다.

tpgetorgnode

해당 클라이언트가 접속된 노드 번호(node number)를 반환한다.

tpgetpeer_ipaddr

연결된 상대방의 IP 주소를 출력한다.

tpgetsvcname

서비스 인덱스로부터 서비스명을 가져오는 함수이다.

tpgetsvrseqno

같은 서버 프로세스들 간의 서버 프로세스에 대한 일련번호를 반환한다.

tpissetfd

서버에서 UCS 프로세스에서 소켓 FD로 데이터가 도착했는지를 검사한다.

tpissetfd_w

UCS 방식 서버 프로세스의 FDSET을 검사하여 파라미터 값으로 주어진 소켓 FD에 보낼 데이터가 있는지 확인한다.

tpprechk

RM의 상태 점검을 위한 사용자 콜백 함수로 tpprechk()는 Tmax 시스템 접속 전에 호출된다.

tpregancb

tmadmin 으로부터 admntoi 명령으로 들어오는 요청에 대해서 처리한다.

tpregcb

서버에서 UCS 상에서 비동기형 요청에 대한 응답을 받는 루틴을 설정한다.

tprelay

UCS 서버 프로세스에서 서비스를 요청한 클라이언트의 정보를 담아서 또 다른 서비스를 요청한다.

tpresumetx

현재 중지된 전역 트랜잭션을 재개하는 함수로 중지된 전역 트랜잭션을 tpresumetx(), tpsuspendxt()를 통하여 재개시킬 수 있다.

tpreturn

서버의 서비스를 종료한다.

tpsavectx

UCS 프로세스에서 사용되며 클라이언트의 정보를 내부적으로 관리하도록 한다.

tpschedule

UCS 서버 프로세스에서 데이터의 도착을 기다리는 함수이다.

tpsendtocli

지정된 클라이언트에 비요청 메시지를 송신한다.

tpsetcliwatcher

UCS 프로세스에서 사용되며 clid에 대응하는 클라이언트가 종료될 때 감지한다.

tpsetdbsessionid

RM 세션 정보를 얻기 위한 함수이다.

tpsuspendtx

기존 전역 트랜잭션을 중지하기 위한 함수이다.

tpsvctimeout

서비스 타임아웃이 발생했을 경우 호출한다.

tpsvrdone

Tmax 서버 프로세스 종료 루틴을 호출한다.

tpsvrdown

서버 프로세스를 down한다.

tpsvrinit

Tmax 서버 프로세스를 초기화한다.

tpsvrthrdone

Multithread 및 Multicontext 서버는 서버 프로 세스가 종료될 경우 tpsvrdone 함수를 수행하기에 앞서 서비스 Thread들을 종료시킨다.

tpsvrthrinit

Multithread 및 Multicontext 서버에서 tpsvrinit 함수가 호출된 이후 Thread들을 초기화한다.

tptsleep

TMM으로부터 서버 프로세스 종료 이벤트를 대기한다.

tpunadvertise

서버 프로세스가 제공하는 서비스를 서버에서 등록해제(unadvertise)한다.

tpunregancb

tmadmin으로부터 admntoi 명령으로 들어오는 요청에 대해서 처리하는 콜백 함수를 해제한다.

tpunregcb

서버에서 UCS에서 비동기형 요청에 대한 응답을 받는 루틴을 재설정한다.

tpuschedule

UCS 서버 프로세스에서 데이터 도착을 기다리는 함수이다.

tx_close

리소스 관리자들과의 연결을 종료한다.

tx_open

관련된 리소스 관리자와 연결한다.

2.3. 클라이언트 함수

이름 설명

gettpurcode

urcode 서비스에 설정된 urcode를 클라이언트에 반환한다.

tpchkunsol

함수를 호출할 당시에 서버로부터 비요청 메시지가 있는 경우 해당 메시지를 처리하기 위한 함수를 호출하기 위한 함수이다.

tpend

클라이언트에서 Tmax 시스템과의 연결을 해제한다.

tpgetclid

Tmax에 연결되어 있을 경우 Tmax에서 관리하는 자신의 clid 값을 얻어온다.

tpgethostaddr

Tmax 클라이언트와 Tmax 시스템에 접속여부를 확인하거나, 접속된 Tmax 시스템의 IP와 포트 번호에 대한 정보를 얻고자 할 때 사용한다.

tpgetunsol

클라이언트의 요청없이 일방적으로 전달받은 메시지를 처리한다.

tpinit

Tmax 시스템에 연결한다.

tpreset

현재 접속된 클라이언트 연결을 해제한다.

tpsetunsol

비요청 수신 메시지를 처리하는 루틴을 설정한다.

tpsetunsol_flag

비요청 메시지 수신 flags를 변경한다.

tpstart

Tmax 시스템에 연결한다.

tpterm

Tmax 시스템과의 연결을 해제한다.

tptobackup

Tmax 백업 시스템으로 연결한다.

2.4. TCP/IP 게이트웨이 함수

함수 설명

allow_connection

리모트 노드와 새로운 연결이 맺어지기 전에 호출되는 함수이다. 해당 연결 요청의 허용 여부를 반환값으로 결정할 수 있다.

allow_connection_ipv6

IPv6 프로토콜 환경에서 리모트 노드와 새로운 연결이 맺어지기 전에 호출되는 함수이다. 해당 연결 요청의 허용 여부를 반환값으로 결정할 수 있다.

chk_end_msg

리모트 노드로부터 데이터를 수신할 때 데이터의 끝을 나타내는 특정 문자 또는 비트 스트림이 존재할 경우 사용자가 호출할 수 있는 함수이다.

chk_extpong_msg

채널 장애를 감지할 때 서버로부터 받은 메시지를 확인하는 함수이다.

chk_pong_msg

채널 장애 감시 응답 메시지 여부를 체크하는 사용자 함수이다.

get_channel_num

Tmax 서비스나 클라이언트로부터 요청한 데이터를 리모트 노드에 전송할 때 사용자가 채널을 선택할 수 있도록 하는 함수이다.

get_extmsg_info

get_msg_info와 일부 기능을 제외하고 기본적으로 동일한 기능을 갖는다.

get_msg_info

리모트 노드으로부터 요청이나 응답이 도착하여 데이터를 읽은 후 TCPGW 라이브러리와 custom.c와의 인터페이스 역할을 하는 info를 참조 또는 가공하는 함수이다.

get_msg_length

리모트 노드로부터 요청이나 응답이 도착하는 경우 호출하는 함수로 반환된 값만큼, 실 데이터를 다시 read하는 함수이다.

get_msg_security

get_msg_info 호출된 이후에 데이터를 가공할 수 있는 함수이다.

get_service_name

tpreply()나 tpacall()을 할 서비스명의 오류 코드에 따라서 설정하는 함수이다.

init_remote_info

리모트 노드와 연결을 맺기에 전에 호출되는 함수이다.

inmsg_recovery

리모트 노드로부터의 요청을 처리했을 때 오류가 발생하는 경우 호출하는 함수이다.

outmsg_recovery

리모트 노드로 요청을 보낼 때 오류가 발생할 경우 호출된다.

prepare_shutdown

TCPGW가 종료하기 직전에 call되는 함수이다.

put_extmsg_info

put_msg_info와 일부 기능을 제외하고 기본적으로 동일한 기능을 갖는다.

put_msg_info

리모트 노드로 메시지를 전송하고자 할 때 호출되는 함수이다.

put_msg_complete

리모트 노드로 메시지를 전송한 후에 호출되는 함수이다.

put_msg_security

put_msg_info 호출되기 전에 데이터를 가공할 수 있는 함수이다.

remote_closed

리모트 노드와 연결을 종료한 후 호출되는 함수이다.

remote_connected

리모트 노드와 연결을 맺은 후에 호출되는 함수이다.

remote_connected_ipv6

IPv6 프로토콜 환경에서 리모트 노드와 연결을 맺은 후에 호출되는 함수이다.

reset_extping_msg

reset_ping_msg와 일부 기능을 제외하고 기본적으로 동일한 기능을 갖는다.

reset_ping_msg

TCP/IP Ping(채널 장애 감지) 메시지의 전송 여부와 전송 메시지를 재설정하기 위해 주기적으로 호출되는 함수이다.

set_error_msg

리모트 노드와의 거래 중 에러가 발생한 경우 자동으로 호출되는 함수이다.

set_extping_msg

서버에 채널 장애를 감지할 때 보낼 메시지를 설정하는 함수이다.

set_ping_msg

채널 장애 감시를 위해서 보낼 메시지 설정 및 주기, 타임아웃 등을 설정할 수 있는 사용자 함수이다.

set_service_timeout

서비스 타임아웃이 발생할 경우 사용자가 호출할 수 있는 함수이다.

2.5. TDL 함수

이름 설명

tdlcall

최신 버전의 동적 모듈 함수를 호출한다.

tdlcall2

최신 버전의 동적 모듈 함수를 호출한다.

tdlcall2s

최신 버전의 동적 모듈 함수를 호출한다.

tdlcall2v

최신 버전의 동적 모듈 함수를 호출한다.

tdlcallva

최신 버전의 동적 모듈 함수를 호출한다.

tdlcallva2

최신 버전의 동적 모듈 함수를 호출한다.

tdlclose

해당 모듈의 레퍼런스 카운트를 0으로 초기화하거나, 모듈을 직접 메모리에서 해제한다.

tdlcreate

최신 버전의 동적 모듈에서 Class Factory를 사용하여 클래스 인스턴스를 생성하는 함수로 TDL 환경 파일(tdl.cfg)에 VERSION=4로 설정된 경우 사용 가능하다.

tdldestroy

최신 버전의 동적 모듈에서 Class Factory를 사용하여 클래스 인스턴스를 파괴하는 함수로 TDL 환경 파일(tdl.cfg)에 VERSION=4로 설정된 경우 사용 가능하다.

tdldone

공유 메모리를 초기화한다.

tdlend

명시적 버전 정합성(Explicit Version Consistency) 유지를 종료한다.

tdlerror

tdlcall()에 대한 에러가 발생했을 때 문자열 형태로 변환한다.

tdlfind

모듈의 인덱스를 찾는다.

tdlfind2

모듈의 인덱스를 찾는다.

tdlgetseqno

글로벌 시퀀스 번호를 가져온다.

tdlinit

공유 메모리를 초기 설정한다.

tdlload

Hashtable 검색 및 라이브러리 적재를 tdlcall()을 하기 전에 미리 수행하여 로컬 캐시에 해당 모듈의 정보를 저장한다.

tdlload2

Hashtable 검색 및 라이브러리 적재를 tdlcall()을 하기 전에 미리 수행하여 로컬 캐시에 해당 모듈의 정보를 저장한다.

tdlresume

일시적으로 중지된 버전 정합성 유지를 재개한다.

tdlstart

명시적 버전 정합성(Explicit Version Consistency) 유지를 시작한다.

tdlstat

TDL 통계 정보를 출력한다.

tdlstat2

TDL 통계 정보를 출력한다.

tdlsuspend

일시적으로 버전 정합성 유지를 중지한다.

2.6. 보안 함수

이름 설명

tmax_accept_crypt

tmax_init_crypt와 마찬가지로 tpstart() 내부에서 클라이언트와 CAS 둘 다 호출된다.

tmax_auth_plugin_init

Tmax 환경설정의 CASOPT에 설정된 값들을 전달한다.

tmax_chk_authen

tpstart() 내부에서 클라이언트의 tmax_init_auth() 호출에 대한 CAS의 인증 검사한다.

tmax_chk_author

CAS에서 인가 검사할 때 호출한다.

tmax_crypt_plugin_init

Tmax 환경설정의 CASOPT에 설정된 값들을 전달한다.

tmax_crypt_plugin_fini

Tmax 환경설정의 CASOPT에 설정된 값들을 전달한다.

tmax_fini_auth

tmax_init_auth 함수를 통해 생성된 해당 클라이언트의 보안 토큰 정보를 삭제한다.

tmax_fini_crypt

tmax_init_crypt 함수를 통해 생성된 own_ctoken을 정리한다.

tmax_init_auth

클라이언트가 tpstart() 내부에서 호출한다.

tmax_init_crypt

암호화 작업을 위한 초기화 과정을 수행한다.

tmax_req_auth

클라이언트의 tpcall 호출 내부에서 요청하는 서비스에 대한 인가를 위해 호출한다.

tmax_tencrypt

Tmax 암/복호화 함수이다.

tmax_unwrap

클라이언트와 Tmax 간의 암호화된 메시지를 복호화한다.

tmax_wrap

클라이언트 와 Tmax간의 메시지를 암호화한다.

2.7. Windows 관련 함수

이름 설명

WinTmaxAcall

MuitiThread 환경에서의 비동기 서비스의 송신 요청한다.

WinTmaxAcall2

MuitiThread 환경에서의 비동기 서비스의 송신 요청한다.

WinTmaxEnd

Tmax 시스템과 연결을 종료한다.

WinTmaxSend

데이터를 송신한다.

WinTmaxSetContext

Windows 핸들과 메시지 타입을 설정한다.

WinTmaxStart

Multi Windows 환경에서 Tmax 시스템과 연결하는 데 사용되는 함수이다.

2.8. 기타 함수

이름 설명

tlog_close

트랜잭션 로그를 분석하기 위한 함수 중 하나로, 해당 로그 파일을 닫는 함수이다.

tlog_find

해당 트랜잭션 로그 파일에서 entry에 지정된 정보와 매칭(matching)되는 entry를 찾는 함수이다.

tlog_nodeno

XID를 이용하여 트랜잭션이 시작된 노드 번호를 찾는 함수이다.

tlog_open

트랜잭션 로그를 분석하기 위한 함수로 해당 로그 파일을 불러(open)온다.

tmaxoserrno

시스템 호출 도중 에러가 발생할 경우 통합된 에러 번호가 설정되는 변수이다.

Usiginit

Tmax 시그널 핸들러를 초기화한다.

Usignal

사용자 시그널 핸들링에 필요한 매크로 설정에 사용되는 함수로 Windows 시스템 환경에는 사용되지 않는다.

Ustrerror

시스템 에러코드(errno)에 대한 통합 에러 메시지를 반환한다.

Uunixerr

시스템 호출 도중 에러가 발생할 경우 통합된 에러 번호가 설정되는 변수이다.

Uunix_err

ATMI API 호출이 실패하고 tperrno가 TPEOS로 설정된 경우 시스템 에러의 종류를 stderr로 출력한다.