Using D3R2EC To Extract Encrypted Paging Metrics From Monitor

With z14 and z/VM APAR VM65993, z/VM can now encrypt guest pages to paging DASD. With this support, metrics were added to z/VM to help the z/VM system administrator understand how many pages are being encrypted and decrypted a second and the percent CPU being consumed for each task.

This article describes the new D3R2EC tool that reports on the new paging encryption information found in monitor record D3 R2 MRSTORSP. The article describes how to do the extraction and what the calculated metrics mean.

How to Collect the Data

To collect the data, run CP Monitor with processor domain samples enabled. The encrypted paging performance information lands in the D3 R2 monitor records. To make a recording of the monitor records, run MONWRITE. If you need help running MONWRITE, refer to this article.

How to Reduce the Data

Once you have a MONWRITE file, you can use the D3R2EC tool to obtain the metrics in a human-readable format. The process amounts to this:

Start with a MONWRITE file that contains D3 R2 records.
Run the D3R2EC tool against the MONWRITE file. The D3R2EC takes the MONWRITE file as input and produces the report file as output. The report file will have CMS filetype $D3R2EC.

Appearance of the $D3R2EC Report

The encrypted paging metrics describe the rate of 4 KB pages encrypted and decrypted by each logical processor and the percent CPU used to accomplish these tasks by each logical processor over time. The resulting tabular report bears a vague resemblance to a Performance Toolkit By-Time report.

Here is an excerpt of an encrypted paging report. The report is wide; on this web page, for page rendering purposes, we have broken the columns into groups.

The workload here was entirely contrived for internal lab purposes; the values in the report mean absolutely nothing as far as customer workload expectations are concerned.

The report consists of the rate of pages encrypted and decrypted by each logical processor and the percent CPU used by each logical processor.

D3R2 Encrypted paging report for file: A05Y9152 MONDATA Interval <------- Rate of Pages --------> __Ended_ Type LPU_ _Enc+Dec__ Encrypted_ Decrypted_ >>Mean>> IFL 0 19451.25 11662.78 7788.47 >>Mean>> IFL 1 19036.57 9766.84 9269.73 >>Mean>> IFL 2 19153.36 9761.35 9392.01 >>Mean>> IFL 3 19010.73 9657.54 9353.18 >>Mean>> IFL 4 19131.78 9685.10 9446.68 >>Mean>> IFL 5 21139.60 9656.43 11483.17 >>Mean>> IFL 6 21351.01 9744.53 11606.48 >>Mean>> IFL 7 21167.82 9827.81 11340.01 >>Total> .... 8 159442.12 79762.38 79679.73 15:27:27 IFL 0 14500.07 9057.13 5442.94 15:27:27 IFL 1 15452.78 8950.06 6502.72 15:27:27 IFL 2 15215.59 8310.86 6904.73 15:27:27 IFL 3 14394.43 7823.19 6571.24 15:27:27 IFL 4 14700.28 8225.17 6475.11 15:27:27 IFL 5 18332.57 8317.30 10015.27 15:27:27 IFL 6 18304.86 8439.71 9865.15 15:27:27 IFL 7 18117.23 8296.26 9820.97 >>Total> .... 8 129017.81 67419.68 61598.13 (continued) <------ Percent CPU busy ------> _Enc+Dec__ __Encrypt_ __Decrypt_ 2.45044 1.71205 0.73840 2.31351 1.43584 0.87766 2.32062 1.43352 0.88710 2.32729 1.43122 0.89607 2.33772 1.43319 0.90453 2.50907 1.42566 1.08341 2.53488 1.44154 1.09333 2.52316 1.45072 1.07244 19.31669 11.76374 7.55294 1.83363 1.33507 0.49856 1.91393 1.31984 0.59409 1.85513 1.22522 0.62991 1.78056 1.17005 0.61051 1.82524 1.22422 0.60102 2.14883 1.23835 0.91048 2.15040 1.25402 0.89638 2.12680 1.23287 0.89393 15.63452 9.99964 5.63488

The table below gives definitions for each of the columns in the report.

Column	Meaning
Encrypted Paging Statistics
Interval Ended	The hh:mm:ss of the CP Monitor interval-end time, in UTC. The first block of rows is marked ">>Mean>>" to indicate that the rows are the mean of the logical processors over the monitor interval. The first ">>Total>" row indicates the sum of logical processor ">>Mean>>" values combined over the monitor interval. The subsequent rows marked ">>Total>" indicates the sum of logical processor values combined over the interval.
Type	The logical processor type: CP, IFL, etc.
LPU	Logical processor number.
Rate of Pages Enc+Dec	Sum of the rate of 4 KB pages encrypted and decrypted by each logical processor for the monitor interval.
Rate of Pages Encrypted	Rate of 4 KB pages encrypted by each logical processor for the monitor interval.
Rate of Pages Decrypted	Rate of 4 KB pages decrypted by each logical processor for the monitor interval.
Percent CPU busy Enc+Dec	The sum of percent CPU used by each logical processor to encrypt and decrypt the pages for the monitor interval.
Percent CPU busy Encrypt	Percent CPU used by each logical processor to encrypt the pages for the monitor interval.
Percent CPU busy Decrypt	Percent CPU used by each logical processor to decrypt the pages for the monitor interval.