apostila mfe 3

MANUAL INTERNOMAINFRAME EXPRESS 3.0

Elaborado por: Eusinha Flvia Hoppe TAP

Mainframe Express 3.0

Criao de projeto:

Os projetos devero ser criados com base em projetos modelos, j configurados de acordo com os requisitos e padres do cliente. Alm disto, o projeto a ser criado dever ser salvo no diretrio (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 especfico. 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 extenso de um projeto criado no MFE .MVP. Todos os projetos contero no mnimo 4 abas inferiores: Files, Workgroup, Catalog e Spool. Barra de ferramentas Janela do Projeto Janela de edio

Barra de Status

Tabs

Janela de Output

CPMBraxis 2008 pg:

2

Mainframe Express 3.0Passo 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 opo 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 diretrio D:\Work (onde o projeto ser criado) e clique em Avanar (Next). 6. Selecione a opo Using a template project file, selecione o nome do projeto modelo, marque a opo Copy all files from project/template folder. 7. Clique em Avanar (Next). 8. Clique em Concluir (Finish). Aps a criao do projeto, seu contedo exibido graficamente numa janela chamada viso de projeto (Project View). A partir desta janela, todos os aspectos de trabalho com esse projeto podem ser acessados e controlados.

Iniciando a construo de um programa (Populando o projeto):

Ao realizar a abertura do projeto recm criado (Project View), o mesmo estar vazio, ou seja, no haver componentes ou fontes disponveis. Portanto, todos os arquivos devem ser catalogados no projeto. Os programas (cdigo fonte) devem ser criados de acordo com o diretrio apontado no momento da criao do projeto. Para a fbrica, deve ser mantido o diretrio D:\Work, pois os comandos do SCP (Sistema de Controle da Produo) estaro utilizando o mesmo mapeamento. Passo a passo: 1. Selecione New no menu File. 2. Escolher a opo Source File e OK. 3. Surgir a tela do editor para incio da digitao (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 diretrio onde o programa dever ser salvo. Obs: Manter diretrio padro: D:\Work\. Editar o programa: Na aba inferior Files pasta Source, selecione o programa desejado e d um

CPMBraxis 2008 pg:

3

Mainframe Express 3.0duplo clique ou acione o boto direito do mouse, opo Edit. Fechar o programa: Selecione a opo Close do menu File ou clique o boto do editor ou programa. Dicas: Selecionar vrias linhas do cdigo 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 boto esquerdo do mouse para selecionar e arraste at o ponto desejado. Copie o bloco atravs do cone Copiar na barra de menu ou pressione CTRL + C. 4. Posicione o cursor na linha que deseja colar e cole o bloco atravs do cone Colar na barra de menu ou pressione CTRL + V no h necessidade de abrir linhas em branco. Selecionar parte de uma linha do cdigo fonte (programa): 1. Posicione o cursor no incio da parte desejada. 2. Clique com o boto esquerdo do mouse para selecionar e arraste at o ponto desejado. 3. Copie a rea selecionada atravs do boto direito do mouse, opo Copy ou pelo cone Copiar na barra de menu. 4. Posicione o cursor na linha que deseja colar e cole o bloco atravs do boto direito do mouse, opo 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 incio do bloco que dever ser alinhado 2. Selecione o bloco desejado e arraste para a coluna desejada.

na prpria janela

Adicionando um programa ao projeto:

O MFE permite que voc copie programas (cdigo fonte) que foram desenvolvidos externamente ao projeto (criado em diretrio diferente do D:\Work ou disponveis em outro projeto). Os arquivos (programas, componentes, arquivos de dados, JCL, etc), mesmo sendo digitados dentro do MFE, no so anexados automaticamente ao projeto. Portanto, precisam ser adicionados ao projeto.

CPMBraxis 2008 pg:

4

Mainframe Express 3.0Passo a passo: 1. Selecione a opo Add files no menu Project. 2. Na janela Add files to project, aponte para o diretrio 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 execuo do passo 4. 4. Selecione a opo Done ou simplesmente feche a janela ativa atravs do boto .

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 opo Remove do menu Project ou clique com o boto direito do mouse e escolha a opo Remove. 3. Na janela Remove files from Project pode-se escolher 2 opes: Also delete Original source file alm de remover do projeto, tambm ir remover o arquivo original no diretrio onde est salvo. Cuidado: Se escolher esta opo, no h como recuperar o arquivo. E a opo Also delete Generate files apenas remove do projeto o arquivo e os arquivos relacionados a ele dentro do projeto (books, .int, .idy, etc).

Realizando pesquisas no MFE:

O MFE permite a busca por palavras dentro do cdigo fonte, dentro de um projeto como um todo ou em diretrios externos ao projeto. Todas as opes de busca esto no menu SEARCH. Opes mais utilizadas: FIND: Pesquisar palavra dentro do cdigo 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 opo Cursor para capturar a palavra. Se preferir, a palavra pode ser digitada diretamente no campo de pesquisa - FIND. Obs: Se a busca for feita atravs de mais de uma palavra, selecione com o mouse as palavras desejadas.

CPMBraxis 2008 pg:

5

Mainframe Express 3.0Boto ALL: ir marcar (cor diferente do texto) no cdigo fonte os lugares em que a palavra indicada no campo de pesquisa aparece. Realizar substituio de palavras no cdigo fonte (programa): 1. Digite a palavra original no campo de pesquisa - FIND. 2. Habilite a opo REPLACE. 3. Digite a palavra que ir substituir a original no campo REPLACE. Ateno: Cuidado para no realizar alteraes indevidas, como campos de copybooks. Para solucionar o problema, selecione a opo Current File Only. FIND COBOL ITEM: Destaca todas as linhas onde as variveis ou procedures so utilizadas. A rea de prefixo (Prefix rea), mostra uma tag indicando como a varivel ou procedure est sendo usada: Definida, Referenciada ou modificada. LOCATE: Definition: Localiza palavras dentro do cdigo fonte (programa). Para retornar ao ponto original de chamada, clique com o boto direito do mouse, opo return. Cobol Section: Localiza e insere o cursor na linha onde a seo selecionada do Cobol aparece no cdigo fonte (programa). SHOW COBOL REPORTS: Possibilita a visualizao de dados mortos (Dead Data), dados no referenciados (Unreferenced Data), a lista de copybooks utilizados no programa (Copybook Structure) e as estatsticas sobre o programa (Program Statistics). Obs: Com um duplo clique no nome da copybook (opo Copybook Structure), a mesma ser editada e o cursor ser posicionado no incio da mesma. FIND IN FILES: Pesquisar por palavra dentro de arquivos que so externos ao projeto ou em arquivos / programas dentro do projeto. Inclusive em arquivos de dados (.DAT).

CPMBraxis 2008 pg:

6

Mainframe Express 3.0O 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 execuo 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 especfico, o mesmo deve ser selecionado com um clique (marcar) e aps acionar a opo Build ou clique com o boto direito do mouse e escolha a opo Compile. Quando encontrado um erro, o MFE marca a linha atravs da colocao 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 cdigo fonte (programa) recompilado. Os arquivos de extenso .INT e .IDY resultantes da compilao estaro sendo gravados automaticamente em um diretrio da rede (Loadlib) para facilitar o teste integrado quando necessrio.

Executando / Depurando um programa Batch:

Para a execuo de um programa Batch necessrio 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 opo Run no menu Debug ou pressione a tecla F5 (Run) para a execuo (Zoom) ou para a depurao passo a passo selecione a opo 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 execuo. Quando o job atingir o ponto de execuo do programa Cobol, e estando no mdulo de depurao, o cdigo fonte exibido e a linha corrente do cdigo fonte (a que est prestes a ser executada) ressaltada. A partir da, a execuo est sob o comando do usurio, que dever seguir conforme comandos de depurao do Menu Debug (F5 ou F11). Dicas:CPMBraxis 2008 pg: 7

Mainframe Express 3.0 Visualizando a lista de programas executados: Quando da depurao de uma aplicao que contm muitos subprogramas, difcil saber exatamente quais os programas que foram executados at o momento. O MFE fornece esta informao na janela Loaded Program List, que pode ser acessada durante uma depurao no menu View, opo Debug Windows, opo Loaded Program List. Uma janela ser aberta com as informaes. Para fechar a janela aberta, selecione o menu View, opo Debug Windows e desabilite a opo Load Program List ou clique com o boto direito do mouse sobre a janela e ecolha a opo Hide. Visualizando os Calls e Performs ativos: Ao marcar um breakpoint em uma linha, quando a execuo interrompida por ele, voc pode no ter certeza do caminho que a aplicao 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 depurao atravs do menu View, opo Debug Windows, opo Call Stack. Ao encerrar a execuo automaticamente pelo MFE.

do

programa,

a

janela

fechada

Criao de arquivo de dados novo (.DAT): Passo a passo: 1. Na aba inferior Catalog, selecione New no menu File. 2. Escolha a opo Data File e OK. 3. Na janela Alocate and create data set informe: a. DS name: nome do arquivo (.DAT). b. PC filename: diretrio 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), varivel (VB). Obs: Se o arquivo for indexado (VSAM) ser necessrio definir a chave atravs do boto Define Keys: a. Clique no boto Insert key incluso da chave primria. b. Informe a posio e o tamanho da chave nos campos Key Offset e Key length da chave primria. c. Se o arquivo possuir chave alternada, selecione a opo Insert Key After e proceda conforme o item a acima.

CPMBraxis 2008 pg:

8

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

Salvar arquivo de dados (.DAT): Passo a passo: 1. Selecione a opo Save no menu File. 2. Digite o nome do arquivo com extenso .DAT e indique o diretrio D:\Work. 3. Clique em Salvar.

Incluso de arquivo de dados j existente (externo ao projeto): Passo a passo: 1. Escolha a aba inferior Catalog. 2. Clique com o boto direito do mouse sobre qualquer parte da rea branca, opo Add existing dataset. 3. No campo DS Name entre com o nome do arquivo. 4. Selecione o boto Browse direita do campo PC Filename e escolha o diretrio de onde quer copiar o arquivo. 5. Selecione o arquivo desejado e Abrir.

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

A criao do layout do arquivo feita atravs da Data Division de um programa Cobol que utiliza o arquivo. Portanto, o programa escolhido dever estar compilado sem erros. Se no souber qual o programa que utiliza o arquivo pode-se utilizar a opo 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 boto direito do mouse e escolha a opo Create record layout ou selecione a opo New no menu File e escolha a opo Record Layout. 3. Uma janela ser aberta, e as reas da Data division e working-storage do programa sero exibidos. 4. Selecione a estrutura do arquivo (marcar) e clique com o boto direito do mouse, opo New record layout. 5. Na janela aberta, escolha a opo Default layout se o arquivo for de tamanho fixo, ou seja, todos os registros tero a mesma estrutura. Se o arquivo for varivel ou possuir mais de 1 tipo de registro, escolha a opo Conditional layout. 6. Avanar.

CPMBraxis 2008 pg:

9

Mainframe Express 3.07. Concluir.

Criando layout de arquivo de dados - tipo condicional: Execute at o passo 5 do item anterior e escolha a opo Conditional Layout. Clique Next e Finish. Isto adiciona a estrutura do registro como um layout condicional - no painel direita, deve-se especificar o campo e a condio que identifica o tipo de registro. No painel direita, expanda a estrutura escolhida clicando o sinal +. Clique com o boto da direita no campo escolhido como identificador do tipo de registro. Clique na opo Properties. Na janela Field Properties, selecione a condio IS=TO na lista pulldown. Digite o valor do tipo esquerda do campo Condition. Clique em OK. Salvar estrutura do arquivo de dados (.STR): Passo a passo: 1. Selecione a opo Save no menu File. 2. Digite o nome do arquivo com extenso .STR e indique o mesmo diretrio em que o arquivo com extenso .DAT foi salvo - D:\Work. 3. Clique em Salvar 4. Feche a janela do Editor de layout de registro clique na opo Close do menu File ou clicando o boto na prpria janela.

1.

2.

3. 4. 5. 6.

7. 8.

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 boto direito do mouse, opo Edit. Obs: O MFE s executar a associao se o arquivo estiver editado (aberto). 2. Selecione a opo DataTools no menu File. 3. Clique na opo Associate Record layouts. 4. Opo 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 boto direito do mouse na rea do arquivo e escolha a opo Insert record after.

CPMBraxis 2008 pg: 10

Mainframe Express 3.03. 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 primria e alternada (se existir). 5. direita ser aberta a estrutura para insero de 1 registro. 6. Aps preenchimento, selecione a opo Save no menu File. Dicas: Menu Edit opo Datatools: Nesta opo, o MFE oferece opes para alterao dos registros no arquivo como: insero de novos registros entre os j existentes, inicializao do registro, delete, insero de mltiplos registros de uma s vez, etc. Menu View opo Datatools: Nesta opo, o MFE oferece os itens: File information: demonstra as caractersticas do arquivo: tamanho, organizao, 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 opo DataTools do menu File. 3. Clique na opo Load Record layouts. 4. Aponte o diretrio onde o arquivo de layout (.STR) foi salvo, selecione o arquivo de layout (.STR) correspondente e clique na opo 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.





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

2. Para visualizar o relatrio a ser impresso no formato Hexadecimal clique na opo Print Preview no menu File. Selecione em Print is based on a opo Unformatted View, selecione em Print Options a opo Hexadecimal values, selecione em Print range a opo All records e clique em Preview. 3. Selecione conforme a tela abaixo as opes do cabealho para visualizar o relatrio a ser impresso e ao final solicite a impresso com Print ou feche a visualizao com Close.


Mainframe Express 3.04. Para visualizar o relatrio a ser impresso no formato de layout clique na opo Print Preview no menu File. Selecione em Print is based on a opo Formatted View, selecione opes em Print Options, selecione em Print range a opo All records e clique em Preview.

5. Para imprimir os relatrios: no menu file, opo Print Preview atravs da opo Print ou com o arquivo de dados editado, clique na opo Print no menu File. Selecione as opes de impresso conforme descrito acima, selecione a impressora e nmero de cpias e boto OK. 6. Para gerar arquivo .TXT (Unformatted View), crie uma impressora local do tipo Generic/Text Only, no momento da impresso selecione est impressora e informe na janela Print to File o local e nome do arquivo (com extenso .TXT) a ser salvo, conforme exemplo abaixo:


Mainframe Express 3.0CICS Para desenvolver aplicaes 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 transaes: Passo a passo: 1. Selecione a aba inferior CICS com um clique. 2. Clique com o boto direito do mouse em PCT (Program Control Table), opo Add new PCT entry. 3. Informe a transao do programa no campo Transaction Id (letra maiscula). 4. Informe o nome do programa no campo Program Name (letra maiscula). 5. Informe uma breve descrio do programa no campo Description. Este item opcional. 6. Clique no boto Aplicar para inserir a transao e continuar com a janela aberta ou clique no boto OK para inserir a transao 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 boto direito do mouse em FCT (File Control Table), opo Add new FCT entry. 3. Informe o nome do arquivo de dados (.DAT), atravs do cone [...], confirmando com o boto OK. Caso este arquivo possua ndice alternado ser solicitado a incluso dos ndices com uma mensagem, aceite clicando em YES e informe na coluna FCT name o nome dos ndices alternados. 4. Ou escolher a opo Use Catalog e informar o nome do arquivo .DAT.

Criando Mapas (.BMS): Passo a passo: 1. Selecione New no menu File. 2. Selecione a opo CICS BMS Mapset e clique em OK.CPMBraxis 2008 pg: 15

Mainframe Express 3.03. Preencha as opes de Propriedades do Mapset: a. Mapset Name: Obrigatrio. Nome do mapset - mximo de 7 caracteres. b. Type: De acordo com os padres do cliente. c. Mode: Habilitar as opes IN e OUT. d. Lang: Habillitar a opo Cobol. e. Tipoapfx: Habilitar a opo Yes. 4. Clique OK. 5. Preencha as opes de Propriedades do Mapa: a. Map Name: obrigatrio. Nome do mapa mximo 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 no necessitam de configurao de atributos. As variveis devem ser inseridas atravs da opo Add fields boto direito do mouse e formatadas conforme abaixo: a. Posicione o cursor sobre o campo, clique com o boto direito do mouse, opo Properties. b. Field Name: Obrigatrio. Nome do campo. c. Pos: linha e coluna onde a varivel ser inserida no mapa. d. Attrb: atributos que a varivel ter. e. Length: tamanho da varivel Obs: Para os campos de input, deve-se inserir um campo delimitador de varivel (stopper), clique com o boto direito ao final do campo e selecione a opo Add field. 7. Selecione a opo 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, boto direito do mouse, opo Edit as text.

Executando / depurando um programa CICS: Passo a passo: 1. Selecione a opo RUN no menu Debug ou clique no cone RUN (F5) para a execuo. 3. Selecione a opo Start debugging no menu Debug ou clique no cone STEP (F11) para a depurao. 4. Na aba CICS, informe o cdigo da transao inicial. Dicas:CPMBraxis 2008 pg: 16

Mainframe Express 3.0 Utilize a tecla do lado direito do teclado ou a tecla mais direita para substituir o ENTER, e a tecla para substituir o CLEAR. Para fechar e sair do ambiente CICS digite a transao EXIT.

Para visualizar mapas BMS (telas) sem a execuo do cdigo fonte (programa), aps compilar o mapa, entrar no processo de execuo de uma transao (DEBUG\RUN\CICS) e acionar a transao CMAP.

Para examinar o contedo dos registros em uma TS (Temporary Storage), aps realizar a gravao da mesma, entrar no processo de execuo de uma transao (DEBUG\RUN\CICS) e executar a transao CEBR.



Comparando arquivos (DIFF):1. 2.

3. 4.5.

6.

Selecione a opo Workbench no menu Tools. Selecione a opo Source Compare. OLD: acione o boto find files para buscar o cdigo fonte (programa) anterior. NEW: acione o boto find files para buscar o cdigo fonte (programa) novo. No campo Directives, acrescente a diretiva COBOL. Se for necessria a expanso da copybooks inclua tambm a diretiva INCLUDE. Clique em OK.

Nas linhas em que houver divergncia entre os fontes, a mesma ser destacada atravs de uma cor diferente do texto original. Dicas: Na opo Margins, do menu Options, pode-se definir a partir de qual range de colunas ser realizada a comparao. Na opo Compare Statistics, do menu Difference, pode-se comparar dados estatsticos das verses anterior e atual. No menu File, opo Create report, possvel realizar a gerao de um arquivo com as diferenas, estatsticas, etc.


Mainframe Express 3.0IMS/DC Para desenvolver aplicaes 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 boto direito do mouse em Transactions, opo 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 transao - PSB name: PSB utilizada pelo programa - Program name: nome do programa - SPA size: tamanho da rea de transferncia utilizada por programas conversacionais. - Process limit count: nmero limite que o programa ficar na memria, sem uma nova carga. - Maximum Seg no: nmero limite de acessos a segmentos de banco de dados. 4. Clique no boto 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 boto direito do mouse em Printers/Lterms, opo Add new printer/Lterm.CPMBraxis 2008 pg: 19

Mainframe Express 3.03. Preencha os seguintes campos: - Name: nome da impressora. Para o cliente Bradesco, deve-se cadastrar a impressora padro: PMSVS860. - Type: Printer 4. Clique no boto OK para cadastrar a impressora e fechar a janela automaticamente. Cadastrando tela (.MFS): A tela (.MFS) deve ser adicionada ao projeto aps sua criao, da mesma forma que realizado com o cdigo fonte (programa) e compilada. Aps a compilao, a tela dever estar cadastrada na pasta MFS automaticamente. Para realizar a deleo de um cadastro de tela, selecione a mesma com o boto direito do mouse e escolha a opo Delete. Cadastrando PSB: A PSB (.PSB) deve ser adicionada ao projeto e compilada. Aps a compilao, a PSB dever estar cadastrada na pasta PSB automaticamente. Para realizar a deleo de um cadastro de uma PSB, selecione a mesma com o boto direito do mouse e escolha a opo Delete. Impresso de relatrios: Passo a passo: 1. Selecione a aba inferior IMS com um clique. 2. Cadastre a impressora conforme item Cadastrando impressora. 3. Sempre que um relatrio gerado via aplicao IMS, o mesmo gravado no arquivo IMS3270P.LST na pasta Listing do diretrio onde o projeto foi criado. 4. Para gerar nomes diferentes de arquivos de impresso, clique com o boto direito do mouse em IMS System, opo Properties. Na pasta TM/MFS selecione a opo Separate print files by Appl Region ID. Esta opo faz com que os arquivos gerados sejam nomeados com IMS-XXXX.LST, onde XXXX o cdigo da ApplRgnID mostrada no topo da tela de execuo (Application output) do IMS. 5. Para visualizar o relatrio gerado automaticamente ao final da execuo, clique com o boto direito do mouse em IMS System, opo Properties. Na pasta TM/MFS, selecione a opo View printer output on session closed, na pasta TM/MFS ou d dois cliques sobre o arquivo gerado na pasta Listing do diretrio onde o projeto foi criado. 6. Para imprimir selecione a opo Print do menu File.


Mainframe Express 3.0Configurando Trace DL/I: Passo a passo: 1. Selecione a aba inferior IMS com um clique. 2. Clique com o boto direito do mouse em IMS System, opo Properties. 3. Na pasta DL/I Trace, selecione todas as opes da janela Call trace options, a opo 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 cdigo do seu usurio. 5. Clique no boto OK. Impresso Trace DL/I: Passo a passo: 1. Selecione a opo Trace Print do menu Tools, opo IMS. 2. Preencha o campo Input Filename com BTS.LST, apontando para o diretrio onde o projeto foi criado. 3. Clique no boto Ok. 4. O trace do IMS gerado no arquivo IMSPRINT.LST na pasta Listing do diretrio onde o projeto foi criado. 5. Para imprimir selecione a opo Print do menu File.

Criando telas (.MFS): A tela (.MFS) para aplicaes IMS/DC podem ser geradas de duas formas: atravs do editor do MFE com a digitao manual (Source File) ou atravs do gerador de tela CO-MFS. Passo a passo CO-MFS: 1. Selecione a opo CO-MFS no menu Tools, opo Workbench. CO-MFS Diretrizes: Na opo Create/Update Member, informe Member Name (Nome da Tela), Device Type (igual a 2), Description (Descrio tela) e adicione atravs da tecla F4. 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 variveis devem ser criados com os caracteres especiais abaixo: OBS: Antes de visualizar os campos e as definies (atributos, tamanho, etc), acione a tecla F2 para adicionar o campo a tela. Caracteres: CPMBraxis 2008 pg: 21

Mainframe Express 3.0@ = protegido e modificvel, ~ = protegido e no modificvel, & = no protegido e modificvel, + = no protegido e no modificvel Para visualizar/alterar a definio dos campos e atributos, acione a tecla F4 com o cursor posicionado sobre o campo para visualizar/alterar a definio do campo especfico ou sobre a tela limpa para visualizar/alterar a definio de todos os campos atravs das teclas F7 e F8. Para visualizar/alterar a definio/alinhamento dos campos de entrada e sada da tela, acione a tecla F5. Para visualizar/alterar a descrio/formato dos campos do copybook, acione a tecla F6. Para consultar a definio dos campos e atributos anterior/posterior, acione as teclas F7 - campo anterior e F8 - campo posterior. Para mudar a ordem dos campos do MFLD, acione a tecla F9 na tela principal. Para visualizar/alterar a definio dos caracteres utilizados para a criaos dos campos da tela, acione a funo F7 - tecla esta oculta na tela. Para visualizar/alterar as definies das PFs da tela, acione a funo F8 . Para salvar alteraes, acione a tecla F3. Para cancelar alteraes, acione a tecla F9. Para setar a posio inicial do cursor, acione a tecla F10 - tecla esta oculta na tela. Para sair do CO-MFS, acione a tecla F3 ou clique no cone . Para gerar macro e copybooks do formato member, acione a opo 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 gerao atravs da tecla F5. Para visualizar lista de formatos (members), acione a opo List Members in Library e informe a funo desejada (S-Edit, G-Generate, DDelete, B-Binary e E-Export Screen) no campo Func da tela escolhida.

Atualizando tela (.MFS) atravs do CO-MFS: Passo a passo: 1. Selecione a opo CO-MFS no menu Tools, opo Workbench. 2. Na opo Import a Member using MFS macros, informe o Dataset name to import from (diretrio e nome do arquivo com extenso .MFS) ou acione a tecla F2 e escolha a tela a ser alterada colocando o caracter S no campo Func a frente do Dataset Name, Member Name (nome doCPMBraxis 2008 pg: 22

Mainframe Express 3.0campo FMT dentro do arquivo .MFS), Device Type, Description e importe atravs da tecla F5. 3. Para realizar as visualizaes/alteraes proceda conforme descrito no item anteriormente, lembrando que aps realizar uma alterao na tela, deve-se adicionar com a tecla F2 antes de alterar nome de campo e atributos.

Compilando programa / tela (.MFS): Antes da execuo 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 especfica, o mesmo deve ser selecionado com um clique (marcar) e aps acionar a opo Build ou clique com o boto direito do mouse e escolha a opo Compile.

Quando encontrado um erro, o MFE marca a linha atravs da colocao 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 cdigo fonte (programa / tela) recompilado.

Executando / depurando um programa IMS: Passo a passo: 1. Selecione a opo RUN no menu Debug ou clique no cone RUN (F5) para a execuo. 2. Selecione a opo Start debugging no menu Debug ou clique no cone STEP (F11) para a depurao. 3. Na aba IMS, informe o cdigo da transao IMS ou o comando /FOR output_screen_name.


Mainframe Express 3.0DEBUG: Opes: Start Debugging d incio ao processo de depurao/execuo. Stop Debugging encerra o processo de depurao/execuo.

Restart Debugging encerra o processo de depurao/execuo corrente e restabelece o incio de um novo processo de depurao/execuo. Break interrompe a execuo 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 nmero do Delay in seconds for diminudo e a velocidade diminui se o nmero 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/pargrafo corrente em velocidade normal, parando a depurao/execuo no comando seguinte ao comando de chamada (Perform).

Run to Cursor executa at a posio do cursor em velocidade normal, caso a lgica do programa no passe pela posio 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 execuo do comando corrente e executa o prximo comando. Skip Return executa o comando seguinte ao comando de chamada (Perform) da procedure/pargrafo. O restante da procedure/pargrafo corrente no executado.


Mainframe Express 3.0 Skip to Cursor executa a linha onde o cursor est posicionado sem executar os comandos intermedirios. Breakpoint insere um indicador no cdigo fonte de forma que a execuo interrompa naquele ponto: Set marca a linha corrente do cursor com um Breakpoint normal , podendo ser selecionado via menu de contexto (boto direito do mouse) ou via um duplo clique na rea mais a esquerda (Prefix Area).

Set Advanced... permite a marcao dos Breakpoint do tipo: Do statement - executa o comando especificado. Conditional - interrompe o programa quando uma condio especfica for satisfeita. Program permite a interrupo da depurao/execuo quando do incio da execuo do programa informado. Disable desabilita a marcao do Breakpoint na linha corrente, mudando a cor do Breakpoint para cinza. Enable habilita a marcao do Breakpoint na linha corrente, mudando a cor do Breakpoint para vermelho. Clear All in Program retira todas as marcaes de Breakpoints do programa corrente. Clear All in Project retira todas as marcaes de Breakpoints do projeto corrente. Disable All in Project desabilita todas as marcaes de Breakpoints do projeto corrente. Enable All in Project habilita todas as marcaes de Breakpoints do projeto corrente. Show All - exibe todas as marcaes de Breakpoints em todos os programas do projeto corrente, permitindo habilitar ou desabilitar os mesmos.


Mainframe Express 3.0Examine - permite verificar o valor corrente de um item de dados. Este pode ser alterado durante a depurao/execuo. Do Statement - executa um comando COBOL que no est no programa. O comando executado, mas no adicionado ao cdigo 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 usurio. A data e/ou hora selecionadas se aplicam apenas durante a sesso corrente de depurao/execuo. A opo Dynamic date e Dynamic time mantm a data e/ou hora atualizadas durante a execuo do programa.


Mainframe Express 3.0Cobertura de teste - Test Coverage: O MFE disponibiliza informaes de cobertura de teste. As equipes de desenvolvimento freqentemente precisam mostrar que realizaram testes os quais cobriram todos os caminhos lgicos atravs do programa. Atravs do utilitrio de cobertura de teste, possvel realizar a gerao de relatrios que mostram a extenso da cobertura do teste estes podem estar nos formatos texto (.TXT) ou HTML.

Habilitando o Test Coverage: Passo a passo: 1. Selecione a opo Test Coverage no menu Tools. 2. Selecione a opo Configuration e clique no boto Create New. 3. No campo Filename entre com o nome do arquivo de configurao. Este arquivo ser gravado com a extenso .TCF na pasta Testcover gerada no mesmo diretrio do projeto. 4. Habilite as demais opes conforme a necessidade: Result file details > Single results file: acumula em um nico arquivo (extenso .tcz) o resultado das execues dos testes. Result file details > Overwrite results file on each test run: sobrepem o contedo do arquivo de resultados ( extenso .tcz) cada vez que um teste executado. Caso este item no seja selecionado, o arquivo de resultados acumula o resultado de cada execuo. Result file details > Separate incremental results file (use ???? in filename): separa os arquivos de resultados, incluindo no nome do arquivo um nmero seqencial para cada resultado de execuo. A permanncia dos caracteres ???? no nome do campo Results filename obrigatrio. Display nterim results in debugging output window: exibe temporariamente para cada execuo 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 execuo de teste.


Mainframe Express 3.05. Clique no boto Save Configuration File para salvar as informaes selecionadas no arquivo de configurao (Filename) com a extenso .tcf. 6. Para utilizar o arquivo de configurao na cobertura de teste, selecione-o na lista de arquivos e clique no boto Set as active.

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

Executando programa com Test Coverage:

Antes de rodar um programa no modo de cobertura de teste, necessrio primeiro compil-lo com a opo Test Coverage. Passo a passo: 1. Selecione a opo Build Settings for Project no menu Project. 2. Com a janela ativa, selecione a aba Cobol, subpasta General. 3. Habilite a opo Test Coverage. 4. Clique em OK. Obs: Os passos acima habilitam a opo de cobertura de testes para todos os programas do projeto. Caso a opo deva ser utilizada apenas para um nico programa, selecione o programa desejado com um clique do mouse e siga os passos acima.



5. Executar o programa de acordo com sua caracterstica, atravs da opo Start Debugging no menu Debug.

Gerando relatrios dos testes:

Para gerar relatrios com os resultados dos testes, aps a execuo do programa, selecione a opo Test Coverage no menu Tools, opo Report. Adicione (boto Add) ou remova (boto Remove) os arquivo de resultado (extenso .tcz) que faro parte do relatrio e selecione as opes do contedo e da sada do relatrio conforme a sua necessidade, sendo includos no relatrio: Report content options: Basic block numbers: contador de blocos de cdigo fonte podendo considerar como um bloco de cdigo as instrues de linha executadas sucessivamente sem interrupo. Calls: identificador e totalizador (ocorrncia / execuo) de comandos Call existentes no programa executado. Columns on left: transfere o contador de instrues executadas e bloco de cdigo para o lado esquerdo do relatrio. Data frequency: identificador e totalizador (ocorrncia / execuo) de freqncia de campos referenciados durante a execuo.


Mainframe Express 3.0 Full source listing: exibe o programa fonte. Verbs: identificador e totalizador (ocorrncia / execuo) de verbos existentes no programa Cobol executado. Report on tagged lines: identificador e totalizador de linhas de cdigo que foram alteradas. Report on tagged lines > from this list: libera uma janela para que os identificadores de alteraes de cdigo fonte sejam informados, os quais se encontram no cdigo 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 posio do identificador de alterao de cdigo, podendo utilizar as palavras @LEFT (colunas 1 at 6) ou @RIGHT (colunas 73 at 80). Output options: HTML: gera o relatrio no formato HTML. Separate report file per program: cria um relatrio isolado para cada programa executado. Text: gera o relatrio no formato texto. Display results in output tab: exibe na aba TestCover as informaes para a gerao do relatrio. Use root name prefix: especifica que o nome do relatrio 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 gravao dos relatrios. Clique no boto Produce report, deixando habilitada a opo Show index of reports in browser para que os relatrios sejam apresentados ao final.

Entendendo o relatrio emitido pelo Test Coverage: Abaixo um descritivo do relatrio gerado com a opo Test Coverage: 1- Fonte do programa e totalizadores: Fonte do programa:CPMBraxis 2008 pg: 30

Mainframe Express 3.0 Coluna BLOCK > contador de blocos de cdigo fonte, demonstra atravs de um contador sequencial os blocos de instrues/pargrafos a serem executados. Coluna COUNT > contador de execuo por linha de cdigo fonte, identificando a quantidade de vezes que uma linha (instruo/pargrafo) foi executada. Totalizadores de execuo: Quantidade de blocos de cdigo executados X quantidade de blocos de cdigo existentes e percentual de execuo. Quantidade de instrues executadas existentes e percentual de execuo. X quantidade de instrues quantidade de

Quantidade de sees/pargrafos executados X sees/pargrafos existentes e percentual de execuo.

Quantidade de comandos CALL executados X quantidade de comandos CALL existentes e percentual de execuo. Quantidade de identificadores de alterao (TAG) executados identificadores de alterao existentes e percentual de execuo. 2- Totalizadores por verbos Cobol, classificados em ordem decrescente pela quantidade de execuo de cada verbo Cobol: Quantidade de ocorrncias (OCCURS) do Cobol no programa. Quantidade de ocorrncias do verbo Cobol que foram executadas (COVERAGE) e percentual da execuo. Quantidade de vezes que o verbo Cobol foi processado (EXECUTIONCOUNT) durante toda a execuo do programa e o percentual com relao ao total de execues dos verbos Cobol. 3- Totalizadores de comandos CALL: Com a identificao dos comandos CALL, realizado o registro do total de ocorrncias (OCCURS), do total de ocorrncias que foram executadas (COVERAGE) e a quantidade de vezes que o comando CALL foi processado (EXECUTION-COUNT) durante toda a execuo do programa. X


Mainframe Express 3.04- Totalizadores de freqncia de dados, classificados em ordem decrescente pela quantidade de vezes que o campo foi referenciado durante a execuo: Identificao do campo de dados (DATA-NAME). Total de referncias (REFERENCES) a este campo durante toda a execuo, isto , se existem duas referncias a um certo campo no programa e as instrues que fazem a referncia a este campo foram executadas 10 vezes, ento teremos o total de 20 referncias ao campo. Tamanho do campo (SIZE) definido no programa. Se houve a necessidade de alinhamento (ALIGNMENT) na movimentao / comparao deste campo. Exemplo: mover campo de 5 bytes numrico para campo de 10 bytes alfanumrico. E caso houver a perda de informao quando do alinhamento aparecer mensagem MISALIGNED.


apostila mfe 3

Documents