Instalando o Wazi Developer for VS Code

Conclua as etapas a seguir para instalar o Wazi Developer for VS Code em sua estação de trabalho:

  1. Pré-requisitos

  2. Fazer download do IBM Wazi Developer for VS Code

  3. Instalar o Zowe Explorer

  4. Instalar o IBM Z Open Editor

  5. Instalar o IBM Z Open Debug

Pré-requisito

Revise o Contrato de Licença do IBM Z Open Editor e os Avisos de Terceiros antes de fazer o download.

Pré-requisitos para a instalação:

  • Visual Studio Code versão 1.44 ou mais recente: como o Wazi Developer for VS Code é entregue como um conjunto de extensões do VS Code, em vez de como um IDE independente, deve-se primeiro instalar e configurar o VS Code. Recomendamos usar sempre a versão mais recente disponível do VS Code. No entanto, embora a versão mínima necessária seja a 1.44.0, recomendamos usar pelo menos a 1.45.1, que inclui correções em Configurações do usuário do VS Code que podem impactar o IBM Z Open Editor. Se você não tiver o VS Code instalado, é recomendável usar o Visual Studio Code for Java Installer fornecido pela Microsoft, já que ele baixa e instala automaticamente o Java SDK com o VS Code. (consulte, mas ignore o próximo marcador para a dependência Java ao usar esta opção). Para obter informações sobre a instalação e configuração do VS Code, consulte a documentação dele.

  • Java SDK versão 8 ou mais recente - 64 bits: os servidores de linguagens COBOL, PL/I e HLASM incluídos nesta extensão são implementados em Java. Portanto, é necessário instalar e configurar um SDK Java de 64 bits, a fim de iniciá-lo com sucesso. Recomendamos a instalação do VS Code for Java, como descrito acima. No entanto, se você já tiver o VS Code ou quiser instalar o Java por conta própria, será possível escolher entre as opções a seguir:

    • Oracle Java 8 ou as versões LTS 11 do Oracle Java

    • Versão 8, 11, ou 17 do OpenJDK. Se você estiver usando a versão 1.1 ou mais recente do Z Open Editor, você poderá também usar apenas um Java Runtime Environments (JRE).

    • As versões mais recentes do Java também devem funcionar, mas não foram rigorosamente testadas para o Z Open Editor como o Java 8 e 11.

    Várias configurações são fornecidas para configurar como a extensão usa Java. Consulte a seção Configurando Java abaixo para obter mais detalhes. Entre em contato conosco se você tiver quaisquer problemas com uma versão Java específica.

  • (Recomendado) Git: para usar os recursos que envolvem o Git, deve-se instalar o Git e disponibilizá-lo no caminho do sistema para que o VS Code possa exibi-lo. Em Macs, o Git vem pronto para uso. No Linux, é possível instalar o Git com o gerenciador de pacotes de sua distribuição. No Windows, é possível obter o Git em https://git-scm.com.

  • (Recomendado) Zowe CLI 6.33.3 ou posterior: Para fazer uso do Zowe para abrir e editar arquivos diretamente do z/OS® MVS™ ou USS por meio da linha de comando, é preciso ter o Zowe CLI e os componentes de host configurados. Para obter mais informações, consulte Configurando integrações para interagir com o z/OS.

Fazendo download do IBM Wazi Developer for VS Code

Faça o download do cliente do Wazi Developer for VS Code do Mainframe DEV de acordo com o Procedimento para download de pacotes de instalação do Mainframe DEV. Extraia o <license>_Wazi_Developer_for_VSCode_<version>.zip transferido por download em sua máquina.

Para verificar assinaturas de código para os arquivos binários transferidos por download, consulte o procedimento a seguir. Se ainda não tiver instalado o OpenSSL, faça isso agora.

  1. O <license>_Wazi_Developer_for_VSCode_<version>.zip extraído acima contém os arquivos .sig e .pem que são usados para verificar os arquivos binários.

  2. Verifique a validade do certificado.

    1. Para visualizar os detalhes do certificado, emita o comando a seguir:

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

    2. Para visualizar os detalhes da chave pública, emita o comando a seguir:

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

    3. Compare o expoente da chave pública e o certificado para ver que a chave pública é de fato a que está dentro do certificado. Também é possível usar qualquer outro visualizador de certificado como Mac OS Preview.

    4. Para verificar a validade do certificado público IBM, emita o comando a seguir:

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

      Se o certificado for válido, a saída será:

      Response verify OK

  3. Verifique os arquivos binários transferidos por download.

    Para verificar os arquivos usando a assinatura e os arquivos de chaves públicas, emita o comando a seguir:

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

    Por exemplo, 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

    Se o binário for verificado com sucesso, a saída será:

    Verified OK

Instalando o Zowe Explorer

O IBM Z Open Editor requer a extensão do Zowe Explorer VS Code 1.19.0 ou posterior (1.20.0 é recomendada) como pré-requisito. Ao instalar o IBM Z Open Editor, ele tentará fazer o download do Zowe Explorer do VS Code Marketplace para você automaticamente. Se você estiver trabalhando off-line, primeiro instale o arquivo VSIX Zowe.vscode-extension-for-zowe-<version>.vseis do Zowe Explorer extraído de wazi-development-client-<version>.zip na instância do VS Code. É possível seguir a Documentação do VS Code para instalação por meio de um arquivo .vsix.

Instalando o IBM Z Open Editor

O IBM Z Open Editor oferece suporte para linguagens corporativas IBM. É possível instalar o IBM Z Open Editor com uma das duas abordagens a seguir.

Sempre é possível obter a versão mais recente do IBM Z Open Editor por meio do Mainframe DEV ou do VS Code Marketplace. Por padrão, o VS Code verifica as atualizações de extensão e as instala automaticamente. É possível desativar a atualização automática, conforme descrito em Atualização automática de extensão.

Importante: antes de instalar o IBM Z Open Editor, é preciso ter um Java SDK completo instalado e configurado na máquina de desenvolvimento. Consulte a seção Pré-requisitos acima e a seção Configurando Java para IBM Z Open Editor.

Nota: iniciando no IBM Wazi Developer 1.1.0, a funcionalidade de construção de usuário faz parte da extensão do IBM Z Open Editor VS Code. A construção de usuário permite que desenvolvedores do z/OS executem construções pessoais dentro do Wazi Developer usando a ferramenta do IBM Dependency Based Build (DBB). Siga a documentação de construção de usuário para saber mais.

Instalando o IBM Z Open Editor por meio de um arquivo .vsix

Instale o zopeneditor-<version>.vsix extraído de wazi-development-client-<version>.zip para a instância do VS Code da seguinte forma:

  1. Clique no ícone de Extensões na barra de atividades no VS Code para abrir a visualização Extensões.

  2. Clique no ícone ... no canto superior direito na visualização Extensões para revelar um menu suspenso de mais ações.

  3. No menu suspenso que aparece, clique em Instalar por meio do VSIX....

  4. Use o selecionador de arquivos que aparece para navegar, selecione o arquivo VSIX transferido por download e clique em Instalar.

A extensão deve ser instalada por meio do arquivo VSIX. Para obter mais informações, consulte Documentação do VS Code para instalação por meio do VSIX.

Instalando o IBM Z Open Editor por meio do VS Code Marketplace

Como alternativa, como o IBM Z Open Editor também está disponível gratuitamente no VS Code Marketplace, é possível obter o IBM Z Open Editor de uma das formas a seguir.

  • Inicie o VS Code, abra a visualização Extensões clicando no ícone Extensões no grupo de atividades ou clicando no menu Arquivo > Preferências > Extensões e procure por IBM Z Open Editor. Clique no botão Instalar e aguarde a instalação ser concluída.

  • Vá para o website do VS Code Marketplace que hospeda o IBM Z Open Editor. Clique no botão Instalar e aguarde a instalação ser concluída.

Verificando a instalação do IBM Z Open Editor

Para testar rapidamente se o IBM Z Open Editor está instalado corretamente, é possível pode abrir um arquivo de programa COBOL, PL/I ou HLASM em sua máquina. Se você não tiver esses arquivos em sua máquina, será possível clonar o repositório de amostra, conforme descrito na seção Explorando os arquivos de amostra, e abrir seus arquivos de programas COBOL, PL/I ou HLASM. Se você vir o destaque da sintaxe no código COBOL, PL/I ou HLASM, a extensão estará funcionando corretamente.

Configurando Java

Os servidores de linguagem COBOL, PL/I e HLASM usados pelo IBM Z Open Editor foram implementados usando a linguagem de programação Java. Portanto, é necessário que um Java Runtime esteja disponível por configurações ou no caminho do programa para iniciar no VS Code. A extensão do IBM Z Open Editor usa propriedades de Configurações do VS Code, que podem ser incluídas nas configurações do usuário do VS Code, para configurar qual e como o Java deve ser usado. Essas configurações permitem que você selecione a instalação específica de Java para escolher, caso você tenha várias instalações, além de configurar parâmetros como quanta memória deseja que a extensão use.

Selecionando a instalação Java para usar

Antes de iniciar um servidor de linguagem, os clientes do servidor de linguagem na extensão do VS Code do IBM Z Open Editor tentam procurar em diferentes locais para localizar uma instalação Java correspondente. Eles procurarão nos locais a seguir nesta ordem específica e escolherão a primeira instalação Java que puderem localizar que seja pelo menos Versão 8 e 64 bits. Se virem que um Java falha o teste com relação a esses critérios, eles continuarão procurando:

  1. A configuração de usuário do VS Code zopeneditor.JAVA_HOME.

  2. A configuração de usuário do VS Code java.home .

  3. A variável de ambiente JAVA_HOME.

  4. O PATH definido para o ambiente no qual o Z Open Editor é executado (ou seja, seu caminho Windows ou MacOS padrão)

  5. Um local típico específico da plataforma. Por exemplo, no MacOS, ele executará o /usr/libexec/java_home -V. No Windows, ele executará os comandos where java.exe para localizar uma instalação Java válida.

Como é possível ver, as configurações de usuário sempre têm precedência sobre as outras opções listadas, o que permite especificar uma versão Java diferente para o IBM Z Open Editor do que o padrão no seu computador caso você tenha instalado a versão múltipla. Se você usou o Visual Studio Code recomendado para o Java Installer, a configuração de usuário java.home foi definida por esse instalador.

Se o Java não puder ser localizado, verifique a guia Z Open Editor da visualização de Saída do VS Code para qualquer erro e tente corrigir o problema configurando a variável de ambiente JAVA_HOME ou crie uma entrada nas configurações de usuário do VS Code.

Para definir uma configuração do usuário, use o menu Preferências > Configurações e localize a configuração no editor gráfico sob IBM Z Open Editor ou edite o arquivo json de configuração diretamente incluindo uma entrada como a seguir usando o nome de caminho absoluto para o diretório de instalação Java.

No Mac:

"zopeneditor.JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home"

Em Windows:

"zopeneditor.JAVA_HOME": "C:\\Program Files\\Java\\jdk1.8.0_181"

Configurando a alocação de memória Java

Por padrão, o cliente servidor de linguagem que inicia os servidores de linguagem individuais para COBOL, PL/I, HLASM ou REXX aloca um máximo de 512 MB de memória para cada um deles. Os servidores de linguagem consumirão muito menos memória na inicialização e, em seguida, alocarão e liberarão a memória ao analisar programas. No entanto, eles podem ficar sem memória ao analisarem arquivos de programas muito grandes e atingirem o limite predefinido. Para permitir a alocação de memória adicional, utilize a configuração do VS Code a seguir para especificar um novo valor máximo:

"zopeneditor.server.memoryAllocation": 640

Lembre-se de que esse valor é para cada linguagem usada, portanto, ao usar tanto o COBOL quanto o PL/I, você poderá acabar consumindo o dobro da quantidade especificada. Se você estiver trabalhando com programas menores ou seu computador não suportar uma quantidade tão grande de memória, também será possível tentar valores menores que 512 com essa configuração.

Instalando o IBM Z Open Debug

É possível usar as extensões do VS Code do IBM Z Open Debug com o z/OS Debugger para depurar os aplicativos COBOL e PL/I do z/OS em um cliente remoto do VS Code.

Instale as extensões de VS Code a seguir extraídas de wazi-development-client-<version>.zip na instância do VS Code (V1.43 ou posterior):

  • zopendebug-<version>.vsix

  • zopendebug-profileui-<version>.vsix

É possível seguir a Documentação do VS Code para instalação por meio do arquivo .vsix.

Para fazer o upgrade do IBM Z Open Debug na estação de trabalho, faça o download do wazi-development-client-<version>.zip mais recente do Mainframe DEV, extraia o arquivo compactado e instale os arquivos .vsix .