zOSMF Desktop UI Hands-On Lab.pdf
- 1. © Copyright IBM Corp.2022 1 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Hands-On Lab Exploring the new z/OSMF Desktop UI Abstract: IBM z/OS Management Facility (z/OSMF) provides a web-based graphical user interface (UI) for working with z/OS. In this hand-on lab, you will explore the new desktop style UI of z/OSMF, which offers advantages over the earlier, classic style UI. This session will be useful to systems programmers and their managers who will be using or are considering using z/OSMF.
- 2. z/OSMF Desktop UI Hands-On Lab Exercises Guide 2 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Introduction: A new look and feel for z/OSMF After ten years of continuous development, the z/OSMF user interface (UI) is showing its age. The current UI, with its navigation tree, tabs, and tables, is still quite functional, but it has some notable limitations. For example, the current UI limits you to running one z/OSMF task at a time. Also, it constrains the size of each task work area---the place where you do your z/OS work---which can make it a chore to enter commands and data. Is it time for a change? We think so. With the installation of APAR PH16076 and the subsequent enhancements on your system, z/OSMF now offers a new, desktop-style UI as a user-selectable option. Since z/OS V2R5, desktop-style UI is the only supported UI for z/OSMF. With this new UI comes a new way of interacting with z/OSMF, which is more consistent with other computing platforms. The changes include: • Much larger work area with icons to represent the z/OSMF tasks and folders. • Task bar that helps you access z/OSMF tasks quickly. Your experience is further enhanced through the following improvements: • Support for a mix of new and existing applications. • Multi-tasking capabilities for viewing and running multiple tasks at once. • Ability to: o Resize the workspace of a particular task within the UI. o Create customized groupings of z/OSMF tasks in user-named folders. o Save links from the Links task as icons on the desktop. o Search, browse and edit data sets, Unix directory and Unix files. o Create shortcut for data set, UNIX files on the desktop. o Submit data set or data set member as JCL o View job output for your jobs o Create new data set or USS file o Compare dataset and USS file We think that you will find the new desktop UI to be faster and more friendly to use than the earlier, classic style UI.
- 3. © Copyright IBM Corp.2022 3 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. z/OSMF Lab: Exploring the desktop style UI In this lab, you will learn about the new desktop UI by completing the following activities: 1. Log in to z/OSMF. 2. Create new data set. 3. Create a new data set member. 4. Search data set and member. 5. Copy and rename data set member. 6. Compare and merge data set members 7. Browse USS path and edit USS file 8. Open referenced data sets in Editor 9. Create shortcut for data set or data set member It is recommended that you perform these activities in the order listed. As you become more familiar with the desktop UI, you will become adept at accessing the particular tasks that you require. As with the other labs in this session, the lab teams share access to the same z/OS system. Each team is given a unique z/OS user ID to use for the exercises. To avoid confusion, use only the user ID that is assigned to your team. Notes: 1. The screen captures in this handout show the use of different user IDs. Your browser session will use the user ID that was assigned to your lab team.
- 4. z/OSMF Desktop UI Hands-On Lab Exercises Guide 4 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 1. Log in to z/OSMF • Launch browser from your workstation • Point browser to z/OSMF – enter the following url https://share.centers.ihost.com/zosmf • Login with SHARE userid/pw as provided by the lab instructor o Each workstation has been assigned a unique z/OS user id Note: All screen captures in the handout show the different user ID, your browser will be slightly different to reflect the User ID that you were given.
- 5. © Copyright IBM Corp.2022 5 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Since V2R4, z/OSMF lands in desktop UI by default.
- 6. z/OSMF Desktop UI Hands-On Lab Exercises Guide 6 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 2. Create new data set Step 2a. Open the dialog of Create new data set Right click on the z/OSMF desktop background, and select New→Data set menu. The “New Data Set” dialog will be popped up.
- 7. © Copyright IBM Corp.2022 7 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 2b. Create a PDS/E dataset with pre-defined template for JCL data set In the dialog of “New Data Set”, enter data set name <userid>.LAB.DEMO in which <userid> should be replaced by your current logon user id, such as SHARA15. Then select “JCL” template in the “Data Set Template” drop down list. Click on OK button, the data set will be created and a new message will be displayed on the top of the dialog to indicate the successful creation of the new data set.
- 8. z/OSMF Desktop UI Hands-On Lab Exercises Guide 8 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 2c. Open the created data set In the popped up message, click the Open button in the message to directly access the data set just created.
- 9. © Copyright IBM Corp.2022 9 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. The panel will display member list of this data set. Since it’s just created, there is no member displayed in the dialog.
- 10. z/OSMF Desktop UI Hands-On Lab Exercises Guide 10 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 3. Create a new data set member Step 3a. Open New Member dialog Click the + icon like below to open the New Member dialog. A new dialog is opened and the current data set name is populated.
- 11. © Copyright IBM Corp.2022 11 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 3b. Create a new member Input TEST as the Member Name value, then click OK.
- 12. z/OSMF Desktop UI Hands-On Lab Exercises Guide 12 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 3c. Check if the data set member is created successfully Click Open in the message to open the data set member just created.
- 13. © Copyright IBM Corp.2022 13 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Now, you will see the editor window of data set member “SHARA15.LAB.DEMO(TEST)”.
- 14. z/OSMF Desktop UI Hands-On Lab Exercises Guide 14 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Let’s close the Editor window for now.
- 15. © Copyright IBM Corp.2022 15 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 4. Search data set and member Step 4a. Search data set SYS1.SAMPLIB with type ahead search function • Select the “Data Set and File Search” window • Input sys1.s in the search box and pause for one second. You will see the drop down list which contains all the data set names match with “SYS1.S” you just entered. • Use Up or Down arrow key in keyboard to scroll up and down in the drop down list. • Select SYS1.SAMPLIB and hit enter. Step 4b. List the data set SYS1.SAMPLIB Click Go button or press Enter.
- 16. z/OSMF Desktop UI Hands-On Lab Exercises Guide 16 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 4c. Open member list of data set SYS1.SAMPLIB Click on the data set name to open it. Since SYS1.SAMPLIB is a PDS/E, the member list will be displayed.
- 17. © Copyright IBM Corp.2022 17 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 18. z/OSMF Desktop UI Hands-On Lab Exercises Guide 18 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 4d. Use Filter to quickly locate data set member AIRINJCL Click the Filter icon on the tool bar
- 19. © Copyright IBM Corp.2022 19 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Input keyword “JCL” in the Filter input box to quickly locate the member “AIRINJCL”.
- 20. z/OSMF Desktop UI Hands-On Lab Exercises Guide 20 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 21. © Copyright IBM Corp.2022 21 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 5. Copy and rename data set member Step 5a. Copy data set member AIRINJCL from SYS1.SAMPLIB to SHARA15.LAB.DEMO • Right click on the data set member AIRINJCL, then select Copy to → Data Set. • Input <USERID>.LAB.DEMO and the Member Name as TEST. Then click OK button.
- 22. z/OSMF Desktop UI Hands-On Lab Exercises Guide 22 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 5b. Check the result of Copy Close the prior “Copy” dialog and switch back to “Data set and File Search” dialog like below. Enter “SHARA15.LAB.DEMO” in the input box and then hit Enter.
- 23. © Copyright IBM Corp.2022 23 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Click on the data set name “SHARA15.LAB.DEMO”, the member list will be opened.
- 24. z/OSMF Desktop UI Hands-On Lab Exercises Guide 24 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 5c. Rename the data set member SHARA15.LAB.DEMO(TEST) • Right click on the member “TEST” and select “Rename” The Rename dialog will be opened. Provide a new name “AIRIN2” like below. Hit OK button.
- 25. © Copyright IBM Corp.2022 25 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 5d. Edit content of data set member Switch back to the “Data set and File Search” dialog and click on the member name “AIRIN2” to open the member for editing.
- 26. z/OSMF Desktop UI Hands-On Lab Exercises Guide 26 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. A new editor window will be opened like below. Click on the Pen icon to enter into Editing mode.
- 27. © Copyright IBM Corp.2022 27 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Press Control + F Key (on Windows) to open the Find + Replace tool. (Mac is Command + F).
- 28. z/OSMF Desktop UI Hands-On Lab Exercises Guide 28 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Input tmp in Find box to search the content which contains “tmp”.
- 29. © Copyright IBM Corp.2022 29 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Click the Toggle Replace mode. Input “var” in the replace box and click the Replace All icon to change all “tmp” to “var”.
- 30. z/OSMF Desktop UI Hands-On Lab Exercises Guide 30 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Click the Save button to save changes.
- 31. © Copyright IBM Corp.2022 31 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 32. z/OSMF Desktop UI Hands-On Lab Exercises Guide 32 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 6. Compare and merge data set members Step 6a. Select source for compare • Reselect the Data Set and File Search window. • Select dataset member AIRIN2 → right click → select menu “Select Source for Compare”. Step 6b. Select another source for compare • Move the cursor to the search input box. • Select “SYS1.SAMPLIB” from the dropdown history list.
- 33. © Copyright IBM Corp.2022 33 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. After the data set name SYS1.SAMPLIB is populated in the input box, click Go button or press Enter to list the data set.
- 34. z/OSMF Desktop UI Hands-On Lab Exercises Guide 34 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Click on the data set name to open member list of SYS1.SAMPLIB. Then enter “JCL” in the Filter input box on tool bar like below.
- 35. © Copyright IBM Corp.2022 35 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 6c. Compare two members Right click on member name “AIRINJCL”, select menu “Compare with SHARA15.LAB.DEMO(AIRIN2)”
- 36. z/OSMF Desktop UI Hands-On Lab Exercises Guide 36 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. A compare window will be opened like below.
- 37. © Copyright IBM Corp.2022 37 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 6d. Copy the first difference from right to left Now we are at the first difference, click the Copy to Left button on the top left to copy the current difference from right to left.
- 38. z/OSMF Desktop UI Hands-On Lab Exercises Guide 38 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 39. © Copyright IBM Corp.2022 39 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 6e. Copy the difference from left to right. To change the third difference at the right side, we can either use the Next Difference button to navigate to it, or simply put the cursor at the third difference, and click the Copy to Right button.
- 40. z/OSMF Desktop UI Hands-On Lab Exercises Guide 40 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 41. © Copyright IBM Corp.2022 41 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 42. z/OSMF Desktop UI Hands-On Lab Exercises Guide 42 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 6f. Save the changes. Since you made changes to both sides, the Save icon on the top will now be enabled. Click the Save icons to save the changes.
- 43. © Copyright IBM Corp.2022 43 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 44. z/OSMF Desktop UI Hands-On Lab Exercises Guide 44 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 7. Browse USS path and edit USS file Step 7a. Browse a USS path • Switch back to the Data Set and File Search window. • Input the USS path /global/zosmf/configuration/servers/zosmfServer in the search bar. You don’t have to enter the full path. Enjoy the type ahead search if you pause one second as you type. • Click the Go button or press Enter to open the directory. Click on the column header “Name” to sort the files alphabetically by name, then we can easily find the file server.xml
- 45. © Copyright IBM Corp.2022 45 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 46. z/OSMF Desktop UI Hands-On Lab Exercises Guide 46 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Open the USS file server.xml by clicking its name, we will see the file is opened and it’s also highlighted with XML syntax.
- 47. © Copyright IBM Corp.2022 47 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 48. z/OSMF Desktop UI Hands-On Lab Exercises Guide 48 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 8. Open referenced data sets in Editor Step 8a. Open the data set member SYS1.PROCLIB(IZUFPROC) Switch back to Data Set and File Search window, search the data set SYS1.PROCLIB. Click on the name of “SYS1.PROCLIB” to open its member list. Then input IZUFPROC in the search box to search for the member.
- 49. © Copyright IBM Corp.2022 49 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Open the data set member “IZUFPROC”, you will see the referenced data sets or USS path are displayed as links.
- 50. z/OSMF Desktop UI Hands-On Lab Exercises Guide 50 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 8b. Adjust the window to a proper size Click the maximize icon or double-clicking the window’s title bar to maximize the editor window.
- 51. © Copyright IBM Corp.2022 51 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 52. z/OSMF Desktop UI Hands-On Lab Exercises Guide 52 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 8b. Open referenced data set with one click • Hover on the name of SYS1.SBPXEXEC o For Windows, Hit Ctrl + Click to open the data set o For Mac, Hit Cmd + Click to open the data set
- 53. © Copyright IBM Corp.2022 53 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 54. z/OSMF Desktop UI Hands-On Lab Exercises Guide 54 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 8c. Open a referenced USS directory from Editor window • Switch back to the window which displays content of SYS1.PROCLIB(IZUFPROC) • Scroll up to the top of the content. • Cmd+Click on usr/lpp/zosmf path
- 55. © Copyright IBM Corp.2022 55 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 56. z/OSMF Desktop UI Hands-On Lab Exercises Guide 56 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Now, let’s select “Data Set and File Search” window again. If you cannot find the window, you can open it via clicking on the “Search” icon on the right of z/OSMF task bar like below.
- 57. © Copyright IBM Corp.2022 57 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.
- 58. z/OSMF Desktop UI Hands-On Lab Exercises Guide 58 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. 9. Create shortcut for data set or data set member Step 9a. Find the data set member SYS1.SAMPLIB(IZUAUTH) • In the “Data Set and File Search” window, enter SYS1.SAMPLIB and then hit Enter. Open member list of SYS1.SAMPLIB by clicking on the name of SYS1.SAMPLIB. Then enter “IZUAUTH” in the Filter input box to quickly find IZUAUTH sample job.
- 59. © Copyright IBM Corp.2022 59 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Step 9b. Send IZUAUTH to desktop Right click on IZUAUTH → select Send to →select Desktop. Step 9c. Check the shortcut
- 60. z/OSMF Desktop UI Hands-On Lab Exercises Guide 60 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. Double click on the background of z/OSMF desktop can quickly bring you back to the desktop. Then you will see the shortcut you just created for SYS1.SAMPLIB(IZUAUTH) on the desktop. Step 9d. Open the shortcut Double click on the icon of “SYS1.SAMPLIB(IZUAUTH)”, you can directly open the member for editing. The shortcut could help you to quickly locate some frequently used files or data sets in the future. Step 9e. Submit job from z/OSMF Desktop Editor • In the Editor window we opened for “SYS1.SAMPLIB(IZUAUTH)”, click on the 3 dots icon and then you will see a menu item “Submit as JCL”. Since you are operating with a shared system, we won’t perform this action. But if you do so, a separate Job Output window will be popped up for you to check job outputs.
- 61. © Copyright IBM Corp.2022 61 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM. End of exercise
- 62. z/OSMF Desktop UI Hands-On Lab Exercises Guide 62 © Copyright IBM Corp. 2022 IBM conference materials may not be reproduced in whole or in part without the prior written permission of IBM.