Getting Started with Workbench for VS Code

This tutorial will help you prepare the BMC AMI DevX Workbench for Visual Studio Code (VS Code) environment you'll need for the rest of the Test Drive Experience.

If you wish to rerun this Test Drive Script, simply restart it from here. The files and libraries will be regenerated.

Explore VS Code

Create a Workspace

The workspace allows for settings and configurations to be saved so that they persist between logins. 

Do This

In the top toolbar select File and then Save Workspace As.

1.png

Do This

Name the workspace Your Test Drive ID and save under the root directory "PhotonUser". 

Workspace.png

BMC AMI DevX Explorer

In this section you will:

  • Establish a connection to the mainframe
  • Add filters to view data sets and files needed for the upcoming tutorials
  • Define and allocate a data set
  • Copy a member from one data set to another
  • Edit members and submit JCL
  • View job output 

Connecting to The Host

In order to interact with mainframe resources such as data sets and jobs a host connection must be established. 

Do This

Select the z/OS icon on the left side of the screen to display the DevX Explorer.

2.png

Do This

To log on to the host right-click the hostname TestDrive within the DevX Explorer and select Log In. Enter Your Test Drive credentials when prompted. 

3.png

Adding Data Set Filters

To display data sets in the DevX Explorer filters can be used. 

Do This

To apply a filter right-click the hostname within the DevX Explorer and select Add Filter to display the dialog . The + icon can also be used. 

4.png

Do This

In the Add Filter dialog input CWEZ000.TOPAZ.WORKSHOP and hit enter. A second dialog will appear prompting for an optional filter name (Screenshot not shown). Leave blank and hit enter to apply the data set filter. 

5.png

Allocating a Data Set

You can easily allocate a new data set by copying the attributes from another. 

Do This

Expand the data set filter using the arrow and right-click the CWEZ000.TOPAZ.WORKSHOP data set. Select Allocate Like.

6.png

Do This

Replace the CWEZ000 high-level qualifier in the data set name with Your Test Drive ID and hit enter to allocate the new data set. 

7.png

Copying a Member to Your Data Set

The Allocate Like operation created a data set on the mainframe just like the source data set, but it did not put any data into it. Next, you are going to copy a member from the source data set.

Do This

Click the expand arrow beside data set CWEZ000.TOPAZ.WORKSHOP to display the member list. Right-click the JCL member WBRSTOR and select Copy. 

8.png

Do This

Add a filter for the data set Your Test Drive ID.TOPAZ.WORKSHOP that was just allocated (Not Shown). Expand the new filter, right-click your data set and select paste to copy WBRSTOR to your data set.

9.png

Edit and Submit JCL

Now that the JCL member has been successfully copied into your own data set, you are going to edit this member and submit a job that will finish copying a set of working files.

Do This

Right-click WBRSTOR and select edit to open the editor. Change the job name (CWEZ000A) to match Your Test Drive ID plus one character.

Once complete click the the X on the editor tab and save your changes. 

10.png

Do This

Right-click WBRSTOR and select submit JCL. 

11.png

Viewing Job Output

Now you want to check and see that the job has completed successfully. The Job Explorer can be used to monitor the status of jobs.

Do This

To access the Job Explorer, click the toggle panel icon located on the top toolbar, as highlighted in the screenshot. Then, select Job Explorer from the bottom panel. 

12.png

Do This

To find the job input Your Test Drive ID with a wildcard * into the prefix field and click search. 

The Prefix and Owner fields work just like the PREFIX and OWNER commands in SDSF. You can use one or both of them to display the jobs you are interested in. 

13.png

Do This

To display the job output in the editor, double-click the job name. 

Once done viewing click the the X on the editor tab.  

14.png

Notice that when you click on the job name, the DD statements appear on the right-hand column of the Job Explorer, along with the number of records:
15.png

Adding a Filter for WBSAMP Data Sets

Do This

The job created several data sets qualified by Your Test Drive ID. You will need to add another filter Your Test Drive ID.WBSAMP to display those data sets. Refer to the prior step for adding a filter if you need assistance. Once added expand the filter to see all the data sets created for you. 

Your data sets should look similar to the screenshot, but with Your Test Drive ID as the first node of the data set names:

16.png

Next Steps

Now that you have built your BMC AMI DevX Workbench for Visual Studio Code environment, you're ready to take a deep dive into the full Workbench experience.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*