Page 1
© 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
Page 2
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
Page 3
3© 2015 IBM Corporation
3IBM 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.
WTO2Mobile – z/OS Console messages on your mobile Device
Hmmm... z/OS console messages
on my Yedi phone?
A smart feature this would be...
Page 4
4© 2015 IBM Corporation
4IBM 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.
WTO2Mobile – z/OS Console messages on your mobile Device
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
Page 5
5© 2015 IBM Corporation
5IBM 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.
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
Page 6
6© 2015 IBM Corporation
6IBM 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.
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
Page 7
7© 2015 IBM Corporation
7IBM 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.
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...
Page 8
8© 2015 IBM Corporation
8IBM 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 zEvent Administration Dialog
Execute the member DIALOG in uid.zevent.exec
Now we are ready to define:
– Settings
– Projects
– Users
– Attributes
– Rules
Page 9
9© 2015 IBM Corporation
9IBM 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 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/
Page 10
10© 2015 IBM Corporation
10IBM 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.
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
Page 11
11© 2015 IBM Corporation
11IBM 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.
User Definition
Paste the Push Token
into the Drop Area
Page 12
12© 2015 IBM Corporation
12IBM 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.
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
Page 13
13© 2015 IBM Corporation
13IBM 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.
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
Page 14
14© 2015 IBM Corporation
14IBM 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.
Test Notification with Send to Mobile
Add the Receiver(s)
and click <SEND>
Page 15
15© 2015 IBM Corporation
15IBM 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.
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
Page 16
16© 2015 IBM Corporation
16IBM 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.
Attributes Definition
Determine the Category
and specify the Caption
Page 17
17© 2015 IBM Corporation
17IBM 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.
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
Page 18
18© 2015 IBM Corporation
18IBM 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.
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
Page 19
19© 2015 IBM Corporation
19IBM 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.
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
Page 20
20© 2015 IBM Corporation
20IBM 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.
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 */
Page 21
21© 2015 IBM Corporation
21IBM 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.
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 */
Page 22
22© 2015 IBM Corporation
22IBM 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.
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
Page 23
23© 2015 IBM Corporation
23IBM 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.
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
Page 24
24© 2015 IBM Corporation
24IBM 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.
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.
Specify the provided Attributes
and add the Receivers
Page 25
25© 2015 IBM Corporation
25IBM 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.
Attributes Definition...
Provide Context Information
for instant Analysis
Determine the Category
and specify the Caption
Page 26
26© 2015 IBM Corporation
26IBM 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.
On your mark, get set, go!
System programmer wants to
get informed instantly about
common storage constraints
Message IRA101E is displayed
on the console
Alert is sent to
system programmer
Module MPF4REXX calls
zEvent notification API
SRM detects SQA shortage
System programmer can instantly
detect the top SQA consumers
Page 27
27© 2015 IBM Corporation
27IBM 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.
Launch in Context
RMF Context z/OSMF Context
Page 28
28© 2015 IBM Corporation
28IBM 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.
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.
Specify the provided Attributes
and add the Receivers
Page 29
29© 2015 IBM Corporation
29IBM 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.
Attributes Definition...
Provide Context Information
for instant Analysis
Determine the Category
and specify the Caption
Page 30
30© 2015 IBM Corporation
30IBM 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.
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
Page 31
31© 2015 IBM Corporation
31IBM 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.
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
Page 32
32© 2015 IBM Corporation
32IBM 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.
RMF Monitor III Batch – Phase III Samples
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
message which displays
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%.
If yes, issues a console
message which displays
the actual CPU utilization
Depending on the report type various default actions are provided.
All default actions are associated with a console message.
Page 33
33© 2015 IBM Corporation
33IBM 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.
RMF Monitor III Batch – Phase III Samples
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
message which displays
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.
Issues a console message
which displays the actual
values in case the
thresholds are met
ERBR3SYS
Checks whether the total
CPU utilization is higher
than 90%.
If yes, issues a console
message which displays
the actual CPU utilization
Checks the response time
for a specific WLM group
agains a user specified
threshold.
Issues a console message
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
Page 34
34© 2015 IBM Corporation
34IBM 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.
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)
+RMF300I 3B: Processing CPC Report...
+RMF304I 3B: MSU Consumption of critical LPARs:
+RMF305I 3B: P01 : 145 (WTO Limit: 100)
+RMF305I 3B: P02 : 99 (WTO Limit: 80)
+RMF305I 3B: P12 : 11 (WTO Limit: 10)
+RMF300I 3B: Processing CPC Report...
+RMF300I 3B: Processing CPC Report...
+RMF300I 3B: Processing CPC Report...
+RMF304I 3B: MSU Consumption of critical LPARs:
+RMF305I 3B: P12 : 14 (WTO Limit: 10)
Now start the
Monitor III Batch
Reporting Session
ERBM3B
Page 35
35© 2015 IBM Corporation
35IBM 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.
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
Page 36
36© 2015 IBM Corporation
36IBM 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 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
Page 37
37© 2015 IBM Corporation
37IBM 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.
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
+RMF300I 3B: Processing CPC Report...
+RMF304I 3B: MSU Consumption of critical LPARs:
+RMF305I 3B: SYSF : 4 (WTO Limit: 1)
+RMF300I 3B: Processing CPC Report...
+RMF304I 3B: MSU Consumption of critical LPARs:
+RMF305I 3B: SYSF : 8 (WTO Limit: 1)
+RMF300I 3B: Processing CPC Report...
+RMF300I 3B: Processing CPC Report...
+RMF300I 3B: Processing CPC Report...
+RMF304I 3B: MSU Consumption of critical LPARs:
+RMF305I 3B: SYSF : 5 (WTO Limit: 1)
zevent origin(RMFM3B)
system(SYSF)
longmsg(SYSF : 4 (WTO Limit: 1))
Page 38
38© 2015 IBM Corporation
38IBM 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.
On your mark, get set, go!
System programmer wants to
get informed when a threshold
of a certain metric is exceeded
Alert is sent to
system programmer
Performance Monitor calls
zEvent notification API
Threshold is exceeded
Performance Monitor checks
the actual value of the selected
metric(s) continuously
System programmer can instantly
retrieve additional information
Page 39
39© 2015 IBM Corporation
39IBM 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.
Launch in Context
RMF Context z/OSMF Context
Page 40
40© 2015 IBM Corporation
40IBM 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.
WTO2Mobile – z/OS Console messages on your mobile Device
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
Page 41
41© 2015 IBM Corporation
41IBM 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.
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
Page 42
42© 2015 IBM Corporation
42IBM 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.
zEvent Hands-on Lab
Session z011452
Bring your own Device
and Get Started with IBM zEvent
Friday: 11:30
Page 43
43© 2015 IBM Corporation
43IBM 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.
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
Page 44
44© 2015 IBM Corporation
44IBM 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.
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