Sobre o programa WsReceiver.exe


Prezados Senhores,


A MCDI fornece um programa utilitario chamado WSRECEIVER.EXE que
faz a recepcao dos dados de RECEPTORES ligados ao computador em 
um ambiente WINDOWS 9x, ME, XP e 2000.
 
O programa WSRECEIVER permite a configuracao dos receptores ligados
`as portas seriais do computador que estivrem configuradas no WINDOWS.

O Wsreceiver estabelece a comunicacao com o(s) receptor(es)
instalado(s) nele configurado(s), recebe os eventos e grava os dados
dos eventos recebidos no arquivo com a pilha de eventos a serem
atendidos pelo programa WINSAMM que estejam sendo executados
nesse computador.

I) Programa SAMM no DOS, Windows 9x
O WsReceiver NAO deve ser utilizado se utiliza-se o programa SAMM 8.1.xx
ou 10.3.xx no MS-D0S, no Windows 95, 98 ou 98-SE. Nesses casos, e' 
mais adequado utilizarem-se PARAMETROS de configuracao dos receptores
na linha de comando que executa o programa SAMM.EXE.

II) Programa SAMM no Windows XP, ME, 2000
No caso de utilizar-se o SAMM 10.3.xx não se deve utilizar o programa
Wsreceiver, e sim criar um arquivo de lote ("BATch") para passar
parâmetros na linha de comando que executa o programa SAMM.EXE, informando
por meio deles a existência dos receptores instalados. Caso se tenha
executado o WsReceiver anteriormente, deve-se apagar o arquivo 
C:\WSAMMCOM.DTA do diretório raiz do disco C: do computador, ou o 
programa SAMM.EXE utilizará as configurações do WsReceiver para as
portas, e irá ignorar os parametros.

III) WINSAMM
Para utilizar-se o WinSamm sempre sera' necessario executar o WsReceiver
para comunicar-se com o(s) receptor(es).

No pacote que a MCDI do BRASIL envia, o programa WSRECEIVER.EXE
foi compactado pelo WinZip e chama-se WSRxxxx.ZIP, onde xxxx e'
o numero da versao do programa que esta' no pacote.

Caso uma atualizacao do sistema seja efetuada utilizando-se um
pacote obtido da homepage da MCDI do Canada´, deve-se ter o 
cuidado de sibsltituir o antigo WSRECEIVER.EXE pela nova versao.
Isso normalmente e´ feito pelo programa de atualiacao automaticamente.

==============================
COMO UTILIZAR O WSRECEIVER.EXE
==============================
Importante:
	Deve-se SEMPRE utilizar o conjunto de programas SAMM.EXE
e WSRECEIVER.EXE do mesmo pacote de programas obtido da MCDI. 
A mistura de programas de pacotes diferentes pode causar erros.
******************************************************************
O WSRECEIVER.EXE SEMPRE DEVE SER EXECUTADO A PARTIR DO DIRETORIO 
\SAMM
DO DISCO ONDE ESTA´ O PROGRAMA SAMM.EXE ou WINSAMM.EXE que se 
deseja utilizar.
******************************************************************

O WSRECEIVER.EXE é um programa para Windows 9x ou Xp, e e´ um 
utilitario dos programas SAMM.exe VERSAO 10.3.XX e WINSAMM.exe.
O WSRECeiver faz a comunicacao entre os receptores de eventos 
instalados e o computador.

Com o programa SAMM:
	O WSRECeiver deve ser executado e ficar em execucao, 
com sua janela minimizada ou nao, para depois executar-se o 
programa SAMM.exe ou WinSamm.exe em uma outra janela do DOS dentro 
do Windows. 

Com o programa WINSAMM:
	Pode-se executar primeiro o WSRECEIVER e deixa-lo 
minimizado, para entao executar o WinSamm, ou pode-se executar o 
WinSamm e executar o WSRECEIVER.EXE (nesse caso deve-se dar esse 
nome para o programa WSREC.EXE) por meio da opcao WSRECEIVER do 
Menu principal do programa WINSAMM.

Como Configurar o WSRECEIVER.EXE:
Ele deve ser executado, e por meio dele configuram-se as portas seriais
e os receptores que nelas estao conectados, salvando-se a configuracao.
A configuracao das portas sera´ salva no diretorio raiz do disco C:
do computador onde o WSRECeiver esta´ sendo executado, nos arquivos 
chamados:

WSAMMCOM.DTA e WSammPort.Dta

Na proxima vez que o WSREC for executado, ele utilizara´ as 
configuracoes salvas anteriormente, comunicando-se com os receptores 
instalados sem mais configuracoes.

Para evitar alteracoes na configuracao por pessoas nao autorizadas, o 
WSREC necessita de uma senha de acesso de nivel "A", do SAMM ou do 
Winsamm, que deve ser fornecida clicando-se no botao 
[LIBERAR CONFIGURACAO].

As senhas dos programas DEMONSTRACAO sao:

Senha do operador numero 1 do SAMM.EXE Demo = SAMM
Senha do operador numero 1 do WinSamm.exe Demo = WINSAMM

Logo apos instalar-se o modelo Demonstracao desses programas,
estara´ cadastrado apenas o operador numero 1, de nivel
de acesso maximo, com a senha acima.
Esse operador pode cadastrar, alterar ou apagar outros operadores,
ajustar seu nivel de acesso, e alterar todas as demais opcoes.

MUDANCA DA SENHA
Para alterar a senha do operador 1, ou de outro operador, digita-se
SET no lugar da senha, a senha atual e duas vezes a nova senha.

Uma vez infromada uma senha adequada no WSRECRECEIVER, pode-se 
ajustar cada uma das portas seriais configuradas no computador, 
para que o programa receba dados do(s) receptor(es) que estao 
nelas conectados.

E´ aconselhavel manter-se a configuracao das portas como:
Velocidade       : BAUD = 1200
Bits de dados    : DATA BITS = 8
Paridade         : PARITY = NONE (nenhuma)
Bits de parada   : STOP BITS = 1
Controle de Fluxo: FLOW CONTROL = NONE (sem controle de fluxo)

NOTA: deve-se ajustar as caracteristicas da porta dos receptores para 
essas mesmas configuracoes, ou nada ira´ funcionar.

Depois de ajustado cada receptor de cada porta, clica-se no botao
[SALVA OS DADOS] do WsReceiver, e depois em [Bloquear configuracao].
Minimiza-se o programa pelo botao [MINIMIZA] e depois executa-se
o programa SAMM.exe ou o WINSAMM.exe para atender aos eventos
recebidos.

EM UMA REDE
***********
Se o programa SAMM e/ou WINSAMM estao  instalados no disco de
um Servidor de rede, eles estarao em um diretorio \SAMM do disco
do servidor. Aconselha-se utilizar uma parlticao separada do HD
do servidor, e instalar nela o programa SAMM e/ou WinSamm.

Se a particao e´ o disco D:, os programas SAMM e/ou WinSamm
serao instalados no diretorio D:\SAMM, E NAO PODEM SER MOVIDOS
desse diretorio, nem executados a partir de um outro diretorio.
Compartilha-se o disco D: do servidor com os demais computadores
estacoes de trabalho da rede, e mapeia-se um disco, digamos, J:,
em cada estacao de trabalho, como o disco remoto \\SERV\D.

Assim, em uma estacao de trabalho, podem-se executar os programas
WSRECEIVER.EXE, SAMM.EXE e WINSAMM.EXE a partir do diretorio 
J:\SAMM, criando-se um atalho para eles, sendo que os programas 
devem ser iniciados de dentro do diretorio J:\SAMM e ter esse 
diretorio como sendo o diretorio de trabalho.

Qualquer outra tentativa de alterar o diretorio de execucao desses
programas causara´ um desastre.

FUNCIONAMENTO DO WSRECEIVER.EXE
-------------------------------
O WSRECEIVER e´ para Windows, portanto, so´ enxerga as portas 
seriais (COM) que estiverem configuradas no Windows. Para que uma 
porta serial seja configuravel no WSRECEIVER, ela deve constar na 
lista dos Gerenciadores de Dispositivos do Sistema do Painel de 
Controle do Windows.

Uma vez configurado um receptor em uma porta, deve-se ver o 
"batimento cardiaco" desse receptor na janela de texto do 
WSRECEIVER (se a opcao " Mostra o heartbeat" esta´ ativada
nessa porta), ou os dados de eventos chegando do receptor
configurado em cada porta. 

Os dados dos eventos recebidos dos receptores sao gravados no 
arquivo de eventos a serem atendidos do diretorio onde o 
WSRECEIVER esta´ sendo executado. Por isso ele deve ser executado 
a partir do MESMO diretorio de onde sera´ executado o programa 
SAMM ou WINSAMM. Esses ultimos leem o arquivo de eventos a serem 
atendidos criado pelo WSREC e os mostram na tela de monitoramento 
para serem resolvidos pelo operador.

Nesse momento o evento e´ retirado da pilha de eventos a serem 
atendidos e transferido para outros arquivos temporarios ate´ 
que seu atendimento seja concluido.
Apos as providencias e anotacoes serem tomadas pelo operador do 
SAMM ou WINSAMM, o evento e´ "salvo", sendo entao transferido, 
junto com os comentario, para os arquivos de HISTORICO de eventos 
do programa SAMM ou WINSAMM.

Atenciosamente,

Eng. Teodorico A. Eberle
20:55 8/9/2005