Tutorial: Creating and getting started with your workspace

Go to the IBM Wazi Developer for Workspaces URL provided by your OpenShift administrator. If you do not have an account and self-registration was enabled by your administrator, click the Register button at the bottom to create a new account. Once you have your credentials, use them to log in to the application.

After logging in, you will be taken to the Create Workspace page that contains tiles of all the different stacks you can choose.

Click the Wazi Developer with sample apps stack. A workspace will be created with a sample repository called zopeneditor-sample.

After the workspace is created successfully, you should see the sample repository as follows by clicking the Explorer view.

The sample code in the zopeneditor-sample repository uses references to copybook and include files. To view or change the preconfigured copybook and include file properties called property groups that help resolve these references, you can use one of the following ways:

• ZAPP files: Open the zopeneditor-sample/zapp.yaml file that contains the property groups defined for this repository. If you want to create new or change folders with copybook and include files, update the array collection property-groups to control how IBM Z Open Editor resolves copybook and include file references. For more details on how to configure property groups, see Configure your applications with ZAPP files.

• User or Workspace settings: Specify property groups as documented in Setting property groups.

  Note: The settings in IBM® Wazi Developer for Workspaces are managed slightly differently than in VS Code. For details, see Configuring your workspace.

Now that your Wazi Developer for Workspaces instance is up and running, you can explore what the Wazi Developer for Workspaces stack offers. This workspace instance comes with a sample project named zopeneditor-sample.

• Tip: If you later want to add other projects to your workspace, you can place them at the top level of your workspace, alongside the zopeneditor-sample project folder.

Within the zopeneditor-sample directory, you can see several folders such as COBOL, COPYBOOK, INCLUDES, JCL, PLI with code samples in these different languages. For details about the sample files and their use cases, open and preview the README.md file.

The following steps walk you through some features of the editor with the COBOL file as an example.

1. Expand the COBOL folder and select the file SAM1.cbl to open it. The COBOL program is opened in the editor, and you can immediately see the syntax highlighting.

2. On the right, there are two icons. The first looks like a bullet point list. Click it to open the COBOL program's Outline view. Then, you can click inside the COBOL editor, and the Outline view is populated, with which you can quickly navigate the program.

3. Try some of the other language features. For example, you can right-click any variable and select Peek References from the pop-up menu. The editor then shows you all the places where the variable is used inside the program.

For more information about the editor's features, see Making code changes.

You need access to a z/OS system with z/OSMF or RSE configured to take full advantage of all the features in the stack. Zowe CLI profiles are used to connect to z/OS. This section explains how to do this in IBM Wazi Developer for Workspaces via the command line.

Make sure you have a z/OS system that is reachable from your OpenShift cluster. If you are using IBM Cloud®, you could try using a system provided by the Master the Mainframe learning site, which you can sign up for on the Master the Mainframe Learning System Registration page.

Complete the following steps to create a Zowe CLI profile:

1. After you have created a workspace using the IBM Wazi Developer for Workspaces stack, click the cube icon on the right side of your workspace to launch command line that contains the run time of Wazi Developer tools.

2. Expand wazi-terminal and double-click New terminal.

3. To use Zowe CLI, you must create a Zowe CLI profile to connect to z/OS. You can also reuse this same profile in the Zowe Explorer VS Code extension. Follow these steps to create a profile:

   Issue one of these commands depending on your z/OS API:

   • For z/OSMF, issue this command with your hostname, z/OSMF port, username, and password:

     zowe profiles create zosmf-profile zoweCLI --host host.company.com --port 443 --user USER1 --pass password --reject-unauthorized  false

   • For RSE, issue this command with your hostname, RSE port, username, password, and basepath:

       zowe profiles create rse rseCLI --host host.company.com --port 6801 --user user1 --pass pass1 --bp rseapi --ru false

Complete the following steps to set up Zowe Explorer and visually explore z/OS resources.

1. Open the Zowe view in your Wazi Developer for Workspaces workspace, and expand the DATA SETS view, if it is not already expanded.

2. You can either choose an existing profile that you created by using Zowe CLI in step 4 above or create a new profile by using Zowe Explorer on UI as follows:

   • To use the profile you created in the command line, first hover your cursor over the DATA SETS view header bar, and then click the Refresh All arrow icon. Then, click the + icon next to it and select your profile from the drop-down list.

   • To create a new profile in the UI, click the + icon in the DATA SETS view header bar and select Create a New Connection to z/OS. A series of follow-up prompts will ask you for all your connection details.

     • Specify any name for your connection profile.

     • If you are using a Master the Mainframe z/OS connection mentioned in step 4:

       • For the z/OSMF url, use the IP address and port that you used for the 3270 connection above. The default port for z/OSMF is normally 443.

       • For the question about rejecting connections with self-signed certificates, select false for the Master the Mainframe systems.

3. Now an entry appears in the Data Sets tree. You can click the Search icon (magnifying glass) next to that entry and select Create a new filter to enter your username and find the ISPF.ISPPROF data set. To create a new data set, you can right-click your profile name and select Create New Data Set.

4. To add the same connection profile to the USS or JOBS view, expand the view and click the + icon that appears when you hover your cursor over the view's header. Then, select the connection from the drop-down list.

For more information about using the Zowe Explorer views to interact with z/OS, see Using the Zowe Explorer views.