Utilización de la configuración de lanzamiento de depuración de procedimientos almacenados

Una configuración de lanzamiento es un mecanismo para definir y guardar diferentes configuraciones de entorno de trabajo que se pueden iniciar por separado. Puede utilizar configuraciones de lanzamiento para iniciar sesiones de depuración.

Puede crear una configuración de lanzamiento para iniciar una sesión de depuración de procedimiento almacenado o, si elige la acción Depurar en la vista Explorador de proyectos de datos para un procedimiento almacenado, se creará una configuración de lanzamiento. En ambos casos, siga los pasos que se indican de forma detallada en las pestañas de configuración de lanzamiento:

  1. Si está creando una nueva configuración de lanzamiento sin utilizar la acción Depurar de la vista Explorador de proyectos de datos, vaya a una perspectiva del entorno de trabajo que ofrezca el conjunto de acciones lanzar/depurar/ejecutar (por ejemplo, la perspectiva Depurar) y realice una de las tareas siguientes:
    • Seleccione Ejecutar > Depurar desde la barra de menús del entorno de trabajo para abrir el recuadro de diálogo de configuraciones de lanzamiento Depurar.
    • Pulse la flecha abajo situada al lado del pulsador Depurar de la barra de herramientas del entorno de trabajo y elija Depurar en la lista. Se abrirá el recuadro de diálogo de configuraciones de lanzamiento Depurar.

    Si utiliza la acción Depurar de la vista Explorador de proyectos de datos, se creará la configuración de lanzamiento y puede omitir éste paso y el siguiente.

  2. En el recuadro de diálogo de configuraciones de lanzamiento Depurar, realice una de las siguientes tareas:
    • Seleccione el nodo Procedimiento almacenado de DB2 y pulse en Nueva configuración de lanzamiento.
    • Pulse el botón derecho del ratón en el nodo Procedimiento almacenado de DB2 y seleccione Nuevo en el menú emergente.
    • Realice una doble pulsación en el nodo Procedimiento almacenado de DB2.
  3. En el campo Nombre, entre el nombre que desee para la configuración que va a crear.
  4. Seleccione la pestaña Principal para ponerla en primer plano.
  5. En el campo Proyecto, indique el proyecto de entorno de trabajo que esté asociado con el procedimiento almacenado que desea depurar. Para ello, pulse en Examinar y, en el recuadro de diálogo Nombre de proyecto resultante, seleccione el proyecto que desea utilizar y pulse en Bien.
  6. El URL de la base de datos (según JDBC) se visualizará en el campo Ubicación (URL). Este campo es de sólo lectura.
  7. Para especificar el procedimiento que desea depurar, pulse el botón Examinar del campo Procedimiento para invocar el recuadro de diálogo de selección de procedimiento. El procedimiento debe estar en el proyecto que se ha especificado previamente en el espacio de trabajo.
  8. En el recuadro de diálogo de selección de procedimiento, elija el procedimiento que desee depurar y pulse en Bien para volver a la página de configuración de lanzamiento.
  9. Tras seleccionar el procedimiento, el campo Procedimiento se rellena con el nombre del procedimiento. Este campo debe completarse obligatoriamente.
  10. Los argumentos que desee pasar el procedimiento para la sesión de depuración se especifican en la lista de argumentos. Inicialmente, la lista de argumentos utiliza los valores por omisión adecuados para el tipo de argumento o, si se han cambiado estos valores en el recuadro de diálogo Ejecutar configuración, la lista utiliza por omisión los valores cambiados. Al ejecutar una configuración de lanzamiento para un procedimiento almacenado que puede incluir parámetros, durante el tiempo de lanzamiento se abre un recuadro de diálogo Especificar los valores del parámetro. Puede utilizar este recuadro de diálogo para añadir o editar argumentos que deben pasarse al procedimiento almacenado. Como alternativa, puede pulsar el botón Editar del campo Lista de argumentos para invocar el recuadro de diálogo Ejecutar configuración, que le permitirá editar argumentos y otros valores de ejecución. Este botón aparece en gris y no está accesible si el procedimiento no incluye parámetros.
  11. El recuadro de diálogo Ejecutar configuración contiene varios valores para ejecutar procedimientos almacenados. En el recuadro de diálogo, seleccione la pestaña Valores de parámetro para acceder a los parámetros que están disponibles para el procedimiento seleccionado (los valores de esta pestaña son iguales que los del recuadro de diálogo Especificar los valores del parámetro). Para cada parámetro, se listan los siguientes elementos:
    • nombre de argumento
    • tipo (carácter, entero, etc.)
    Si el parámetro es de entrada o entrada/salida, la celda de valor para el campo de argumento está habilitada y puede editar el valor en el campo, especificando un valor entero o de caracteres, etc., dependiendo del tipo. Cuando termine de editar los valores de los parámetros, pulse en Bien para volver a la página de configuración de lanzamiento.
  12. Para establecer la Vía de búsqueda de fuente, seleccione la pestaña Fuente y realice una de las tareas siguientes:
    • Para añadir una ubicación de fuente, pulse en Añadir. Se abrirá el recuadro de diálogo Añadir fuente, en el que puede seleccionar el tipo de ubicación de fuente que debe añadirse. En la lista de selección del recuadro de diálogo Añadir fuente, si elige Área de trabajo, todos los proyectos del área de trabajo se añadirán a la vía de búsqueda de fuente. Las demás selecciones darán como resultado un recuadro de diálogo en el que puede entrar o examinar la ubicación de la vía de búsqueda de fuente que desea utilizar.
    • Para eliminar una entrada existente, seleccione una ubicación de fuente y pulse en Eliminar.
    • Para establecer el orden de las entradas existentes, seleccione una ubicación de fuente y pulse Arriba o Abajo para modificar la colocación de esa ubicación.
      Nota: En algunos casos, es posible que el cambio de emplazamiento de una ubicación no entre en vigor hasta la próxima vez que se lance el procedimiento almacenado.

    Si desea buscar todas las instancias del nombre de archivo fuente en la vía de búsqueda de fuente, seleccione el recuadro de selección Busca archivos fuente duplicados en la vía. Si selecciona este recuadro de selección y el depurador encuentra varias instancias del nombre de archivo, se le solicitará en un recuadro de diálogo que elija el archivo fuente correcto.

  13. Seleccione la pestaña Comunes para ponerla en primer plano. Puede realizar las tareas siguientes en la página Comunes:
    • Si desea que la configuración de lanzamiento se almacene localmente y esté disponible para un único usuario, asegúrese de que esté seleccionado el botón de selección Archivo local. Si la configuración de lanzamiento debe almacenarse como un archivo en el espacio de trabajo y compartirse en un depósito para que la utilice un equipo, seleccione el botón de selección Archivo compartido y entre una ubicación en la que desee guardar la configuración de lanzamiento. Como alternativa, puede navegar hasta la ubicación.
    • Si desea que la configuración de lanzamiento aparezca como configuración de depuración favorita en el menú de favoritos del pulsador Depurar o en la lista Historial de depuración del menú Depurar, seleccione el recuadro de selección Depurar.
    • En la sección Codificación de consola, indique la codificación de caracteres que desea que la vista Consola utilice. Por ejemplo, si desea que la vista visualice un idioma que no sea inglés, puede que desee cambiar la codificación.
    • En la sección Entrada y salida estándar, indique la ubicación de la entrada y salida de la vista Consola.
    • Para ejecutar la configuración de lanzamiento en segundo plano, seleccione el recuadro de selección Lanzar en segundo plano.
  14. Si se ha proporcionado toda la información obligatoria para la configuración de lanzamiento, se habilitará el pulsador Depurar. Si cambia alguno de los valores de la configuración de lanzamiento guardada (o en una configuración de lanzamiento que se ha creado automáticamente al seleccionar Depurar en la vista Explorador de proyectos de datos), se habilitará el pulsador Aplicar. Al pulsar Aplicar se guardará la configuración de lanzamiento y, en este punto, puede optar por cerrar el recuadro de diálogo sin lanzar la sesión de depuración o pulsar en Depurar para lanzar una sesión de depuración utilizando la nueva configuración de lanzamiento. Si pulsa en Depurar, los cambios realizados en la configuración de lanzamiento se guardarán y se lanzará una sesión de depuración.

    Tras guardar una configuración de lanzamiento de depuración, puede editarla. Para obtener más información sobre cómo editar configuraciones de lanzamiento de depuración, consulte la tarea relacionada.

    Consejo: Si aún no ha guardado los valores de la configuración de lanzamiento y ha realizado entradas en los valores de la configuración de lanzamiento que desea eliminar o cambiar, pulsando Revertir se eliminarán todos los cambios que haya realizado.
  15. Si no se ha suministrado alguna información obligatoria para la configuración de lanzamiento o si hay errores en la información proporcionada, los mensajes de la parte superior del recuadro de diálogo le indicarán qué falta.
  16. Cuando termine de trabajar en el recuadro de diálogo, pulse en Cerrar para salir de él sin lanzar una sesión de depuración.
Conceptos relacionados
Depuración local y remota
Tareas relacionadas
Inicio de una sesión de depuración
Preparación para la depuración
Crear nuevas configuraciones de lanzamiento a partir de configuraciones de lanzamiento existentes
Editar configuraciones de lanzamiento
Eliminar configuraciones de lanzamiento

Feedback