MANUAL INTERNO

MAINFRAME EXPRESS 3.0

Elaborado por:
Eusinha Flávia Hoppe – TAP
 Mainframe Express 3.0
 Criação de projeto:

Os projetos deverão ser criados com base em projetos modelos, já

configurados de acordo com os requisitos e padrões do cliente. Além disto, o
projeto a ser criado deverá ser salvo no diretório (área de trabalho) de cada
colaborador.
Para cada cliente deverá ser criado um novo projeto e os programas deste
devem ser desenvolvidos dentro de cada projeto específico. Por exemplo: se o
colaborador desenvolve programas para os clientes Bradesco e Itaú. Em sua área
de trabalho deverá ter 2 projetos distintos, um para o cliente Bradesco e outro para
o cliente Itaú.
A extensão de um projeto criado no MFE é .MVP. Todos os projetos conterão
no mínimo 4 abas inferiores: Files, Workgroup, Catalog e Spool.

Barra de ferramentas
Janela do Projeto Janela de edição

Barra de Status Tabs Janela de Output

CPMBraxis – 2008 – pág: 2

 Mainframe Express 3.0
Passo a passo:
1. Inicializar o MFE (2 cliques sobre o ícone do mesmo na área de
trabalho).
2. Selecione New no menu File.
3. Na janela NEW, selecione a opção Project e clique em OK.
4. Informe o nome do projeto – deve ser criado com o nome do cliente
para o qual será desenvolvido o programa. Ex: Programa Bradesco, utilizar
nome do projeto como “BRADESCO”.
5. Selecione o diretório D:\Work (onde o projeto será criado) e clique
em Avançar (Next).
6. Selecione a opção “Using a template project file”, selecione o nome
do projeto modelo, marque a opção “Copy all files from project/template
folder”.
7. Clique em Avançar (Next).
8. Clique em Concluir (Finish).

Após a criação do projeto, seu conteúdo é exibido graficamente numa janela

chamada visão de projeto (Project View). A partir desta janela, todos os aspectos
de trabalho com esse projeto podem ser acessados e controlados.

 Iniciando a construção de um programa (Populando o projeto):

Ao realizar a abertura do projeto recém criado (Project View), o mesmo estará

vazio, ou seja, não haverá componentes ou fontes disponíveis. Portanto, todos os
arquivos devem ser catalogados no projeto.
Os programas (código fonte) devem ser criados de acordo com o diretório
apontado no momento da criação do projeto. Para a fábrica, deve ser mantido o
diretório D:\Work, pois os comandos do SCP (Sistema de Controle da Produção)
estarão utilizando o mesmo mapeamento.

Passo a passo:
1. Selecione New no menu File.
2. Escolher a opção Source File e OK.
3. Surgirá a tela do editor para início da digitação (entre as colunas 8 e
72 o fundo será branco – indicando as colunas aceitas pelo COBOL).

Salvar o programa:
1. Selecione New no menu File.
2. Informe o nome do programa.
3. Informe o diretório onde o programa deverá ser salvo.
Obs: Manter diretório padrão: D:\Work\.

Editar o programa:
Na aba inferior Files – pasta Source, selecione o programa desejado e dê um

CPMBraxis – 2008 – pág: 3

 Mainframe Express 3.0
duplo clique ou acione o botão direito do mouse, opção Edit.

Fechar o programa:
Selecione a opção Close do menu File ou clique o botão na própria janela
do editor ou programa.

Dicas:

Selecionar várias linhas do código fonte (programa):

1. Edite o arquivo desejado.

2. Posicione o cursor na parte reservada da tela (Project View) – à esquerda
antes da linha.
3. Clique com o botão esquerdo do mouse para selecionar e arraste até o
ponto desejado. Copie o bloco através do ícone Copiar na barra de menu
ou pressione CTRL + C.
4. Posicione o cursor na linha que deseja colar e cole o bloco através do ícone
Colar na barra de menu ou pressione CTRL + V – não há necessidade de
abrir linhas em branco.

Selecionar parte de uma linha do código fonte (programa):

1. Posicione o cursor no início da parte desejada.

2. Clique com o botão esquerdo do mouse para selecionar e arraste até o
ponto desejado.
3. Copie a área selecionada através do botão direito do mouse, opção “Copy”
ou pelo ícone Copiar na barra de menu.
4. Posicione o cursor na linha que deseja colar e cole o bloco através do botão
direito do mouse, opção “Paste” ou pelo ícone Colar na barra de menu –
neste caso há necessidade de abertura de linhas em branco antes de colar.

Realizar alinhamento de coluna em bloco:

1. Posicione o cursor no início do bloco que deverá ser alinhado

2. Selecione o bloco desejado e arraste para a coluna desejada.

 Adicionando um programa ao projeto:

O MFE permite que você copie programas (código fonte) que foram
desenvolvidos externamente ao projeto (criado em diretório diferente do D:\Work
ou disponíveis em outro projeto).
Os arquivos (programas, componentes, arquivos de dados, JCL, etc), mesmo
sendo digitados dentro do MFE, não são anexados automaticamente ao projeto.
Portanto, precisam ser adicionados ao projeto.

CPMBraxis – 2008 – pág: 4

 Mainframe Express 3.0

Passo a passo:
1. Selecione a opção “Add files” no menu Project.
2. Na janela “Add files to project”, aponte para o diretório onde está o
programa foi salvo anteriormente ou já gravado (Add from).
3. Selecione o programa desejado (CBL, JCL) e clique em ADD para que o
MFE realize um apontamento do programa para o projeto aberto.
Obs: Pode-se inserir mais de um arquivo por vez, para isto basta que os
arquivos desejados estejam selecionados antes da execução do passo 4.
4. Selecione a opção Done ou simplesmente feche a janela ativa através do
botão .

 Removendo um programa do projeto:

Programas podem ser removidos do projeto a qualquer momento.

Passo a passo:
1. Na aba inferior Files, selecione o arquivo que será removido do projeto.
2. Selecione a opção “Remove” do menu Project ou clique com o botão direito
do mouse e escolha a opção “Remove”.
3. Na janela “Remove files from Project” pode-se escolher 2 opções: “Also
delete Original source file” – além de remover do projeto, também irá
remover o arquivo original no diretório onde está salvo. Cuidado: Se
escolher esta opção, não há como recuperar o arquivo. E a opção “Also
delete Generate files” – apenas remove do projeto o arquivo e os arquivos
relacionados a ele dentro do projeto (book´s, .int, .idy, etc).

 Realizando pesquisas no MFE:

O MFE permite a busca por palavras dentro do código fonte, dentro de um

projeto como um todo ou em diretórios externos ao projeto. Todas as opções de
busca estão no menu SEARCH.
Opções mais utilizadas:

FIND:

Pesquisar palavra dentro do código fonte (programa):

1. Uma nova janela será ativada na parte inferior do Project View.

2. Posicionar o cursor no campo escolhido para pesquisa.
3. Clique na opção “Cursor” para capturar a palavra. Se preferir, a palavra
pode ser digitada diretamente no campo de pesquisa - FIND.
Obs: Se a busca for feita através de mais de uma palavra, selecione com o
mouse as palavras desejadas.

CPMBraxis – 2008 – pág: 5

 Mainframe Express 3.0

Botão ALL: irá marcar (cor diferente do texto) no código fonte os lugares
em que a palavra indicada no campo de pesquisa aparece.

Realizar substituição de palavras no código fonte (programa):

1. Digite a palavra original no campo de pesquisa - FIND.

2. Habilite a opção “REPLACE”.
3. Digite a palavra que irá substituir a original no campo REPLACE.

Atenção: Cuidado para não realizar alterações indevidas, como campos

de copybooks. Para solucionar o problema, selecione a opção “Current
File Only”.

FIND COBOL ITEM:

Destaca todas as linhas onde as variáveis ou procedures são utilizadas. A área

de prefixo (Prefix área), mostra uma tag indicando como a variável ou
procedure está sendo usada: Definida, Referenciada ou modificada.

LOCATE:

Definition:
Localiza palavras dentro do código fonte (programa). Para retornar ao ponto
original de chamada, clique com o botão direito do mouse, opção “return”.

Cobol Section:
Localiza e insere o cursor na linha onde a seção selecionada do Cobol aparece
no código fonte (programa).

SHOW COBOL REPORTS:

Possibilita a visualização de dados mortos (Dead Data), dados não

referenciados (Unreferenced Data), a lista de copybooks utilizados no
programa (Copybook Structure) e as estatísticas sobre o programa (Program
Statistics).

Obs: Com um duplo clique no nome da copybook (opção Copybook Structure),

a mesma será editada e o cursor será posicionado no início da mesma.

FIND IN FILES:

Pesquisar por palavra dentro de arquivos que são externos ao projeto ou em

arquivos / programas dentro do projeto. Inclusive em arquivos de dados (.DAT).

CPMBraxis – 2008 – pág: 6

 Mainframe Express 3.0

O resultado da busca será exibido na janela de output do Project View. Cada

linha exibida indica que a palavra foi encontrada. Para editar o arquivo onde a
palavra foi encontrada, dê dois cliques com o mouse sobre a linha.

 Compilando programa / JCL:

Antes da execução de um programa/JCL este deve ser compilado.

Passo a passo:
1. Selecione Build no menu Build ou pressione a tecla F7 (Build) para que
todos os programas sejam compilados.
2. Se quiser compilar um programa específico, o mesmo deve ser selecionado
com um clique (marcar) e após acionar a opção Build ou clique com o botão
direito do mouse e escolha a opção “Compile”.

Quando encontrado um erro, o MFE marca a linha através da colocação de um

“X” na parte reservada do Project View – à esquerda da tela. Para que o caracter
seja eliminado, o problema deve ser corrigido e o código fonte (programa)
recompilado.

Os arquivos de extensão .INT e .IDY resultantes da compilação estarão sendo

gravados automaticamente em um diretório da rede (Loadlib) para facilitar o teste
integrado quando necessário.

 Executando / Depurando um programa Batch:

Para a execução de um programa Batch é necessário que tenha sido criado

um JCL e o mesmo esteja compilado.

Passo a passo:
1. Selecione o job (na pasta JCL) que será executado.
2. Selecione a opção Run no menu Debug ou pressione a tecla F5 (Run) para
a execução (Zoom) ou para a depuração passo a passo selecione a opção
Start Debugging no menu Debug ou pressione a tecla F11 (STEP).
3. Na janela “Start Debugging, confirmar se o JCL que será executado está
correto. A janela Application Output aberta serve para monitorar a
execução. Quando o job atingir o ponto de execução do programa Cobol, e
estando no módulo de depuração, o código fonte é exibido e a linha
corrente do código fonte (a que está prestes a ser executada) é ressaltada.
A partir daí, a execução está sob o comando do usuário, que deverá seguir
conforme comandos de depuração do Menu Debug (F5 ou F11).

Dicas:

CPMBraxis – 2008 – pág: 7

 Mainframe Express 3.0

 Visualizando a lista de programas executados:

Quando da depuração de uma aplicação que contém muitos

subprogramas, é difícil saber exatamente quais os programas que foram
executados até o momento. O MFE fornece esta informação na janela Loaded
Program List, que pode ser acessada durante uma depuração no menu View,
opção Debug Windows, opção Loaded Program List. Uma janela será aberta
com as informações.

Para fechar a janela aberta, selecione o menu View, opção Debug

Windows e desabilite a opção Load Program List ou clique com o botão direito
do mouse sobre a janela e ecolha a opção Hide.

 Visualizando os Calls e Performs ativos:

Ao marcar um breakpoint em uma linha, quando a execução é

interrompida por ele, você pode não ter certeza do caminho que a aplicação
levou para chegar até aquela linha. O MFE fornece a janela Call/Perform stack,
a qual mostra todos os CALLs e PERFORMs ativos, e que pode ser acessada
durante uma depuração através do menu View, opção Debug Windows, opção
Call Stack.

Ao encerrar a execução do programa, a janela é fechada

automaticamente pelo MFE.

 Criação de arquivo de dados novo – (.DAT):

Passo a passo:
1. Na aba inferior Catalog, selecione New no menu File.
2. Escolha a opção Data File e OK.
3. Na janela “Alocate and create data set” informe:
a. DS name: nome do arquivo (.DAT).
b. PC filename: diretório onde o arquivo de dados (.DAT) deverá ser
salvo – D:\work.
c. DSORG: tipo de arquivo (PS, VSAM).
d. RECFM: tipo de blocagem - fixo (FB), variável (VB).
Obs: Se o arquivo for indexado (VSAM) será necessário definir a chave através
do botão Define Keys:
a. Clique no botão “Insert key” – inclusão da chave primária.
b. Informe a posição e o tamanho da chave nos campos Key Offset e
Key length da chave primária.
c. Se o arquivo possuir chave alternada, selecione a opção “Insert Key
After” e proceda conforme o item a acima.

CPMBraxis – 2008 – pág: 8

 Mainframe Express 3.0
d. Clique em OK
4. Escolha a opção Create para gerar o arquivo.

 Salvar arquivo de dados – (.DAT):

Passo a passo:
1. Selecione a opção Save no menu File.
2. Digite o nome do arquivo com extensão .DAT e indique o diretório D:\Work.
3. Clique em Salvar.

 Inclusão de arquivo de dados já existente (externo ao projeto):

Passo a passo:
1. Escolha a aba inferior Catalog.
2. Clique com o botão direito do mouse sobre qualquer parte da área branca,
opção “Add existing dataset”.
3. No campo DS Name entre com o nome do arquivo.
4. Selecione o botão Browse à direita do campo PC Filename e escolha o
diretório de onde quer copiar o arquivo.
5. Selecione o arquivo desejado e Abrir.

 Criar layout de arquivo de dados – estrutura (.STR):

A criação do layout do arquivo é feita através da Data Division de um programa

Cobol que utiliza o arquivo. Portanto, o programa escolhido deverá estar
compilado sem erros.
Se não souber qual o programa que utiliza o arquivo pode-se utilizar a opção
“Find in files” do menu Search para identificar o programa.

Passo a passo:
1. Na aba inferior Files, selecione o programa (marcar) em que o layout do
arquivo está declarado.
2. Clique com o botão direito do mouse e escolha a opção “Create record
layout” ou selecione a opção New no menu File e escolha a opção Record
Layout.
3. Uma janela será aberta, e as áreas da Data division e working-storage do
programa serão exibidos.
4. Selecione a estrutura do arquivo (marcar) e clique com o botão direito do
mouse, opção “New record layout”.
5. Na janela aberta, escolha a opção “Default layout” se o arquivo for de
tamanho fixo, ou seja, todos os registros terão a mesma estrutura. Se o
arquivo for variável ou possuir mais de 1 tipo de registro, escolha a opção
“Conditional layout”.
6. Avançar.

CPMBraxis – 2008 – pág: 9

 Mainframe Express 3.0
7. Concluir.

 Criando layout de arquivo de dados - tipo condicional:

1. Execute até o passo 5 do item anterior e escolha a opção “Conditional Layout”.

2. Clique Next e Finish.
Isto adiciona a estrutura do registro como um layout condicional - no painel à
direita, deve-se especificar o campo e a condição que identifica o tipo de
registro.
3. No painel à direita, expanda a estrutura escolhida clicando o sinal “+”.
4. Clique com o botão da direita no campo escolhido como identificador do tipo de
registro.
5. Clique na opção “Properties”.
6. Na janela “Field Properties”, selecione a condição IS=TO na lista pulldown.
7. Digite o valor do tipo à esquerda do campo “Condition”.
8. Clique em OK.

 Salvar estrutura do arquivo de dados – (.STR):

Passo a passo:
1. Selecione a opção Save no menu File.
2. Digite o nome do arquivo com extensão .STR e indique o mesmo diretório
em que o arquivo com extensão .DAT foi salvo - D:\Work.
3. Clique em Salvar
4. Feche a janela do Editor de layout de registro – clique na opção Close do
menu File ou clicando o botão na própria janela.

 Associar um arquivo de layout (.STR) ao arquivo de dados (.DAT):

Passo a passo:
1. Selecione a aba inferior Catalog e abra o arquivo de dados escolhido com
dois cliques ou pressione botão direito do mouse, opção Edit.
Obs: O MFE só executará a associação se o arquivo estiver editado (aberto).
2. Selecione a opção DataTools no menu File.
3. Clique na opção “Associate Record layouts”.
4. Opção Sim/Yes.
5. Clique OK.

 Inserindo registros no arquivo de dados (.DAT):

1. Na aba inferior Catalog e abra o arquivo desejado.

2. Clique com o botão direito do mouse na área do arquivo e escolha a
opção “Insert record after”.

CPMBraxis – 2008 – pág: 10

 Mainframe Express 3.0
3. Na janela “Select record layout”, selecione a estrutura do registro e
clique OK.
4. Se o arquivo escolhido for VSAM, a janela “Insert indexed record”,
será aberta automaticamente para o preenchimento da chave primária e
alternada (se existir).
5. À direita será aberta a estrutura para inserção de 1 registro.
6. Após preenchimento, selecione a opção Save no menu File.

Dicas:

 Menu Edit – opção Datatools:

Nesta opção, o MFE oferece opções para alteração dos registros no arquivo
como: inserção de novos registros entre os já existentes, inicialização do
registro, delete, inserção de múltiplos registros de uma só vez, etc.

 Menu View – opção Datatools:

Nesta opção, o MFE oferece os itens:

 File information: demonstra as características do arquivo: tamanho,
organização, quantidade de registros dos arquivos, etc.
 Show hex: exibe o registro selecione em formato hexadecimal.

 Utilizar um arquivo de layout já existente:

Passo a passo:
1. Selecione a aba inferior Catalog e escolha o arquivo a ser visualizado.
2. Selecione a opção DataTools do menu File.
3. Clique na opção “Load Record layouts”.
4. Aponte o diretório onde o arquivo de layout (.STR) foi salvo, selecione o
arquivo de layout (.STR) correspondente e clique na opção Abrir.

Um novo painel se abrirá à direita, como mostrado na figura abaixo. Os dados

exibidos este painel dependem do tipo de registro selecionado no painel à
esquerda.

CPMBraxis – 2008 – pág: 11

Mainframe Express 3.0

CPMBraxis – 2008 – pág: 12

 Mainframe Express 3.0
 Impressão de arquivos de dados

Passo a passo:
1. Na aba inferior Catalog, editar o arquivo desejado, conforme abaixo:

2. Para visualizar o relatório a ser impresso no formato Hexadecimal

clique na opção Print Preview no menu File. Selecione em “Print is based
on” a opção Unformatted View, selecione em “Print Options” a opção
Hexadecimal values, selecione em “Print range” a opção All records e clique
em Preview.
3. Selecione conforme a tela abaixo as opções do cabeçalho para
visualizar o relatório a ser impresso e ao final solicite a impressão com Print
ou feche a visualização com Close.

CPMBraxis – 2008 – pág: 13

 Mainframe Express 3.0
4. Para visualizar o relatório a ser impresso no formato de layout clique
na opção Print Preview no menu File. Selecione em “Print is based on” a
opção Formatted View, selecione opções em “Print Options”, selecione em
“Print range” a opção All records e clique em Preview.

5. Para imprimir os relatórios: no menu file, opção Print Preview através

da opção Print ou com o arquivo de dados editado, clique na opção Print no
menu File. Selecione as opções de impressão conforme descrito acima,
selecione a impressora e número de cópias e botão OK.
6. Para gerar arquivo .TXT (Unformatted View), crie uma impressora
local do tipo Generic/Text Only, no momento da impressão selecione está
impressora e informe na janela “Print to File” o local e nome do arquivo
(com extensão .TXT) a ser salvo, conforme exemplo abaixo:

CPMBraxis – 2008 – pág: 14

 Mainframe Express 3.0
CICS

Para desenvolver aplicações em CICS, o projeto deve estar configurado para o

mesmo. Quando o projeto está preparado para suportar o CICS, no project view
aparecerá uma aba inferior denominada: “CICS”.
Quando aberta deverá apresentar a seguinte estrutura:
 CICS System
 Program Control Table (PCT)
 File Control Table (FCT)
 Processing Program Table (PPT)
 System Initialization Table (SIT)

Cadastrando transações:

Passo a passo:
1. Selecione a aba inferior CICS com um clique.
2. Clique com o botão direito do mouse em PCT (Program Control
Table), opção “Add new PCT entry”.
3. Informe a transação do programa no campo “Transaction Id” (letra
maiúscula).
4. Informe o nome do programa no campo “Program Name” (letra
maiúscula).
5. Informe uma breve descrição do programa no campo “Description”.
Este item é opcional.
6. Clique no botão Aplicar para inserir a transação e continuar com a
janela aberta ou clique no botão OK para inserir a transação e fechar a
janela automaticamente.

 Cadastrando arquivos de dados (.dat):

Passo a passo:
1. Selecione a aba inferior CICS com um clique.
2. Clique com o botão direito do mouse em FCT (File Control Table), opção
“Add new FCT entry”.
3. Informe o nome do arquivo de dados (.DAT), através do ícone [...],
confirmando com o botão OK. Caso este arquivo possua índice alternado
será solicitado a inclusão dos índices com uma mensagem, aceite clicando
em YES e informe na coluna FCT name o nome dos índices alternados.
4. Ou escolher a opção “Use Catalog” e informar o nome do arquivo .DAT.

 Criando Mapas (.BMS):

Passo a passo:
1. Selecione New no menu File.
2. Selecione a opção CICS BMS Mapset e clique em OK.

CPMBraxis – 2008 – pág: 15

 Mainframe Express 3.0
3. Preencha as opções de Propriedades do Mapset:
a. Mapset Name: Obrigatório. Nome do mapset - máximo de 7
caracteres.
b. Type: De acordo com os padrões do cliente.
c. Mode: Habilitar as opções IN e OUT.
d. Lang: Habillitar a opção Cobol.
e. Tipoapfx: Habilitar a opção Yes.
4. Clique OK.
5. Preencha as opções de Propriedades do Mapa:
a. Map Name: obrigatório. Nome do mapa – máximo de 7 caracteres.
b. Size: line = 24, column = 80.
6. No editor, desenhe a tela conforme o layout enviado pelo cliente. As literais
devem ser digitadas normalmente e não necessitam de configuração de
atributos. As variáveis devem ser inseridas através da opção “Add fields” –
botão direito do mouse e formatadas conforme abaixo:
a. Posicione o cursor sobre o campo, clique com o botão direito do
mouse, opção “Properties”.
b. Field Name: Obrigatório. Nome do campo.
c. Pos: linha e coluna onde a variável será inserida no mapa.
d. Attrb: atributos que a variável terá.
e. Length: tamanho da variável
Obs: Para os campos de input, deve-se inserir um campo delimitador de
variável (stopper), clique com o botão direito ao final do campo e
selecione a opção “Add field”.
7. Selecione a opção Save As no menu file para salvar o mapset.
8. Adicione o mapset ao projeto.
9. Compile o mapa para que o copybook (áreas de tela) seja gerado pelo
MFE.

Editar o arquivo .BMS:

1. Na aba inferior Files, selecione o mapa que deseja editar com um clique do
mouse, botão direito do mouse, opção “Edit as text”.

 Executando / depurando um programa CICS:

Passo a passo:
1. Selecione a opção “RUN” no menu Debug ou clique no ícone RUN (F5)
para a execução.
3. Selecione a opção “Start debugging” no menu Debug ou clique no ícone
STEP (F11) para a depuração.
4. Na aba CICS, informe o código da transação inicial.

Dicas:

CPMBraxis – 2008 – pág: 16

 Mainframe Express 3.0

 Utilize a tecla <CTRL> do lado direito do teclado ou a tecla <Enter> mais à

direita para substituir o ENTER, e a tecla <ESC> para substituir o CLEAR.

 Para fechar e sair do ambiente CICS digite a transação “EXIT”.

 Para visualizar mapas BMS (telas) sem a execução do código fonte

(programa), após compilar o mapa, entrar no processo de execução de uma
transação (DEBUG\RUN\CICS) e acionar a transação “CMAP”.

 Para examinar o conteúdo dos registros em uma TS (Temporary Storage),

após realizar a gravação da mesma, entrar no processo de execução de
uma transação (DEBUG\RUN\CICS) e executar a transação “CEBR”.

CPMBraxis – 2008 – pág: 17

 Mainframe Express 3.0
 Comparando arquivos (DIFF):

1. Selecione a opção “Workbench” no menu Tools.

2. Selecione a opção “Source Compare”.
3. OLD: acione o botão “find files” para buscar o código fonte (programa)
anterior.
4. NEW: acione o botão “find files” para buscar o código fonte (programa)
novo.
5. No campo Directives, acrescente a diretiva “COBOL”. Se for necessária a
expansão da copybooks inclua também a diretiva “INCLUDE”.
6. Clique em OK.

Nas linhas em que houver divergência entre os fontes, a mesma será destacada
através de uma cor diferente do texto original.

Dicas:

 Na opção “Margins”, do menu Options, pode-se definir a partir de qual

range de colunas será realizada a comparação.

 Na opção “Compare Statistics”, do menu Difference, pode-se comparar

dados estatísticos das versões anterior e atual.

 No menu File, opção “Create report”, é possível realizar a geração de um

arquivo com as diferenças, estatísticas, etc.

CPMBraxis – 2008 – pág: 18

 Mainframe Express 3.0
IMS/DC

Para desenvolver aplicações em IMS, o projeto deve estar configurado para o

mesmo. Quando o projeto está preparado para suportar o IMS, no project view
aparecerá uma aba inferior denominada: “IMS”.
Quando aberta deverá apresentar a seguinte estrutura:
 IMS System
 DBD GENS
 MFS GENS
 PSB GENS
 Transactions
 Printers/Lterms
 DB Catalog

Cadastrando programas - Transaction:

Passo a passo:
1. Selecione a aba inferior IMS com um clique.
2. Clique com o botão direito do mouse em Transactions, opção “Add new
transaction”.
3. Preencha os seguintes campos:
- Program type:
BMP (Batch Message Processor) – Batch
DLI (Stand-alone DLI Program)
MPP (Message Processing Program) – Online
NRMP (Non-Response Message Processor)
QBMP (Queue-driven batch message processor)
- Trancode name: nome da transação
- PSB name: PSB utilizada pelo programa
- Program name: nome do programa
- SPA size: tamanho da área de transferência utilizada por programas
conversacionais.
- Process limit count: número limite que o programa ficará na
memória, sem uma nova carga.
- Maximum Seg no: número limite de acessos a segmentos de banco
de dados.
4. Clique no botão OK para inserir o programa e fechar a janela
automaticamente.

Cadastrando impressora – Printers/Lterms:

Passo a passo:
1. Selecione a aba inferior IMS com um clique.
2. Clique com o botão direito do mouse em Printers/Lterms, opção “Add new
printer/Lterm”.

CPMBraxis – 2008 – pág: 19

 Mainframe Express 3.0
3. Preencha os seguintes campos:
- Name: nome da impressora. Para o cliente Bradesco, deve-se
cadastrar a impressora padrão: “PMSVS860”.
- Type: Printer
4. Clique no botão OK para cadastrar a impressora e fechar a janela
automaticamente.

Cadastrando tela (.MFS):

A tela (.MFS) deve ser adicionada ao projeto após sua criação, da mesma
forma que é realizado com o código fonte (programa) e compilada.
Após a compilação, a tela deverá estar cadastrada na pasta “MFS”
automaticamente.
Para realizar a deleção de um cadastro de tela, selecione a mesma com o
botão direito do mouse e escolha a opção “Delete”.

Cadastrando PSB:

A PSB (.PSB) deve ser adicionada ao projeto e compilada.

Após a compilação, a PSB deverá estar cadastrada na pasta “PSB”
automaticamente.
Para realizar a deleção de um cadastro de uma PSB, selecione a mesma com
o botão direito do mouse e escolha a opção “Delete”.

Impressão de relatórios:

Passo a passo:
1. Selecione a aba inferior IMS com um clique.
2. Cadastre a impressora conforme item Cadastrando impressora.
3. Sempre que um relatório é gerado via aplicação IMS, o mesmo é gravado
no arquivo IMS3270P.LST na pasta Listing do diretório onde o projeto foi
criado.
4. Para gerar nomes diferentes de arquivos de impressão, clique com o botão
direito do mouse em IMS System, opção “Properties”. Na pasta TM/MFS
selecione a opção “Separate print files by Appl Region ID”. Esta opção faz
com que os arquivos gerados sejam nomeados com IMS-XXXX.LST, onde
XXXX é o código da ApplRgnID mostrada no topo da tela de execução
(Application output) do IMS.
5. Para visualizar o relatório gerado automaticamente ao final da execução,
clique com o botão direito do mouse em IMS System, opção “Properties”.
Na pasta TM/MFS, selecione a opção “View printer output on session
closed”, na pasta TM/MFS ou dê dois cliques sobre o arquivo gerado na
pasta Listing do diretório onde o projeto foi criado.
6. Para imprimir selecione a opção “Print” do menu File.

CPMBraxis – 2008 – pág: 20

 Mainframe Express 3.0
Configurando – Trace DL/I:

Passo a passo:
1. Selecione a aba inferior IMS com um clique.
2. Clique com o botão direito do mouse em IMS System, opção “Properties”.
3. Na pasta DL/I Trace, selecione todas as opções da janela “Call trace
options”, a opção “Write to data set” da janela “Trace output options” e
confirme o nome do arquivo como BTS.LST.
4. Na pasta TM/MFS More, preencha o campo Lterm Name com “MFIMS” e o
campo USER ID com o código do seu usuário.
5. Clique no botão OK.

Impressão – Trace DL/I:

Passo a passo:
1. Selecione a opção “Trace Print” do menu Tools, opção “IMS”.
2. Preencha o campo Input Filename com “BTS.LST”, apontando para o
diretório onde o projeto foi criado.
3. Clique no botão Ok.
4. O trace do IMS é gerado no arquivo IMSPRINT.LST na pasta Listing do
diretório onde o projeto foi criado.
5. Para imprimir selecione a opção “Print” do menu File.

 Criando telas (.MFS):

A tela (.MFS) para aplicações IMS/DC podem ser geradas de duas formas:
através do editor do MFE com a digitação manual (Source File) ou através do
gerador de tela CO-MFS.

Passo a passo – CO-MFS:

1. Selecione a opção “CO-MFS” no menu Tools, opção “ Workbench”.

CO-MFS – Diretrizes:

• Na opção <1> Create/Update Member, informe Member Name

(Nome da Tela), Device Type (igual a 2), Description (Descrição tela) e
adicione através da tecla F4<Add>.
Obs: o campo Screen Name / Condition só deverá ser preenchido se existir
mais de uma tela.
• Monte a tela conforme layout enviado pelo cliente – constantes
(literais fixas), os campos de variáveis devem ser criados com os caracteres
especiais abaixo:
OBS: Antes de visualizar os campos e as definições (atributos, tamanho, etc),
acione a tecla F2<Add> para adicionar o campo a tela.
Caracteres:

CPMBraxis – 2008 – pág: 21

 Mainframe Express 3.0
@ = protegido e modificável,
~ = protegido e não modificável,
& = não protegido e modificável,
+ = não protegido e não modificável

• Para visualizar/alterar a definição dos campos e atributos, acione a

tecla F4<DFLD> com o cursor posicionado sobre o campo para
visualizar/alterar a definição do campo específico ou sobre a tela limpa para
visualizar/alterar a definição de todos os campos através das teclas
F7<PREV> e F8<NEXT>.
• Para visualizar/alterar a definição/alinhamento dos campos de
entrada e saída da tela, acione a tecla F5<MFLD>.
• Para visualizar/alterar a descrição/formato dos campos do copybook,
acione a tecla F6<Cpy>.
• Para consultar a definição dos campos e atributos anterior/posterior,
acione as teclas F7<Prev> - campo anterior e F8<Next> - campo posterior.
• Para mudar a ordem dos campos do MFLD, acione a tecla F9<Re-
Order> na tela principal.
• Para visualizar/alterar a definição dos caracteres utilizados para a
criaçãos dos campos da tela, acione a função F7<Set Screen Paint
Character> - tecla esta oculta na tela.
• Para visualizar/alterar as definições das PF´s da tela, acione a
função F8<Dev> .
• Para salvar alterações, acione a tecla F3<Save>. Para cancelar
alterações, acione a tecla F9<Cancel>.
• Para setar a posição inicial do cursor, acione a tecla F10<Set Initial
Cursor Position> - tecla esta oculta na tela.
• Para sair do CO-MFS, acione a tecla F3<Exit> ou clique no ícone
.
• Para gerar macro e copybooks do formato member, acione a opção
<7> Generate MFS Macros and Copybooks, informando o Member Name,
local e nome do arquivo copybook, local e nome da tela (macro MFS) e
execute a geração através da tecla F5<Generate>.
• Para visualizar lista de formatos (members), acione a opção <8> List
Members in Library e informe a função desejada (S-Edit, G-Generate, D-
Delete, B-Binary e E-Export Screen) no campo “Func” da tela escolhida.

 Atualizando tela (.MFS) através do CO-MFS:

Passo a passo:
1. Selecione a opção “CO-MFS” no menu Tools, opção “Workbench”.
2. Na opção <3> Import a Member using MFS macros, informe o Dataset
name to import from (diretório e nome do arquivo com extensão .MFS) ou
acione a tecla F2<Dir> e escolha a tela a ser alterada colocando o caracter
“S” no campo “Func” a frente do Dataset Name, Member Name (nome do

CPMBraxis – 2008 – pág: 22

 Mainframe Express 3.0
campo FMT dentro do arquivo .MFS), Device Type, Description e importe
através da tecla F5<Import>.
3. Para realizar as visualizações/alterações proceda conforme descrito no item
anteriormente, lembrando que após realizar uma alteração na tela, deve-se
adicionar com a tecla F2<Add> antes de alterar nome de campo e
atributos.

 Compilando programa / tela (.MFS):

Antes da execução de um programa / tela (.MFS) este deve ser compilado.

Passo a passo:
1. Selecione Build no menu Build ou pressione a tecla F7 (Build) para que
todos os programas / telas sejam compilados.
2. Se quiser compilar um programa / tela específica, o mesmo deve ser
selecionado com um clique (marcar) e após acionar a opção “Build” ou
clique com o botão direito do mouse e escolha a opção “Compile”.

Quando encontrado um erro, o MFE marca a linha através da colocação de um

“X” na parte reservada (Prefix área) do Project View – à esquerda da tela. Para
que o caracter seja eliminado, o problema deve ser corrigido e o código fonte
(programa / tela) recompilado.

 Executando / depurando um programa IMS:

Passo a passo:
1. Selecione a opção “RUN” no menu Debug ou clique no ícone RUN (F5)
para a execução.
2. Selecione a opção “Start debugging” no menu Debug ou clique no ícone
STEP (F11) para a depuração.
3. Na aba IMS, informe o código da transação IMS ou o comando “/FOR
output_screen_name”.

CPMBraxis – 2008 – pág: 23

 Mainframe Express 3.0
DEBUG:

Opções:

 Start Debugging – dá início ao processo de depuração/execução.

 Stop Debugging – encerra o processo de depuração/execução.

 Restart Debugging – encerra o processo de depuração/execução corrente e

restabelece o início de um novo processo de depuração/execução.

 Break – interrompe a execução do programa.

 Step – executa o comando corrente – F11.

 Step All – executa todos os comandos do programa passo a passo

automaticamente em uma certa velocidade, a velocidade aumenta se
número do “Delay in seconds” for diminuído e a velocidade diminui se o
número do “Delay in seconds” for aumentado.

 Run Thru – executa o comando indicado em velocidade normal,

podendo ser, por exemplo, um comando MOVE, READ, PERFORM, CALL,
etc. Uma sub-rotina pode ser executada em um único passo.

 Run Return – executa o restante da procedure/parágrafo corrente em

velocidade normal, parando a depuração/execução no comando seguinte
ao comando de chamada (Perform).

 Run to Cursor – executa até a posição do cursor em velocidade normal,

caso a lógica do programa não passe pela posição do cursor, o programa
será executado até encontrar o comando Goback ou Stop Run.

 Run – executa todo o programa em velocidade normal – F5.

 Skip Statement – pula a execução do comando corrente e executa o

próximo comando.

 Skip Return – executa o comando seguinte ao comando de chamada

(Perform) da procedure/parágrafo. O restante da procedure/parágrafo
corrente não é executado.

CPMBraxis – 2008 – pág: 24

 Mainframe Express 3.0
 Skip to Cursor – executa a linha onde o cursor está posicionado sem
executar os comandos intermediários.

 Breakpoint – insere um indicador no código fonte de forma que a execução

interrompa naquele ponto:

 Set – marca a linha corrente do cursor com um Breakpoint normal

, podendo ser selecionado via menu de contexto (botão direito do
mouse) ou via um duplo clique na área mais a esquerda (Prefix
Area).

 Set Advanced... – permite a marcação dos Breakpoint do tipo:

Do statement - executa o comando especificado.

Conditional - interrompe o programa quando uma condição

específica for satisfeita.

 Program – permite a interrupção da depuração/execução quando do

início da execução do programa informado.

 Disable – desabilita a marcação do Breakpoint na linha corrente,

mudando a cor do Breakpoint para cinza.

 Enable – habilita a marcação do Breakpoint na linha corrente,

mudando a cor do Breakpoint para vermelho.

 Clear All in Program – retira todas as marcações de Breakpoints do

programa corrente.

 Clear All in Project – retira todas as marcações de Breakpoints do

projeto corrente.

 Disable All in Project – desabilita todas as marcações de Breakpoints

do projeto corrente.

 Enable All in Project – habilita todas as marcações de Breakpoints do

projeto corrente.

 Show All - exibe todas as marcações de Breakpoints em todos os

programas do projeto corrente, permitindo habilitar ou desabilitar os
mesmos.

CPMBraxis – 2008 – pág: 25

 Mainframe Express 3.0
 Examine - permite verificar o valor corrente de um item de dados. Este
pode ser alterado durante a depuração/execução.
 Do Statement - executa um comando COBOL que não está no
programa. O comando é executado, mas não é adicionado ao código fonte.

 Threads – utilizado para programas Cobol Non-mainframe (Micro Focus).

 DateWarp - temporariamente substitui a data e a hora corrente do

sistema por uma escolhida pelo usuário. A data e/ou hora selecionadas se
aplicam apenas durante a sessão corrente de depuração/execução. A
opção “Dynamic date” e “Dynamic time” mantém a data e/ou hora
atualizadas durante a execução do programa.

CPMBraxis – 2008 – pág: 26

 Mainframe Express 3.0
Cobertura de teste - Test Coverage:

O MFE disponibiliza informações de cobertura de teste. As equipes de

desenvolvimento freqüentemente precisam mostrar que realizaram testes os quais
cobriram todos os caminhos lógicos através do programa. Através do utilitário de
cobertura de teste, é possível realizar a geração de relatórios que mostram a
extensão da cobertura do teste – estes podem estar nos formatos texto (.TXT) ou
HTML.
 Habilitando o Test Coverage:

Passo a passo:
1. Selecione a opção “Test Coverage” no menu Tools.
2. Selecione a opção “Configuration” e clique no botão Create New.
3. No campo Filename entre com o nome do arquivo de configuração. Este
arquivo será gravado com a extensão .TCF na pasta Testcover gerada no
mesmo diretório do projeto.
4. Habilite as demais opções conforme a necessidade:

 Result file details > Single results file: acumula em um único

arquivo (extensão .tcz) o resultado das execuções dos testes.

 Result file details > Overwrite results file on each test run:
sobrepõem o conteúdo do arquivo de resultados ( extensão .tcz)
cada vez que um teste é executado. Caso este item não seja
selecionado, o arquivo de resultados acumula o resultado de cada
execução.

 Result file details > Separate incremental results file (use

“????” in filename): separa os arquivos de resultados, incluindo no
nome do arquivo um número seqüencial para cada resultado de
execução. A permanência dos caracteres “????” no nome do campo
Results filename é obrigatório.

 Display ínterim results in debugging output window: exibe

temporariamente para cada execução um resumo do resultado do
Test Coverage na aba inferior Testcover.

 Log Filename: informe o local e nome de um arquivo de Log, que

registrará o resumo do resultado do Test Coverage de cada
execução de teste.

CPMBraxis – 2008 – pág: 27

 Mainframe Express 3.0
5. Clique no botão Save Configuration File para salvar as informações
selecionadas no arquivo de configuração (Filename) com a extensão .tcf.
6. Para utilizar o arquivo de configuração na cobertura de teste, selecione-o
na lista de arquivos e clique no botão Set as active.

7. Habilite a opção “Run in test coverage mode” na tela acima para rodar um
programa do projeto com o modo de cobertura de teste ou escolha a opção
“Project Settings” do menu Project, pasta Execution e habilite esta mesma
opção.
8. Clique em OK.

 Executando programa com Test Coverage:

Antes de rodar um programa no modo de cobertura de teste, é necessário

primeiro compilá-lo com a opção “Test Coverage”.

Passo a passo:
1. Selecione a opção “Build Settings for Project” no menu Project.
2. Com a janela ativa, selecione a aba Cobol, subpasta General.
3. Habilite a opção “Test Coverage”.
4. Clique em OK.

Obs: Os passos acima habilitam a opção de cobertura de testes para todos os

programas do projeto. Caso a opção deva ser utilizada apenas para um único
programa, selecione o programa desejado com um clique do mouse e siga os
passos acima.

CPMBraxis – 2008 – pág: 28

 Mainframe Express 3.0

5. Executar o programa de acordo com sua característica, através da opção

“Start Debugging” no menu Debug.
 Gerando relatórios dos testes:
Para gerar relatórios com os resultados dos testes, após a execução do
programa, selecione a opção “Test Coverage” no menu Tools, opção “Report”.
Adicione (botão Add) ou remova (botão Remove) os arquivo de resultado
(extensão .tcz) que farão parte do relatório e selecione as opções do conteúdo e
da saída do relatório conforme a sua necessidade, sendo incluídos no relatório:

Report content options:

 Basic block numbers: contador de blocos de código fonte podendo

considerar como um bloco de código as instruções de linha executadas
sucessivamente sem interrupção.

 Calls: identificador e totalizador (ocorrência / execução) de comandos

Call existentes no programa executado.

 Columns on left: transfere o contador de instruções executadas e bloco

de código para o lado esquerdo do relatório.

 Data frequency: identificador e totalizador (ocorrência / execução) de

freqüência de campos referenciados durante a execução.

CPMBraxis – 2008 – pág: 29

 Mainframe Express 3.0
 Full source listing: exibe o programa fonte.

 Verbs: identificador e totalizador (ocorrência / execução) de verbos

existentes no programa Cobol executado.

 Report on tagged lines: identificador e totalizador de linhas de código

que foram alteradas.

 Report on tagged lines > from this list: libera uma janela para que os
identificadores de alterações de código fonte sejam informados, os quais
se encontram no código fonte do lado esquerdo (Left) das colunas 1 até
6, ou do lado direito (Right) das colunas 73 até 80.

 Report on tagged lines > from the tagfile: permite que seja informado o
local/nome de um arquivo texto, o qual deve conter a posição do
identificador de alteração de código, podendo utilizar as palavras @LEFT
(colunas 1 até 6) ou @RIGHT (colunas 73 até 80).
Output options:

 HTML: gera o relatório no formato HTML.

 Separate report file per program: cria um relatório isolado para cada
programa executado.

 Text: gera o relatório no formato texto.

 Display results in output tab: exibe na aba TestCover as informações

para a geração do relatório.

 Use root name prefix: especifica que o nome do relatório deve conter
um prefixo, devendo este ser informado no campo liberado a direita.

 Report output folder: informe o local / nome da pasta que será utilizada
para gravação dos relatórios.

Clique no botão Produce report, deixando habilitada a opção “Show index of

reports in browser” para que os relatórios sejam apresentados ao final.

 Entendendo o relatório emitido pelo Test Coverage:

Abaixo um descritivo do relatório gerado com a opção “Test Coverage”:

1- Fonte do programa e totalizadores:

Fonte do programa:

CPMBraxis – 2008 – pág: 30

 Mainframe Express 3.0
 Coluna BLOCK > contador de blocos de código fonte, demonstra através de
um contador sequencial os blocos de instruções/parágrafos a serem
executados.

 Coluna COUNT > contador de execução por linha de código fonte,

identificando a quantidade de vezes que uma linha (instrução/parágrafo) foi
executada.
Totalizadores de execução:

 Quantidade de blocos de código executados X quantidade de blocos de

código existentes e percentual de execução.

 Quantidade de instruções executadas X quantidade de instruções

existentes e percentual de execução.

 Quantidade de seções/parágrafos executados X quantidade de

seções/parágrafos existentes e percentual de execução.

 Quantidade de comandos CALL executados X quantidade de comandos

CALL existentes e percentual de execução.

 Quantidade de identificadores de alteração (TAG) executados X

identificadores de alteração existentes e percentual de execução.

2- Totalizadores por verbos Cobol, classificados em ordem decrescente

pela quantidade de execução de cada verbo Cobol:

 Quantidade de ocorrências (OCCURS) do Cobol no programa.

 Quantidade de ocorrências do verbo Cobol que foram executadas

(COVERAGE) e percentual da execução.

 Quantidade de vezes que o verbo Cobol foi processado (EXECUTION-

COUNT) durante toda a execução do programa e o percentual com relação
ao total de execuções dos verbos Cobol.

3- Totalizadores de comandos CALL:

Com a identificação dos comandos CALL, é realizado o registro do total de

ocorrências (OCCURS), do total de ocorrências que foram executadas
(COVERAGE) e a quantidade de vezes que o comando CALL foi processado
(EXECUTION-COUNT) durante toda a execução do programa.

CPMBraxis – 2008 – pág: 31

 Mainframe Express 3.0
4- Totalizadores de freqüência de dados, classificados em ordem
decrescente pela quantidade de vezes que o campo foi referenciado
durante a execução:

 Identificação do campo de dados (DATA-NAME).

 Total de referências (REFERENCES) a este campo durante toda a

execução, isto é, se existem duas referências a um certo campo no
programa e as instruções que fazem a referência a este campo foram
executadas 10 vezes, então teremos o total de 20 referências ao campo.

 Tamanho do campo (SIZE) definido no programa.

 Se houve a necessidade de alinhamento (ALIGNMENT) na movimentação /

comparação deste campo. Exemplo: mover campo de 5 bytes numérico
para campo de 10 bytes alfanumérico. E caso houver a perda de
informação quando do alinhamento aparecerá à mensagem MISALIGNED.

CPMBraxis – 2008 – pág: 32