========================================================================
* 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.
========================================================================

IBM Debugger para AIX, Versión 6.1, permite depurar local y remotamente aplicaciones C/C++ que se ejecuten en AIX Versión 5. Las aplicaciones que se ejecutan en una máquina AIX se pueden depurar desde la interfaz de usuario del depurador que funciona en la misma máquina o remotamente, desde otra máquina AIX o Windows.

Este documento consta de los siguientes apartados:

• Software prerrequisito
• Instalar IBM Debugger para AIX
• Desinstalar IBM Debugger para AIX
• Novedades de IBM Debugger para AIX, Versión 6.1
• Iniciar una sesión de depuración
• Acceder a la documentación de IBM Debugger para AIX
• Limitaciones de IBM Debugger para AIX

Software prerrequisito

Instalación del cliente AIX

Para el cliente AIX se necesita AIX v5.2 (AIX 5200-07 o posterior) o AIX v5.3 (AIX 5300-03 o posterior).

Para probar si esta plataforma de instalación está soportada, teclee lscfg -p | fgrep Architecture en el indicador del sistema. Debe recibir la respuesta Model Architecture: chrp. Solo están soportados los sistemas de la plataforma de referencia de hardware común (chrp).

La depuración de las siguientes características solo está soportada si las correspondientes características están presentes en el hardware o en el sistema operativo:

• Almacenamiento local de hebras (TLS)
• Coma flotante decimal (DFP)
• Tipos de vectores
• Dispositivos de hardware POWER5 y POWER6

Instalar IBM Debugger para AIX

Si instaló todos los conjuntos de archivos al instalar los compiladores XL C/C++, como se explica en el procedimiento de instalación predeterminado del manual "IBM XL C/C++ Enterprise Edition for AIX, V9.0 Installation Guide", ya estarán instalados todos los componentes de IBM Debugger para AIX (cliente y motor).

Si no instaló todos los conjuntos de archivos al instalar los compiladores XL C/C++ o si siguió el procedimiento de instalación no predeterminado, tendrá que instalar los componentes de IBM Debugger para AIX por separado. Las instrucciones están en el apartado "Instalar el motor de depuración (irmtdbgc) y el cliente de interfaz de usuario (idebug) para AIX", más abajo.

Si desea utilizar el cliente de interfaz de usuario de IBM Debugger en Windows, tendrá que seguir el procedimiento del apartado "Instalar el cliente de interfaz de usuario (idebug) para Windows", más abajo.

Si se propone instalar una versión de todo el producto y no un arreglo provisional, le recomendamos que desinstale las posibles versiones anteriores de IBM Debugger antes de instalar esta versión de IBM Debugger para AIX (vea: Desinstalar IBM Debugger para AIX).

Instalar el motor de depuración (irmtdbgc) y el cliente de interfaz de usuario (idebug) para AIX

IBM Debugger para AIX viene empaquetado en los siguientes conjuntos de archivos:

Para instalar los componentes de IBM Debugger en AIX, así como los conjuntos de archivos de mensajes pertinentes soportados actualmente en el sistema, emita los mandatos:

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

Instalar el cliente de interfaz de usuario (idebug) para Windows

Para instalar el cliente de interfaz de usuario para Windows:

1. Abra un indicador de mandatos y navegue hasta el directorio IBMdebugger\windows\, en el CD del producto.
2. Ejecute el programa IBMdebugger\windows\setup.exe, en el CD del producto, y siga las indicaciones en pantalla para instalar el cliente de interfaz de usuario.

Desinstalar IBM Debugger para AIX

Desinstalar en Windows

Para desinstalar el cliente Windows de IBM Debugger para AIX, abra el Panel de control Windows y elija la opción Agregar o quitar programas. Localice y seleccione IBM Debugger para AIX. Pulse Eliminar para que empiece el proceso de desinstalación.

Si la desinstalación falla, puede seguir estos pasos para iniciar manualmente el programa de desinstalación:

1. Abra un indicador de mandatos.
2. Cambie de directorio (con el mandato cd) para ir al directorio de instalación de IBM Debugger para AIX. El directorio de instalación predeterminado es C:\Program Files\IBM\IBM Debugger for AIX.
3. Cambie de directorio (con el mandato cd) para ir a _jvm\bin.
4. Teclee el mandato: java -jar ..\..\_uninst\uninstall.jar
5. El programa de desinstalación se iniciará.

Desinstalar en AIX

Para desinstalar el motor/cliente de IBM Debugger para AIX en AIX, inicie sesión como usuario root y emita el mandato:

installp -u ibmdebugger*

Novedades de IBM Debugger para AIX, Versión 6.1

• Soporte para:
  • Hardware POWER6
  • Registros AltiVec
  • Coma flotante decimal (DFP)
  • Almacenamiento local de hebras (TLS)
• Filtrado de variables locales
• Función show_self, que le permite visualizar el contenido de un objeto C++ de una manera que tenga sentido
• Evaluación de funciones C/C++, para funciones con enlazamiento C
• Evaluación de expresiones para las expresiones de asignación
• Soporte de pantalla de una sola línea en conjunto
• Soporte para caracteres de idioma nacional en el fuente C/C++
• Soporte de conversión temporal a plantilla
• Supervisión mejorada de las variables locales
• Una nueva vista de la consola de depuración (solo como avance tecnológico)

Iniciar una sesión de depuración

Antes de depurar un programa, no olvide compilarlo con información de depuración mediante la opción -g del compilador.

Para iniciar una sesión de depuración, primero debe iniciar el cliente de IBM Debugger en una máquina AIX local o remota o en una máquina Windows remota. Luego lance la sesión de depuración, ya sea local o remotamente.

Iniciar el cliente de IBM Debugger

Para iniciar el cliente de IBM Debugger en Windows, vaya al menú Inicio de Windows y seleccione Programas > IBM > IBM Debugger para AIX > IBM Debugger para AIX.

Para iniciar el cliente de IBM Debugger en AIX, ejecute el mandato idebug. En un entorno multiusuario (en el que más de un usuario ejecute el cliente de interfaz de usuario en una misma máquina AIX), cada usuario debe seleccionar un número de puerto exclusivo para el daemon. Para ello, especifique un rango de puertos de daemon en el cliente de interfaz de usuario:

1. Inicie el cliente de interfaz de usuario.
2. Pulse la flecha abajo junto al icono del daemon en la vista Depuración.
3. Teclee un rango de puertos que el cliente de interfaz de usuario pueda intentar utilizar (los rangos se teclean con el formato 8001-8009, por ejemplo).
4. El cliente de interfaz de usuario utilizará el primer puerto disponible del rango.
5. El motor de depuración, si se lanza desde el cliente de interfaz de usuario, utilizará el puerto que el cliente de interfaz de usuario haya encontrado disponible.
6. Si se propone lanzar el motor de depuración directamente, debe especificar el puerto obtenido por el cliente de interfaz de usuario.

Lanzar el motor de IBM Debugger

Para depurar un programa localmente, puede lanzar el motor desde el cliente AIX o desde la línea de mandatos. Para depurar un programa remotamente, debe lanzar el motor desde la línea de mandatos.

Para lanzar el motor desde el cliente AIX (solo para depuración local):

1. En el cliente AIX, seleccione Archivo -> Lanzar nuevo -> Cargar un programa.
2. Proporcione la información necesaria para localizar su programa y lanzarlo. Como mínimo, debe especificar el nombre del ejecutable. Si no se puede localizar el programa en la variable de entorno PATH actual, incluya la vía completa de acceso al programa.

La aplicación se cargará y la ejecución se suspenderá en main().

Para lanzar el motor desde la línea de mandatos (depuración local o remota), ejecute el mandato:

irmtdbgc [-qhost=<nombre de host>:<puerto de daemon de ui>] <ejecutable><parámetros de ejecutable>

Donde:

• <puerto de daemon de ui> es el número del puerto TCP/IP de la máquina cliente especificada en las preferencias del daemon. El número de puerto predeterminado del daemon es 8001. El puerto especificado para el motor debe ser uno de los puertos en que esté a la escucha la interfaz de usuario.
• -qhost=<nombre de host> es el nombre de la máquina de hospedaje en la que se ejecuta el cliente. Puede omitir esta opción si el cliente se ejecuta en la misma máquina o si ha especificado la máquina de cliente y el puerto con la variable de entorno DER_DBG_ADDR (vea el párrafo Motor del depurador, en el apartado Limitaciones de IBM Debugger para AIX).
• <ejecutable> es la vía completa de acceso al programa que desea depurar.
• <parámetros de ejecutable> representa los parámetros que se pasan al programa que desea depurar.

Entonces el motor se conectará con el cliente, cargará el programa y lo suspenderá cuando llegue a main().

Acceder a la documentación de IBM Debugger para AIX

La documentación completa de IBM Debugger para AIX se proporciona en un Information Center en línea que se lanza desde el cliente de IBM Debugger.

Para ver el sistema de ayuda: en el cliente Windows o AIX, seleccione Ayuda > Contenido de la ayuda.

Limitaciones de IBM Debugger para AIX

Limitaciones generales:

• Al aplicar un arreglo provisional mediante un cliente Windows, se produce una excepción no capturada de SWT que se escribe en el archivo de anotaciones cuando se sustituye la configuración actual por otra. Esta excepción se puede ignorar y usted puede seguir utilizando sin problemas el entorno de trabajo con la configuración sustituida.
• Cuando se utiliza un cliente AIX, si se añade una interpretación en la vista Memoria, la interpretación podría no situarse en la dirección base del bloque de memoria. Para solucionar provisionalmente este problema, pulse la interpretación con el botón derecho del ratón y seleccione Restablecer en dirección base. Esto hará que la interpretación se sitúe en la dirección base del bloque de memoria.
• Cuando se utiliza el cliente AIX, el sistema de ayuda podría no iniciarse si hay un navegador Web que no funciona en su vía de acceso. Para asegurar el buen funcionamiento del sistema de ayuda, quite los navegadores Web que no funcionan de su vía de acceso.
• IBM Debugger para AIX no permite pasar el nombre del programa como parámetro al mandato idebug.

Motor del depurador:

• La variable de entorno DER_DBG_PORT del motor de depuración ha caído en desuso. La dirección de host y el puerto se deben especificar como DER_DBG_ADDR=host:puerto.
• La variable de entorno DER_DBG_DEEP_STEP_DEBUG ha caído en desuso. Esta variable de entorno se ha sustituido por DER_DBG_STEP_DEBUG = [SHALLOW | DEEP] [INCLUDE | NOINCLUDE], donde:
  • SHALLOW (superficial) o DEEP (profundo) controla si la función de recorrer hasta depuración solo comprueba si existe información de depuración en la subrutina inmediata (SHALLOW) o si prosigue su camino hasta encontrar una ubicación que tenga información de depuración (DEEP). El valor predeterminado es SHALLOW. El proceso de recorrer hasta depuración en profundidad puede ser lento si se tiene una gran cantidad de código sin información de depuración.
  • INCLUDE o NO_INCLUDE determina si el código de los archivos incluidos se trata como que tiene información de depuración al realizar un proceso de recorrer hasta depuración, El valor predeterminado es INCLUDE.
• Se han añadido las siguientes variables de entorno:
  • DER_DBG_BACKGROUND_READ - El valor predeterminado es YES. Si se establece que esta variable sea igual a NO, el depurador no podrá leer información de depuración mientras esté desocupado de alguna manera. En el caso de las aplicaciones que tengan cantidades sumamente grandes de datos de depuración, puede ser necesario establecer que esta variable sea igual a NO para impedir que el depurador se quede sin espacio de memoria dinámica.
  • DER_DBG_POWER_STEP - Si se establece que esta variable sea igual a Y o YES, el depurador ignorará los puntos de interrupción al recorrer. El valor predeterminado es NO.
  • DER_DBG_CICS_STEP - Esta es una variable de entorno especial que debe utilizarse al depurar bajo CICS. Hace que el depurador recorra con normalidad el código que llama a rutinas por medio de CICS.
• La variable de entorno DER_DBG_ NO_LIBPTHDEBUG ya no está soportada.

Infocenter de documentación

• Error 500 de estado de HTTP o código HTML visible en los resultados de búsqueda de la Ayuda: si busca en la documentación en línea en la ventana Ayuda (Ayuda > Contenido de la ayuda) y se encuentra con uno de estos problemas:
  • Error 500 de estado de HTTP , con la descripción "El servidor ha encontrado un error interno () que le impidió satisfacer esta petición."
  • Códigos HTML visibles en la parte superior o inferior de la lista de resultados de la búsqueda, como <a class="link" id="a113" href="...
  Intente ejecutar la misma búsqueda en la vista Ayuda dinámica: pulse Ayuda > Ayuda dinámica o apriete la tecla F1 del teclado y pulse el enlace de Buscar situado en la parte inferior de la vista. La búsqueda de ayuda dinámica visualizará los resultados en la categoría Ayuda local.
• Al pulsar un resultado de búsqueda de la Ayuda se visualiza código XML: si busca en la documentación en línea de la ventana Ayuda (Ayuda > Contenido de la ayuda) y pulsa uno de los resultados y el marco de contenido visualiza un archivo fuente XML, en lugar de visualizar un archivo legible, vuelva a ejecutar la búsqueda en la vista Ayuda dinámica. Seleccione Ayuda > Ayuda dinámica y pulse el enlace de Buscar situado en la parte inferior de la vista. La búsqueda de ayuda dinámica visualizará los resultados en el triángulo Ayuda local. Si ha seleccionado el botón Mostrar categorías de resultados, el resultado que está buscando se mostrará bajo una categoría como la de Bienvenido (estas son algunas de las categorías que solo se visualizan correctamente en la vista Ayuda dinámica).

Limitaciones de los idiomas nacionales:

• Con el mandato irmtdbgc, no podrá cargar un programa cuyo nombre o parámetros incluyan caracteres con elementos de código UCS por encima del 255. Esos programas se pueden cargar localmente con la acción Archivo > Lanzamiento nuevo > Cargar un programa del cliente AIX.
• Limitaciones de los idiomas bidireccionales (BIDI/BiDi):
  • El editor del depurador, la vista Variables, la vista Supervisores y la vista Memoria pueden visualizar palabras compuestas incorrectamente por numerales y caracteres BIDI. La posición que ocupan los numerales y los caracteres BIDI en la palabra puede ser incorrecta.
  • Los caracteres árabes Lam Aleph (o Lam Alef) no se visualizan correctamente con la interpretación EBCDIC en la vista Memoria cuando se utiliza CP420. Se puede utilizar CP420S en su lugar.
  • Al editar una variable de tipo serie para que contenga caracteres árabes con colas, el valor puede no establecerse correctamente si el carácter con cola no tiene un espacio adyacente. El carácter con cola podría perderse.
  • Los numerales en hindi no se pueden entrar en campos de edición en las vistas Variables, Supervisores y Memoria.
• El texto de la interfaz de usuario que se añade al producto como resultado de un arreglo provisional solo está en inglés.