Embed Size (px)
Citation preview
wwwepvtechcom
EPV Technologies
EPV Real Time CICS
Installation and Customization
Supporting
EPV zParser V15
November 2021
IT Cost
Under Control
EPV Real Time - 2 -
EPV Technologies
All the mentioned trademarks belong to their respective companies
EPV Technologies contact details
EPV Technologies
Viale Angelico 54
00195 Roma
Tel 06 86210880
Fax 06 86387461
E-mail epvtechepvtechcom
WEB httpwwwepvtechcom
Installation and Customization - 3 -
EPV Technologies
Contents
1 Introduction - 5 - 2 Architecture - 6 - 3 Exception Thresholds - 7 -
31 Statistical Thresholds - 7 - 32 User Thresholds - 7 -
4 Pre-requisites - 8 - 5 Installation - 9 - 6 Customization - 10 -
7 Dashboard - 12 - 8 Customer support - 15 -
Related documentation - 16 -
EPV Real Time - 4 -
EPV Technologies
About this manual
This manual is intended to help anyone who wants to use EPV Real Time CICS to identify abnormal
CICS transactions on the fly
Terminology
The string $EPVROOT used in this manual represents the path to your EPV installation folder
The string $ProfileName represents the name of your EPV User Profile
Installation and Customization - 5 -
EPV Technologies
1 Introduction
EPV Real Time CICS is a component of the EPV Real Time product suite Its goal is to identify CICS
transactions exceptions by combining statistical principles and user settings It is composed by three
components
bull EPV Real Time Thresholds to analyse CICS data and create the thresholds where a transaction
needs to be classified as exception
bull EPV Real Time User Exit to provide a filtering mechanism that is applied to incoming data
bull EPV Real Time Web App a web dashboard that is constantly updated to show the current
exceptions and analyze them
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 2 -
EPV Technologies
All the mentioned trademarks belong to their respective companies
EPV Technologies contact details
EPV Technologies
Viale Angelico 54
00195 Roma
Tel 06 86210880
Fax 06 86387461
E-mail epvtechepvtechcom
WEB httpwwwepvtechcom
Installation and Customization - 3 -
EPV Technologies
Contents
1 Introduction - 5 - 2 Architecture - 6 - 3 Exception Thresholds - 7 -
31 Statistical Thresholds - 7 - 32 User Thresholds - 7 -
4 Pre-requisites - 8 - 5 Installation - 9 - 6 Customization - 10 -
7 Dashboard - 12 - 8 Customer support - 15 -
Related documentation - 16 -
EPV Real Time - 4 -
EPV Technologies
About this manual
This manual is intended to help anyone who wants to use EPV Real Time CICS to identify abnormal
CICS transactions on the fly
Terminology
The string $EPVROOT used in this manual represents the path to your EPV installation folder
The string $ProfileName represents the name of your EPV User Profile
Installation and Customization - 5 -
EPV Technologies
1 Introduction
EPV Real Time CICS is a component of the EPV Real Time product suite Its goal is to identify CICS
transactions exceptions by combining statistical principles and user settings It is composed by three
components
bull EPV Real Time Thresholds to analyse CICS data and create the thresholds where a transaction
needs to be classified as exception
bull EPV Real Time User Exit to provide a filtering mechanism that is applied to incoming data
bull EPV Real Time Web App a web dashboard that is constantly updated to show the current
exceptions and analyze them
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 3 -
EPV Technologies
Contents
1 Introduction - 5 - 2 Architecture - 6 - 3 Exception Thresholds - 7 -
31 Statistical Thresholds - 7 - 32 User Thresholds - 7 -
4 Pre-requisites - 8 - 5 Installation - 9 - 6 Customization - 10 -
7 Dashboard - 12 - 8 Customer support - 15 -
Related documentation - 16 -
EPV Real Time - 4 -
EPV Technologies
About this manual
This manual is intended to help anyone who wants to use EPV Real Time CICS to identify abnormal
CICS transactions on the fly
Terminology
The string $EPVROOT used in this manual represents the path to your EPV installation folder
The string $ProfileName represents the name of your EPV User Profile
Installation and Customization - 5 -
EPV Technologies
1 Introduction
EPV Real Time CICS is a component of the EPV Real Time product suite Its goal is to identify CICS
transactions exceptions by combining statistical principles and user settings It is composed by three
components
bull EPV Real Time Thresholds to analyse CICS data and create the thresholds where a transaction
needs to be classified as exception
bull EPV Real Time User Exit to provide a filtering mechanism that is applied to incoming data
bull EPV Real Time Web App a web dashboard that is constantly updated to show the current
exceptions and analyze them
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 4 -
EPV Technologies
About this manual
This manual is intended to help anyone who wants to use EPV Real Time CICS to identify abnormal
CICS transactions on the fly
Terminology
The string $EPVROOT used in this manual represents the path to your EPV installation folder
The string $ProfileName represents the name of your EPV User Profile
Installation and Customization - 5 -
EPV Technologies
1 Introduction
EPV Real Time CICS is a component of the EPV Real Time product suite Its goal is to identify CICS
transactions exceptions by combining statistical principles and user settings It is composed by three
components
bull EPV Real Time Thresholds to analyse CICS data and create the thresholds where a transaction
needs to be classified as exception
bull EPV Real Time User Exit to provide a filtering mechanism that is applied to incoming data
bull EPV Real Time Web App a web dashboard that is constantly updated to show the current
exceptions and analyze them
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 5 -
EPV Technologies
1 Introduction
EPV Real Time CICS is a component of the EPV Real Time product suite Its goal is to identify CICS
transactions exceptions by combining statistical principles and user settings It is composed by three
components
bull EPV Real Time Thresholds to analyse CICS data and create the thresholds where a transaction
needs to be classified as exception
bull EPV Real Time User Exit to provide a filtering mechanism that is applied to incoming data
bull EPV Real Time Web App a web dashboard that is constantly updated to show the current
exceptions and analyze them
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 6 -
EPV Technologies
2 Architecture
When SMF data read by EPV Real Time Agent is inserted in the EPV Real Time Databases it is also
checked to identify CICS transaction exceptions If a transaction exceeds a CPU or elapsed time
threshold it is also inserted in the EPV Real Time CICS database
This data is then immediately visualized in the web dashboard that is always connected to the database
Figure 1
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 7 -
EPV Technologies
3 Exception Thresholds
As explained in the previous chapter of this manual SMF 110 subtype 1 data is filtered at read time to
discover abnormal CICS transactions
The filtering mechanism is applied to the CPUTIME and the ELAPSED fields It is composed of two
types of thresholds statistical and user
By default transactions with CPUTIME or ELAPSED that exceed the statistical threshold are considered
exceptions
If a user threshold is customized for a specific transaction it is used instead of the statistical threshold
31 Statistical Thresholds
This kind of threshold is automatically calculated by EPVRealTimeThresholds (an EPV Real Time
program) on a daily basis
These thresholds are built by processing SMF data of one or more representative days
The default source for this analysis is the EPV Real Time database but you can use the EPV zParser
database instead of it (check $RT_ThresholdSource from the Customization Chapter)
Before starting the analysis we perform a preliminary step where we get the transactions frequency
per second During this step the users can exclude transactions that have only a few occurrences with
$RT_FrequencyThreshold which by default is set to 10
During this step users can also exclude or include specific regions and transactions (check the
Customization Chapter for further details)
At the end of the process you can find the results of the analysis in the thresholds table of the EPV
Real Time CICS database
32 User Thresholds
Together with the Statistical Thresholds the possibility to define User Threshold for both CPUTIME
and ELAPSED is provided These kind of threshold can be customized for each transaction
To start using them you need to customise the RTCICS_TRAN_THRESHOLDPL User Exit you
can find in $EPVROOTUSERPROFILE$ProfileNameEPVREALTIMESMFUSEREXIT
This file is allocated by EPV Control Center during the User Profile creation and by default it only
contains a dummy customization
Please follow the example provided inside the User Exit to properly customize the
$RT_ValueThresholdTran variable
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 8 -
EPV Technologies
4 Pre-requisites
bull EPV Real Time
bull EPV Control Center
bull EPV Hub
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 9 -
EPV Technologies
5 Installation
EPV RealTime CICS is distributed inside EPV Real Time this means that to start using it you just need
to ask EPV for a valid license
With that said the only action required is to copy the LICENSE_EPVREALTIME_DASHBOARDEPV
file provided by EPV in the $EPVROOTPASSWORD folder
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 10 -
EPV Technologies
6 Customization
To start customizing EPV Real Time CICS you need to start the EPV application server located in the
$EPVROOTSERVER folder
Once the server is running and listening on the choosen port you need to navigate to httplocalhostport
or httpyourIPport with your browser enter the credentials or register your user through the EPV Hub
platform to be authenticated and validated to access the EPV Real Time web application
In order to customize the EPV Real Time CICS parameters you need to access the EPV Control Center
and click on the EPV Real Time product card
You need to select the General tab and write the RTC string in the EPV Products Integration section
in the User Apps List field (Figure 2) Once done press SAVE CONFIG
Figure 2
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 11 -
EPV Technologies
By selecting the Real Time Config tab you can access the following screen which allows to set the Real
Time CICS parameters
Figure 3
This is the list and the description of the configuration parameters that you can also find in
$EPVROOTUSERPROFILE$ProfileNameEPVREALTIMECONFIGPL
bull $EPVDBS-gtRT_CICS Real Time CICS database
bull $RT_InclRegList List of included CICS regions
bull $RT_ExclRegList List of excluded CICS regions
bull $RT_InclTranList List of included CICS transactions
bull $RT_ExclTranList List of excluded CICS transactions
bull $RT_ThresholdSource Source of the thresholds algorithm EPV Real Time database or EPV
zParser database
bull $RT_FrequencyThreshold Exceptions threshold on transaction frequency
bull $OnlyRealTimeCICS Avoid loading SMF110_1 data in the EPV110_1_TrxAcct table
Note make sure to create the EPV Real Time CICS database after you finished customizing the
parameters
If you dont mind losing data in your EPV Real Time databases then you can run
EPVRealTimeConfigDBUpdater_RestoreDefaultshBAT located in your
$EPVROOTUSERPROFILE$PROFILEEPVREALTIMEPROCS
Otherwise you can create the database manually
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 12 -
EPV Technologies
7 Dashboard
To enter the EPV Real Time Web App you need to navigate to httplocalhostport or httpyourIPport
with your browser login to EPV Hub and select the EPV Real Time CICS App
Figure 4
Then before accessing the dashboard you need to select your EPV User Profile in which you customized
the EPV Real Time product
Figure 5
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 13 -
EPV Technologies
After activating a profile you need to enter in the CICS Dashboard from the sidebar menu on the left
Figure 6
We used this part of the dashboard to monitor the incoming exceptions From the main linear graph you
can see the Elapsed Exceptions represented in blue the green line instead for the CPUTIME ones
The latest exception is always highlighted in red and it is positioned at the top of the table as soon as it
arrives By clicking on the dots we can check what transactions were identified as exceptions and access
a more detailed view of them
Figure 7
From this table (Figure 7) we can check the Region the Transaction the Start and End Date Time the
Elapsed time the CPUTIME the Dispatch and the Suspend Time
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 14 -
EPV Technologies
From the dashboard main view (Figure 8) you can see at the bottom doughnut graphs to check which
CICS regions and transactions were producing the highest amount of exceptions By clicking on a
specific area you can enter the detailed table view mentioned before
Figure 8
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
Installation and Customization - 15 -
EPV Technologies
8 Customer support
For any technical problem with or question about EPV Products please write an e-mail to
epvsupportepvtechcom
For any other issue about EPV products please write an e-mail to
epvinfoepvtechcom
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
EPV Real Time - 16 -
EPV Technologies
Related documentation
The following manuals complement the information provided in this manual
bull EPV zParser V15 Installation and Customization
bull EPV Real Time V15 Installation and Customization
