1. IBM Washington Systems Center Introducing the zPMT WebSphere Application Server for z/OS Based on WP100871 ibm.com/support/techdocs Don Bagwell IBM Washington Systems Center dbagwell@us.ibm.com

2. IBM Washington Systems Center 2 Agenda Overview of the zPMT Illustration of a DMGR configuration Some Recommendations (something short of “best practices”)

3. IBM Washington Systems Center 3 White Paper on Techdocs This presentation is based on the white paper WP100871 on Techdocs http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP100871

4. IBM Washington Systems Center 4 Overview

5. IBM Washington Systems Center 5 Initial High-Level Overview of the zPMT zPMT and the AST …

6. IBM Washington Systems Center 6 zPMT is a Function of the “Application Server Toolkit” (AST) The Application Server Toolkit comes with WebSphere Application Server (all platforms). It is an “Eclipse-based” tool. Installation media provided in the “Optional Materials” bundle of CDs If you have a valid license for WebSphere Application Server (any platform), you have right to as many seats of AST as you like Invoking the AST and zPMT… You do not need to master the AST to use the zPMT. For configurations only, you can skip right past 99% of AST functions. Windows or Linux, but zPMT only runs on Windows at present

7. IBM Washington Systems Center 7 Invoking AST and then the zPMT Function IBM WebSphere  Application Server Toolkit V6.1  Application Server Toolkit AST … from “Start” menu: zPMT … from menu bar of AST: Types of configurations you can build … This will be the focus of all our discussions of configuring WebSphere for z/OS

8. IBM Washington Systems Center 8 Five Different Configuration Types You Can Build This is one more than you can do with the ISPF panels … Remember what this is doing … it’s building a set of customized batch JCL jobs that will be run on the z/OS system This from the WP100871 white paper Message: equivalent of ISPF Panels, plus one more The result of your configuration work …

9. IBM Washington Systems Center 9 What Gets Created Keeping your AST and zPMT up to date … A saved configuration definition down in the “workspace” (more later) Customized JCL jobs – created in Windows files – are on workstation’s hard drive Upload feature allows you to FTP the files up to the z/OS sstem Once uploaded, it is exactly the same as if the ISPF panels had created the configuration jobs

10. IBM Washington Systems Center 10 Updating AST and zPMT to Latest Level of Code zPMT is part of AST, and AST is built on Rational Eclipse base, it can take advantage of the “Product Updater” function: It will then go to website and scan for available updates. If an update exists, you may select it for installation. Process is very automated and easy Next: an example of creating a configuration …

11. IBM Washington Systems Center 11 An Example Configuration Definition

12. IBM Washington Systems Center 12 Invoking AST and Specifying a “Workspace” A “workspace” is a starting point folder for all the sub-directories and files the AST (and zPMT) will create as part of its work: Some points: Not necessary to understand everything in this structure Everything zPMT creates will be under C:/zPMT (in this example) It’s okay to create different workspaces for different configurations (more later) We have some recommendations on how to organize workspaces later Specifying the type of definition to be created …

13. IBM Washington Systems Center 13 Creating a Definition After invoking the AST and the zPMT function, you then may then act upon an existing definition, or create a new one: Options are nearly identical to the ISPF panels, with the exception of the one that creates simple ND cell in one set of jobs Giving the definition a name …

14. IBM Washington Systems Center 14 Giving the Definition a Name The name required here is used by zPMT so it can keep separate what may be several different definitions. You should provide a name that tells the story of what the configuration is – cell name, configuration type, etc. Points: This name not used on the z/OS system; only in the zPMT tool May be far more than 8 characters long Uppercase/lowercase – doesn’t matter Spaces not allowed Later, when you come back into zPMT, you’ll key off whatever name you provide here to know what the definition is for. So make it meaningful. Specifying the type of definition to be created … It is possible to create a definition based on an input variables file. More on this later.

15. IBM Washington Systems Center 15 High Level Qualifier for z/OS Target Data Sets The next window asks what the “target data set” high level qualifier will be for the generated jobs: Points: This is really no different from what we used to do in the ISPF panels The customized jobs themselves need to know this … this is not just where the customized jobs will be FTPed. The Planning Spreadsheet (PRS1331) … This brings up the issue of the Planning Spreadsheet, which many use to plan their configurations. That spreadsheet is very much applicable to the zPMT, just as it was to the ISPF panels

16. IBM Washington Systems Center 16 The Planning Spreadsheet Techdoc PRS1331 provides an Excel spreadsheet that many find very useful in planning their configuration naming and port definitions The version 6.0 spreadsheets The version 6.1 spreadsheets zPMT editionISPF edition Spreadsheet operates off the concept of providing a few key variables in one place, then having all the names and ports automatically generated. The ISPF edition is formatted to look like the ISPF panels themselves. Generate values in Excel, then copy/paste into ISPF. You can use this edition with the zPMT. The zPMT edition is creates a “Response File” format …

17. IBM Washington Systems Center 17 New Spreadsheet Generates zPMT Input Variables Provide key variables in the “Variables” sheet The zPMT edition generates a set of values that can be used as a “Response File” input to the zPMT tool Copy the generated variables from the appropriate worksheet and paste into Notepad to create a file Then point to the file in the “Response File” field of the window where you gave the definition a name Then just tab through the zPMT windows and generate the jobs The Data Fields of the zPMT …

18. IBM Washington Systems Center 18 The Names, Ports and Such that Make up the Configuration Definition Then we get into window after window that looks very much like the ISPF panels … not exactly, but the layout of the data is very similar. Points: The nature of the data requested is exactly as it was for the ISPF panels The layout is slightly different … some stuff is in slightly different places. Still, easy to follow if you’re familiar with the ISPF panels We’ll not go through each because it’s so similar to ISPF Creating the Definition …

19. IBM Washington Systems Center 19 Creating the Customization Definition Once you have your definitions as you want them, you click on the “Create” button to generate the customized jobs and finish the definition: Everything is still on your workstation. You may act upon your definition in several different ways at this point. Actions against zPMT definition …

20. IBM Washington Systems Center 20 Things You Can Do Against Definition Definitions stored in the workspace can be acted upon … Create a new (different) definition Cycle back through an existing definition and make changes Delete a definition from the workspace (Not from z/OS, if you’ve already uploaded it) View the definition Summary of locations and some names The instructions for running the jobs on the z/OS system The “Response File” – the saved variables for this definition Upload the files to the CNTL and DATA data sets Viewing and Uploading …

21. IBM Washington Systems Center 21 Viewing a Definition Three tabs provided here … Basic stuff … definition name, definition type, target data sets Exactly the same thing as would be generated by the ISPF panels and put in the *INS member of the CNTL data set. This gets uploaded and placed in CNTL data set. The same thing as generated by the zPMT edition of the Planning Spreadsheet Uploading …

22. IBM Washington Systems Center 22 Uploading to the z/OS System Where the jobs can be run to create the configuration … Host, ID and password used to access z/OS Where files will go (grayed out – this must be same “target data sets” as specified in the configuration) Target may pre-exist or this tool can allocate Will use default allocation parameters Final steps …

23. IBM Washington Systems Center 23 Completing the Customization on z/OS Some recommendations … Where the jobs can be run to create the configuration … We just illustrated this Process from here is exactly like it is when using ISPF. Run the jobs in sequence to create the configuration.

24. IBM Washington Systems Center 24 Recommendations

25. IBM Washington Systems Center 25 One Workspace, or Many? It is quite possible to create all definitions in one big workspace. You may wish to consider making it a bit more granular. C:\zPMT All the definitions for A1CELL under here – DMGR, Standalone, Federate, etc. \A1CELL \Z9CELL All the definitions for Z9CELL under here – DMGR, Standalone, Federate, etc. zPMT will only “see” the definitions in the workspace specified at startup of AST. Could get confusing if dozens or hundreds of definitions in a workspace Or consider separation based on organization Backup and restore of a workspace …

26. IBM Washington Systems Center 26 Backup and Restore of a Workspace It’s just a set of folders and files in Windows. So it’s possible to copy or Zip the directory as a means of backing up the workspace Everything you defined for the Z9 cell is contained under C:\zPMT\Z9CELL Copy or ZIP to backup Restore is simply the reverse. Here’s the key – do NOT rename the root folder structure. There are references to that throughout the definition files. Sharing a workspace with others …

27. IBM Washington Systems Center 27 Sending a Zipped Workspace to Others Move Workspace If it’s possible to ZIP up a workspace, it’s possible to send that to someone else. Is this recommended? Two cases to consider: Share Workspace Intent is to permanently move a workspace from one workstation to another This is okay Intent is to share the information contained within a workspace with another, perhaps to build a different configuration We don’t recommend sending whole workspace. Rather, we recommend sending “Response File” Response Files …

28. IBM Washington Systems Center 28 Sending Response Files to Others Response files are flat files containing all the variables for a definition. They can be used as input to another definition. Best way: “View” the definition, then select the “Response File” tab. From there, copy contents and paste into a file. Person receiving file can then point to the file in the “Response File” field at definition creation. See next chart. Or, get it out of file system, way down under \profiles and the folder with the name of your definition. Loading response files …

29. IBM Washington Systems Center 29 Loading Response Files During definition creation, panel that asks for “definition name” also gives you a chance to point to a response file: Be aware of something … window just prior to this asked for the “type” of definition being created: Response file carries with it the “type” used originally. Be sure the two match … unless you’re intentionally loading response file of different type to seed some fields with data, as we did in ISPF panels frequently.

30. IBM Washington Systems Center 30 Questions? This presentation is based on the white paper WP100871 on Techdocs http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP100871 Reminder! Pull that one for more detail