segunda-feira, 17 de outubro de 2011

Sistema Câmbio: Explicações de uso do PSTAC10

Vale reforçar que devem ser utilizadas preferencialmente as opções PSTAC10 R -RC (lista de protocolos), -RD (protocolos a receber) ou -RH (protocolos resposta), para as quais valem as observações abaixo:

 

a) As opções -RC (ou -RD) podem recuperar o protocolo origem, se indicada a opção -C, o que provoca o protocolo ser relacionado em lugar do CNPJ (item 3.3.g do arquivo Leiame.txt do PSTAW10);

b) A opção -L (item 3.3.b do Leiame.txt)  pode indicar uma data limite superior ou uma quantidade de minutos. Se indicado apenas -L equivale a -L1440, isto é, de agora até um dia atrás;

c) Se indicado -Laaaammdd23591439 indica que sejam relacionados todos os protocolos que foram atualizados em "aaaammdd", no período de 23:59 até 1439 minutos antes (0:00 hora);

d) Para a confecção de relações dependendo da indicação do parâmetro "-T", são tomados limites, que eventualmente podem mudar (dependendo das necessidades):

     1) Até 30 protocolos para qualquer opção R -Rx, se não indicado o parâmetro -T;

     2) Até "x" ou 100 protocolos (se "x" maior que 100), se indicado um valor "x" com o parâmetro -T;

     3) Até 100 protocolos se indicada a opção "-T" simplesmente;

     4) O valor 100 aumenta para 10.000 protocolos se também usada a opção descrita em "c", isto é, se for estipulado um limite de datas no mesmo dia;

e) Para as relações de arquivos a receber (R -RD), podemos ter as seguintes opções:

    1) Somente os arquivos que não foram recebidos (padrão), que equivale à opção -F13;

    2) Somente os arquivos já recebidos, se indicada a opções -F57 nas relações;

    3) Os arquivos recebidos e a receber, se indicado -F17 nas relações (pouco recomendado para muitas consultas);

f) Para se retornar um protocolo já recebido à condição de a receber, pode ser comandado PSTAC10 D -R -Nprotocolo -Ddocmto;

 

  Embora não tenha sido objeto de discussão na reunião, gostaria de fazer algumas ponderações sobre logons e identificações para o PSTAC10.

 

a) O critério padrão que o sistema usa é o de se efetuar o logon somente nas trocas de senhas/usuários ou nas atualizações de equipamentos ou versões do programa. Na verdade, tanto a partir de linha de comando (PSTAC10 L -u -s), como na execução do PSTAW10 (logon valendo para o PSTAC10), o sistema grava um arquivo com as credenciais do usuário (PSTAC10.cfh), com um processo de cifragem própria;

b) A existência do arquivo PSTAC10.cfh permite que as novas execuções do PSTAC10 aproveitem as credenciais.  A opção PSTAC10 L -u (logout) apaga esse arquivo, exigindo novos logons;

c) Como o processo de logon é lento, não é recomendável  que seja repetido para cada transmissão. Para os que entendem ser mais seguro o PSTAC10 não persistir o arquivo de logon, já que não podem restringir o acesso indevido às estações, podem ser utilizados dois processos:

  1) Gravar o PSTAC10.cfh em algum local "de sua confiança", e retorná-lo antes de cada comando, apagando-o após cada operação; ou

 2) Adicionar aos comandos as opções -J<operador > -K<senha>, ao invés de um PSTAC10 L antes de cada operação (vide arquivo Leiame.txt item 4);

 

  Alguns exemplos do que falei, considerando por hipótese que o código da instituição é 84999, dependência 0510, usuário S-PSTA e sua senha MINHAPSW:

 

a) PSTAC10 L -u849990510.S-PSTA -sMINHAPSW

    Efetua um logon, o que recomendo fazer no máximo uma vez por dia (o ideal é uma vez por ano ou na mudança de senha/versão/máquina);

b) PSTAC10 R -RD -C -L2011101323591439 -T -F57 Relacao1.txt

    Recupera no arquivo "Relacao1.txt"  até 10.000 protocolos que foram recebidos entre 0:00 e 23:50 horas do dia 13/10/2011 (por favor não façam isto mais do que duas vezes por dia);

c) PSTAC10 R -RC -C -L2011100723591439 -T Relacao2.txt

   Recupera no arquivo "Relacao2.txt" até 10.000 protocolos enviados, a receber ou já recebidos no período de 0:00 às 23:59 horas do dia 7/10/2011 (mesma recomendação que o anterior);

d) PSTAC10 R -RD -C -L20111014140010 -T -D6102 Relacao3.txt

   Recupera em "Relacao3.txt" até 10.000 protocolos a receber, tratados entre 13:50 e 14:00 horas do dia 14/10/2011 (se aplicação souber tratar os horários, seria o ideal de busca);

e) PSTAC10 D -R -N01234567 -d6102

  Recoloca o protocolo 01234567 na condição de a receber. Para efeito de datas, a data dessa operação passará a ser considerada (e não mais a da disponibilização do protocolo);

f) PSTAC10 R -RD -D6102 -F17 -C -T Relacao4.txt

  Recupera no arquivo "Relacao4.txt" até 100 protocolos recebidos ou a receber relativos ao documento 6102;

g) PSTAC10 R -RD -AAMES102 -F17 -C -T Relacao4.txt

  Idêntico ao anterior. É uma outra forma de se selecionar o documento (pode ser pelo código do arquivo);

 

Sobre o limite de 10.000, ele na verdade é um limite máximo de protocolos tratáveis ou pesquisados, para impedir que uma única consulta demore demais. Por este motivo, não adianta anexar a opção de continuação (-Nprotocolo) que eu havia indicado na reunião, já que os protocolos antes do indicado, apesar de não serem relacionados, serão tratados também. Caso o número 10.000 se configure indevido (o total diário de todas as IFs ainda não superou 60.000), posteriormente veremos como proceder.

 

Vale lembrar que é recomendável o uso da versão 2.8.0.2 (a última) do PSTAW10/C10. A maioria dos comandos aqui referenciados não funciona com versões anteriores à 2.8.0.1. O arquivo Leiame.txt pode ser visto tanto na versão atual como na anterior. A única coisa nova, que não pretendo colocar no "Leiame.txt", é o tratamento dos 10.000 protocolos (implementado ontem) quando for usada uma única data de referência. Qualquer dúvida ou eventual imprecisão nos comandos aqui mencionados, por favor escrevam para o e-mail que lhes remete esta mensagem (psta@bcb.gov.br).

 

Nenhum comentário: