질의 수행의 타임아웃 시간을 설정한다.
cci_set_query_timeout으로 설정된 타임아웃 시간은 cci_prepare, cci_execute, cci_execute_array, cci_execute_batch 함수들에 영향을 미친다. 각 함수에서 타임아웃이 발생했을 때 cci_connect_with_url 연결 URL에 설정한 disconnect_on_query_timeout의 값이 yes이면 CCI_ER_QUERY_TIMEOUT 에러를 반환한다.
위 함수들은 cci_connect_with_url 함수의 인자인 연결 URL에 login_timeout이 설정되어 있는 경우에도 CCI_ER_LOGIN_TIMEOUT 에러를 반환할 수 있는데, 이는 응용 클라이언트와 응용 서버(CAS) 간 재연결 과정에서 로그인 타임아웃이 발생한 경우이다.
응용 클라이언트와 응용 서버(CAS) 간 재연결 과정은 응용 서버가 재시작하거나 재스케쥴되는 경우에 발생한다. 재스케쥴이란 응용 서버가 트랜잭션 단위로 응용 클라이언트를 선택하여 연결을 시작하고 종료하는 과정을 의미하는데, 브로커 파라미터인 KEEP_CONNECTION이 OFF이면 항상 발생하고 AUTO이면 상황에 따라 발생한다. 보다 자세한 사항은 "성능 튜닝 > 브로커 설정 > 브로커별 파라미터"의 KEEP_CONNECTION 설명을 참고한다.
int cci_set_query_timeout (int req_handle, int milli_sec);