Configuración de IBM Z Open Debug

Antes de poder conectarse a un sistema z/OS e iniciar la depuración, configure para IBM Z Open Debug.

Configuración de las preferencias

Puede especificar los detalles de conexión al host y otras preferencias en Valores > Extensiones > IBM Z Open Debug o en el archivo setting.json.

Tabla 1. Valores de IBM Z Open Debug
Nombre de campo en Valores	Propiedad en settings.json	Descripción
Conexión: Nombre de conexión	zopendebug.connection.connectionName	El nombre de host del sistema z/OS remoto.
Conexión: Puerto de conexión	zopendebug.connection.connectionPort	El puerto de Servicio de perfil de depuración en el sistema z/OS remoto. Para una conexión segura, asegúrese de que se ha especificado un puerto seguro.
Conexión: Raíz de contexto	zopendebug.connection.contextRoot	La raíz de contexto del Servicio de perfil de depuración en el sistema z/OS remoto.
Conexión: Asegurada	zopendebug.connection.secured	Permite habilitar una conexión segura.
Conexión: Nombre de usuario	zopendebug.connection.userName	El ID de usuario que se va a utilizar para las conexiones con el servidor z/OS remoto.
Vista de perfil: Registro de Api	zopendebug.profileView.apiLog	Permite habilitar el registro de diagnóstico de Servicio de perfil de depuración. Los archivos de registro se almacenan en el directorio de inicio del usuario.
Vista de perfil: Mostrar bienvenida	zopendebug.profileView.showWelcome	Mostrar la página de bienvenida en la vista Perfiles de Z Open Debug.

Configuración de launch.json

Para configurar launch.json para IBM Z Open Debug, consulte los atributos soportados en Listado de sesiones de depuración de z/OS Debugger aparcadas en un host de z/OS y Conexión a una sesión de depuración de un z/OS Debugger aparcado en un host de z/OS.

Importación de un certificado autofirmado para Servicio de perfil de depuración

Z Open Debug utiliza la API Servicio de perfil de depuración para gestionar perfiles de depuración. Esta API REST está protegida con un certificado. Si el certificado es autofirmado, tendrá que instalar el certificado en el sistema operativo para establecer una conexión segura.

Nota: Esta tarea es necesaria si utiliza Wazi Developer for Workspaces en el entorno de cloud OpenShift®.

Antes de establecer una conexión segura, asegúrese de que el programador del sistema ha creado un certificado para Servicio de perfil de depuración, como se describe en Habilitación de la comunicación segura y que está conectado al sistema z/OS remoto con un puerto seguro especificado y la conexión segura habilitada.

Obtenga el certificado directamente del programador de sistemas o siga los pasos siguientes para obtener el certificado con un navegador:
1. Abra la ventana Herramientas de desarrollador.
  - En la vista Perfiles de Z Open Debug de un cliente de código VS, seleccione Ver > Paleta de mandatos > Desarrollador: Abrir herramientas de desarrollador de Webview.
  - En el entorno de cloud de OpenShift, puede abrir la ventana directamente. Por ejemplo, si utiliza Google Chrome, pulse con el botón derecho del ratón y seleccione Inspeccionar en el menú.
2. En la ventana Perfiles de Z Open Debug, realice cualquier acción.
3. En la pestaña Red de la ventana Herramientas de desarrollador, pulse cualquier dtcn/ en la columna Nombre para copiar el URL. El URL empieza por https://nombre_conexión:número_puerto.
4. Pegue el URL copiado en la barra de direcciones de un navegador. En la barra de direcciones se muestra un icono de aviso que indica una conexión no segura.
5. Pulse el icono de aviso para descargar o exportar el certificado.
  Nota: Tras importar el certificado en el almacén de certificados del sistema operativo, se muestra el nombre original, en lugar del nombre que especificó al exportar el certificado.
Importe el certificado autofirmado al sistema operativo.
Puede importar el certificado en Entidades de certificación raíz de confianza en Windows o Acceso de cadena de claves en macOS directamente, o utilizar Google Chrome para cualquier sistema operativo o Internet Explorer para Windows.
Google Chrome para Windows:
1. Seleccione Valores > Privacidad y seguridad > Gestionar certificados.
2. En la ventana Certificados, abra la pestaña Autoridades de certificación de raíz de confianza y seleccione Importar. Se abre el Asistente de importación de certificados.
3. En el Asistente de importación de certificados, examine para seleccionar el certificado. Es posible que tenga que elegir Todos los archivos (*.*) para mostrar todos los tipos de archivo.
4. Pulse Finalizar para completar la importación del certificado.
5. En la ventana Certificados, seleccione Avanzadas para abrir la ventana Opciones avanzadas y asegúrese de que la Autenticación de cliente está seleccionada.
Google Chrome para macOS:
1. Seleccione Valores > Privacidad y seguridad > Gestionar certificados.
2. En el Acceso de cadena de claves , importe el certificado.
3. Efectúe una doble pulsación en el certificado importado para establecer los campos en Confiar siempre.
Internet Explorer para Windows:
1. Seleccione Herramientas > Opciones de Internet.
2. En la pestaña Contenido de la ventana Opciones de Internet, seleccione Certificados para abrir la ventana Certificados.
3. En la ventana Certificados, abra la pestaña Autoridades de certificación de raíz de confianza y seleccione Importar. Se abre el Asistente de importación de certificados.
4. En el Asistente de importación de certificados, examine para seleccionar el certificado. Es posible que tenga que elegir Todos los archivos (*.*) para mostrar todos los tipos de archivo.
5. Pulse Finalizar para completar la importación del certificado.
6. En la ventana Certificados, seleccione Avanzadas para abrir la ventana Opciones avanzadas y asegúrese de que la Autenticación de cliente está seleccionada.