MEFF Feed Traspaso

MEFF Feed Traspaso
GUÍA TÉCNICA
MEFF S/MART v9.90
6 de octubre de 2015
La información contenida en este documento está sujeta a modificaciones sin previo aviso. A menos que se indique lo
contrario, las compañías, los nombres y los datos utilizados en los ejemplos son ficticios. Ninguna parte de este documento
puede ser reproducida o transmitida de ninguna forma, ni por cualquier medio, ya sea electrónico o mecánico, con ningún
propósito, sin la previa autorización por escrito.
© 2014 BME. Todos los derechos reservados.
© 2015 BME. Todos los derechos reservados.
MEFF Feed Traspaso - Guía Técnica
Tabla de Contenidos
1.
Introducción ...................................................................................................................................1
1.1
1.2
1.3
2.
MEFF_Feed_Traspaso ...................................................................................................................2
2.1
2.2
3.
Cómo recibir información....................................................................................................................... 1
Cómo trabaja la DLL ............................................................................................................................. 1
Requisitos software para usar la DLL MEFF_Feed_Traspaso. ............................................................. 1
Configuración ........................................................................................................................................ 2
Puntos de entrada ................................................................................................................................. 2
Mensajes .........................................................................................................................................5
3.1
3.2
Características ...................................................................................................................................... 5
Relación de mensajes ........................................................................................................................... 6
3.2.1 Mensajes de negociación........................................................................................................... 6
3.2.2 Mensajes de liquidación ............................................................................................................. 7
i
MEFF Feed Traspaso - Guía Técnica
1. Introducción
1. Introducción
MEFF_Feed_Traspaso es una DLL que permite recibir un feed ASCII de los terminales MEFFStation.
El objetivo es suministrar, a aplicaciones externas, datos en tiempo real tanto de negociación como
de liquidación.
Esta DLL permite únicamente recibir información. Para enviar datos al sistema debe utilizarse
MEFFGate.
1.1 Cómo recibir información
El capítulo dos describe la DLL y sus puntos de entrada, dando también los códigos de retorno.
Los parámetros se comprueban, de forma que si no son correctos la aplicación recibirá un código de
retorno informando de ello.
1.2 Cómo trabaja la DLL
MEFF_Feed_Traspaso es síncrona de forma que la aplicación tiene que esperar hasta que la llamada
es procesada y los datos están disponibles o se ha producido un error.
Para evitar un número excesivo de llamadas a la DLL que causen que la red vaya lenta,
MEFF_Feed_Traspaso accederá al fichero de datos sólo si la última llamada finalizó con éxito y pudo
leer datos, En caso contrario esperará unos milisegundos y después devolverá el código “datos no
disponibles”.
1.3 Requisitos software para usar la DLL MEFF_Feed_Traspaso.
MEFF_Fedd_Traspaso es una DLL de 32 bits, por lo tanto la aplicación que la use debe ser capaz de
llamar a una función de 32 bits. Las llamadas a esta función son estándar.
La DLL usa TCP para comunicarse con MEFFStation.
6 de octubre de 2015
© BME 2015
1
MEFF Feed Traspaso - Guía Técnica
2. MEFF_Feed_Traspaso
2. MEFF_Feed_Traspaso
Este capítulo describe la especificación funcional de la DLL MEFF_Feed_Traspaso. También se
describe la configuración necesaria para un uso correcto.
2.1 Configuración
Para una correcta ejecución de la DLL, el programa que la use debe instalarse en un PC con
Windows NT Workstation 4.0 o superior con Service Pack 4 o superior.
2.2 Puntos de entrada
Los puntos de entrada de la DLL son:
Open_Feed_Traspaso
Establece la conexión.


Parámetros
Parámetro
Tipo
Long
Comentarios
Camino
Pchar
n
Camino al servidor del feed
Valores de retorno
Los valores de retorno son enteros con signo de cuatro bytes. Estos valores serán menores
que cero si la apertura no ha sido correcta.
Si el resultado es correcto el valor de retorno será mayor que cero. Este valor de retorno se
usará en las funciones de Read y Close con el nombre Manejador.
Los valores de retorno posible son:
Valores de retorno
Descripción
>= 0
OK
-1
Feed ya abierto
-2
Feed no encontrado
-3
Está tratando de abrir mas de 11 conexiones
-4
No autorizado
Read_Feed_Traspaso
Leer siguiente mensaje.
6 de octubre de 2015
© BME 2015
2
MEFF Feed Traspaso - Guía Técnica


2. MEFF_Feed_Traspaso
Parámetros
Parámetro
Tipo
Long
Comentarios
Manejador
Int
4
Manejador del feed (Ver
Open_Feed_Traspaso).
Buffer
Char
n
Dirección del buffer donde se guardarán
los datos
Tamaño
Int
4
Tamaño del buffer. (Debe ser superior a
256 bytes)
Valores de retorno
El valor de retorno es un entero con signo de 4 bytes.
Contiene el número de caracteres realmente leídos.
Será menor que cero si la operación ha fallado.
Si la lectura ha sido correcta, el valor de retorno será mayor o igual a cero.
Los valores de retorno posibles son:
Valores de retorno
Descripción
>0
Número de caracteres leídos.
0
Registro vacío, no se ha leído ningún carácter
-1
Feed no abierto
-2
Error de lectura (hay que relanzar el feed)
-3
Manejador inválido
-4
Fin de sesión
Close_Feed_Traspaso
Cerrar la conexión.

Parámetros
Parámetro
Tipo
Long
Comentarios
Manejador
Int
4
Manejador del feed
6 de octubre de 2015
© BME 2015
3
MEFF Feed Traspaso - Guía Técnica

2. MEFF_Feed_Traspaso
Código de retorno
El código de retorno será menor que cero si el cierre no es correcto.
Si el cierre es correcto el Manejador será mayor que cero.
Los valores de retorno posible son:
Valores de retorno
Descripción
0
OK
-1
Feed no abierto
6 de octubre de 2015
© BME 2015
4
MEFF Feed Traspaso - Guía Técnica
3. Mensajes
3. Mensajes
Los terminales MEFFTop son capaces de generar un feed en tiempo real con el mismo contenido de
los ficheros de datos. Alguno de estos mensajes son generados en tiempo real y otros al final de
sesión. Este capítulo muestra el formato de los mensajes e indica si se envían en tiempo real o no.
3.1 Características
Para recibir el feed de datos, es necesario hacer un programa que use la DLL MEFF_Feed_Traspaso.
La información enviada es la misma que se incluye en los ficheros de datos con una cabecera
formada por el nombre de fichero y separada por punto y coma. Por ejemplo los registros
correspondientes a CPREMIUMS tienen el siguiente formato:
Valores
válidos
Campo
Tipo
CPREMIUMS
String
SessionDate
LocalDate
Fecha de sesión
ContractGroup
String(2)
Código de grupo de contratos
TradeID
int
Número de registro de cámara de la
operación
Side
char
Member
String(4)
Miembro al que pertenece la cuenta
Account
String(5)
Cuenta asociada a la operación
ContractCode
String(22)
Código de contrato
Premium
Amt
Currency
Currency
"1"=Compra
"2"=Venta
Descripción
Signo de la operación
Prima resultante de la opción
ver Tabla 1 en
documento
‘Tablas
de
Codificación’
Divisa en la que está expresada la prima
Todos los campos son de longitud variable separados por punto y coma.
Los campos no numéricos están delimitados por comillas (“), los numéricos no están delimitados por
comillas.
Los campos numéricos pueden tener una coma como separador decimal en cualquier posición y
también pueden contener el signo menos.
El feed incluye todos los mercados o cámaras a los que se conecta el terminal, por lo tanto sólo hace
falta una conexión.
Si se pierde conexión, al reconectar se recibirá toda la sesión desde el principio, por lo tanto la
aplicación del miembro puede recibir registros repetidos.
6 de octubre de 2015
© BME 2015
5
MEFF Feed Traspaso - Guía Técnica
3. Mensajes
3.2 Relación de mensajes
El cuadro que sigue da el nombre de los mensajes que se envían por el feed.
3.2.1 Mensajes de negociación
Fichero
Descripción
Generación
TACCOUNTS
Cuentas
T.R.
TCONTRACTS
Contratos
T.R.
TCONTRCODES
Equivalencias códigos internos de contratos
T.R.
TCONTRGRP
Grupos de contratos
T.R.
TCONTRTYP
Tipos de contrato
T.R.
THOLIDAYS
Festivos
T.R.
TLOGORDERS
Seguimiento de las órdenes
T.R.
TMARKET
Mercado
T.R.
TORDERS
Órdenes
T.R.
TTRADES
Operaciones
T.R.
6 de octubre de 2015
© BME 2015
6
MEFF Feed Traspaso - Guía Técnica
3. Mensajes
3.2.2 Mensajes de liquidación
Fichero
Descripción
Generación
CACCOUNTS
Cuentas
T.R.
CCLEARINGHOUSE
Cámara
T.R.
CCONTRACTS
Contratos
T.R.
CCONTRCODES
Equivalencias códigos internos de contratos
T.R.
CCONTRGRP
Grupos de contratos
T.R.
CCONTRTYP
Tipos de contrato
T.R.
CGIVEIN
Give-Ins para Miembro Destino
T.R.
CGIVEINCLM
Give-Ins para Compensador de Miembro Destino
T.R.
CGIVEOUT
Give-Outs
T.R.
CHOLIDAYS
Festivos
T.R.
CINTERSPR
Compensaciones inter-matriz
T.R.
CINTRASPR
Compensaciones intra-matriz
T.R.
COPENPOSITION
Saldo de posición abierta
B.O.S.
CPREMIUMS
Primas de opciones
T.R.
CTRADES
Operaciones
T.R.
CVALARRAYS
Parámetros de la matriz de garantías
T.R.
B.O.S. - Este fichero se enviará al comienzo de sesión.
T.R. – Este fichero se generará en tiempo real.
Para una descripción detallada de los ficheros de traspaso, ver los manuales “MEFFStation –
Ficheros de Datos de Negociación” y “MEFFStation - Ficheros de Datos de Liquidación”.
6 de octubre de 2015
© BME 2015
7