APRESENTAÇÃO DOS APLICATIVOS PSTAW10 e PSTAC10 - 05/09/2011 =========================================================== 1. INTRODUÇÃO ---------- - A função principal desses aplicativos é prover o intercâmbio de informações (documentos digitais) entre o Banco Central e Instituições Financeiras (ou outras instituições) de maneira padronizada e segura, usando-se a CIFRAGEM DE DADOS, através de conexões na Internet ou em algumas redes privadas que têm conexão à rede do Banco Central (RTM e RSFN). - O PSTAW10 não se destina à preparação de ARQUIVOS, tarefa de reponsabilidade das Instituições, e/ou de outros aplicativos distribuídos pelo Banco, específicos para cada documento. - Para fazer uso do PSTAW10, o operador deve ser cadastrado no Sistema de Informações Banco Central - SISBACEN, estando ali autorizado na transação PSTA300. Para certos documentos pode ainda ser necessária a autorização em outro serviço, de modo a garantir maior segurança no envio e busca das informações. - A cifragem é feita de modo a que a correspondente decifragem só ocorra em equipamentos Servidores do Banco Central, ou no equipamento onde está instalado o PSTAW10. As transferências são todas feitas com uma cifragem dos arquivos a enviar ou a receber, em grande parte das vezes precedida por um processo de compressão. - Os arquivos identificados como "zipados" (com padrão interno usado na extensão .zip) normalmente são transmitidos sem que o programa efetue compressão adicional, de modo a agilizar o procedimento de envio ou recepção. - Além do PSTAW10 é também fornecido o aplicativo PSTAC10, que se destina a automatizar os processos de envio e recepção de arquivos de/para o Banco Central. O PSTAC10 pode ser chamado a partir de scripts que efetuam as ações necessárias para as transferências. - As instruções e comentários presentes neste texto se aplicam às versões iguais ou posteriores à 2.8.0.1 dos programas. As versões anteriores podem não implementar muitos dos comandos e comportamentos aqui descritos. 2. INSTRUÇÕES BÁSICAS DE USO DO PSTAW10 ------------------------------------ 2.1 - PARA ENVIO DE ARQUIVOS AO BANCO CENTRAL - Identificar-se como no terminal ou em aplicações do SISBACEN informando o código da Instituição, seguido imediatamente do da Dependência (caso de Instituições com código numérico), a identificação do Operador e a Senha; - Escolher na barra de menu a opção "TRANSMISSÃO/Envia Arquivo pela pela Internet"; - Após a seleção de um código de documento e do arquivo que se deseja enviar o arquivo é compactado ("zipado"), caso já não tenha a terminação ".zip" e então é procedida a sua cifragem em um diretório temporário. Assim o arquivo está pronto para o envio. É estabelecida a conexão através da Internet com um equipamento servidor do Banco Central, para a transmissão ao ambiente computacional do Banco; - Após a transferência ser efetuada sem problemas será exibida uma tela com o número do PROTOCOLO; - A validade do arquivo para o SISBACEN será aferida apenas em operações específicas que poderão incluir a disponibilização de um arquivo-resposta. Existem sistemáticas diferentes, que variam de acordo com o documento enviado. - A opção de envio, além da cifragem, eventualmente pode fazer a validação do "layout" do arquivo/documento de entrada, com a conferência do comprimento de registros e de alguns outros aspectos relevantes na identificação do documento, caso haja um "layout" definido. 2.2 - PARA RECEBIMENTO DE ARQUIVOS - Após a identificação da instituição e operador no SISBACEN o PSTAW10 poderá indicar a existência de arquivos a receber; - Além da indicação pelo programa pode ser selecionada a opção de Menu "RECEPÇÃO/Relação dos Arquivos a Receber", de modo a ser apresentada a relação dos arquivos que estão disponíveis para a recepção (DOWNLOAD) pela Instituição identificada; - Após exibida a relação deve-se indicar o arquivo (PROTOCOLO) desejado preenchendo o seu nome (localização no computador). Ao final do "DOWNLOAD" será exibida uma mensagem confirmando o término bem sucedido do processo. 2.3 - INFORMAÇÕES ADICIONAIS PARA O USO - Pode ser utilizada somente a opção de verificação de formato do arquivo, para checar a validade do mesmo. Esta opção deve ser usada tanto para checar a validade como para minimizar o tempo de conexão à Internet, no caso das conexões discadas. 3. APLICATIVO PSTAC10 ------------------ - Juntamente com o PSTAW10 é distribuído o programa PSTAC10, o qual apresenta todas as suas funcionalidades usando linha de comando (modo console). - Este programa pode viabilizar uma automatização de processos relativos ao envio, verificação da eventual disponibilidade, e recepção dos arquivos, por parte das instituições. - A sua utilização deve ocorrer, preferencialmente, por uso de "scripts" ou arquivos de comandos, normalmente nos ambientes Windows (2000/2003/2008/XP/Vista/Windows7). O pertinente uso da variável com o retorno de chamadas (%ERRORLEVEL%) permite que seja aferido o sucesso do envio, da recepção, ou ainda a existência de arquivos a receber. - Para relacionar as diversas opções de uso, pode ser acionado o programa em uma janela de console (CMD.exe), sem argumento de chamada (digitando-se apenas C:\BCB\PSTAW10\PSTAC10). - As letras relacionadas para as opções podem ser digitadas em maiúsculas ou minúsculas, sem distinção de significado. Caso seja necessário agregar alguma informação adicional à letra, esta deve vir logo após a mesma, sem espaços. - Deve ser evitado o uso de espaços em nomes de arquivos ou em observações, uma vez que o espaço normalmente é usado como o elemento de separação entre argumentos. Caso seja necessário o uso, envolver todo o campo entre aspas ("). - O PSTAC10 pode ser usado também para descompactar um arquivo ".zip" recebido, para preparar um arquivo ".zip" para envio, para tratar arquivos com informações de auditoria (Logs), ou ainda conferir ou calcular o hash SHA1 dos arquivos tratados pelo sistema. - Em cada execução é setado o parâmetro de scripts errorlevel, que pode assumir os seguintes valores: 0 - Indica a operação OK ou que existe um arquivo a receber 1 - Indica que não há arquivo disponível para o recebimento Indica que a senha não expira no prazo de dias indicado Indica que o PSTAC10 não abriu exclusivamente o arquivo Indica que o envio/recepção do arquivo estão bloqueados Indica que não há arquivos selecionáveis para a relação 2 - Resultado do processamento inválido conforme a mensagem 3 - Parâmetros de chamada incorretos ou arquivo inexistente Indica também erro na cifragem ou preparação de arquivo 4 - Erro crítico na execução demandando uma nova instalação Indica ainda a impossibilidade de execução pelo Windows 5 - Parâmetros de chamada omitidos ou chamada em modo ajuda 3.1) EXEMPLOS DE CHAMADAS DOS COMANDOS MAIS UTILIZADOS a) PSTAC10 L -u840018901.FULANO -sXPTO1234 Efetua um Logon para o usuário FULANO com a senha XPTO1234 Esse usuário pertence à Instituição 84001 dependência 8901 Não há necessidade de logon para cada operação do programa Deve-se usar se mudar o endereço IP ou a versão do PSTAC10 É necessário também se alterarda a senha sem o PSTAC10/W10 O logon no PSTAW10 valendo no PSTACC10 substitui o comando b) PSTAC10 L -u840018901.FULANO -ssenha1 -nsenha2 -csenha2 Troca a senha do usuário FULANO de "senha1" para "senha2" Esta opção é necessária no mínimo a cada 89 dias corridos Para os usuários de serviços o prazo limite é de 359 dias Pode ser evitada com logon no PSTAW10 valendo no PSTAC10 c) PSTAC10 L -u Equivale a uma operação de LOGOUT apagando as credenciais Após esta opção será necessário um novo LOGON d) PSTAC10 T -u -d8 Testa se a senha SISBACEN vai expirar nos próximos 8 dias Se a senha não expira em 8 dias é retornado o Errorlevel1 e) PSTAC10 E -D4010 "C:\Meus Docs\COS4010.txt" Envia o arquivo 4010 a partir de C:\Meus Docs\COS4010.txt Quando houver espaços utilizar as aspas envolvendo o nome f) PSTAC10 E -D4010 "C:\Meus_Docs\arq.txt" "-OMeu arquivo" Envia o arquivo 4010 a partir de C:\Meus_Docs\arq.txt O campo de observação conterá a expressão "Meu arquivo" g) PSTAC10 Z -Z C:\Zips\SCR3020.zip C:\Arqs\SCR3020.xml Cria o arquivo C:\Zips\SCR3020.zip (arquivo zipado) A partir do arquivo C:\Arqs\SRC3020.xml h) PSTAC10 E -DR320 -S C:\Zips\SRC3020.zip Envia o arquivo R320 a partir de C:\Zips\SRC3020.zip A opção "-S" indica para não ser comprimido para o envio Esta opção é assumida pelo programa se for um arquivo zip i) PSTAC10 V -DR002 -PC:\TEMP\Numprot.txt Verifica se existe um arquivo R320 a receber Se houver é gravado o arquivo Numprot.txt com o protocolo j) PSTAC10 V -N124567 -PC:\TEMP\ProtRest.txt Verifica se existe um arquivo resposta ao protocolo 124567 Se houver é gravado o arquivo ProtResp.txt com o protocolo k) PSTAC10 R -DR002 -PC:\TEMP\Numprot.txt C:\Dados\R002.txt Recebe o arquivo de número contido no arquivo Numprot.txt Grava o arquivo recebido como C:\Dados\R002.txt l) PSTAC10 R -DR002 -PC:\TEMP\Numprot.txt -S C:\Zips\R002.zip Recebe o arquivo de número contido no arquivo Numprot.txt Grava o arquivo recebido como C:\Zips\R002.zip Deve ser usada para baixar arquivos que já estão zipados Mesmo se não indicada o programa não compacta arquivos zip m) PSTAC10 Z -U C:\Zips\R382.zip C:\Recs Descompacta o conteúdo de C:\Zips\R002.zip na pasta C:\Recs n) PSTAC10 Z -R C:\Zips\R382.zip C:\Zips\R382.rel Lista em C:\Zips\R002.zip o conteúdo de C:\Zips\R002.zip o) PSTAC10 O "-TTexto gravado." Anexa "dd/mm/aaaaa hh:mm:ss Texto gravado." em PSTAC10.log É útil para registrar eventos no arquivo de Log do PSTAC10 p) PSTAC10 H E Exibe as diversas opções para envio de arquivos q) PSTAC10 H R Exibe as diversas opções para recepção/relação de arquivos - A nomenclatura das pastas e arquivos acima relacionada não é obrigatória, sendo empregada somente a título de exemplo. Em cada instituição poderá haver outros nomes adotados. 3.2) EXEMPLOS DE SCRIPTS PARA USO DO PSTAC10 a) SCRIPT PARA VERIFICAÇÃO DE ARQUIVO A RECEBER: PSTAC10 v -DR002 -PNumero.tmp IF NOT %ERRORLEVEL% == 0 goto ERROS for /f "tokens=1,1" %%a in (Numero.tmp) do SET NUM=%%a Echo PROTOCOLO %NUM% DISPONIVEL PARA RECEPCAO Del Numero.tmp goto :eof :ERROS IF %ERRORLEVEL% == 1 Echo NAO EXISTEM DOCUMENTOS A RECEBER IF %ERRORLEVEL% == 2 Echo PROBLEMAS NA COMUNICACAO IF %ERRORLEVEL% == 3 Echo ERRO NOS PARÂMETROS PASSADOS IF %ERRORLEVEL% == 4 Echo ERRO IRRECUPERÁVEL NO PSTAC10 IF %ERRORLEVEL% == 5 Echo ERRO NA CHAMADA DO PSTAC10 b) SCRIPT PARA CHECAGEM, RECEPÇÃO E UNZIP DE ARQUIVO PSTAC10 v -DR382 -PNum.tmp IF %ERRORLEVEL% == 0 goto RECEBE IF %ERRORLEVEL% == 1 Echo NAO EXISTEM ARQUIVOS A RECEBER IF %ERRORLEVEL% == 2 Echo PROBLEMAS NA COMUNICACAO IF %ERRORLEVEL% == 3 Echo ERRO NOS ARGUMENTOS PASSADOS IF %ERRORLEVEL% == 4 Echo ERRO IRRECUPERÁVEL NO PSTAC10 IF %ERRORLEVEL% == 5 Echo ERRO NA CHAMADA DO PSTAC10 goto :EOF :RECEBE for /f "tokens=1,1" %%a in (Num.tmp) do SET NUM=%%a Echo PROTOCOLO %NUM% DISPONIVEL PARA RECEPCAO Del Num.tmp PSTAC10 r -dR382 -s -n%NUM% C:\Arquivos\R382.zip IF %ERRORLEVEL% == 0 ( Echo RECEBIDO O PROTOCOLO %NUM% goto UNZIPA ) IF %ERRORLEVEL% == 1 Echo RECEPCAO DO ARQUIVO BLOQUEADA IF %ERRORLEVEL% == 2 Echo PROBLEMAS NA COMUNICACAO IF %ERRORLEVEL% == 3 Echo ERRO NOS ARGUMENTOS PASSADOS IF %ERRORLEVEL% == 4 Echo ERRO IRRECUPERÁVEL NO PSTAC10 IF %ERRORLEVEL% == 5 Echo ERRO NA CHAMADA DO PSTAC10 goto :EOF :UNZIPA del C:\Arquivos\Recs\*.* /q PSTAC10 z -u C:\Arquivos\R382.zip C:\Arquivos\Recs c) SCRIPT PARA ENVIO DE UM ARQUIVO: PSTAC10 e -DR320 -PNumero.txt C:\ARQUIVOS\R320.xml IF %ERRORLEVEL% == 0 Echo VEJA PROTOCOLO EM Numero.txt IF %ERRORLEVEL% == 1 Echo ARQUIVO EM USO ou BLOQUEADO IF %ERRORLEVEL% == 2 Echo PROBLEMAS NA COMUNICACAO IF %ERRORLEVEL% == 3 Echo ERRO NOS ARGUMENTOS PASSADOS IF %ERRORLEVEL% == 4 Echo ERRO IRRECUPERÁVEL NO PSTAC10 IF %ERRORLEVEL% == 5 Echo ERRO NA CHAMADA DO PSTAC10 d) SCRIPT PARA PREPARAÇÃO E ENVIO DE UM ARQUIVO ZIPADO: PSTAC10 Z C:\ARQUIVOS\R320.zip C:\ARQUIVOS\R320.xml IF NOT %ERRORLEVEL% == 0 ( Echo ERRO NA COMPACTACAO DO ARQUIVO goto :EOF ) PSTAC10 e -DR320 -PNumero.txt -S C:\ARQUIVOS\R320.zip IF %ERRORLEVEL% == 0 Echo VEJA PROTOCOLO EM Numero.txt IF %ERRORLEVEL% == 1 Echo ARQUIVO EM USO ou BLOQUEADO IF %ERRORLEVEL% == 2 Echo PROBLEMAS NA COMUNICACAO IF %ERRORLEVEL% == 3 Echo ERRO NOS ARGUMENTOS PASSADOS IF %ERRORLEVEL% == 4 Echo ERRO IRRECUPERÁVEL NO PSTAC10 IF %ERRORLEVEL% == 5 Echo ERRO NA CHAMADA DO PSTAC10 3.3 USO DO PSTAC10 PARA GERAR RELAÇÃO DE PROTOCOLOS a) Essas opções equivalem à transação PSTA300 do Sisbacen Normalmente são retornados até 30 protocolos O primeiro registro do arquivo apresenta a data base Recomenda-se utilizar as opções -RA a -RG (item b) PSTAC10 r -R relacao.txt -L200502201600 Gera uma relação de transferências no arquivo relacao.txt Somente os protocolos atualizados até 16 horas de 2/2/2005 Se omitida a opção -L, são relacionadas os mais recentes Se usada a opção -F13 indica só protocolos não recebidos Se usada a opção -F19 indica os recebidos e por receber c) PSTAC10 r -R bacenjud.txt -d5312 -l Gera a relação de transferências no arquivo Bacenjud.txt Pega os protocolos do documento 5312 nas últimas 24 horas Se usada sozinha a opção L indica os últimos 1440 minutos As opções -D e -L podem ser combinadas d) PSTAC10 r -RP -n1234567 A1234567.txt Gera A1234567.txt com dados apenas do protocolo 1234567 Nesse caso é gravado um único registro no arquivo e) O arquivo gerado tem uma linha por protocolo, na forma: 001-008 = Número do protocolo 009-009 = 1-3 a receber, 5-7 recebido ou arquivo enviado Se em branco indica que não é arquivo a receber 8 indica um arquivo a receber que foi eliminado 010-014 = Código do documento 015-022 = Programa utilizado na transferência 023-026 = Versão do programa utilizado na transferência 027-034 = Layout do arquivo no Sysbacen (Ex. AJUD301) 035-042 = Protocolo que originou o arquivo (para respostas) 043-044 = Evento/situação atual da transferência 30 - Arquivo recebido no Banco Central e recusado 31 - Arquivo a receber pela instituição 35 - Arquivo recebido pela instituição financeira 50 - Arquivo recebido no Banco Central 67 - Arquivo enviado como teste de transmissão 71 - Arquivo recebido e aceito para processamento 81 - Arquivo recebido a processar na Intranet 82 - Arquivo em processamento na Intranet Bacen 98 - Arquivo descartado para recepção Outros códigos podem indicar erros ou pendências 045-054 = Instituição e dependência titular do arquivo 055-064 = Operador que enviou ou recebeu o arquivo 065-076 = Data e hora do último evento (AAAAMMDDHHMM) 077-088 = Final do nome do arquivo local (12 posições) 089-096 = CGC da instituição titular do arquivo enviado 097-100 = Quantidade de volumes recebidos 101-104 = Total de volumes em que o arquivo foi dividido 105-116 = Tamanho do arquivo (em bytes) 117-128 = Quantidade de bytes transferida (compactado) 129-129 = Meio de transmissão 9-PSTAW10 ou C10 8-PSTAW10 ou C10 (reservado) 7-PSTAW10 ou C10 em teste I-PSTAW10 ou C10 C-Connect Direct da Sterling 130-134 = Código auxiliar de situação ou erro 135-150 = Endereço IP do computador cliente 151-158 = Servidor do Bacen que tratou o arquivo 159-160 = Quantidade de eventos da transferência 161-162 = Primeiro evento da transferência, podendo ser: 17 - Protocolo reservado para disponibilização 25 - Protocolo reservado para disponibilização 51 - Arquivo enviado pela instituição ao Bacen 52 - Arquivo a ser recebido pela instituição 163-172 = Instituição que enviou ou preparou o arquivo 173-182 = Operador que enviou ou preparou o arquivo 183-194 = Data e hora do início do primeiro evento 195-226 = Observações quaisquer sobre o arquivo 227-256 = Nome da instituição titular do arquivo 257-326 = Descrição do código auxiliar de situação f) PSTAC10 r -RC resumo.txt Gera uma relação resumida de transferências em resumo.txt Contém os 30 protocolos com a atualização mais recente Pode ser usada a opção -L como no item "b" Se usada a opção -F13 indica só protocolos não recebidos g) O arquivo resumo tem uma linha por protocolo, na forma: 001-008 = Número do protocolo 009-009 = 1-3 a receber, 5-7 recebido ou arquivo enviado Se em branco indica que não é arquivo a receber A-G equivalem a 1-7 para arquivos muito antigos 010-014 = Código do documento 015-022 = Programa utilizado na transferência 023-026 = Versão do programa utilizado na transferência 027-034 = Layout do arquivo no Sysbacen (Ex. AJUD301) 035-036 = Evento/situação atual da transferência 30 - Arquivo recebido no Banco Central e recusado 31 - Arquivo a receber pela instituição 35 - Arquivo recebido pela instituição financeira 50 - Arquivo recebido no Banco Central 67 - Arquivo enviado como teste de transmissão 71 - Arquivo recebido e aceito para processamento 81 - Arquivo recebido a processar na Intranet 82 - Arquivo em processamento na Intranet Bacen 98 - Arquivo descartado para recepção Outros códigos podem indicar erros ou pendências 037-046 = Instituição e dependência titular do arquivo 047-058 = Data e hora do último evento (AAAAMMDDHHMM) 059-066 = CGC da instituição titular do arquivo enviado Substituído pelo protocolo origem com opção "-C" 067-078 = Tamanho original do arquivo (em bytes) 079-090 = Quantidade de bytes transferida (compactado) 091-091 = Meio de transmissão 9-PSTAW10 ou C10 8-PSTAW10 ou C10 (reservado) 7-PSTAW10 ou C10 em teste I-PSTAW10 ou C10 C-Connect Direct da Sterling 092-096 = Código auxiliar de situação ou erro 097-098 = Primeiro evento da transferência, podendo ser: 17 - Protocolo reservado para disponibilização 25 - Protocolo reservado para disponibilização 26 - Protocolo reservado para disponibilização 51 - Arquivo enviado pela instituição ao Bacen 52 - Arquivo a ser recebido pela instituição 099-110 = Data e hora do início do primeiro evento 111-122 = Final do nome do arquivo local (12 posições) 123-126 = Total de volumes em que o arquivo foi dividido Quantidade de eventos se indicada opção "-C" 127-130 = Campo interno de controle do BC (SIT) 131-160 = Nome da instituição titular conforme Sisbacen h) PSTAC10 r -RX detalhe.txt -n1024003 Recupera informações detalhadas sobre o protocolo 1024003 No primeiro registro são apresentados os dados principais Do segundo registro em diante são relacionados os eventos i) O registro inicial do protocolo tem o seguinte leiaute: 001-008 = Número do protocolo 009-009 = 1-3 a receber, 5-7 recebido ou arquivo enviado Se em branco indica que não é arquivo a receber 010-014 = Código do documento 015-022 = Programa utilizado na transferência 023-026 = Versão do programa utilizado na transferência 027-034 = Layout do arquivo no Sysbacen (Ex. AJUD301) 035-042 = Número do protocolo de origem (se houver) 043-044 = Evento/situação atual (vide relação em "e") 045-054 = Instituição e dependência titular do arquivo 055-064 = Operador que enviou ou recebeu o arquivo 065-076 = Data e hora do último evento (AAAAMMDDHHMM) 077-088 = Final do nome do arquivo local (12 posições) 089-096 = CGC da instituição titular do arquivo enviado 097-100 = Quantidade de volumes recebidos 101-104 = Total de volumes em que o arquivo foi dividido 105-116 = Tamanho do arquivo (em bytes) 117-128 = Quantidade de bytes transferida (compactado) 129-129 = Meio de transmissão (vide relação em "e") 130-134 = Código auxiliar de situação ou erro 135-150 = Endereço IP do computador cliente 151-158 = Servidor do Bacen que tratou o arquivo 159-190 = Observações quaisquer sobre o arquivo 191-194 = Campo interno de controle do BC (SIT) 195-234 = Hash SHA1 calculado do arquivo (em hexadecimal) 235-278 = Campo interno de controle do BC (DSN) 279-531 = Nome completo do arquivo no equipamento local 532-784 = Campo interno de controle do BC (PATH) 785-800 = Campo interno de controle do BC (RC/RS) 801-803 = Campo interno de controle do BC (QTE) 804-806 = Quantidade de eventos da transferência 807-822 = Campo interno de controle do BC (FTP) 823-852 = Nome da instituição titular do arquivo 853-922 = Descrição do código auxiliar de situação 923-930 = Primeiro protocolo de resposta 931-938 = Segundo protocolo de resposta (ou 99999999) j) Os registros seguintes do protocolo tem o seguinte leiaute: 001-002 = Código do evento (vide relações em "i") 003-014 = Data/hora do evento (AAAAMMDDHHMM) 015-024 = Instituição/dependência que comandou o evento 025-034 = Operador responsável ou que comandou o evento 035-050 = Descrição correspondente ao código do evento 3.4) RECOMENDAÇÕES IMPORTANTES SOBRE O USO - Para evitar sobrecarga dos servidores do PSTA estes limitam o atendimento das consultas aos protocolos disponíveis e/ou de suas relações ao máximo de 20 consultas por intervalo de 5 minutos para cada endereço IP e usuário do Sisbacen. Caso o operador efetue mais de 20 chamadas receberá uma mensagem "Excedido o limite permitido de conexões do cliente PSTA". - O programa PSTAC10 (assim como o PSTAW10) faz uso de vários arquivos de trabalho, no próprio diretório de instalação do programa (Ex. PSTAW10.ini, PSTAC10.log). É necessário que a execução do programa possa efetuar a gravação sobre a pasta onde estiver instalado. - As definições de novos documentos bem como de parâmetros em geral para execução dos aplicativos estão em um arquivo com opções de configuração, que deve ser periodicamente revisto no PSTAC10 com a chamada "PSTAC10 D -C". 3.5) SUGESTÕES DE USO PARA A MENSAGERIA SISBACEN (AMESxxx) - Os arquivos da mensageria SISBACEN são o AMES101 e AMES102, respectivamente para envio e recepção de mensagens do Banco Central (ou AMES111/112 no ambiente de homologação). Para o AMES102 a sua automatização com a tempestividade requerida, não é necessário o "bombardeio" muito frequente do servidor do PSTA. Devem ser considerados os limites do item anterior quanto ao intervalo mínimo de 15 segundos entre requisições de relações e/ou verificações. - Para automatização sugerem-se os seguintes passos: - PSTAC10 R -RD relacao.txt -AAMES102 -L10 -T100 O arquivo "relacao.txt" tem até 100 protocolos disponíveis São considerados somente protocolos dos últimos 10 minutos Se o horário não for de Brasília o programa não compensará - As relações são ordenadas por ordem inversa de data (LIFO) Caso se queira da mais antiga classificar na posição 65/12 - A seguir se aciona um script para baixar arquivo na forma: PSTAC10 R -AAMES102 -N O protocolo estará nas 8 primeiras posições de cada linha - Observe-se que a nova versão do PSTAC10 pode selecionar os documentos tanto por seu código (-D6102) como agora também pelo arquivo (-AAMES102) - Caso a instituição não apresente um fluxo médio de mais de 1 mensagem a cada 15 segundos, ao invés de uma relação com (-RD) pode ser simplesmente verificado um só protocolo: PSTAC10 V -AAMES102 protocolo.txt O arquivo "protocolo.txt" conterá o protocolo mais recente 4. CONSIDERAÇÕES SOBRE USUÁRIOS E SENHAS - Tanto o PSTAW10 como o PSTAC10 precisam de usuários e senhas válidos no ambiente Sisbacen. No PSTAW10 é solicitada a cada execução a identificação do usuário. No PSTAC10 é gravado um arquivo criptografado com esses dados, que é usado para cada operação posterior ao logon, dentro do limite de validade da senha. - A partir da versão 2.8.0.1 o PSTAC10 volta a permitir que os usuários e senhas sejam informados na própria operação sem o uso do arquivo (PSTAC10.cfh) gerado na operação de logon. Se for adotada esta opção, devem ser informados o usuário, pela opção -J e a senha pela opção -K. - Para operações automatizadas, podem ser cadastrados usuários de serviços, que são identificadores no Sisbacen que não têm CPF, e cujas senhas expiram com 360 dias, ao invés de senhas associadas a pessoas físicas, que duram normalmente 90 dias. - Os usuários de serviços são nominados na forma S-XXXXXXXX, e podem ser criados tantos quanto se queira ou apenas um único usuário, caso tudo seja automatizado em uma só rotina/local. - O cadastramento de usuários de Serviços deve ser feito pelos operadores masters do Sisbacen, através da transação PTRA700 daquele sistema, que já é normalmente utilizada tanto para o cadastramento de usuários como para autorizações desses para uso de transações ou serviços. Na PTRA700 deve ser utilizada a opção 1 (GERENCIA USUARIOS) e mais a subopção 7 (CREDENCIA USUARIO DE SERVIÇO). - É importante observar que para alguns documentos os usuários devem ser autorizados em outras transações/serviços, além da PSTA300, que é necessária para qualquer transmissão. - A partir da versão 2.5.0.3 do PSTAC10, pode ser testado se a senha vai expirar em até "d" dias, com a chamada "T -U -Dd". 5. SUGESTÕES PARA INTEGRAÇÃO COM OUTRAS PLATAFORMAS ------------------------------------------------ - Nas plataformas Intel com Linux, o uso do emulador Wine deve possibilitar o funcionamento do PSTAC10 normalmente. - Em outras plataformas Unix, que permitam compartilhamento de arquivos com plataformas Windows, podem ser usados processos ativados automaticamente com acionamento do PSTAC10 a partir da existência dos arquivos em diretórios pré-definidos. - Em plataformas tipo Mainframe, pode ser utilizado o FTP para as transferências de ou para os mesmos diretórios sugeridos, empregando-se de forma semelhante a sugestão anterior. - Quando os arquivos envolvidos são muito grandes pode ocorrer o acionamento do PSTAC10, antes da completa transferência do mesmo para o diretório base. De modo a contornar o problema, o PSTAC10 sempre tenta abrir os arquivos de forma exclusiva, retornando uma mensagem e errorlevel 1 caso não consiga. 6. CARACTERÍSTICAS TÉCNICAS E INFORMAÇÕES DE SUPORTE ------------------------------------------------- - O PSTAW10 e os demais programas com ele distribuídos poderão ser instalados em qualquer sistema operacional 32 ou 64 bits Microsoft-Windows, desde o NT/2000 até o Windows 7 e 2008. É possível rodar sob emulação de Windows para os ambientes que suportam, tais como algumas versões de Linux, que utilizam o emulador "Wine". É recomendável o uso de uma versão igual ou posterior ao Windows 2000, para viabilizar o uso dos scripts de automatização aqui sugeridos. - Os aplicativos PSTAW10/PSTAC10 usam criptografia assimétrica do padrão RSA com chave de 1024 bits para encriptar os dados principais e/ou sensíveis, tais como senhas e especificações dos documentos transmitidos. Usam ainda chaves simétricas de 192 bits (3DES/CBC) para a cifragem de arquivos propriamente ditos, geradas aleatoriamente para cada documento enviado ou recebido. - Para o envio e recepção de arquivos grandes, tanto o PSTAW10 como o PSTAC10 podem dividir a transferência em volumes, que possibilitm retomar o processo do último volume trafegado (o tradicional "restart/recovery"). Qualquer arquivo enviado ou recebido por volumes não será comprimido (zipado) para a sua transmissão. É definido como máximo dos volumes o tamanho de 999,99 Mega Bytes, que pode ser reduzido para qualquer outro tamanho. Isto se torna útil quando se verificam problemas de velocidade, ou ainda quedas ou interrupções nas conexões. - Para a transmissão via Internet, o computador deve estar li- gado à rede de alguma forma, seja pela discagem, via DialUp, ou RAS no caso do Windows-NT, pela conexão em banda larga ou em rede privada que esteja conectada à rede mundial. - Para os casos de conexão direta em que a Instituição utilize tecnologia de "firewall" (caso mais comum para redes ligadas diretamente à Internet), deverão ser liberadas as conexões à porta 1024 do protocolo TCP, para os equipamentos servidores do Banco, nomeados "psta.bcb.gov.br" que têm os endereços IP "200.218.208.91" e "200.218.209.91" (mecanismo round robin). Não é necessária a abertura de conexões internas à rede, mas apenas permitir a conexão ao servidor externo, mesmo que via NAT (Network Address Translation). - O protocolo de comunicação do PSTAW10 com os seus servidores é totalmente particular, não sendo possível a utilização dos "proxies" de Internet, por não se tratar de HTTP ou qualquer outro protocolo conhecido. - Para desinstalar o programa (retirar do microcomputador) de- ve ser usado o método próprio do ambiente Windows - a rotina "Meu Computador-Painel de Controle-Adicionar/Remover Progra- mas". Antes da desinstalação, deverá ser acionado o processo de eliminação de arquivos/relações no menu opções/eliminação de arquivos, para a remoção dos eventuais arquivos que foram criados após a instalação. - Erros de conexão a equipamentos servidores do Bacen decorrem normalmente de configurações específicas de redes, que podem ser adaptadas às necessidades do PSTAW10. Nesses casos, deve o próprio suporte técnico de redes da Instituição ou Usuário resolver os eventuais problemas, já que este normalmente tem a visão do seu ambiente. - Dúvidas em geral podem ser sanadas pelo Atendimento Sisbacen através do telefone (61)3414-2156. - Outros questionamentos técnicos específicos do funcionamento do PSTAW10 e PSTAC10 também podem ser encaminhados ao e-mail institucional "psta@bcb.gov.br". Recomenda-se que seja usado este e-mail apenas pelo pessoal de suporte técnico local dos usuários, especialmente nos casos de transferências de dados muito lentas, não completadas e/ou obtidas. As dúvidas sobre os objetivos e modos de preparação dos arquivos, ou ainda da utilização básica do programa não podem ser esclarecidas por este canal. Recomenda-se uma leitura atenta deste documento, antes de se lançarem dúvidas sobre o aplicativo. 7. COMENTÁRIOS SOBRE A ÚLTIMAS VERSÔES ----------------------------------- - O presente item descreve as modificações mais importantes da versão 2.8.0.1, discutindo alguns aspectos de seu uso e boas práticas no uso dos programas PSTAW10 e PSTAC10. - A versão 2.8.0.2 corige um problema de verificação das datas de expiração das senhas e diminui o tamanho máximo dos dados transmitidos por volume. Ela reduz de 2,1 Giga para 999 Mega bytes o tamanho máximo de um volume. Para efeito de envio ou recepção um arquivo pode ser dividido em até 9000 volumes, o que propicia a retomada de transmissões com o aproveitamento do que foi transmitido em volumes anteriores. - Pode ser pesquisado um protocolo de resposta, indicando-se o número do original com "PSTAC10 V -D -N -P", onde "orig" é o protocolo de origem. Embora já descrita pelo texto de ajuda - "PSTAC10 H R" - das versões anteriores esta opção apresentava problemas em alguns casos. - A principal novidade desta versão é quanto ao tratamento das relações de protocolos obtidas no PSTAC10. A opção "-L" pode indicar tanto uma data limite superior, por default a atual, como uma quantidade de minutos, que é assumida 1440 (1 dia), se simplesmente indicada a opção "-L", que pede a relação de todos os protocolos de 24 horas atrás do horário do micro ao mais recente registrado. Por exemplo, poderia ser indicada a opção "-L201107202359" para recuperar protocolos atualizados até as 23:59 do dia 20/07/2011. A opção "-L2011072023591439" indica protocolos compreendidos entre 00:00 e 23:59 horas do dia 20/07/2011. - No caso de uso da opção -L, ou com intervalos menores do que um dia (1440 minutos), pode ser acrescida a opção -T sozinha indicando ao invés dos 30 documentos o máximo permitido pelo sistema. Hoje isto equivale a -T100. - Vale lembrar que no caso de todas as relações pode-se usar a opção -T, indicando a quantidade máxima de protocolos a serem recuperados. Se nada for indicado são assumidos até 30 protocolos, e a quantidade máxima tanto indicada como obtida no caso anterior, hoje é de 100 registros. Esses números são periodicamente revistos, em função do consumo de recursos da infraestrutura que suporta o sistema PSTA. - Com a mesma justificativa de balancear funcionalidades com o consumo de recursos, foram alterados recentemente os limites de conexões para pesquisa de protocolos a receber ou para as relações de protocolos, que evoluiram de até 6 execuções nos últimos 5 minutos, para até 21 nos mesmos 5 minutos. - De qualquer modo, a consulta em intervalos muito curtos deve ser feita criteriosamente pelas instituições, somente quando forem efetivamente necessários. Os excessos de consultas sem resposta positiva serão mapeados, e eventualmente informados aos usuários. - É preferível o uso das opções "-RC" ou "-RD" respectivamente em lugar de "-R1" ou "-R2". O número do protocolo original é agora recuperado com o acréscimo da opção "-C", com anotação do protocolo de origem nas posições 059/066, e da quantidade de eventos nas posições 123-126, respectivamente em lugar do CGC da instituição e da quantiade de volumes transmitidos. - As relações dos protocolos a receber ("R -RD" ou "R -R1") só recuperam por padrão arquivos que não foram baixados. Para a recuperação de todos os protocolos a receber ou já recebidos pode ser acrescentada uma opção "-F17" ao comando "R -RD" ou mesmo ao "R -RC" (rol dos protocolos da instituição). - No PSTAC10 pode-se agora indicar o documento pelo respectivo código de arquivo, com a opção "-A", ao invés de se indicar "-D". Assim, tanto faz usar "-D6111" como "-AAMES111" no envio de um arquivo do tipo AMES111. - De maneira análoga, no PSTAW10 também pode ser configurada a exibição das relações de códigos na ordem dos arquivos antes dos documentos, com o menu "Opções/configuração do programa" na opção de tratamento "Indica arquivo antes do documento". - A partir da versão 2.7.0.1 não foi mais possível a indicação de usuário e senha fora da rotina de logon. O problema é que as opções "-U" e "-S" têm outras finalidades nas demais rotinas. Caso se queira indicar tempestivamente o usuário e senha podem ser usadas as opções "-J" e "-K", para que esses valores se sopreponham aos de um eventual logon em uma passagem anterior do PSTAC10.