========================================================================
* IBM(R) IBM Debugger for AIX, Version 6.1
* (C) COPYRIGHT International Business Machines Corp. 2006, 2008
* All Rights Reserved
* Licensed Materials - Property of IBM
*
* US Government Users Restricted Rights - Use, duplication or
* disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
* AIX and IBM are trademarks of IBM Corp.
*
* Other company, product, and service names may be trademarks or service
* marks of others.
========================================================================

O IBM Debugger para AIX, Versão 6.1, suporta depuração local e remota para aplicativos C/C++ que estão em execução no AIX Versão 5. Aplicativos em execução em uma máquina AIX podem ser depurados a partir da interface com o usuário do depurador em execução na mesma máquina ou remotamente a partir de outra máquina AIX ou Windows.

Este documento contém as seguintes seções:

• Software Obrigatório
• Instalando o IBM Debugger para AIX
• Desinstalando o IBM Debugger para AIX
• O que Há de Novo no IBM Debugger para AIX, Versão 6.1
• Iniciando uma Sessão de Depuração
• Acessando a Documentação do IBM Debugger para AIX
• Limitações do IBM Debugger para AIX

Software Obrigatório

Instalação do Cliente AIX

O cliente AIX requer o AIX v5.2 (AIX 5200-07 ou posterior) ou AIX v5.3 (AIX 5300-03 ou posterior).

Para testar se esta plataforma de instalação é suportada, no prompt do sistema digite lscfg -p | fgrep Architecture. Você deve receber a resposta Model Architecture: chrp. Apenas sistemas chrp (Common Hardware Reference Platform) são suportados.

A depuração dos seguintes recursos será suportada apenas se os recursos correspondentes estiverem presentes no hardware ou no sistema operacional:

• TLS (Thread Local Storage)
• DFP (Decimal Floating Point)
• Tipos de vetor
• Recursos de Hardware POWER5 e POWER6

Instalando o IBM Debugger para AIX

Se você instalou todos os conjuntos de arquivos ao instalar os compiladores XL C/C++, conforme descrito no procedimento de instalação padrão no "Guia de Instalação do IBM XL C/C++ Enterprise Edition para AIX, V9.0", todos os componentes do IBM Debugger para AIX (cliente e mecanismo) já estão instalados.

Se você não instalou todos os conjuntos de arquivos ao instalar os compiladores XL C/C++, ou utilizou o procedimento de instalação não-padrão, será necessário instalar os componentes do IBM Debugger para AIX separadamente. Para obter instruções, consulte "Instalando o Mecanismo de Depuração (irmtdbgc) e o Cliente da Interface com o Usuário (idebug) para AIX" abaixo.

Caso queira utilizar o cliente da interface com o usuário do IBM Debugger no Windows, será necessário seguir o procedimento em "Instalando o Cliente da Interface com o Usuário (idebug) para Windows" abaixo.

Se estiver instalando uma versão completa do produto e não uma Correção Temporária, é recomendado desinstalar todas as versões anteriores do IBM Debugger antes de instalar esta versão do IBM Debugger para AIX (consulte Desinstalando o IBM Debugger para AIX).

Instalando o Mecanismo de Depuração (irmtdbgc) e o Cliente da Interface com o Usuário (idebug) para AIX

O IBM Debugger para AIX está empacotado nos seguintes conjuntos de arquivos:

Para instalar os componentes do IBM Debugger no AIX, além dos conjuntos de arquivos de mensagens apropriados atualmente suportados por seu sistema, emita os seguintes comandos:

installp -aXgd . -e /tmp/ibmdebugger.install.log ibmdebugger*

Instalando o Cliente da Interface com o Usuário (idebug) para Windows

Para instalar o cliente da interface com o usuário para Windows:

1. Abra um prompt de comandos e navegue para o diretório IBMdebugger\windows\ no CD do produto.
2. Execute o programa, IBMdebugger\windows\setup.exe, no CD do produto e depois siga os prompts na tela para instalar o cliente da interface com o usuário.

Desinstalando o IBM Debugger para AIX

Desinstalando no Windows

Para desinstalar o cliente Windows do IBM Debugger para AIX, abra o Painel de Controle do Windows e escolha Adicionar ou Remover Programas. Localize e selecione IBM Debugger para AIX. Clique em Remover para iniciar o processo de desinstalação.

Se a desinstalação falhar, as seguintes etapas podem ser seguidas para que o programa de desinstalação seja iniciado manualmente:

1. Abra um prompt de comandos.
2. Altere o diretório (com o comando cd) para o diretório de instalação do IBM Debugger para AIX. O diretório de instalação padrão é C:\Program Files\IBM\IBM Debugger para AIX.
3. Altere o diretório (com o comando cd) para _jvm\bin.
4. Digite o seguinte comando: java -jar ..\..\_uninst\uninstall.jar
5. O programa de desinstalação será iniciado.

Desinstalando no AIX

Para desinstalar o mecanismo/cliente IBM Debugger para AIX no AIX, emita este comando ao efetuar logon como usuário root:

installp -u ibmdebugger*

O que Há de Novo no IBM Debugger para AIX, Versão 6.1

• Suporte para:
  • Hardware POWER6
  • Registros AltiVec
  • DFP (Decimal Floating Point)
  • TLS (Thread Local Storage)
• Filtragem de variável local
• Função show_self, que permite que o conteúdo de um objeto C++ seja exibido de maneira significativa
• Avaliação da função C/C++ para funções com ligação C
• Avaliação de expressão para expressões de designação
• Suporte de exibição agregado on-line
• Suporte para caracteres do idioma nacional na origem C/C++
• Suporte para Cast-to-Template
• Monitoramento aprimorado de variáveis locais
• Uma nova visualização Console de Depuração (apenas Visualização Técnica)

Iniciando uma Sessão de Depuração

Antes de depurar um programa, certifique-se de ter compilado o programa com informações de depuração utilizando a opção compiladora -g.

Para iniciar uma sessão de depuração, primeiro inicie o cliente IBM Debugger em uma máquina AIX local ou remota ou em uma máquina Windows remota. Em seguida, ative a sessão de depuração local ou remotamente.

Iniciando o Cliente IBM Debugger

Para iniciar o cliente IBM Debugger no Windows, vá para o menu Iniciar do Windows e selecione Programas > IBM > IBM Debugger para AIX > IBM Debugger para AIX.

Para iniciar o cliente IBM Debugger no AIX, execute o comando idebug. Em um ambiente multiusuário (mais de um usuário executando o cliente da interface com o usuário na mesma máquina AIX), cada usuário deve selecionar um número de porta de daemon exclusivo. Para isso, especifique um intervalo de portas de daemon no cliente da interface com o usuário:

1. Inicie o cliente da interface com o usuário.
2. Clique na seta para baixo ao lado do ícone de daemon na visualização Depuração.
3. Digite um intervalo de portas que o cliente da interface com o usuário pode tentar utilizar (os intervalos são digitados, por exemplo, como 8001-8009).
4. O cliente da interface com o usuário utilizará a primeira porta disponível no intervalo.
5. Se o mecanismo de depuração for ativado a partir do cliente da interface com o usuário, ele utilizará a porta que o cliente da interface com o usuário encontrou disponível.
6. Se você estiver ativando o mecanismo de depuração diretamente, será necessário especificar a porta obtida pelo cliente da interface com o usuário.

Ativando o Mecanismo IBM Debugger

Para depurar um programa localmente, você pode ativar o mecanismo a partir do cliente AIX ou da linha de comandos. Para depurar um programa remotamente, você deve ativar o mecanismo a partir da linha de comandos do AIX.

Para ativar o mecanismo a partir do cliente AIX (apenas depuração local):

1. No cliente AIX, selecione Arquivo -> Nova Ativação -> Carregar um Programa.
2. Forneça as informações necessárias para localizar e ativar seu programa. No mínimo, você deve especificar o nome do executável. Se o programa não puder ser localizado em sua atual variável de ambiente PATH, inclua o caminho completo para o programa.

Seu aplicativo será carregado e a execução será suspensa em main().

Para ativar o mecanismo a partir da linha de comandos (depuração local ou remota), execute o seguinte comando:

irmtdbgc [-qhost=<hostname>:<uidaemonport>] <executável><parâmetros executáveis>

em que:

• <uidaemonport> é o número da porta TCP/IP na máquina cliente que é especificada nas preferências de daemon. O número da porta de daemon padrão é 8001. A porta especificada para o mecanismo deve ser uma das portas que a interface com o usuário está atendendo.
• -qhost=<hostname> é o nome da máquina host na qual o cliente está sendo executado. Você pode omitir essa opção se o cliente estiver sendo executado na mesma máquina ou se você tiver especificado a máquina cliente e a porta com a variável de ambiente DER_DBG_ADDR (consulte a seção Mecanismo Depurador de Limitações do IBM Debugger para AIX).
• <executável> é o caminho completo para o programa que você deseja depurar.
• <parâmetros executáveis> são os parâmetros transmitidos ao programa que você deseja depurar.

O mecanismo então se conectará ao cliente, carregará seu programa e o suspenderá ao atingir main().

Acessando a Documentação do IBM Debugger para AIX

A documentação completa para o IBM Debugger para AIX é fornecida em um centro de informações on-line que é ativado a partir do cliente IBM Debugger.

Para visualizar o sistema de ajuda: No cliente Windows ou AIX, selecione Ajuda > Conteúdo da Ajuda.

Limitações do IBM Debugger para AIX

Limitações Gerais:

• Ao aplicar uma Correção Temporária através de um cliente Windows, ocorre uma exceção SWT não-capturada gravada no arquivo de log quando você substitui a configuração atual por outra. Essa exceção pode ser ignorada e você pode continuar utilizando tranqüilamente o ambiente de trabalho com a configuração substituída.
• Ao utilizar o cliente AIX, quando uma renderização é incluída na Visualização de Memória, ela pode não ser posicionada no endereço básico do bloco de memórias. Para obter uma solução alternativa para este problema, clique com o botão direito do mouse na renderização e selecione Reconfigurar como Endereço Básico. Isso levará a renderização para o endereço básico do bloco de memórias.
• Quando você utilizar o cliente AIX, o sistema de ajuda pode falhar ao iniciar se houver um navegador da Web fora de funcionamento em seu caminho. Para garantir que o sistema de ajuda funcione, remova os navegadores da Web sem funcionamento de seu caminho.
• O IBM Debugger para AIX não suporta a transmissão do nome de um programa como um parâmetro para o comando idebug.

Mecanismo Depurador:

• A variável de ambiente do mecanismo depurador DER_DBG_PORT está obsoleta. O endereço do host e a porta devem ser especificados como DER_DBG_ADDR=host:port.
• A variável de ambiente DER_DBG_DEEP_STEP_DEBUG está obsoleta. Essa variável de ambiente foi substituída por DER_DBG_STEP_DEBUG = [SHALLOW | DEEP] [INCLUDE | NOINCLUDE], em que:
  • SHALLOW ou DEEP controla se a função step-debug apenas verifica a sub-rotina imediata para informações de depuração (SHALLOW) ou continua até que um local com informações de depuração seja localizado (DEEP). O padrão é SHALLOW. Uma step-debug intensa pode ficar lenta se você tiver grandes quantidades de código sem informações de depuração.
  • INCLUDE ou NO_INCLUDE determina se o código nos arquivos incluídos é tratado como contendo informações de depuração ao fazer uma step-debug. O padrão é INCLUDE.
• As seguintes variáveis de ambiente foram incluídas:
  • DER_DBG_BACKGROUND_READ - O valor padrão é YES. Sua configuração como NO impedirá o depurador de ler informações de depuração enquanto ele estiver inativo. Para aplicativos com quantidades extremamente grandes de dados de depuração, pode ser necessário configurar essa opção como NO para impedir que o depurador seja executado fora do espaço de heap.
  • DER_DBG_POWER_STEP - Se for configurado como Y ou YES, o depurador irá ignorar pontos de interrupção ao avançar. A configuração padrão é NO.
  • DER_DBG_CICS_STEP - Essa é uma variável de ambiente especial a ser utilizada durante a depuração no CICS. Isso faz o depurador avançar normalmente pelo código que chama rotinas via CICS.
• A variável de ambiente DER_DBG_ NO_LIBPTHDEBUG não é mais suportada.

Infocenter de Documentação

• Erro HTTP Status 500 ou código HTML visível nos resultados de procura da Ajuda: Se você procurar a documentação on-line na janela Ajuda (Ajuda > Conteúdo da Ajuda) e encontrar um dos seguintes problemas:
  • Erro HTTP Status 500, com a descrição "O servidor encontrou um erro interno () que o impediu de atender ao pedido."
  • Tags HTML visíveis na parte superior ou inferior da lista de resultados da procura, como <a class="link" id="a113" href="...
  Tente executar a mesma procura novamente na visualização Ajuda Dinâmica: clique em Ajuda > Ajuda Dinâmica ou selecione a tecla F1 e clique no link Procurar na parte inferior da visualização. A procura da Ajuda Dinâmica exibirá os resultados sob a categoria Ajuda Local.
• Clicar nos resultados de procura da Ajuda exibe código XML: Se você procurar a documentação on-line na janela Ajuda (Ajuda > Conteúdo da Ajuda) e clicar em um dos resultados e o quadro do conteúdo exibir um arquivo de origem XML no lugar de algo legível, execute a procura novamente na visualização Ajuda Dinâmica. Clique em Ajuda > Ajuda Dinâmica e clique no link Procurar na parte inferior da visualização. A procura da Ajuda Dinâmica exibirá os resultados sob a seta Ajuda Local. Caso tenha selecionado o botão Mostrar Categorias de Resultados, o resultado que você está procurando será exibido sob uma categoria como Bem-vindo (estas são algumas das categorias exibidas corretamente apenas na visualização Ajuda Dinâmica).

Limitações do Idioma Nacional:

• Utilizando o comando irmtdbgc, você não pode carregar um programa cujo nome ou cujos parâmetros incluem caracteres com pontos de código UCS acima de 255. Tais programas podem ser carregados localmente com a ação do cliente AIX Arquivo > Nova Ativação > Carregar um Programa.
• Limitações do Idioma Bidirecional (BIDI/BiDi):
  • O editor Depurador, a visualização Variáveis, a visualização Monitores e a visualização Memória podem exibir palavras compostas incorretamente por caracteres e numerais BIDI. A posição dos numerais e caracteres BIDI na palavra pode estar incorreta.
  • Os caracteres árabes Lam Aleph (ou Lam Alef) não são exibidos corretamente na renderização EBCDIC na visualização Memória quando se usa CP420. CP420S pode ser utilizado no lugar.
  • A edição de uma variável de cadeia para que ela contenha caracteres árabes com tails pode não configurar o valor corretamente se o caractere tail não tiver um espaço adjacente. O caractere tail pode ser perdido.
  • Numerais hindi não podem ser digitados em campos de edição nas visualizações Variáveis, Monitores e Memória.
• O texto da interface com o usuário que é incluído no produto como resultado da Correção Temporária deve ser apenas em inglês.