RESUMO DE ESPECIFICAO 1.

Pr-Requisitos
1.1 Sero entregues 2 (dois) programas, descritos a seguir:

# 1

PROGRAMA VALIDAO

FORMATO SHARED LIBRARY Padro Unix Sun Solaris

LOCAL E FORMA DE EXECUO MEDIADOR DA TELEMAR COM ASSINATURA DE FUNO PROPRIETRIA DA TELEMAR

CONVERSO

SHARED LIBRARY Padro Unix Sun Solaris

MEDIADOR DA TELEMAR COM ASSINATURA DE FUNO PROPRIETRIA DA TELEMAR

OBJETIVOS a- VALIDAR ARQUIVOS NATIVOS DA PLATAFORMA; b- FORMATAR ARQUIVOS COM BLOCAGEM DEFINIDA a- CONVERTER ARQUIVOS NATIVOS DA PLATAFORMA PARA UM OU MAIS FORMATOS PROPRIETRIOS

1.2. Pr-requisitos de Implementao Capacidade de processar arquivos concatenados Regras de metodologia de desenvolvimento definidas pelo cliente Construo utilizando linguagem definida pelo cliente Aplicao exige alta performance Entrega do fonte Comentrios no cdigo-fonte Idioma Documentao Sim Sim UML Sim (C ANSI UNIX) Sim Sim Sim Ingles Sim

1.3 Parmetros de Desempenho Tamanho de arquivo base Quantidade de registros Tamanho mdio do registro Tempo de converso aceitvel por arquivo Arquivo de 1 GB 14 milhes 80 bytes 15 minutos

1.4. Entenso da documentao IDIOMA Formato Metodologia Documento de Especificao de Projeto Documento de Requisitos de Implantao Documento de Resultados de Testes Portugus PDF UML Sim Sim Sim

RESUMO DE ESPECIFICAO
Documento de Utilizao da Aplicao Documento de Descrio das Regras de Validao dos arquivos nativos gerados pela Plataforma Documento de Descrio de Parmetros, configuraes e caracteristicas tcnicas da porta Ethernet da Plataforma Documento de descrio das regras de converso dos arquivos nativos da Plataforma para os formatos proprietrios da Telemar Documento de Descrio dos arquivos nativos gerados pela Plataforma Documento de Detalhamento dos comandos de transferncia de arquivos dentro da Plataforma Sim Sim Sim

Sim

Sim Sim

2. Sobre a Transferncia dos Arquivos.

FORMA DE TRANSFERENCIA RESTRIES PORTA FTP DIRETA, UTILIZANDO PORTA ETHERNET 10/100/1GB NA PLATAFORMA, UTILIZANDO PROTOCOLO FTP. EXCETO PADRO (21) E DEVE SER SUPERIOR A 4000

2.1. Dentro de cada PLATAFORMA devero ser criados dois diretrios com os seguintes nomes; primary e secondary. No diretrio primary devero estar os arquivos validos a serem coletados pelo mediador. O mediador em intervalos de tempo programados se conectara a PLATAFORMA e iniciara a copia (atravs de FTP) dos arquivos que esto no diretrio primary. Cada arquivo copiado pelo mediador ser movido para o diretrio secondary existente na PLATAFORMA. Os arquivos devero permanecer no diretrio secondary durante pelo menos 90 dias. Aps este perodo a plataforma automaticamente dever providenciar a excluso dos arquivos do diretrio. O processo de excluso do diretrio dever ter como opo a possibilidade dos arquivos serem compactados (RFC 1951, RFC 1952) e gravados em mdia de DVD e/ou Disco ptico (5,25 de 4.8 Gbytes Norma ISO/IEC 15286) sendo essas formatadas em padro aberto de leitura/gravao e suportados pelos sistemas operacionais Windows, SUN SOLARIS, LINUX. O processo de compactao e gravao em mdia dever gerenciar o espao disponvel nas mesmas informando quando da necessidade de sua substituio.

2.2. A periodicidade e o tamanho dos arquivos a serem disponibilizados no diretrio primary para coleta devero ser configurveis atravs de IHM de forma independente ou conjuntamente.

2.3. TODA INFRAESTRUTURA de hardware e software necessria ao processo de transferncia de arquivos (placas de rede, drive de disco ptico, software de compactao, rotina de backup, etc...) devera estar fisicamente contida no interior da PLATAFORMA. No ser admitida a utilizao de equipamentos externos aos ao(s) mdulo(s) que compem o hardware PLATAFORMA (servidores ou microcomputadores, etc...) a menos que os mesmos sejam utilizados para fins de administrao e gerencia deste processo.

2.4. A PLATAFORMA dever prover uma IHM (interface homem maquina) que comporte todos os comandos de administrao do processo transferncia e backup dos arquivos.

RESUMO DE ESPECIFICAO 3. Dos arquivos a serem transferidos.

3.1. Os arquivos de bilhetagem e/ou tarifao devero ser transferidos no formato nativo em que os mesmos so gerados pela PLATAFORMA.

3.2. Caso os arquivos a serem processados pelas LIBs no possuam uma blocagem definida deve-se implementar uma blocagem, inserindo um filler no final do arquivo utilizando a LIB que valida o arquivo (a definio desta blocagem seguira em documento anexo).

3.3. O nome dos arquivos nativos gerados pela plataforma devera conter as seguintes formatao e informaes. A plataforma devera disponibilizar um comando para permitir a plataforma compactao dos arquivos. NOME DO ARQUIVO: ID_DATAINIC_CRC32_SEQUENCIAL EXEMPLO: TLMR_240604123402_AD0A34BB_0000001 DEFINIO DOS CAMPOS: CAMPO ID DATAINIC CRC32 SEQUENCIAL

DESCRIO Identificao da Central com 4 posies alfanumricas Data Inicio de Gerao do Arquivo [DDMMAAhhmmss] Cdigo CRC (Cyclical Redundancy Check) com 32 Bits do arquivo. Numero Seqencial que e incrementado a cada arquivo a cada novo arquivo gerado na plataforma [7 Digitos].

4. Dos Formatos de CDRs que sero produzidos.

4.1. O conversor dever ser capaz de somente converter determinados tipos de chamadas e/ou servios para cada um dos formatos definidos pela OI. 4.2. A OI definir quais os formatos, servios e/ou tipos de chamadas devero constar em cada formato de arquivo a ser produzido pelos conversores. Exemplo: 1. Os CDRs AMA128 somente devero conter chamadas internacionais. 2. Os CDRs AMA111 somente devero conter chamadas de Rede Inteligente menos os servios blacklist e whitelist.

RESUMO DE ESPECIFICAO

5. Tabela de Programas x Regras aplicveis

Programa Validao Converso Regra I Sim No Regra II No Sim Regra III Sim No Regra IV No Sim Regra V Sim No Regra VI Sim Sim

6. Programa de validao
Aes:
1- Avaliar integridade fsica do arquivo; 2- Definir blocagem se necessrio; 3- Criar uma cpia do arquivo

A LIB de validao dever avaliar a integridade fsica do arquivo, definir uma blocagem caso este no seja blocado e criar uma copia do arquivo utilizando os critrios a seguir: Caso o programa de validao no encontre erros no arquivo: 1- Cria copia do arquivo a ser validado, bloca o arquivo caso este no possua uma blocagem pr-definida (Regra V) e renomeia o arquivo conforme regra VI; 2- Informa o diretrio e o nome da cpia criada do arquivo a ser validado na varivel outputfile; 3- Retorna valor 0. Caso o programa de validao encontre um arquivo com problemas: 1234Cria uma cpia desblocada (ver regra V) do arquivo a ser validado e renomeia o arquivo conforme regra VI; Informa o diretrio e o nome da cpia criada do arquivo a ser validado na varivel outputfile; Envia uma mensagem padro (regra I e III) informando o problema encontrado; Retorna valor 1.

7. Programa de converso
A LIB de Converso dever avaliar a integridade fsica do arquivo a ser convertido (informado na varivel inputFile), converter os CDRs nativos do mesmo para o formato especificado pelo arquivo de configurao e armazenar estes novos CDRs em um arquivo que chamaremos de arquivo resultante da converso.

Aes:
1- Converter registro 2- Filtragem de registros antigos 3- Separao de registros antigos

1- Converso de registro 1.1 Se converso concluda com sucesso: 1.1.1 - Disponibilizar no diretrio temporrio informado na varivel tmpDir o arquivo resultante da converso.

RESUMO DE ESPECIFICAO
1.1.2 - Disponibilizar na varivel message a mensagem de converso concluda conforme descrito na especificao (ver Regra I e III). 1.1.3 - Informar o PATH e o nome do arquivo resultante da converso na varivel outputFile (regra VI) 1.1.4 - Retornar valor 1 1.2. Caso converso encontre arquivos com problemas: 1.2.1 - Excluir arquivos criados no diretrio temporrio. A LIB somente dever deletar os arquivos que criados por ela. 1.2.2 - Disponibilizar mensagem (regra II e regra III) na varivel message informando o motivo da no converso do arquivo. 1.2.3 - Manter varivel "outputFile" 1.2.4 - Retornar valor -1 1.3. Caso o programa de converso no encontre registros no arquivo a ser convertido que atendam aos critrios de converso para o formato definido no arquivo de configurao 1.3.1 - Disponibilizar no diretrio temporrio (informado na varivel tmpDir) o arquivo resultante da converso com zero bytes (tamanho em bytes igual a zero). 1.3.2 - Disponibilizar mensagem (regra II e regra III) na varivel message informando o motivo da no converso do arquivo. 1.3.3 - Informar o PATH e o nome do arquivo resultante da converso na varivel outputFile (regra VI) 1.3.4 - Retornar valor 1 2- Filtragem e/ou Excluso dos Registros Antigos 2.1 A LIB de CONVERSO devera incluir uma regra que identifique um registro antigo. Entenda-se por registro antigo ao registro no qual o numero de dias entre a data no campo data da inicio da chamada de um registro bruto e a data atual do sistema (data informada pelo S.O. da plataforma onde a LIB ser executada) seja igual ou maior que o valor informado no arquivo de configurao (ver Regra-IV). Exemplos:
O arquivo de configurao tem no campo QtdeDias o valor 15.

A data atual do sistema 16/10/2005 Exemplo1- A aplicao encontrou um registro no arquivo que tem a data da chamada igual a 01/10/2005 logo este registro considerado antigo devido quantidade de dias entre a data atual do sistema e a data da chamada encontrada no registro ser maior que o valor definido no arquivo de configurao. Exemplo2- A aplicao encontrou um registro no arquivo que tem a data da chamada igual a 30/01/2005 logo este registro considerado antigo. 3- Separao de Registros Antigos por UF 3.1 A LIB de CONVERSO devera incluir uma regra que identifique e filtre os registros por U.F. a partir da definio descrita no arquivo de configurao da LIB. Caso o registro nativo da plataforma no disponha desta informao a regra poder ser montada utilizando a tabela de Cdigo Nacional de Localidade Telefnica Oficial. A regra dever ser validada pela OI.

RESUMO DE ESPECIFICAO

Definies das Regras Regra Regra I Regra II Regra III Regra IV Regra V Regra VI Aplicabilidade Converso Validao Validao Converso Validao Validao/Converso Objetivo FORMATO DAS MENSAGENS A SEREM INCLUIDAS NA LIB DE VALIDAO FORMATO DAS MENSAGENS A SEREM INCLUIDAS NA LIB DE CONVERSO FORMATO DAS MENSAGENS A SEREM INCLUIDAS NAS LIBs POR PROBLEMAS NO AMBIENTE DE PROCESSAMENTO DETALHAMENTO DO ARQUIVO DE CONFIGURAO BLOCAGEM/DESBLOCAGEM Definio do nome do arquivo resultante da operao de validao ou converso

RESUMO DE ESPECIFICAO

Regra I Objetivo da regra: FORMATO DAS MENSAGENS A SEREM INCLUIDAS NA LIB DE VALIDAO Detalhamento do Algoritmo: Exibir a causa do erro ou evento ocorrido de acordo com a implementao, recursos de S.O e problemas de processamento. Pode conter palavras acentuadas: NO Exemplos: -------------------------------------------DETALHAMENTO DAS MENSAGENS A SEREM COLOCADAS NA VARIAVEL "message" -------------------------------------------Segue a definio das mensagens a serem colocadas na variavel "message". {Linha Branco} {Linha Branco} ** Conversor {NOME_FORNECEDOR} ** Resultado da Conversao Arquivo de Entrada: Nome: /billing40/RJBOTB/teydtmp/09808/JEFERSON.txt Qtde Bytes: 876.645.456.765 Regs : 233.000.256.121 Nome do Arquivo de Saida: Nome: /billing40/RJBOTB/teydtmp/RJBOT_90808900_YUI billing40/RJBOTB/teydtmp/RJBOT_90808900_YU/8 098908/JEFERSON.txt.00 Qtde Bytes: 234.064.545.670 Regs : 1.234.456.101 Datas e Hora de Referencia Menor: 20/10/2005 12:45:59

Maior: 28/10/2005 01:37:11 {Linha Branco} {Linha Branco} ONDE:

{Linha Branco} Inserir linha em branco ** Conversor {NOME_FORNECEDOR} ** Inicio variavel (entre 8 e 59). Esta linha deve ser centralizada no espaco entre as colunas 08 ate a coluna 59. {NOME_FORNECEDOR} Espaco para o nome do fornecedor do conversor.

RESUMO DE ESPECIFICAO
Resultado da Conversao Inicio na coluna 22. Arquivo de Entrada Inicia na coluna 8 Nome: {PATH + Nome do arquivo que foi processsado} Inicia na coluna 10 {PATH + Nome do arquivo que foi processsado} Inicia na coluna 16 e escrito ate a coluna 59. Se houver mais caracteres a serem escritos estes devero ser escritos na linha abaixo iniciando novamente na coluna 16 ate a 59 e assim sucessivamente. Descrio do campo: Devera conter o PATH mais o nome do arquivo a ser convertido contido na variavel "inputFile". Qtde Bytes: {Qtde de Bytes} Inicia na coluna 10 {Qtde de Bytes} Inicia na coluna 22 Deve conter ate 12 digitos separados por "." Deve ser escrito da esquerda para a direita a partir da coluna 36 e suprimir os zeros a esquerda. Descrio do campo:

Devera conter a qtde de bytes do arquivo a ser

convertido contido na variavel "inputFile". Regs : {000.000.000.000} Inicia na coluna 15 {000.000.000.000} Inicia na coluna 22 Deve conter 12 digitos separados por "." Deve ser escrito da esquerda para a direita a partir da coluna 36 e suprimir os zeros a esquerda. Descrio do campo: Devera conter a qtde de REGs do arquivo a ser convertido contido na variavel "inputFile". Nome do Arquivo de Saida: Inicia na coluna 08 Nome: {PATH + Nome do arquivo que foi processsado} Inicia na coluna 10 {PATH + Nome do arquivo que foi processsado} Inicia na coluna 16 e escrito ate a coluna 59. Se houver mais caracteres a serem escritos estes devero ser escritos na linha abaixo iniciando no-

RESUMO DE ESPECIFICAO
vamente na coluna 16 ate a 59 e assim sucessivamente. Descrio do campo: Devera conter o PATH mais o nome do arquivo resultante da converso que foi gravado na variavel "outputFile". Qtde Bytes: {000.000.000.000} Inicia na coluna 10 {000.000.000.000} Inicia na coluna 22 Deve conter 12 digitos separados por "." Deve ser escrito da esquerda para a direita a partir da coluna 36 e suprimir os zeros a esquerda. Descrio do campo: Devera conter a qtde de bytes do arquivo resultante da converso que foi gravado na variavel "outputFile". Regs : {233.000.256.121} Inicia na coluna 15 {233.000.256.121} Inicia na coluna 22 Deve conter 12 digitos separados por "." Deve ser escrito da esquerda para a direita a partir da coluna 36 e suprimir os zeros a esquerda. Descrio do campo: Devera conter a qtde de REGs do arquivo resultante da converso que foi gravado na variavel "outputFile". Datas e Hora de Referencia Inicia na coluna 10 Menor: {20/10/2005 12:45:59} Inicia na coluna 15 {28/10/2005 01:37:11} Inicia na coluna 22 Descrio do campo: Devera conter a data e hora do REG mais antigo encontrado no arquivo resultante da converso que foi gravado na variavel "outputFile". Menor: {20/10/2005 12:45:59} Inicia na coluna 15 {28/10/2005 01:37:11} Inicia na coluna 22 Descrio do campo: Devera conter a data e hora do REG mais recente encontrado no arquivo resultante da converso que foi gravado na variavel "outputFile".

{Linha Branco}

RESUMO DE ESPECIFICAO
{Linha Branco} ** Conversor {NOME_FORNECEDOR} ** Resultado da Conversao Arquivo de Entrada: Nome: /billing40/RJBOTB/teydtmp/09808/JEFERSON.txt Qtde Bytes: 876.645.456.765 Regs : 233.000.256.121 Nome do Arquivo de Saida: Nome: /billing40/RJBOTB/teydtmp/RJBOT_90808900_YUI billing40/RJBOTB/teydtmp/RJBOT_90808900_YU/8 098908/JEFERSON.txt.00 Qtde Bytes: 234.064.545.670 Regs : 1.234.456.101 Datas e Hora de Referencia Menor: 20/10/2005 12:45:59 Maior: 28/10/2005 01:37:11 Tratamento de REGs antigos Qtde REGs : 102.64.545.670 Acoes Exec: Exclusao do arquivo outputFile Armazenamento no diretorio definido. {Linha Branco} {Linha Branco} ** Conversor {NOME_FORNECEDOR} ** Inicio variavel (entre 8 e 59). Esta linha deve ser centralizada no espaco entre as colunas 08 ate a coluna 59. {NOME_FORNECEDOR} Espaco para o nome do fornecedor do conversor. Resultado da Conversao Inicio na coluna 22. Tratamento de REGs antigos Inicia na coluna 8 Qtde REGs : {102.64.545.670} Inicia na coluna 8 {102.64.545.670} Inicia na coluna 35 conter ate 12 digitos separados por ponto e ser escrito da esquerda para a direita e suprimir os zeros a esquerda. Descrio do campo: IDEM MENSAGEM ANTERIOR. Acoes Exec: {acoes} Inicia na coluna 8 {acoes} Inicia na coluna 22 Pode conter uma ou duas linhas

RESUMO DE ESPECIFICAO
Descrio do campo: Aqui dever estar decritas as aes efetuadas no arquivo por regras especificas definidas no arquivo de configurao.

{Linha Branco} {Linha Branco} ** Conversor {NOME_FORNECEDOR} ** Erro na {TIPO_ERRO} Causa: O arquivo estava com defeito devido ao tamanho do registro estar inCompatvel com a quantidade de by tes do arquivo. Nome do Arquivo de Entrada: /billing40/RJBOTB/teydtmp/098908/teste/solucao/COL LETA/RJ_ABCD_GJHGJGJ_0980890_RJEFERSON_RJBOT_90800 YU_TELEMAR_RIO_JANEIRO_220820051234_CODIGO_ONLINE_ fatuaramento.txt Qtde Bytes: Qtde de REGs: 100.064.545.670 100.064.545.670 Posico no arquivo onde ocorreu o erro: 1.645.456.765 Conteudo dos 25 bytes da posic. onde ocorreu erro: 0D304021110000000000000000000000000000000000000000 {Linha Branco} {Linha Branco}

ONDE: {Linha Branco} Inserir linha em branco ** Conversor {NOME_FORNECEDOR} ** Inicio variavel (entre 8 e 59). Esta linha deve ser centralizada no espaco entre as colunas 08 ate a coluna 59. Erro na {TIPO_ERRO} Inicio na coluna 24. {TIPO_ERRO} Devera conter uma das duas palavras a seguir: VALIDACAO => Quando o erro ocorrer durante a vali dacao. CONVERSAO => Quando o erro ocorrer durante a conversao. Causa: Inicia na coluna 08. {Descrio do erro} Inicia na coluna 10 e escrito ate a coluna 59. Se

RESUMO DE ESPECIFICAO
houver mais caracteres a serem escritos estes devero ser escritos na linha abaixo iniciando novamente na coluna 10 ate a 59 e assim sucessivamente. Descrio do campo: Devera conter o texto da mensagem de erro a ser informada na variavel "message". Nome do Arquivo de Entrada: Inicia na coluna 8 {PATH + Nome do arquivo que foi processsado} Inicia na coluna 10 e escrito ate a coluna 59. Se houver mais caracteres a serem escritos estes devero ser escritos na linha abaixo iniciando novamente na coluna 10 ate a 59 e assim sucessivamente. Descrio do campo: Devera conter o PATH mais o nome do arquivo a ser validado ou convertido contido na variavel "inputFile". Qtde Bytes: Qtde de REGs: Inicia na coluna 8 {100.064.545.670} {100.064.545.670} Inicia na coluna 22 e na coluna 43 - O preenchimento e da esquerda para direita. - Cada campo podera conter ate 12 digitos separados por ponto. - Os zeros a esquerda deverao ser suprimidos. Descrio do campo: Devera conter a qtde bytes ou REGs do arquivo a ser validado ou convertido informado na variavel "inputFile". Posico no arquivo onde ocorreu o erro: Inicia na coluna 8 {1.645.456.765} Inicia na coluna 22 conter ate 12 digitos separados por ponto e ser escrito da esquerda para a direita Os zeros a esquerda deverao ser suprimidos. Descrio do campo: Posio (em bytes) no arquivo a ser validado ou convertido (informado na variavel "inputFile") onde inicia o problema. Conteudo dos 25 bytes da posic. onde ocorreu erro: Inicia na coluna 8 {0D304021110000000000000000000000000000000000000000} Inicia na coluna 10 Descrio do campo: DUMP dos primeiros 25 bytes a partir da posio do arquivo

RESUMO DE ESPECIFICAO
onde se encontra o erro do arquivo a ser validado ou convertido informado na variavel "inputFile".

{Linha Branco} {Linha Branco} ** Conversor {NOME_FORNECEDOR} ** Erro na {TIPO_ERRO} Causa: Erro ao tentar ler do arquivo. Nome do Arquivo de Entrada: /billing40/RJBOTB/teydtmp/098908/teste/solucao/COL LETA/RJ_ABCD_GJHGJGJ_0980890_RJEFERSON_RJBOT_90800 YU_TELEMAR_RIO_JANEIRO_220820051234_CODIGO_ONLINE_ fatuaramento.txt Qtde Bytes: Qtde de REGs: 100.064.545.670 100.064.545.670 {Linha Branco} {Linha Branco} A DESCRICAO DOS CAMPOS E POSICO IGUAL A MENSAGEM ACIMA SO QUE ESTA MENSAGEM POSSUI MENOS CAMPOS.

RESUMO DE ESPECIFICAO
Regra II Objetivo da regra: FORMATO DAS MENSAGENS A SEREM INCLUIDAS NA LIB DE CONVERSO Detalhamento do Algoritmo: Exibir a causa do erro ou evento ocorrido de acordo com a implementao, recursos de S.O e problemas de processamento. Pode conter palavras acentuadas: NO A LIB de converso devera retornar mensagens nos casos abaixo: 1. Quando o campo DestREGs do arquivo de configurao igual a 1 (ver Regra IV): 2. Quando o campo DestREGs do arquivo de configurao igual a 2 (ver Regra IV): 3. Quando o campo DestREGs do arquivo de configurao igual a 3 (ver Regra IV): 4. Quando houver problemas no arquivo

RESUMO DE ESPECIFICAO
Regra III Objetivo da regra: FORMATO DAS MENSAGENS A SEREM INCLUIDAS NAS LIBs POR PROBLEMAS NO AMBIENTE DE PROCESSAMENTO Detalhamento do Algoritmo: ** Conversor SIEMENS ** Erro na Conversao Causa: Erro ao tentar ler do arquivo. Nome do Arquivo de Entrada: /billing40/RJBOTB/teydtmp/098908/teste/solucao/COL LETA/RJ_ABCD_GJHGJGJ_0980890_RJEFERSON_RJBOT_90800 YU_OI_RIO_JANEIRO_220820051234_CODIGO_ONLINE_ fatuaramento.txt Qtde Bytes: Qtde de REGs: 100.064.545.670 100.64.545.670

** Conversor SIEMENS ** Erro na Conversao Causa: Erro ao tentar ler ao tentar deslocar ponteiro de leitura do arquivo. Nome do Arquivo de Entrada: /billing40/RJBOTB/teydtmp/098908/teste/solucao/COL LETA/RJ_ABCD_GJHGJGJ_0980890_RJEFERSON_RJBOT_90800 YU_OI_RIO_JANEIRO_220820051234_CODIGO_ONLINE_ fatuaramento.txt Qtde Bytes: Qtde de REGs: 100.64.545.671 100.064.545.670

** Conversor SIEMENS ** Erro na Conversao Causa: Erro ao tentar alocar memria. Nome do Arquivo de Entrada: /billing40/RJBOTB/teydtmp/098908/teste/solucao/COL LETA/RJ_ABCD_GJHGJGJ_0980890_RJEFERSON_RJBOT_90800 YU_OI_RIO_JANEIRO_220820051234_CODIGO_ONLINE_ fatuaramento.txt Qtde Bytes: Qtde de REGs: 100.064.545.670 100.64.545.672

RESUMO DE ESPECIFICAO
Regra IV Objetivo da regra: DETALHAMENTO DO ARQUIVO DE CONFIGURAO O arquivo de configurao ser utilizado pela LIB de CONVERSO para definir como dever ser efetuada a converso do arquivo informando na varivel inputFile que dever informar os parmetros a serem utilizados na converso conforme descrito abaixo e devera assim ser formatado: 1. Os campos devero ser separados por ponto-e-virgula. 2. A LIB de converso dever ser capaz de ler arquivos em CSV com a quebra de linha no padro UNIX (LF 0x0D) ou DOS (CRLF 0x0D 0x0A). No arquivo os caracteres aps o # devero ser desprezados (sero considerados comentrios) bem como os espaos e linhas em branco. O local onde ficara o arquivo de configurao poder ser informado das duas maneiras descritas a seguir sendo a forma atravs da varivel de ambiente dominante. Ambas as formas devero estar disponveis na LIB e a escolha entre uma e outra devera ser opcional. 1. Atravs de uma varivel de ambiente chamada PATH_ARQ_CONFIG_LIB 2. Atravs da varivel ConfFilePathnamemantida no cdigo fonte com o pathname default do arquivo de configurao conforme descrito a seguir. Esta somente dever ser usada quando a varivel de ambiente no estiver presente. /CONFIG_LIBs/fornecedor/CONFIG_LIB_[nome_da_lib].csv Onde: fornecedor: Nome fornecedor ou tecnologia. Este nome deve ser definido conjuntamente com a equipe da OI. nome_da_lib Nome da LIB (shared library). Este nome deve ser definido conjuntamente com a equipe da OI. Exemplo: Sendo NGNFULANO o nome do fornecedor e Conv_NGNFULANO.so o da LIB acordados entre o fornecedor da LIBs e a OI ento assim ficar o pathname default da varivel que contem o PATH e o nome default do arquivo de configurao: /CONFIG_LIBs/NGNFULANO/CONFIG_LIB_[ Conv_NGNFULANO.so].csv Parmetros que devero constar no arquivo de configurao: 1.0 BEName O contedo deste campo ser confrontado com o contedo da varivel BEName (esta varivel informada pela API do mediador) para identificar qual a linha do arquivo de configurao ser utilizada para definir os parmetros utilizados no processo de converso. 2.0 NEname O contedo deste campo ser confrontado com o contedo da varivel NEname (esta varivel informada pela API do mediador) para identificar qual a linha do arquivo de configurao ser utilizada para definir os parmetros utilizados no processo de converso. 3.0 Bilhetador Indica o nome do Bilhetador que pertence os registros que foram selecionados do arquivo nativo da central para serem convertidos. 4.0 LayoutSada Identifica o formato de sada do registro (AMA80, AMA111, AMA128, AMA180).

RESUMO DE ESPECIFICAO
5.0 QdteDias Define quantidade de dias (contados a partir da data atual do sistema operacional) que o registro dever ser considerado antigo. Caso este campo apresente espao em branco ou vazio (quando o campo assim for apresentado ;;) dever ser considerado que esta verificao de CDRs antigos no ser efetuada. 6.0 DestREGs Chave que define o que deve ser feito com os registros antigos:

1 = Habilita a converso de todos os registros do arquivo para o arquivo outputFile. 2 = Converte os registros antigos, mas no armazena estes registros no arquivo outputFile.
Armazena os registros antigos convertidos em um arquivo no diretrio definido no arquivo de configurao. O nome do arquivo a ser gravado no diretrio dever ter a seguinte formao: {Bilhetador}_{NEname}_{BEname}_{DataAtual[ddmmaaaa]}_{HoraAtual[hhmmss]}

3 = Ao identificar que um registro nativo antigo, no converte o mesmo e segue para o prximo. Esta opo age como um filtro, retirando do arquivo outputFile (arquivo a ser gerado como resultado da converso)
todos os registros que atendam a regra (neste caso a idade do registro). Caso este campo apresente espao em branco ou vazio (quando o campo assim for apresentado ;;) dever ser considerado que esta verificao de CDRs antigos no ser efetuada. 7.0 DirRegAnt Diretrio (PATH) onde devero ser colocados os arquivos com registros antigos (Quando o diretrio no existir a LIB de Converso devera cri-lo). Caso este campo apresente espao em branco ou vazio (quando o campo assim for apresentado ;;) dever ser considerado que esta verificao de CDRs antigos no ser efetuada. 8.0 FmtSaida Formato de Sada do arquivo. ASCII EBCDIC ASCLF Arquivo em ASCII com LF no final de cada registro. ASCCRLF Arquivo em ASCII com CR e LF no final de cada registro. 9.0 UFdosREGs Lista de U.F. (separada por virgulas) dos registros que devero compor o arquivo. Neste campo dever constar (separado por virgula) todas as U.F. (siglas dos estados) de origem das chamadas que devero constar nos registros. Caso este campo apresente espao em branco, * (asterisco) ou vazio (quando o campo assim for apresentado ;;) dever ser considerado que no haver filtragem de CDRs por UF ou seja todos os CDR contidos no arquivo sero convertidos. Exemplo: Numa linha do arquivo de configurao no campo UFdosREGs contem a seguinte informao:BA, MG. Isso significa que no arquivo de sada (arquivos resultante da converso) somente dever conter os registros que originaram chamadas nestes estados. 10.0 RegrasAplic Este campo dever constar no arquivo de configurao porem no dever ser efetuado nenhum tratamento no mesmo. Lista de regras (separadas por virgula) a serem aplicadas. Este campo conter a regra (ou lista das mesmas) contendo um conjunto de caracteres que identificam que (ou quais) regras devero ser aplicadas durante o

RESUMO DE ESPECIFICAO
processamento dos arquivos.

Exemplo: A LIB possui regras de excluso de registros, listadas abaixo, que devero ser aplicadas de acordo com o tipo de registro a ser processado. Logo a seguir esta uma linha informando coma as regras devero ser colocadas no arquivo de configurao: Nome da Regra: ExclChamLocais ExcluiChamIntern Descrio Exclui chamadas locais Exclui chamadas internacionais

RESUMO DE ESPECIFICAO
Regra V - 1 - BLOCAGEM DE ARQUIVOS Objetivo da regra: Acrescentar caracteres de preenchimento (filler) no final do arquivo para que a nova quantidade de bytes seja mltiplo do fator de blocagem. Detalhamento do Algoritmo: 1.1 Recupera o tamanho do arquivo. 1.2 Divide o tamanho do arquivo pelo fator de blocagem (fixo e pr-definido) 1.3 Se a diviso no for exata preencher o final do arquivo com um filler que torne o resultado desta diviso exata. Observaes: Para linhas com comprimentos distintos utilizar como filler linhas com espaos em branco cuja soma dos comprimentos dos caracteres de todas as linhas torne o resultado da diviso exata Exemplos: O arquivo coletado da Central de MUQUIFO no blocado e seus registros so de tamanho varivel. Para resolver este problema se usou uma blocagem por tamanho de arquivo com valor de 2000 bytes. Isto significa que quando um arquivo com tamanho 12.233.667 Bytes tiver de ser processado, dever ser efetuado o seguinte procedimento: A. Dividir o tamanho do arquivo em bytes pelo fator de blocagem (que neste caso 2000 bytes): 12.233.667 / 2000 => Quociente da Diviso = 12.232.000 Resto da Diviso = 1667 B. Calcular quantos bytes tem que ser inseridos no arquivo para que o resultado da diviso seja exato. Se o valor do resto fosse 2000 a diviso seria exata, logo o calculo consiste em subtrair o valor do resto da diviso (neste caso 1667) de 2000: 2000 (Valor da Blocagem) - 1667 (Resto da diviso) = 333 Bytes C. Logo o programa de validao devera incluir 333 Bytes de filler no final deste arquivo para que este arquivo mantenha um fator de blocagem de 2000 bytes. Regra V - 2 - DESBLOCAGEM DE ARQUIVOS

Para gerar um arquivo desblocado ou com a blogagem fora do padro definido basta incluirmos no final do arquivo o filler de preenchimento que deveria ser inserido para blocar o arquivo acrescido de um byte a mais. Exemplos: Usando o EXEMPLO acima para desblocar este arquivo basta que ao invs de inserirmos 333 bytes sejam colocados 334 bytes no final do mesmo.

RESUMO DE ESPECIFICAO
Regra VI Objetivo da regra: Definio do nome do arquivo resultante da operao de validao ou converso Detalhamento do Algoritmo: 1- Nome do arquivo de sada: PATH + [nome-de-arquivo de entrada (inputfile) excluindo-se o PATH] + .00 Onde, PATH = dever ser copiado da variavel tmpDir. nome-de-arquivo em inputfile sem o PATH .00 = sufixo (sem aspas) para ser colocado apos o nome do arquivo. Exemplos: inputFile = /billingTST/BEjefNGNHUW080/aaa28022 tmpDir = /billingTST/BEjefNGNHUW080/temporrio outputFile dever ser: /billingTST/BEjefNGNHUW080/temporrio/" + "aaa28022" + ".00"