Getting Started with Workbench for Eclipse
This tutorial will help you prepare the BMC AMI DevX Workbench for Eclipse (Workbench) environment you'll need for the rest of the Test Drive Experience. It will also introduce you to some basic Workbench functions and the Help capabilities within.
Explore Eclipse
Eclipse IDE Components
BMC AMI DevX Workbench for Eclipse is based on Eclipse, an Integrated Development Environment (IDE). The basic components are illustrated below:
In Eclipse, a perspective is a collection of related views arranged in a logical manner. Perspectives can be pre-defined or customized.
Access BMC AMI DevX Workbench for Eclipse
After BMC AMI DevX Workbench for Eclipse starts, you may see the following the screen. If so, close the welcome screen by clicking the white "x" next to the word Welcome. You'll see the Workbench Host Explorer perspective as shown above.
Reset a Perspective
From time to time, you may find it necessary to reset your perspective to the default settings to make sure you are at the correct starting point.
Right-click on the Host Explorer perspective name in the top right corner and click Reset.
Click the Reset Perspective button.
So far, you have learned about Eclipse perspectives and views, and how to clean up your working area by either resetting a single perspective or closing all perspectives.
Next, we will look at working with mainframe host resources like datasets and jobs.
Host Connections
In this section you will:
- Connect to the Host
- Logon to the Host
- Add filters to view the files and libraries that you will need for the upcoming tutorials
- Define and allocate a library
- Copy a member from one library to another
- Edit library members and submit JCL
Connect to the Host
Expand your host connection list.
Click on arrow next to Hosts.
Click the expand button next to TestDrive.
Workbench will prompt you to login using your mainframe ID and password (screenshot not shown). Type the test drive ID and password that were sent to you, and then press <enter>.
After you've signed in, you should see the following below the Test Drive host:
Add a Filter
To view a dataset needed for the first exercise:
Right-click z/OS Datasets.
Click Add Filter.
In the Filter pattern field, type: cwez000.topaz.workshop and click Add then OK.
Right-click on the dataset CWEZ000.TOPAZ.WORKSHOP.
Click on Allocate Like.
In the Allocate Dataset dialog box, change the first part of the dataset name, "CWEZ000," to your test drive ID.
Click the Finish button.
Click OK.
Add a filter for the new dataset
In order to work with your new dataset and copy data into it, you need to create a second filter in Host Explorer so you can see it. This is the same process you will follow to create a filter for any dataset.
In the Hosts Explorer view, right-click z/OS Datasets and click Add Filter.
In the Filter field, type: cwezxxx.topaz.workshop (where cwezxxx = the Test Drive ID you've been assigned) and click OK (screenshots not shown).
When complete, your host explorer view will look like this, except your Test Drive ID will be in the high-level qualifier instead of CWEZXXX:
Copy a Member to Your Dataset
The Allocate Like operation created a dataset on the mainframe structured just like the source dataset but it did not put any data into it. Next, you'll copy a member from the source dataset so that you can customize it for your specific user ID.
Click on the arrow next to CWEZ000.TOPAZ.WORKSHOP to display the members in the PDS.
Drag and drop WBRSTOR into your new PDS.
The Copy dialog window will open. Click Copy.
Upon successful completion of the COPY function, you'll see "Success" in the Status column.
Click the Close button (not shown).
You can also see the result of the copy in the Console view in the bottom frame of the Workbench.
Edit JCL and Submit a Job
Now that you've copied a member to your own dataset, you'll edit this member and submit a job to copy set of working files for the rest of your Test Drive Experience. If you ever wish to restart your Test Drive Experience from scratch, simply return to this step and resubmit this JCL.
If the PDS member list is not shown, click the expand button next to yourid.TOPAZ.WORKSHOP to display the list (screenshot not shown).
Double-click WBRSTOR. The member opens in the Workbench text editor.
Change the Job Name (highlighted) to match yourid plus one character, as shown in the screenshot, except "XXX" will be your number.
When you make a change, Eclipse places an asterisk (see the red arrow) next to the member name tab to indicate that there are unsaved changes.
Right-click in the JCL to display the context menu and click Submit.
Click OK in the "Submit Resource" dialog (screenshot not shown).
The job should end quickly, and a confirmation message will appear in the console view. If you do not get "MAXCC=0," please call the BMC Support Hotline.
You'll also see the following pop-up in the bottom-right corner of Workbench:
The notification will disappear after a few seconds, or you can click the 'X' to close it.
Once you have confirmed your job completed successfully, close the edit view by clicking the X in the editor tab.
Click the Yes button to save your JCL (screenshot not shown.)
Add a filter for WBSAMP datasets
The job created several datasets qualified by your ID. You will need to add another filter to display those datasets (screenshots not shown). Refer to the prior instructions for adding a filter if you need help.
In the Filter field, type yourid.WBSAMP and click OK.
Your z/OS Datasets should look similar to the screenshot here with yourid as the first node of the dataset names.
Show Contents View
It can be very helpful to focus on the contents of a specific dataset with a view that shows just the contents of a single selected filter or dataset. BMC AMI DevX Workbench for Eclipse provides this with the Contents View.
Right-click on your new filter (yourid.wbsamp) to display the context menu, and choose Show Contents.
The Contents view is populated with dataset names matching the filter criteria and related dataset information. You can also see this list in the Host Explorer view by right clicking the arrow next to the filter name.
'Show Contents' can provide more detailed information about the type of file/library as well as dataset attributes. Both approaches are valid and used interchangeably.
This completes the Host Explorer Section. You have learned how to use filters to find datasets on the mainframe, allocate new datasets, and copy members to them, as well as how to edit a PDS member.
Next, we'll show you how Workbench helps you manage your mainframe JES queues.
JES Explorer
The JES Explorer allows you to view and manage job outputs. The functionality it provides is similar to SDSF.
In this section you will:
- Examine the functions of the JES Explorer
- Display a Job queue
- Display the Job output
- Purge the job from the held queue
JES Explorer View
Click the JES Explorer tab.
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.
Type your user ID with a wildcard * in the PREFIX field as shown in the screenshot.
If you see that the 'connect' button is highlighted, this indicates that you are no longer connected to the host. This can occur if you leave Workbench and come back later to do the JES EXPLORER portion of the script or if the connection to the host has timed out. You will need to reconnect to the host.
Click on the 'connect' button. Since you are, in this exercise, connecting to only one host, the connection will be established. A dialog appears. Enter your ID and password and click on the OK button (screenshot not shown).
Click the 'search' button, and the job that you just ran will appear in the list.
JES Explorer Queues
Notice that you can also filter your JES output by queue type.
Try different options but please remember to re-check all the boxes before continuing in this experience to stay consistent with the instructions.
Browse JOB Output
To display job output in the editor, double-click the Job Name:
The output is displayed in the editor.
Notice when you click on the jobname, the DD statements appear on the right-hand column of the JES Explorer view, along with the number of records.
JES Explorer Purge
To purge your output (screenshots not shown), click on your job to select it.
Click the Purge button (Red X Icon) or press the Delete key on your keyboard.
Click 'OK' to purge the job, then click the refresh icon to show your job removed from the queue.
Getting Help
There are two ways to get assistance with questions you may have within BMC AMI DevX Workbench for Eclipse.
Quick Access search glass
When you click on the Quick Access field, you can enter a command that you want information about, and press <enter>.
A window pops up to display menus and information how-to's.
You can select any of the options listed. If the panel is full, you can click 'CTRL+3' to see all of the options.
Click anywhere outside of the window to close the Quick Access window.
Help Tab
Clicking on the Help Tab will provide you with several options:
You can search for a specific function, or you can click on Help Contents:
Next Steps
Now that you have built your BMC AMI DevX Workbench for Eclipse environment, you're ready to take a deep dive into the full Workbench experience.