CybosPlus Interface

$image\ebx_-1743877703.gif$ Method

	RQ/RP	SB/PB
Data Input	object.SetInputValue( type, value) type에 해당하는 입력 데이터를 Value 값으로 지정한다. type : 입력 데이터 종류 value : 새로 지정할 값
통신 요청 (하단 각각 비교 설명 참조)	object.Request() ret = object.BlockRequest () ret = object.BlockRequest2 (short option) 3가지중에 선택1	object.Subscribe() object.SubscribeLatest() 2가지중에 선택1
Data Get	value = object.GetHeaderValue ( type ) type에 해당하는 헤더 데이터를 반환한다. type : 데이터 종류 반환 값 : 데이터 종류에 해당하는 값 value = object.GetDataValue ( type, index ) type : 데이터 종류 index : 데이터 인덱스 반환 값 : 데이터 종류의 index 번째 데이터

object. GetDibStatus	DIB 통신 상태 (읽기전용) 반환 값 : -1 - 오류 0 - 정상 1 - 수신대기. 오류(-1) , 정상(0) 상태에서는 데이타요청 가능. 수신대기(1) Request를 요청하고 아직 Received 이벤트를 받지 않은 상태의 오브젝트로 다시 Request/BlockRequest/BlockRequest2를 호출한 경우에 발생
object.GetDibMsg1	DIB 통신 결과 메시지 문자열(읽기전용) 반환 값 : 결과 메시지 문자열
object.GetDibMsg2	사용안함

$image\ebx_-1743877703.gif$ Property

object.Continue	연속 데이터 유무를 나타내는 프로퍼티. (읽기전용) 반환 값 : 1 - 연속데이터 있음. 0 - 연속데이터 없음.
object.Header	Header 컬렉션 루트 객체를 반환한다. Header 컬렉션에는 Header 정보의 종류와 이름이 들어 있다.(읽기전용) 반환 값 : Header 컬렉션 객체.
object.Data	Data 컬렉션 루트 객체를 반환한다. Data 컬렉션에는 Data 정보의 종류와 이름이 들어 있다.(읽기전용) 반환 값 : Data 컬렉션 객체.

$image\ebx_-1743877703.gif$ Event

object.Received
데이터를 수신 했을 때 발생하는 이벤트

$image\ebx_-1743877703.gif$ BlockRequest/Blockrequest2/Request의 리턴값

BlockRequest/BlockRequest2

Request

시세 오브젝트

리턴값

0: 정상요청

1: 통신요청 실패

3: 그외의 내부 오류

리턴값 없음

주문관련 오브젝트

리턴값

0: 정상요청

1: 통신요청 실패

2: 주문확인창에서 취소

3: 그외의 내부 오류

4: 주문요청 제한 개수 초과

좌동

$image\ebx_-1743877703.gif$ 요청제한

사용자의 고의 또는 실수(무한루프 등...)로부터 서버 및 다른 사용자들을 보호하기 위하여 시세요청(RQ)과 실시간 요청(SB)에 대해 제한을 두고 있습니다.

RQ 제한

SB 제한

시세 오브젝트

15초에 최대 60건으로 제한

초과 요청시 첫 요청으로 부터15초가 지날 때까지 내부적으로 기다림

최대 400건의 요청으로 제한

초과 요청시 오류

주문관련 오브젝트

15초에 최대 20건으로 제한

초과 요청시 첫 요청으로 부터 15초가 지날 때까지 요청함수(Request, BlockRequest, BlockRequest2)에서 4를 반환

제한없음

위의 제한 사항은 당사 방침에 따라 변경될 수 있습니다.

CpCybos의 LimitRequestRemainTime과 GetLimitRemainCount로 타임아웃까지 남은 시간과 남아있는 요청개수를 얻을 수 있습니다.

$image\ebx_-1743877703.gif$ BlockRequest와BlockRequest2 비교

예를 들어 설명하겠습니다. 다음과 같은 예가 있습니다.
(a) BlockRequest 하는 도중에 다른 이벤트(Received,마우스클릭등) 처리안에서

다른 (b)BlockRequest가 있다고 가정할 경우

	BlockRequest	BlockRequest2
설명	(b)의 BlockRequest가 우선 처리	option 인자에 따라 기능이 다름 - option이 0 : BlockRequest와 같은 기능 - option이 1: 요청한 순서대로 (a)의 BlockRequest2가 먼저 수행됩니다.
특징	이벤트에서 요청할 RQ를 우선적으로 처리할경우 유리함	순차적으로 RQ를 요청할경우 유리함 통상적인 경우 BlockRequest2 사용을 추천함

$image\ebx_-1743877703.gif$ Subscribe와SubscribeLatest 비교

시세변동의 이벤트는 내부에서는 배열로 처리하고 있습니다.

	Subscribe	SubscribeLatest
설명	배열에 쌓인 시세변동 이벤트를 순차적으로 모두 발생되도록 요청	배열에 쌓인 시세변동의 이벤트 중에서 가장 최근의 이벤트만 발생되도록 요청
사용예	<히스토리성 데이타> HTS의 TR7024 호가체결리스트화면 처럼 시세변동데이타를 빠짐없어 모두 처리해야 하는 경우에 사용합니다.	<스냅샷성 데이타 > HTS의 TR7021 현재가 화면처럼 보는 시점에 가장 최근데이타만 수신되도록 합니다. 따라서 Subscribe보다는 처리할 이벤트는 줄어들어서 처리속도는 줄어들어 유용하게 사용