User’s Guide

zpcr@us.ibm.com

Alex Patterson Shawn Lundvall Valerie Spencer

Table of Contents

Introduction ..................................................................................................... 4

Getting Started ............................................................................................... 5

Input Data Gathering ...................................................................................... 7

CP3KEXTR JCL for zBNA .......................................................................................................................... 7

Support for Large DAT Files ..................................................................................................................... 8

File Menu ........................................................................................................ 9

Load Files .................................................................................................................................................... 9 Load a zBNA file ...............................................................................................................................................10

zBNA Initial Panel ......................................................................................... 11

Job Step Details Panel ............................................................................................................................. 13 Life of a Program ..............................................................................................................................................13

Key Batch Jobs ........................................................................................................................................ 14

Top Programs ........................................................................................................................................... 15 Load a SMF70 and z/OS SMF File ..................................................................................................................15

Save As zBNA Study File ........................................................................................................................ 17

Save untersed file as DAT file ................................................................................................................. 17

Save as CSV .............................................................................................................................................. 18

Edit Menu ..................................................................................................... 20

Find ............................................................................................................................................................ 20

Select Columns ........................................................................................................................................ 21

Filters Menu .................................................................................................. 22

Set Filters .................................................................................................................................................. 23

Action Menu ................................................................................................. 25

Set Alternate CPUs .................................................................................................................................. 25 LPAR Definitions Table....................................................................................................................................26 Capping ..............................................................................................................................................................26 Absolute Capping ..............................................................................................................................................26 SMT Benefit .......................................................................................................................................................27

Flag Transition Jobs ................................................................................................................................ 28

Job Data Set Report ................................................................................................................................. 29 Life of a Data Set ...............................................................................................................................................30

Display Graph ........................................................................................................................................... 31 Gantt Chart Color Scheme ...............................................................................................................................31

GCP Utilization ......................................................................................................................................... 32

MSU Rolling 4-Hour Average .................................................................................................................. 32

Set Intensity Percent ................................................................................................................................ 34

Reports Menu ............................................................................................... 35

Applications Menu ........................................................................................ 36

Top Data Sets Input Window ................................................................................................................... 36

zEDC Compression .................................................................................................................................. 38 zEDC Show Top DSNs ......................................................................................................................................39

Understanding the Table of Eligible Data Sets for Compression ...............................................40 zEDC Data Set Analysis ....................................................................................................................................45 zEDC Top Data Sets Graphs ............................................................................................................................46

Estimated zEDC Cards Graph ..............................................................................................................46 Estimated zEDC CPU Savings Graph ................................................................................................47 Estimated zEDC MIPS Graph ...............................................................................................................48 Estimated zEDC MSU Graph ................................................................................................................49 Estimated zEDC IO Count Graph ........................................................................................................50 Data Set Gigabytes per Hour Graph ...................................................................................................51

zEDC Graph Report .........................................................................................................................................52

Encryption ................................................................................................................................................. 54 Data Set Encryption ..........................................................................................................................................54

Description of the Data Set Types ......................................................................................................55 Understanding the Table for Data Sets that Meet the DFSMS Eligibility Criteria ...................55 Estimated Data Set Encryption CPU Cost Graph ...........................................................................56 Estimated Data Set Encryption MIPS Graph ....................................................................................57 Estimated Data Set Encryption MSU Graph .....................................................................................58 Estimated Data Set Encryption Gigabytes per Hour Graph .........................................................59 Estimated Data Set Encryption IO Rate Graph ................................................................................60

Coupling Facility Encryption ...........................................................................................................................61 Understanding the Table of Eligible Coupling Facility Structures .............................................61 Estimated CF Encryption CPU Cost Graph ......................................................................................62 Estimated CF Encryption MIPS Graph ...............................................................................................63 Estimated CF Encryption MSU Graph ...............................................................................................64 Estimated CF Encryption Gigabytes per Hour Graph ...................................................................65

zHyperLink ................................................................................................................................................ 66 Understanding the Table for Data Set Candidates that are zHyperLink Eligible ......................................66 zHyperLink Data Set Analysis .........................................................................................................................67

zHyperLink IO Rate Graph ....................................................................................................................67 Average Response Time Graph...........................................................................................................68 Re-Dispatch and Average Response Time Graph ..........................................................................69

Multiple System Graph Creator ..................................................................... 70

zBNA Saved HTML Report ........................................................................... 76

Introduction The IBM Z Batch Network Analyzer (zBNA) application accepts SMF Type 14, 15, 30, 42, 70, 72, 74, and 113 data extracted using the CP3KEXTR program to analyze a single batch window of user defined length. The data in the SMF 30 subtype 5 records are displayed on the main zBNA panel when zBNA opens. In addition, the program is focused on Batch Jobs and will ignore records which are not batch jobs. If a task originated as a started task or as a TSO user, these are not included in the analysis even though they have generated Type 30 data. New in zBNA Version 1.3, dated December 31, 2013, is the zEnterprise Data Compression (zEDC) function. zBNA provides a means of estimating the amount of data which may be eligible for compression using the IBM zEDC Express PCIe card available on either a zEC12/zBC12 or newer. The intention is to give the customer a starting point for identifying how much zEDC Express capacity they may need to support their workloads. New in zBNA Version 1.8.1, dated August 25, 2017, is support for Data Set and Coupling Facility Encryption. The performance APARs OA53718 and OA53664 must be applied to the system for z14 estimations. New in zBNA Version 1.8.2, dated April 10, 2018, is support for zHyperLink. There are both IBM Z hardware and z/OS requirements, which must be met along with SMF 42.6 enhancements. These are discussed in the “zHyperLink” section. zBNA is used to:

• estimate the amount of data which may be eligible for encryption

• identify job time sequences based on a graphical view,

• filter jobs by attributes like CPU time / intensity, job class, service class, etc.,

• review the resource consumption of all the batch jobs,

• drill down to the individual steps to see the resource usage,

• identify candidate jobs for running on different processors,

• identify jobs with speed of engine concerns (top program %),

• identify data sets used in a job and the set of jobs that use a data set (Life of A Data Set),

• identify jobs and BSAM/QSAM data sets that are zEDC compression candidates across a specified time window,

• estimate the amount of data which may be eligible for encryption, and

• estimate the amount of data which may be eligible for zHyperLink. zBNA allows “what if” analysis to be performed to see how the specified batch window would run in a different environment. It generates output in the form of:

• saved studies that can be loaded another time,

• Gantt charts of the jobs and filters applied in the study,

• a multiple system graph for the zEDC, Data Set/Encryption, zHyperLink applications,

• a CSV file of “interesting” data, and

• a report saved in HTML format that can be displayed in a browser or a word processor for further manipulation.

Getting Started The zBNA Capacity Planning application is a PC-based productivity application that runs on the Windows 7, 8, or 10 64-bit platform. It is designed to help analyze how processor capacity is being consumed and what work would be most sensitive to changes in engine speed. It is one of a family of applications produced and maintained by the Capacity Planning Support (CPS) team, which is part of the IBM Washington Systems Center in Herndon, Virginia. PC System (minimum requirement)

• Intel Core Duo or better (64-bit required)

• 4GB of RAM is required to install; more is recommended to accommodate large amounts of data that may be loaded into zBNA

• Graphics adapter and display (1024x768 or better)

• Microsoft Windows 7, 8, 10 NOTE: These features are the recommended minimum requirement for the installation and execution of zBNA. Obtaining zBNA

1. IBM employees via the IBM Intranet at: http://w3-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5126 2. IBM Business Partners via PartnerWorld:

https://www-356.ibm.com/partnerworld/wps/servlet/mem/ContentHandler/tech_PRS5133

3. IBM Customers zBNA via the IBM Internet: http://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5132 Java Requirement zBNA requires the IBM CPS Java Runtime Environment v8 64-bit, which is available on:

1. IBM Employees http://w3-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5222

2. IBM Business Partners https://www-356.ibm.com/partnerworld/wps/servlet/mem/ContentHandler/tech_PRS5133

3. IBM Customers https://www-03.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/PRS5132

NOTE: Installation of the IBM CPS Java Runtime Environment v8 64-bit for zBNA is done without replacing or removing any other Java that may already be installed, and does not change your “system” Java.

Installation zBNA is packaged with InstallShield. To install the application, execute the package file that you downloaded from the website to your PC. You will be prompted to specify the target directory for the application code. An application icon can optionally be placed on the desktop. Execution Execute the zBNA package file that you downloaded to your PC. You will be prompted to specify the target directory for the application code. An application icon can optionally be placed on the desktop along with an opportunity to have a shortcut to the IBM CPS Tools folder, found under Start → All Programs, created on the desktop. The folder will contain the applications and associated documentation.

Questions and Feedback Contact Capacity Planning Support via: Lotus Notes: zPCR/Gaithersburg/IBM@IBMUS e-mail: zpcr@us.ibm.com

Input Data Gathering zBNA processes data produced by the CP3KEXTR program. Obtain this program from the same place where zBNA was downloaded. A partition data set member named EXTRZBNA is in the CP3KEXTR package. This member is designed to gather the data specific to a zBNA analysis. It will create two partitioned data sets; one of the RMF Type 70’s and 113 data and the other of the Type 14, 15, 30 and 42 data combined. Each of these data sets will need to be transferred down to the PC, using FTP, in ASCII (i.e. text, flat file that is readable when viewed) mode. FTP the dataset containing the RMF data with a suffix of .edf and .dat for the dataset containing the Type 30 data. These files will be the input to the zBNA analysis. Notes:

1. When the larger data set containing the SMF Type 14, 15, 30 and 42 records is tersed on z/OS, it must be transferred as binary to the PC.

2. SMF 113 records (required) will be processed for the EDF.

3. DURATION parameter cannot be less than five minutes.

CP3KEXTR JCL for zBNA The following JCL member is specifically for zBNA and included in the program. EXTRALL – JCL that must be used with zBNA Version 1.2 released on 09/17/2013 or later //#CUSTMER JOB (????,????),MSGLEVEL=1,MSGCLASS=O,NOTIFY=???????? //* //* // EXEC PGM=IEFBR14 CLEAN UP //DD1 DD DISP=(MOD,DELETE),UNIT=SYSDA,SPACE=(TRK,1), // DSN=CUSTMER.OTHRTYPS.DATA //DD2 DD DISP=(MOD,DELETE),UNIT=SYSDA,SPACE=(TRK,1), // DSN=CUSTMER.DATA.TRS //EXTR EXEC PGM=LOADER //* PRINT DATA SET FOR MESSAGES FROM YOUR RUN //PRINT001 DD SYSOUT=* //* INPUT SMF DATASET //SMFIN DD DISP=SHR,DSN='CUSTMER.INPUT.SMF' //* OUTPUT DATASET FOR EDFI FILE //EDF001 DD DISP=SHR,DSN=CUSTMER.CPSTOOLS.JCL(EDFI) //* OUTPUT DATASET FOR WORKLOAD GROUPING DATASET //PGN001 DD DISP=SHR,DSN=CUSTMER. CPSTOOLS.JCL (PGNMAP) //* OUTPUT DATASET FOR AUTO BCU MAP //*BCU001 DD DISP=SHR,DSN=CUSTMER. CPSTOOLS.JCL (BCUMAP) //* INPUT DATASET FOR IOCP PROCESSING (FICON ANALYSIS) //*IOCP001 DD DISP=SHR,DSN=CUSTMER.CPSTOOLS.JCL(IOCP) //* DDS FOR OPTIONAL INTERNAL SORT OF SMF RECORDS //*SORTMSGS DD SYSOUT=* //SYSOUT DD SYSOUT=* //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(500)) //SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,( 500)) //SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,( 500)) //SORTWK04 DD UNIT=SYSDA,SPACE=(CYL,( 500))

//* # OUTPUT DATASET FOR TYPE14, 15, 30 & 42 RECORDS //* NOTE: DCB INFORMATION FOR THIS DATASETS IS SUBJECT TO CHANGE. //* SO IT IS BEST TO LET THE PROGRAM ALLOCATE THEM. //DATA001 DD SPACE=(CYL,(300,100),RLSE),DISP=(,CATLG),UNIT=SYSDA, // DSN=CUSTMER.OTHRTYPS.DATA,DSNTYPE=LARGE //* # OUTPUT DATASET FOR SAVE= PARAMETER (SAVE CP3K'S SMF RECORDS) //*SMFSAVE DD SPACE=(CYL,(20,10),RLSE),DISP=(,CATLG),UNIT=SYSDA, //* BLKSIZE=8192,DSN=CUSTMER.SMF.SAVE //* # OPTIONAL USER DUMP DATASET //*SYSUDUMP DD SYSOUT=* //SYSIN001 DD * ENT='YOUR COMPANY’ YOUR COMPANY NAME SYSID=SY01 SMF SYSID DURATION=01:00 DURATION FOR SUMMARY SAMPLES * DURATION MUST BE A MULTIPLE OF RMF INTERVAL *TIME=(00:00-24:00) CONTINGUOUS PERIOD OF INTEREST *DATE=(08/05/09-08/12/09) CONTINGUOUS DAYS PGN=GOAL GENERATE PGNMAP BCU=AUTO GENERATE BCUMAP SORT=YES IF RECORDS ARE IN SORTED ORDER * OMITTING SORT=YES WILL SPEED THINGS UP. /* //* MESSAGES FROM THE MVS LOADER //SYSLOUT DD SYSOUT=* //* THE OBJECT MODULE OF THE PROGRAM //SYSLIN DD DISP=SHR,DSN=CUSTMER.CPSTOOLS.JCL(ZOBJEXTR) //* //* THIS STEP TERSES THE DATA FILE TO MINIMIZE NETWORK BANDWIDTH //* IT WILL ISSUE RC=10, IF THERE ARE NO RECORDS IN THE INPUT DSN. //* //T EXEC PGM=TRSMAIN,PARM=SPACK //SYSPRINT DD SYSOUT=* //INFILE DD DISP=SHR,DSN=*.EXTR.DATA001 //OUTFILE DD DSN=CUSTMER.DATA.TRS,DISP=(,CATLG,DELETE), // SPACE=(CYL,(50,15),RLSE),UNIT=SYSDA Note: Since the amount of data needed by zBNA is large, use the following parameters to gather data for only one shift. SELECT DATE=02/11/14,TIME=18-24 SELECT DATE=02/12/14,TIME=00-07

The CP3KEXTR result yields output from 02/11/14 at 18:00 to 02/12/14 at 07:00. Note: Limit the time range to 24 hours for ONE System! Support for Large DAT Files The .dat file for a large system can easily be 1 GB or larger. This can result in long download times, especially if you are remote to the z/OS system that the files are being downloaded from. To address these download times, zBNA supports tersed .dat files. Terse the file on z/OS and download it (suggested file extension is .trs) as binary to the PC. On the “Import Files” panel in zBNA, you will select the tersed file when you click on Browse For z/OS SMF File.

File Menu This is the initial display of the options available on the File menu with no data loaded in zBNA.

Use this menu to load files, save the input as a study file, and save the data on the main panel in CSV format along with an alternate CPU, if one is defined. Note: When a study is saved in zBNA format, what is actually saved are the filters that are defined. No actual input data is saved.

Load Files

Note: Any previously generated Type 70 (.edf) and Type 30 (.dat) file prior to September 17, 2013, will not load into zBNA Version 1.2 or later. There are two steps required to load data files into zBNA.

1. The first, Load Files, loads the SMF Type 30 Subtype 5 job records only. Select “Key Batch” box for all jobs that are important to you then proceed to set the job thresholds (top program %, GCP time, and elapsed time) and define filters such as time, service/report/job class, and account code. This will reduce the number of jobs to something more manageable for the analysis. Note: These settings can only be manipulated during the first load; they cannot be altered once the job step details have been loaded into zBNA.

2. The second part of the load process is to add the SMF Type 30 Subtype 4 job step records. Click File then Add Selected Step Level Records.

3. Click File, Load Files to display the “Import Files” panel. Start the zBNA configuration by either loading a previously saved zBNA file (.zbna), which automatically fills in the two original .edf and .dat/.trs files in the “Choose the SMF70 .edf file…” and “Choose the SMF30 .dat file…” fields, or browse for the individual .edf and .dat files.

Load a zBNA file On the “Import Files” panel, click the Browse For zBNA File button.

Notice that the title bar specifies what type of file you have selected to load. Files of type, “.zbna” have been previously saved by zBNA. Select the file, Open to load the data.

zBNA Initial Panel This is the initial panel displayed in zBNA.

This is the zBNA main panel. It has three parts:

1. The upper left window, Applied Filters, contains a listing of filters, if any, that have been applied to the input data.

2. The upper right window, Mainframe Information, contains information about the partition under study.

3. The large window contains the detailed job data associated with the partition. 4. The first column, Key Batch, is used to identify jobs that are important to you. When jobs

are selected, they remain in the study even if they fall outside of the job thresholds and other filters that are defined on the “zBNA Filters” panel. They key jobs are shown in red on the graph.

5. The columns in the table view can be sorted in ascending/descending order. Additionally, the number of jobs is always displayed in the lower left corner. The message in the lower right corner serves as a reminder that currently Only JOB end records (type 30 subtype 5) have been loaded. To load the SMF Type 30 subtype 4 job step records, click File, Add Selected Step Level Records. The main zBNA panel is redisplayed.

Now a job can be drilled down to show the step level details.

To drill down to view the job step details, either double click on the job row or right click and select Show Step Details to display the “Job Information” panel.

Job Step Details Panel

The step details for the specified Job are shown. The Proc Step column will show the procedure step name. Note: The data must be extracted using the CP3KEXTR Program dated 10/10/2014 or later. A CSV file can be generated of these details by using File, Create CSV file. To create an HTML file use Action, Report.

Life of a Program Step details for a specific Program can be analyzed.

Right click on a Step line of a Program, and select Get the Life of this Program. zBNA will pass the .dat file again, and collect all Steps that used that Program.

The "Life of a Program" panel is very similar to that of the "The Life of a Data Set" panel. The only addition to this panel is the Job name column. From this panel zBNA will output a CSV of the data, as well as a Report.

Key Batch Jobs When a selection is made (user specified designation) in the Key Batch column, this denotes jobs which are very important.

The Key Batch jobs can be selected individually or multiples swiped together. To accomplish the latter,

• right click the mouse button in a job row,

• swipe forward the number of rows that are Key Batch,

• release the right mouse button, and

• click Toggle Key Batch. Note: Use the same method to deselect multiple rows of jobs. The Key Batch jobs are always included in the analysis regardless of the job filter definitions. Generate a graph of the Key Batch jobs (graphed in Red) using the Graph menu. Similarly, a Key Batch Report can be generated on the Reports menu.

Top Programs The Top Program and Top Pgm % columns represent the program name of the top task and the percent of the total engine time which is spent on this top task. These fields will only be populated if the customer has installed the PTF for APAR OA39629 on their system. It is also necessary to have SMF 30 Interval recording enabled to get values in subtype 4s and 5s; thus, zBNA reporting. The following fields in the SMF Record Type 30 are affected: SMF30_Highest_Task_CPU_Percent For interval records, the largest percentage of CPU time used by any task in the address space, rounded to the nearest integer. The percentage value is calculated as:

TCB time x 100 / interval time For step-end and job-end records, the value is the largest reported interval value. SMF30_Highest_Task_CPU_Program This is the program name running in the task that used the largest percentage of CPU time in this address space. This field corresponds to the SMF30_Highest_Task_CPU_Percent. The Condition code column contains the ending condition code of the job.

Load a SMF70 and z/OS SMF File On the “Import Files” panel, click Browse For SMF70 File.

Notice that the title bar specifies what type of file you have selected to load. Files of type, “.txt” and “.edf” contain the SMF Type 70, 72, and 113 data. The “Import Files” panel redisplays. Click the Browse For z/OS SMF File button.

Notice that the title bar specifies what type of file you have selected to load. Files of type, “.txt” .dat, and .trs (tersed format)” contain the SMF Record Types 14, 15, 30, and 42 data. The content of this file must correspond to the SMF Type 70 data previously selected. Click Open. The “Import Files” panel now shows the SMF70 and z/OS SMF files that were selected.

Click Import. The data is now processed. The SMF Type 70 data determines the time that is analyzed. If there are jobs (Type 30 records) outside of the SMF Type 70 data bounds, they are eliminated and jobs which overlap are trimmed to include only the time for which the SMF Type 70 data is present. Also, Type 30 records which have a blank Job class are taken to be started tasks or initiators and are excluded from the analysis. Note: When the data being imported was extracted with a CP3KEXTR that is six months or older, zBNA displays a message.

Save As zBNA Study File

The “Save zBNA File” panel will create a .zBNA file. This file contains information about the current study. It includes the two files (SMF70’s, 113 and z/OS SMF data – includes SMF Record Types 14, 15, 30, 42), any filters that may have been selected, the settings for Top Program Pct., GCP and Elapsed Time, and any alternate processors that may have been selected. In this way, it is possible to save the state of the analysis to review later or to pass on to a colleague. Note: If the job step level records (SMF Type 30 subtype 4) are loaded, FileAdd Selected Step Level Records, they are not saved in the .zBNA file.

Save untersed file as DAT file When a terse file is loaded, this selection is enabled on the File menu. This function will save the .dat file from the untersed data that is in the model.

Save as CSV

Use the Save as CSV expanded menu to save the following data.

• Save as CSV, Jobs & Steps – The step level records must also be added into the configuration (File, Add Selected Step Level Records) before this option is enabled.

• Save as CSV, Jobs & Steps w Alts – Along with the step level records, an alternate processor must be added into the configuration (Action, Set Alternate CPUs) before this option is enabled.

• Save as CSV, Jobs only – The SMF Type 30 subtype 5, job information, is saved in a CSV file.

• Save as CSV, Jobs only w Alts – An alternate processor must be added into the configuration (Action, Set Alternate CPUs) before this option is enabled.

Select one of the options to save the CSV file.

This panel will prompt to identify the name for the .CSV file. The current table along with the other data columns in the Edit, Select Columns will be output in CSV format for further analysis. If all input is desired, it will be necessary to clear the filters and set the CPU Time filter to zero and the Top Program Pct. to zero. By doing this all data will be displayed in the table and will be output to the CSV file.

Edit Menu

Find The Edit menu houses the Find function allowing quick searches on specific text. On the Edit menu, click Find.

Input the search criteria.

The search result will be highlighted. Use Find Next on the Edit menu or F3 to continue with the search.

Select Columns

This feature allows the user to have control of the data columns that are displayed on the main menu; there are preselected default columns. Once a selection has been enabled or disabled, click outside of the list to update the table.

Filters Menu

The Filters menu contains the function that allows the job threshold and filters to be specified from the data. These include Top Program Pct., service classes, job classes and account codes. Click Set Table Filters to display the “zBNA Filters” panel. Note: Filters must be defined prior to adding the Step Level Records. Once the latter operation is performed, the “zBNA Filters” panel is in the viewable only state.

Set Filters

The Job Thresholds window allows the following three thresholds to be defined.

1. The Top Program Pct is the minimum value that the Top Pgm % field (shown on the main panel) must have in order to be displayed.

2. The GCP Time is the number of seconds that the job must have used in order to be displayed on the main panel.

3. The Elapsed Time defines the number of seconds that the job ran. Note: The Clear Filters function does not apply to the settings in the Job Thresholds: window. Simply input another value in the field to make a change.

The Service Class Filter window allows you to select the Service Classes that are to be displayed. The same is true for the Report Class Filter, Job Class Filter, and Account Codes Filter windows. Use the Ctrl key and mouse for multiple selections or to remove a selection. The Job Name Include Mask window allows the selection of jobs based on their names. The “*” will match any number of characters and the “?” will match one character in the job name. Click Add to input a job names mask. The Exclude by Job Name window contains jobs which have been excluded (right clicking on the jobs on the main panel, and select “Exclude Data”). Enable the Filter by time checkbox to limit the jobs to a given time interval. This selection is propagated to the zEDC Compression function on the “zEDC Top Data Sets” panel.

The filters that were specified are shown in the Applied Filters box on the main zBNA panel.

To reset the filters and return to the original data, click Clear Table Filters on the Filters menu before you add the selected job step records (File, Add Selected Step Level Records).

Action Menu

The Action menu has the following options.

• Set Alternate CPUs Define alternate processors to perform “what if” analyses.

• Flag Transition Jobs After an alternate CPU has been set that is slower than the base processor, zBNA adds a column to the main table identifying those jobs that are below the intensity percent, whose value is set in Graph, Set Intensity Percent. The default is 10%.

• Job Dataset Report View the data sets a specific job used. Note: SMF Type 42 subtype 6 records must be loaded.

Set Alternate CPUs

Several analyses show comparisons of the current processor with alternate ones. Define your alternate processors on this panel, and it's best to maximize the window to get a better view of the processor list. To begin the process, click New. The Model drop-down list in the Alternate Processors table shows the models by processor family. If applicable, make changes to each of the PU types along with specifying whether to enable the zAAP on zIIP capability. Click Apply to accept the changes.

LPAR Definitions Table

Note that the (UseBase) category simply means to use the same category as the original processor. The LPARs on the alternate processor take on the same workload characteristics as the base processor. Click on the base processor, and you will see what definitions are assigned. If you want the alternate processor to use a different workload, double click in the drop-down box in the Workload column for that LPAR, and select the appropriate workload. Tab out of the box, and click Apply for the change to take effect. If the EDF is built with SMF 113s in the input, the RNI/L1MP methodology will be used to determine the LSPR workload match. If there are no SMF 113s, Average will be the default workload.

Capping The Cap checkbox is used to indicate that a shared partition is to be considered as being capped. Checking the box without entering a value in the Abs Cap field indicates hard capping.

Absolute Capping This feature is on zEC12/zBC12 and later processors only. For normal capping (hardware capping), a partition's Maximum Capacity value is set equal to its Minimum Capacity value. An Absolute Capping value is specified as a fractional value between zero and the number of logical CPs defined to the partition (format N.nn). This value has the effect of increasing the partition's Maximum Capacity value proportionally between its hard capping value and the value had no capping been specified.

When one of the supported processors is defined, and selected in the Alternate Processors table, an additional column, Abs Cap, is added in the LPAR Definitions table. If the value entered is not within the valid range, a dialog will display at the bottom of the table.

SMT Benefit Symmetrical Multi-Threading (SMT) is a feature on z13 processors and later applicable to IFL and zIIP CPs only. LSPR data is published based on single-threaded workload. To evaluate expected z13 zIIP and IFL capacity, an SMT Benefit value can be applied for each partition. The suggested default SMT Benefit value is 25% for zIIP and IFL (20% prior to the z14) CPs. When one of the supported processors is defined, and selected in the Alternate Processors table, an additional column, SMT, is added in the LPAR Definitions table. zBNA will automatically apply the defaults using the selections on the Action menu, otherwise, input the values manually in the SMT field.

Note: SMT is currently supported only by the SCPs listed below. SMT Benefit will not be realized by KVM or Linux until such support is made available.

• z/OS v2.1 or later on zIIP CPs – version must be explicitly defined to the partition

• z/VM 6.3 or later on IFL CPs – version must be explicitly defined to the partition

Flag Transition Jobs This option is enabled after an alternate processor that is slower than the base processor has been applied in the study.

A column, Transition, is added to the tabular view.

zBNA automatically flags the jobs that are BELOW the threshold of the intensity percent on the base machine and ABOVE the threshold of the intensity on the alternate processor. These jobs are likely to cause problems for customers in such a migration.

Job Data Set Report The SMF Type 42 subtype 6 records are required. They are loaded into zBNA via the .dat file. This function is activated after File, Add Selected Step Level Records is used, and a job is selected.

Click Action, Job Data Set Report or right click on the selected job then click Job Data Set Report. zBNA reads the SMF Type 42 subtype 6 data.

When this process is complete, zBNA displays the “Job Dataset Report” panel.

The DASD data set information for the selected job is shown on this panel. Be sure to expand the panel to view all the columns. You can sort on a specific column heading to show that data set characteristic in ascending or descending order. Further processing on a data set is available by right clicking in a row and selecting Get the Life of this Data Set. zBNA reads the .dat file, first, for SMF 42 data then for the 30 data.

Life of a Data Set

For the selected data set, details are shown for the jobs that access the data set throughout the Batch interval. You can investigate the SMF Type 64 records and consider increasing LSR / NSR buffers to hold Index Set and potentially eliminate approximately 5 minutes of I/O time.

Display Graph

Select Display Graph: Table to display the Gantt chart produced from the filters applied to the loaded data.

The chart can be manipulated in a number of ways.

1. To zoom into a section, click on the upper left and hold the left mouse button while dragging to the lower right of the section you wish to zoom.

2. Panning can be accomplished by holding the control key and left clicking with the mouse and dragging the chart.

Gantt Chart Color Scheme

1. Magenta This color represents the execution time of a job.

2. Blue This color represents the wait time, which is calculated from the RMF Service class waiting for dispatch field. The rest of the bar of a given job represents “other” time. 3. This color may be red if the user has flagged this job as a key batch job. 4. It will be green if the execution time is less than ten percent of the job’s duration. 5. It will be yellow if the execution time is more than ten percent of the jobs duration.

Note that the ten percent may be changed by selecting ActionSet Intensity Percent.

The Y axis lists the names of the given jobs. The flyover text for these labels will display the average physical processor utilization while that job is executing. Note: If pan and zoom are used to resize the graph, click the “Reset Graph” button to set the chart back to its original state. The “Back to Main” button displays the tabular view of the data.

GCP Utilization Click Display Graph: CPU Utilization on the Graph menu to show this chart.

This is a plot of the GCP physical utilization of the partition and CPC. The x-axis shows the day(s) and hours. If the time filters have been set, only those times will be plotted.

MSU Rolling 4-Hour Average Click Display Graph: Rolling 4 hr Avg on the Graph menu to show this chart.

This is a plot of the Rolling 4-Hour Average of the partition. The rolling 4-hour average is very sensitive to the number of samples and intervals selected. There is no attempt to duplicate all of the function that the Sub-Capacity Reporting Tool (SCRT) provides by limiting the rolling 4-hour average to the defined capacity or group defined capacity. The point is to look for peak intervals; it shows the true rolling 4-hour average and not the billing value with all the limits applied. Note: If the time filters have been set, only those times will be used to calculate the rolling 4-hour average.

Set Intensity Percent

To set an intensity threshold, click Graph, Set Intensity Percent to open an input window to specify the value.

CPU Intensity is the ratio of CPU execution time divided by the job elapsed time. If as much CPU time is used as elapsed time, then intensity is 100%. If it used six minutes of CPU for a one-hour job, then it has an intensity of 10%. This is important because improving the CPU aspect of a job that uses very little CPU is not interesting. Likewise, improving the CPU aspect of a job that uses much CPU is interesting. zBNA sets the Intensity Percent default value to 10%. As this relates to the graph, “other time”, the bar is green when the job’s CPU execution time is less than the Intensity Percent of the job’s duration. A yellow bar signifies that the CPU execution time is more than the Intensity Percent of the job’s duration. Notes:

1. The Intensity Percent value can be changed to whatever your customer thinks would be important to them.

2. At the present time, there is no Rule of Thumb as to what the default value should be.

Reports Menu zBNA generates several reports.

If a “Key Batch” check box is selected on the main zBNA panel, a report containing these jobs can be generated. Click ReportsGenerate Key Batch Report to display the Gantt chart produced from the selected key jobs. Note: Each of the options on the Reports menu all open the “zBNA Save HTML Report” dialog.

Input the name for the .htm file. Once the file name is supplied, the zBNA report is generated and saved.

Applications Menu This is the gateway to the Top Data Sets, zEDC BSAM/QSAM Compression, Data Set and Coupling Facility Encryption, zHyperLink, and Multiple System Graph Creator functions.

Top Data Sets Input Window View the data sets where the most I/O time is, over the entire interval and regardless of who is accessing the data set. Click Applications, Top Data Sets.

zBNA prompts for the number (10 is the default) of data sets to display. Click More Options to identify a specific Service Class and/or Job Name Include Mask.

Once the input is specified, click Find Datasets. zBNA reads the .dat file, first, for the SMF 42 data then for the SMF 30 data to display the “Top Data Sets” panel. Note: If the number of actual data sets is less than the number specified for the top data sets, the actual number is included in the title on the "Top Data Sets by Total I/O Time" panel.

The purpose of this panel is to show where the most I/O time is, over the entire interval and regardless of who is accessing the data set. Looking at the data set characteristics, technology options can be evaluated to improve the response time, and thus the elapsed times of the jobs/online applications that are accessing it. Use FileCreate CSV File to save a “.csv” file containing the top data sets information. Right click on a specific data set, and select Get the Life of this Data Set to open the “Life of a Data Set” panel.

zEDC Compression View the estimated number, by hour, of zEDC cards needed to support the workload for all data sets that met the criteria in the interval.

zBNA provides a means of estimating the amount of data which may be eligible for compression using the IBM zEDC Express PCIe card available on a zEC12 or later processor. Note: SMF Record Types 14 and 15 are required to use this application. Click ApplicationszEDC: BSAM/QSAM Compression, and zBNA adds SMF Record Types 14 and 15 data along with the matching Type 42 subtype 6 records.

zEDC Show Top DSNs The purpose of providing the top data sets is to identify which ones will provide the most impact/benefit from zEDC compression, and may provide a starting point for which ones to implement first.

The top zEDC compression candidate data sets, by type, are shown. The panel is displayed on entry sorted by the MB column in descending order. Here is a description of the data set types.

• COMP (Compressed) Already compressed using z Systems hardware compression Note: COMP is labeled when the PTF that understands generic and tailored isn't installed. When that PTF is installed, GEN and TLRD will be labeled as the File Type.

• EF (not Compressed) Extended Format data set but not compressed

• PS (not EF) Physical Sequential not extended format

• zEDC Using the zEDC Express feature for compression

Show by Rate or MB Select the radio button to enable/disable which file type(s) of compression candidates to view. You can also select to show the compression metric by Rate (MB/sec) or MB (total); the latter is the default view.

Graphing Options • All Datasets (default)

The graph will display all of the eligible zEDC compression data set candidates.

• Top “N” Datasets Only the number of data sets that are in the table will be displayed on the graph. This number is set in Action, Number of Data Sets to Display.

• User Selected Datasets Specify which of the Top N Datasets to include/exclude on the graph using the checkboxes in the first column in the table.

Understanding the Table of Eligible Data Sets for Compression

Time Filter Status This information is shown at the bottom right of the panel. It is propagated from the Set Filters panel when "Filter by time" is set and the checkbox is enabled.

User Sel. Individually select data sets or use the multiple select the checkbox

DSN Data Set Name

File Type Indicates if the QSAM/BSAM data set is currently using IBM z hardware compression or is an eligible file type

Transferred MB Total MBs of data transferred for the data set

RW Ratio Provides the read to write ratio of the data. A data set which is 100% read is identified as an ‘R’ while a data set which is 100% write is identified as a ‘W’

Comp Ratio If the data set is already compressed this will show the current compression ratio

Δ I/O Count A negative value for I/O counts indicates the estimated reduction in the number of I/Os against the data set across the window if moved to zEDC compression

Δ I/O Time Seconds

Estimation of the change in the amount of time spent doing I/O against the data set across the window if moved to zEDC compression

Δ CPU Time Seconds

Estimation of the change in the amount of CPU time spent doing I/O against the data set across the window if moved to zEDC compression. A negative value for estimated CPU time indicates a CPU savings, while positive values indicates an increase in CPU cost

Δ DASD Space MB

Estimation of the change in the amount of DASD Space in MB from using zEDC compression. The field is blank if the data set is 100% Read

The first column of checkboxes is used to specify whether a specific data set is to be included or excluded in the graph.

Individual data sets can be selected, as well as all the data in the table at one time using basic Microsoft Windows. Right click on a checkbox in the first column. Use Select All to enable the data sets, and that number will be shown (50 selected) in the information line on the bottom of the panel. All selections can be cleared using Clear All.

The File Type column shows whether the data set is already compressed. You can quickly identify data sets that are considered to be candidates for zEDC that are not currently being compressed. The MB column (sorted in descending order by default) contains the total MB transferred (read or written) for all job steps that accessed the file. There could be a relatively small file that is accessed by numerous steps, and it would rank “high” in the list because the total MB would reflect both how much data was transferred to or from the data set and how often. The input in the RW Ratio column refers to the number of reads divided by the number of writes. If either is zero, we put R (the data set is read only) or W (the data set is write only). The values in the Comp Ratio column represent the compression ratio which is the uncompressed data divided by the compressed data size. The Comp Ratio value for EF and PS candidate datasets is one in all cases. zBNA shows the estimated I/O Count, I/O Time, and CPU Time deltas if the candidate data set was to be compressed with zEDC. The Estimate PS or EF Comp. Ratio box allows you to specify a compression ratio that will be used to provide the estimation for sequential data sets. The High, Medium, and Low ratio defaults are based upon the ranges seen in the IBM benchmarks. Without any additional insights, use Medium. Use a different compression ratio if you have knowledge of the data and how it might compress. For instance, if hardware compression is turned on, you can use that data. Input that value in the Custom field. The updates will show in the Projections for zEDC column for the EF and PS data sets. Notes:

• The number of data sets in the table is displayed at the bottom of the table.

• A CSV file can be generated of the compression data. Use File, Create CSV file – Table data (maximum of 1000 data sets) and File, Create CSV file – All data.

• The Find and Find Next functions are available on the Edit menu.

• Use the Action menu to specify the Number of Data Sets to Display on the “zEDC Top Data Sets” panel. The input value can range from 10 to 1000.

• When no compression type checkbox is selected or when the User Selected Datasets option is enabled without selecting a checkbox in the first column, the items in the Graph menu are disabled because there is nothing to graph.

• To display the Projected zEDC Cards, Projected zEDC CPU Savings, Projected zEDC I/O Count, and Dataset Gigabytes per Hour graphs use the Action menu.

• Click Report, Data Processing Results to view the selection detail of the SMF 14/15s used in the analysis.

• To create a zBNA zEDC report, click Report, Output Report. The “Save HTML

Report” dialog displays.

The default folder to save the output is “zBNA_Output”. Input a name for the HTML file. zBNA saves the file, zEDC report.htm. In this same dialog, you can select a report file that currently exists.

zBNA opens the dialog to select whether to overwrite or append to the existing file.

Using Overwrite, the text in the original “.htm” file will be overwritten. Append, adds the section, “zEDC Compression Analysis” to the end of the original “.htm” file. NOTE: When any of the zEDC graphs are displayed, they can be appended to the zEDC report file by using Report, Output Graph.

zEDC Data Set Analysis Right click on a data set on the zEDC Top Data Sets panel, and click zEDC Dataset Analysis to display this graph.

The chart can be manipulated in a number of ways.

1. To zoom into a section, click on the upper left and hold the left mouse button while dragging to the lower right of the section you wish to zoom.

2. Panning can be accomplished by holding the control key and left clicking with the mouse and dragging the chart.

The data set represented and its compression category are shown at the top left on the panel. The y-axis shows the corresponding job and step in the data set. Place the mouse over the data points to see their values. The Control Panel at the bottom of the panel describes the color scheme on the graph.

zEDC Top Data Sets Graphs Use the Graph menu to show the analysis of the zEDC projection results.

Estimated zEDC Cards Graph

Display this graph from the “zEDC BSAM/QSAM Top Data Sets” panel. Click Graph, Estimated zEDC Cards. This graph shows the estimated number of zEDC cards, by hour, needed to support the workload for all BSAM/QSAM data sets that met the criteria in the interval. With this graph, you can see the peak time and how many cards are required from a capacity perspective. A datum line is shown at every integer if the estimated number of cards is less than four. Otherwise, a datum line is shown for every two cards. The x-axis shows the start and end hour of this data.

Estimated zEDC CPU Savings Graph

Display this graph from the “zEDC Top Data Sets” panel. Click Graph, Projected zEDC CPU Savings. It shows the CPU savings and cost estimate when utilizing zEDC for BSAM/QSAM. Note: There will be CPU savings only if you are currently using Hardware Data Compression (Generic or Tailored) for DFSMS PS data sets. You may also save CPU if you are using software compressing in the other exploiters (e.g. Sterling Direct Connect, MQ, PKWARE, etc.). zBNA will not provide estimates for these exploiters.

Estimated zEDC MIPS Graph

Display this graph from the “zEDC Top Data Sets” panel. Click Graph, Projected zEDC MIPS. This chart shows the estimated NET change in MIPS for exploiting the zEDC function for the selected data sets. The y-axis shows the estimated change in CPU in MIPS. The CPU savings will come from one of two areas. One is movement from tailored or generic compression using the CMPSC instruction on the GCP to zEDC compression using the zEDC Express card. The second place there can be a net savings is if the zEDC compression is significant enough to generate significant savings in I/O activity and the CPU savings from avoiding the I/O is greater than the CPU cost of calling the zEDC PCI/e card. When compressing a data set for the first time by using zEDC Express, it is expected there may be a CPU cost increase. This cost is from the CPU cost of doing the management of calling the card for compression and decompression. The x-axis shows the estimated zEDC net change in MIPS across time. The time shown on the x-axis is governed by the time filter used when the chart was generated. Within the legend for the current processor and any defined alternate processors are the estimated MIPS ratings for the selected processors as estimated by zPCR.

Estimated zEDC MSU Graph

The purpose of this chart is to show the estimated NET change in MSU charges for exploiting the zEDC function for the selected data sets. The CPU savings will come from one of two areas. The first is movement from tailored or generic compression using the CMPSC instruction on the GCP to zEDC compression using the zEDC Express card. The second area where there can be a net savings is if the zEDC compression is significant enough to generate significant savings in I/O activity, and the CPU savings from avoiding the I/O is greater than the CPU cost of calling the zEDC PCI/e card.

When compressing a data set for the first time by using zEDC Express, it is expected there may be a CPU cost increase. This cost is from the CPU cost of doing the management of calling the card for compression and decompression.

The y-axis shows the estimated change in CPU in MSUs. The x-axis shows the estimated zEDC net change in MSUs across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

The legend shows the MSU ratings for the current processor and any defined alternates.

Also, the dates and times of the data are specified along with the Time Filters, if they are applied.

Estimated zEDC IO Count Graph

Display this graph from the “zEDC Top Data Sets” panel. Click Graph, Projected zEDC I/O Count. This chart shows the estimated I/Os which will be directed to the zEDC cards if the eligible data sets are enabled for zEDC compression. The estimation is shown for each file type found in the data.

The x-axis shows the estimated zEDC I/O load across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

Data Set Gigabytes per Hour Graph

Display this graph from the “zEDC Top Data Sets” panel. Click Graph, Data set Gigabytes per Hour to show the estimated gigabytes by compression category for each hour. This chart shows the total estimated Gigabytes (GB) transferred by file type if the eligible data sets are set to exploit the zEDC function. This includes the estimated change for both reading and writing the data set. The y-axis shows the total estimated GB transferred for the selected data sets. The reduction in GBs transferred is due to the benefits of compression.

The x-axis shows the estimated zEDC total GBs transferred by file type across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

zEDC Graph Report To output the data and any of the three zEDC graphs to a zBNA report file, click Report, Output Graph. The “zBNA Save HTML Report” dialog displays.

The default folder to save the output is “zBNA_Output”. Input a name for the HTML file. zBNA saves this file, in addition to its corresponding graph image. zEDC report.htm is the report file name, hence, zEDCgraph00001.jpg is automatically saved. In this same dialog, you can select a report file that currently exists.

zBNA opens the dialog to select whether to overwrite or append to the existing file.

Using Overwrite, the text in the original “.htm” file will be overwritten and the graph image saved. Append, adds the section, “zEDC Compression Analysis” to the end of the original “.htm” file.

Encryption zBNA Version 1.8.1 provides support for Pervasive Encryption. Please NOTE that for z14 estimations, the results presented assume that the following performance APARs have been applied to the system: OA53718, OA53664. zBNA provides a means of estimating the amount of data which may be eligible for encryption. It is meant to be used to give the customer a starting point for identifying how much CPU capacity is needed to support their workloads. There are both IBM Z hardware and z/OS requirements, which must be met before the z/OS Data Set and/or Coupling Facility encryption can be exercised. There are many factors, such as job failures and programming techniques which dynamically change access methods and impact performance and throughput, which may result in significant variances between the actual and projected results. IBM does not guarantee the results from zBNA. This information is provided "as is", without warranty, expressed or implied. You are responsible for the results obtained from your use of this application.

Data Set Encryption Access the Data Set Encryption function via the Applications, Encryption menu on the main zBNA panel. NOTE: There are required APARs that provide enhancements to DFSMS SMF 42.6 for pervasive encryption in zBNA. z/OS V2.1 and V2.2 require OA52132, and OA52734 is required for V2.3.

These are the data sets for all intervals which meet the DFSMS encryption eligibility criteria. The supported access methods and data set types include BSAM/QSAM sequential data sets using extended format (version 2), and VSAM and VSAM/RLS data sets including KSDS, ESDS, RDS, VRRDS, and LDS in extended format. You can see

which data sets are already in extended format in the table view. Remember, for DFSMS to actually encrypt a data set, it must be Extended.

Description of the Data Set Types

Data Set Type Explanation

Phys Seq Physical Sequential Not Extended Format

Extended Phys Seq Extended Format Physical Sequential

KSDS data VSAM Key Sequence Data Set data component

KSDS index VSAM Key Sequence Data Set index component

Variable RRDS data VSAM Variable Relative Record Data Set data component

Variable RRDS index VSAM Variable Relative Record Data Set index component

Fixed RRDS VSAM Fixed Length Relative Record Data Set

Linear VSAM Linear Data set

ESDS VSAM Entry Sequence Data Set

Understanding the Table for Data Sets that Meet the DFSMS Eligibility Criteria

Data Set Type Indicates access method of the data set and the file type.

Currently Encrypted YES | NO. Indicates if the data set is currently encrypted by DFSMS.

MB Transferred Total MBs of data transferred for the data set as reported in the SMF data.

RW Ratio Provides the read to write ratio of the data. A data set which is 100% read is identified as an 'R' while a data set which is 100% write is identified as a 'W'.

Block Size Indicates the allocated block size of the data set.

Encryption Estimated ΔCPU Time

Reported only for data sets which are not encrypted, it provides the estimated change in CPU time to encrypt the data set.

Total I/O Time Total time spent doing I/O for the data set as reported by the SMF 42.6 records.

I/O Count Count of data set I/Os as reported by the SMF 42.6 records.

Response Time

The average response time for the data set as reported by the SMF 42.6 across the intervals. If the data set is active across multiple intervals a normalized value is calculated using the I/O rates as the weighting factor.

Compressed None | TLRD | GEN | ZEDC. Indicates if the data set is compressed. Tailored, Generic, or zEDC compression are supported.

Compression Ratio If the data set is already compressed this will show the current compression ratio.

Extended Indicates if the data set is defined as Extended Format to DFSMS.

These top Encryption data set candidates are determined by the total MB transferred. There are several characteristics displayed for each data set. By default, the data set activity is summarized

by all Service Classes and Jobs (that is why ALL is displayed in Service Class and Job Name). zBNA includes the data set based on whether the TYPE is supported by DFSMS for encryption, but it does include candidates even if they are not Extended, e.g. having a value of (“No”). Using "Number of Data Sets to Display" on the Action Menu, input the number of data sets to display in the table. That number is shown in the Information line at the bottom of the panel as "Displaying nn of a total…".

The "Create Multiple Systems Graph" function generates one graph showing different SYSIDs on the same CEC. More details are in the “Multiple System Graph Creator” section. The list of graphs is on the Graph menu.

Estimated Data Set Encryption CPU Cost Graph

This chart shows the estimated change in CPU seconds for exploiting the DFSMS data set encryption function for the selected data sets. The y-axis shows the estimated number of CPU seconds by data set type.

The x-axis shows the estimated DFSMS data set change in CPU seconds across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

Estimated Data Set Encryption MIPS Graph

This chart shows the estimated cost in MIPS for exploiting the DFSMS data set encryption function for the selected data sets. The y-axis shows the estimated number of MIPS. The chart shows the MIPS cost for the LPAR which represents the data supplied to zBNA. By defining one or more alternate processors which are a different server technology, (i.e. the LPAR is running on a z13 and a z14 is selected as an alternate processor), it is possible to see the different estimated MIPS costs for the selected data sets by different server technology (an alternate processor is defined later in the lab). The x-axis shows the estimated change in MIPS across time for the current LPAR and any defined alternate processors. Within the legend is the estimated MIPS ratings for the selected processors as estimated by zPCR. As you can see above, it is 101,291 MIPs for the current processor. Care needs to be exercised with this MIPS estimate. The CPU numbers provided are for GCP seconds and this is used to derive the MIPS and MSU estimated values. However, if the encryption activity is done on a zIIP processor then portions of the CPU costs will be zIIP seconds. This

estimate is given in GCP equivalents because the DFSMS support is not sensitive to engine type; GCP or zIIP. This estimate should be viewed as a conservative estimate of MIPS usage. zBNA converts the CPU seconds into MIPS, so you can see the amount of additional capacity required on this z13 to support DFSMS data set encryption.

Estimated Data Set Encryption MSU Graph

This chart shows the estimated cost in MSUs for exploiting the DFSMS data set encryption function for the selected data sets. The y-axis shows the estimated number of MSUs by data set type. The chart shows the cost in MSUs for the LPAR which represents the data supplied to zBNA. By defining one or more alternate processors which are a different server technology, (i.e. the LPAR is running on a z13 and a z14 is selected as an alternate processor), it is possible to see the different estimated MSU costs for the selected data sets by different server technology. The x-axis shows the estimated change in MSUs across time for the current LPAR and any defined alternate processors. The time shown is governed by the time filter used when the chart was generated. Care needs to be exercised with this MSU estimate. The CPU numbers provided are for GCP seconds and this is used to derive the MIPS and MSU estimated values. However, if the encryption activity is done on a zIIP processor then portions of the CPU costs will be zIIP seconds which do not carry MSU charges. This estimate is given in GCP equivalents because the DFSMS support is not sensitive to engine type; GCP or zIIP. This estimate should be viewed as a conservative estimate of MSU costs.

Within the legend for the current processor and any defined alternate processors are the MSU ratings for the selected processors.

Estimated Data Set Encryption Gigabytes per Hour Graph

The chart provides the LPAR's total DASD I/O rate in GB as a line graph. This total DASD I/O GB estimation is for the total DASD I/O rate from the LPAR. This information can be used to quickly identify how much of the LPAR's DASD I/O is covered or eligible for coverage by DFSMS data set encryption. The bar chart(s) indicate the estimated I/O rate in GBs per hour for data sets which are already encrypted, and those which are eligible to be encrypted but currently are not encrypted. This information is summed for all the data sets identified by the filters, regardless of file type. The x-axis shows for the selected data sets the estimated DASD I/O rate in GBs per hour across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

This chart provides the total DASD I/O rate as a line graph. This estimation is for the total DASD I/O rate from the LPAR, and this information can be used to quickly identify how much of the LPAR's DASD I/O is covered or eligible for coverage by DFSMS data set encryption.

The bar chart(s) indicates the estimated I/O rate in GBs per hour for data sets that are eligible to be encrypted but currently not encrypted. This information is summed for all the data sets identified by the filters, regardless of file type.

Estimated Data Set Encryption IO Rate Graph

The chart provides the LPAR's total DASD I/O rate as a line graph. This information can be used to quickly identify how much of the LPAR's DASD I/O load is covered or eligible for coverage by DFSMS data set encryption. The bar chart(s) indicate the estimated I/O rates for data sets by file type. This information is summed for all the data sets identified by the filters.

The x-axis shows for the selected data sets the estimated DASD I/O rate per hour across time. The time shown on the x-axis is governed by the time filter used when the chart was generated. zBNA shows the “Total” DASD I/O rate, including those data sets not eligible for data set encryption. It also shows the eligible I/O rate by data set type. You can see that the I/O rate is mostly composed of Phys Seq, Linear, and ESDS data set types. There is a good portion of I/O also from KSDS Data and KSDS Index data set types, but they did not drive significant amount of CPU. The reason is that the majority of VSAM KSDS Data and Index files are already encrypted, and there are examples in the table where Currently Encrypted is set to “Yes”.

Coupling Facility Encryption Access the Coupling Facility Encryption function via the Applications, Encryption menu on the main zBNA panel. NOTE: APAR OA51879 for z/OS V2.2 provides XES support for enhanced list/cache reporting. Additionally, APAR OA52003 provides new fields in the SMF 74.4 records to capture new structure information provided by XES in APAR OA51879.

Understanding the Table of Eligible Coupling Facility Structures All structures which meet the XES structure eligibility criteria and match the specified filters are listed in the table.

CF Name The name of the Coupling Facility

Structure Name The name of the structure

Structure Type List or Cache

MB Transferred Total MBs of data transferred for the structure as reported in the SMF data

Currently Encrypted YES | NO. Current encryption status of the structure

Encryption Estimated ΔCPU Time

Reported only for structures which are not encrypted it provides the estimated change in CPU time to encrypt the structure.

Request Rate The overall request rate, SYNC and ASYNC, to the structure as reported in the SMF data.

SYNC % The percentage of the request rate which was issued SYNC

Using "Number of Structures to Display" on the Action Menu, input the number of top structures to display in the table. That number is shown in the Information line at the bottom of the panel as "Displaying nn of a total…". The "Create Multiple System Graph" function generates one graph showing different SYSIDs on the same CEC. More details are in the “Multiple System Graph Creator” section. There are several Coupling Facility Encryption graphs viewable on the Graph menu.

Estimated CF Encryption CPU Cost Graph

This chart shows the estimated change in CPU seconds for exploiting the CF structure encryption function for the selected structures. The estimated CPU change is summed for each structure by the Coupling Facility where the structure resides. The y-axis shows the estimated number of CPU seconds by Coupling Facility.

The x-axis shows the estimated change in CPU seconds across time to encrypt the selected structures. The time shown on the x-axis is governed by the time filter used when the chart was generated.

Estimated CF Encryption MIPS Graph

This chart shows the estimated cost in MIPS for exploiting the CF structure encryption function for the selected structures. The y-axis shows the estimated number of MIPS summed for all structures and for all Coupling Facilities. The chart shows the estimated MIPS cost for the LPAR which represents the data supplied to zBNA. By defining one or more alternate processors which are a different server technology, (i.e. the LPAR is on a z13 and a z14 is set as an alternate processor), it is possible to see the different estimated MIPS costs for the selected structures by server technology. The x-axis shows the estimated change in MIPS across time for the current LPAR and any defined alternate processors. Within the legend is the estimated MIPS ratings for the selected processors as estimated by zPCR. As you can see above, it is 101,291 MIPs for the current processor. Care needs to be exercised with this MIPS estimate. The CPU numbers provided are for GCP seconds and this is used to derive the MIPS and MSU estimated values. However, if the encryption activity is done on a zIIP processor then portions of the CPU costs will be zIIP seconds. This estimate is given in GCP equivalents because the CF structure encryption support is not sensitive to engine type; GCP or zIIP. This estimate should be viewed as a conservative estimate of MIPS

usage. zBNA converts the CPU seconds into MIPS, so you can see the amount of additional capacity required on this z13 to support CF structure encryption.

Estimated CF Encryption MSU Graph

This chart shows the estimated cost in MSUs for exploiting the CF structure encryption function for all selected structures. The y-axis shows the estimated number of MSUs for all structures. The chart shows the cost in MSUs for the LPAR which represents the data supplied to zBNA. By defining one or more alternate processors which are a different server technology, (i.e. the LPAR is running on a z13 and a z14 is selected as an alternate processor), it is possible to see the different estimated MSU costs for the selected data sets by different server technology.

The x-axis shows the estimated change in MSUs across time for the current LPAR and any defined alternate processors. The time shown is governed by the time filter used when the chart was generated. Care needs to be exercised with this MSU estimate. The CPU numbers provided are for GCP seconds and this is used to derive the MIPS and MSU estimated values. However, if the encryption activity is done on a zIIP processor then portions of the CPU costs will be zIIP seconds which do not carry MSU charges. This estimate is given in GCP equivalents because the CF support is not sensitive to engine type; GCP or zIIP. This estimate should be viewed as a conservative estimate of MSU costs.

Within the legend for the current processor and any defined alternate processors are the MSU ratings for the selected processors.

Estimated CF Encryption Gigabytes per Hour Graph

This chart shows the estimated Coupling Facility data transfer in GBs for the hour summed across all selected structures and all selected Coupling Facilities. The data on the y-axis will show the GBs per hour for structures which are currently encrypted and structures which are eligible for encryption but are not yet encrypted.

The x-axis shows for the identified structures the estimated data transfer rate in GBs per hour across time. The time shown on the x-axis is governed by the time filter used when the chart was generated.

zHyperLink The top zHyperLink (zHL) data set candidates are determined by the total number of HyperLink Eligible I/Os, (in descending order). There are several characteristics displayed by each data set. By default, the data set activity is summarized by all Service Classes and Jobs (that is why ALL is displayed in Service Class and Job Name). Additional information includes Type, Block Size, Total I/O Number, zHL Active (No or Yes), % zHL Eligible, % zHL Hit, Average I/O Response, New zHL Estimated Response Time, and % Improvement.

In addition to the zHL I/O response time improvement, there is an additional value for zHL, in that the I/O remains connected, thus there is no z/OS re-dispatch time. zBNA provides a current time of Average Re-Dispatch and Response time (sum of Average I/O Response and specified Re-Dispatch time), and then an estimate of the New zHL Estimated Re-Dispatch and Response (essentially factoring in zHL Eligible DASD Cache Hits and elimination of Re-Dispatch Time for those Hits). Finally, it shows the % Improvement with Re-Dispatch.

Understanding the Table for Data Set Candidates that are zHyperLink Eligible

Data Set Type Indicates access method of the data set and the file type.

Block Size Indicates the allocated block size of the data set.

Total IO Number Count of data set I/Os as reported by the SMF 42.6 records.

zHL Active Yes | No | Mixed. Indicates if the data set is already using zHyperLink.

% zHL Eligible The percent of the I/O that is eligible to use zHyperLink (if the system had all of the necessary support.)

% zHL Hit The percent of the eligible for zHyperLink I/O that was identified as a cache hit by the 42.6 records.

Average IO Response Time

The average response time in milliseconds for the data set as reported by the SMF 42.6 across the intervals. If the data set is active across multiple intervals a normalized value is calculated using the I/O rates as the weighting factor.

Estimated Response Time with zHL

The estimated average response time in milliseconds for the data set as projected should all eligible I/O use zHyperLink across the intervals. If the data set is active across multiple intervals a normalized value is calculated using the I/O rates as the weighting factor.

% Improvement The percent improvement of the estimate over the Avg IO Response Time

Avg. Re-Dispatch + Response Time

The addition of the Avg. IO Response Time with the user specified Re-Dispatch Time shown in milliseconds.

Estimated Re-Dispatch + Response Time with zHL

The estimated average re-dispatch plus response time in milliseconds for the data set as projected should all eligible I/O use zHyperLink across the intervals. If the data set is active across multiple intervals a normalized value is calculated using the I/O rates as the weighting factor.

% Improvement with Re-Dispatch

The percent improvement of the estimated over the Average Re-Dispatch + Response Time.

zHyperLink Data Set Analysis The list of graphs is on the Graph menu.

zHyperLink IO Rate Graph

For this data, zBNA shows the “not zHyperLink but eligible” for zHyperLink I/O rate, and also the “Total DASD I/O”. In this case, it is likely that DB2 tablespaces are accessed both in Synchronous mode and in Prefetch mode. DB2 Prefetch I/O consists of more than one block, which are not eligible for zHyperLink. Since DB2 synchronous reads hits (4k in size) are the first exploiter of zHyperLink, this represents the total activity and zHL potential I/Os of the selected DB2 subsystem.

Average Response Time Graph

For this data, zBNA shows the “Current” DASD response for the eligible data sets and the new “Estimated with zHyperLink” response time. zHyperLink can improve the I/O response time down in the range of 25 microseconds for cache hits, but there are also some I/Os that remain, and often have much larger response times than the random read cache hits in the “Current.” The “Estimated with zHyperLink” includes this weighted analysis so as to depict the new DASD data set response time that one would see in the SMF 42-6 record. As noted above, it is likely that DB2 tablespaces are accessed both in Synchronous mode and in Prefetch mode. DB2 Prefetch I/O consists of more than one block, which are not eligible for zHyperLink. Since DB2 synchronous read hits (4k in size) are the first exploiter of zHyperLink, this represents the weighted total response for the zHL eligible I/Os of the selected DB2 subsystem.

Re-Dispatch and Average Response Time Graph

For this data, zBNA shows the “Current” DASD response for the eligible data sets and the new “Estimated with zHyperLink” re-dispatch and response time. zHyperLink can improve the I/O response time down in the range of 25 microseconds for cache hits, but there are also some I/Os that remain, and often have much larger response times than the random read cache hits in the “Current.” The “Estimated with zHyperLink” includes this weighted analysis added to the user specified re-dispatch time.

Multiple System Graph Creator zBNA generates a graph showing different SYSIDs on the same CEC. This function is available in the zEDC, Encryption, and zHyperLink applications using Action, Create Multiple System Graph. Notes: While displaying any of these graphs, use:

1. File, Create CSV file – Graph data to create a CSV file containing that graph’s data.

2. Action, Create Multiple System Graph to allow the load of multiple CSVs saved from the graphs within the applications (zEDC, Encryption, zHyperLink), and aggregate them together to get a “multi-system” graph. The CSVs loaded must contain the same graph from different SYSIDs that are on the same CEC. For example, to show a chart of the projected zEDC cards for SYS1 and SYS2 combined, perform these steps.

• Load the .edf/.dat for SYS1. • Go to the zEDC Compression function. • Display the Projected zEDC Cards graph. • Create the CSV file. • Return to the zBNA main panel. • Load the .edf/.dat for SYS2. • Go to the zEDC Compression function. • Display the Projected zEDC Cards graph. • Create the CSV file.

Click Action, Create Multiple System Graph then follow the instructions on the “zBNA zEDC Graph Aggregator” panel to select the CSV files, and display the graph showing the data for both SYS1 and SYS2.

Click Load Graph CSVs to display a dialogue panel to select multiple CSV files that were created of one type of an application’s (zEDC, Data Set/Coupling Facility Encryption, or zHyperLink) graph for different SYSIDs on the same CEC.

Make the file selection then click Open, and zBNA displays the "Message" panel informing you whether or not the time filters were applied on the "zBNA Filters" panel.

Click OK to display the Multiple System Graph.

Notice that the Multiple System Graphs tab is added on the "zBNA Encryption" panel. This graph can be output in an HTML report file using Report, Output Graph.

Input a new file name for the HTML file. An existing HTML file may be used as well by navigating to it and selecting it in the list.

Click Save to display the zBNA confirmation panel to add the graph in the existing file.

Click Append, and the HTML is updated with the graph.

With the Multiple System Graphs tab enabled, use the Graph menu to show the list of graphs that have been aggregated.

Another form of output that can be generated is the CSV of the graph displayed. Use File, Create CSV file – Graph data.

zBNA Saved HTML Report The “.htm” file that is created can be opened in a browser or Microsoft Word. The corresponding graph(s) will automatically be read into the file when it is open.

The zEDC Compression report contains the “.htm” (text), “zBNA logo.png” (cover page graph), and “xxxxnnnn.jpg” (zEDC graph, if appended). When these objects are loaded together, they can be saved in Portable Document Format (.pdf), if a PDF software converter is available like Adobe Acrobat. You can also compress the files into a single one to distribute to others.

The main zBNA report contains the “.htm”, “zBNA logo.png”, “gradient.png” (image that is included in the legend on the main zBNA graph), “xxxxnnnn.jpg” (main zBNA graph).