CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) BD SQL Quotes Sistema de Gravação de Cotações Manual de Configuração e Instalação Histórico das Revisões Versão Data Autor Descrição V1.0 13/06/2008 Celso Zanin Documento inicial V1.1 16/06/2008 Celso Zanin Documentando configuração do DEBUG V1.2 22/10/2008 Roberto Sedenho Documentação de descrição das alterações V1.3 05/10/2009 Rommel Trindade Autenticação no servidor SMTP (MTA). V1.4 01/07/2010 Luciano Rodrigues Alterações nas configurações gerais do arquivo BDSQLQuotes.cfg CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 1 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) Índice: 1) BD SQL Quotes............................................................................................................................. 3 1.1) Aplicativo ............................................................................................................................................ 3 1.1) Instalação ........................................................................................................................................... 3 1.2) Monitoração........................................................................................................................................ 6 1.3) Alerta por email......................................................................................................................... CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 2 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) 1) BD SQL Quotes Aplicativo responsável pela gravação de cotações em base de dados. A gravação de cotações pode ser realizada em banco de dados Oracle ou SQL Server. 1.1) Aplicativo ▪ BDSqlQuotes.exe: Aplicativo com console para configuração do BDSqlQuotes; ▪ BDSqlQuotes.doc: Este documento; ▪ BDSqlQuotes.cfg: Arquivo de configuração do BDSqlQuotes; ▪ BDSqlQtService.exe: Arquivo monitor do serviço (também responsável em adicionar e remover o serviço); ▪ columns.txt: Arquivo de configuração com os campos a serem gravados; ▪ table.txt: Arquivo de configuração com os “ativos” a serem gravados. Obs.: O aplicativo é dependente do “run-time” do Visual C++ 2005 (executar o arquivo vcredist_x86.exe ou copiar no mesmo diretório os arquivos mf*.dll e ms*.dll). 1.1) Instalação ▪ Copiar o diretório do BDSQLQuotes; ▪ Verificar conectividade com os servidores Advanced (configurar na sessão [HOSTLIST.CMA_NET] do arquivo BDSqlQuotes.cfg); ▪ Verificar instalação do OraOLEDB.Oracle (executar o instalador Oledb92070 para a instalação do OraOLEDB se necessário); ▪ Configurar o SID para acesso ao Oracle via “Net Configuration Assistant” (ou solicitar a instituição o arquivo tnsnames.ora e gravar diretamente no diretório “C:\oracle\ora92\network\ADMIN” - instalação padrão Oledb92070); ▪ Verificar conectividade com o servidor de banco de dados Oracle (configurar na sessão [BDSQLQUOTES] do arquivo BDSqlQuotes.cfg); ▪ Verificar instalação do SQL Server; ▪ Verificar conectividade com o servidor de banco de dados SQL Server (configurar na sessão [BDSQLQUOTES] do arquivo BDSqlQuotes.cfg); ▪ Configurar o arquivo “columns.txt”: Arquivo com as colunas a serem gravadas (formato “num,texto_cma,campo_base,limpa”, onde “campo_base” quando preenchido é o campo da base de dados para a gravação e no campo “limpa” é a configuração para ligar e desligar a limpeza da cotação), trecho do arquivo disponibilizado na instalação: 0,Volume,ATV_DES_VO1 1,Percentual,ATV_DES_VAR 2,NMOC 3,NMOV 4,AgMOC 5,AgMOV 6,PresC 7,PresV CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 3 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) 8,PcoExerc 9,Vencto 10,LoteNeg 11,Retorno 12,Ajuste,ATV_DES_AJU 13,DUteis 14,DCorrid 15,Limpeza 16,Ultimo,ATV_DES_ULT ▪ Configurar o arquivo “table.txt”: Configurar a relação de “ativos” a serem gravados na base de dados ; ▪ Arquivo de configuração BDSqlQuotes.cfg (configurar apenas os itens em vermelho): [BDSQLQUOTES] DBTYPE = ORACLE Tipo do servidor de base de dados (ORACLE ou SQLSERVER) DSN = PROVIDER = OraOLEDB.Oracle DATASOURCE = SID do Oracle ou nome do servidor SQL Server CATALOG = tempdb Nome da base de dados DBUSER = user Usuário do servidor de base de dados DBPASS = password Senha do servidor de base de dados DBTABLE = BCSYS_ATIVO Tabela para gravação RELOADATIVOS = 60 Tempo (em minutos) para reload dos ativos DBTABLECOLUMNS = COD_COL:ATV_CODIGO;FLG_COL:ATV_FLG_ATIVO;DTM_COL:ATV_DAT_DATAHORA; Bolsa default para inclusão de ativo diretamente EXCHANGE = 2 na tabela (na tabela não temos a origem) //-----------------------------------------------// TRY DB OPEN TIMEOUT (unit in seconds) // Over timeout it will send email DBOPENTIMEOUT= 10 É o intervalo entre uma desconexão e a próxima conexão. Caso a desconexão seja maior que o tempo definido a aplicação envia o e-mail de alerta, caso contrário não envia. É altamente recomendável que o valor desse campo seja maior que 3, pois o acesso a base de dados é remoto. //-----------------------------------------------[HOSTLIST.CMA_NET] HOST01 = HOST:advanced01.cma.com.br;PORT:9875; HOST02 = HOST:advanced02.cma.com.br;PORT:9875; HOST03 = HOST:advanced03.cma.com.br;PORT:9875; HOST04 = HOST:advanced04.cma.com.br;PORT:9875; [SYSTEM] APPLICATION = DEBUG:1,2,3; NETWORK = DEBUG:1; OBJECT=DEBUG:1,2,3; NET_RECONNECTION = INTERVAL:10; LOGPATH = log\ 1o 2o 3o 2o servidor servidor servidor servidor Advanced Advanced Advanced Advanced Nível de debug da aplicação (de 1 a 9 ou DEBUG: ALL) Nível de debug dos dados de rede (de 1 a 9 ou DEBUG: ALL) Nível de debug dos objetos usados pela aplicação (de 1 a 9 ou DEBUG: ALL) Intervalo em segundos para a reconexão com os servidores de base de dados e Advanced Path para a gravação dos arquivos de log [DATA] QUOTES = SESSION:SCMA; DBQUOTES = SESSION:SCMA; SYSTEM = SESSION:SYSTEM; [SESSION] SCMA = GROUP:SESSION_CMA; SMTP = NET:SMTP_NET; SYSTEM = NET:SYS; CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 4 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) [SESSION_CMA] CMA_NET = EXCHANGE:0.250;RIGHTS:1; Limite mínimo e máximo da origem (0 à 250) [NET.PLUGIN] CMA_NET = DLL:advprot.dll;PROT:AdvProtocol.1; SMTP_NET = DLL:smtprot.dll;PROT:smtpProtocol.1; [PROVIDER.PLUGIN] INTERFACE01 = DLL:ProvINTBov.DLL;INT:ProviderInterfaceBov.1; INTERFACE02 = DLL:ProvINT.DLL;INT:ProvINT.1; [TRANSPORT.PLUGIN] INTERFACE01 = DLL:NETBASIC.DLL;INT:NetBasicInterface.1; [STATIC.DATA] SYSTEM = RIGHTS = SMTP = DBQUOTES.1 = ▪ A configuração do usuário do Servidior Advanced é realizada via o módulo BvspSimulator.exe (menu Arquivo) ▪ Para instalar como Serviço do Windows seguir os passos: ▪ Executar “BDSqlQtService.exe /install”; ▪ Executar “BDSqlQtService.exe /Service”; ▪ Entrar no Serviço do Windows, localizar o serviço “BDSqlQtService” e configura-lo o “Tipo de Inicialização” como “Automático”; ▪ Configurar no “BvspSimulator.exe” o “Modo de Execução” adequadamente; ▪ Para retirar o Serviço do Windows executar “BDSqlQtService /uninstall”; ▪ Quando trabalhando como serviço configurar BDSqlQuotes como serviço, segue tela de configuração abaixo: CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 5 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) ▪ Os textos que aparecem na interface do BDSqlQuotes podem ser eliminados através de clique-direito sobre a lista de mensagens (ou através da eliminação do arquivo “appdata.dat”); Usar o comando “TELNET” no DOS-Prompt na porta do Advanced (exemplo: “C:\TELNET advanced1.cma.com.br 9875”) Usar o comando “TNSPING” no DOS-Prompt (exemplo: “TNSPING servora”) Também se pode gravar um registro na base de dados (configurar o campo [BDSQLQUOTES].RELOADATIVOS com o número de minutos para o processamento da carga de ativos para gravação das cotações) 1.2) Monitoração ▪ A monitoração pode ser realizada através do arquivo BDSqlQuotes.mon; [MONITOR] DATA=13/06/08 14:58:42 SITUACAO_ADVANCED=OK SITUACAO_BASEDADOS=OK Data do computador (atualizada a cada 30 segundos) Situação da conexão com o Servidor Advanced (*) Situação da conexão com o Banco de Dados (*) (*) Quando conexão sem problemas o texto OK vai aparecer, caso contrário irá aparecer o texto NOT_READ. ▪ No arquivo LOGAAAAMMDD.log (onde AAAMMDD é data neste formato) podemos consultar informações de funcionamento do aplicativo (vide 1.1 para configuração do DEBUG); ▪ Exemplo do arquivo LOGAAAAMMDD.log: 2010/07/01 17:04:36 <|>(APPLICATION:1)<|> ############################################################################################## CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 6 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Negociação Eletrônica (Desenvolvimento de Produtos) 2010/07/01 17:04:36 <|>(APPLICATION:1)<|> DATABASE: Open succeeded. 2010/07/01 17:04:46 <|>( NETWORK:1)<|> Network OnConnect: Loading protocol (advprot.dll). 2010/07/01 17:04:46 <|>( NETWORK:1)<|> Network OnConnect: found protocol (AdvProtocol.1). 2010/07/01 17:04:46 <|>( NETWORK:1)<|> Network OnConnect: create protocol (AdvProtocol.1:). 2010/07/01 17:04:46 <|>( NETWORK:1)<|> TCP Client(41): Connection(Host=advanced01.cma.com.br Port=9875) ready. 1.3) Alerta por email ▪ O BDSQL alerta por email quando perde a conexão com o banco de dados ou com o Advanced Server. Para ativar o alerta configure no arquivo BDSqlQuotes.cfg a entrada EMAIL_ALERT; [HOSTLIST.SMTP_NET] HOST01 = HOST:SPO-DC1.cma.local;PORT:25; IP ou nome do servido SMTP (MTA) que fará a entrega da mensagem [EMAIL_ALERT] INTERVAL = 1 Intervalo em minutos para o envio do email Email dos destinatários separados por ponto vírgula(;) Email do remetente Nome do remetente Usuário utilizado para autenticação Senha do usuário para autenticação. RECIPIENT = [email protected] SENDER = [email protected] SENDER_NAME = Teste de E-mail USER = PW = (*) A autenticação ocorrerá se a entrada USER estiver preenchida e o MTA deverá informar que aceita autenticação AUTH PLAIN e/ou AUTH LOGIN. ▪ O log do BDSqlQuotes foi melhorado e gravará a informação fornecida pelo MTA com o porquê do não envio do email. CMA Consultoria, Métodos, Assessoria e Mercantil LTDA Rua Professor Filadelfo Azevedo, 712 CEP 04508-011 - São Paulo/SP - Fone: (11) 3053-2600 - Fax: (11) 3887-8016 [email protected] - www.cma.com.br 7 /7 Brasil Estados Unidos Espanha Portugal Argentina Uruguai Chile