IBMR Compiled Language Debugger 7.5 - Notas sobre o Release

Alterações de Preferência na Porta Daemon

A porta utilizada pelo Daemon de Depuração agora é salva no espaço de trabalho. Cada espaço de trabalho agora possui uma porta daemon de depuração diferente.

A ação Alterar Porta... no Daemon de Depuração exibirá a página de preferências do Daemon de Depuração. A página de preferências permite alterar a porta e suporta a configuração de uma nova porta padrão. O botão "Configurar como Padrão" salvará o valor da porta, pois o novo padrão e os novos espaços de trabalho utilizarão a nova porta padrão.

Trabalhando com o Caminho do Mecanismo no Diálogo "Editar Caminho de Consulta de Origem"

A inclusão de um caminho do mecanismo atualiza o caminho padrão utilizado pelo mecanismo de depuração.

Para reconfigurar o padrão do caminho do mecanismo:
  1. Inclua uma entrada de caminho do mecanismo vazia.
  2. Remova a entrada vazia.

Suporte para Novo Editor Padrão

Em releases anteriores do RationalR Developer para System zTM, o Compiled Language Debugger usaria um Editor do Depurador especializado para exibir a origem do programa ou visualizações de listagem. O Rational Developer para System z agora suporta o editor padrão ao depurar programas COBOL ou PL/I (local ou host). Esse suporte aplica-se a programas que tenham uma visualização de código fonte. Todas as outras visualizações (Desmontagem ou Listagem) continuam utilizando o Editor do Depurador.

Considerações importantes ao utilizar o suporte ao editor padrão:
  • Esse suporte pode ser ativado/desativado utilizando a preferência:

    Executar/Depurar -> Depuração Compilada -> Sempre utilizar o Editor do Depurador ao depurar

    Quando a preferência for selecionada (marcada), o Editor do Depurador interno será utilizado. Quando a preferência não for selecionada (desmarcada), o depurador abrirá o editor padrão com base no idioma do programa sendo depurado.

  • O editor padrão para um idioma é definido na preferência:

    Geral -> Editores -> Associações de Arquivo

    As extensões de arquivo determinam qual editor será utilizado para exibir o código fonte de um programa sendo depurado. O depurador designará uma extensão de arquivo para o código fonte recuperado do mecanismo de depuração que corresponda ao idioma de programação do programa.

  • O Rational Developer para System z versão 7.5 suporta os seguintes editores padrão:
    • Editor LPEX do System z
    • Editor C/C++ Remoto
  • Quando o código fonte é obtido do mecanismo de depuração, ele é inteiramente copiado do mecanismo de depuração para um arquivo temporário no espaço de trabalho do usuário. O arquivo temporário é aberto utilizando o editor padrão no modo de leitura. Quando a sessão de depuração é encerrada, o arquivo temporário é excluído.
  • Se a código fonte for local, em um projeto do espaço de trabalho ou no sistema de arquivos local, o editor padrão carregará o arquivo local no modo de leitura. Se o arquivo local puder ser aberto para edição, uma ação pode estar disponível no menu pop-up do editor para permitir que o arquivo seja modificado. Se linhas de código fonte forem incluídas, removidas ou modificadas, o depurador pode não realçar a linha correta ao passar ou parar em um ponto de interrupção.
  • Os recursos sensíveis ao idioma do editor padrão serão disponibilizados, incluindo a visualização de esboço, se suportada pelo editor.

Assistente de Conteúdo do Console de Depuração para Comandos da Ferramenta de Depuração

Suporte básico para o assistente de conteúdo foi incluído na Visualização Console de Depuração. Pressionar Ctrl+Espaço no campo Entrada de Comando listará todos os comandos suportados da Ferramenta de Depuração. A lista é baseada no nível da Ferramenta de Depuração conectada. À medida que os caracteres são inseridos, a lista é filtrada para mostrar os comandos correspondentes.

Suporte para Pontos de Interrupção Executando Comandos da Ferramenta de Depuração

Versões mais recentes do mecanismo da Ferramenta de Depuração suportarão a execução de comandos da Ferramenta de Depuração quando um ponto de interrupção for atingido. Quando conectado a um mecanismo da Ferramenta de Depuração que suporta comandos em um ponto de interrupção, um novo campo aparecerá na página "Parâmetros Opcionais" do assistente do ponto de interrupção. Os comandos da Ferramenta de Depuração inseridos no ponto de interrupção serão executados quando o ponto de interrupção for atingido.

Programas em Batch

A depuração de um programa PL/I em batch não funcionará se o código fonte estiver em linha no JCL. O depurador requer um arquivo de código fonte.

Ao executar o Aplicativo de Depuração em um executável remoto, essa ação iniciará uma sessão de depuração em batch. Como o aplicativo está em execução em batch, não é possível fornecer entrada do programa no prompt de comandos do TSO. Para contornar isso, forneça toda entrada de usuário necessária no campo adicional de JCL na página de propriedades das opções Runtime do projeto.

Depuração Remota do CICS

Além da transação DTCN, com o CICSR TX Series, a transação CADP pode ser utilizada para depurar uma transação remota. Consulte o Guia do Usuários da Ferramenta de Depuração, para obter informações adicionais.

O depurador fornece duas interfaces para inserir o código de depuração em um programa CICS durante a etapa Link:
  • EQADCCXT - permite alterar dinamicamente o destino da listagem do depurador para uma estação de trabalho diferente.
  • CEEUOPT - O z/OSR insere um endereço IP estático e um número de porta no programa CICS.
Eis um exemplo de como a interface EQADCCXT foi vinculada e editada nos programas CICS:
  • INCLUDE SYSLIB(EQADCCXT)
  • INCLUDE SYSLIB(DFHELII)
  • INCLUDE SYSLIB(DSNCLI)

Se você decidir utilizar a interface EQADCCXT, o depurador fornecerá um programa CICS chamado Debug Tool Control Panel para alterar dinamicamente seu ambiente de teste de depuração. A sessão de depuração pode ser testada apenas na região CICS utilizando o protocolo MFI ou redirecionada para uma estação de trabalho, em que o Rational Developer esteja em execução, utilizando o protocolo TCP.

O Debug Tool Control Panel pode ser iniciado digitando DTCN no terminal CICS. Quando o Painel de Controle aparecer, basta digitar TCP para o protocolo, o número da porta na qual o programa do servidor do depurador do Rational Developer para System z está atendendo na estação de trabalho (geralmente, porta 8001) e o endereço IP da estação de trabalho. Especifique o ID de transação que é mapeado para sua definição de programa. Pressione PF4 para salvar e PF3 para sair. Neste ponto, verifique o Rational Developer para System z para certificar-se de que o servidor do depurador esteja atendendo no número da porta correto. Você pode chamar o programa CICS (por meio do ID da transação) e a perspectiva Depuração deve aparecer no Rational Developer para zSeriesR em sua estação de trabalho.

Depurando Arquivos de Código Fonte com Nomes Duplicados

Existe um problema conhecido com o depurador distribuído da estação de trabalho que pode causar a depuração do arquivo de origem incorreto. Fornecido o mesmo nome do arquivo de origem em dois Projetos Locais, será depurado o aplicativo incorreto. Definir pontos de interrupção no arquivo de origem em um fará com que o depurador pare no outro arquivo de origem como se os pontos de interrupção estivessem definidos nele. Esse é um defeito conhecido e será corrigido em um futuro release do produto. Para resolver o problema, mantenha apenas um arquivo de origem com um nome fornecido em seu espaço de trabalho. Para contornar o problema de ponto de interrupção, continue pressionando Run no depurador distribuído para ignorar os pontos de interrupção não-desejados.

Nome de Projeto com Mais de 80 Caracteres Causa Problemas na Depuração Local

A depuração local de um executável que reside em um projeto com um nome com mais de 80 caracteres pode resultar em um erro "Falha de Comunicações" no depurador, encerrando sua sessão de depuração.

Depurando um Programa COBOL com uma Instrução XML PARSE

Ao depurar um programa COBOL com uma instrução XML PARSE, as variáveis podem não serem exibidas na visualização Variáveis e as variáveis não podem suportar a monitoramento. Quando desejar ver todas as variáveis na visualização Variáveis, clique no programa COBOL na pilha que é o nome do programa COBOL na janela Depurar. Por exemplo, se estiver depurando um programa COBOL chamado XML1, na pilha você verá XML_XML1 e XML1. É necessário clicar em XML1 e, em seguida, clicar na guia Variables.

Quando desejar monitorar uma variável, na janela Código Fonte, clique na linha com PROGRAM-ID; em seguida, na janela Monitores e inclua o item de dados que deseja monitorar.

Alteração no Formato ADATA Produzido por HLASM

O formato do ADATA produzido pelo HLASM (High Level Assembler) alterou o formato da Versão 1 Release 4 para a Versão 1 Release 5. O utilitário Debug Tool EQALANGX - necessário para depuração do assembler simbólico de depuração - requer o formato ADATA Versão 1 Release 4. O HLASM envia uma saída ADATA opcional, ASMAXADR, que converte o arquivo ADATA a partir do formato Release 5 para Release 4. É necessário instalar e ativar essa saída para depuração HLASM simbólica da Ferramenta de Depuração. Se você não converter o formato ADATA para o formato do Release 4, o utilitário EQALANGX aparentemente será bem-sucedido e ocorrerá a falha durante a sessão de depuração.