The zEvent Mobile Application

© Copyright IBM Corporation 2016. Technical University/Symposia materials may not be reproduced in whole or in part without the prior written permission of IBM.

The zEvent Mobile Application

Harald BenderSoftware EngineerIBM

2IBM Systems Technical Events | ibm.com/training/events© Copyright IBM Corporation 2016. Technical University/Symposia materials may

not be reproduced in whole or in part without the prior written permission of IBM.

The following are trademarks of the International Business Machines Corporation in the United States, other countries, or both.

The following are trademarks or registered trademarks of other companies.

* All other products may be trademarks or registered trademarks of their respective companies.

Notes:

Performance is in Internal Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput that any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput improvements equivalent to the performance ratios stated here.

IBM hardware products are manufactured from new parts, or new and serviceable used parts. Regardless, our warranty terms apply.

All customer examples cited or described in this presentation are presented as illustrations of the manner in which some customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics will vary depending on individual customer configurations and conditions.

This publication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without notice. Consult your local IBM business contact for information on the product or services available in your area.

All statements regarding IBM's future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only.

Information about non-IBM products is obtained from the manufacturers of those products or their published announcements. IBM has not tested those products and cannot confirm the performance, compatibility, or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.UNIX is a registered trademark of The Open Group in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency, which is now part of the Office of Government Commerce.

For a complete list of IBM Trademarks, see www.ibm.com/legal/copytrade.shtml:

*, AS/400®, e business(logo)®, DBE, ESCO, eServer, FICON, IBM®, IBM (logo)®, iSeries®, MVS, OS/390®, pSeries®, RS/6000®, S/30, VM/ESA®, VSE/ESA, WebSphere®, xSeries®, z/OS®, zSeries®, z/VM®, System i, System i5, System p, System p5, System x, System z, System z9®, BladeCenter®

Not all common law marks used by IBM are listed on this page. Failure of a mark to appear does not mean that IBM does not use the mark nor does it mean that the product is not actively marketed or is not significant within its relevant market.

Those trademarks followed by ® are registered trademarks of IBM in the United States; all others are trademarks or common law marks of IBM in the United States.

Trademarks




Hmmm...what about critical

events and z/OS performance

monitoring on mobile devices?




� Receive push messages based critical system events

� Access to z/OS performance data from mobile devices

� Single point of control for the enterprise

� Developed with IBM Mobile First Studio

� Available in the app stores for Android and iOS

� Version 3.0 planned for July 2016

� Supported Monitoring Facilities:

– RMF Performance Data Portal

– z/OSMF Resource Monitoring



Content

� Overview

– Basic Idea

– Components and Flow

– Administration

� Using the zEvent App

– Getting Started

– Push Server Setup

– Configuration and Settings

– Inbound Functions

• Events

• Charts

– Outbound Functions

• RMF Performance Data Portal

• z/OSMF Resource Monitoring

• Job Information from SDSF Spool

– Launch in Context

� Event Generation with RMFM3B

� Demo



Idea – Solution and Scenario

1. System Programmer/Administrator: Not at workplace

2. Event happens on mainframe, e.g. Defined Capacity

Limit reached or performance stalls

3. Alert is generated by MPF, CPM, RMF, SA etc… and

send via push notification to mobile phone

4. Solution allows to check back status/additional

information from mobile phone to mainframe

5. Then take action (at workplace) or classify status as

uncritical

� Provide a system programmer with the means

‒ to get immediately notified when an important event occurs

‒ to check major system indicators

‒ to decide whether the event requires immediate attention

� Solution

‒ Mobile app which receives event notifications

‒ z/OS back end to send events and manage participants



zEvent – Components

Mobile App

z/OS Host

Push Services

EventGeneration

UserAdministration

MonitoringProducts

Registration

Admin

Setu

p

Setup

System Administrator

Push Notification

Access toRMF Data Portalz/OSMF RM



zEvent – Components

� Mobile Application

� z/OS host system

� Push server

� zEvent requires three parts

– The mobile application which displays events, charts and allows to access monitoring functions on z/OS

– z/OS host system which provides user administration, a mechanism to recognize and send important events to the push services, and monitoring tools which can be accessed to further analyze system status

– Push services which are open services to deliver notifications to registered end user devices



zEvent – Complete Flow

4. S

end to

Adm

inis

trato

r

1. Setup

5. User Admin

2. Register

3. Client Id

7. S

end

Message

8. Send Notification

Push Server

User Admin

MPF Exit

SysREXX

(Filter)

Calls

Message

6. Generates



zEvent – Complete Flow …

� Encrypted message flow to guarantee

secure message delivery

� One of the most important aspects of zEvent is secure message delivery

– All events and charts can be encrypted on the z/OS host

– The decryption takes place at the mobile devices

– Events and charts which are saved on the mobile device are encrypted by a master password

– Used encryption: AES-128, -192, or -256

� Registration

– Mobile devices connects to push server and retrieves an authentication id

– The authentication is sent to the z/OS (zEvent) system administrator who adds the user to zEvent and assigns it to user groups



Event Generation from WTO

/*-------------------------------------------------------------------*//* MESSAGES FOR ZEVENT *//*-------------------------------------------------------------------*/IEA404A,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) WTO BUFFER SHORTAGERMF305I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) MSU CONSUMTION ALERT

System REXXLibrary Concatenation

Sample Exit Module

Push Server

AXREXX REQUEST=EXECUTE,SYNC=YES,NAME=ZEVENT,REXXARGS=(n)

zevent origin(mpf)

system(mvs1)

msgtype(s)

longmsg(“message text“)



zEvent – The REXX API

Type Call Result

minimal zevent msgid (rmf305i)

origin(db)

category(db)

color(db)

system(rexx: system)

time(rexx: time())

message(db)

longmsg(db)

receiver(db)

userdata(db)

appdata(db)

MPF

zevent origin(mpf)

system(mvs1)

msgtype(s)

longmsg(“this is the long message text“)

maximal

zevent origin(sa)

category(1)

color( #66FF00)

system(mvs1)

time(14:10:00)

message(“short message“)

msgtype(s)

longmsg(“this is the long message text“)

receiver(admins)

userdata({“key1“ : “val1“, “key2“ : “val2“})

appdata({izur": {"dashboard": "Performance Index"}})

zEvent db



zEvent Administration

� The event administration provides the following functions:

– User and Group definition

– Rules definition

– Event attribute definition

� The following parts are generated:

– REXX procedure

– Stub for MPFLSTxx parmlib member

REXX lib

Linklib

generated

zEvent MPF exit

zEvent REXX

MPFLSTxx

IEA404A zEvent exit

message

calls

invokes

notifies notifies

generatedinstalled



� Overview

– Basic Idea


– Administration


– Getting Started




• Events

• Charts







� Live Demo

Content



zEvent App – Startup

Start:

Splash Screen

Events:

Always shown after

Startup

Settings:Show/Hide Tabs

Connect to MonitorsConnect to Push Server



zEvent – Registration

� The first required step is to connect to the push server� Connection information can be provided by a QR code which can also be created by the mobile app� After scanning the QR code, the connection information is filled into the push settings display� Pressing the Connect button sends a message to the push server to retrieve the push token

2

34

1

4



zEvent – Push Server Connection

� Registration is required when the application is installed and used for the first time and after each re-install

� The application checks whether the registration key has changed and if yes it provides a dialog to send the authentication information to the system administrator

� The user can select the email program and the information is visible in JSON format After pressing the SEND button the information is on its way

8

76

6

5



Tabs and Dialogs – Events

For the first time Filled with events Pressing on an event allows to display message details

Pressing on the details shows a pop-up dialog to go to RMF, z/OSMF RM or to delete the events



Tabs and Dialogs – Tab Selection

� The Events tab is the main tab and it is always present

� All other tabs can be configured based on need and functions which should be exploited

– Charts: displays graphical information based on push notifications

– RMF: accesses the RMF data portal to display RMF performance data

– z/OSMF RM: accesses z/OSMF to display RMF performance data

– Jobs: accesses JES spool to display Job related information

� Note:

– The information on RMF and z/OSMF can be redundant and the option is simply provided as a user’s choice



Tabs and Dialogs – Charts

� Charts represent performance information displayed as graphs

– Provide analysis information immediately together with an event without requesting the user to pull the information

� The usage is the same as on the Events tab:

– The incoming chart is signaled as an event

– Clicking on the event displays the chart

– A chart can be manipulated (zooming) or deleted



Charts – The Idea

� Key metrics on the z/OS systems are monitored continuously by the zEvent provider

� The provider maintains a chart document in JSON format

� The values are retrieved for each interval and appended to the chart

� A push message with the chart as payload is sent to the zEvent app

� The App receives the JSON document and visualizes the chart graphically

� The user of the zEvent app is instantly notified and can analyze the metric trend

"charts" : [{

"sys" : "SYS2",

"time" : "17:53:44",

"title" :"CPU Consumption",

"xaxis" : {

"title" : "Time (h)",

"label" : [1,2,3,4,5,6,7,8,9,10,11]

},

"yaxis" : {"title" : "CPU Consumption"},

"series": [{

"title" :"CPU1",

"type" :"Lines",

"color" :"#6656756A",

"values" :[17,22,17,21,4,21,8,5,1,6,21]

},{

"title" :"CPU2",

"type" :"Lines",

"color" :"#66A48E24",

"values" :[24,29,20,15,21,30,6,17,28,18,9]

}],

"usr" : {"Date":"15/04/28","Time":"17:30:00"}

}]



Tabs and Dialogs – RMF & z/OSMF

� RMF and z/OSMF allow the mobile user to logon to the z/OS

system and to obtain additional

information to further analyze a

performance event

� RMF accesses the RMF

performance data portal

� z/OSMF accesses z/OSMF RM



zEvent – RMF Performance Data Portal

� The RMF Performance Data Portal appears on the RMF tab when the following URL is specified with the connection profile: http://hostname:8803/gpm/root.xml

� From the primary screen the user can now navigate to any preferred metric



zEvent – z/OSMF Resource Monitoring

� The z/OSMF Resource Monitoring Dashboard list is displayed on the z/OSMF tab when the following URL is specified with the connection profile: http://hostname:443/zosmf/izur

� The user can now open the preferred Dashboard



zEvent – Job Information from JES Spool

� Display job information for the active z/OSMF connection

� Access to JES spool files via z/OSMF REST API

Initiates filtered request to server

Local filter

Active jobs



zEvent – Job Information from SDSF Spool...

� View job attributes and spool file content



zEvent – Job Information from SDSF Spool...

Retrieve detailed information about

job abend



Tabs and Dialogs – Connections

� In order to access the z/OS system it is necessary to provide

– Label (should match the SMF system name)

– URL for RMF resp. z/OSMF

– Connection type (RMF or z/OSMF)

– Timeout value in milliseconds

– Userid and password



Tabs and Dialogs – Connect

� A connection can be established by the mobile user– Tap the connection entry and then “Connect”

– The mobile device accesses the z/OS system

– If the connection is successful the connection icon turns to green

� A connection can also be established from an event for the system from which the event was sent– Assuming a connection is defined for that system



Launch in Context – RMF DDS Metric



Launch in Context – RMF Monitor III Report



Launch in Context – RMF Postprocessor Report



Launch in Context – z/OSMF Dashboard



Launch in Context – Job Information



� Overview

– Basic Idea


– Administration


– Getting Started




• Events

• Charts







� Live Demo

Content



Event Generation – RMF Monitor III Batch

RMFM3B PROC REPORT=CPC, HLQ=

PGM=IKJEFT01

PARM = ERBM3B &HLQ &REPORT

Batch TSO

InitalizationProcedure

Monitor IIIReport Type

UserId

HardcopyMonitor III

Main ModuleGO Mode



RMF Monitor III Batch – Phase III Samples

Depending on the report type the generic exit module ERB3RPH3 passes control to the RMF supplied specific report exit modules

ERB3RPH3

ERBR3WFX ERBR3SYS ERBR3CPC

//SYSPROC DD DISP=SHR,DSN=&HLQ..RMFM3B.SERBCLS

// DD DISP=SHR,DSN=&RMF..SERBCLS

// DD DISP=SHR,DSN=&ISPF..SISPEXEC

// DD DISP=SHR,DSN=&ISPF..SISPCLIB

RMFM3B PROC RMF=SYS1,ISPF=SYS1

Use this library for modifications

of the RMF supplied procedures




And what the hell does now the specific report exit

for me?

ERBR3CPC

Checks whether WLM

initiated capping (softcap)

is currently active.

If yes, issues a console

message which displays

the current capping %.

If no, issues a console


the remaining time until

potential softcap starts

ERBR3WFX

Counts the number of

exception lines from the

WFEX report and issues

a console message which

displays the number of

exceptions

ERBR3SYS

Checks whether the total

CPU utilization is higher

than 90%.



the actual CPU utilization

Depending on the report type various default actions are provided.All default actions are associated with a console message.




ERBR3CPC

Checks whether WLM

initiated capping (softcap)

is currently active.



the current capping %.

If no, issues a console


the remaining time until

potential softcap starts

Checks the MSU

consumption of all LPARs

against a user specified

threshold.

Issues a console message

with the actual MSU

consumption for the

LPARs that are exceeding

the limit

n/a

ERBR3WFX

Counts the number of

exception lines from the

WFEX report and issues

a console message which

displays the number of

exceptions

Routes all exception lines

from the WFEX report

unchanged to the console

Checks the system wide

CPU utilization as well as

the ECSA usage against

user specified thresholds.


which displays the actual

values in case the

thresholds are met

ERBR3SYS

Checks whether the total

CPU utilization is higher

than 90%.



the actual CPU utilization

Checks the response time

for a specific WLM group

agains a user specified

threshold.


which displays the actual

response time in case the

threshold is met

n/a

This action

performs a scan of the report table

header

This action performs a scan through all report

table rows



Example ERB3RSYS – Action 1

I would like to see

a console message if one of my LPAR‘s exceeds a certain

MSU limit

/* Partition Data Entry fields ***************************************/

/* */

/* pdt.0.1: Partition names */

/* pdt.0.2: MSU Limits for WTO */

/* */

/*********************************************************************/

pdt.0.1 = "MVS1 MVS2 MVS3 MVS4" /* <== adjust partition names */

pdt.0.2 = "00010 00010 00010 00010" /* <== and the MSU limits */

filter = 0 /* <== set to 1 for filtering */

lparnum = 0

"TBQUERY" tabnam "ROWNUM(lparnum)"

ERBR3CPC

/* Partition Data Entry fields ***************************************/

/* */

/* pdt.0.1: Partition names */

/* pdt.0.2: MSU Limits for WTO */

/* */

/*********************************************************************/

pdt.0.1 = "P01 P02 P11 P12" /* <== adjust partition names */

pdt.0.2 = "00100 00080 00040 00010" /* <== and the MSU limits */

filter = 1 /* <== set to 1 for filtering */

lparnum = 0

"TBQUERY" tabnam "ROWNUM(lparnum)"

Adjust the partition names

and theMSU limits

$HASP373 BHBEM3B STARTED - INIT 1

IEF403I BHBEM3B - STARTED - TIME=15.15.31

+RMF300I 3B: Processing CPC Report...

+RMF304I 3B: MSU Consumption of critical LPARs:

+RMF305I 3B: P01 : 172 (WTO Limit: 100)

+RMF305I 3B: P02 : 124 (WTO Limit: 80)



+RMF305I 3B: P01 : 145 (WTO Limit: 100)

+RMF305I 3B: P02 : 99 (WTO Limit: 80)

+RMF305I 3B: P12 : 11 (WTO Limit: 10)





+RMF305I 3B: P12 : 14 (WTO Limit: 10)

Now start the Monitor III Batch

Reporting Session ERBM3B



RMF Monitor III Batch – References

www.ibm.com/systems/z/os/zos/bkserv/v2r2pdf/#ERB

RMF Users Guide, Chapter 21. Client Server Enabling

ftp://public.dhe.ibm.com/eserver/zseries/zos/rmf/RMF2WTO.pdf



� Overview

– Basic Idea


– Administration


– Getting started




• Events

• Charts







� Demo

Content



Example 1 – RACF Security Violation

System programmer wants to

get informed instantly about security violations

Incident causes RACF console

message ICH408I

Alert is sent to system programmer

Module MPF4REXX calls zEvent notification API

Unauthorized user tries to read

the dataset of another user



Example 2 – SRM Constraint

System programmer wants to get informed instantly about

SRM Constraints

Alert is sent to

system programmer

System programmer can instantly retrieve additional information

Incident causes SRM console

message IRA420I

Module MPF4REXX calls

zEvent notification API

System detects extraordinary

high demand for storage



Example 3 – Job Abend

System programmer wants to get informed instantly about

abnormal job termination

Alert is sent to

system programmer


Incident causes XWTR console

message IEF450I

Module MPF4REXX calls


User job terminates with

operation exception (S0C1)



Example 4 – MSU Consumption

System programmer wants to get informed when a threshold

of a certain metric is exceeded

Alert is sent to

system programmer

Performance Monitor calls


Threshold is exceeded

Performance Monitor checks

the actual value of the selected

metric(s) continuously




The zEvent Mobile Application – Summary

� Receive push messages based critical system events

� Instant access to z/OS performance data from mobile devices

� Single point of control for the enterprise

� Launch in context provides additional value

� Quick entry to monitoring facilities through automated login

� Representation of the data is well suited for mobile devices

– RMF Performance Data Portal with individual metric views

– z/OSMF Resource Monitoring Dashboards are arranged vertically



zEvent & z/OS Console Messages

Session z011452

Bring your own Deviceand Get Started with IBM zEvent

Friday: 11:30

Session z011450

WTO2Mobilez/OS Console Messages on your mobile Device

Thursday: 15:00



zEvent References

http://www.ibm.com/systems/z/os/zos/features/zevent/zevent.html

zEvent Website

http://www.ibm.com/systems/z/os/zos/features/zevent/zevent_resources.html#UsersGuide

zEvent Users Guide

http://www.ibm.com/systems/z/os/zos/features/zevent/zevent_resources.html#AdminGuide

zEvent Administration Guide

http://www.ibm.com/systems/z/os/zos/features/zevent/zevent_resources.html#HostFiles

zEvent Host Files

http://www.ibm.com/systems/z/os/zos/features/zevent/zevent_resources.html#MON3B

zEvent Monitor III Batch Tool

https://play.google.com/store/apps/details?id=com.ibm.systems.zevent

zEvent App for Android

https://itunes.apple.com/us/app/ibm-zevent/id1045034762

zEvent App for iOS



Continue growing your IBM skills

ibm.com/training

provides a comprehensive portfolio of skills and career accelerators that are designed to meet all your training needs.

If you can’t find the training that is right for you with our

Global Training Providers, we can help.

Contact IBM Training at [email protected]

Global Skills Initiative

Date post:	15-Apr-2017
Category:	Technology
Upload:	marna-walle
View:	242 times
Download:	0 times

The zEvent Mobile Application

Technology