Escolar Documentos
Profissional Documentos
Cultura Documentos
Skyline
Manual Cliente Skyline
2 de 44
Sumrio
Arquitetura Skyline ........................................................................................5 Requisitos mnimos ........................................................................................7
Hardware........................................................................................................................ 7 Software......................................................................................................................... 8
Aspectos de Segurana ....................................................................................8
Comunicao (Figura 3) ................................................................................................. 8 Handshake (Figura 4) ..................................................................................................... 8 Processo do Handshake: ................................................................................................. 9 Autenticao do Usurio .................................................................................................... 9 Armazenamento de Dados do Usurio e Senha no Servidor.............................................. 10 Restries aplicadas ao processo de autenticao e senhas................................................ 10 Gerenciamento Skyline Commander ............................................................................. 11
Funcionalidades do Skyline Cliente................................................................... 11
Conexo via redes IP........................................................................................................ 12 Conexo via rede de pacotes............................................................................................. 12 Conexo via Modem ........................................................................................................ 13 Criptografia...................................................................................................................... 13 Atualizao automtica .................................................................................................... 13 Compactao de arquivos................................................................................................. 14 Envelopamento ................................................................................................................ 14 Transmisso para lista de usurios.................................................................................... 15 Transmisso para mltiplos usurios ................................................................................ 15 Alternativas de conexo automtica.................................................................................. 15 Modo Emulado............................................................................................................. 16 Converses de nomes de arquivo...................................................................................... 16 Caracteres Variantes......................................................................................................... 17 Protocolo rpido............................................................................................................... 17 Gerao de relatrios........................................................................................................ 18 Inibio da Janela de login ............................................................................................... 18 Modo quieto..................................................................................................................... 18 Append de arquivos.......................................................................................................... 19 Alterar senha.................................................................................................................... 19 Log de Erros .................................................................................................................... 20
Apndice A Configurando o wtcm.ini............................................................... 20
Regras Gerais................................................................................................................... 36
Linhas de Comando ...................................................................................... 37 Strings e constantes numricas ....................................................................... 37 Execuo................................................................................................... 38 Variveis .................................................................................................. 38 Parmetros................................................................................................ 39 Comandos e Sintaxe ..................................................................................... 39 Comando M ................................................................................................ 40 Comando I ................................................................................................. 40 Comando P................................................................................................. 40 Comando R ................................................................................................ 40 Comando K ................................................................................................ 41 Comando S ................................................................................................. 41 Comando W................................................................................................ 41 Apndice D Possveis erros em uma conexo RENPAC .......................................... 42 Suporte tcnico NEXXERA .............................................................................. 44
4 de 44
Apresentao
O software Cliente Skyline foi concebido com o objetivo de proporcionar um meio seguro para troca de informaes, sobre qualquer meio fsico (rede local, internet, linha discada, cable modem, adsl, renpac, etc.), e tambm sobre qualquer plataforma de hardware e sistema operacional. Esta caracterstica multi-plataforma do Cliente Skyline permite um alto grau de portabilidade, proporcionando a mesma segurana e eficincia no intercmbio eletrnico de informaes em todas as plataformas em que ele atua. A natureza tecnolgica do Cliente Skyline e a expertise da Nexxera no desenvolvimento de sistemas de segurana garantem a eficcia do processo, o gerenciamento e a segurana das informaes trafegadas por meios de criptografia forte (RSA e 3DES) e rotinas de verificao de contedo (clculo de CRC - Cdigo de Redundncia Cclica). Estes assuntos estaro detalhados no Manual Servidor Skyline.
Arquitetura Skyline
Figura - 1
5 de 44
O Cliente Skyline baseado em um software servidor que atende conexes pela porta 7700. A conexo com o servidor pode ser realizada atravs de qualquer verso do software cliente, Windows 32 Bits (Win32), WindowsCE(WinCE), Ms-Dos, Palm-OS ou UNIX.
O Cliente Skyline capaz de utilizar o meio de comunicao disponvel de acordo com a plataforma em uso (internet ou acesso discado), desde que previamente configurado para isso. A configurao do Cliente Skyline ser descrita em detalhes no Apndice A Configurando o Tcm.ini. A partir do momento em que a conexo com o servidor estabelecida, todo o gerenciamento do processo passa a ser realizado pelo Servidor Skyline, que por sua vez pode atender milhares de conexes simultaneamente.
O Cliente Skyline dispem de uma estrutura de diretrios onde so colocados os arquivos recebidos e os arquivos a serem enviados e os j enviados. A estrutura de diretrios segue o padro conforme (Figura 2).
Figura - 2
Inbox: Caixa de Entrada, pasta onde so salvos os arquivos recebidos pelo Skyline; Outbox: Caixa de Sada, pasta onde devem ser colocados os arquivos que sero enviados pelo Skyline; Sentbox: Caixa de Enviados, pasta para onde so movidos os arquivos j enviados, tratada como pasta de backup de arquivos j transmitidos pelo Skyline.
O software Cliente Skyline composto por dois arquivos e uma estrutura de diretrios conforme figura anterior. Os arquivos que compe o Cliente Skyline so:
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 6 de 44
- Skyline.exe ou wtcm.exe: o nome do executvel do Skyline Cliente. Este arquivo pode ser renomeado para qualquer nome, desde que fique junto com o arquivo de configurao no mesmo diretrio. Geralmente o padro usado wtcm.exe.
- Wtcm.ini: arquivo de configurao ou arquivo de inicializao do do Skyline Cliente. neste arquivo que configuramos o meio de conexo, servidor e porta de comunicao, identificao da caixa postal do cliente, nome da caixa postal destinatria, script de conexo entre outros conforme tabela encontrada no Apndice A. Obs.: Se o Cliente Skyline rodar sem este arquivo a conexo com o servidor no estabelecida, apresentando a seguinte mensagem: No foi possvel estabelecer uma conexo. - Session.log: Arquivo de log da verso Skyline Cliente. neste arquivo que so armazenadas todas as informaes referentes conexo do cliente, desde falhas, transmisses e recepes. Este arquivo gerado sempre com o ltimo status da conexo. Obs.: Existe um parmetro dentro do wtcm.ini que permite gravar o contedo deste log em outro log chamado History.log, que pode ser configurado conforme tabela do Apndice A.
Requisitos mnimos
Hardware Os requisitos de Hardware para instalao e execuo do software Cliente Skyline so: Microcomputador: Equipamento: Micro IBM PC compatvel (XT, AT); Memria convencional: 440 Kbytes livres de memria convencional ; (para verificar, digite MEM); Disco Rgido: 2,4 MB livres para instalao inicial e 1,5 MB para upgrade ; Uma interface serial assncrona RS232; Nota IMPORTANTE: Para os casos de utilizao de microcomputador do tipo Palmtop, so necessrios pelo menos 280K de memria livre para a instalao do programa. Modem: Assncrono, full duplex, 2 fios. Os comandos para discagem automtica devem ser Hayes ou CCITT. As recomendaes CCITT que podem ser utilizadas so: V.22, V.22 bis, V.32 bis, V.32 bis,
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 7 de 44
V.42 (MNP.4, LAPM) ou V.42 bis (MNP.5). As velocidades de transmisso podem ser as seguintes: 300 bps, 1200 bps, 2400 bps, 4800 bps, 9600 bps, 14400 bps, 28800 bps 33600 ou 56000 bps. Linhas de Comunicao: Linha telefnica (Internet, Rede de Pacotes ou Linha Discada) ou acesso dedicado Rede de Pacotes (X.28). Software Sistema Operacional Qualquer um dos sistemas operacionais suportados listados abaixo: MS-DOS verso 3.30 ou superior; Windows 3.x/9x/NT/2000/CE/XP; Palm-OS; UNIX;
Aspectos de Segurana
Comunicao
(Figura 3)
Figura - 3
Handshake (Figura 4)
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 8 de 44
Figura - 4
O primeiro passo da conexo do skyline o processo de estabelecimento do link com o servidor, ou seja, discagem quando for o caso, conexo direta, X.25 ou IP. Uma vez estabelecido o link o skyline passa a negociar a segurana do canal.
Processo do Handshake:
O cliente de comunicao gera para si, a cada sesso, uma chave RSA; A parte pblica desta chave criptografada com a chave pblica do servidor, que est codificada no software cliente, e enviada ao servidor; Recebendo esta chave, o servidor gera uma chave 3DES, de 168 bits e envia ao cliente, criptografada com a chave pblica do cliente que ele recebeu; O cliente recebe esta chave, e com ela, forma um tnel seguro para a comunicao; A partir deste momento, todos os dados que trafegam no canal de comunicao esto criptografados utilizando-se a chave 3 DES estabelecida;
Autenticao do Usurio
A identificao do usurio (caixa postal) e a senha so passadas ao servidor no tnel seguro criado no processo de handshake e, verificadas na base do servidor. Se o conjunto usurio/senha vlido, o servidor prossegue a conexo. Caso contrrio, a conexo abortada neste momento e o evento de conexo com senha incorreta registrado nos logs do servidor.
9 de 44
Figura - 5 No subdiretrio mailbox ficam armazenados os arquivos para transferncia. Os arquivos ficam pendentes neste diretrio at serem retirados pelo seu respectivo usurio, que neste caso so os usurios 70000 e 70001. Sempre que um arquivo transmitido a partir de uma caixa postal (mailbox), uma copia do arquivo transmitido vai para o subdiretrio sent. Os arquivos ficam indefinidamente no subdiretrio sent, at serem apagados. Pode ser definida uma periodicidade para esses arquivos serem apagados. Para isso veja as configuraes no arquivo tmsys.ini. O arquivo mailbox.dat contm os dados da caixa postal, ou seja, o que visualizado pelo administrador na janela de propriedades do Skyline Commander (vide manual do Skyline Commander).
10 de 44
O desbloqueio da caixa postal dever ser realizado pelo administrador do sistema utilizando o Skyline Commander;
Conexo Discada O Cliente Skyline utiliza um discador externo (dial up) para efetuar a discagem e conexo. Os atributos de configurao envolvidos so: wsaddr, wsdll, modemport, wstitle, dialto, wsusername, wspassword;
Habilitado para as verses:
Funcionalidades Conexo via Redes IP Win32 X WinCE X UNIX X Palm X
12 de 44
Criptografia
O Cliente Skyline dispem de recursos de criptografia dos dados trafegados, que garantem o sigilo completo e total integridade dos dados. Os processos criptogrficos esto descritos detalhadamente em Aspectos de Segurana, no manual Servidor Skyline. Esta funcionalidade disponvel nas ltimas verses do Skyline Cliente, e no necessita de qualquer parmetro adicional de configurao do wtcm.ini.
Habilitado para as verses:
Funcionalidades Criptografia Win32 X WinCE X UNIX Palm X
Atualizao automtica
O Cliente Skyline possui um recurso de atualizao automtica, uma vez habilitado no servidor Skyline pelo administrador do sistema, o cliente passa a efetuar a verificao da verso sempre que conectar. Este processo ocorre no momento em que o Cliente Skyline apresenta na tela a mensagem verificando o mdulo de comunicao, e quando a verso do cliente for menor que a verso atual disponvel no servidor, assim ocorre uma atualizao. O processo de atualizao faz o download de um arquivo (upgrade.exe) e desconecta do servidor executando o arquivo recebido, que automaticamente este executar o Cliente Skyline novo.
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 13 de 44
Compactao de arquivos
Esta funcionalidade permite a compresso e descompresso dos arquivos no momento da transmisso e recepo. O parmetro de configurao envolvido :
compress;
Envelopamento
O Cliente Skyline permite definir aonde o arquivo ser gravado e tambm como, se por append (insero no fim do arquivo) ou update (substituio do contedo do arquivo). Para isso o arquivo deve ser gerado com um cabealho pr definido. Informaes sobre esta funcionalidade devem ser obtidas com o suporte Nexxera. O parmetro de configurao envolvido :
chk_envelope;
14 de 44
Lista de Usurios
15 de 44
Modo Emulado
O Cliente Skyline pode trabalhar em modo emulado, simulando o funcionamento do software de EDI da Embratel, podendo ento substituir o mesmo obtendo a mesma funcionalidade. Para trabalhar em modo emulado, basta que o executvel do Cliente Skyline chame-se de operador.exe. Todas as configuraes necessrias sero obtidas atravs dos arquivos de configurao do STM400 (software Embratel). Os atributos de configurao do tcm.ini para uso desta funcionalidade so:
wsaddr, wstitle, modemport, wsdll, wsusername, wspassword.
16 de 44
Caracteres Variantes
Na recepo de arquivos com mesmo nome, o primeiro arquivo sempre sobrescrito, caso no seja utilizada a regra de caracteres variantes. Esta regra usada em conjunto com Converses de nomes de arquivos, de forma a obter um compartimento que no sobrescreva os arquivos recebidos com mesmo nome. No exemplo anterior, duas recepes de um arquivo com o nome TESTE.TXT, com contedos diferentes ocasionariam a perda do primeiro arquivo, pois ambos seriam renomeados paraTESTE.DOC. Para evitar este problema, existe a possibilidade de especificar um ou mais caracteres variantes no nome do arquivo. Um caractere variante sempre vale por um caractere comum, selecionado de tal forma que o nome de arquivo formado seja nico, evitando dessa forma sobrescrever um arquivo j existente. Exemplo: TXT=*#.DOC Neste caso, o primeiro arquivo recebido seria renomeado para TESTEA.DOC e o segundo seria renomeado para TESTEB.DOC (os caracteres A e B podero ser outros). A cerquilha (#) especifica um caractere variante. Pode-se utilizar mais de um caractere variante, podendo este aparecer em qualquer ponto da expresso alvo, no s no nome do arquivo como no
exemplo.
Protocolo rpido
As novas verses Cliente Skyline j possuem o protocolo de comunicao rpido, defido como SkyFast. Este protocolo utiliza um recurso de enjanelamento dos pacotes de dados, tornando a
17 de 44
comunicao mais rpida e eficiente. No necessrio a utilizao de qualquer recurso adicional de configurao.
Gerao de relatrios
possvel habilitar a gerao de um arquivo descrevendo um relatrio sobre as transmisses realizadas, trazendo dados como a lista de arquivos transmitidos, tamanho dos mesmos, data, etc. A cada comunicao gera um arquivo com a nomenclatura nome_arquivo_001.txt, sendo que nome_arquivo o nome definido no atributo de configurao do tmc.ini make_report.
Habilitado para as verses:
Funcionalidades Gerao de Relatrios. Win32 X WinCE UNIX Palm -
Modo quieto
Quando esta opo ativada, o Cliente Skyline executa sem uma interface visvel, ou seja, em background. No necessrio a utilizao de qualquer atributo de configurao adicional no
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 18 de 44
tcm.ini, sendo que para a utilizao deste recurso basta executar o Cliente Skyline com a opo /q.
Habilitado para as verses: Funcionalidades Modo Quieto Win32 X WinCE UNIX X Palm -
Append de arquivos
O Cliente Skyline pode realizar o append de arquivos recebidos em um arquivo pr-existente (adicionar contedo ao final do arquivo). Para que isso ocorra necessrio que os arquivos (recebido e existente) possuam o mesmo nome e tenham um sinal de + no fim do nome do arquivo. Se o arquivo recebido possuir um + no final de seu nome e no existir um arquivo prexistente com o mesmo nome, o arquivo criado com o sinal de + no fim do nome. No necessrio a utilizao de qualquer parmetro adicional para a utilizao deste recurso.
Alterar senha
Na tela de login da verso Cliente Skyline existe o boto ALTERAR. Clicando neste boto o usurio poder alterar a senha atual do Skyline. Aps clicar no boto uma nova tela aparecer conforme a (Figura 6)
Figura - 6
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 19 de 44
O usurio informa a senha antiga no campo Senha atual, em seguida a nova senha e redige novamente a nova senha. Obs.:Se o atributo passwd estiver configurado como false no wtcm.ini, no ser possvel a modificao da senha, tem que estar configurado passwd=true. No h a necessidade da utilizao de qualquer atributo de configurao adicional.
Log de Erros
Esta funcionalidade faz com que o Cliente Skyline salve o arquivo session.log, que contm informaes sobre a conexo e, assim que tiver uma conexo bem sucedida envia este arquivo ao servidor, para anlise do suporte tcnico. Para que esta funcionalidade esteja habilitada, necessrio a utilizao do atributo de configurao:
error_file;
Exemplos
Observao
Wsaddr
20 de 44
Parmetro
Descrio
Exemplos
Observao
Modemport
Parmetro para configurar a porta de comunicao que o mdulo cliente usar para realizar a conexo com o Servidor. Esta porta pode ser usada nas conexo via Internet apontando o Winsock do Windows ou a porta modemport=winsock do modem no cliente a fim de realizar modemport=COM4 conexo via Rede de Pacotes (protocolo X25), servio da Embratel conhecido com RENPAC. modemport=porta de comunicao
Para conexes via internet discada este parmetro sempre ser acompanhado pelo parmetro wsdll.
Wsdll
Parmetro para apontar a Dll de comunicao do sistema, ou seja, para apontar a biblioteca do winsock quando o Cliente wsdll=winsock.dll Skyline usa o winsock do windows. Wsdll=biblioteca do winsock
Este parmetro usado somente em conjunto com o parmetro modempor, e somente quando a conexo via internet.
activate_bluetoot Parmetro para ativar o bluetooth do equipamento do cliente conforme j prh configurado pelo usurio.
activate_bluetooth=TRUE activate_bluetooth=FALSE
only_use_bluetoo Parmetro para Informa ao Cliente Skyline que dever usar o modem bluetooth ativo. th_modem
only_use_bluetooth_modem=TRUE only_use_bluetooth_modem=FALSE
try_all_modens*
Parmetro para ativar a deteco automtica de modens e suas respectivas portas, seguindo uma ordem de prioridades.
try_all_modens=TRUE try_all_modens=FALSE
Wstitle
Parmetro para abrir um discador prprio do Skyline com todos os provedores instalados na mquina do cliente. Parmetro para configurar o nmero do telefone do provedor de internet ou nmero da Renpac. Pode ser usado da seguinte forma:
wstitle=TCMDialer
Dialto
telefone da RENPAC, da conexo RAS ou telefone de um determinado provedor, e ainda: a) Somente o telefone a ser chamado; b) Pabx mais o telefone a ser chamado; c) Qualquer outro tipo de pabx mais o telefone a ser chamado. Paramtro para configurar username do provedor de Internet (TERRA, AOL, UOL, IG) ou Redes corporativas tais como: Office Dial; Remot IP; Dial Net.
Wsusername
Este parmetro usado somente nos casos de conexo discada; Geralmente este parmetro acompanha o parmetro wspassword
21 de 44
Parmetro
Descrio
Exemplos
Observao
Wspassword
device_name
Parametro para configurar Nome do modem a ser usado na conexo. Este parmetro usado somente quando for necessrio que o skyline realize a conexo de forma automtica, sem a interveno do usurio para digitar usurio e senha de device_name=Motorola FasTalk II conexo com o provedor. Para ser usado este parmetro necessrio configurar o nome do modem manualmente, conforme o nome que podemos encontrar no painel de controle. Parmetro para configurar o nmero do PABX para acesso linha externa. Geralmente usado quando usado Centrais Telefnica. Este parmetro permite configurar para ora aparecer na tela ora no aparecer. Se colocar com o sinal de interrogao sempre abrir a tela para a configurao manual. Pabx=nmero pabx=nmero e letra Parmetro par aconfigurar a velocidade de conexo do modem. Este parmetro muito usado para as conexes via RENPAC e tambm para conexes RAS. modemspeed=velocidade do modem, que poder ir de 300 115200 Parmetro para indicar um ou dois Numeros da renpac correspondente ao servidor destino. Quando indicado dois nmeros o Skyline ir alternar
Este parmetro mais eficiente do que o Try_all_modems, pois este detecta somente alguns quanto o device_name podemos cadastrar qualquer nome de modem. Nome do modem conforme definido no painel de controle, respeitando letras masculas e caracters especiais.
Pabx
Modemspeed *
modemspeed=9600
Renpac
renpac=numero do terminal RENPAC renpac=numero do terminal RENPACA;numero do terminal RENPACB renpac=(NIU+password-numero do terminal RENPAC) renpac=NIU+password-numero do terminal RENPACA;numero do terminal RENPACB Parmetro para configurao da String de inicializao do modem a ser usado. Modeminit=string do padro AT
Se precisar, o nmero da NIU pode ser informado junto com o nmero da Renpac
Modeminit
Este parmetro pode ser usado em uma conexo RAS, RENPAC ou quando realizar conexes GPRS.
22 de 44
Parmetro
Modemdialing
Descrio
Parmetro para ndicar o tipo de discagem, se por Tom ou Pulso. TOM = T PULSE=P
Exemplos
modemdialing=T modemdialing=P
Observao
Este tipo de parmetro muito comum para conexes via RENPAC e conexes RAS
Passwd
Parmetro que ativa ou desabiva a chamada da janela "digite sua senha" do Skyline Cliente.
passwd=TRUE passwd=FALSE
Funciona para qualquer verso cliente, WinCE Mobile, Win32 e Unix. TRUE => ativa parmetro FALSE => desativa parmetro
Parmetro usado para indicar a prxima alternativa de conexo do Skyline, caso a atual conexo no se estabelea ou derrubada por quaisquer motivos. Quando um usurio trabalha com mais de uma opo de conectividade como internet, alternate=internet renpac, office dial, etc, basta configurar este internet.alternate=renpac parmetro com cada alternativa. Exemplo: renpac.alternate=FALHA alternate=conexoA conexoA.alternate=conexoB conexoB.alternate=conexoC conexoN.alternate=FALHA (Essa indicar que o skyline pode finalizar a conexo pois no tem mais alternativas)
Alternate
Quando usado este parmetro com valor igual "qualquer coisa", entende-se que este valor "qualquer coisa" servir como pre-fxo para todos os outros parmetros da prxima alternativa de conexo, sempre separados por um ponto. Exemplo: alternate=internet internet.modemport=wi nsock internet.wsdll=winsock. dll internet.alternate=renp ac renpac.modemport=CO M1 (...)
alternate_send_li st=
Parmetro para indicar o nome de arquivo de lista que ser usado para realizar transmisso para uma caixa postal MATRIZ. Este parmetro usado para envia arquivos de diretrios diferentes, para uma caixa postal Matriz, de forma j pr-definida atrav de um arquivo de lista, ou seja, o arquivo de lista dever ter uma estrutura padro, conforme a regra abaixo:---------------diretrio_origem\nome_arquivo; curinga para a caixa com o nome MATRIZ; nome_arquivo_a_ser_salvo.Exemplo:c:\marti ns\transmit\pedido00.not; *host; PEDIDO00.00000--------------alternate_send_list=nome do arquivo de lista
alternate_send_list=lista.end
Parmetro para configurar o nmero de vezes em que a tentativa de Conexo ser realizada, caso de erro de conexo.
Retries
Este parmetro usado sempre que precisar ser definido a quantidade de tentativas de conexo para cara uma delas. Retries=nmero de tentativas
Retries=2
23 de 44
Parmetro
Descrio
Exemplos
Observao
Compress
compress=TRUE compress=FALSE
chk_envelope
Parmetro usado para checar arquivos envelopados recebidos pelo Skyline. Arquivos envelopados tem uma caracteristica particular, composto por um header com informaes referentes ao nome da pasta em que ser gravado aps finalizar a recepao pelo Skyline, isto , se o parmetro chk_envelope estiver configurado conforme modelo abaixo: chk_envelope=yes -> ativa parmetro no -> desativa
chk_envelope=yes chk_envelope=no
Parmetro para configurar a pasta/diretrio de entrada, pasta onde so gravados os arquivos recebidos.
Para desktop: inbox=c:\Skyline\inbox inbox=Z:\Public\inbox inbox=\\CPU-Terra\inbox Para handheld: inbox=\Skyline\inbox\ Para Unix: inbox=/home/skyline/inbox/
Inbox
inbox=unidade local\caixa de entrada; inbox=unidade mapeada na rede\caixa de entrada; inbox=\\nome da mquina compartilhada na rede\caminho da caixa de entrada na rede;
Para confirgurar multiplos inbox usado a regra de nomenclatura do Skyline, ou seja, configurado junto com o parmetro asterstico. port*.*= port*.*@c:\Skyline\inbox \PORTAS\ jan*.*=jan*.*@c:\Skyline \inbox\JANELAS\
Outbox
Parmetro para configurar a pasta/diretrio de sada, pasta onde so gravados os arquivos serem enviados ao servidor. 1) Opes padres: 1.a. outbox=unidade local:\pasta de sada; 1.b. outbox=unidade mapeada na rede:\pasta de sada; 1.c. outbox=\\nome da mquina compartilhada na rede\caminho da pasta de sada; 1.d. outbox=caixa postal@unidade local:\pasta de sada; (Permite transmitir para um caixa postal especcifica um arquivo especfico) 2) Opes de multiplos outbox (virtuais): 2.a.outbox=caixa postal1, caixa postal2...@unidade local:\pasta de sada 2.b.outbox=caixa postal@unidade local:\pasta de sada outbox1=caixa postal1@unidade local:\pasta de sada outbox2=caixa postal2@unidade local:\pasta de sada 3) Opes de multiplos outbox (fsicos) 3.a. outbox=caixa postal@unidade local:\pasta de sada0 outbox1=caixa postal1@unidade local:\pasta de sada1 outbox2=caixa postal2@unidade local:\pasta de sada2
1) outbox=c:\skyline\outbox outbox=x:\IFV\skyline\outbox outbox=\\informatica\skyline\outbox outbox=70000@c:\skyline\outobx\*.t xt 2) outbox=70000,70001@c:\skyline\out box outbox=70000@c:\skyline\outbox\*.t xt outbox1=70001@c:\skyline\outbox\*. ini outbox2=70002@c:\skyline\outbox\*. log 3) outbox=70000@c:\skyline\outbox1\ outbox1=70001@c:\skyline\outbox2\ outbox2=70002@c:\skyline\outbox3\
Na opo 2 o arquivo a ser transmitido para cada destinatrio definido pela regra de nomenclatura dos arquivos. Na opo 3 o arquivo a ser transmitiro para cada destinatrio definido pela regra de nomenclatura das pastas.
24 de 44
Parmetro
Descrio
Parmetro para configurar a pasta/diretrio de backup, pasta onde so gravados os arquivos transmistidos com sucesso ao servidor. 1)Opo padro: 1.a.sentbox=unidade local:\pasta de backup\ 1.b.sentbox= unidade mapeada na rede:\pasta de backup\ 1.c.sentbox=\\nome da mquina compartilhada na rede\caminho da pasta de backup\ 1.d.sentbox= (vzio) Somente o parmetro senbox sem o caminho da pasta de backup, mantem o arquivo j transmitido na pasta de sada (outbox); 2)Opes de multiplos sentbox: (Esta trabalha em conjunto com o parmetro outbox) outbox=pasta de sada[caminha da pasta de backup] Parmetro para habilitar ou desabilitar arquivo de log concatenado. Este parmetro permite habilitar um log que guardar todos os session.log em um nico arquivo de forma concatenada, porem com o nome HISTORY.LOG. Este log atualizar a cada conexo e o arquivo gravado no raiz do diretrio onde se encontra instalado o Skyline.
Exemplos
Observao
Sentbox
Na opo 2 o arquivo a ser transmitido sempre estar amarrado a uma pasta de backup.
History
history=TRUE history=FALSE
Parmetro para gerar um arquivo de log sinttico. Para cada conexo criado um log, este log pode ser definido em que pasta poder ser salvo. Para evitar ser sobrescrito o make_report grava o log sempre com um contador sequncial de 3 dgistos mais a extenso .txt. Padro: make_report=unidade local\caixa de log\nome do log Informaes importantes: a) Cada arquivo de log tem as seguintes informaes: Um header com o nome da verso do cliente mais o nome do domnio; Sessao iniciada data e hora; Sessao finalizada data e hora. nome do arquivo recebido; nome do arquivo transmitido. b) O log gerado, tem a seguinte nomenclatura: nomelog_CCC.TXT Onde: nome_log = prefxo CCC = contador de 3 dgitos .TXT = exteno do arquivo de log
Make_report
25 de 44
Parmetro
Descrio
Parmetro para configurar o nome de uma caixa postal que ir receber um arquivo de log, conforme pr-definido, com o contedo do arquivo SESSION.LOG que apresentar qualquer tipo de erro. Neste parmetro configurado o nome do arquivo de log que ser gerado mais o nome da caixa postal que ir receber. Independente de qual caixa postal est configurada no parmetro defaultaddr, o parmetro error_file permite confiigurar uma caixa postal especfica para receber os logs da caixa postal que apresentar problemas. Padro: error_file=arquivo@caixa Parmetro para desabilitar o Bluetooth do pocket ao finalizar a conexo do Skyline Cliente.
Exemplos
Observao
error_file
error_file=arquivo@caixa
bthdisableatexit
Bth=bluetooth; disable=desativar; desabilitar at=ao exit=sair Portanto o parmetro quer dizer: desabilitar bluetooth ao sair.
bthdisable=TRUE
Este parmetro foi implementado para as verses de pocket a partir da verso 8.3 e para verses W32 a partir da verso 8.5
activate_bluetooth* Este parmetro foi desenvolvido a partir da verso 8.3 Desktop e 8.1 Pocket, para ser usado juntamente com o parmetro only_use_bluetooth_modem
only_use_bluetooth_modem* Este parmetro foi desenvolvido a partir da verso 8.3 Desktop e 8.1 Pocket, para ser usado juntamente activate_modem
26 de 44
try_all_modens* Ativa deteco automtica de modens e suas respectivas portas, seguindo uma ordem de prioridades: Ordem de prioridades dos modens: 1. Modens GPRS; 2. Modens USB 3. Modens PCMCIA 4. Modens Bluetooth 5. Modens IrDa 6. Built-in Modem
Quando habilitada a funo try_all_modens, o software Cliente Skyline lista todos os modens instalados na CPU, tais como, Modens GPRS(via celular), Adaptadores Bluetooth USB, Modens PCMCIA, Compact Flash Modem, modem SD, modens IrDA Generic, confirmando o nome e a porta que estes encontram-se instalados. Os modens so usados conforme a lista de prioridades. Exemplo de uma determinada situao no cliente: - Se o cliente possui dois tipos de modens instalados em seu computador, 1 GPRS e 1 PCMCIA, e se este apenas estiver com o PCMCIA Plugado, o skyline primeiramente ir tentar todos os tipos de conexo no modem GPRS, posteriormente no PCMCIA. Esta ordem foi definida, conforme uma demanda de um cliente da Nexxera, conforme sua situao atual.
Obs.1: A opo de usar este parmetro, Try_all_modens, ideal para clientes que utilizam modem "Externo" com tecnologias GPRS, Bluetooth, PCMIA, e os que usam o parmetro alternate(parmetro para alternar tipos de conexo), facilitando a automao no processo de conectividade.
Obs.2: O cliente poder optar, em usar o parmetro device_name, onde este possvel especificar, manualmente, o nome do modem que est sendo usado no momento, isso facilita para os clientes que possuem muitos modens instalados no desktop, e para clientes que utilizam algum tipo de modem que no fora homologado.
27 de 44
28 de 44
;-----------------------wsdll=winsock.dll wsaddr=nexxera.skyline.com.br:7700 retries=1 alternate=gprs *.*.*.*.*=*.*.*.*.* *.*.*.*=*.*.*.* *.*.*=*.*.* *.*=*.* *=* 1=M - Realizando a Conexo com o Servidor 2=W 30 TMCOM 3=* ;------------------------------;2 Conexo via GPRS ;------------------------------gprs.wsdll=winsock.dll gprs.wstitle=TCMDialer gprs.wsaddr=200.247.115.130:7700 gprs.dialto=*99***1# gprs.wsusername=tim gprs.wspassword=xxxxx gprs.activate_bluetooth=TRUE gprs.only_use_bluetooth_modem=TRUE gprs.modeminit=+cgdcont=1,"IP","gprs.oi.com.br" gprs.retries=2 gprs.alternate=internet *.*.*.*.*=*.*.*.*.* *.*.*.*=*.*.*.* *.*.*=*.*.* *.*=*.* *=*
internet.wstitle=TCMDialer internet.wsaddr=nexxera.skyline.com:7700 internet.dialto=078789332 internet.pabx=? internet.wsusername=username internet.wspassword=password internet.modeminit= internet.alternate=renpac internet.retries=3 internet.1=M - Realizando Conexao via internet internet.2=W 45 TMCOM internet.3=*
inbox=\skyline\inbox outbox=\skyline\outbox sentbox=\skyline\sentbox username=70000 defaultaddr=Matriz *.*=*.* *=* 1=W 30 TMCOM 2=*
Solucionando Problemas
Falha na Comunicao: Verificar a conexo do cliente: no prompt do DOS digite ping nexxera.skyline.com.br -t , o tempo ideal de resposta do link <= 200ms; Se o resultado do ping for request time out, verificar as configuraes de rede do
701 Skyline Server 4.0 (c)1995-2002 www.nexxera.com 701 Build 430 Linux i686 26/05/2003 12:03:29 707 TMCOM:TERMITE Se o telnet no apresentar nenhuma mensagem, verificar se o cliente possui firewall e orient-lo a liberar a porta 7700 para comunicao com o Skyline; Erro em DrvInit: Este erro acontece quando a porta de comunicao (no wtcm.ini parmetro modemport=COM?) esta errada ou no existe. Este erro s acontece nas conexes via Renpac; Usurio no cadastrado: Verificar no arquivo wtcm.ini o parmetro username=, provavelmente no esta configurado com o nome da caixa postal do cliente; O servidor no suporta criptografia: Verificar o link do cliente, atravs do comando ping. Provavelmente o tempo de
falha no sincronismo:
- quando o Cliente Skyline no consegue manter a conexo com o Servidor
/RA - Define que haver somente recepo. Plataforma: WinCE, Win32, UNIX, PALM /NTR Define que no haver transmisso nem recepo.Utilizado em conjunto com o parmetro /ARQ . Plataforma: Win32, UNIX /ARQ Transmite somente o arquivo definido na linha de comando. Por Plataforma: Win32, UNIX Exemplo: /ARQ=umArquivo /US Define o usurio do cliente. Plataforma: CE, Win32, UNIX, PALM Exemplo: /US=70000 /SE Define a senha do usurio. Plataforma: CE, Win32, UNIX, SE, PALM Exemplo: /SE=umaSenha /TE Define um arquivo que ser utilizado para configurar o cliente, por padro utiliza-se wtcm.ini. Plataforma: WinCE, Win32, UNIX Exemplo: /TE=novoArquivo /TOP Desativa o modo emulado. Plataforma: WinCE, Win32, UNIX /OP Fora o modo emulado mesmo que executvel no se chame operador.exe. Plataforma: WinCE, Win32 /DEBUG Mostra a comunicao detalhadamente. Plataforma: WinCE, Win32, UNIX /EXTDEBUG Parmetro INTIL!! Plataforma: WinCE, Win32, UNIX /UNPACK - Utilizado para descompactar os arquivos recebidos pelo cliente, que, por algum motivo, no o foram previamente descompactados. Plataforma: WinCE, Win32, UNIX /DEST Define o parmetro deafaultaddr. Plataforma: Win32, UNIX Exemplo: /DEST=valor /Q - Modo quieto. No mostra interface alguma, o Skyline roda em background.
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 35 de 44
Plataforma: UNIX /SESSION Define um novo nome para o arquivo de log, que por padro SESSION.LOG. Plataforma: UNIX Exemplo: /SESSION=novoLog /SERV Envia arquivos para mltiplos servidores com caixas postais distintas. Isso obtido atravs da associao dos parmetros wsaddr e outbox, wsaddr1 e outbox1, wsaddr2 e outbox2, e assim por diante. Plataforma: UNIX /UP Salva os arquivos recebidos com todas as letras maisculas. Plataforma: UNIX, PALM, PALM Conflito: No palm este parmetro possui significado diferente. Ele utilizado para forar a atualizao. /LOW - Salva os arquivos recebidos com todas as letras minsculas. Plataforma: UNIX /SW Define o creatorid do Skyline no palm. Plataforma: PALM
Regras Gerais
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 36 de 44
Linhas de Comando
Uma linha de comando do script deve seguir o formato: N=C argumentos Onde N a numerao de linha, em decimal, sem zeros na frente do nmero, C o comando do script (sempre uma nica letra), sendo seguido pelos argumentos opcionais do comando. No devem existir quaisquer espaos entre o nmero N, o sinal = e o comando C. Pode haver espaos opcionais entre o comando C e seus argumentos. Para encontrar a primeira linha do script, o mdulo verifica a existncia de linhas com numerao de 1 a 20. Se existir alguma linha nessa faixa, o script assumido como existente e iniciada sua execuo. Cada linha subseqente deve estar at, no mximo, vinte unidades aps a linha atual, como nos exemplos: Exemplo 1 10=... 20=... 40=...Esta linha lida. Exemplo 2 10=... 20=... 50=...Esta linha no ser encontrada.
37 de 44
O final da seqncia do caractere especial encontrado como o primeiro caractere no numrico. Dessa forma, no exemplo a seguir: Azt\101ca Neste caso o caractere \101 expressa a letra e, traduzindo ento para Azeteca.
Execuo
Na execuo no existe qualquer comando de controle de fluxo, que seja linear. O script assume trmino bem sucedido logo aps executar a ltima linha de comando disponvel com sucesso. No caso de algum erro (timeout, por exemplo) o script abortado imediatamente, forando o Skyline a realizar uma nova seqncia de discagem e conexo, executando, em seguida, novamente o script desde o incio.
Variveis
O interpretador de script dispe de uma rea de 8 buffers de 64 caracteres cada um, chamados de variveis. Essas variveis so utilizadas para leitura de dados, tanto do usurio quanto do sistema e so numeradas de 0 a 7. Sua utilizao se d atravs de macro-substituio. Antes da execuo, cada linha de script verificada em busca de referncias variveis, respectivamente $0 para a varivel 0, $1 para a varivel 1 e assim por diante, at $7. Sempre que uma ocorrncia de qualquer varivel verificada, a seqncia $n substituda no texto da linha pelo contedo da varivel. Dessa forma, pode-se exemplificar: a) Define-se uma varivel chamada de varivel2: varivel2="Florianpolis" b) A linha de script fica definida, ento, na forma: 10=M Estamos em $2 agora. c) Esta linha ser macro-substituda para: 10=M Estamos em Florianpolis agora. Nota IMPORTANTE: Variveis armazenando texto criptografado no podem ser impressas ou editadas, podendo apenas ser enviadas atravs da linha de comunicao.
38 de 44
Parmetros
Junto com o script podem ser armazenados parmetros diversos, modificveis facilmente com o auxlio de um editor de texto. Esses parmetros podem ser carregados para variveis durante a execuo do script e utilizados no processo de login. Um parmetro expresso da seguinte forma: nome_parmetro=valor No deve existir nenhum espao entre o nome do parmetro, o sinal = e o valor. O valor (que sempre uma string) se estende at o final da linha. Podem ser especificadas strings vazias, que tomam o formato: nome_parmetro= possvel armazenar valores criptografados, que podero ser lidos com um comando adequado da macro-linguagem de script.
Comandos e Sintaxe
Os comandos de script podem ser divididos nas seguintes categorias: I. Interface com o usurio (leitura e escrita de dados no console). II. Leitura de parmetros (dados armazenados junto com o script). III. Comunicao (leitura e escrita de dados na linha de comunicao). Resumidamente, so eles: M - Imprime mensagens no console. I - L uma string digitada pelo usurio no console. P - L uma senha digitada pelo usurio no console. R - L um parmetro. K - L um parmetro criptografado. S - Envia uma string pela linha de comunicao. W - Aguarda uma string ou um timeout. Em seguida ser apresentada uma descrio de todos os comandos. Parmetros opcionais so apresentados entre [colchetes].
39 de 44
Comando M
O comando M imprime mensagens no console, avanando uma linha. Se string for nula o comando apenas far avanar uma linha. A sintaxe segue o formato: M [<string>] Neste caso o argumento <string> uma string opcional que ser impressa. Um exemplo completo deste comando citado abaixo: 1=M Mensagem escrita
Comando I
O comando I l uma string digitada pelo usurio no console. A sintaxe para a escrita demonstrada a seguir: I <var> <tam> O parmetro <var> o ndice da varivel a ser utilizada, e o parmetro <tam> o tamanho mximo da string a ser editada. Se a varivel <var> contm previamente uma string, ela ser editada. Aps o usurio teclar <Enter>, a string editada ficar registrada na varivel <vars>, podem ser impressos no console, transmitida pela linha de comunicao, etc. Exemplo: 2=I 1 10 Neste caso a varivel a varivel 1, sendo seu tamanho mximo de 10 caracteres.
Comando P
Este comando processa a leitura de uma senha digitada pelo usurio no console. O processamento idntico ao comando I, porm neste caso a string no apresentada diretamente ao usurio. Exemplo: 3=P 2 8 Para este exemplo a senha armazenada na varivel 2, sendo seu tamanho mximo de 8 caracteres.
Comando R
L um parmetro armazenado juntamente com o script. A sintaxe descrita abaixo: R <var> <parm> [ <default> ] parmetros: <var> ndice da varivel a ser usada.
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 40 de 44
<parm> nome do parmetro que ser lido. <default> valor default do parmetro, se ele no existir. A string associada ao parmetro copiada para a varivel <var>. Se a varivel no existir, ser copiado para a varivel <var> a string <default>. Se, alm disso, a string <default> no existir, ser copiada uma string nula para a varivel <var>. Exemplo: 4=R 1 username 70000 Neste caso, o parmetro username copiado para a varivel1. Se nenhum valor for especificado, o valor default ser atribudo varivel.
Comando K
L um parmetro criptografado. A descrio idntica ao comando R, inclusive a forma de utiliz-lo. Entretanto, a string associada ao parmetro deve ser previamente criptografada. Se o parmetro <default> for utilizado, tambm deve apresentar-se criptografado.
Comando S
Este comando utilizado para enviar uma string pela linha de comunicao. A string enviada caractere por caractere, independente do meio em uso. No enviado nenhum caractere extra, alm da string, dessa forma, para enviar <RETURN>, por exemplo, necessrio adicion-lo manualmente na string, utilizando a seqncia \13. A sintaxe descrita a seguir: S <string> O Parmetro: <string> uma seqncia de caracteres, a qual ser transmitida. Exemplo: 5=S login\13 Neste exemplo enviada a string login, seguida de <ENTER>.
Comando W
Aguarda uma string ou um timeout. Este comando assume trs formas bsicas. Na primeira, se apenas o parmetro <timeout> for especificado, ele realizar uma pausa de <timeout> (tempo em segundos) no processamento. Na Segunda forma, ele aguardar at no mximo <timeout>
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 41 de 44
(tempo em segundos) pelo surgimento da string <string_ok>, na linha de comunicao. Se o timeout for esgotado, o comando abortar o script. Na terceira forma, ele ir aguardar at <timeout> (tempo em segundos) pelo surgimento, tanto de <string_ok> quanto de <string_falha> na linha. Se <string_ok> aparecer, o comando finalizar indicando sucesso. Se houver timeout ou <string_falha> surgir, o comando abortar a execuo do script. A sintaxe definida abaixo: W <timeout> [ <string_ok> [ <string_falha> ] ] Parmetros: <timeout> Timeout do comando, em segundos.<string_ok> String a ser procurada. <string_falha> String indicativa de falha. Nota: Tanto <string_ok> quanto <string_falha> so verificadas como sub-strings, nas linhas de texto que chegarem pela linha de comunicao. Portanto, se uma das strings for especificada como assw, ela ser identificada com sucesso se na linha de comunicao ocorrer a string Password. Exemplo: 6=W 30 Password Neste exemplo o programa aguarda pela string Password, ou pelo <timeout> de 30 segundos.
CLR OCC
CLR INV
CLR NC
CLR DER
CLR NA
42 de 44
CLR NP
CLR RPE
Erro de procedimento remoto. A rede detectou erro de procedimento do assinante remoto. Erro de procedimento local. A rede detectou erro de procedimento do assinante local.
CLR ERR
CLR PAD
A chamada foi desfeita pr solicitao do assinante remoto, atravs de procedimentos do protocolo X.29.
Mensagens de Servio
Os mnemnicos das mensagens de desconexo que o assinante do RENPAC 2028 poder receber so:
MNEMNICO SIGNIFICADO
DTE .......................O assinante remoto solicitou a desconexo ou a reinicializao. OCC ......................Nmero ocupado. O assinante chamado est com todos os seus canais lgicos ocupados em outras ligaes. INV .......................O assinante chamador solicitou uma facilidade no disponvel. NC ...................... Congestionamento da rede ou condio anormal temporria da rede. DER ..................... O nmero chamado est fora de servio. NA ..................... Acesso bloqueado. O assinante chamador no est autorizado a se conectar ao assinante chamado. NP.......................O nmero chamado no existe na rede. RPE .....................Erro de procedimento remoto. A rede detectou erro de procedimento do assinante remoto. ERR .................... Erro de procedimento local. A rede detectou erro de procedimento do assinante local e detalha este erro com uma mensagem em ingls. RNA .....................O assinante chamado no aceita chamada a cobrar. PAD .................... A chamada foi desfeita por solicitao do assinante remoto, atravs de procedimentos de protocolo X.29. ID ......................... Indica que origem e destino possuem tamanho de pacote ou classe de throughput incompatvel. CONF ..................... Confirma a desconexo solicitada pelo assinante chamador.
Nexxera Seu Ambiente Eletrnico de Negcios Setor de Desenvolvimento 43 de 44
Prmios 2005
Em 2005 a nexxera foi reconhecida nacionalmente pelas principais instituies do Brasil.
Top de Marketing - o prmio mais concorrido do setor. Destinado s organizaes que primam pela melhor sustentao de seu produto, servio ou marca usando tticas inovadoras e consistentes de marketing.
Marketing Best - Realizado anualmente, h 18 anos pela Fundao Getlio Vargas, o prmio tem por objetivo promover e difundir as empresas que mais se destacam no planejamento e execuo das estratgias de Marketing de seus produtos e/ou servios.
Top de Vendas - Uma homenagem s empresas que conseguiram alcanar resultados positivos em vendas. um dos mais tradicionais prmios da ADVB e uma oportunidade de reconhecer o empenho de seus profissionais.
FINEP - A FINEP privilegia em sua atuao o apoio a empresas e instituies que investem no desenvolvimento de novos produtos e processos, na busca contnua da inovao e da liderana tecnolgica.
44 de 44