Enterprise Modernization para o IBM System z: Ferramentas de Determinação de Problemas do System z no Rational Developer para System z

Página 3 de 6  Opções de documento Classificar este tutorial Ajude-nos a melhorar este conteúdo

Instruções do Tutorial

Esta seção mostra como executar o tutorial das Ferramentas de Determinação de Problemas do System z no Rational Developer para System z.

Navegar até o Explorador de Sistema Remoto

Certifique-se de estar na perspectiva Explorador de Sistema Remoto. No Rational Developer para System z, uma perspectiva fornece a você as ferramentas certas para uma tarefa específica. Neste caso, a tarefa está interagindo com arquivos e sistema MVS tradicionais. As mesmas tarefas podem ser concluídas na perspectiva Projetos do z/OS, como você não vai criar um projeto, a perspectiva Sistema Remoto fornece um espaço mais utilizável para sua tarefa.

1. Se o título na parte superior direita do Rational Developer para System z não informar Explorador de Sistema Remoto, selecione Janela > Abrir Perspectiva > Outra. Uma caixa semelhante à mostrada na Figura 1 deve aparecer.
2. A seguir, selecione Explorador de Sistema Remoto, conforme mostrado na Figura 2 e, então, clique em OK .

Nota: Se, em algum momento, as telas não estiverem onde descritas, utilize Janelas > Reconfigurar Perspectiva para voltar para o layout de tela padrão

Atualizar conjuntos de dados de exercício

Os conjuntos de dados utilizados neste script podem ou não estar disponíveis, dependendo de como o último usuário deixou a sandbox. Para garantir que você tenha um ambiente de teste válido, utilize as seguintes etapas para atualizar os conjuntos de dados necessários para este exercício. Para atualizar os conjuntos de dados, será necessário acessar um conjunto de dados que não inicia com seu ID do usuário. Uma maneira de fazer isto é criar um filtro. Um filtro de conjunto de dados permite que você crie uma lista de conjuntos de dados necessários para definir um padrão ou uma lista de nomes de conjuntos de dados. Este exemplo requer apenas um conjunto de dados PDS.

1. Para criar o filtro, clique com o botão direito do mouse em Arquivos MVS e selecione Novo > Filtro, conforme mostrado na Figura 3.

Uma janela Novo Filtro é aberta. Na caixa de texto Filtrar string, digite o nome do conjunto de dados do SYS030.MASTER.SANDBOX.JCL (Figura 4) e, então, clique em Avançar .

Após criar o filtro, você será solicitado a inserir o nome deste novo filtro.

1. É possível nomear o filtro como você desejar, mas, para este exemplo, digite Criar DS Jcl para o Nome do Filtro conforme mostrado na Figura 5.
2. Clique em Concluir .

O novo filtro está pronto para utilização.

1. Para revelar os nomes dos membros, clique no sinal de mais (+) próximo ao novo filtro e + próximo à string SYS030.MASTER.SANDBOX.JCL.
2. Clique com o botão direito do mouse no membro CREATEDS e selecione Enviar, conforme mostrado na Figura 6.

Este tutorial assume que a tarefa foi concluída com êxito e que os seus conjuntos de dados foram atualizados, antes de continuar com as próximas etapas.

Inicie a demonstração enviando XSAM para executar JCL

Nesta seção do tutorial, você enviará o JCL para executar um programa em lote. O programa incorrerá um problema fazendo com que a tarefa encerre de forma anormal (ABEND).

Esta seção irá:

• Demonstrar como as Ferramentas de Determinação de Problemas podem ajudá-lo a determinar o problema.
• Mostrar a você onde ocorreu o problema no programa.
• Animar a execução real do programa com o depurador para observar a finalização anormal.
• Temporariamente resolver o problema.
• Criar uma correção permanente para o problema.

Para iniciar, você enviará o JCL que contém o problema.

1. Clique no sinal de mais (+) próximo a Arquivos MVS,
2. Em seguida, clique no sinal de mais (+) próximo a Meus Conjuntos de Dados (userid.*).
3. Role para baixo até localizar userid.SANDBOX.JCL. Clique em + próximo ao conjunto de dados userid.SANDBOX.JCL.
   Na etapa anterior, o JCL foi enviado clicando com o botão direito do mouse do membro JCL. Desta vez, o tutorial abrirá o membro no editor e, então, enviar o JCL.
4. Role para baixo e dê um clique duplo no membro do arquivo XSAM.jcl, conforme mostrado na Figura 7, para abrir o arquivo.

Nota: se você não visualizar os conjuntos de dados userid.SANDBOX.*, clique com o botão direito do mouse em Meus Conjuntos de Dados (userid.*) e selecione Atualizar.

O arquivo XSAM.jcl é aberto no editor. O editor padrão torna mais fácil ler o JCL colorindo as linhas ativas.

1. Neste momento, não há linhas para alterar, portanto, você pode enviar a TAREFA clicando com o botão direito do mouse na caixa do editor e selecionado Enviar, conforme mostrado na Figura 8.

Validar código de retorno de saída de envio de tarefa

Enviar o JCL a partir do editor coloca o ID da tarefa na parte superior do editor. Bem abaixo, o ID da tarefa é uma guia denominada Detalhes do Sistema Remoto. A saída da tarefa é exibida nesta caixa.

1. Se o número da tarefa de saída não estiver sendo exibido, clique no ícone Atualizar na barra de controle, conforme mostrado na Figura 9.

Nota: Se a caixa contiver o JES , siga estas etapas para exibir a saída de tarefa:

1. Dê um clique duplo no JES para exibir Minhas Tarefas
2. Em seguida, clique duas vezes em Minhas Tarefas para exibir a saída de tarefa.

Na lista de saída, você deve visualizar a tarefa que corresponda, com o ID da TAREFA mostrado na Figura 10. Na saída, observe que o Código de Retorno tem um valor de S0C7.

1. Para visualizar a saída da tarefa, clique duas vezes na entrada ou clique com o botão direito do mouse e selecione Abrir a partir do menu de contexto, conforme mostrado na Figura 10.
2. Os resultados aparecerão na caixa próxima ao Editor JCL com uma nova guia. Procure a linha semelhante a "+IDI0003I Fault ID EPS00060 assigned in history file FAULT.V8R1.HIST"

Sugestão: A combinação de teclas CTRL-F abrirá um menu de localização que pode ser utilizado para localizar esta linha localizando a string hist. Realce o nome do arquivo de histórico na saída de tarefa, clique com o botão direito do mouse e copie o texto, conforme mostrado na Figura 11. Você utilizará o texto copiado para especificar o arquivo de histórico na próxima seção.

Nota: O nome do membro do histórico está na mesma linha. Este nome pode ser utilizado para identificar sua entrada no arquivo de histórico mais tarde neste tutorial. Na Figura 11, o nome é F00729.

Analisando S0C7 com o Fault Analyzer

Utilize primeiro a perspectiva Fault Analyzer (perspectiva FA). Há muitas maneiras para alternar perspectivas. Nesta seção, você percorrerá uma alternativa para as etapas utilizadas anteriormente neste tutorial. A perspectiva atual é mostrada na guia superior direita do Rational Developer para System z. Próximo à perspectiva atual, está um ícone quadrado,

1. Clique neste ícone e uma lista de perspectivas utilizadas recentemente é exibida, conforme mostrado na Figura 12.
2. Como você não esteve na perspectiva FA ela não é mostrada na lista. Selecione Outro….

1. Isto abrirá uma caixa de seleção de perspectiva. Selecione Perspectiva FA e, então, clique em OK .
2. Na perspectiva Fault Analyzer, clique em + próximo a Artefatos FA. Se não houver um +, ou o arquivo de histórico na saída de tarefa não for mostrado sob Artefatos FA, será necessário incluir um arquivo de histórico.
3. Para incluir um arquivo de histórico, clique com o botão direito do mouse em Artefatos FA na caixa superior esquerda e selecione Incluir Novo Arquivo de Histórico, conforme mostrado na Figura 13.

Um diálogo pop-up é aberto, conforme mostrado na Figura 14. Na linha de entrada denominada Nome do Arquivo de Histórico, digite o nome do arquivo de histórico localizado na saída de tarefa.

Sugestão: Você pode colar o nome copiado da saída de tarefa na etapa anterior. Após o arquivo de histórico ter sido especificado, clique em OK .

Além disso, especifique o Nome da Conexão RSE. Dependendo da quantidade de dados, pode levar algum tempo para mostrar os ABENDs capturados no arquivo de histórico ao listá-los pela primeira vez. Os dados padrão são apresentados na parte inferior direita da página da perspectiva, conforme mostrado na Figura 15. As colunas mostram:

• O ID associado com o ABEND
• O tipo de ABEND
• Outros dados úteis

Nas colunas dos encerramentos de forma anormal mais recentes, uma das entradas deve ser 0C7 , recém-produzido a partir da tarefa em lote.

Sugestão: Se você não visualizar sua tarefa na lista:

1. Clique com o botão direito do mouse no nome do arquivo de histórico e selecione Preencher/Atualizar Arquivo de Histórico.
2. Para iniciar a análise do problema, clique com o botão direito do mouse na entrada ABEND e selecione Procurar Relatório.
3. Para localizar sua entrada, procure S0C7 na coluna Abend e o seu ID do usuário na coluna User_ID .
4. Clique com o botão direito do mouse nesta entrada e selecione Procurar Relatório, conforme mostrado na Figura 16.

Sua tela será semelhante à Figura 17, com todas as ferramentas Fault Analyzer disponíveis. A navegação da árvore Artefato FA no painel esquerdo, você pode acessar os arquivos de histórico a partir dos mainframes. Abaixo desta área de janela está o resumo, que torna a navegação no arquivo de histórico fácil e rápida. A seção inferior direita, que você acabou de utilizar, lista as falhas e os detalhes sobre as falhas nas colunas.

É possível classificar e customizar as colunas para tornar a localização de um ABEND específico fácil e rápida. Também é possível utilizar as informações do ABEND nas colunas para localizar tendências de problemas. O painel principal contém o relatório FA e os detalhes do Histórico de Falhas.

A visualização Detalhes do Histórico de Falhas possui cinco guias.

• A guia inicial, Relatório Principal, fornece um resumo do problema.
• A guia Resumo de Eventos mostra todos os eventos (caminho de chamada) que levam até o problema e no qual o problema original ocorreu.
• A guia Informações de Encerramento de Forma Anormal da Tarefa contém todas as informações sobre este encerramento de forma anormal específico (semelhante às informações mostradas na array ABEND na seção inferior). Além disso, ela possui as configurações do ambiente de tempo de execução e informações de edição de link para o problema.
• A guia Informações do Sistema Inteiro possui blocos de controle que pertencem ao ABEND. Ela lista valores para os blocos de controle para os subsistemas específicos. Isto é especificamente importante quando os ABENDs ocorrem em um subsistema como CICS, IMS ou DB/2.
• A guia Informações Diversas contém as informações específicas sobre como o Fault Analyzer é chamado e algumas das customizações utilizadas.

1. Utilize a guia Relatório Principal para iniciar a análise do ABEND. Todos os itens sublinhados em azul são links para outras áreas do relatório.
2. Clique no ABEND S0C7 para iniciar a função de consulta da ferramentas Fault Analyzer.

A página de resumo fornece uma breve explicação do código ABEND e a consulta fornece uma explicação completa. A consulta pode ser utilizada de maneira independente do resto da ferramenta Fault Analyzer e não apenas para os ABENDs, mas para os códigos de retorno para ferramentas IBM como chamadas do IBM® DB2® SQL ou IP Multimedia Subsystem (IMS).

1. À medida que você rola para baixo até o Relatório Principal, observe a instrução COMPUTE na linha 196. As variáveis utilizadas na linha 196 e as definições no programa são listadas. Na parte inferior do relatório, são mostrados os valores de tais variáveis. O valor de CUST-ACCT-BALANCE é mostrado em um formato hexadecimal porque os dados não são um número de pacote válido. Isto também é sinalizado com o texto "*** Dados numéricos inválidos ***", denotando que este valor causou o problema.
2. Clique na guia Resumo de Eventos para visualizar o caminho da chamada. O caminho da chamada informa que o problema ocorreu em um programa denominado SAM2 e o programa SAM2 é chamado pelo SAM1.
3. Role para baixo até visualizar todos os eventos no relatório. O evento que contém o problema já está expandido e realçado. No evento 3, as informações fornecidas na guia de resumo é fornecida em mais detalhes. Neste ponto, há informações importantes para iniciar uma sessão de depuração.

Você sabe:

• O problema ocorre no programa SAM2
• CUST-ACCT-BALANCE é a variável
• O valor da variável é X'7C7B5B6C50'.

A perspectiva completa do analisador de falhas com o resumo do evento é mostrada na Figura 18.

Depurando o programa com o S0C7 com a ferramenta de depuração

Há uma interface de depuração interativa da GUI. A depuração da GUI precisa de uma comunicação de duas vias que não é possível na interface Sandbox. Consulte a Figura 19 abaixo para obter um exemplo da perspectiva de depuração (não produzida neste exercício de sandbox). A interface de depuração mostra:

• O caminho da chamada
• A posição atual na origem COBOL
• As variáveis utilizadas pela instrução COBOL atual.

A interface de tela verde que precisa apenas de uma conexão Virtual Telecommunications Access Method (VTAM) é utilizada para mostrar como depurar capacidades.

O depurador interativo precisa saber onde a interação ocorrerá. Utilizar a tela do VTAM no Rational Developer para System z possibilita este tipo de situação. A primeira coisa que você desejará fazer é voltar para a perspectiva Explorador de Sistema Remoto.

1. Na perspectiva Explorador de Sistema Remoto, clique com o botão direito do mouse na conexão de mainframe denominada dallas e selecione Suporte ao Emulador de Conexão de Host, conforme mostrado na Figura 20.

1. O emulador padrão assume o uso da Time Sharing Option (TSO). Você precisará ajustar as configurações para utilizar um emulador diferente para este tutorial.

Nota: Configure uma conexão especial com esta configuração salva se planejar ajustar a configuração para utilizar um emulador diferente com frequência.

Para alterar a configuração:

1. Selecione a guia Propriedades de Host na janela do emulador.
2. Altere o número da porta de 23 para 2023 (esta etapa é necessária para utilizar a tela do VTAM com o depurador).
3. Selecione Desconectar.
4. Selecione Conectar.

O emulador de depuração iniciará.

Há duas maneiras que o depurador interage com o VTAM.

• Efetue logon com seu ID do usuário
• Especifique a tela do VTAM

Neste tutorial, utilize a identificação da tela do VTAM específica.

1. Copie o nome da tela da LU do VTAM do monitor para utilizar ao modificar a JCL, conforme mostrado na Figura 21.

Nota: É importante reservar um tempo para escrever o nome da tela da LU do VTAM no caso de desejar reutilizá-lo. Neste tutorial, o valor é TRMLU013.

Para iniciar a sessão de depuração:

1. Envie novamente o JCL e transmita os parâmetros de depuração para programas que deseja testar.
2. Selecione a guia XSAM.jcl.
3. Remova o comentário e modifique o nome da LU do VTAM. Você deve visualizar as três linhas PARM comentadas. Utilize a que contém "PARM='/TEST(,,,MFI%"
4. Cole o nome da tela da LU após o sinal de percentual. Deixe a vírgula e o parêntese de fechamento na linha, conforme mostrado na Figura 22.
5. Salve e envie a JCL.

Sugestão: Para Salvar um arquivo, digite Ctrl+S ou clique com o botão direito do mouse no editor e selecione Salvar.

Sugestão: Para Enviar a JCL, clique com o botão direito do mouse no editor e selecione Enviar, conforme mostrado na Figura 23.

Nota:Quando a linha não é comentada, a cor é alterada. Esta alteração de cor é útil para observar quando introduzir o comentário posteriormente neste tutorial.

1. Selecione a guia dallas.hce e, então, clique na tecla PF3 . Dê um clique duplo no dallas.hce para visualizar o emulador de tela verde na tela inteira. Assumindo que a JCL inicia imediatamente, você deve visualizar a tela de depuração.

A tela de depuração tem três seções:

• A seção superior mostra as variáveis de interesse, que serão mostradas em etapas subsequentes.
• A seção central mostra o código de origem e, por padrão, mostrará sua posição atual no código de origem durante a depuração.
• A seção inferior mostra os comandos utilizados na depuração. Esta seção pode ser salva e reutilizada em outras sessões de depuração.

Nota: A maioria dos comandos mostrados a partir da depuração de tela verde tem botões utilizados na interface da GUI.

O comando GO na linha de comando (ou a tecla PF9) informa ao depurador para executar o programa até que um ponto de interrupção seja alcançado, conforme mostrado na Figura 24.

O depurador também mostra interrupções em exceções no programa, conforme mostrado na Figura 25. Um tipo de exceção é um ABEND.

O Depurador para na mesma instrução compute mostrada no relatório Fault Analyzer. A seção Monitor na parte superior da tela mostra os valores das variáveis para esta instrução. Um valor inválido em CUST-ACCT-BALANCE é realçado em vermelho, conforme mostrado na Figura 26. O log mostra a exceção que causou a parada do programa, na parte inferior da tela.

Uma função do Debug Tools Utilities and Advanced Functions é o comando PLAYBACK . Este comando permite que você reproduza o código de modo inverso para visualizar onde o valor inválido foi introduzido na variável.

Utilize o comando MONITOR LIST e aponte para o CUST-ACCT-BALANCE para visualizar quando o valor de CUST-ACCT-BALANCE foi alterado, conforme mostrado na Figura 27. Isto é possível mesmo quando uma instrução não está utilizando esta variável.

Inicie oPLAYBACK e utilize o comando STEP 25 (mostrado na Figura 28) para consultar o programa animado vinte cinco etapas atrás. Na reprodução, você verá a alteração atual nas variáveis, bem como o valor de CUST-ACCT-BALANCE.

CUST-ACCT-BALANCE ainda contém o valor inválido. Selecione PF2 ou utilize um comando STEP 1 para visualizar a instrução que causou o valor inválido, conforme mostrado na Figura 29.

O valor inválido foi introduzido com uma instrução READ . Para descobrir mais sobre a instrução read, utilize o comando Find CUSTOMER-FILE FIRST para visualizar a declaração de CUSTOMER-FILE, conforme mostrado na Figura 30.

A partir do código, você pode visualizar se CUSTOMER-FILE utiliza o nome DD CUSTFILE. Saber disso o ajuda a identificar qual arquivo forneceu os dados na JCL. Para corrigir temporariamente os dados com falha e continuar a testar, utilize o comando PLAYBACK STO , conforme mostrado na Figura 31.

O comando PLAYBACK STOP reposiciona o cursor no ponto no programa onde ocorreu o problema. Para esta sessão de depuração, corrija temporariamente o problema nos dados substituindo o valor por qualquer número válido (este exemplo utiliza 10) em CUST-ACCT-BALANCE na janela do monitor, conforme mostrado na Figura 32.

O comando RUN BYPASS corrigiu os dados, conforme mostrado na Figura 33. Avise ao programa para ignorar a exceção e continue a executar.

O programa executa até o encerramento e mostra um código de retorno zero. Clique duas vezes na guia dallas.hce para visualizar todas as telas do Eclipse. Atualize a saída de tarefa na janela Detalhes do Sistema Remoto na parte inferior direita da tela para visualizar o código de retorno.

Nota: A Figura 34 mostra o terminal da LU na conclusão da sessão de depuração.

A última etapa é atualizar os dados incorretos. Clique com o botão direito do mouse no conjunto de dados que contém os dados inválidos e selecione Abrir, conforme mostrado na Figura 35. É possível localizar qual arquivo editar e corrigir a JCL ao mesmo tempo. Selecione a guia JCL na janela central superior para editar arquivos e, então, comente a linha de parâmetro TEST.

Nota: O script CUSTFILE DD utiliza o conjunto de dados denominado userid.SANDBOX.SAMFILE.

Utilizando a guia Sistemas Remotos à esquerda, role para baixo e localize o arquivo.

Nota: Os conjuntos de dados são classificados em duas listas em ordem alfabética. A primeira lista é de todos os conjuntos de dados PDS. A segunda lista contém todos os outros conjuntos de dados.

Um aviso sobre dados não-exibíveis será aberto. Selecione OK para limpar o aviso. Os dados agora estão visíveis, conforme mostrado na Figura 36. Infelizmente, isto não é fácil ler. Portanto, será difícil identificar o registro que contém os dados inválidos e localizar os dados inválidos.

A próxima seção deste tutorial mostrará como tornar a visualização dos dados mais fácil.

Corrigindo um problema de dados com o File Manager

Para abrir um editor apropriado, o Rational Developer para System z utiliza dois critérios para determinar o conteúdo de um conjunto de dados.

O critério principal para determinar o conteúdo de um arquivo é a convenção de nomenclatura dos conjuntos de dados. Por exemplo, qualquer conjunto de dados terminando com JCL é interpretado como um arquivo JCL (você pode customizar isso).

Um tipo de dados contém dados utilizados pelos programas. Os dados são identificados por um tipo tdat . Os dados são determinados automaticamente quando o conteúdo de um arquivo é a organização do conjunto de dados do VSAM ou podem ser identificados por uma convenção de nomenclatura do conjunto de dados. Para arquivos tdat , é possível fornecer um copybook ou modelo para ajudar a identificar como formatar os dados em um formato legível se você tiver o File Manager.

Como o seu arquivo de dados não possui uma convenção de nomenclatura que seja facilmente identificada e o arquivo que você deseja editar é sequencial, é necessário identificar manualmente o arquivo como tdat. Durante a identificação do conjunto de dados como dados, também é possível identificar o copybook a ser utilizado para mapear os dados.

Clique com o botão direito do mouse em userid.SANDBOX.SAMFILE e selecione Propriedades, conforme mostrado na Figura 37.

Para informar ao Rational Developer para System z que o conteúdo do conjunto de dados são dados, especifique o seguinte, conforme mostrado na Figura 38.

• Selecione Mapping
• Em Extensão, selecione o botão de opções Outro .
• Especifique tdat na caixa de texto

Para associar o copybook para ser mapeado com os dados, clique em Associação de Modelo e utilize a caixa de seleção sob o título de Procurar por Modelo/Copybook:

Expanda o primeiro conjunto de dados userid.SANDBOX.COPYLIB e o membro de CUSTREC1.cpy, conforme mostrado na Figura 40. Clique no botão Aplicar e, então, clique em OK .

O ícone próximo ao arquivo será alterado. Clique duas vezes no arquivo (EM4Z01.SANDBOX.SAMFILE) para editá-lo com o File Manager.

Clique duas vezes na guia para o editor do arquivo para visualizar o arquivo na tela inteira (consulte a Figura 41). A tela inteira permite que você visualize uma grande quantidade de dados. Se você tiver familiaridade com a versão de tela verde do File Manager, observará que o modo de tabela e o modo único estão no mesmo painel. Selecionar qualquer registro na seção da tabela ativa a seção Registro Único e sincroniza o registro.

É fácil visualizar que o registro contendo o nome de Turner, Paige possui dados inválidos. Isto é indicado pelos asteriscos vermelhos na coluna saldo da conta. Para corrigir os dados, realce a coluna e digite sobre os asteriscos com um número válido (neste caso, 10), conforme mostrado na Figura 41. Quando pressionar Enter, o número será formatado. Quando você fechar o arquivo, será solicitado a salvar o arquivo caso ainda não o tenha feito.

Verificar os resultados

Para provar que o problema foi corrigido, volte até a JCL e envie a tarefa (salve a alteração para o parâmetro caso ainda não o tenha feito). Verifique a saída do JES e verifique se obteve um código de retorno de zero. Lembre-se de que é necessário atualizar a exibição da saída clicando no botão para atualizar (duas setas amarelas), conforme mostrado na Figura 42.

Voltar para parte superior

	Página 3 de 6