Gerenciamento

O COBOLware dispõe de um sofisticado sistema de gerenciamento de aplicativos que se adapta ao perfil operacional da empresa sem necessidade de programação. Os menus são definidos por parametrização e os usuários são cadastrados por grupos. Desta forma os menus são personalizados ou seja, somente os itens pertinentes à rotina de trabalho de um usuário são exibidos.

O gerenciador possui 4 modalidades de operação em função da plataforma hospedeira e das preferências do usuário. Como um programa compilado com o COBOLware produz programas independentes de plataforma e de tipo de interface, a seleção do ambiente operacional será definida pelo atalho de execução do gerenciador.

Gráfico	cwmenuG.exe
Texto em janela	cwmenuT.exe
Texto em tela DOS	cwmenuF.exe
Texto em Unix	cwmenu

Os parâmetros que configuram o gerenciador são armazenados em um arquivo indexado (cwconf e cwconf.idx) formando o perfil de um sistema. Uma instalação pode possuir inúmeros sistemas, cada qual com o seu arquivo de configuração. O atalho de ativação de um sistema deve partir da pasta de instalação do gerenciador e declarar em qual pasta este arquivo está armazenado (/D:) e de qual pasta devem ser carregados os binários, sejam eles .int, .gnt ou .dll (/C:).

Exemplo:

Supondo que o gerenciador esteja instalado em C:\COBOLware, o configurador do sistema de estoque resida na pasta F:\estoque e os binários em F:\programas\cil e que o usuário tenha preferência pela interface gráfica:

C:\COBOLware\cwmenuG.exe /d:F:\ estoque /c:F:\programas\cil

No ambiente Unix seria prático escrever um pequeno shell. Supondo que o gerenciador esteja instalado em /opt/COBOLware, o configurador do sistema de estoque na pasta /estoque e os binários em /programas/cil, o shell teria o seguinte conteúdo:

cd /opt/COBOLware
./cobware . cwmenu /d:/estoque /c:/programas/cil

Para executar o gerenciador no amiente Unix é necessário instalar os binários específicos para Unix que podem ser obtidos por download em http://www.COBOLware.com/download/cobolware5.zip.

A instalação do gerenciador em Unix requer apenas a criação de uma pasta e descompressão do arquivo.

Exemplo:

mkdir /opt/COBOLware
cd /opt/COBOLware
tar -xvf COBOLware5.tar

Assim que é executado, o gerenciador abre o arquivo de configuração na pasta indicada. Se o arquivo não for encontrado será emitida uma mensagem de erro e o gerenciador se encerra. Por segurança não existe a opção de criação pelo gerenciador. Um arquivo de configuração básica de exemplo pode ser encontrado no diretório de instalação.

Existindo uma configuração válida o gerenciador solicita usuário e senha de logon no sistema. No arquivo básico está cadastrado apenas o usuário SUPERVISOR com a senha inicial COBOL.

Modo gráfico

Modo texto

Informando usuário e senha será exibido o menu conforme o perfil configurado:

No modo gráfico.

No modo texto.

Configuração
Modo Help
Spool

O gerenciador disponibiliza help de contexto. Teclando F1 é exibido o help correspondente ao campo em que estiver posicionado o cursor, teclando ALT-H o help é editado.

Algumas opções de customização do gerenciador são configuradas através de variáveis de ambiente que podem ser declaradas no sistema operacional ou no arquivvo cwmenu.ini.

Variáveis reconhecidas:

CCITCP2	Endereço IP do servidor FileShare.
CWACCENT	Off, Remove acentuação.
CWACCENTCONTROL	Off, Desabilita o suporte ao controle acentuação do modo texto.
CWATTRIBUTE	nnn, Código de cor inicial para programas oriundos do COBOL II Plus da Microbase..
CWAUTO	On, Ao preencher totalmente um campo, passa automáticamente para o próximo.
CWAUTOFSERROR	Off, Desabilita tratamento automático de mensagens de erro de FILE STATUS para programas compilados com a diretiva CALLFH”CWSQLC”.
CWAUTORETRYLOCK	Off, Desabilita tentativa automática de re leitura de registros travados para programas compilados com a diretiva CALLFH”CWSQLC”.
CWAUTOSPOOL	On, Habilita o direcionamento automático para spool de relatórios assinalados para PRINTER para programas compilados com a diretiva CALLFH”CWSQLC”.
CWBACKDEFAULT	N, Código de cor de fundo default para o modo texto.
CWBEEP	Off, Desabilita o sinal sonoro de todos os ACCEPTs.
CWBOXR	Off, Desabilita o tratamento do modo radion button na opção NOERASE da CWBOXR no modo gráfico.
CWCASE	Upper, Variáveis convertidas para maiúsculas Lower, Variáveis convertidas para Minúsculas.
CWCASE-INPUT	Upper, Digitação convertida para maiúsculas Lower, Digitação convertida para Minúsculas.
CWCELL-HEIGHT	Altura do caractere em pixels no modo gráfico.
CWCELL-WIDTH	Largura do caractere em pixels no modo gráfico.
CWCLEAR	Off, Desliga a limpeza de tela no inicio da execução no modo gráfico.
CWCOBSW xn	On/Off, Liga ou desliga RTS switches, x = letra da swiche e n = número da swiche, são interpretados somente via cwmenu.ini. Exemplos: CWCOBSW N=On CWCOBSW P1=Off
CWCOLORBARR	nnn, Código de cor da barra de menu do gerenciador no modo texto.
CWCOLOR-BARR	nnn, Código de cor da barra de menu de todos os menus no modo texto
CWCONF	Nome alternativo para o arquivo de configuração cwconf.
CWCONF-FS	On, Habilita o tratamento do arquivo de configuração cwconf via FileShare.
CWICON	Nome do arquivo de icone a ser usado na janela no modo gráfico.
CWCONTROL	Off, Desabilita a interpretação de WITH CONTROL em DISPLAY no modo gráfico.
CWCURSOR-COLOR	Código de cor do entry-field cursor no modo gráfico.
CWDISABLED-COLOR	Código de cor dos entry-fields desabilitados no modo gráfico.
CWDISPLAY-BARR	On, Exibe "/" em campos editados com "/" e cláusula BLANK ZERO mesmo com valor zero no modo texto.
CWDRIVE	Off, Remove a definição de letras de drive no retorno do comando GetFile Label.
CWEDITNUM	On, Permite a alteração valores numéricos editados.
CWENDK	On, Trata a tecla End como interrupção.
CWENTER-TERMINATE	On, Faz com que a tecla enter encerre o aceite de todos os itens da tela/janela.
CWENTRY	Off, Desabilita a emulação de aparência de entry-field no modo texto.
CWERRORMAIL	Destinatário de emails para relato de erros de runtime.
CWFIELD-COLOR	nnn, Código de cor para variáveis desabilitadas no modo gráfico.
CWFILE-CASE	Upper, Converte nome de arquivos para maiúsculas, Lower, para minúsculas no comando GetFile Label. .
CWFONT-FIELD-NAME	Nome da fonte para variáveis no modo gráfico.
CWFONT-FIELD-WEIGHT	Altura da fonte para variáveis no modo gráfico
CWFONT-FIELD-WIDTH	Largura da fonte para variáveis no modo gráfico.
CWFONT-STATIC-MODE	Fixed, Equipara tamanho das fontes no modo gráfico.
CWFONT-STATIC-NAME	Nome da fonte para literais no modo gráfico.
CWFONT-STATIC-WEIGHT	Altura da fonte para literais no modo gráfico.
CWFONT-STATIC-WIDTH	Largura da fonte para literais no modo gráfico.
CWFRAME	Off, Desabilita exibição de caracteres de moldura no modo gráfico.
CWFORCE	On, Define como obrigatório o cadastramento dos arquivos para retorno no comando GetFile Label.
CWFS35	Off, Desabilita retorno de FILE STATUS 35 para facilitar a conversão de programas do padrão Microsoft o códigos menores que 10 e o valor 42 retornam 00 conforme o padrão Microbase (válido para programas compilados com a diretiva CALLFH”CWSQLC”).
CWFSFATAL	Lista de códigos de FILE STATUS que devem encerrar o sistema (válido para programas compilados com a diretiva CALLFH”CWSQLC”), cada código deve ser separado por vírgula, exemplo: 39,30,9*.
CWFSIGNORE	Lista de códigos de FILE STATUS que devem não devem gerar mensagem automática (válido para programas compilados com a diretiva CALLFH”CWSQLC”), cada código deve ser separado por vírgula, exemplo: 39,30,9*.
CWFULL	Nome de bitmap para tela em branco.
CWFULLMODE	Menu, Exibe bitmap para tela em branco somente durante o menu.
CWGETLABEL	On, Habilita a atribuição automática da propriedade definida na tabela de arquivos para VALUE OF FILE-ID em programas compilados com a diretiva CALLFH”CWSQLC” desde que o tamanho da variável comporte o valor, do contrário o nome do arquivo será transparente manipulado apenas pelo CWSQLC.
CWGUICOLOR	Off, Desabilita o tratamento de FOREGROUND-COLOR e BACKGROUND-COLOR no modo gráfico.
CWGUINEW	Lista de caracteres substitutos (deve ter correspondência com CWGUIOLD).
CWGUIOLD	Lista de caracteres a serem substituídos (deve ter correspondência com CWGUINEW).
CWHELP	Programa COBOL alternativo a CWHELP para o modo gráfico.
CWHELPinout	Windows, Indica que os arquivos texto de ajuda (Help) possuem acentuação codificada no padrão Windows..
CWHELPOBS	Off, Desabilita exibição de "Fim arquivo de ajuda" na função Help modo texto.
CWHELP-FONT	Nome de fonte para o texto de ajuda (Help).
CWHELP-COLOR	nnn, Código de cor para o texto de ajuda (Help).
CWHELP-WIDTH	Largura da fonte para Help
CWHELP-HEIGHT	Altura da fonte para Help.
CWHELP-FIXED	On, Habilita estilo de fonte fixa para Help.
CWHELP-BOLD	On, Habilita estilo de fonte negrito para Help.
CWHELP-ITALIC	On, Habilita estilo de fonte itálica para Help.
CWHELP-STRIKE-OUT	On, Habilita estilo de fonte riscado para Help.
CWHELP-UNDERLINE	On, Habilita estilo de fonte sublinhado para Help.
CWIMPR-QUIET	On, Habilita o modo quiet na função Print Report no modo texto.
CWLEVEL	Padroniza para / ou \, os indicadores de níveis de pastas o cadastro de arquivos .
CWLITS	Upper, Literais convertidas para maiúsculas Lower, Literais convertidas para Minúsculas.
CWLOCATE	Habilita o retorno do caminho completo da pasta corrente na configuração de labels quando o arquivo cadastrado não possui caminho declarado.
CWLOGO	Substituto ao indicador COBOLware, Off desabilita.
CWLOGON-COLOR	nnn, Código de cor da janela de logon no modo gráfico.
CWLOGON-COLUMN	Coluna de posicionamento da janela de logon no modo gráfico.
CWLOGON-LINE	Linha de posicionamento da janela de logon no modo gráfico.
CWMENU-HELP	Nome de programa help alternativo para o modo help.
CWMENULIST	On, Classifica a lista de programas por posição no menu durante a manutenção de grupos.
CWNOFRAME	On, Desabilita moldura padrão do modo texto.
CWPASSWORD	Senha para logon automático.
CWPREFIX	Declara caminho padrão para retornodo cadastro de arquivos.
CWPRINTFONT	Fonte para impressão via Windows.
CWPURGEPRINT	On, Apaga relatórios gerados em spool quando impressos.
CWPURGEVIEW	On, Apaga relatórios gerados em spool no modo auto-visualização quando visualizados.
CWPUSH-WIDTH	Largura da fonte para push-buttons.
CWPUSH-HEIGHT	Altura da fonte para push-buttons.
CWPUSH-FIXED	On, Habilita estilo de fonte fixa para push-buttons.
CWPUSH-BOLD	On, Habilita estilo de fonte negrito para push-buttons.
CWPUSH-ITALIC	On, Habilita estilo de fonte itálica para push-buttons.
CWPUSH-STRIKE-OUT	On, Habilita estilo de fonte riscado para push-buttons.
CWPUSH-UNDERLINE	On, Habilita estilo de fonte sublinhado para push-buttons.
CWREFRESH	Atualização de telas por comando DISPLAY.
CWREMOVE	Lista de caracteres que não devem ser exibidos no modo gráfico.
CWRITEATTR	Off, Desabilita o tratamento de atrinutos de cor das rotinas CBL_SCR_WRITE no modo gráfico.
CWRTSW	Programa alternativo para visualizar mensagens de runtime.
CWSPLTMP	Pasta para arquivos temporários específica para spool.
CWSPOOLVIEW	Programa alternativo para visualizar relatórios.
CWSPOOL-FONT	Nome de fonte para o visualizador de relatórios no modo gráfico.
CWSPOOL-COLOR	nnn, Código de cor para o spool.
CWSPOOL-WIDTH	Largura da fonte para spool.
CWSPOOL-HEIGHT	Altura da fonte para spool.
CWSPOOL-FIXED	On, Habilita estilo de fonte fixa para spool.
CWSPOOL-BOLD	On, Habilita estilo de fonte negrito para spool.
CWSPOOL-ITALIC	On, Habilita estilo de fonte itálica para spool.
CWSPOOL-STRIKE-OUT	On, Habilita estilo de fonte riscado para spool.
CWSPOOL-UNDERLINE	On, Habilita estilo de fonte sublinhado para spool.
CWSTATIC-COLOR	Código de cor para literais no modo gráfico.
CWTITLE	Título da janela para o modo texto-Windows.
CWSUFIX	Declara extensão padrão para retorno no comando GetFile Label. Off, remove a extensão cadastrada.
CWTOP-BMP	Nome de bitmap para primeiras 6 linhas em branco.
CWUPDATE	On, Trata todos os ACCEPTs como WITH UPDATE.
CWUSERNAME	Usuário para logon automático.
CWZEROSUPRESS	On, Suprime exibição de um zero como identificador de ACCEPT numérico no modo texto.
DB-LINK	Nome de banco para conecção com diretiva CALLFH”CWSQLC” ativada na compilação.
FSPASSWORD	Senha pra conexão ao FileShare.
FSSERVER	Nome do servidor FileShare.
FSUSERNAME	Usuário para conexão ao FileShare.
ORACLE-PASSWORD	Senha pra conexão ao Oracle com diretiva CALLFH”CWSQLC” ativada na compilação.
ORACLE-USERNAME	Usuário para conexão ao Oracle com diretiva CALLFH”CWSQLC” ativada na compilação.