This tutorial will help you prepare the BMC Compuware Topaz environment you need as a basis for the rest of the Test Drive Experience. It will introduce you to some of the basic functions of BMC Compuware Topaz Workbench as well as the ‘help’ capabilities within.
Eclipse IDE Components
BMC Compuware Topaz Workbench 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 way. Perspectives can be pre-defined or custom.
Access BMC Compuware Topaz Workbench
When Topaz comes up, you may see the following the screen. If you do, close the welcome screen by clicking the white "x" next to the word Welcome (as indicated in the screenshot). Then you will see the Topaz Workbench Host Explorer perspective.
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. (Screenshot not shown).
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.
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.
Then click the expand button next to TestDrive.
Topaz 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 successfully sign in, you will notice that below the TestDrive, you will see the following:
Do not click on 'Save Credentials' as it is not enabled for Test Drive.
Add a Filter
To view a dataset needed for the first exercise:
Right-click z/OS Datasets.
Click Add Filter.
In the Filter field, type: cwez000.topaz.workshop (screenshot not shown)
Click OK (screenshot not shown).
Filters are not case sensitive. All dataset names in the filtered lists will appear as uppercase.
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.
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)
(Screenshots not shown.)
After clicking OK, 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 are going to 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 should see "Success" under Status:
Click the Close button (screenshot not shown).
You can also see the result of the copy in the Console view in the bottom frame of the Topaz Workbench.
Edit JCL and Submit a Job
Now that you have successfully copied a member to your own dataset, you are going to edit this member and submit a job that will finish copying a set of working files for the rest of your Test Drive Experience. This also will allow you to restart your entire Test Drive Experience from scratch if you decide to go through it again, simply by returning to this step and resubmitting 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 Topaz 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 Compuware Support Hotline.
You will also see the following pop-up on the bottom right corner of Topaz Workbench:
The notification will disappear after a few seconds, or you can 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. Topaz 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 are going to show you how Topaz helps you manage your mainframe JES queues.
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.
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 Topaz 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).
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.
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
If you need to purge your output:
Click on your job to select it.
Issue the purge command by clicking the Purge button or by pressing the Delete key on your keyboard.
If you select more than one job, you will purge all the jobs that you have selected.
Click 'OK' to purge the job (screenshot not shown).
Click the refresh icon to remove your job from the queue.
There are two ways to get assistance with questions you may have within Topaz Workbench.
Quick Access field
When you click on the Quick Access field, you can enter a command that you want information about, and press <enter>.
A window will pop up with menus and information how-to's:
At this point, 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.
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:
Now that you have built your Topaz Workbench environment, you're ready to take a deep dive into the full Topaz Workbench experience.