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/obolware.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.

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.

CWMEMORY

nnn, quantidade de blocos de memoria de 32K que devem ser reservados para a construção de telas gráficas (default = 10).

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.

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.