Wazi Developer for VS Code のインストール

Wazi Developer for VS Code をワークステーションにインストールするには、以下の手順を実行します。

  1. 前提条件

  2. VSコード用IBMWaziデベロッパーのダウンロード

  3. Zoweエクスプローラーのインストール

  4. IBM Z Open Editorのインストール

  5. IBM Zオープン・デバッグのインストール

前提条件

ダウンロードする前にIBM Z Open Editor使用許諾契約 および 第三者の特記事項を確認してください。

インストールの前提条件は以下のとおりです。

  • Visual Studio Code バージョン 1.44 以降: Wazi Developer for VS Code はスタンドアロン IDE ではなく VS Code 拡張機能のセットとして配布されているため、まず VS Code をインストールして構成する必要があります。 常に最新の VS Code バージョンを使用することをお勧めします。 ただし、必要な最小バージョンは 1.44.0 ですが、少なくとも 1.45.1 を使用することをお勧めします。これには、IBM Z Open Editor に影響を与える可能性がある VS Code のユーザー設定の修正が含まれています。 VS Codeがインストールされていない場合は、マイクロソフト社が提供するJava Installer向けのVisualスタジオコードを使用すると、VS Codeと一緒にJava SDKも自動的にダウンロード・インストールされますので、これを使用することをお勧めします。 (Java 依存関係については、次の中黒点を参照してください。ただし、上記オプション (Visual Studio Code for Java インストーラー) を使用する場合は、スキップしてください)。 VSコードのインストールと設定については、そのドキュメントを参照してください。

  • Java SDK バージョン 8 以降 - 64 ビット: この拡張機能に含まれる COBOL、PL/I、および HLASM 言語サーバーは、Java で実装されています。 そのため、64 ビットの Java SDK をインストールして構成し、正常に開始する必要があります。 上記の説明に従って VS Code for Java をインストールすることをお勧めしますが、既に VS Code を使用している場合、または Java 自体をインストールする場合は、以下のオプションから選択できます。

    • Oracle Java 8またはOracle JavaのLTSバージョン11

    • OpenJDKのバージョン8、11または17 Z Open Editor のバージョン 1.1 以降を使用している場合は、Java ランタイム環境 (JRE) も使用できます。

    • それより新しいバージョンの Java も機能するはずですが、Java 8 と 11 ほどには Z Open Editor で厳密にテストされていません。

    拡張機能が Java をどのように使用するかを構成するために、さまざまな設定が提供されています。 詳しくは、以下のJavaの構成セクションを参照してください。 特定の Java バージョンで問題が発生した場合は、お問い合わせください。

  • (推奨) Git: Git に関連する機能を使用するには、Git をインストールし、VS Code で表示できるようにシステム・パスで Git を使用可能にする必要があります。 Mac では、Git がすぐに使用可能な状態で提供されます。 Linux では、ディストリビューションのパッケージ・マネージャーで Git をインストールできます。 Windowsで、https://git-scm.comからGitを取得することができます。

  • （推奨）Zowe CLI 6.33.3以降：z/OS® MVS™やUSSからコマンドラインで直接ファイルを開いて編集するZoweを利用するには、Zowe CLIとホスト・コンポーネントの設定が必要です。 詳細については、z/OSと対話するための統合の設定を参照してください。

IBM Wazi Developer for VS Code のダウンロード

メインフレームDEVからインストールパッケージをダウンロードするステップに従って、Wazi Developer for VS CodeのクライアントをメインフレームDEVからダウンロードします。 ダウンロードした<license>_Wazi_Developer_for_VSCode_<version>.zipを、お使いのマシンで解凍してください。

ダウンロードしたバイナリー・ファイルのコード署名シグニチャーを確認する場合は、以下の手順を参照してください。 OpenSSL をまだインストールしていない場合は、インストールします。

  1. 上で解凍した<license>_Wazi_Developer_for_VSCode_<version>.zipには、バイナリファイルの検証に使用する.sigと.pemファイルが含まれています。

  2. 証明書の妥当性を確認します。

    1. 証明書の詳細を表示するには、次のコマンドを発行します。

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

    2. 公開鍵の詳細を表示するには、次のコマンドを発行します。

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

    3. 公開鍵と証明書の指数を比較して、公開鍵が確かに証明書内のものであることを確認します。 Mac OS のプレビューなどの他の証明書ビューアーを使用することもできます。

    4. IBM 公開証明書の妥当性を確認するには、次のコマンドを発行します。

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

      証明書が有効の場合、出力は以下のようになります。

      Response verify OK

  3. ダウンロードしたバイナリー・ファイルを検証します。

    署名ファイルおよび公開鍵ファイルを使用してファイルを検証するには、次のコマンドを発行します。

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

    例えば、zopeneditor-1.0.0.vsixを検証する場合は、次のように発行します。

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

    バイナリーが正常に検証された場合、出力は以下のようになります。

    Verified OK

Zowe Explorer のインストール

IBM Z Open Editorは、前提条件として Zowe Explorer VS Code extension 1.19.0 以降 (1.20.0 を推奨) が必要です。 IBM Z Open Editor をインストールすると、自動的に VS Code Marketplace から Zowe Explorer のダウンロードが試行されます。 オフラインで作業する場合は、まずwazi-development-client-<version>.zipから展開したZowe Explorer VSIXファイルZowe.vscode-extension-for-zowe-<version>.vsixをVS Codeインスタンスにインストールしてください。 a.vsixファイルからインストールするためのVS Codeのドキュメントに従うことができます。

IBM Z Open Editor のインストール

IBM Z Open Editor は、IBM エンタープライズ言語のサポートを提供します。 以下の 2 つの方法のいずれかから、IBM Z Open Editor をインストールできます。

IBM Z Open Editor の最新バージョンは、Mainframe DEV または VS Code Marketplace のいずれかからいつでも入手できます。 デフォルトでは、VS Code は拡張機能の更新の有無を確認し、自動的にインストールします。 拡張自動更新で説明されているように、自動更新を無効にすることができます。

重要： IBM Z Open Editorをインストールする前に、開発マシンに完全な Java SDK をインストールし、構成しておく必要があります。 上記の前提条件セクションとIBM Z Open Editor用のJavaを設定するセクションを参照してください。

注: IBM Wazi Developer 1.1.0 以降では、ユーザー・ビルド機能が IBM Z Open Editor VS Code の拡張機能に組み込まれています。 z/OS 開発者はユーザー・ビルド機能を利用することで、Wazi Developer 内で IBM Dependency Based Build (DBB) ツールを使用して個人用ビルドを実行できます。 ユーザー・ビルドのドキュメントに従って詳細を確認してください。

.vsix ファイルからの IBM Z Open Editor のインストール

wazi-development-client-<version>.zipから展開したzopeneditor-<version>.vsixを、以下のステップでVSコードのインスタンスにインストールします。

  1. VS Code のアクティビティー・バーの「拡張機能 (Extensions)」アイコンをクリックして、「拡張機能 (Extensions)」ビューを開きます。

  2. 拡張機能の表示の右上にある**...**アイコンをクリックすると、その他のアクションのドロップダウンメニューが表示されます。

  3. 表示されたドロップダウンメニューで、**VSIXからインストール...**をクリックします。

  4. ポップアップ表示されるファイルピッカーで、ダウンロードしたVSIXファイルを移動して選択し、インストールをクリックします。

VSIX ファイルから拡張機能がインストールされます。 詳しくは、VSコードのドキュメントVSIXからインストールする場合をご覧ください。

VS Code Marketplace ファイルからの IBM Z Open Editor のインストール

IBM Z Open Editor も VS Code Marketplace で無料で入手できるので、以下のいずれかの方法で IBM Z Open Editor を取得することもできます。

  • VSコードを起動し、アクティビティ・グループの拡張機能アイコンをクリックするか、メニューのファイル＞環境設定＞拡張機能をクリックして拡張機能ビューを開き、IBM Z Open Editor検索してください。 インストールボタンをクリックし、インストールが完了するのを待ちます。

  • IBM Z Open EditorをホストしているVSコード・マーケットプレイスのウェブサイトにアクセスします。 インストールボタンをクリックし、インストールが完了するのを待ちます。

IBM Z Open Editor のインストールの検証

IBM Z Open Editor が正しくインストールされているかどうかを素早くテストするために、ご使用のマシンで COBOL、PL/I、または HLASM プログラム・ファイルを開くことができます。 もし、あなたのマシンにそのようなファイルがない場合は、サンプルファイルの探索の項で説明したようにサンプルリポジトリをクローンし、そのCOBOL、PL/I、またはHLASMのプログラムファイルを開くことができます。 COBOL、PL/I、または HLASM コードの構文の強調表示が表示される場合、拡張機能は正常に機能しています。

Java の構成

IBM Z Open Editor で使用される COBOL、PL/I、および HLASM 言語サーバーは、Java プログラミング言語を使用して実装されました。 そのため、Java ランタイムを VS Code で開始できるように、設定またはプログラム・パスを指定する必要があります。 IBM Z Open Editor の拡張機能では、VS Code の「設定」のプロパティーを使用します。これらのプロパティーを VS Code のユーザー設定に追加して、使用する Java および Java の使用方法を構成できます。 これらの設定により、複数のインストールがある場合に選出する Java の特定のインストールを選択することができます。また、拡張機能で使用するメモリー量などのパラメーターも設定できます。

使用する Java インストールの選択

言語サーバーを開始する前に、IBM Z Open Editor VS Code 拡張機能の言語サーバー・クライアントは、一致する Java インストール済み環境を見つけるためにさまざまな場所を参照しようとします。 ここに記載している順序で、クライアントは以下の場所を参照し、最初に検出されたバージョン 8 以上かつ 64 ビットの Java インストール済み環境を使用します。 Java が検出されても、この条件の検査に失格した場合は、検索が続行されます。

  1. zopeneditor.JAVA_HOMEVSコード・ユーザー設定です。

  2. java.homeVSコード・ユーザー設定です。

  3. JAVA_HOME環境変数です。

  4. Z Open Editor を実行する環境に定義されている PATH (つまり、Windows または MacOS のデフォルトのパス)。

  5. プラットフォーム固有の標準的なロケーション。 例えば、MacOSでは/usr/libexec/java_home -V、Windowsではwhere java.exeコマンドを実行して、有効なJavaのインストール場所を特定します。

ユーザー設定は常に上記の他のオプションより優先されるので、複数のバージョンがインストールされている場合に、コンピューターのデフォルトとは異なる Java バージョンを IBM Z Open Editor に指定することができます。 おすすめのJavaインストーラー向けのVisualスタジオコードを使用した場合、java.homeユーザー設定はこのインストーラーによって設定されました。

Javaが見つからない場合は、VS Code OutputビューのZ Open Editorタブにエラーがないか確認し、JAVA_HOME環境変数を設定するか、VS Codeのユーザー設定にエントリを作成して問題を解決してください。

ユーザー設定を定義するには、「基本設定」>「設定」メニューを使用し、グラフィカル・エディターの「IBM Z Open Editor」下にある設定を見つけるか、設定の json ファイルを直接編集し、Java インストール・ディレクトリーの絶対パス名を使用して次のようなエントリーを追加します。

Mac の場合:

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

Windows の場合:

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

Java メモリー割り振りの構成

デフォルトでは、COBOL、PL/I、HLASM、REXXの各言語サーバを起動する言語サーバクライアントは、それぞれに最大512MBのメモリを割り当てています。 言語サーバーは、起動時に消費するメモリを大幅に削減し、その後、プログラムの解析時にメモリの確保と解放を行います。 しかし、非常に大きなプログラムファイルを解析する際にメモリ不足になり、あらかじめ設定された制限値に達してしまうことがあります。 より多くのメモリを割り当てられるようにするには、以下のVS Codeの設定で、新しい最大値を指定します。

"zopeneditor.server.memoryAllocation": 640

この値は使用する言語ごとに設定されているので、COBOLとPL/Iの両方を使用する場合、指定した量の2倍の消費量になってしまう可能性があることに留意してください。 より小さなプログラムを使用する場合や、お使いのコンピュータがこのような大容量のメモリをサポートしていない可能性がある場合は、この設定で512より小さい値を試すこともできます。

IBM Z Open Debug のインストール

z/OS Debugger で IBM Z Open Debug VS Code 拡張機能を使用して、リモート VS Code クライアントで z/OS COBOL および PL/I アプリケーションをデバッグすることができます。

wazi-development-client-<version>.zipから解凍した以下のVSコード拡張機能をVSコードのインスタンス（V1.43 以降）にインストールします。

  • zopendebug-<version>.vsix

  • zopendebug-profileui-<version>.vsix

a .vsixファイルからインストールするためのVS Codeのドキュメントに従うことができます。

ご使用のワークステーション上でIBM ZOpen Debugをアップグレードするには、Mainframe DEVから最新のwazi-development-client-<version>.zipウンロードし、圧縮ファイルを解凍して、.vsixファイルをインストールしてください。