WTO2Mobile –z/OS Console Messages on your mobile Device

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

WTO2Mobile – z/OS Console Messages on your mobile Device

Harald BenderSoftware EngineerIBM

2© 2015 IBM Corporation

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





WTO2Mobile – z/OS Console messages on your mobile Device

Hmmm... z/OS console messages

on my Yedi phone?

A smart feature this would be...






zEvent Components

– the zEvent Administration Dialog

– the zEvent MPF4REXX Bridge

– the zEvent mobile App

zEvent Administration Dialog

– Settings

– Projects

– Users

– Attributes

– Rules

– Generate REXX API and MPF Parmlib Member

Setup the Environment

– Add MPF Exit to the Linklist and APF Table

– Activate the MPF Parmlib Member

– Append the zEvent REXX Library to the REXXLIB Concatenation

On your Mark – Invocation of the REXX API

– MPF Exit triggers the Notification

– REXX API called by z/OS Component

Context Information for Performance Monitoring

– RMF Data Portal

– z/OSMF Resource Monitoring





WTO2Mobile in a Nutshell

REXX lib

Linklib

generated

zEvent MPF exit

zEvent REXX

MPFLSTxx

IEA404A zEvent exit

message

calls

invokes

notifies notifies

generatedinstalled

The Administration dialog generates the following parts

– REXX procedure

– Stub for MPFLSTxx parmlib member





Download the zEvent host components from the zEvent website to your workstation

Upload both files to your z/OS system with LRECL=80 and RECFM=FB

Install the z/OS Components for zEvent





Now you should have the following two files on your z/OS system

Unpack both files to PDS format:

– receive indataset(zevent.exec.v2r1) this creates the PDS uid.zevent.exec

– receive indataset(zevent.linklib.v2r1) this creates the PDS uid.zevent.linklib

Allocate a new dataset uid.zevent.saxrexec with the same attributes than uid.zevent.exec(this is the dataset for the generated REXX API module)

Install the z/OS Components for zEvent...





The zEvent Administration Dialog

Execute the member DIALOG in uid.zevent.exec

Now we are ready to define:

– Settings

– Projects

– Users

– Attributes

– Rules





The zEvent Administration Dialog: Settings

zEvent uses under the cover the cURL tool for the submission of the notifications

The PORTED TOOLS package for z/OS is already installed in most shops

The cURL path is a required parameter

Just in case the PORTED TOOLS are not installed, you can get it from here:

www.ibm.com/systems/z/os/zos/features/unix/ported/

http://www.ibm.com/systems/z/os/zos/features/unix/ported/





Project Definition

GCM can be used directly

instead of IBM Bluemix

(Android devices only)

Optionally the messages

can be piped through the

z/OSMF notification API

Click <REGISTER> for

Client ID and Secret





User Definition

Paste the Push Token

into the Drop Area





zEvent – Push Server 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 Token Transfer

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





Test Notification with Send to Mobile

Add the Receiver(s)

and click <SEND>





Rules Definition

Specify the provided Attributes

and add the Receivers

I would like to receive

notifications about all security

violations on my z/OS system





Attributes Definition

Determine the Category

and specify the Caption





Create the ZEVENT REXX API & the MPFLSTxx Parmlib Member

Save the ZEVENT EXEC

to your REXXLIB Dataset

Save the MPFLST member

to your PARMLIB Dataset

/*-------------------------------------------------------------------*//* MPFLSTxx ENTRIES FOR ZEVENT *//*-------------------------------------------------------------------*/ICH408I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) RACF INCIDENTIEA404A,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) WTO BUFFER SHORTAGERMF305I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) MSU CONSUMTION ALERT





Add the ZEVENT MPF Exit to LINKLIB and APF Table

/***********************************************************//* SET DYNAMIC LINKLST *//***********************************************************/LNKLST UNDEFINE NAME(ZEVENT) LNKLST DEFINE NAME(ZEVENT) COPYFROM(CURRENT) LNKLST ADD NAME(ZEVENT) DSNAME(BHBE.ZEVENT.LINKLIB) ATTOP LNKLST ACTIVATE NAME(ZEVENT) LNKLST UPDATE,JOB=* /***********************************************************//* SET DYNAMIC APF TABLE *//***********************************************************/APF FORMAT(DYNAMIC) APF ADD DSNAME(BHBE.ZEVENT.LINKLIB) SMS

I could also add the

ZEVENT.LINKLIB to the

LINKLIST and APF Table

permanently

Activate the PROGxx member

with SET PROG=xx

USER.PARMLIB(PROGxx)

Check the Result

in the System Log





Add the MPFLSTxx Entries

I could also add the MPF

Definitions permanently

Activate the MPFLSTxx member

with SET MPF=(00,xx,....)

USER.PARMLIB(MPFLSTxx)

/*-------------------------------------------------------------------*//* MPFLSTxx ENTRIES FOR ZEVENT *//*-------------------------------------------------------------------*/ICH408I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) RACF INCIDENTIRA101E,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) CRITICAL SQA SHORTAGERMF305I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) MSU CONSUMTION ALERT

You should NOT see

any Errors with Regard

to the MPF Exit





Append the zEvent REXX Library to the REXXLIB Concatenation

Restart the AXR Address Space

to activate the zEvent extension

USER.PARMLIB(AXRxx)

/********************************************************************//* AXRZE - The SYSREXX Parmlib Member *//********************************************************************/

CPF('REXX&MVSPID.',SYSPLEX) /* REXXnn Sysplex wide CPF value */AXRUSER(AXRUSER) /* Execution is performed on behalf

this userid */REXXLIB ADD DSN(SYS1.SAXREXEC) /* 1st REXXLIB dataset */REXXLIB ADD DSN(BHBE.ZEVENT.SAXREXEC) /* Extension for zEvent */





Define Access to the REXXLIB Dataset

It depends whether

a ZEVENT userid

is defined or not

permit ‘bhbe.zevent.**‘ id(zevent) acc(read)

permit ‘bhbe.zevent.**‘ id(axruser) acc(read)

/*-------------------------------------------------------------------*//* MPFLSTxx ENTRIES FOR ZEVENT *//*-------------------------------------------------------------------*/ICH408I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) RACF INCIDENTIRA101E,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) CRITICAL SQA SHORTAGERMF305I,SUP(NO),USEREXIT(MPF4REXX),AUTO(ZEVENT) MSU CONSUMTION ALERT

The ZEVENT API is

invoked either on behalf

of the ZEVENT userid or

the userid specified in the

AXR parmlib member

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

/********************************************************************//* AXRZE - The SYSREXX Parmlib Member *//********************************************************************/

CPF('REXX&MVSPID.',SYSPLEX) /* REXXnn Sysplex wide CPF value */AXRUSER(AXRUSER) /* Execution is performed on behalf

this userid */REXXLIB ADD DSN(SYS1.SAXREXEC) /* 1st REXXLIB dataset */REXXLIB ADD DSN(BHBE.ZEVENT.SAXREXEC) /* Extension for zEvent */





On your mark, get set, go!

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





MPF4REXX Messages and Codes

Hmmm...something

seems to go wrong...

All AXREXX Macro

Return and Reason

Codes are described in

the Authorized Assembler

ProgrammingServices

Reference

The AXR address space

is not active

The ZEVENT REXX EXEC was not

found in the REXXLIB concatenation

The ZEVENT REXX encountered a

runtime error

The ZEVENT REXX encountered a

timeout error

RSN = 0C0A can indicate a deadlock situation when

• the message id ICH408I has been specified with

the MPFLSTxx member and

• The ZEVENT or AXR userid has no read access

to the ZEVENT REXXLIB dataset





Rules Definition... I would like to receive notifications whenever

SRM detects a critical SQA storage shortage.

Then i need to indentify instantly the

top SQA consuming address spaces.







Attributes Definition...

Provide Context Information

for instant Analysis









get informed instantly about

common storage constraints

Message IRA101E is displayed

on the console

Alert is sent to

system programmer

Module MPF4REXX calls


SRM detects SQA shortage

System programmer can instantly

detect the top SQA consumers





Launch in Context

RMF Context z/OSMF Context





Rules Definition...I would like to monitor continously the MSU

consumption of all partitions on my entire CEC.

When a certain threshold is exceeded i want to

receive a notification. Then i need to analyze

the MSU consumption in more detail.







Attributes Definition...

Provide Context Information

for instant Analysis







Event Generation – RMF Monitor III Batch

RMFM3B PROC REPORT=CPC, HLQ=

PGM=IKJEFT01

PARM = ERBM3B &HLQ &REPORT

Batch TSO

Initalization

Procedure

Monitor III

Report TypeUserId

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 ERB3RCPC – MSU Limits

/* 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 the

MSU 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

http://www.ibm.com/systems/z/os/zos/bkserv/v2r2pdf/

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





The zEvent REXX API

Type Call Result

minimal zevent msgid (ANY100I)

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)

msgid(IRA101E)

longmsg(“CRITICAL SQA SHORTAGE“)

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





Calling the zEvent REXX API directly

"VGET (erbsid) SHARED“longmsg = pdt.e.1 colon cpcpamsu limitparm = "Origin(RMFM3B) System("erbsid") LongMsg("longmsg")“/************************************************************/ /* Call zEvent REXX API *//************************************************************/address TSO "ex 'BHBE.ZEVENT.SAXREXEC(ZEVENT)' '"parm"'"

ERBR3CPC

$HASP373 BHBEM3B STARTED - INIT 1

IEF403I BHBEM3B - STARTED - TIME=15.15.31



+RMF305I 3B: SYSF : 4 (WTO Limit: 1)









zevent origin(RMFM3B)

system(SYSF)

longmsg(SYSF : 4 (WTO Limit: 1))







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

System programmer can instantly

retrieve additional information





Launch in Context

RMF Context z/OSMF Context






zEvent Components

– the zEvent Administration Dialog

– the zEvent MPF4REXX Bridge

– the zEvent mobile App

zEvent Administration Dialog

– Settings

– Projects

– Users

– Attributes

– Rules

– Generate REXX API and MPF Parmlib Member

Setup the Environment

– Add MPF Exit to the Linklist and APF Table

– Activate the MPF Parmlib Member

– Append the zEvent REXX Library to the REXXLIB Concatenation

On your Mark – Invocation of the REXX API

– MPF Exit triggers the Notification

– REXX API called by z/OS Component

Context Information for Performance Monitoring

– RMF Data Portal

– z/OSMF Resource Monitoring





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 Hands-on Lab

Session z011452

Bring your own Device

and Get Started with IBM zEvent

Friday: 11:30





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

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

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

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

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

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

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





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

mailto:[email protected]

Technology

WTO2Mobile –z/OS Console Messages on your mobile Device