CybosPlus Interface

CybosPlus

CybosPlus Interface

image\ebx_-1743877703.gifMethod

 

RQ/RP

SB/PB

Data Input

object.SetInputValue( type, value)
type
해당하는 입력 데이터를 Value 값으로 지정한다.
t
ype : 입력 데이터 종류
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.gifProperty

object.Continue

연속 데이터 유무를 나타내는 프로퍼티. (읽기전용)
반환 : 1 - 연속데이터 있음. 0 - 연속데이터 없음.

object.Header

Header 컬렉션 루트 객체를 반환한다.
Header
컬렉션에는 Header 정보의 종류와 이름이 들어 있다.(읽기전용)
반환 : Header 컬렉션 객체.

object.Data

Data 컬렉션 루트 객체를 반환한다.
Data
컬렉션에는 Data 정보의 종류와 이름이 들어 있다.(읽기전용)
반환 : Data 컬렉션 객체.

 

image\ebx_-1743877703.gifEvent

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 BlockRequestBlockRequest2 비교

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

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

 

BlockRequest

BlockRequest2

설명

(b) BlockRequest 우선  처리

option 인자에 따라 기능이 다름
- option 0 : BlockRequest 같은 기능
- option
1: 요청한 순서대로 (a) BlockRequest2 먼저 수행됩니다.

특징

이벤트에서 요청할 RQ 우선적으로 처리할경우 유리함

순차적으로 RQ 요청할경우 유리함
통상적인 경우 BlockRequest2 사용을 추천함

 

image\ebx_-1743877703.gif SubscribeSubscribeLatest 비교

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

 

Subscribe

SubscribeLatest

배열에 쌓인 시세변동 이벤트를 순차적으로 모두 발생되도록 요청

배열에 쌓인 시세변동의 이벤트 중에서 가장 최근의 이벤트만 발생되도록

사용

<히스토리성 데이타>
HTS TR7024 호가체결리스트화면 처럼 시세변동데이타를 빠짐없어 모두 처리해야 하는 경우에 사용합니다.

<스냅샷 데이타 >
HTS TR7021 현재가 면처럼 보는 시점에 가장 최근데이타만 수신되도록 합니다. 따라서 Subscribe보다는 처리할 이벤트는 줄어들어서 처리속도는 줄어들어 유용하게 사용