Escolar Documentos
Profissional Documentos
Cultura Documentos
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
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
na prpria janela
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.
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).
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.
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
do
programa,
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.
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.
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.
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.
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.
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:
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
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
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.
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.
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 <1> Create/Update Member, informe Member Name (Nome da Tela), Device Type (igual a 2), Description (Descrio tela) e adicione atravs 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 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<Add> para adicionar o campo a tela. Caracteres:
CPMBraxis 2008 pg: 21
Atualizando tela (.MFS) atravs do CO-MFS: Passo a passo: 1. Selecione a opo CO-MFS no menu Tools, opo Workbench. 2. Na opo <3> 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<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 pg: 22
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.
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.
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.
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.
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.
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.
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.
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
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