GitHubContribute in GitHub: Edit online

Running Dependency-Based user builds from Z Open Editor

Z Open Editor user build allows you to run builds directly out of the editor remotely on z/OS UNIX System Services with IBM Dependency Based Build.

  1. Run Ansible automation to remotely set up user build on the z/OS UNIX system of the VSI by running the playbook:

    cd ansible
    ansible-playbook -i inventories --extra-vars "host=devtest1" dbb-prepare-userbuild.yml
  2. Review the script and its output. You can also set up user build manually as documented in Setting up the user build External link icon.

    The script clones a Git repository in /u/ibmuser/projects and copies a configuration file into that repository. This configuration is specific to the z/OS system that you are using. All the required values are provided for the z/OS development and test stock image in the Ansible inventory by the file ansible/inventories/host_vars/devtest1.yml.

    The output of the dbb-prepare-userbuild.yml playbook provides JSON to be copied into your VS Code user settings. They contain user- and system-specific values for Z Open Editor to start a build.

  3. Open the zapp.yaml file and review the dbb-userbuild entry.

    1. If you are not using IBM Wazi Sandbox, remove the value -DBB_PERSONAL_DAEMON from the command.

    2. Check the buildScriptArgs and ensure that the application value matches the name of the sample repository folder that you cloned and opened in VS Code at the beginning of this tutorial. The default value is zopeneditor-sample.

  4. Open the SAM1 program in the editor and right-click Prepare IBM User Build. The Output view will show the progress of creating folders and copying over properties from the local application-conf directory, which needs to be done only once or after the settings are changed.

  5. After the operation succeeds, right-click Run IBM User Build to build the program SAM1 and download the logs file.

You can now make program changes with Z Open Editor and build the application with User Build. To run the application, you can also use the Ansible playbook that copies required test data over to MVS. The Ansible playbook then executes a JCL that is also available in the IBMUSER.SAMPLE.JCL(RUN) partitioned data set. After you have the test data in place, you can repeatedly right-click to execute the RUN JCL in Zowe Explorer.