Manual do

Usuário

Arquitetura do Manager Windows

Cód: GCAR0004
Revisão: 11
Data: 16/04/2012
 Índice

Índice

Introdução ........................................................................................................... 3
Estrutura .............................................................................................................. 4
Trabalho .......................................................................................................... 4
Programas ............................................................................................... 4
Arquivos de Configuração ........................................................................ 4
Executáveis .............................................................................................. 6
Arquivos de Trabalho ............................................................................... 6
Zeus Mirage (Gerenciamento de Serviços) ............................................... 8
Licença de Uso................................................................................................. 9
Bibliotecas (libs) ........................................................................................... 10
Comunicação ................................................................................................. 11
Path_comum (Servidor de Arquivos) ............................................................. 12
Logs .............................................................................................................. 14
Interações entre o aplicativo e o Web Server e/ou Banco de Dados ...... 14
Principais interações com o Kernel ........................................................ 14
Interações com o servidor de licenças (SLS) ......................................... 14
Programas Complementares / Auxiliares ........................................................... 15
Apache .......................................................................................................... 15
Estrutura................................................................................................ 15
Configuração .......................................................................................... 15
Logs ....................................................................................................... 15
PHP ............................................................................................................... 15
Estrutura................................................................................................ 16
Configuração .......................................................................................... 16
Logs ....................................................................................................... 16
Zend Optimizer .............................................................................................. 16
Estrutura................................................................................................ 16
Configuração .......................................................................................... 16
 Introdução

Introdução

Este documento tem o objetivo de oferecer um melhor entendimento em relação à estrutura

do aplicativo Zeus Manager versão 1.6 baseado em Windows (NT, 2000, 2003 e XP).

A comunicação realizada em os módulos do Zeus Manager e também com aplicações internas

é feita através de Web Services.

Web service é uma solução utilizada na integração de sistemas e na comunicação entre

aplicações diferentes. Com esta tecnologia é possível que novas aplicações possam interagir com
aquelas que já existem e que sistemas desenvolvidos em plataformas diferentes sejam compatíveis.
Os Web services são componentes que permitem às aplicações enviar e receber dados em formato
XML. Cada aplicação pode ter a sua própria "linguagem", que é traduzida para uma linguagem
universal, o formato XML.

Essencialmente, o Web Service faz com que os recursos da aplicação do software estejam
disponíveis sobre a rede de uma forma normalizada. Outras tecnologias fazem a mesma coisa, como
por exemplo, os browsers da Internet acedem às páginas Web disponíveis usando por norma as
tecnologias da Internet, HTTP e HTML. No entanto, estas tecnologias não são bem sucedidas na
comunicação e integração de aplicações. Existe uma grande motivação sobre a tecnologia Web
Service pois possibilita que diferentes aplicações comuniquem entre si e utilizem recursos diferentes.

Utilizando a tecnologia Web Service, uma aplicação pode invocar outra para efetuar tarefas
simples ou complexas mesmo que as duas aplicações estejam em diferentes sistemas e escritas em
linguagens diferentes. Em outras palavras, os Web Services fazem com que os seus recursos
estejam disponíveis para que qualquer aplicação cliente possa operar e extrair os recursos
fornecidos pelo Web Service.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 3

 Trabalho

Estrutura
Apresentamos abaixo a estrutura que compõe o Zeus Manager.

Trabalho

O Zeus Manager trabalha com um diretório padrão onde estão seus principais arquivos.

Os arquivos ficam instalados em /Zanthus/Zeus/Apache2/htdocs/manager.

Abaixo um resumo dos arquivos que compõem esta pasta.

Programas

Responsáveis pela execução dos programas que compõem o aplicativo Zeus Manager. Estes
arquivos são feitos em PHP e possuem a extensão .php5.

Os arquivos ficam instalados na raiz da pasta.

Além dos arquivos .php5, existem outros arquivos e pastas abaixo, que contém arquivos
auxiliares a execução dos programas php nas pastas /classes, /css, /flex, /fontes, /imagens,
/includes, /JavaScript, /PDF, /Pear, /serviço, /web_services e /xmlForm.

Arquivos de Configuração

São os arquivos responsáveis pelas características de funcionamento do sistema, de acordo

com ambiente e padrões de uso.

O arquivo de configuração pode ser gravado em duas pastas: na raiz do diretório acima ou
em /Zanthus/Zeus/Manager.

Abaixo o arquivo de configuração utilizado pelo Zeus Manager

ZMWSInfo.ini

Utilizado para definir os parâmetros de comunicação com o servidor Web Service, com o
servidor de banco de dados e com o Zeus SLS.

Os principais parâmetros que devem ser configurados no arquivo ZMWSInfo.ini são:

Seção [GERAL]

User= xxx (usuário para conexão com o banco de dados);

Passwd= xxx (senha do usuário para conexão com o banco de dados);

Seção [SLS]

Servidor=xxx (endereço do servidor de licenças SLS. Necessário caso o servidor

SLS esteja em outra máquina);

Seção [INFOZMWS]

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 4

 Trabalho
IDBanco=n (Código do banco de dados utilizado: 1 – Oracle, 2 SQL Server ou 3
– Postgresql);

IPBancoZM=xxx (Endereço do servidor onde está o banco de dados de

cadastros do Zeus Manager).

IPBancoMov=xxx (Endereço do servidor onde está o banco de dados de

movimentos do Zeus Manager).

IPBancoPed=xxx (Endereço do servidor onde está o banco de dados de pedidos

do Zeus Manager).

Seção [ORACLE]

Somente para usuários de banco Oracle.

DatabaseNameBase=xxx (Nome da base de dados de cadastros do Zeus

Manager);

DatabaseNameMov=xxx (Nome da base de dados de movimentos do Zeus

Manager);

DatabaseNamePed=xxx (Nome da base de dados de pedidos do Zeus

Manager);

Seção [POSTGRESQL]

Somente para usuários de banco Postgresql.

DatabaseNameBase=xxx (Nome da base de dados de cadastros do Zeus

Manager);

DatabaseNameMov=xxx (Nome da base de dados de movimentos do Zeus

Manager);

DatabaseNamePed=xxx (Nome da base de dados de pedidos do Zeus

Manager);

Seção [MSSQL]

Somente para usuários de banco SQL Server.

DatabaseNameBase=xxx (Nome da base de dados de cadastros do Zeus

Manager);

DatabaseNameMov=xxx (Nome da base de dados de movimentos do Zeus

Manager);

DatabaseNamePed=xxx (Nome da base de dados de pedidos do Zeus

Manager);

As informações detalhadas para configuração do arquivo ZMWSInfo.ini podem ser obtidas no

manual M032.PDF.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 5

 Trabalho

Executáveis

Arquivos extraídos do mesmo pacote utilizado pelo PDV, estes arquivos ficam na pastas
/kernzphp.

Os principais arquivos são:

W_CONV.EXE

Executável responsável pela conversão dos arquivos binários (.TRA) em arquivos texto (.SDF)
e vice-versa.

Este processo de conversão não é obrigatório, porém pode ser executado no próprio servidor
Manager para eventuais depurações e análise dos arquivos.

ROTKERNC.DLL

Biblioteca que contém as principais informações da versão em uso utilizada para conexão
com o PHP.

Arquivos de Trabalho

São os arquivos que contêm os binários relacionados aos registros de cadastros. Estes
arquivos são gerados no processo de carga na pasta /Kernel/n onde n corresponde ao número da
loja que teve o cadastro gerado.

Os principais arquivos de trabalho são:

TH00XXXX.TRA

Arquivo que contém as informações relacionadas às parametrizações do sistema.

TH02XXXX.TRA

Arquivo que contém as informações relacionadas ao movimento do operador.

TH05XXXX.TRA

Arquivo que contém as informações do cadastro de departamentos.

TH06XXXX.TRA

Arquivo que contém as informações do cadastro de produtos.

TH20XXXX.TRA

Arquivo que contém as informações do cadastro de produtos alterados.

TH07XXXX.TRA

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 6

 Trabalho

Arquivo que contém as informações relativas à última carga de cadastros realizada

TH09XXXX.TRA

Arquivo que contém as informações do cadastro de formas de pagamento.

TH10XXXX.TRA

Arquivo que contém as informações do cadastro de clientes.

TH11XXXX.TRA

Arquivo que contém as informações do cadastro de pagamentos/recebimentos.

TH12XXXX.TRA

Arquivo que contém as informações do cadastro de decomposição de produtos.

TH14XXXX.TRA

Arquivo que contém as informações do cadastro de planos de pagamento.

TH15XXXX.TRA

Arquivo que contém as informações do cadastro de coeficientes (utilizados em planos de

pagamentos).

TH16XXXX.TRA

Arquivo que contém as informações do cadastro de funcionários.

TH17XXXX.TRA

Arquivo que contém as informações do cadastro de permissões.

TH18XXXX.TRA

Arquivo que contém as informações do cadastro de textos.

TH21XXXX.TRA

Arquivo que contém as informações do cadastro de promoções.

TH22XXXX.TRA

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 7

 Trabalho
Arquivo que contém as informações dos produtos / seções vinculados a promoções.

Zeus Mirage (Gerenciamento de Serviços)

Além das operações executadas através do Zeus Manager, existem alguns processos que
envolvem atividades que precisam ser executadas periodicamente sem a intervenção de um usuário.

Estes processos são gerenciados pelo serviço Zeus Mirage, que é instalado juntamente com o
Zeus Manager e está baseado na pasta /servico a partir da pasta raiz do aplicativo.

O Zeus Mirage também é adicionado aos serviços do Windows e é acionado pelo Gerenciador
de Serviços do Windows ou pelo Gerenciador de Serviços do Zeus Manager.

Atualmente, o Mirage é responsável pela execução dos seguintes serviços:

· Geração de carga automática;

· Geração do arquivo de movimento em formato SDF;
· Notificação de problemas na carga;
· Envio de e-mail de notificações.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 8

 Licença de Uso

Licença de Uso

Os arquivos responsáveis pela licença de uso são gerenciados pelo aplicativo Zeus SLS que
após instalado fica disponível na lista de serviços do Windows, no caminho /Zanthus/Zeus/SLS.

O serviço é iniciado juntamente com a inicialização do Windows e deve permanecer ativo

para que o sistema Zeus Manager possa ser carregado.

Opcionalmente, o serviço Zeus SLS pode ser instalado em máquina diferente do servidor
Zeus Manager.

Seus principais arquivos são:

Zeus_SLS.exe

Serviço responsável pelo controle e gerenciamento de licenças do Manager e dos PDVs).

Zeus_Codmaq.exe

Executável responsável por coletar os dados do servidor de licenças.

Zeus_GerPDV.exe

Executável responsável por coletar os dados dos ECFs.

ZEUS_SRV.INI

Arquivo que contém as configurações necessárias para a conexão com o serviço Zeus_SLS.

ZEUS_PDV.INI

Arquivo que contém as configurações necessárias para a conexão com o executável

Zeus_GerPDV.exe.

*.ZZS

Arquivo que contém as informações do servidor de licenças geradas pelo executável

Zeus_Codmaq.exe.

*.ZCP

Arquivo que contém as informações dos ECFs geradas pelo executável Zeus_GerPDV.exe.

*.ZLC

Arquivo gerado no site Zanthus, que contém as informações de liberação do Zeus Manager.

*.ZLP

Arquivo gerado no site Zanthus, que contém as informações de liberação dos ECFs.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 9

 Bibliotecas (libs)

Bibliotecas (libs)

Nas soluções baseadas em Windows, o executável não é o único responsável pelo

funcionamento do aplicativo.

O executável contém as principais rotinas e regras de negócios e faz uso de bibliotecas (libs)
para diversas funções, como:

Interface de comunicação;
Interação com o PHP;
Interação com o Web Server;

Os arquivos são carregados na pasta /Zanthus/Zeus/DLL e são gravados com a extensão

*.DLL.

A inexistência de um arquivo destes impede a execução do aplicativo Zeus Manager ou pode

gerar erros caso o aplicativo esteja utilizando uma versão desatualizada.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 10

 Comunicação

Comunicação

Para que o Zeus Manager possa se comunicar com o PDV ele precisa do protocolo TCP/IP
carregado em sua inicialização.

A comunicação é baseada no protocolo TCP/IP que é configurado na instalação do sistema

operacional Windows.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 11

 Path_comum

Path_comum (Servidor de Arquivos)

Algumas interações realizadas entre o Zeus Manager e os PDVs não ocorre por comunicação,
mas sim pela troca de arquivos.

Para que esta troca ocorra é necessário que exista uma pasta de uso comum pelo servidor
Zeus Manager e pelos PDVs.

Por ser uma área de troca, o caminho é definido no momento de instalação do sistema. Por
padrão utiliza-se a pasta /Zanthus/Zeus/path_comum.

Os principais arquivos e pastas que podem existir neste caminho são:

VerAtu.tar.gz

Arquivo que contém o pacote com os executáveis que compõem a versão do PDV. O arquivo
original, disponível no ftp deve receber o nome acima para que seja lido pelo PDV.

Ao entrar no ar, o PDV verifica a existência deste arquivo na raiz do path_comum, compara
com o arquivo que possui localmente e, se forem diferentes, copia o arquivo e faz os procedimentos
de atualização.

/so

Pasta que contém as bibliotecas que deverão ser utilizadas pelo PDV. Os arquivos desta
pastas devem ser copiados juntamente com a atualização do arquivo VerAtu.tar.gz.

/LICENCA e /LICSLS

Pasta com arquivos que possuem as informações relativas ao ECF, capturadas pelo programa
Zeus_GerPDV.exe.

Seu conteúdo é atualizado na inicialização do PDV.

/CTRL

Pasta que contém informações relacionadas a preparação da carga de cadastros e

informações sobre os PDVs que já executaram a carga.

/DADO

Pasta que contém os cadastros preparados pelo processo de carga de cadastros e que serão
carregados pelos PDVs. Os arquivos podem estar no formato original ou compactados.

/ECFCFG

Pasta que contém os arquivos de configuração de Finalizadoras e Comprovantes Não Fiscais

que serão carregados pelos PDVs evitando a configuração um a um.

Seu conteúdo é carregado na inicialização do PDV.

/GERALCFG
Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 12
 Path_comum

Pasta que pode conter todos os arquivos de configuração do PDV (.CFG) que serão
carregados pelos PDVs evitando a configuração um a um.

Seu conteúdo é carregado na inicialização do PDV ou pode ser atualizado a qualquer

momento com a execução da função 859 no PDV.

/EXISTE

Pasta que deve ser criada no servidor de arquivos, evitando que no sistema Linux a pasta
path_comum seja uma pasta local.

O processo de carga só é executado se a pasta existir e for visível pelo PDV.

/MV

Pasta que é criada pelo PDV se houver a execução da função 189 (recuperação de movimento
em área comum), onde serão gravados os arquivos de movimento do PDV em formato binário.

A estrutura da pasta será: AAAAMMDD.PDV, onde AAAA é o ano, MM é o mês, DD é o dia e

PDV é o número de ordem do PDV.

/TRAZARQ

Pasta que contém as informações de liberação de uso dos PDVs.

Seu conteúdo é carregado na inicialização do PDV ou pode ser atualizado a qualquer

momento com a execução da função 6060 no PDV.

/PERIFCFG

Pasta que contém as configurações dos periféricos dos PDVs, a partir de um arquivo XML.

Ao entrar no ar, o programa do PDV verifica a existência, no diretório de trabalho, de um

arquivo de nome PERI_CFG.XML. Se esse arquivo existir, a execução continua normalmente. Caso
contrário, o PDV tentará copiar o arquivo PERIFCFG.XML do diretório PERIFCFG/nnn do path
comum (onde nnn é o número do ECF em uso) ou, se esse arquivo específico do ECF não existir, do
diretório PERIFCFG do path comum. O arquivo que tiver sido copiado é então lido, para atualizar
as configurações dos periféricos, e renomeado para PERI_CFG.XML (de tal forma que nada aconteça
na próxima verificação).

Para gravar as informações que serão usadas por outros PDVs, utilizar a função 876.

Para gravar as informações que posteriormente serão utilizadas somente para o mesmo PDV,
utilizar a função 879.

/RFD0

Pasta que contém as informações relacionadas ao Registro de Fita Detalhe de um PDV num
determinado período.

As informações podem ser gravadas ao final do dia, após a redução Z ou podem ser gravadas
pela utilização das funções 8242 ou 8245.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 13

 Logs

Logs

O aplicativo Zeus Manager gera logs em diversas situações.

Abaixo os tipos de logs gerados e as formas para geração e obtenção dos arquivos.

Interações entre o aplicativo e o Web Server e/ou Banco de Dados

O aplicativo gera o arquivo zeusmanager.zlg na pasta LOGS/AAAAMMDD encontrada em

/Arquivos de Programas/Apache Group/Apache 2/htdocs/manager/ ou /Program Files/Apache
Group/Apache 2/htdocs/manager/.
.

Para a criação do log de todas as rotinas, é necessária a ativação do mesmo, o que é feito no
arquivo ZMWSInfo.ini, com a inclusão da seção [DEBUG]:

ATIVO=S (Indica que o log será ativado).

LOGFILE=S (Indica que o arquivo será gravado).
NIVEL=n (Nível de detalhamento do log, que pode variar de 1 a 7).

Principais interações com o Kernel

O aplicativo gera o arquivo AAAAMM00.ZL1 (onde AAAA indica o ano e MM o mês), que é
gravado na pasta LOGGERAL encontrada a partir da pasta /Arquivos de Programas/Apache
Group/Apache 2/htdocs/manager/Kernel/n/ ou /Program Files/Apache Group/Apache
2/htdocs/manager/Kernel/n/.

Interações com o servidor de licenças (SLS)

O aplicativo gera o arquivo Zeus_srv.zlg que é gravado na pasta /Zanthus/Zeus/SLS .

Para que o arquivo gere um log detalhado das operações, é necessário criar um arquivo
chamado DEBUG_LISTA.ZAN na mesma pasta.

IMPORTANTE

Qualquer tipo de log DETALHADO deve permanecer ativo SOMENTE durante o período de análise e
coleta.

Ao término de uso, o mesmo deve ser desativado, pois durante sua execução, o consumo de
recursos e espaço em disco do equipamento é maior, podendo prejudicar a performance do sistema.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 14

 Inicialização

Programas Complementares / Auxiliares

Para que o Zeus Manager possa ser executado corretamente é necessário que outros
programas sejam instalados para complementar sua solução. São eles:

Apache

Servidor Apache é um servidor Web livre responsável pela execução de instruções http,
sendo o responsável pela execução das operações do Zeus Manager.

Estrutura

O Servidor Apache utiliza como pasta de trabalho a pasta /Arquivos de Programas/Apache

Group/Apache 2/ ou /Program Files/Apache Group/Apache 2/.

Configuração

O principal arquivo de configuração do Apache é o arquivo HTTPD.CONF que é encontrado

na pasta /Arquivos de Programas/Apache Group/Apache 2/conf ou /Program Files/Apache
Group/Apache 2/conf.

Além das configurações padrões, o arquivo recebe algumas informações relacionadas ao

aplicativo Zeus Manager, não sendo recomendada sua manutenção sem orientação da Zanthus.

Logs

O servidor Apache possui arquivos responsáveis pelos logs, arquivos estes encontrados em
/Arquivos de Programas/Apache Group/Apache 2/logs/ ou /Program Files/Apache Group/Apache
2/logs.

Ele gera dois arquivos de log:

Access.log

Arquivo que contém os logs de acesso ao servidor Apache.

Error.log

Arquivo que contém os logs de erros em solicitações feitas ao servidor Apache.

PHP

PHP (um acrônimo recursivo para "PHP: Hypertext Preprocessor") é uma linguagem de
programação de computadores interpretada, livre e muito utilizada para gerar conteúdo dinâmico na
WEB, sendo a base de desenvolvimento dos programas do Zeus Manager.

Permite a conexão com diversos sistemas operacionais e com diversos gerenciadores de

banco de dados.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 15

 Inicialização
Estrutura

O PHP utiliza como pasta de trabalho a pasta /Arquivos de Programas/PHP/ ou /Program

Files/PHP/.

Configuração

O principal arquivo de configuração do PHP é o arquivo php.ini que é encontrado na pasta

/Arquivos de Programas/PHP ou /Program Files/PHP.

Além das configurações padrões, o arquivo recebe algumas informações relacionadas ao

aplicativo Zeus Manager, não sendo recomendada sua manutenção sem orientação da Zanthus.

Logs

O log de erros do PHP utiliza o mesmo arquivo do servidor Apache, encontrado em em

/Arquivos de Programas/Apache Group/Apache 2/logs/ ou /Program Files/Apache Group/Apache
2/logs.

As informações ficam no arquivo error.log.

Zend Optimizer

Zend Optimizer é um utilitário que possibilita a otimização de PHP, linguagem usada no

desenvolvimento de páginas dinâmicas do Zeus Manager

A plataforma Zend foi criada especificadamente para ajudar otimização dos processamentos
mais robustos, que são gerados devido ao grande tráfego que os programas com base em PHP
proporcionam.

Além disso, é responsável por decodificar os programas PHP do Zeus Manager que são
codificados no momento de sua compilação, impedindo sua abertura e evitando a cópia do código.

Estrutura

O Zend utiliza como pasta de trabalho a pasta /Arquivos de Programas/Zend/ ou /Program

Files/Zend/.

Configuração

Como trabalha em conjunto com o PHP as suas informações são ativadas no arquivo de
configuração do PHP, o arquivo php.ini que é encontrado na pasta /Arquivos de Programas/PHP ou
/Program Files/PHP.

Além das configurações padrões, o arquivo recebe algumas informações relacionadas ao

aplicativo Zeus Manager, não sendo recomendada sua manutenção sem orientação da Zanthus.

Arquitetura do Manager Windows - GCAR0004 – Rev.2 Data: 16/04/2012 Pág. 16