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 ambiente Unix é necessário instalar os binários específicos para Unix que podem ser obtidos por download em http://www.COBOLware.com.

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

Exemplo:

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

Arquivo de instaladores	Compilação
cobolware.com/downlod/OC/cobolware.zip	Micro Focus Object COBOL 4.0.38
cobolware.com/download/NE/cobolware.zip	Micro Focus NetExpress 3.1
cobolware.com/download/VC/cobware.zip	Micro Focus Visual COBOL 2.1

Membros da pasta compactada cobolware.zip	Plataforma do instalador
COBOLware.exe	IWindows
COBOLware.tar	Unix/Linux no formato gnt
int/COBOLware.tar	Unix/Linux no formato int

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 arquivo cwmenu.ini.

Variáveis reconhecidas:

COBWARE3	Off, Desabilita o suporte a chamadas de rotinas do COBOLware 3.0 (GRs).
CONSOLE	On, Direciona ACCEPTs e DISPLAYs não posicionados para o simulador de console no estilo mainframe, para operar a console é preciso executar o programa console.
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..
CWALLPAPER	Off, Desabilita exibição de bitmap para tela em branco e para primeiras 6 linhas em branco.
CWAUTO	On, Ao preencher totalmente um campo, passa automaticamente para o próximo.
CWAUTOFSERROR	On, Habilita tratamento automático de mensagens de erro de FILE STATUS para programas compilados com a diretiva CALLFH”CWSQLC”.
CWAUTOPATH	On, Habilita criação automática de pastas na abertura de arquivos para programas compilados com a diretiva CALLFH”CWSQLC”.
CWAUTORETRYLOCK	Off, Desabilita tentativa automática de releitura 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.
CWBORDER	N, Código fixo de moldura para o modo texto (de 0 a 9).
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 de programas sem passar pelo pelo menu no modo texto.
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 ícone 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 na configuração de nomes de arquivos..
CWEDITCHAR	Off, Desabilita a alteração de campos alfanuméricos no modo texto, quando digitada a primeira coluna o resto do campo é apagado
CWEDITNUM	On, Permite a alteração valores numéricos editados no modo texto.
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.
CWFAXWORK	Define pasta de trabalho alternativa para a exibição de figuras no modo texto.
CWFIELD-COLOR	nnn, Código de cor para variáveis desabilitadas no modo gráfico.
CWFIND	Off, Desabilita a pesquisa em listas de seleção.
CWFILE-CASE	Upper, Converte nome de arquivos para maiúsculas, Lower, para minúsculas.
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.
CWFOOTLINE	Numero de linha para posicionamento da linha de rodapé dos módulos de configuração do gerenciador quando definido CWFRAMEPGM.
CWFRAME	Off, Desabilita exibição de caracteres de moldura no modo gráfico.
CWFRAMEPGM	Nome de programa de tratamento de padrão de tela alternativo para o modo texto.
CWFOREBACK	Off, Desabilita diferenciamento automático de coincidências de códigos de cor do fundo com a cor do texto que torna os caracteres invisíveis.
CWFORCE	On, Define como obrigatório o cadastramento dos arquivos.
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*.
CWFSREPLACE	Tabela de correspondência de códigos de FILE STATUS para compatibilidade de lógica de programas portados de outras implementações COBOL (válido para programas compilados com a diretiva CALLFH”CWSQLC”), cada código deve ser separado por vírgula com a correspondência indicada por um sinal de igual, exemplo: 35=30,9D=99.
CWFSRETRY	Lista de códigos de FILE STATUS que indica quando a operação mal sucedida deve ser repetida continuamente até que seja obtido sucesso (válido para programas compilados com a diretiva CALLFH”CWSQLC”), cada código deve ser separado por vírgula, exemplo: 9A,9#,9D.
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.
CWGUICOLOR-ACCEPT	Off, Desabilita a herança de atributos de cor para entry-fields 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.
CWHELPINPUT	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.
CWID-REPORT	Pasta Habilita produção de relatório de chamadas no fechamento do menu, sendo produzido arquivos na pasta definida com a extensão id.
CWIMPR-QUIET	On, Habilita o modo quiet na função Print Report no modo texto.
CWIMPR-SIZE-PAGE	nnn, Número de linhas por página em alternativa ao default 59.
CWIMPR-SIZE-PAGE-nnn	nnn, Número de linhas por página em alternativa ao default 59 específico para a largura nnn.
CWIMPR--USER	Atribui relatórios a um determinado usuário.
CWINISHOW	On, Exibe na linha 25 o nome relativo do cwmenu.ini carregado.
CWJUST	Off, Desabilita a opção de no modo texto os campos alfanumérico alinhados a direita serem durante digitações alinhados a esquerda.
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.
CWLOADS	Lista de nomes programas, DLLs ou bibliotecas para carga na inicialização do gerenciador. (Separados por espaços, vírgulas “,”, dois pontos “;” pipes “\|” ou ponto e virgula “;”)
CWLOCATE	On, Habilita o retorno do caminho completo da pasta corrente na configuração de labels quando o arquivo cadastrado não possui caminho declarado.
CWLOCKNEW	On, Habilita o bloqueio automático em todos os grupos para novos programas adicionados ao menu.
CWLOCKS	Indica nome de arquivo onde deve ser mantido o controle de travamento de registros para programas compilados com a diretiva CALLFH”CWSQLC” , esse recurso visa dar subsídios para a localização de dead locks, para visualizar os recursos travados pode ser utilizado o programa CWLOCKV. Os books e SELECT e FD permitem o desenvolvimento de um programa próprio de consultas de travamentos, nesse caso, os registros não travados desse arquivo devem ser desconsiderados, pois é justamente a situação de travado é que indica que o recurso ainda está em uso. Para que a leitura não fique parada em um registro travado (status = “9D”) basta fazer executar START LOCKS KEY GREATER nome-da-chave, assim o READ LOCKS NEXT RECORD, sairá do registro travado corrente.
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.
CWLOGPGM	Nome de programa alternativo para receber usuário e senha no momento do login no modo gráfico, parâmetros: USUARIO, SENHA ambos PIC X(30) e RESPOSTA PIC X(1) que deve retornar 'Y' caso o usuário desista de efetuar o login.
CWLPTnPDF	Nome de arquivo PDF para o qual a saída de impressão da porta n deve ser direciona, uma vírgula “,” indica que o documento PDF produzido deve se aberto automaticamente. Ex: CWLPT1PDF=sysout, Quando um relatório for gerado na porta LPT1 resultará no arquivo sysout.pdf que será aberto automaticamente.
CWMD5DIR	Define em qual diretório devem ser sem mantidos os controles de layout dos documentos XML e JSON utilizados pelo comado XML e JSON respectivamente, o default é $COBOLWARE/md5.
CWMENU-CLOSE	Off, mantem a janela gráfica aberta quando chamar programa que utilize SP2.
CWMENU-F9	Descrição,Programa, Define descrição e programa para a tecla F9 no menu principal.
CWMENU-HELP	Nome de programa help alternativo para o modo help.
CWMENUCOMMENT	On, Exibe comentários dos menus como opções desabilitadas no modo gráfico.
CWMENULIST	On, Classifica a lista de programas por posição no menu durante a manutenção de grupos.
CWMENUPAGE	On, O itens dos menus secundários exibem os números das páginas para as quais apontam; All, exibe também nos itens de menu primário.
CWNOFRAME	On, Desabilita moldura padrão do modo texto.
CWNOPENEDS	Nome de arquivo onde deve ser gravada a lista de nomes dos arquivos abertos caso o limite de arquivos abertos simultaneamente do ambiente seja atingido. (válido para programas compilados com a diretiva CALLFH”CWSQLC”).
CWODBCSTRING	String de conexão a ODBC para programas compilados com a diretiva CALLFH”CWSQLC”.
CWPASSWORD	Senha para logon automático.
CWPAUSE	Nome de arquivo de bloqueio de I/O do sistema para programas compilados com a diretiva CALLFH”CWSQLC” enquanto esse arquivo existir nenhuma operação de I/O será permitida e o sistema fica em espera.
CWPREFIX	Declara caminho padrão para retorno do cadastro de arquivos.
CWPRINTFONT	Fonte para impressão via Windows.
CWPRINTSIZE	Tamanho da 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.
CWREMINDER	Off, Desabilita o recurso de lembrete de senhas.
CWREPORTEXTMAIL	Texto de até 255 caracteres para o corpo dos e-mail de envio de relatórios pelo comando Print Report, o caractere “^” é interpretado como fim de linha.
CWRESOLUTION	Define o tamanho da janela no modo gráfico, valores válidos de 1 a 4.
CWREWRITE	Off, Substitui o comando REWRITE no tratamento de arquivos indexados por um DELETE RECORD e em seguida um WRITE, se não houver modificações no registro nenhuma operação será realizada, (para programas compilados com a diretiva CALLFH”CWSQLC”)
CWRITEATTR	Off, Desabilita o tratamento de atributos de cor das rotinas CBL_SCR_WRITE no modo gráfico.
CWRTSW	Programa alternativo para visualizar mensagens de runtime.
CWSHOWFAX	On, Habilita a exibição de imagens no comando PICTURE no modo texto utilizando o Visualizador de Fax do Windows.
CWSPLTMP	Pasta para arquivos temporários específica para spool.
CWSP2COLOR	Off , Desativa tabela de cores do CWMENU para telas gráficas.
CWSEND-OK	On, determina que a opção default seja OK em mensagens que solicitem somente OK/Cancelar. .
CWSPOOLVIEW	Programa alternativo para visualizar relatórios, o caractere $ indica a posição no nome do arquivo na linha de comando.
CWSPOOLHANDLER	Programa alternativo para manipular o diretório de spool (relatórios gerados) O caractere ? Indica o nome e a posição na linha de comando do arquivo a ser gerado contendo a exportação da lista de relatórios armazenados no spool. São suportados os formatos XML, JSON, DBF e TXT delimitado por “\|”. O caractere # indica um dígito número da task que visa obter nomes exclusivos do processo. Exemplos: explorer ?lista###.xml notepad ?lista##.txt dbu ?lista###.dbf
CWSPOOLTEXTMAIL	Texto de até 255 caracteres para o corpo dos e-mails de envio de relatórios pelo spool, o caractere “^” é interpretado como fim de linha.
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.
CWSECURECHAR	Caractere de exibição na entrada de campos invisíveis no modo texto. Off para exibir somente o cursor.
CWSUFIX	Declara extensão padrão para retorno de nomes de arquivos cadastrados. 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.
CWWINMEMORY	nnn, quantidade de blocos de memoria de 32K que devem ser reservados para a construção de janelas gráficas (default = 1).
CWZEROSUPRESS	On, Suprime exibição de um zero como identificador de ACCEPT numérico no modo texto.
DB-LINK	Nome de banco para conexão com Oracle.
FSPASSWORD	Senha pra conexão ao FileShare.
FSSERVER	Nome do servidor FileShare.
FSUSERNAME	Usuário para conexão ao FileShare.
HOTKEY-nnn	Programa COBOL a ser executado ao pressionar determinada tecla. onde nnn é o código da tecla conforme o CWKEYS.CPY (3 dígitos)
ORACLE-PASSWORD	Senha para conexão com Oracle.
ORACLE-USERNAME	Usuário para conexão com Oracle.
ORACLE-STRING	String para conexão com Oracle.
ORASQL8	Nome ou PATH\nome da dll do Oracle Client em alternativa a ORACLE8.dll
SMTPSERVER	Nome de servidor SMTP em alternativa ao default mail.cobolware.com
SMTPUSERNAME	Usuário do servidor SMTP em alternativa ao default spool@cobolware.com.
SMTPPASSWORD	Senha do usuário do servidor SMTP alternativo.
SMTPPPORT	Porta alternativa para o servidor SMTP.