Manual STCPRen 21/09/2007, Riversoft Integração e Desenvolvimento

Transcrição

1 STCPRen Versão Riversoft Integração e Desenvolvimento de Software Ltda Av.Dr.Delfim Moreira, 537 Centro Santa Rita do Sapucaí, Minas Gerais CEP Tel/Fax: riversoft@riversoft.com.br Suporte: suporte@riversoft.com.br Web:

2 Conteúdo 1. INTRODUÇÃO O QUE É O STCPREN? CARACTERÍSTICAS GERAIS REQUISITOS DE SOFTWARE E HARDWARE INSTALAÇÃO UTILIZAÇÃO MODOS DE OPERAÇÃO E OPÇÕES DE EXECUÇÃO FORMAÇÃO DO NOVO NOME DO DIRETÓRIO E DO ARQUIVO VARIÁVIES INTERNAS REGISTRO DE LOG DOS EVENTOS CONFIGURAÇÃO COMO ADICIONAR OU CRIAR UM ARQUIVO DE CONFIGURAÇÃO DE REGRAS COMO ALTERAR OS PARÂMETROS DE CONFIGURAÇÃO DO ARQUIVO DE REGRAS COMO CRIAR E MODIFICAR AS REGRAS DE VALIDAÇÃO DOS NOMES DE ARQUIVOS EXECUÇÃO LINHA DE COMANDO CÓDIGOS DE EVENTOS CÓDIGOS DE EVENTOS GERADOS NO ARQUIVO DE MENSAGENS GLOSSÁRIO REFERÊNCIAS LICENÇA

3 1. Introdução 1.1. O que é o STCPRen? O STCPRen é uma aplicação que possibilita o renomeio e cópia de arquivos, varredura em diretórios e execução de processo, baseado na configuração de regras de validação dos nomes destes arquivos. O STCPRen pode ser utilizado na integração do STCP OFTP Server ou STCP OFTP Client com diferentes outras aplicações (ERPs, EDI, etc...) de forma simples e direta. No cenário apresentado abaixo, mostramos a integração da estrutura de diretórios de transferência do STCP OFTP Client com a de incorporação e geração de arquivos financeiros de um sistema de ERP. C:\STCPCLT Arquivo de configuração de regras C:\ERP <PERFIL> ENTRADA SAIDA STCPRen RETORNO REMESSA Figura 1 - Integração STCP OFTP Client x ERP As regras de validação e das ações (renomeio, cópia, backup, etc) deverão ser armazenadas em um ou mais arquivos de configuração Características Gerais Renomeio de arquivo(s) Cópia para múltiplos diretórios Conversão de formato texto (Unix/Dos) Validação do nome do arquivo por expressão regular Remoção do arquivo por data do último acesso Execução de processo (.BAT,.EXE, etc...) Registro de log das ações realizadas Geração de timestamp com data e hora do computador ou do arquivo Mapeamento dinâmico de recursos de rede Varredura de diretório e subdiretório Validação de diretório por expressão regular Conversão maiúscula e minúscula do nome do arquivo - 3 -

4 2. Requisitos de software e hardware Microcomputador Pentium ou superior Memória de 64 Mbytes ou superior Espaço no disco rígido de 5 Mbytes Drive de CD-ROM Sistema operacional Windows 2000/2003/XP/VISTA 3. Instalação 3.1. Insira o CD na unidade de leitura Em Iniciar, escolha a opção Executar Utilize o botão Procurar para acessar a unidade de leitura de CD Selecione o programa SETUP.EXE Execute o programa

5 4. Utilização 4.1. Modos de operação e opções de execução O STCPRen é uma aplicação (.EXE) que pode ser executada diretamente na linha de comando do sistema operacional, através do agendador de tarefas ou por outras aplicações: STCP OFTP Server ou Client, TWS*, etc. O STCPRen possui quatro modos de operação distintos e a seleção será realizada através da linha de comando, são eles: Modo Arquivo específico Lista de arquivos Varredura de um diretório específico Varredura de uma lista de diretórios Linha de Comando Stcpren_3_2.exe rules <nome do arquivo de regras> <nome do arquivo específico> Stcpren_3_2.exe rules <nome do arquivo de regras> -filelist <nome do arquivo de lista> Stcpren_3_2.exe rules <nome do arquivo de regras> -scan <nome do diretório> Stcpren_3_2.exe rules <nome do arquivo de regras> -dirlist <nome do arquivo de lista> Quando o modo de varredura é utilizado, a opção -subdir habilita a procura nos subdiretórios Formação do novo nome do diretório e do arquivo Quando o STCPRen localiza um arquivo, separa o nome do diretório do nome do arquivo e possibilita a utilização destas informações pelas regras de substituição (Figura 2). Nome do Arquivo Completo (C:\TEMP\EXEMPLO.TXT) Nome do Diretório (C:\TEMP) Nome do Arquivo (EXEMPLO.TXT) Figura 2 - Separação do nome do arquivo - 5 -

6 A seleção das informações para formar um novo nome de diretório e de arquivo nas ações de Cópia e ou de Backup serão configuradas através das regras de substituição (Figura 3). Nome do Diretório Nome do Arquivo Variáveis Timestamp (YYYYMMDDhhmmssnnn Regras de Substituições Nome Novo do Diretório Expressão regular Figura 3 - Formação do nome novo do diretório Nome do Diretório Nome do Arquivo Variáveis Timestamp (YYYYMMDDhhmmssnnn Número Seqüencial Regras de Substituições Nome Novo do Arquivo Conteúdo do Arquivo Expressão Regular Figura 4 Formação do nome novo do arquivo - 6 -

7 4.3. Variávies internas O STCPRen possui um conjunto de variáveis internas que poderão ser utilizadas nas opções de configuração: ExeProgBefore, ExecProgAfter, ExecProgError, CheckLockUnlockFileName, CreateLockUnlockFileName, etc... Variável $FILENEWNAME $FILEOLDNAME $PATHNEWNAME $PATHOLDNAME $NEWNAME $OLDNAME $NEW2NAME $OLD2NAME $FILESIZE $TIMESTAMP Novo nome do arquivo com o diretório (após as substituições). Nome original do arquivo com o diretório. Nome novo do diretório (após as substituições). Nome original do diretório. Nome novo do arquivo. Nome do arquivo original. Novo nome do arquivo (após as substituições) sem a extensão. Nome do arquivo original sem a extensão. Tamanho do arquivo em bytes. Timestamp no formato: YYYYMMDDhhmmssnnn YYYY = ano MM = mês DD = dia hh = hora (formato 24h) mm = minuto ss = segundos nnn = milésimos de segundos $RULENAME $DESC $ERROR Nome da regra executada da regra Último código de erro $VAR0 até $VAR9 Variáveis utilizadas na linha de comando var0 até var9. $SRCUSER $DSTUSER Identificação de origem Identificação de destino - 7 -

8 4.4. Registro de Log dos Eventos O STCPRen irá registrar as ações executadas em um arquivo diário de log dos eventos contendo: data e hora, nome do arquivo original, novo nome do arquivo, etc. Os dados poderão ser armazenados em arquivo texto ou banco de dados. STCPRen Log de Eventos Figura 5 - Registro do Log de Eventos - 8 -

9 5. Configuração A configuração das regras de validação do nome de arquivo e as ações executadas pelo STCPRen podem ser criadas com o auxílio do programa STCPRenCfg.EXE ou de um editor de texto, por exemplo, NOTEPAD.EXE. Este capítulo demonstra como utilizar o programa STCPRenCfg.EXE para criar ou editar o arquivo de configuração de regras Como adicionar ou criar um arquivo de configuração de regras Acesse a pasta de instalação do STCPRen e execute o programa STCPRenCfg.exe Clique no botão Adicionar para selecionar o arquivo de configuração ou criar um novo

10 Clique no botão indicado para localizar o arquivo Para criar um novo arquivo, digite um novo nome e clique no botão Abrir

11 Clique no botão OK para adicionar ou criar o arquivo de configuração de regras Caso o arquivo de configuração não exista, uma janela de aviso será apresentada, clique no botão Sim para confirmar

12 5.2. Como alterar os parâmetros de configuração do arquivo de regras Selecione o arquivo de configuração desejado e clique no botão Propriedades

13 Na guia Geral, configure os parâmetros desejados. ScanDir Parâmetro Define o nome do diretório para varredura. Obs.: Este parâmetro será utilizado somente se a opção scan for definida na linha de comando do STCPRen. ScanDirRegEx Define uma expressão regular para validar os subdiretórios que serão processados na varredura. ScanDirRegExNeg ScanLockSem Define uma expressão regular para validar os diretórios que não serão excluídos da varredura. Define um nome de semáfora para sincronização do modo de varredura. Obs.: Utilizado para sincronizar a execução de múltiplos processos do STCPREN. Válido somente com o uso da opção -scan

14 ScanFirstRule ScanSubDir Define a primeira regra de validação do nome do arquivo a ser executada. Define os subdiretórios que devem ser verificados. 0 = Não 1 = Sim ScanCheckFileInUse Habilita/desabilita a verificação se o arquivo está em uso. 0 = Não 1 = Sim MaxRetries DelayRetry LogErrorOption Define o número de tentativas a serem realizadas antes de abandonar a operação (cópia, criação de diretório e apagar). Define o tempo de espera (em milisegundos) antes de realizar uma nova tentativa de operação (cópia, criação de diretório e apagar). Define a opção de registro dos eventos de falha na localização de um diretório ou arquivo. 0 = Não registra 1 = Registra se o arquivo não existir 2 = Registra se o diretório não existir 3 = Registra se arquivo ou diretório não existirem

15 Na guia Acesso é possível configurar os parâmetros para utilização de um compartilhamento de rede. Parâmetro LocalName RemoteName UserName UserPswd Confirmar Define o nome do recurso local (não é obrigatório). Define o nome do recurso de rede para ter acesso. Define o nome do usuário para acesso ao recurso. Define a senha do usuário para acesso ao recurso. Confirma a senha digitada anteriormente

16 Na guia Log é possível configurar os parâmetros para gravação dos registros de eventos de execução do STCPRen. Parâmetro LogIni LogLevelOnSucess LogLevelOnInfo Define o nome do arquivo contendo as diretivas de log. Define o nível de log dos eventos de sucesso da aplicação. Define o nível de log dos eventos de informação da aplicação. LogLevelOnWarning Define o nível de log dos eventos de alerta da aplicação. LogLevelOnError Define o nível de log dos eventos de erro da aplicação. MessageFile Define o diretório para criação do arquivo de mensagem geral. MessageFileUser Define o diretório para criação do arquivo de mensagem do usuário

17 Verbose UserLog Define o nível de informação a ser armazenada. Define se as mensagens serão geradas por usuário: 0 = Log geral 1 = Log por usuário

18 Na guia Variáveis, você pode definir regras de substituição dos valores informados nas variáveis ( var0 à var9) utilizados na linha de comando do STCPRen

19 Clique no botão Adicionar para configurar uma nova regra de substituição dos valores de uma variável

20 Configure os parâmetros da regra de substituição e clique no botão OK para salvar. $Var Parâmetro Define a identificação da variável que será utilizada. Valor: 0 a 9. Ocorrência Define a seqüência de execução da substituição. Valor: 0 a 999 Define o nome da regra de substituição. RegExReplaceFrom Define a expressão regular para selecionar o que será substituído. RegExReplaceTo Define o valor para substituição. RegExReplaceOcorr Define a quantidade de repetições da substituição: 0 = Todas

21 Na guia Listas, você pode substituir as linhas do arquivo pelos valores das variáveis (-var0 à -var9) ou através de uma expressão regular criando regras de substituição. O arquivo de lista pode conter nomes de diretórios ou arquivos que serão processados. As regras de substituição serão aplicadas às linhas do arquivo

22 Clique no botão Adicionar para configurar uma nova regra de substituição através de uma variável

23 Configure os parâmetros da regra de substituição e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução da substituição. Valor: 0 a 999 Define o nome da regra de substituição. VarReplaceFileNamePosFrom Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) a partir da posição de origem definida. VarReplaceFileNamePosTo VarReplaceFileNameLen VarReplaceFileNameValue Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) para a posição de destino definida. Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) com o tamanho definido. Define o valor da variável quando não for informado na linha de comando (-varn)

24 Clique no botão Adicionar para configurar uma nova regra de substituição através de uma expressão regular

25 Configure os parâmetros da regra de substituição e clique no botão OK para salvar. Parâmetro Ocorrência Define a seqüência de execução da substituição. Valor: 0 a 999 RegExReplaceFrom RegExReplaceTo RegExReplaceOcorr Define o nome da regra de substituição. Define a expressão regular para selecionar os dados que serão substituídos. Define o valor para substituição. Define a quantidade de repetições da substituição: 0 = Todas

26 5.3. Como criar e modificar as Regras de Validação dos nomes de arquivos Na guia Regras de Validação, clique no botão Adicionar para criar uma nova regra ou selecione uma regra e clique no botão Propriedades para modificá-la

27 Clique no botão Adicionar para criar uma nova regra

28 Configure a identificação da regra e clique no botão OK para salvar. Regra Nome Parâmetro Define o número da regra (ordem de execução). Define o nome da regra

29 Selecione uma regra e clique no botão Propriedades para modificar os seus parâmetros. Para mudar o número da regra (ordem de execução), selecione-a e pressione o botão ou

30 Na guia Geral, configure os parâmetros de identificação da regra, validação do arquivo e outos: Parâmetro Regra Nome DirRegEx FileRegEx Define o número da regra (ordem de execução). Define o nome da regra. Define a expressão regular para validar o nome do diretório. Define a expressão regular para validar o nome do arquivo

31 SrcRegEx Description ExecProgBefore ExecProgAfter ExecProgError DestinationUser SourceUser NextSection RemoveAfterCopy Define a expressão regular para validar o nome do usuário de origem (opção src da linha de comando). Define a descrição da regra. Define o nome do programa ou batch que deve ser executado antes de processar o arquivo. Define o nome do programa ou batch que deve ser executado após processar o arquivo. Define o nome do programa ou batch que deve ser executado quando ocorrer um erro. Nome do usuário/módulo de destino do STCP OFTP (opcional). Nome do usuário/módulo de origem do STCP OFTP (opcional). Define a próxima seção de processamento a ser executada para esta regra. O nome do arquivo para processamento é o mesmo do início da regra. Ativa ou inibe a remoção do arquivo: 0 = Não remove o arquivo 1 = Remove o arquivo RemoveAfterHours Remove o arquivo somente se o último acesso tiver ocorrido antes da quantidade de horas estabelecida neste parâmetro: 0 = Remove imediatamente >0 = Remove após a quantidade de horas especificada. Overwrite Ativa ou inibe a sobreposição do arquivo: 0 = Não sobrepõe 1 = Sobrepõe Obs: Veja a opção de CopyFileOption e BackupFileOption para habilitar a sobreposição em cada operação individualmente. ProcessAfterSeconds Processa o arquivo somente se o último acesso tiver ocorrido após a quantidade de segundos estabelecida neste parâmetro

32 Na guia Renomeio de Arquivo I, configure os parâmetros que serão utilizados na definição do Novo Nome do Arquivo. Parâmetro RenameFileTo Define o novo nome para o arquivo. Obs.: Se este parâmetro não for definido, o nome original será utilizado. InsertTimestamp Define a utilização do timestamp na nova nomenclatura: 0 = Não insere

33 1 = Insere no final do nome do arquivo 2 = Insere no inicio do nome do arquivo 4 = Insere customizado (através das opções de substituição) InsertTimestampPart Define o tipo de timestamp a ser utilizado pela opção InsertTimestamp: 0 = Data e hora do sistema (computador local) 1 = Data e hora da criação do arquivo 2 = Data e hora da última modificação do arquivo 4 = Data e hora do último acesso ao arquivo

34 Na guia Renomeio de Arquivo I, clique em Adicionar e configure as regras de renomeio do Novo Nome do Arquivo com as opções de Substituição através do nome original

35 Configure as opções de substituição através do nome original do arquivo e do diretório, variávies, número de seqüência, timestamp e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução da substituição. Valor: 0 a 999 ReplaceFileNamePosFrom ReplaceFileNamePosTo ReplaceFileNameLen Define a identificação da regra de renomeio. Modifica o novo nome do arquivo com parte do nome antigo a partir da posição de origem definida. Modifica o novo nome do arquivo com parte do nome antigo para a posição de destino definida. Modifica o novo nome do arquivo com parte do nome antigo com o tamanho definido

36 ReplaceFileNameFromPathPosFrom Modifica o novo nome do arquivo com parte do path do arquivo original a partir da posição de origem definida. ReplaceFileNameFromPathPosTo ReplaceFileNameFromPathLen VarReplaceFileNamePosFrom VarReplaceFileNamePosTo VarReplaceFileNameLen VarReplaceFileNameValue InsertSeqNumberTo InsertSeqNumberLen InsertSeqNumberMIn InsertSeqNumberMax InsertSeqNumberSeq InsertTimestampPosFrom InsertTimestampPosTo InsertTimestampLen Modifica o novo nome do arquivo com parte do path do arquivo original para a posição de destino definida. Modifica o nome do arquivo com parte do path do arquivo original com o tamanho definido. Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) a partir da posição de origem definida. Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) para a posição de destino definida. Modifica o novo nome do arquivo com parte do valor da variável (var0,var1,..., varn) com o tamanho definido. Define o valor da variável quando não for informado na linha de comando (-varn). Insere um número de seqüência no novo nome a partir da posição de destino definida. Insere um número de seqüência no novo nome com o tamanho definido. Número de seqüência inicial. Número de seqüência final. Número de seqüência atual. Modifica o novo nome com parte do Timestamp a partir da posição de origem definida. Modifica o novo nome com parte do Timestamp para a posição de destino definida. Modifica o novo nome com parte do Timestamp com o tamanho

37 Na guia Renomeio de Arquivo II, configure as regras de renomeio do Novo Nome do Arquivo através do conteúdo do arquivo original ou de uma expressão regular: Parâmetro ReplaceFromFileOption Habilita/Desabilita a utilização do conteúdo do arquivo original para fazer o renomeio

38 Clique em Adicionar para configurar as regras de Substituição através do conteúdo do arquivo original que serão aplicadas no Novo Nome do Arquivo :

39 Configure os parâmetros de substituição e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução. Valor: 0 a 999 ReplaceFromFileRegEx Define a identificação da regra. Define uma expressão regular para validar a linha que contêm a informação que deverá ser utilizada na substituição. ReplaceFromFilePosFrom Define a coluna inicial da linha selecionada. ReplaceFromFilePosTo RepalceFromFileLen Define a posição inicial do novo nome para onde serão copiados. Quantidade de caracteres que serão copiados a partir da coluna inicial

40 Clique em Adicionar para configurar as regras de Substituição através de uma expressão regular que serão aplicadas no Novo Nome do Arquivo :

41 Configure os parâmetros de substituição e clique no botão OK para salvar. Parâmetro Ocorrência Define a seqüência de execução. Valor: 0 a 999 RegExReplaceFrom RegExReplaceTo Define a identificação da regra. Define uma expressão regular para selecionar os dados que deverão ser substituidos. Define o valor para substituição. RegExReplaceOcorr Define a quantidade de repetições da substituição: 0 = Todas

42 Na guia Cópia, configure os parâmetros que serão utilizados na definição do Novo Nome do Diretório para onde será copiado o arquivo original

43 Parâmetro CopyToDir CopyFileOption Define o nome do diretório de destino para onde deverá ser copiado o arquivo. Define as opções de cópia que deverão ser utilizadas. CopyTempExtension Define uma extensão temporária para o arquivo enquanto o processo de cópia não é finalizado

44 Clique em Adicionar para configurar as regras de Substituição através do nome original que serão aplicadas no Novo Nome do Diretório

45 Configure os parâmetros de substituição e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução. Valor: 0 a 999 CopyPathReplacePosFrom CopyPathReplacePosTo CopyPathReplaceLen CopyPathVarReplacePosFrom CopyPathVarReplacePosTo CopyPathVarReplaceLen Define a identificação da regra. Modifica o nome do path da cópia com parte do path original a partir da posição de origem definida. Modifica o nome do path da cópia com parte do path original para a posição de destino definida. Modifica o nome do path da cópia com parte do path original com o tamanho definido. Modifica o nome do path da cópia com parte da variável a partir da posição de origem definida. Modifica o nome do path da cópia com parte da variável para a posição de destino definida. Modifica o nome do path da cópia com parte da variável com o tamanho definido

46 CopyPathVarReplaceValue CopyPathReplaceFFNPosFrom CopyPathReplaceFFNPosTo CopyPathReplaceFFNLen CopyPathInsertTMPPosFrom CopyPathInsertTMPPosTo CopyPathInsertTMPLen Define o valor variável. Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) a partir da posição de origem definida. Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) para a posição de destino definida. Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) com o tamanho definido. Modifica o nome do path da cópia com o timestamp (TMP) a partir da posição de origem definida. Modifica o nome do path da cópia com o timestamp (TMP) a partir da posição de origem definida. Modifica o nome do path da cópia com o timestamp (TMP) considerando o tamanho definido

47 Clique em Adicionar para configurar as regras de Substituição através de expressão regular que serão aplicadas no Novo Nome do Diretório

48 Configure os parâmetros de substituição e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução. Valor: 0 a 999 Define a identificação da regra. CopyPathRegExReplaceFrom Define uma expressão regular para selecionar os dados que deverão ser substituidos. CopyPathRegExReplaceTo Define o valor para substituição. CopyPathRegExReplaceOcorr Define a quantidade de repetições da substituição: 0 = Todas

49 Na guia Backup, configure os parâmetros que serão utilizados na definição do Novo Nome do Diretório, para onde será copiado o arquivo original: Parâmetro BkpToDir Define o nome do diretório destino para onde deverá ser copiado o arquivo de backup

50 BkpFileOption Define as opções de backup que deverão ser utilizadas

51 Clique em Adicionar para configurar as regras de Substituição através do nome original que serão aplicadas no Novo Nome do Diretório de backup

52 Configure os parâmetros de substituição e clique no botão OK para salvar. Parâmetro Ocorrência BkpPathReplacePosFrom BkpPathReplacePosTo BkpPathReplaceLen Define a seqüência de eventos. Identifica a regra de Backup. Modifica o nome do path de bachup com parte do path original a partir da posição de origem definida. Modifica o nome do path de backup com parte do path original para a posição de destino definida. Modifica o nome do path de backup com parte do path original com o tamanho definido. BkpPathReplaceVarReplacePosFrom Modifica o nome do path de backup com parte da variável a partir da posição de origem definida. BkpPathVarReplacePosTo BkpPathVarReplaceLen BkpPathVarReplaceValue Modifica o nome do path de backup com parte da variável para a posição de destino definida. Modifica o nome do path de backup com parte da variável com o tamanho definido. Define o valor variável

53 BkpPathReplaceFFNPosFrom BkpPathFFNPosTo BkpPathReplaceFFNLen BkpPathInsertTMPPosFrom BkpPathInsertTMPPosTo BkpPathInsertTMPLen Modifica o nome do path de backup com parte do nome original do arquivo (FFN) a partir da posição de origem definida. Modifica o nome do path de backup com parte do nome original do arquivo (FFN) para a posição de destino definida. Modifica o nome do path de backup com parte do nome original do arquivo (FFN) com o tamanho definido. Modifica o nome do path de backup com o timestamp (TMP) a partir da posição de origem definida. Modifica o nome do path de backup com o timestamp (TMP) a partir da posição de origem definida. Modifica o nome do path da cópia com o timestamp (TMP) considerando o tamanho definido

54 Clique em Adicionar para configurar as regras de Substituição através de expressão regular que serão aplicadas no Novo Nome do Diretório de backup

55 Configure os parâmetros de substituição e clique no botão OK para salvar. Ocorrência Parâmetro Define a seqüência de execução. Valor: 0 a 999 Define a identificação da regra. BkpPathRegExReplaceFrom Define uma expressão regular para selecionar os dados que deverão ser substituidos. BkpPathRegExReplaceTo Define o valor para substituição. BkpPathRegExReplaceOcorr Define a quantidade de repetições da substituição: 0 = Todas

56 Na guia Avançadas, configure os parâmetros:

57 Parâmetro CheckLockUnlockOption Define as opções de criação/utilização do arquivo de sincronização de acesso ao arquivo que está sendo processado. CheckLockUnlockFileName Define o nome do arquivo de bloqueio/desbloqueio que deverá ser verificado. CreateLockUnlockFileName Define o nome do arquivo de bloqueio/desbloqueio que deverá ser criado. DelayNextFileProcess Define o intervalo mínimo (em milisegundos) para processar o próximo arquivo na mesma regra

58 6. Execução 6.1. Linha de comando Linha de Comando stcpren_3_2.exe [opções] [Opções] -log <arquivo de log> -rules <arquivo de regras> Define o nome do arquivo de configuração de log. Define o nome do arquivo de regras. -firstrule <número da regra> Define a primeira regra a ser processada. -scan <nome do diretório> -subdir -dirregex <regex> -dirregexneg <regex> -fileregex <regex> -fileregexneg <regex> Define o nome do diretório para varredura. Habilita a procura do subdiretório. Define uma expressão regular para validar os subdiretórios que serão processados. Define uma expressão regular para validar os subdiretórios que não serão processados. Define uma expressão regular para validar os nomes de arquivos que serão processados. Define uma expressão regular para validar os nomes de arquivos que não serão processados. -filelist <nome da lista> Define o nome do arquivo da lista de arquivos. -dirlist <nome da lista> Define o nome do arquivo de lista de diretórios. -scansemname <nome> Define um nome de semáfora para sincronização do mode de varredura. Obs.: Utilizado para sincronizar a execução de múltiplos processos do STCPREN. -var(n) <valor> Define o valor da variável. O índice (N) pode variar de 0 á

59 7. Códigos de Eventos 7.1. Códigos de eventos gerados no arquivo de mensagens Mensagem MSG7001 [MSG7001] LOCAL - <STCPREN> - Erro: quantidade de parametros e insuficiente - '%d' MSG7002 [MSG7002] LOCAL - <STCPREN> - Erro: nome do arquivo invalido - '%s' MSG7003 MSG7004 MSG7005 MSG7006 MSG7007 MSG7008 MSG7009 MSG7010 MSG7011 MSG7012 MSG7013 MSG7014 [MSG7003] LOCAL - <STCPREN> - Erro: arquivo de regras '%s' nao tem definicao para arquivo '%s' [MSG7004] LOCAL - <STCPREN> - Erro: servico de log nao foi aberto [MSG7005] LOCAL - %s - Erro: regra '%s' com parametro invalido no arquivo '%s' [MSG7006] LOCAL - %s - Inicio do STCPREN para o arquivo '%s' [MSG7007] LOCAL - %s - Erro: copia do arquivo de '%s' para '%s' [codigo:%u] [MSG7008] LOCAL - %s - Copia do arquivo de '%s' para '%s' destino '%s' [MSG7009] LOCAL - %s - Copia do arquivo de '%s' para '%s' origem '%s [MSG7010] LOCAL - %s - Erro: remover o arquivo '%s' [codigo:%u] [MSG7011] LOCAL - %s - Erro: executar o comando '%s %s'[codigo:%u] [MSG7012] LOCAL - %s - Erro: executar o comando '%s %s'[codigo:%u] [MSG7013] LOCAL - <STCPREN> - Erro: conectar recurso '%s' [codigo:%u] [MSG7014] LOCAL - <STCPREN> - Erro: desconectar recurso '%s' [codigo:%u]

60 8. Glossário E Endereço IP Este endereço é um número único para cada computador conectado a Internet, composto por uma seqüência de 4 números que variam de 0 até 255, separados por.. F Firewall Dispositivo constituído pela combinação de software e hardware, utilizado para dividir e controlar o acesso entre redes de computadores. H HTTP Do Inglês HyperText Transfer Protocol. Protocolo usado para transferir páginas Web entre um servidor e um cliente, por exemplo, o browser. I ISDN O ISDN (Integrated Services Digital Network) é um sistema de conexões de telefone digital. L Log Registro de atividades por programas de computador. No caso de logs relativos a incidentes de segurança, eles normalmente são gerados por firewalls ou por IDSs. M Macro É sinônimo para um grupo de instruções que pode ser usado como uma instrução ao longo do código-fonte. Modem Dispositivo que permite o envio e recebimento de dados utilizando as linhas telefônicas. P Protocolo OFTP (ODETTE File Transfer Protocol) O OFTP foi primeiramente especificado com premissas do modelo interconexão de sistemas abertos (OSI) utilizando o serviço de rede recomendado pela norma CCITT X.25. Com o crescimento da utilização do OFTP por diferentes setores, a organização ODETTE ampliou o escopo de padronização e incorporou a utilização do protocolo TCP/IP. PPP O PPP (Point-to-Point Protocol) é o método mais usado para transportar pacotes do IP sobre uma ligação de série entre o usuário e a Internet Service Provider (ISP)

61 R RAS Um protocolo para configuração de uma VPN. S Scan Técnica normalmente implementada por um tipo de programa, projetado para efetuar varreduras em redes de computadores. SMM System Management Module (Módulo de Gerenciamento de Sistema). SSL Do Inglês Secure Sockets Layer. Protocolo que fornece confidencialidade e integridade na comunicação entre um cliente e um servidor, através do uso de criptografia. U UNC Este é um formato de nome de arquivo que é usado para especificar a localização dos arquivos, pastas e recursos na rede local (LAN). V VPN É uma rede de comunicação privada normalmente utilizada por uma empresa ou um conjunto de empresas e/ou instituições, construída em cima de uma rede de comunicação pública, por exemplo, a Internet. 9. Referências Disponível em: < Acesso em: 20 de julho de Disponível em: < Acesso em: 20 de julho de Disponível em: < Acesso em: 20 de julho de Licença