websphere application server for z/os version 8 - ibm · websphere application server for z/os...

WebSphere Application Server for z/OS Version 8.5

Overview & Demo

(for BPM:Process Server V8 Workshop ZBPM8)

The WebSphere Application Server on z/OS

CR SR

AppServer

CR

Node Agent

CR

Daemon

CR SR

DMGR

MVS System Image

JCL

MVSWAS

Admin

WebSphere on z/OS is basically a set of MVS address spaces (Started Tasks)●Two Configuration Options:

●Base (stand-alone) AppServer●Network Deployment (ND) Controller Regions are started manually,

with an MVS start command, or using the Integrated Solutions Console (ISC)

Controller Region

Control Region Adjunct (CRA)

JVM

MEs MEs

WLMJCL

WLM starts servants based on workload seen

Parameters provide control over this:

⌧Minimum number of regions

⌧Maximum number of regions

Each Server has several Started tasks:–Controller Region (CR) - protocol entry point: HTTP, HTTPS, IIOP or JMS

–Servant Regions (SR) - this is where the application components run (One or more)

–Control Region Adjunct (CRA) - if SI Buses with Messaging Engines are defined.

Servers can be replicated for workload balancing and high availability

WLM starts CRA if MEs defined

Servant Regions

JVM

Appl Appl

Servant Regions

JVM

Appl Appl

You'll Need to Do Some Planning

There's no avoiding it ... these things require a lot of names, values, ports and such.

Deployment Manager Definitions

WebSphere Application Server home directory:

/wasv8config/b8cell/b8nodea/AppServer

Cell name (short)......: B8CELL

Cell name (long).......: b8cell

Node name (short)......: B8NODEA

Node name (long).......: b8nodea

Server name (short)....: B8SR01A

Server name (long).....: b8sr01a

Cluster transition name: B8SR01

All components have two names

Defined using the ISPF dialogs

Long Name descriptive name

used as directory names

used in Admin Console

Short Nameused as jobname for controllers

used in symbolic links

limited to 7 characters

Naming Scheme: cc|type|n|s

cc = Cell ID

type= sr01 (server #01)

demn (daemon)

dmgr (Deployment mgr)

agnt (Node Agent)

n = System ID (SYSA)

s = Servant or Adjunct

HFS Config root: OMVS.B8CELL.B8NODEA.CONFIG.HFS mounted at /wasv85config/b8cell/b8nodea

Start Command to Start WebSphere Application Server:

s b8acra,jobname=b8sr01a,

env=b8cell.b8nodea.b8sr01a

11/21/13 WAS V8 for z/OS Introduction, Copyright IBM Corp, 2013 4

Reviewing BPM Product History

WAS V.5: WBISF (WebSphere Business Integration Server Foundation) V. 5.1

WAS V.6.1: WebSphere Business Process Management for V.6.1.2

Included WPS, WESB, WBSF/Fabric, and Bus. Monitor)

These products pre-req'd the Feature Packs for XML, SCA, & SDO.

WAS V.7: BPM V7, but many still called it WPS V.7 + WLE (WebSphere Lombardi Edition) V. 7.1 & 7.2

BPM:PS V7.5 ("IBM Business Process Manager Advanced: Process Server") V. 7.5 - Still pre-req'd the Feature Packs for XML, SCA, & SDO.- Dropped the "WebSphere" name. Included WLE - WebSphere Lombardi Edition

WAS V8: BPM:PS V. 8

WAS V8.5: BPM: V. 8.5 (April, 2013)

- Added “Advanced-Only” Configuration.


Reviewing HFS Directories, Roots & Homes

All directory names are user-defined...

here are examples of our servers:

SMP/E installed Product HFS – Read/Only:wassmpe = /shared/zWebSphere/V8R5

Configuration HFSes for each node – Read/Write:

Mount Points (WAS_HOME directories):Dmgr: /wasv8config/b8cell/b8dmnode/DeploymentManager

NodeA: /wasv8config/b8cell/b8nodea/AppServer

profile_roots:<WAS_HOME>/profiles/default

server_home:<profile_home>/config/<cell>/nodes/<node>/servers/<server>

/shared

zWebSphere

/V8R5

/wasv8config

/b8cell/b8nodea

/wasv8config

/b8cell/b8dmnode


The Profile Management Configuration Tool (zPMT)

Is a workstation graphical tool that captures key names, values and input from you and consistently imbeds those values in customized batch jobs.

Spreadsheet …

Hmmm, I’ll supply the following values …

Customized Batch JCL jobs

These get uploaded to z/OS where they’re submitted, one

after another, to create the configuration runtime.

Uploading and running the jobs is the easy part.

The real challenge is coming up with all the names and values and ports the PMT is going to ask for.

Without a plan for those names you’ll very quickly get confused.


Techdoc PRS4944: WAS V8.5 Planning Spreadsheet

An Excel spreadsheet that makes planning values and using the PMT much easier … it helps enforce a disciplined “top down” design:

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

Creating the target Servers

For WAS V8.5, you must use the Profile Management Tool (zPMT)

– part of WebSphere Customization Toolbox (WCT)● Select Version 8.5, ● Create Management, Managed (Custom) node


Wide Screen gives you a better perspective (but smaller font):

Display Filter View Print Options Help

----------------------------------------------------------------------------------------------------------------------------------

SDSF DA SYSB (ALL) PAG 0 CPU/L 4/ 4 LINE 1-8 (8)

COMMAND INPUT ===> SCROLL ===> CSR

PREFIX=B6* DEST=(ALL) OWNER=* SORT=SysName/A JOBNAME/A FILTERS=7 SYSNAME=*

NP JOBNAME JobID SysN CPU% Real Paging SIO CPU-Ti ASIDX SrvClass ECPU% EXCP-Cnt ProcStep StepName RptClass Owner

B8AGNTA STC16345 SYSA 0.04 43T 0.00 0.00 3302.0 00FA OPS_DEF 0.04 20194647 BBOCTL B8AGNTA B8ACRU

B8DEMN STC16344 SYSA 0.00 1183 0.00 0.00 8.51 00E7 SYSSTC 0.00 3620 BBODAEMN B8DEMN B8ACRU

B8DMGR STC16339 SYSA 0.04 63T 0.00 0.00 2768.8 00EE OPS_DEF 0.04 7052176 BBOCTL B8DMGR B8ACRU

B8DMGRS STC16346 SYSA 0.02 141T 0.00 0.00 1360.8 00E5 OPS_DEF 0.04 16632881 BBOSR B8DMGRS B8ASRU

B8SR01A STC18654 SYSA 0.07 109T 0.00 0.00 1610.8 0100 OPS_DEF 0.07 3284531 BBOCTL B8SR01A B8ACRU

B8SR01AA STC18659 SYSA 0.06 113T 0.00 0.00 1893.9 0101 OPS_DEF 0.09 98552606 BBOSR B8SR01AA B8ASRU

B8SR01AS STC18658 SYSA 0.17 132T 0.00 0.00 2642.6 00FC OPS_DEF 0.16 178552549 BBOSR B8SR01AS B8ASRU

B8DEMN STC15550 SYSB 0.00 52T 0.00 0.00 12.48 00D5 SYSSTC 0.00 7049 BBODAEMN B8DEMN B8ACRU

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


----------------------------------------------------------------------------------------------------------------------------------

SDSF OPERLOG DATE 07/07/2009 0 WTORS COLUMNS 02- 133

COMMAND INPUT ===> SCROLL ===> CSR

M 4000000 SYSC 09188 15:51:23.55 STC20599 00000010 +BBOO0278I WEBSPHERE FOR Z/OS MULTI-PRODUCT PTF POST INSTALLER ENDED 201

E 201 00000010 NORMALLY.

N 0020000 SYSC 09188 15:51:23.61 STC20595 00000010 IEF188I PROBLEM PROGRAM ATTRIBUTES ASSIGNED

M 4000000 SYSC 09188 15:51:24.12 STC20595 00000010 BBOO0001I WEBSPHERE FOR Z/OS CONTROL PROCESS 203

E 203 00000010 S1CELL/S1DMNODE/S1DMGR/S1DMGR IS STARTING.

M 4000000 SYSC 09188 15:51:24.14 STC20595 00000010 BBOO0309I CONTROL PROCESS S1CELL/S1DMNODE/S1DMGR/S1DMGR IS EXECUTING 204

E 204 00000010 IN 64-BIT ADDRESSING MODE.

NI0000000 SYSC 09188 15:51:24.20 STC20595 00000210 START S1DEMN,JOBNAME=S1DEMN,ENV=S1CELL.S1CELL.SYSC,REUSASID=YES

M 0080000 SYSC 09188 15:51:24.22 00000010 IRR812I PROFILE S1DEMN*.* (G) IN THE STARTED CLASS WAS USED 206

E 206 00000010 TO START S1DEMN WITH JOBNAME S1DEMN.

N 0200000 SYSC 09188 15:51:24.24 STC20603 00000201 $HASP100 S1DEMN ON STCINRDR

N 0020000 SYSC 09188 15:51:24.27 STC20603 00000210 IEF695I START S1DEMN WITH JOBNAME S1DEMN IS ASSIGNED TO USER S1ACRU

S , GROUP S1CFG

N 4000000 SYSC 09188 15:51:24.27 STC20603 00000010 $HASP373 S1DEMN STARTED

M 4000000 SYSC 09188 15:51:24.55 STC20603 00000010 BBOO0007I WEBSPHERE FOR Z/OS DAEMON S1CELL/S1DMNODE/S1CELL/SYSC IS 210

E 210 00000010 STARTING.

M 4000000 SYSC 09188 15:51:24.56 STC20603 00000010 BBOO0307I DAEMON PROCESS S1CELL/S1DMNODE/S1CELL/SYSC IS EXECUTING IN 211

E 211 00000010 64-BIT ADDRESSING MODE.

Using SDSF


--------------------------------------------------------------------

SDSF DA SYSD (ALL) PAG 0 CPU/L 4/ 4 LINE 1-4

COMMAND INPUT ===> CSR

PREFIX=B8 DEST=(ALL) OWNER=* SORT=SysName/A JOBNAME/A FILTER ON

ACTION=//-Block,=-Repeat,+-Extend,?-JDS,A-Release,C-Cancel,D-Display,

ACTION=E-Restart,H-Hold,K-SysCancel,L-List,P-Purge,Q-Outdesc,R-Reset,

ACTION=S-Browse,W-Spin,X-Print,Y-SysStop,Z-SysForce

NP JOBNAME JobID SysN StepName CPU% Real Paging SIO

B8DEMN STC32707 SYSB B8DEMN 0.00 8193 0.00 0.00

B8SR01A STC32667 SYSB B8SR01A 0.00 78T 0.00 0.00

B8SR01AA STC32710 SYSB B8SR01AA 0.04 120T 0.00 29.55

B8SR01AS STC32711 SYSB B8SR01AS 0.02 190T 0.00 0.00

Monitoring WAS Address Spaces (Started Tasks):Use the DA (display active) command to get a good view of your server address spaces.●Use SDSF commands to 'set display on/off' and 'set action on/off'●Use the 'PREfix' or Filters to limit the rows (Jobnames) displayed. ●Use the 'ARRange' command or pull-down to put interesting columns on the first panel. ●Sort on JobName (instead of JobID or CPU%) to keep the rows from jumping around.

Working in the HFS on z/OS

Telnet ClientsPutty

TeraTerm Pro

ISPFOMVS or =o.4

IShell or =o.3

z/OS UNIX Directory List Utility =3.17

FTP client - WS-FTP

Editing files (in EBCDIC):vi or vim (in telnet sessions)

oedit (in OMVS environment)

Editing ascii files:viascii (in telnet sessions)

oeascii (in OMVS environment)

Converting files to/from ascii or ebcdic:iconv -f IBM-1047 -t ISO8859-1 SIBAPP.ddl > SIBAPP_ascii.ddl

or use my cvtA2E.sh & cvtE2A.sh scripts in /u/user1/wpswork/

- Works with OMVS also!


Looking at logs created in ascii:

Use viascii or a2e (or vi with z/OS 1.13):

viascii wsadmin.traceout

cat wsadmin.traceout | a2e | pg

ISPF 3.17 (with z/OS 1.9)

Convert to EBCDIC:

iconv -f ISO8859-1 -t IBM-1047 wsadmin.traceout > wsadmin.traceout.ebc

Use FTP Client:

Download to your workstation or 'View' in 'Binary' mode.

ISPF 3.17 – Directory List Options

Menu Utilities View Options Help

-------------------------------------------------------------------------------------------

z/OS UNIX Directory List

Command ===>

Pathname . : /wasv8config/b8cell/b8dmnode/DeploymentManager/profiles/default/config/cells/b

Command Filename Message Type Permission Owner Group Size

-------------------------------------------------------------------------------------------

. Dir rwxrwx--- B8ADMIN B8CFG 1024

.. Dir rwxrwx--- B8ADMIN B8CFG 288

adjunct.jvm.options Viewed File rw-rw---- B8ACRU B8CFG 1921

control.jvm.options Edited File rw-rw---- B8ACRU B8CFG 2615

extensionregistry.pr File rwxrwx--- B8ADMIN B8CFG 106

hamanagerservice.xml File rwxrwx--- B8ADMIN B8CFG 627

resources.xml File rwxrwx--- B8ADMIN B8CFG 46123

resources-bpc.xml File rw-rw---- OMVSKERN B8CFG 462

resources-wbi.xml File rw-rw---- OMVSKERN B8CFG 974

servant.jvm.options File rw-rw---- B8ACRU B8CFG 2613

server.xml File rwxrwx--- B8ADMIN B8CFG 27428

server-cei.xml File rwxrwx--- B6ADMIN B6CFG 283

server-core.xml File rw-rw---- OMVSKERN B6CFG 2926

server-pme.xml File rwxrwx--- B6ADMIN B6CFG 878

server-pme51.xml File rwxrwx--- B6ADMIN B6CFG 499

server-wbi.xml File rw-rw---- OMVSKERN B6CFG 2148

trace.dat File rw-rw---- B6ACRU B6CFG 15

variables.xml File rwxrwx--- B6ADMIN B6CFG 901

was.env File rw-rw---- B6ACRU B6CFG 12450

********************************************************* Bottom of data ******************

Line Commands:

E - Edit a file EA - Edit an ASCII file

V - View a file VA - View an ASCII file

B - Browse a file CO - Copy data out

N - Create new entry CI - Copy data in

L - List a directory I - Display attributes

D - Delete an entry R - Rename an entry

MM - Modify mode fields MX - Modify extended attributes

MO - Modify owner MG - Modify group

MF - Modify format X - Execute a z/OS UNIX or TSO com

UA - User auditing AA - Auditor auditing

FS Display file system RA - Refadd to Reflist


UNIX Commands you should know . . .

man - Display online reference manualmkdir - Make a directorymore - Display files on a page-by-page basis mount - Logically mount a file system mv - Rename or move a file or directory nohup - Start a process that is immune to hang upspax - Interchange portable archives ps - Return the status of a process pwd - Return the working directory namer - Process a command history list rm - Remove a file or directory entryset - Set or unset command options and positional paramssh - Invoke a shell su - Change the user ID associated with a session tail - Display the last part of a file touch - Change the file access and modification timesunmount - Remove a file system from the file hierarchyvi - Use the display-oriented interactive text editorwhence - Tell how the shell interprets a command name who - Display information about current users whoami - Display your effective user namezfsadm - manage zFS file systems and aggregates

cat - Concatenate or display text files cd - Change the working directory chgrp - Change the group owner of a file or directory chmod - Change the mode of a file or directory chmount - Change the mount attributes of a file systemchown - Change the owner or group of a file or directorycp - Copy a file date - Display the date and time df - Display the amount of free space in the file systemdiff - Compare two text files and show the differences. (dot) - Run a shell file in the current environment echo - Write arguments to standard outputexit - Return to the shell’s parent process or to TSO/E export - Set a variable for export extattr - Set, reset & display extended attributes for files find - Find a file meeting specified criteria grep - Search a file for a specified patternhead - Display the first part of a filehistory - Display a command history list iconv - Convert characters from one code set to another id - Return the user identitykill - End a process or job, or send it a signal link - Create a hard link to a file ln - Create a link to a file ls - List file and directory names and attributes

Skills for these Labs (we can help you)

MVS TSO Skills:

�ISPF - Edit, Submit jobs, Search, PFKeys, Screen size format (=0)

�SDSF - Control jobs, STCs, Browse Output, Syslog

�MVS Commands

�RACF, WLM, RMF, MXI panels/commands

�WAS Modify (f) command

�ISHELL (o.3) & OSHELL = OMVS (o.4)

�PCOM terminial emulator - Keyboard, translate tables, Screen size (50x133)

UNIX skills:

�basic shell commands

�vi, viascii, awk, grep, a2e, iconv

�shell scripts, jacl, ant scripts

WebSphere skills:

�InfoCenter

�Administrative Console = Integrated Solutions Console (ISC)

�wsadmin.sh

Other tools:�telnet clients: TeraTerm, putty (watch out for backspace key!)

�FTP

�DB2 utility - ADBL, SPUFI

�Arrange your teams so you have a good mix of skills!

�Take advantage of these labs to learn more of these!

Installs with WebSphere & Invoked from a browser, which controls:

Configuration

Application deployment

Operation of servers

Integrated Solutions Console (ISC)

Standard Browserhttp://wg31:8505/ibm/console

http(s)://<host>:<port>/ibm/console

Note: ISC Security Errors with self-signed certificates•These can be safely ignored in these labs. •(In the real world, this error should be taken seriously)


Check option to

“Synchronize

changes with

Nodes”

ISC – Console Preferences

Resources defined at various Scopes


System Information for the Labs


The Lab Environment for this WorkshopJust so you have an understanding of what’s “real” behind the labs

LPAR LPAR LPAR

z/VM Version 5 Release 3.040 guest images, not all running

LPAR: 16 CPs & 104 GB Storage

Team 01

Guest

z/OS 1.12

4.0GB

storage

Team 02

Guest

z/OS 1.12

4.0GB

storage

Team nn

Guest

z/OS 1.12

4.0GB

storage

wg31.washington.ibm.com

HOSTS = xxx.xxx.xxx.201

Team 01

wg31.washington.ibm.com

HOSTS = xxx.xxx.xxx.2nn

Team nn

Key Points:

• Each team has their own z/OS image

• You all use “wg31” as your IP host, but it resolves to the specific guest machine by the workstation “hosts” file.

• We can re-clone your guest machine … be careful but if you break something we can fix it

• Lots of virtualization going on … good environment, but we may see slowdowns. Please understand we’re in a test environment here

IBM 196(Currently 25 LPARs)

Your Lab Environment

VM

Host: wg31.washington.ibm.com

IP: 192.168.17.201

User: USER1

UID0: SYSADM1

Host: wg31.washington.ibm.com

IP: 192.168.17.206

User: USER1

UID0: SYSADM1

TEAM 1 TEAM 6

"Hosts" file

Team 1: 192.168.17.201 wg31.washington.ibm.com wg31


.. .. ..


F

I

R

EWALL

NAT translation

http://wg31:8505/ibm/console Each team has its own MVS system

You have considerable authority (UID=0, RACF Special)

--- be careful!

z/OS systems' host name = wg3n.washington.ibm.com or wg3n... which is resolved to their IP address through a "hosts" file in

c:\windows\system32\drivers\etc\hosts

22© 2012 IBM CorporationIBM Americas Advanced Technical Skills

Washington Systems Center, Gaithersburg, MD

VMWare Desktop

Wide



VMWare Host desktop



Team up with a Lab Partner: - Move to a workstation with a Team # - Pair up with someone with complimentary skills.

(3270, telnet, vi)(Java, RAD workbench)

- See “Basic System Info” behind Lab #2- Logon as USER1- 2nd team member can logon on as USER2- 2nd team member logon to ISC as HUTCH

Note: All Lab documents are on your workstation asPDFs in: ZBPM8 Folder on your workstation desktop

?

Questions?Always ask if it isn't clear!

websphere application server for z/os version 8 - ibm · websphere application server for z/os...

Documents