Compuware Test Drive Getting Started Drive... · • Edit library members and submit JCL Connect to...
Transcript of Compuware Test Drive Getting Started Drive... · • Edit library members and submit JCL Connect to...
1
Compuware Test Drive
Getting Started Revised: 10/6/2020
This tutorial will help you prepare the 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 Topaz Workbench
as well as the ‘help’ capabilities within.
The Mainframe Software Partner for the Next 50 Years
2
Contents
Explore Eclipse ................................................................................................................................. 3
Eclipse Ide Components ............................................................................................................... 3
Access Topaz Workbench ............................................................................................................ 4
Host Connections ............................................................................................................................. 6
JES Explorer .................................................................................................................................... 14
JES Explorer View ....................................................................................................................... 14
JES Explorer Queues ................................................................................................................... 15
Browse JOB Output .................................................................................................................... 16
JES Explorer Purge ...................................................................................................................... 17
Getting Help ................................................................................................................................... 17
NEXT STEPS .................................................................................................................................... 19
The Mainframe Software Partner for the Next 50 Years
3
Explore Eclipse
Eclipse Ide Components
Eclipse is an Integrated Development Environment (IDE). The basic components are:
NOTE: if you wish to rerun this Test Drive Script, simply restart the Test Drive script from page 15. The files and libraries will be regenerated
The Mainframe Software Partner for the Next 50 Years
4
In Eclipse, a perspective is a collection of related views arranged in a logical way. Perspectives can be pre-defined or custom.
Access 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.
Open a Perspective
Click on the Windows tab, scroll down to ‘Open Perspective’ and click on it: The Open Perspective dialog opens and you will see ‘Other’
Click on ‘Other’ to bring up a list of the perspectives available: This lists all perspectives defined within your Workspace. Compuware products, third-party plugins and custom-defined perspectives will appear here. Your list may vary depending on the release of Topaz and the features you have installed. Test Drive instances will always be built on the currently available quarterly GA release.
Click the Cancel button
The Mainframe Software Partner for the Next 50 Years
5
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, how to open them for use within Topaz using either the Window or Compuware menus, and how to clean up your working area
Remember: A Perspective is a
collection of related views grouped in a
logical way – typically to focus on a
particular set of tasks. The Host Explorer
perspective groups the views together
that allow the user to work with mainframe
datasets and jobs.
The Mainframe Software Partner for the Next 50 Years
6
through 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
To 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. Type the test drive ID and password that were sent to you, and then press <enter>. Note: Do not click on ‘Save Credentials’ as it is not enabled for Test Drive After you successfully sign in, you will notice that below the TestDrive, you will see the following:
The Mainframe Software Partner for the Next 50 Years
7
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).
Note, filters are not case sensitive. All dataset names in the filtered lists will appear as uppercase.
Click OK (screenshot not shown).
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.
The Mainframe Software Partner for the Next 50 Years
8
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 that you are authorized to see by your mainframe security facility.
In the Hosts Explorer view, right-click z/OS Datasets and click Add Filter.
In the Filter field, type:
cwezxxx.topaz.workshop
Use the ID that you were assigned as your high level qualifier.
Click OK.
After clicking OK, your host explorer view will look like this, except your CWEZ 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.
The Mainframe Software Partner for the Next 50 Years
9
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.
The Mainframe Software Partner for the Next 50 Years
10
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).
Right click on WBRSTOR and in the dropdown, and click ‘Edit With’ to bring up the edit dropdown. You will modify JCL click ‘Topaz JCL Editor’. The member opens in the editor.
Change the Job Name (highlighted) to match yourid plus one character When you make a change, Topaz Workbench places an asterisk (*) next to the member name tab to indicate that the member has been modified.
Right-click in the JCL to display the context menu and click Submit.
Click OK in the “Submit Resource” dialog (screenshot not shown).
The Mainframe Software Partner for the Next 50 Years
11
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 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.
The Mainframe Software Partner for the Next 50 Years
12
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.
The Mainframe Software Partner for the Next 50 Years
13
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 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 Mainframe Software Partner for the Next 50 Years
14
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
If you see that the ‘connect’ button is not highlighted, then you still have a connection to the host and can skip to step 2. 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 Mainframe Software Partner for the Next 50 Years
15
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.
The Mainframe Software Partner for the Next 50 Years
16
Browse JOB Output
To display job output in the editor, double-click the Job Name:
The output is displayed in the editor.
Notice that 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.
The Mainframe Software Partner for the Next 50 Years
17
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
Note: 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
Getting Help
There are two ways to get assistance with questions you may have within Topaz Workbench:
Quick Access button
When you click on the Quick Access Button, you can enter a command 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.
The Mainframe Software Partner for the Next 50 Years
18
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:
The Mainframe Software Partner for the Next 50 Years
19
NEXT STEPS
Now that you have built your Topaz Workbench environment, you’re ready to take a deep dive into the full Topaz Workbench experience. Click on the link below to return to the Compuware Test Drive main page and choose your next road trip!
COMPUWARE TEST DRIVE