Instalación de IBM Developer for z/OS en VS Code

IBM Developer for z/OS en VS Code incluye IBM Z® Open Editor como uno de sus componentes clave. IBM Z Open Editor es una extensión para VS Code. Antes de la instalación, asegúrese de que están instalados y configurados todos los requisitos previos, sobre todo un tiempo de ejecución Java, ya que las partes principales de la extensión se implementan en el lenguaje de programación Java.

Requisitos previos

Lee el Acuerdo de licencia de IBM Z Open Editor y los avisos de terceros antes de realizar la descarga.

Requisitos previos para la instalación:

  • VS Code versión 1.102.3 o posterior (versión recomendada: 1.105.1 ): IBM Z Open Editor se entrega como una extensión de VS Code y no como un editor independiente. Por lo tanto, primero debe instalarse y configurarse VS Code. Se recomienda utilizar la última versión disponible de VS Code. Si aún no tienes instalado VS Code, te recomendamos que utilices el instalador de « Visual Studio Code » para Java que ofrece Microsoft. Este instalador descarga e instala automáticamente un SDK de Java y VS Code. El siguiente punto sobre la dependencia de Java puede omitirse si se utiliza esta opción. Para obtener información sobre la instalación y la configuración de VS Code, consulta su documentación.

  • Java SDK o JRE versión 21 o posterior - 64 bits: Los servidores de idiomas incluidos en esta extensión están implementados en Java. Para iniciar correctamente la extensión, debe instalarse y configurarse un SDK o Runtime de Java de 64 bits. Se recomienda instalar VS Code para Java, como se describe en la sección anterior, ya que incluye automáticamente el SDK de Java necesario. Sin embargo, si VS Code ya está instalado o si se prefiere la instalación manual, existen las siguientes opciones para instalar Java:

    • Utiliza la versión 21 de « Semeru Runtime » de IBM, que puedes descargar aquí. IBM® Semeru Los tiempos de ejecución permiten crear e implantar aplicaciones Java que se inician rápidamente, ofrecen un gran rendimiento y consumen menos memoria. Estos tiempos de ejecución también se utilizan internamente durante el desarrollo.

    • También puedes utilizar la versión LTS 21 de Java de Oracle o la versión OpenJDK.

    • Se espera que las nuevas versiones de Java posteriores a la 21 funcionen, pero no se han probado con Z Open Editor.

    Se proporcionan varios valores para configurar cómo utiliza Java la extensión. Consulte la sección Configuración de Java siguiente para obtener más detalles.

  • Software de cliente Zowe: Para utilizar Zowe y abrir y editar archivos directamente desde z/OS® MVS™ o z/OS UNIX System Services, es necesario tener configurados el software de cliente Zowe y los componentes del servidor. Encontrará más información sobre la configuración de Zowe en Configuración de integraciones para interactuar con z/OS. Tras la instalación, puede acceder a los recursos de z/OS tal y como se documenta en Interacción con z/OS.

    • Extensión Zowe Explorer VS Code v3.2.2 o posterior. Cuando instala IBM Z Open Editor desde VS Code Marketplace en su VS Code, la última versión de la extensión Zowe Explorer VS Code se co-instala automáticamente, ya que es un requisito previo obligatorio para ejecutar Z Open Editor.

    • (Opcional) Zowe CLI v8.11.0 o posterior. Z Open Editor y Zowe Explorer puede funcionar de forma totalmente independiente.

  • (Opcional) Git : Para usar las características que implican Git, debe instalar Git y tenerlo disponible en la ruta de su sistema para que VS Code pueda mostrarlo. En sistemas Mac, Git se envía preconfigurado. En Linux, puede instalar Git con el gestor de paquetes de su distribución. En Windows, puedes descargar « Git » desde https://git-scm.com.

Descarga de IBM Developer for z/OS en VS Code

Descarga el cliente de IBM Developer for z/OS en VS Code desde Mainframe DEV siguiendo el procedimiento para descargar paquetes de instalación de Mainframe DEV. Extraer el archivo descargado IBM_Developer_for_z/OS_on_VSCode .zip en su máquina.

Si desea comprobar las firmas para el firmado de códigos de los archivos binarios descargados, consulte el siguiente procedimiento. Instale OpenSSL si todavía no lo ha hecho.

  1. El archivo IBM_Developer_for_z/OS_on_VSCode.zip que ha extraído anteriormente contiene los archivos.sig y.pem que se utilizan para verificar los archivos binarios.

  2. Compruebe la validez del certificado.

    1. Para ver los detalles del certificado, emita el siguiente mandato:

      $ openssl x509 -text -in wazi-certificate.pem -noout

    2. Para ver los detalles de la clave pública, ejecute el siguiente comando:

      $ openssl rsa -noout -text -inform PEM -in wazi-public.pem -pubin

    3. Compare el exponente de la clave pública y el certificado para ver que la clave pública es realmente la que está incluida en el certificado. También puede utilizar cualquier otro visor de certificados como, por ejemplo, la vista previa del sistema operativo Mac.

    4. Para comprobar la validez del certificado público de IBM, emita el siguiente mandato:

      $ openssl ocsp -no_nonce -issuer wazi-chain0.pem -cert wazi-certificate.pem -VAfile wazi-chain0.pem -text -url http://ocsp.digicert.com -respout ocsptest

      If the certificate is valid, the output is:

      Response verify OK

  3. Verifique los archivos binarios descargados.

    Para verificar los archivos utilizando los archivos de claves públicas y de firma, emita el siguiente mandato:

    $ openssl dgst -sha256 -verify wazi-public.pem -signature ${binary-filename}.sig ${binary-filename}

    Por ejemplo, para verificar zopeneditor-1.0.0.vsix, emita:

    $ openssl dgst -sha256 -verify wazi-public.pem -signature zopeneditor-1.0.0.vsix.sig zopeneditor-1.0.0.vsix

    Si el binario se verifica correctamente, la salida es:

    Verified OK

Instalar IBM Z Open Editor

Hay varias formas de descargar e instalar IBM Z Open Editor. Si tienes pensado utilizar o probar la versión sin garantía y sin soporte técnico, puedes instalarla directamente desde VS Code Marketplace o desde el Open VSX Registry.

Si eres cliente de IBM, Developer for z/OS Enterprise Edition, IBM o Application Delivery Foundation for z/OS, o tienes derecho a recibir asistencia técnica para Z Open Editor por cualquier otro motivo, te recomendamos que utilices uno de los paquetes de extensiones, que instalan varias extensiones de VS Code automáticamente. También puedes descargar un práctico archivo ZIP desde el sitio de descargas de Mainframe DEV.

Los archivos ZIP incluyen todas las extensiones de VS Code que encontrarás en VS Code Marketplace y Open-VSX Extension Packs, que se enumeran en detalle a continuación. Además, incluyen componentes que no son extensiones de VS Code y, por lo tanto, no están disponibles a través de los paquetes de extensiones. Son herramientas de interfaz de línea de comandos que amplían las posibilidades de las extensiones de VS Code para emitir comandos ad hoc a z/OS desde tu estación de trabajo o incluso utilizarlas para la automatización de scripts. Incluimos la CLI de Zowe junto con los complementos de la CLI de Zowe para IBM RSE API y IBM CICS. Estas herramientas CLI no son necesarias para que las extensiones de VS Code funcionen, pero aportan un valor añadido. En concreto, el complemento RSE API es proporcionado por IBM y no forma parte del proyecto Zowe ni de su documentación, por lo que solo se documenta de forma completa aquí, en esta documentación en línea.

Por último, los archivos ZIP también contienen archivos de firma de código que puede utilizar para verificar la integridad de los archivos descargados. El archivo README.txt incluido en el archivo ZIP explica detalladamente cómo verificar uno por uno todos los binarios incluidos con los archivos de firma.

Instale IBM Z Open Editor desde un archivo VSIX

Si has descargado la extensión «Download for VS Code » del Mainframe DEV Center, puedes instalarla en VS Code siguiendo estos pasos.

  1. Descomprima el archivo zip descargado.

  2. Abra el archivo README.txt en un editor de texto y siga los pasos (opcionales) que allí se describen para verificar los archivos individuales con las firmas de firma de código proporcionadas.

  3. Para instalar el archivo zopeneditor-\<version\>.vsix en VS Code, haga clic en el icono Extensiones de la barra de actividades de VS Code para abrir la vista Extensiones.

  4. Pulse ... en la esquina superior derecha de la vista Extensiones para mostrar un menú desplegable con más acciones.

  5. En el menú desplegable que aparece, pulse Instalar desde VSIX....

  6. Utilice el selector de archivos que aparece para ir al archivo VSIX que ha descargado y seleccionarlo y luego pulse Instalar.

  7. La extensión se debe instalar desde el archivo VSIX.

Instalar IBM Z Open Editor desde el Registro Abierto de VSX

Si ya tienes o deseas configurar VS Code para utilizar el registro Open VSX público alternativo o uno privado local, o si utilizas un editor compatible con VS Code, como VSCodium o Eclipse Theia, que lo utilizan de forma predeterminada, puedes buscar e instalar IBM Z Open Editor e instalarlo desde allí también. Consulte la documentación de Open VSX para saber cómo configurar y utilizar este registro.

Instalar IBM Z Open Editor desde el mercado de aplicaciones de VS Code

Cuando el tiempo de ejecución de Java correcto esté instalado y configurado, puede utilizar cualquiera de las siguientes formas para obtener versiones de IBM Z Open Editor que están disponibles en VS Code Marketplace:

A continuación, haga clic en el botón Instalar y espere a que finalice la instalación.

Instalación desde un paquete de extensión

Hay disponibles dos paquetes de extensiones que incluyen Z Open Editor junto con otras extensiones, proporcionando a los clientes una forma cómoda de instalar y gestionar la familia de herramientas VS Code de IBM con sólo unos clics del ratón.

Para obtener más información sobre cada una de estas extensiones, navegue hasta los enlaces que aparecen en la descripción de cada paquete de extensiones.

Para instalar un paquete de extensión, siga las mismas instrucciones que para instalar Z Open Editor desde VS Code Marketplace u Open-VSX:

  • Busque el paquete en la vista de extensiones de VS Code o en la página web del mercado.

  • Pulse el botón Instalar.

Una vez instalado el paquete de extensiones y las extensiones que incluye, puede activar o desactivar cada una de las extensiones en la vista Extensiones de VS Code. Cuando se publica una nueva versión de cualquier extensión, las actualizaciones se instalan automáticamente. No es necesario volver a instalar el paquete de ampliación.

Verifique la instalación de IBM Z Open Editor

Para comprobar rápidamente si « IBM Z Open Editor » está instalado correctamente, puede abrir un archivo de programa de tipo « COBOL », « PL/I », «HLASM», « REXX » o «JCL» en su equipo. Si no dispone de dichos archivos en su equipo, puede clonar el repositorio de ejemplo tal y como se describe en la sección «Exploración de los archivos de ejemplo» y abrir sus archivos de programa de COBOL, PL/I, HLASM, REXX o JCL. Si ves que se resalta la sintaxis en COBOL, PL/I, HLASM, REXX o en el código JCL, significa que la extensión funciona correctamente.

Configurar Java

La página de bienvenida de IBM Z Open Editor muestra si se ha encontrado Java correctamente. Para abrir la página de bienvenida, presione Ctrl+Shift+P (Windows) o Cmd+Shift+P ( MacOS ) y escriba IBM Z Open Editor : Welcome. Compruebe la tabla de requisitos previos de la página y haga clic en la sección Java para ampliarla.

Los servidores de los lenguajes COBOL ( PL/I ), HLASM ( REXX ) y JCL utilizados por IBM Z Open Editor se implementaron utilizando el lenguaje de programación Java. Por lo tanto, se requiere que un Java Runtime esté disponible a través de la configuración o la ruta del programa para iniciarse en VS Code. La extensión « IBM Z Open Editor » utiliza las propiedades de configuración de VS Code, que se pueden añadir a la configuración de usuario de VS Code, para configurar qué elementos de Java se deben utilizar y cómo. Estos valores le permiten seleccionar la instalación específica de Java que se ha de elegir, en caso de que tenga varias instalaciones, así como establecer tanto los parámetros como la cantidad de memoria que desea que utilice la extensión.

Selecciona la instalación de Java que deseas utilizar

Antes de iniciar un servidor de idiomas, los clientes del servidor de idiomas en la extensión IBM Z Open Editor VS Code buscan en varias ubicaciones para encontrar una instalación Java que coincida. Buscan en el siguiente orden y seleccionan el primer Java que sea versión 21 o superior y de 64 bits. Si una instalación de Java no cumple alguno de los dos criterios, la búsqueda continúa hasta que se encuentra una versión adecuada.

  1. El valor de usuario de VS Code zopeneditor.JAVA_HOME.

  2. El valor de usuario de VS Code java.home.

  3. La variable de entorno JAVA_HOME.

  4. La RUTA definida para el entorno en el que se ejecuta Z Open Editor, es decir, la ruta predeterminada de Windows o de MacOS.

  5. Una ubicación específica de la plataforma. Por ejemplo, en MacOS, ejecute el comando /usr/libexec/java_home -V ; en Windows, ejecute los comandos where java.exe para localizar una instalación Java válida.

Como puede ver, la configuración de usuario siempre tiene prioridad sobre las demás opciones enumeradas, lo que le permite especificar una versión de Java para IBM Z Open Editor distinta de la predeterminada en su ordenador en caso de que haya instalado varias versiones. Si has utilizado el instalador recomendado de Java de Visual Studio Code, este instalador ha configurado los ajustes java.home de usuario. Tenga en cuenta también que los métodos al final de la lista requieren una cantidad significativa de tiempo ya que están ejecutando programas en el sistema. Para mejorar los tiempos de inicio, debe tener en cuenta los valores de usuario, ya que proporcionan el mejor rendimiento de inicio.

Si no se puede localizar Java, compruebe si hay algún error en la pestaña Z Open Editor de la vista de salida de VS Code e intente solucionar el problema configurando la variable de entorno JAVA_HOME o creando una entrada en la configuración de usuario de VS Code.

Para definir una configuración de usuario, utilice el menú Preferencias > Configuración y localice la configuración en el editor gráfico en IBM Z Open Editor o edite directamente el archivo JSON de configuración añadiendo una entrada como se indica a continuación utilizando un nombre de ruta absoluto al directorio de instalación de Java.

En MacOS:

"zopeneditor.JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk21/Contents/Home"

En Windows:

"zopeneditor.JAVA_HOME": "C:\\Program Files\\Java\\jdk21"
Configurar la asignación de memoria de Java

De forma predeterminada, el cliente de servidor de lenguaje que inicia los servidores de lenguaje individuales para COBOL, PL/I, HLASM o REXX asigna un máximo de 512 MB de memoria a cada uno de ellos. Los servidores de idiomas consumen mucha menos memoria al inicio, y luego asignan y liberan memoria cuando analiza los programas. Sin embargo, podrían quedarse sin memoria cuando analice archivos de programa muy grandes y alcance el límite predefinido. Para permitir la asignación de más memoria, utilice la siguiente configuración de VS Code para especificar un nuevo valor máximo:

"zopeneditor.server.memoryAllocation": 640

Tenga en cuenta que este valor es para cada lenguaje que utilice, por lo que si utiliza COBOL y PL/I, puede terminar consumiendo el doble de la cantidad especificada. Si está trabajando con programas más pequeños o es posible que el sistema no dé soporte a una cantidad tan grande de memoria, también puede intentar con valores menores que 512 con este valor.