PRS3357 - Introducing the WCT for zOS - IBM · PRS3357 - Introducing the WCT for WebSphere z/OS...

54

Transcript of PRS3357 - Introducing the WCT for zOS - IBM · PRS3357 - Introducing the WCT for WebSphere z/OS...

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

1 Version:September 29, 2008

© 2008 IBM Corporation

WebSphere Application Server for z/OS V7.0

Introducing the WCT for z/OS

The WebSphere z/OS Support Team

IBM Washington Systems Center

WebSphere Customization Tools, including the zPMT and the zMMT

PRS3357 at ibm.com/support/techdocs

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

2 Version:September 29, 2008

© 2008 IBM Corporation2 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Table of Contents

• Introduction and Overview

We explain the key concepts of “locations” and “definitions” and “perspectives” and “views”

• Exploring the PMT

Here we delve into the specifics of the Profile Management Tool and how it can be used to create V6.1 or V7.0 runtime environments

• Exploring the MMT

We finish up with the specifics of the Migration Management Tooland how it can be used to migrate V5.1, V6.0 or V6.1 runtime environments up to V7.0

We start with a few slides that set the stage … explaining what the WCT is, how it compares to the previous ISPF dialogs and zPMT tools, and where the WCT can be acquired. Then …

The contents of this presentation.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

3 Version:September 29, 2008

© 2008 IBM Corporation3 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Basic Introduction to the WCT for z/OS

The WCT for z/OS is a workstation graphical tool that is used to generate the customized jobs used to create, migrate or augment a WAS z/OS configuration

Customized JCL batch jobs

You enter configuration specifics into the tool

Objective - creation of customized jobs for the purpose of creating or modifying a configuration

The WCT for z/OS -- WCT stands for “WebSphere Customization Tools” -- is a workstation based

graphical tool used for the creation of the customized jobs that build and migrate a WebSphere

Application Server for z/OS environment.

The concept is fairly simple: you enter information into the tool and it generates the customized JCL

jobs. Those are then uploaded to the z/OS platform where they’re run to create the WebSphere

z/OS runtime.

The concept is not new. The tool is. It’s new for V7.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

4 Version:September 29, 2008

© 2008 IBM Corporation4 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Types of Things You Can Do With the WCT

Here’s a peek at the things the WCT will allow you to create. We’ll explore these more later in the presentation.

PMT

MMT

Things you may already be familiar with

There is new V7.0 function under the “Management” option

This tool is capable of generating jobs to create V6.1 cells

New V7.0 functionality

Migration from V5.1, 6.0

or 6.1 up to V7.0

Note: WCT is extensible framework … more function may be added later

Here are the types of things you can do with the WCT. It comes with two basic functions:

• PMT - Profile Management Tool … used to create runtime components. The picture shows the

things you can create. Some of those are what we’re already familiar with from previous

versions of WebSphere z/OS; others are new to WebSphere z/OS V7. We’ll explore the new

things in a bit.

• MMT - Migration Management Tool … used to create jobs to migrate an environment from an

earlier version or release.

It’s important to understand that the WCT is designed to be extensible … which means that in the

future other functionality may be added to the program to allow it to do other things as well.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

5 Version:September 29, 2008

© 2008 IBM Corporation5 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Evolution of This Function

Before the WCT there was the AST, and before that the ISPF panels:

ISPF Panels

• Began in WebSphere z/OS V4 and continued into V5 and V6

• Was effective, but somewhat difficult to use with a tool like the planning spreadsheet

• Deprecated in V6.1 and withdrawn in V7.0 of WebSphere Application Server for z/OS

Function inside the Application Server Toolkit (AST)

• AST served as an Eclipse runtime to host the z/OS customization and migration functions

• First used for WebSphere z/OS V6.1 configurations

• Integrated nicely with the planning spreadsheet, which produced a response file used as input

• AST has considerable function beyond what was needed to customize WebSphere z/OS … which made AST at 800MB+ a very heavy download for some

Both did the same basic thing: creation of customized jobs for the purpose of creating or modifying a configuration. Now the WCT fills that role.

If you’re thinking, “Well, this is something like what we had before.” You’d be right. The WCT did

not spring up in a vacuum. It is a product of an evolution of function over time.

In the beginning, going all the way back to Version 4, we had the ISPF customization dialogs. They

did the same thing in concept as the WCT -- that is, creating customized jobs from specific input --

but it did it in a 3270, green-screen manner. Effective, but it had its limitations.

What came next was function provided as part of the Application Server Toolkit, or AST for short. It

was referred to as the “zPMT” … the “z Profile Management Tool.” The zPMT and the WCT share a

common bond in the fact that both are based on Eclipse, which is an application and tooling

framework. That’s what makes tools that use Eclipse appear to be so similar in look and feel.

The issue with the AST-zPMT was that to get just the zPMT required the entire AST, and that had

quite a bit of function beyond what the zPMT was designed to do. The AST has many wonderful

things, but to most who used the zPMT it was never used.

The WCT now takes over, relieving the AST of having to carry the z/OS customization tool. This is

good … it allows the AST return to what it does best, and it allows the WCT to be a much smaller

package.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

6 Version:September 29, 2008

© 2008 IBM Corporation6 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Acquiring the WCT

You have two options for securing a copy of the WCT:

From the product installation DVD/CDs. The WCT is located on the kit number indicated here:

From IBM web page: ibm.com/support/docview.wss?rs=180&uid=swg24020368

Download using “Download Directory” or FTP

The WCT is available from two sources, as indicated in the chart.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

7 Version:September 29, 2008

© 2008 IBM Corporation7 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Supported Platform Operating Systems

At the time of publication of this document, the supported platforms were:

Windows

•Windows XP Professional

•Windows Vista Business

•Windows Server 2003

Linux

•Red Hat Enterprise Linux 4.6

•Red Hat Enterprise Linux 5.1 and higher

Please check back -- this list may grow to include other operating system platforms

The WCT is commonly thought to be “Windows only” but that’s not really the case. It does run on

Windows, but it’s also applicable to Linux. The list above is what was supported at the time this

presentation was built. The list may grow. Check back.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

8 Version:September 29, 2008

© 2008 IBM Corporation8 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Introduction and OverviewWith an emphasis on where the tool keeps the stuff it creates

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

9 Version:September 29, 2008

© 2008 IBM Corporation9 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Eclipse as Framework for Functional Plugins

The WCT is really an Eclipse-based framework. It’s a container for specific functional features. The two features we’ll look at: PMT and MMT.

Eclipse Framework(WCT has a subset, which is why the install image is only

about 160MB in size)

WCT = “WebSphere Customization Tools”

PMTProfile

Management Tool

MMTMigration

Management Tool

Additional features

added as they become available

PMT -- used to generate the customized jobs that create the configuration for a node

MMT -- used to generate the customized jobs that migrate a configuration for a node

They’re each handled as Eclipse “perspectives” if you’re familiar with that term

As mentioned, the WCT is based on Eclipse, which is an open standard framework for applications

and tooling. Eclipse is used because it is designed, by its very nature, to an extensible framework.

What that means is that later, if new function is delivered, it can easily be added to your existing

WCT and work along side the other function that’s already there.

The WCT is being delivered initially with two functions, the PMT and the MMT as we explored a

moment ago. Additional features may be added later as IBM sees the need.

Each function is presented in Eclipse as a “perspective,” which is a term used to mean the display on

the computer screen of the various features related to the function. So the PMT is one “perspective,”

and the MMT is a different “perspective.” If you want to use one tool you switch to that perspective

and the Eclipse framework will bring to the foreground the features that make up that perspective.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

10 Version:September 29, 2008

© 2008 IBM Corporation10 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Installation is Typical for Windows

Very simple and straight-forward:

Initial Splash License System Pre-Req Test

Installation LocationProgress Bar Success

Installation is very easy … the least complex element of this

Installation image found on “WebSphere Customization Tools” CD that comes with product

Let’s establish something before we get too far down the path. The installation of the WCT is really

easy … it’s like the installation of any other workstation tool. For Windows (for example), it’s a

matter of clicking on install.exe and then going through a small number of panels and the program is

installed. It’s truly that easy … the least complex element of the whole thing.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

11 Version:September 29, 2008

© 2008 IBM Corporation11 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The Welcome Page

When you launch the tool you should see the following “Welcome” panel

This little tip is a handy way to navigate to get to a known place in the WCT(You can also launch the PMT or MMT using this approach)

From here you can launch either tool

If for some reason you don’t see this panel, you can easily get to it:

Window ���� Open Perspective ���� Other

That will bring up the panel you see pictured here

Click “OK”

Select “Welcome”

The Welcome panel is one of three “perspectives” that comes with the tool initially. The other two

are the PMT and the MMT. The Welcome perspective should become active when you first start the

tool, and from there you can launch the PMT or MMT.

But just in case you don’t see the Welcome panel, or you simply wish to return to a “known state,”

you can use the tip shown on this chart. In any Eclipse-based tool you can use this technique to go

to any perspective defined to the tool.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

12 Version:September 29, 2008

© 2008 IBM Corporation12 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

WCT Repository -- Locations and Definitions

The WCT maintains a file location where it keeps information about a customization. Let’s explore “Locations” and “Definitions” …

A “Location” is where the customization files are kept. It may be a shared network

drive if you wish.

“Definitions” are specific to the customization task --create a DMGR, federate a node, etc.

“Definitions” are kept inside a “Location.”

Multiple definitions per location is permitted and expected.

The WCT takes input from you as part of its role in creating the customized jobs. Naturally it’s going

to store that input, and other information, somewhere. That somewhere is a “location,” and as the

name implies it’s simply a place on a physical storage device -- a local hard drive, a network drive, a

file system, a network file system, etc. Any physical storage device recognized by the WCT as being

available through the host operating system can be used as a place where the “location” will reside.

You may defined multiple locations. You might do this as a means of maintaining a logical and

physical separation of work you’ve done with the WCT. We’ll see that unfold as we go through this

presentation.

Within a location the various “definitions” are maintained. A “definition” is what the WCT uses to hold

all the pieces of information related to a specific customization you’ve done. So the work you’ve

done to create a Deployment Manager is kept in a definition. If you then defined a Standalone

server customization it would be a separate definition. The definitions are stored within a location.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

13 Version:September 29, 2008

© 2008 IBM Corporation13 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Think of Locations as Logical Groupings of Related Definitions

You could create one location and put every single definition in there. But it might get a bit confusing as the list of definitions gets longer and longer.

As an alternative, consider the following example:

C:\WCT\

\DEV_A_Cell

\DEV_B_Cell

\Test_Cell

\QA_Cell

\Prod_Cell

DMGR

Node

Federate

Standalone

DMGR

Node

Federate

Node

Federate

Cell

Cell

Cell

Backup could be at highest folder or at

lower folders

Group all the definitions for a cell within a

location; organize locations

under a single root folder.

This is just a suggestion … it helps see relationship of definitions to locations

These folders would be the

Locations

Could make location

folders the cell short or long name if you wished

Also makes location locking more granular, as we’ll see in a bit

This is what we mentioned before -- you can think of locations as a way to logically group related

definitions into a single spot. For example, image you had five cells planned -- two development

cells, a test cell, a QA cell, and a big production cell.

You could create on location and put all the definitions related to all those cells in one spot. It might

get somewhat confusing, though.

Better, we believe, to logically group the cells into separate locations. For instance, imaging you

defined your locations as showin the chart. The first development cell might be only a single

standalone server and thus it might have only one definition inside of it. But the production cell at the

bottom might have five definitions inside of it. If you were focused on working on the production cell,

and you didn’t want to be distracted by other things, all you’d have to do is tell the WCT to go to the

production cell location. The WCT would then show only those defiitions.

The usefulness of this is also evident from a backup and restore point of view. If you wanted, you could backup at the C:\WCT level … or backup each individual folder.

Nothing on the chart above should be taken as requirements … they’re all just suggestions;

illustrations of how this might be accomplished.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

14 Version:September 29, 2008

© 2008 IBM Corporation14 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Creating a Location in the WCT

Relatively simple process of indicating the source (existing vs. new) and providing information about drive and folder location:

“Add”

1

2

3

4

Existing -- similar to an “import” function … bring in a location created by someone else.

New -- as it suggests, the initialization of a brand new location

The PMT supports creating V6.1 or V7.0 nodes

The MMT supports V7.0 migrations only

Select feature --PMT or MMT

The creation of a location is done within the WCT tool by clicking on the “Add” button next to the list

of locations. The location may be new (which means the WCT will create the folders or directories)

or an existing WCT location that you’re simply making this copy of the WCT aware of.

Let’s pause and go over that again, but there’s an important distinction there:

• A location is a physical location on a storage device

• That location must be recognized by the copy of the WCT you’re working in

This is easiest to understand when you think about network drives. Someone else might create the

location on the network drive using their copy of the WCT. They tell you about it. You then “add” the

location by telling your copy of the WCT about it. (And yes, network drive locations can be “shared”

… there is a locking mechanism.) Adding an existing location does not create the folders and files, it

merely updates a list within your WCT of the known locations. Adding a location that doesn’t already

exist will create files and folders.

Note: The PMT has separate locations from the MMT. Same concept, you can’t have the same

drive and path as both a PMT location and a MMT location.

Let’s look at the numbered blocks from the picture:

1. Two radio buttons exist -- “Add an existing” or “Create a new customization location”. We just

finished discussing this.

2. The name of the location is just what will show on your copy of the WCT. It’s a way to provide

a meaningful label so when you see the list of locations you can easily understand what’s in it

3. The version pulldown will show either just V7 if it’s the MMT, or V6.1 / V7.0 if the PMT. That

means the PMT is capable of producing customized jobs to create V6.1 runtimes.

4. Finally, the physical location … here’s where you’d specify drive and path (Windows) or path

(Linux)

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

15 Version:September 29, 2008

© 2008 IBM Corporation15 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Locations are Specific to the WCT Feature

The previous chart implied this -- locations are created and initialized by the WCT feature (PMT or MMT) selected at that time.

MMT chosen here

Locations for MMT displayed

Only migration definitions can exist in those locations

PMT chosen here

Locations for PMT displayed

Definitions for PMT only … can’t mix MMT and PMT definitions in the same location

We mentioned this on the previous panel, but this chart helps understand it a bit better.

Locations are specific to the function within the WCT. MMT locations are separate from PMT

locations. In fact, the locations that show in the list will depend on which “perspective” you select.

This makes sense … PMT definitions are something quite different from MMT definitions. If they

were all mixed together things would get confusing. There’s also some “initialization” of a location

that takes place and that initialization is specific to the function. So the location for the PMT has

certain files and settings that are different from what the MMT would use. So again, they’re kept

separate.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

16 Version:September 29, 2008

© 2008 IBM Corporation16 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Locations Maintained on a Shared Network Drive

The tool now has a locking mechanism that prevents two users from accessing the same location:

E:\WCT\

\DEV_A_Cell

\DEV_B_Cell

\Test_Cell

\QA_Cell

\Prod_Cell

User A User B

Location E:\WCT\Test_Cell unlocked when User A closes WCT or selects another

location. But during use it is locked and others can’t access.

User B is free to work with other locations while User A has the one locked. That’s another reason to consider more granular locations like we suggested.

This is something new with the V7 WCT for z/OS … the ability for the tool to “share” locations on a

network drive.

Now we have to be somewhat careful here because by “share” we do not mean concurrently. What

we mean is that a location with definitions can be defined on a network drive that is accessible to

multiple people. What’s new in the V7 WCT is the ability to lock the location so nobody else can use

it while you’re using it. The previous zPMT (in the AST) didn’t have a very good locking mechanism

so we were reluctant to encourage shared network drive locations. It was quite possible to do it, but

back then we urged caution.

Now, however, putting the locations on a shared network drive solves one the issues most often

mentioned by people -- that is, the ability to access definitions when they’re on someone’s personal

computer hard drive. It means zipping and e-mailing and that was inconvenient. Now the locations

can be put out on a shared drive, and there’s a locking mechanism to prevent corruption while one

person is in working on something.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

17 Version:September 29, 2008

© 2008 IBM Corporation17 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Creating a Definition in the WCT

Also a simple process … it’s something created “under” the location you highlight when you create the definition:

First, select the location under which the

definition will reside

“Create”1

2

3

4

The key here is really block #3 -- those are the different types of definition environments that can be created with the PMT (the MMT has different environments)

Block #4 is just a name … it ends up being a folder under the location.

Once a definition is created and selected, then the WCT will display the definitions that are held

within that location. The WCT may have many locations defined to it, but only one is selected at a

time. A location may have multiple definitions within it, but only one can be worked on at a time.

Creating a definition is easy … you click on the “Create” button (for the PMT; the MMT’s button is

labeled “Migrate”) and the tool brings up what kinds of definitions can be created. For instance here

we see the PMT options we saw in larger format earlier.

Let’s walk through the numbered blocks:

1. A location is selected.

2. The “Create” button is clicked

3. The tool brings up the type of definitions you can create … called “environments”

4. The tool then asks for a definition name. This can be any name you want to give it … it will be

what displays on the WCT’s screen when you’re in that perspective. That panel also has a field

for a “response file,” which is a flat file with variable name/value pairs. This is important

because it provides a place to bring into the WCT the variables needed to fully populate a

definition. Where might that response file come from? Well, from someone else perhaps (they

e-mail you a response file from their WCT) or from the “Planning Spreadsheet” we’ll see in a bit

that creates a response file for the WCT.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

18 Version:September 29, 2008

© 2008 IBM Corporation18 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Demystifying the “Location / Definition” Thing

It’s nothing but a set of folders on a hard drive -- local or network -- where the tool maintains its information:

Three definitions under C:\WCT\Test_CellWe’re illustrating a typical ND cell -- DMGR, then a Standalone, and finally the federation

Five locations under C:\WCTSimilar to what we showed earlier.

C:\

Contents of C:\WCT\Test_Cell\T1DMGR

Instruction HTML file

Response File

There’s a lot more file in the location as a whole, but any one definition consists of just those two files

It’s tempting to think of this “location” and “definition” thing as somewhat mysterious. It shouldn’t be

mysterious. Here’s an example of what the WCT created when a handful of locations were created under a common C:\WCT root, and within one location we had a few definitions:

• As you can see, the locations are physically represented as subfolders. By the way, the

“location name” you gave it is not necessarily the folder name. It can be, but it does not have to

be. The location name is simply something displayed in the tool; the actual location path is what

is represented down in the file system.

• Note: incidentally, if you “remove” a location in the WCT tool it does not delete the file system

directories and files. It simply removes knowledge of that physical location from the copy of the

WCT.

• If we drill under the “Test_Cell” folder (one location) we see some subfolders called “lib” and

“log” and then one called “profiles.” It’s under “profiles” that the definitions are found.

• The definition name you provided when you created the definition does become the folder name.

We can see in this example that four custom definitions exist and the “default” one that’s always

there. In this example we see that the definition names were given something like “z/OS short

names,” though the actual definition name you give can be more descriptive than that.

• The contents of the definition folders is very simple -- an instruction file in HTML format, and a

response file, which is that flat name/value pair file we mentioned earlier. We don’t see the

generated jobs or the files that get upload to z/OS. Those are generated on the fly and uploaded

to z/OS.

There are many other files in the location -- template files, Java JAR files, etc. But this shows that

the contents of a definition is pretty straight forward.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

19 Version:September 29, 2008

© 2008 IBM Corporation19 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Locations are Portable -- You can ZIP and Send to Others

If you want to carry a location and its definitions to another computer, you can easily do that. New with V7 WCT -- it can be unzipped anywhere:

C:\Fred\stuff\WCT

The location really “starts” here -- at the folder above “lib,” “logs” and “profiles”

ZIP File

E:\WebSphere\WCT\locations

Or just

copy it

Key point is that the locations and the definitions inside are no longer tied to

the absolute path

Other instances of WCT simply “Add an existing

customization location” and point to this

Locations are portable things … they can be zipped up and sent to someone else if you wish.

Note: definitions are portable on to the extent the response file can be sent to someone. They can

easily reproduce the definition in their WCT by creating their own definition and then using the

response file from you as input.

The older zPMT -- the one based on the AST -- had a limitation in that the location and the files in

the location had the full drive and path embedded in various files. That made the location portable

only as long as where it was “installed” was the exact same drive and path.

But the new WCT is different. It does not have those hard-coded drive/path values embedded in the

location itself. So the location can be zipped up and sent to someone else, and they can unzip it

anywhere they like and it’ll be usable.

Now, here’s where “adding an existing location” comes into play. Just because you unzip a location

into your network E: drive does not mean anyone’s copy of WCT knows anything about it. But their

copies of WCT can be made aware by adding an existing location. The WCT does not try to initialize

the location, it simply “registers it” (for lack of a better term) into that copy of the WCT and it’s then

available.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

20 Version:September 29, 2008

© 2008 IBM Corporation20 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Eclipse “Perspectives” and “Views”

“Perspectives” and “Views” are a way Eclipse-based tools bring to the screen a specific user interface:

Other views represented

in tabs

Perspective:• Think of it as what’s showing on the

screen

• Is really a collection of “views”

• You can close perspectives to clear the screen, and then open other perspectives

View:• A portion of the screen devoted to the

display of specific information

• Multiple views may be active at once

• Views may be tiled or tabbed, or may not be displayed at all

With the WCT you don’t need to be quite as aware of “perspectives” and “views” as you do with other tooling, but they are used by the WCT because it’s based on Eclipse

We’ve already introduced the notion of a “perspective” -- it is a way for Eclipse to show the related

features of a function in a united way on the screen. Within a perspective we have “views” -- those

are like “windows” or “panes” within the perspective. We’ve already seen views -- the list of

locations is one view; the definitions within the selected location is another view. There are tabs that

we’ll see in a bit that represent still more views.

If you’re new to Eclipse this may seem intimidating, but please don’t let it be. We’re lucky … the

WCT is relatively user friendly. Other tools employ far fancier use of views and perspectives and it

can get quite perplexing. But the WCT is nicely designed and relatively easy to navigate.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

21 Version:September 29, 2008

© 2008 IBM Corporation21 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Help! The Layout of My WCT is All Messed Up!

Eclipse allows you to drag-and-drop and resize the views … and it’s easy to get to a state where you don’t recognize it any more.

The “Reset Perspective” function will return it to something more familiar:

Window ���� Reset Perspective

You don’t lose data … it simply

returns the layout of the views to the default settings

Eclipse is wonderfully customizable. So much so it’s possible to get things to a point you can’t find

things any more. The WCT is less prone to that some of the more powerful application development

tools based on Eclipse, but it’s still possible to find yourself not recognizing the layout of the tool.

You can reset to the “factory defaults” so to speak. The chart shows how that is done.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

22 Version:September 29, 2008

© 2008 IBM Corporation22 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Exploring the PMT and the MMT

Let’s now turn our attention to the two features that are included with the WCT from the start -- the PMT and the MMT:

Used to customize the jobs that construct the runtime environment

Used to customize the jobs that migrate a

runtime environment

Features to augment a runtime for additional

functionality

They have specific roles, but each results in the same basic thing -- a

set of customized jobs that are

then uploaded to z/OS to affect the runtime environment

“Perspective” “Perspective”

“Perspective”

Now we’ll drive into the specifics of the two main functions -- the PMT and the MMT.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

23 Version:September 29, 2008

© 2008 IBM Corporation23 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Exploring the PMTProfile Management Tool

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

24 Version:September 29, 2008

© 2008 IBM Corporation24 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The zPMT in Context to the WCT

Here’s our picture from earlier, with the PMT highlighted:

Eclipse Framework(WCT has a subset, which is why the install image is only

about 160MB in size)

WCT = “WebSphere Customization Tools”

PMTProfile

Management Tool

MMTMigration

Management Tool

Additional features

added as they become available

We’ll use this picture to position the PMT against the MMT, all within the context of the WCT which

relies on Eclipse.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

25 Version:September 29, 2008

© 2008 IBM Corporation25 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

PMT is One of the Basic Features of the WCT

Out of the box the WCT includes the PMT and the MMT. More can be added because WCT is extensible, but those two come with the WCT from the start

PMT is a “Perspective” in the WCT toolWhen the perspective is open, it appears as a tab

LocationsSpecific to the PMT. MMT and other features would maintain their own

list of locations.

DefinitionsUnder the selected location.

Action ButtonsThese are used to initiate

actions within the PMT tool

• Create a definition

• Regenerate (modify) a definition

• Delete a definition

• Process (upload to z/OS or export to file system) a definition

As we’ve seem, the Profile Management Tool (the PMT) is one of the two out-of-the-box basic

functions of the WCT. (The Migration Management Tool, MMT, is the other.)

The PMT is a perspective within Eclipse, as is the MMT. They appear as tabs at the top of the

display, and by selecting the tabs you can “switch perspectives” -- go between the PMT and the

MMT.

When you select one or the other, the locations specific to that function are displayed. As we noted

earlier, the PMT and the MMT can not share the same location. Those locations may be kept under a common root, such as C:\WCT or whatever, but a given folder cannot be a PMT location and an

MMT location at the same time.

When a location is selected, the definitions within that location are displayed. Off to the right we see

the action buttons that are supplied with the PMT. There are four -- create, regenerate, delete and

process. We’ll go through and see each one.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

26 Version:September 29, 2008

© 2008 IBM Corporation26 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

V6.1 PMT Environments

Here’s what it will allow you to do when V6.1 is the selected version:

Feature Pack EJB 3.0

Feature Pack Web Services

Familiar “Build a Cell” Tasks

These two Feature Packs are rolled

into V7

As we mentioned earlier, the PMT has two choices for a location’s version value -- V6.1 and V7.0. A

location has to be one or the other but not both. If you selected V6.1, then the “environments” you

can create with the WCT mirror what is possible with the AST/zPMT -- that is, the standard

WebSphere z/OS components, as well as the EJB 3.0 and Web Services feature pack augmentation

features.

What this allows you to do is have one tool for V6.1 and V7.0.

If you want to bring a configuration from the AST/zPMT into WCT, use the response file. Copy the

response file out of the AST/zPMT and then import it into a definition in the WCT. It’ll recreate the

definition in WCT format, with the exact same values you had in the AST/zPMT.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

27 Version:September 29, 2008

© 2008 IBM Corporation27 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

V7 PMT Environments

Here’s what the PMT will help you create when V7 is specified

A Deployment Manager and a federated node in one set of jobs

“Management” has three sub-selections:

• Administrative Agent -- new in V7, it is part of the “Flexible Management” functionality

• Deployment Manager

• Job Manager -- new in V7, also part of “Flexible Management”

A standalone server

An empty federated node

Job to federate a standalone into a DMGR

Admistrative server

for the secure proxy

Secure proxy

server

Some of that is new in Version 7, and some of it is what we learned to do going all the way back to Version 5.0 of the product.

Back then we used the ISPF panels … then the AST/zPMT … now the WCT/PMT

If the location is specified as a V7, then the environments you see here are available to you. The

topic portion is what we had in the AST/zPMT, and some go back into the ISPF dialogs. But there’s

also things new to V7: the Administratve Agent and Job Manager (under “Management”) and the

“Secure Proxy” elements. Let’s see what those are all about next.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

28 Version:September 29, 2008

© 2008 IBM Corporation28 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

New in V7 - The Administrative Agent

Think of the Administrative Agent as an Admin Console that can be switched to manage many different Standalone Server environments:

CR SR

Standalone

CR SR

Standalone

CR SR

Standalone

Daemon CR SR

Cell and Node

Administrative Agent

Admin Console

“Farm” of Standalone

Servers

Test or Development

• Administration is done by direct update of each Standalone’s configuration file system

• Admin Agent may be on same z/OS system or in the same Sysplex if file systems are shared

• Standalone servers are “registered” to the Admin Agent. The Admin Console function of the standalone is then disabled.

• Note that the Admin Agent is itself a kind of Standalone Server

Daemon

Daemon

Daemon

The V7 Administrative Agent is part of the new “Flexible Management” function, which includes this

as well as the Job Manager and the Secure Proxy, all of which we’ll touch on here and the next few

pages.

The Administrative Agent is meant to address the issue some have where many standalone servers

are used for test and development purposes, and having to access each’s Administrative Console

through a different host/port was cumbersome. What the Administrative Agent provides is a single

Administrative Console that can be used to administer multiple standalone servers. Think of it like

one of those computer terminals with the switches that allow the terminal to be switched from

computer to computer.

But convenience is not the whole story here. When you have a farm of standalone servers, each

has the Administrative function loaded up in its JVM, and that takes up cycles and heap. By having

the Administrative Agent act as the administration point, you offload that from each standalone and

the burden falls on a single server instance.

The way the Administrative Agent works is it directly manipulates the configuration XML of each

standalone server registered to it. That’s why the requirement is for the Administrative Agent and

the standalones registered to it to be on the same z/OS system -- so it can have write access to the

configuration file systems of each standalone server. There’s also a degree of communication that

takes place between the Administrative Agent and the standalone so the Administrative Agent can

“see” if applications are running, and if the standalone is in fact up and running.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

29 Version:September 29, 2008

© 2008 IBM Corporation29 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

New in V7 - The Job Manager

The idea is to have a central place to administer the asynchronous submission of WSADMIN “jobs” to multiple locations in your WebSphere environment:

Daemon CR SR

Cell and Node

Job Manager

Admin Console

Managed Standalones

Daemon CR SR

Cell and Node

Administrative Agent

Daemon CR SR

Deployment Manager

Managed Nodes in Cell

Over Network

• Administrative Agents or DMGRs are “registered” to the Job Manager so it knows about them

• Administrative jobs are maintained in repository local to the Job Manager

• You may then “submit the jobs” asynchronously to the targets and:

• Set the job submission to take effect at a specified time.

• Set the job submission to expire at a specified time. • Have the job submission occur at a specified time

interval. • Notify the administrator through e-mail that the job has

completed.

Again, note that the Job Manager is its own cell/node/server structure.

Naming and port planning applies here as well.

The Job Manager is another single management interface intended to support a large and widely

arrayed WebSphere environment. In this case rather than acting as the Administrative Console for

the remote systems, what the Job Manager does is provide the ability to schedule and submit

various tasks to other WebSphere servers -- either an Administrative Agent (managing a farm of

standalones) or a DMGR with its federated nodes.

From the Job Manager you can do things like start and stop servers and submit WSADMIN scripts to

deploy applications. This can be done on a scheduled basis. So we see not only remote

administration, but also a degree of automated and time-managed administration.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

30 Version:September 29, 2008

© 2008 IBM Corporation30 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

New in V7 - The Secure Proxy and Its Administrative Agent

This is designed to be a more “DMZ Friendly” WebSphere Proxy device:

• JRE, not full JDK … can’t compile code in DMZ

• No web container

• Not administered from Admin Console … use separate Admin Agent in DMZ (or local WSADMIN)

• Switches to unpriviledged user after binding to low-order ports

• Static routing (based on XML) or dynamic (requires DCS port kept open)

Daemon CR

Cell and Node

Secure Proxy Server

CR SR

AppServer

CR

Node Agent

CR

Daemon

CR SR

DMGR

CR SR

AppServer

Node

Secure Proxy

ManagerEssentially an “Admin Agent” but specifically for the Secure Proxy

Earlier versions of WebSphere z/OS had proxy servers, but what differentiates this new function is

the ability to be more “DMZ friendly” … by that we mean several things:

• The proxy itself is a Java Runtime Environment (JRE) but not the JDK, so nobody can use it to

compile code in the DMZ. It runs the IBM proxy code, but that’s all it can do.

• There is no web container so no servlets or other harmful code can be run on the platform.

• It has the capability of requiring only the barest minimum ports on the back firewall. This is

because the proxy has two modes -- static (its routing based on XML, much like the Plugin), or

more dynamic … but going dynamic requires that the DCS port be opened.

• Administration of this is not done from the cell’s Administrative Console. It’s done from a special

server called the Secure Proxy Manager, which is essentially like an Administrative Agent except

limited to managing only the Secure Proxy.

What this represents is a further refinement of the Plugin/Proxy evolution that’s been taking place for

several years now.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

31 Version:September 29, 2008

© 2008 IBM Corporation31 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

A Flowchart View of Creating an Environment

There are considerable similarities between the different environments. So let’s take a high-level look at the general flow of the PMT

Definition Name and Response File

Default Values

Target Data Set HLQ

Configuration Group

Configuration Common IDs

System Info and Proclib

Cell, Node and Server

Configuration File System

Product File System

Optional Applications

JCL Procs and Userids

Host and Ports

Daemon Information

SSL Information

Administrative Security

JOB Card

There are slight differences in some of the environments,

but this is the essential flow that is

common

The “Response

File” is important because it ties in with the planning

spreadsheet

Now let’s see what the flow of panels looks like for creating a definition … again, a “definition” being

the customized input that creates one of the supported environments -- a DMGR, or a Standalone, or

a federation, or one of the new flexible management environments.

The flow is as shown in the chart … and much of it is very much like what we’ve seen before with the

ISPF dialogs and the AST/zPMT. It’s a process of working through and supplying all the information

that’s needed to create the environment that has been selected.

As anyone who has done this before knows, the issue is not typing into the panels … the issue is

coming up with all the names and maintaining an effective, consistent naming convention

throughout. That can be done by hand. Or it can be done with a tool that will generate those values

in a response file format that can be brought into the PMT to populate the fields automatically.

One such tool is an Excel spreadsheet … and one is available for your use.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

32 Version:September 29, 2008

© 2008 IBM Corporation32 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The PMT and the Planning Spreadsheet

The spreadsheet provides a way to easily create input variables the PMT uses to populate the fields.

Provide key variables in the “Variables” sheet

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 PMT windows and generate the jobs

See PRS3341 on ibm.com/support/techdocs for V7 spreadsheet

The spreadsheet tool is simply a device used to create a response file in the format used by the

PMT. The key to the spreadsheet is a couple of things:

• It is designed to take just a few key variables from you and from those generate all the other

values

• By doing so, it enforces a consistent naming convention throughout

• Finally, it creates the names for a complete cell … a DMGR, nodes, federation … all with a

consistency of namings and values throughout.

This consistency for a whole cell is known as a “top down” design, and by that we mean one where

all the elements of the cell are considered as a big picture first, then working down the individual

details for each element. That could be done by hand. The spreadsheet simply makes it easier.

For V7 a new set of spreadsheets have been created. One set is for the traditional environments

(DMGR, nodes, federation, etc.), and another for the new Flexible Management things

(Administrative Agent, Job Manager, Secure Proxy, etc.). These can be found on ibm.com/support/techdocs under the number PRS3341.

The key here is really the way the spreadsheet produces a table of variable/value pairs and that can

be copied/pasted into a file that is then brought into the PMT to create the environment.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

33 Version:September 29, 2008

© 2008 IBM Corporation33 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Converting ISPF “SAVECFG” into PMT Response File

You may have some configurations saved from the ISPF panel days that you’d like to use. The tool allows you to download and convert those:

The function is found under:

File ���� Download ISPF Variables …

Fields:

• Source z/OS -- the host name

• Source dataset name -- this must be a **.SAVECFG sequential data set

• User ID and Password

• Port and timeout

• Target -- where you want the PMT-format response file placed on your workstation

• Type -- what environment type you want the created response file to be. Easiest is to set it equal to the SAVECFG type on the host. But it is possible to have the tool convert it to a different environment type.

Purpose is to allow you to re-use existing definition assets

Some of you will have SAVECFG data sets from the old ISPF days, and they may still be of value to

you. The PMT gives you a facility to download those and convert them to PMT-style response files.

The process is pretty straight forward as you can see from the chart.

A few points:

• What this is designed to work with is the **.SAVECFG sequential data sets from the ISPF

customization dialogs of WAS V5.x and V6.x. If you have some definitions on the z/OS system created by the AST/zPMT tool, you can simply download the ZPMT* member from the DATA

target data set.

• The tool is capable of converting one environment type to another -- for example, a DMGR SAVECFG can be converted to a standalone. But be aware that doing that might mean you have

to update or supply some fields in the PMT once you have the response file on your workstation.

When doing this SAVECFG-to-response-file process you should always review with some care

the values you see in the PMT. It’s just a safe precaution to insure you get the configuration you

really want.

• You can put the response file anywhere on your workstation that you want. And the file

extension may be anything you like.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

34 Version:September 29, 2008

© 2008 IBM Corporation34 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Panels Throughout the PMT Customization

Should be things you’re already familiar with from either ISPF or AST/zPMT …the concepts are largely the same as they’ve been since V5.0 days

That said, we’ll point out a few interesting things that are new or worth noting

The panels inside the PMT should look very familiar … they ask for the same kind of information

that’s been required since back in the V5.0 days. There’s been a few new things added along the

way … mostly additional ports required to support additional functions … but in concept and in

essence the panels are the same as we’ve seen before.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

35 Version:September 29, 2008

© 2008 IBM Corporation35 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Vertical Scroll Bars!

It’s easy to overlook the fact that some PMT panels are taller than others, and vertical scroll bars sometimes pop up. Don’t overlook stuff not shown.

Panel prior to this may not

have a scroll bar. Much depends on how the windows

are sized

In this example, there’s another SAF ID to be named

and defined below what’s

shown on the visible panel

Always watch for the vertical scroll bar!(or maximize the window)

The first thing we’ll mention is something fairly mundane, but it’s worth reminding ourselves about.

Some panels may very well introduce a scroll bar because the panel itself extends below the bottom

of the window. The scroll bars come and go, depending on the layout of the panel. The reminder

here is to watch for those scroll bars and to make sure when one appears that you scroll down and

make sure you’re entering all the information asked for. For example, in the bitmap shown above,

there’s another SAF ID field below the bottom of that panel. It’s really easy to overlook these things,

and that would result in an inconsistent value. (Unless you used the spreadsheet, then the fields

would be consistent based on the spreadsheet and the response file it created.)

One strategy to help with this is to maximize the PMT window. That will avoid scroll bar issues.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

36 Version:September 29, 2008

© 2008 IBM Corporation36 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

In V7, 64-bit JVM is Now the Default

Back in V6.1 the default was 31-bit, but now it defaults to 64-bit:

31-bit mode is “deprecated,”meaning while it’s still there and

still supported, it will eventually be retired and removed.

Generally speaking, the switch to 64-bit should be transparent to you.

Exception: if you have JNI code that is not yet written to 64-bit

Be aware of this change in the default

The next thing we’ll point out is that with V7 the default JVM mode is 64-bit. Back in V6.1

WebSphere z/OS introduced the ability to toggle 31-bit or 64-bit, and by default in V6.1 it was 31-bit.

But with V7, the default is 64-bit.

This should be a relatively transparent thing for you. The one concern we’ll highlight is if you have

custom JNI (Java Native Interface) code that has not yet been written to support 64-bit. A 64-bit

JVM calling native code must call a 64-bit native component. That’s just a given. So if you have JNI

code now and it’s calling 31-bit native, you’ll need to recompile the native to 64-bit to use the 64-bit

support of WebSphere z/OS V7.

Or … toggle that value you see here to 31-bit. That will mean the JVM will start in 31-bit mode and

your current JNI code will continue to work as it has in the past.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

37 Version:September 29, 2008

© 2008 IBM Corporation37 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Intermediate Symbolic Links

In V7 PMT there is a facility for automatically creating the intermediate symbolic link between the configuration file system and product file system:

/wasv7config/mycell/mynodea

/wassmpe

/usr/lpp/zWebSphere/V7R0

The concept of using intermediate symbolic links is not new. We’ve

been advocating it since the days of WebSphere z/OS V5

See WP100396 on ibm.com/support/techdocs

What’s new is the automatic creation of the symlink by the BBO*HFSA job

Config File System Product File System

Created inside the node’s configuration file system. Created by BBO*HFSA.

For some time now we’ve advocated the use of “Intermediate Symbolic Links” as a way to provide a

degree of isolation between the node configuration and the product file system. The intermediate

symbolic link is really just an alias point between the configuration file system and the read-only

product file system … it allows a node to be switched over to a new level of product by changing the

alias. It’s proven to be quite effective as allowing sufficient isolation to “roll” maintenance through a cell. See WP100396 on ibm.com/support/techdocs for more on this concept.

The main point here is that for the first time the PMT will capture your desire for intermediate symbolic links and will create them for you. It does this in the BBO*HFSA job, which is run after the

job that allocates and mounts the configuration file system. The intermediate symbolic link is created

inside the node’s configuration HFS or ZFS, which means the intermediate link is nicely associated

with the node, and is subject to backup when the node file system is backed up.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

38 Version:September 29, 2008

© 2008 IBM Corporation38 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The Created Definitions and the “Views” Associated with Definition

When completed, the definitions are listed relative to the location that is selected. Tabs provide different “views” of the selected definition:

Locations

Let’s see what those views provided …

Definitions

Views

When you’ve finished creating the definition, the PMT will bring you back to the main perspective,

and there you’ll see the different “views.” One if the location. As we’ve seen, when you select a

location the tool will display all the definitions associated with it. When a definition is selected, the

tabs highlighted in blue will be populated with information about the selected definition.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

39 Version:September 29, 2008

© 2008 IBM Corporation39 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Views: Summary, Instructions and Response File

These three views are specific to the definition that’s been selected:

Summary Instructions Response File

Instructions -- provide information on preparing the system and submitting the jobs. Instructions also in hlq.CNTL(BBO*INS)

Response file -- can easily be copy/pasted into an e-mail or text file. Also included in the hlq.DATA(PMT*) member.

A definition has three views associated with it:

• Summary -- this provides the key things about a definition … the definition name, the

environment type, the location path, and the z/OS target data sets.

• Instructions -- it’s very important to know of the existence of these instructions. They spell out

the sequence of job submission, the requirements of the ID under which the job runs, and other

pre-submission system programming requirements that are needed. Instructions are not new

with the V7 PMT … instructions have been around since the days of the ISPF dialogs. But for

anyone new to this, please consult the instructions to see what steps are needed to create the

environment. The instructions are uploaded to the target data sets, into the DATA target under the BBO*INS member.

• Response File -- this is the complete response file for the definition. It is available for

copy/paste directly from this view, so if you’re looking for a handy way to send someone the

response file, this would be it. It’s worth noting that the response file is also uploaded to the

target data set.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

40 Version:September 29, 2008

© 2008 IBM Corporation40 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The “Process” Button and What it Does

Two options offered: “Upload” and “Export.” Upload will FTP to the specified z/OS system. Export will put the CNTL/DATA members to external folders.

Upload Export

• Host picked up from node host value, but can be overridden

• Userid/password is whatever allows FTP

• Port and timeout can be set

• Target data sets fixed based on what was specified in the tool

• Allocate data sets on the fly if you wish

• Name the external file location

• Two sub-folders created: \cntl and \data

• Those sub-folders are populated with the same files as would be uploaded to the CNTL and DATA data sets

• You may then transfer to the z/OS system using whatever manual system you prefer

• (Note: must preserve HLQ as set in customization)

Once a definition is complete, the “Process” button is used to act upon the definition. There are two

choices -- upload and export.

Upload performs an FTP of the files to the z/OS operating system. It will allocate the data sets on

the fly if you indicate it should, and will take the generated files from the tool and create members in

the data sets.

Export will put the “members” out to a set of files on a drive accessible by the operating system

running the PMT. It creates subfolders and then places the files that represent the members under

those folders. You then send the files to someone else, or you may upload them manually.

The one key warning we give you is that if you upload manually, the HLQ of the data sets on the

z/OS system must match the HLQ given to the PMT during the creation of the definition. That HLQ

is used in various places in JCL to specify where to get input files. If you were to upload the files into

a different HLQ, many of the jobs would fail.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

41 Version:September 29, 2008

© 2008 IBM Corporation41 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Example of Generated Jobs for Deployment Manager

The jobs and the sequence they’re run is very similar to before, with a few differences:

BBOCCINS

BBOSBRAK

BBODBRAK

BBOSBRAM

BBODCPY1

BBODCFS

BBODHFSA

BBOWWPFD

No more “BRAJ” to create script for “BRAK” to

execute. Combined; one for common groups, one for the node’s security profiles.

HFS or ZFS … your choice (same as V6.1)

CPY1 job brings in JCL procs, which have different format

No more HFSB job … combined into WWPFD

Instruction member … same as before

Message -- very similar to what we saw in V6.1. Some consolidation of jobs and streamlining. But overall very similar to before.

Will automatically create intermediate symlinks based

on setting of option in the WCT

The “Z member” is now combined into the main proc, so now there’s one member rather than two.

Here’s a listing of the jobs that create a Deployment Manager, which we’ll use as an example. The

jobs are similar to what we’ve seen in the past, with a few jobs now removed as some consolidation

has taken place. Bor instance, there’s no more “BRAJ” job that simply created the RACF script.

And the HFSB job is now gone, rolled into the WWPFD job as the last job run.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

42 Version:September 29, 2008

© 2008 IBM Corporation42 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Summary

The PMT is the runtime configuration feature of the WCT:

• One of the included features of WCT

• Will display as a “Perspective” within the WCT

• Has “Locations” and “Definitions”:• Location is a place on a physical storage device

where the tool maintains information about the customizations

• Definition is a specific customization, for example a DMGR, or an application server

• PMT works with spreadsheet• New version of spreadsheet for V7

• Output from PMT is a set of customized jobs and scripts that create the runtime component on the z/OS platform

z/OS Profile Management Tool

Here’s a summary of the PMT. Let’s turn our attention to the MMT.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

43 Version:September 29, 2008

© 2008 IBM Corporation43 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Exploring the MMTMigration Management Tool

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

44 Version:September 29, 2008

© 2008 IBM Corporation44 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The MMT in Context to the WCT

Here’s our picture from earlier, with the MMT highlighted:

Eclipse Framework(WCT has a subset, which is why the install image is only

about 160MB in size)

WCT = “WebSphere Customization Tools”

PMTProfile

Management Tool

MMTMigration

Management Tool

Additional features

added as they become available

The MMT is another one of the basic functions of the WCT. It is used to configure migration jobs.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

45 Version:September 29, 2008

© 2008 IBM Corporation45 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Very Similar to Look-and-Feel of the PMT … Because Eclipse

The appearance “on the glass” is nearly the same as the PMT because both are based on Eclipse, and thus have a common tool framework.

MMT is a “Perspective” in the WCT toolWhen the perspective is open, it appears as a tab

LocationsSpecific to the MMT. Can’t use the same location for MMT and PMT.

DefinitionsUnder the

selected location.Action Buttons

These are used to initiate actions within the PMT tool

• Create a migration definition

• Regenerate (modify) a definition

• Delete a definition

• Process (upload to z/OS or export to file system) a definition

The look and feel of the MMT is very similar to that of the PMT, and that is as expected. Since both

are built on the Eclipse base, they will by design have similar appearances. Going further, the two

look very much alike because they have very similar objectives -- the PMT is used to generate

customized jobs that create the runtime environment; the MMT is used to generate customized jobs

that migrate a runtime environment. They both capture data from you, the user, and generate

customized jobs.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

46 Version:September 29, 2008

© 2008 IBM Corporation46 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Migrating a Cell -- Node by Node Operation, Transform Config

Two key points about migration -- it’s done node-by-node, and what it involves is copying out the existing configuration, transforming it, writing new:

CR SR

AppServer

CR

Node Agent

CR

Daemon

CR SR

DMGR

LPAR A

CR SR

AppServerNode

Cell

Migration Utility(Customization done by MMT)

Migration Utility(Customization done by MMT)

V7.0

V7.0

New configuration file systems, with V7.0 configuration created based on the existing node

configuration used as input

Where the MMT plays a role -- the customization of the migration utility jobs

that perform the migration

Version 5.1, 6.0 or 6.1

Migration is simply the act of taking an existing V5.1, V6.0 or V6.1 node and transforming the

configuration definitions so it creates a V7 equivalent of that environment. It’s a node by node

process. The key here is that the migration does not modify the existing configuration … it copies it

and transforms it while writing it into a new file system.

The MMT is what generates the batch jobs to perform the migration. The batch jobs are more than

just JCL; they are rather complex programs that understand the requirements of V7 and transform

existing configuration elements to the new formats.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

47 Version:September 29, 2008

© 2008 IBM Corporation47 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Details of Migration using MMT Spelled Out in White Paper

A “Migrating to V7.0” white paper has been written by the Washington Systems Center that spells out the field-by-field details of migration

ibm.com/support/techdocs

WP101329

That will be the source of

information on how to use the MMT to perform a migration

This document will give you the overview of it

This “Introduction to WCT” document is not intended to go into all the details of creating the

migration jobs. Another Techdoc will do that. That’s the one shown on this chart.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

48 Version:September 29, 2008

© 2008 IBM Corporation48 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Selecting the Type of Migration to be Customized

Three choices are presented … they are the three types of nodes that exist for Version 5.1, 6.0 and 6.1 (the supported “from” versions):

CR SR

AppServer

CR

Node Agent

CR

Daemon

CR SR

DMGR

CR SR

AppServerNode

CR SR

AppServer

CR

Daemon

Again, node-by-node, so …

• A Standalone server (one node) consists of one MMT definition and one set of generated jobs

• A Network Deployment (ND) cell would consist of one MMT definition for the DMGR and one MMT definition for each of the federated nodes.

The MMT offers three choices for customizing migration jobs -- a DMGR node, a standalone server

node or a federated node. Those are the three basic forms of nodes.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

49 Version:September 29, 2008

© 2008 IBM Corporation49 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

A Flowchart View of Creating a Migration Definition

Somewhat similar to what the PMT uses, but has fewer steps:

Definition Name and Response File

Target Data Set HLQ

System Proclib and V7 Product Location

“To” Configuration File System Allocation and Mount Point Information

“From” Configuration File System Information

Migration Options

JOB Card

Fewer steps than PMT because migration does not involve

creation of a node environment, but the copying/tranforming

(migration) of the node

Similar to PMT in that you have location, definition and the jobs

that are generated by the process

Migration is performed when the jobs are uploaded to z/OS and

executed

The process is like the PMT, but shorter. The reason it is shorter is because customizing the

migration jobs do not require nearly as much information as is required to build an environment in

the first place. At its heart it is a specification of the “from” path and the naming of the “to” location.

There’s a bit more than that, of course, but the “from/to” equation is the heart.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

50 Version:September 29, 2008

© 2008 IBM Corporation50 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The Jobs Created by the MMT

Up to five jobs, but only one is the real “migration” job; others are housekeeping jobs -- allocating file system, copying JCL, etc.:

Optional

Main migration job is the “MG3” job

This is a summary chart of the jobs that are created by the MMT in support of migration. The jobs

are dependent on the type of node being migrated. For instance, the DMGR node does not have the

MG1 and MG2 jobs because the function of those two jobs does not apply to a DMGR node, but they

do to a Federated or Standalone node. Those two jobs are optional in any event, as they are used to

clear XA logs and those are only present if you have XA connectors installed.

The point here is that the jobs are generated based on the type of node migration being defined.

And the last job … the “MG3” job … is the main job that does the migration.

There is another way to perform the MG3 job … by running three smaller jobs in sequence. We see

that next.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

51 Version:September 29, 2008

© 2008 IBM Corporation51 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

More Granular Migration

An alternative is to run three jobs that, when combined, do the same thing as the main MG3 migration job:

BBOW*PRO Creates the product directories and skeleton profile in the target

BBOW*PRE Copies existing configuration into a backup location in temporary space

BBOW*POS Performs the migration

Advantages -- less time for each job, and a more granular failure/recovery/cleanup process

Particularly suited to very large configurations that normally take hours to migrate

The MMT will also generate three other jobs -- PRO, PRE and POS -- that when run in sequence

provide the exact same thing as the MG3 job, but it does it in a more granular fashion. The

advantage to this is duration of any single job, and a more granular cleanup process.

But there’s really no magic to this … the original MG3 was comprised of the 12 steps you see in the

picture above. The three separate jobs is really just a repackaging of that. The separation is not

quite as clean as the picture above suggests, as a few of the early steps are housekeeping chores

and duplicated in the PRO, PRE and POS jobs. But the picture above illustrates the key point of the

one big job (MG3) being split into three smaller jobs.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

52 Version:September 29, 2008

© 2008 IBM Corporation52 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

MMT has Summary, Instructions and Response File as Well

Like the PMT, the MMT has tabbed “views” that provide a summary, instructions and a response file:

Instructions -- provide information on preparing the system and submitting the jobs. Instructions also in hlq.CNTL(BBOM*INS)

Reponse file -- can easily be copy/pasted into an e-mail or text file. Also included in the hlq.DATA(ZMMT*) member.

Summary InstructionsResponse

FileDefinitions

The MMT is like the PMT in that when a migration definition is created the tool will display several

“views” -- summary, instructions and response file.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

53 Version:September 29, 2008

© 2008 IBM Corporation53 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

The “Process” Button -- Just like PMT

Two options: “Upload” and “Export.” Upload will FTP to the specified z/OS system. Export will put the CNTL/DATA members to external folders.

Upload Export

Uploads customization members to z/OS system

Places customization members to the named

external file system

And the MMT’s “Process” button does the exact same thing as the PMT’s process button.

PRS3357 - Introducing the WCT for WebSphere z/OS Version 7

54 Version:September 29, 2008

© 2008 IBM Corporation54 IBM Americas Advanced Technical SupportWashington Systems Center, Gaithersburg, MD

Document Change Activity and Credits

The WebSphere Application Server for z/OS support team at the Washington Systems Center consists of: John Hutchinson, Mike Kearney, Mike Loos, Louis Wilen, Lee-Win Tai, Steve Matulevich, and Don Bagwell.

Mike Cox, Distinguished Engineer, serves as technical consultant and advisor.

Brian Pierce and Dennis MacDonald provide invaluable system programming support to the team.

Many thanks to Harvey McGee, Jeff Mierzejewski, Dana Duffield, Mark Luchini, Alex Guo, and Mickey Scott for their helpful contributions to the content of this document.

Special thanks to John Cowel for his continuing update and support of the “Planning Spreadsheet”

For questions or comments regarding this document, e-mail Don Bagwell at [email protected]

September 26, 2008 Original document

September 29, 2008 Added Techdoc number and corrected incorrect references to what WCT stood for. The acronym is “WebSphere Customization Tools,” not “Configuration”. Also provided URL for download site where the WCT can be acquired.

Change log and credits.

End of Document