APRESENTAO DOS APLICATIVOS PSTAW10 e PSTAC10 - 05/09/2011 ===========================================================

1. INTRODUO ----------

- A funo principal desses aplicativos prover o intercmbio de informaes (documentos digitais) entre o Banco Central e Instituies Financeiras (ou outras instituies) de maneira padronizada e segura, usando-se a CIFRAGEM DE DADOS, atravs de conexes na Internet ou em algumas redes privadas que tm conexo rede do Banco Central (RTM e RSFN).

- O PSTAW10 no se destina preparao de ARQUIVOS, tarefa de reponsabilidade das Instituies, e/ou de outros aplicativos distribudos pelo Banco, especficos para cada documento.

- Para fazer uso do PSTAW10, o operador deve ser cadastrado no Sistema de Informaes Banco Central - SISBACEN, estando ali autorizado na transao PSTA300. Para certos documentos pode ainda ser necessria a autorizao em outro servio, de modo a garantir maior segurana no envio e busca das informaes. - 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 transferncias so todas feitas com uma cifragem dos arquivos a enviar ou a receber, em grande parte das vezes precedida por um processo de compresso.

- Os arquivos identificados como "zipados" (com padro interno usado na extenso .zip) normalmente so transmitidos sem que o programa efetue compresso adicional, de modo a agilizar o procedimento de envio ou recepo.

- Alm do PSTAW10 tambm fornecido o aplicativo PSTAC10, que se destina a automatizar os processos de envio e recepo de arquivos de/para o Banco Central. O PSTAC10 pode ser chamado a partir de scripts que efetuam as aes necessrias para as transferncias.

- As instrues e comentrios presentes neste texto se aplicam s verses iguais ou posteriores 2.8.0.1 dos programas. As verses anteriores podem no implementar muitos dos comandos e comportamentos aqui descritos.

2. INSTRUES BSICAS DE USO DO PSTAW10 ------------------------------------

2.1 - PARA ENVIO DE ARQUIVOS AO BANCO CENTRAL

- Identificar-se como no terminal ou em aplicaes do SISBACEN informando o cdigo da Instituio, seguido imediatamente do da Dependncia (caso de Instituies com cdigo numrico), a identificao do Operador e a Senha;

- Escolher na barra de menu a opo "TRANSMISSO/Envia Arquivo pela pela Internet";

- Aps a seleo de um cdigo de documento e do arquivo que se deseja enviar o arquivo compactado ("zipado"), caso j no tenha a terminao ".zip" e ento procedida a sua cifragem em um diretrio temporrio. Assim o arquivo est pronto para o envio. estabelecida a conexo atravs da Internet com um equipamento servidor do Banco Central, para a transmisso ao ambiente computacional do Banco;

- Aps a transferncia ser efetuada sem problemas ser exibida uma tela com o nmero do PROTOCOLO;

- A validade do arquivo para o SISBACEN ser aferida apenas em operaes especficas que podero incluir a disponibilizao de um arquivo-resposta. Existem sistemticas diferentes, que variam de acordo com o documento enviado.

- A opo de envio, alm da cifragem, eventualmente pode fazer a validao do "layout" do arquivo/documento de entrada, com a conferncia do comprimento de registros e de alguns outros aspectos relevantes na identificao do documento, caso haja um "layout" definido.

2.2 - PARA RECEBIMENTO DE ARQUIVOS

- Aps a identificao da instituio e operador no SISBACEN o PSTAW10 poder indicar a existncia de arquivos a receber;

- Alm da indicao pelo programa pode ser selecionada a opo de Menu "RECEPO/Relao dos Arquivos a Receber", de modo a ser apresentada a relao dos arquivos que esto disponveis para a recepo (DOWNLOAD) pela Instituio identificada;

- Aps exibida a relao deve-se indicar o arquivo (PROTOCOLO) desejado preenchendo o seu nome (localizao no computador). Ao final do "DOWNLOAD" ser exibida uma mensagem confirmando o trmino bem sucedido do processo.

2.3 - INFORMAES ADICIONAIS PARA O USO

- Pode ser utilizada somente a opo de verificao de formato do arquivo, para checar a validade do mesmo. Esta opo deve ser usada tanto para checar a validade como para minimizar o tempo de conexo Internet, no caso das conexes discadas.

3. APLICATIVO PSTAC10 ------------------

- Juntamente com o PSTAW10 distribudo o programa PSTAC10, o qual apresenta todas as suas funcionalidades usando linha de comando (modo console).

- Este programa pode viabilizar uma automatizao de processos relativos ao envio, verificao da eventual disponibilidade, e recepo dos arquivos, por parte das instituies.

- A sua utilizao 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 varivel com o retorno de chamadas (%ERRORLEVEL%) permite que seja aferido o sucesso do envio, da recepo, ou ainda a existncia de arquivos a receber.

- Para relacionar as diversas opes 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 opes podem ser digitadas em maisculas ou minsculas, sem distino de significado. Caso seja necessrio agregar alguma informao adicional letra, esta deve vir logo aps a mesma, sem espaos.

- Deve ser evitado o uso de espaos em nomes de arquivos ou em observaes, uma vez que o espao normalmente usado como o elemento de separao entre argumentos. Caso seja necessrio o uso, envolver todo o campo entre aspas (").

- O PSTAC10 pode ser usado tambm para descompactar um arquivo ".zip" recebido, para preparar um arquivo ".zip" para envio, para tratar arquivos com informaes de auditoria (Logs), ou ainda conferir ou calcular o hash SHA1 dos arquivos tratados pelo sistema.

- Em cada execuo setado o parmetro de scripts errorlevel, que pode assumir os seguintes valores: 0 - Indica a operao OK ou que existe um arquivo a receber 1 - Indica que no h arquivo disponvel para o recebimento Indica que a senha no expira no prazo de dias indicado Indica que o PSTAC10 no abriu exclusivamente o arquivo Indica que o envio/recepo do arquivo esto bloqueados Indica que no h arquivos selecionveis para a relao 2 - Resultado do processamento invlido conforme a mensagem 3 - Parmetros de chamada incorretos ou arquivo inexistente Indica tambm erro na cifragem ou preparao de arquivo 4 - Erro crtico na execuo demandando uma nova instalao Indica ainda a impossibilidade de execuo pelo Windows 5 - Parmetros 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 usurio FULANO com a senha XPTO1234 Esse usurio pertence Instituio 84001 dependncia 8901 No h necessidade de logon para cada operao do programa Deve-se usar se mudar o endereo IP ou a verso do PSTAC10 necessrio tambm 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 usurio FULANO de "senha1" para "senha2" Esta opo necessria no mnimo a cada 89 dias corridos Para os usurios de servios o prazo limite de 359 dias Pode ser evitada com logon no PSTAW10 valendo no PSTAC10

c) PSTAC10 L -u Equivale a uma operao de LOGOUT apagando as credenciais Aps esta opo ser necessrio um novo LOGON

d) PSTAC10 T -u -d8 Testa se a senha SISBACEN vai expirar nos prximos 8 dias Se a senha no 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 espaos 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 observao conter a expresso "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 opo "-S" indica para no ser comprimido para o envio Esta opo 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 nmero 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 nmero contido no arquivo Numprot.txt Grava o arquivo recebido como C:\Zips\R002.zip Deve ser usada para baixar arquivos que j esto zipados Mesmo se no indicada o programa no compacta arquivos zip

m) PSTAC10 Z -U C:\Zips\R382.zip C:\Recs Descompacta o contedo 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 contedo 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 opes para envio de arquivos

q) PSTAC10 H R Exibe as diversas opes para recepo/relao de arquivos

- A nomenclatura d