EXTDATA Record Types

EXTDATA Reporting › CA Earl and CA Easytrieve SMF Data Dictionary › EXTDATA Record Types - SIEZ

EXTDATA Record Types - SIEZ

The SIEZ record reports statistics from a zVM session. A zVM session is identified as all the accounting records that match these four fields:

User ID
Account Number
Logoff Date
Logoff Time

Each zVM session can generate multiple accounting records of types 1, 2, and 3. zVM 5.3 type 1 "continuation" records offer a detailed view of each special processor attached to the virtual machine: zIIP, zAAP, IFL, and CF. (The continuation records contain CPU use fields only. The other resource use fields are blank.)

CA JARS summarizes these accounting records into a single SIEZ EXTDATA record. Each numeric field in the SIEZ record, with the exception of the CP matrix, is the sum of all the measures from each of the accounting records generated by the session. A CPU-by-CPU breakdown of CP use is included in the SIEZ record as a matrix of values identified by real CP addresses. See sample report EZXTZ002 in the Reports Guide for an example of how to format the matrix.

This table contains the record layout. For more information, see "The VM Interface" in the Interfaces Guide. To help you identify the accounting record fields, see the information on the columns in the virtual accounting records in the chapter entitled, "Accounting Record Formats" in z/VM CP Planning and Administration version 5 release 3 (SC24-6083). You can also review the information on the Virtual Machine Definition Block (VMDBK), which does not map the accounting records but describes the source of many VM accounting record fields.

EXTDATA Variable Name	Acct. Rec. Type	Columns	Description
EXTSIEZ_USERID	1	1-8	User ID
EXTSIEZ_ACCNT1	1	9-16	Account number
EXTSIEZ_ACCNT2			Accounting field from User Accounting Table (see Chapter 8 of the Interfaces Guide for more information)
EXTSIEZ_DATE	1	17-28	Date and time of accounting (mmddyyhhmmss). This is the logoff date.
EXTSIEZ_TIME			Logoff time (hhmmss)
EXTSIEZ_CONTO	1	29-32	Number of seconds connected to CP. This is the sum of connect times in each type 1 accounting record associated with this session. =SUM(EXTSIEZ_CONTM(n))
EXTSIEZ_CONMX			The longest connect time for any CP attached to the session. This is the best estimate of session length. =MAX(EXTSIEZ_CONTM(n))
EXTSIEZ_CPUTN	1	33-36	Milliseconds of processor time used, including time for supervisor functions =SUM(EXTSIEZ_CPTN(n))
EXTSIEZ_CPUVT	1	37-40	Milliseconds of virtual CPU time used. This is "user" time, or the CPU doing the work of the virtual machine rather than overhead functions. =SUM(EXTSIEZ_CPVC(n))
EXTSIEZ_VIPRT	1	41-44	Number of page reads
EXTSIEZ_VIPUN	1	45-48	Number of page writes
EXTSIEZ_PGRD	1	49-52	Number of requested virtual I/O starts for non-spooled I/O
EXTSIEZ_PGWRT	1	53-56	Number of virtual punch cards sent to a virtual punch
EXTSIEZ_VIOST	1	57-60	Number of virtual print lines sent to a virtual printer (this includes one line for each carriage control command)
EXTSIEZ_VIPRD	1	61-64	Number of virtual punch cards received from a virtual reader
EXTSIEZ_TOTVT	1		Milliseconds of total vector time (obsolete)
EXTSIEZ_VIRVT	1		Milliseconds of virtual vector time (obsolete)
EXTSIEZ_VIONS	1	73-76	Number of completed virtual I/O starts for non-spooled I/O (except DIAGNOSE X'58' and DIAGNOSE X'98')
EXTSIEZ_DSKNM			Count type 2 DEVCLAS=Disk. Device class (defined below) has the X'04' bit set on.
EXTSIEZ_DSKTM	2	29-32	Number of seconds since the virtual disk was created or the number of seconds since the last accounting record was cut for this virtual disk. Summed over all type 2s with DEVCLAS=DISK.
EXTSIEZ_TAPCT			Count type 2 DEVCLAS=Tape. Device class (defined below) has the X'08' bit set on.
EXTSIEZ_TAPTM	2	29-32	Number of seconds since the virtual tape was created or the number of seconds since the last accounting record was cut for this virtual tape. Summed over all type 2s with DEVCLAS=Tape.
	2	33	Device class (see note 1 below)
	2	34	Device type (see note 1 below)
	2	35	Device model, if any (see note 1 below)
	2	36	Device features, if any (see note 1 below)
EXTSIEZ_TDKNE			Count of CKD type 3s. DEVCLAS=x'04' and DEVTYPE is not an FBA device.
EXTSIEZ_TDKCY	3	37-38	Number of cylinders of temporary disk space used (only present for CKD or ECKD architected device types)
EXTSIEZ_TDKNF			Count of FBA type 3s. DEVCLAS=x'04' and DEVTYPE=x'21', x'22', x'24', or x'28'.
EXTSIEZ_FBABL	3	37-40	Number of FBA blocks used (only present for FBA-architected device types)
EXTSIEZ_PAGES	3	41-44	Number of 4K pages used (present for all device types)
EXTSIEZ_CPCNT			Count of type 1s. This is the number of entries in the following CPU array. It is possible for this count to be zero if "orphan" type 2 or 3 records were encountered.
EXTSIEZ_CP_ARRAY			This scalar variable covers the entire CPU array. There is one array entry for each CP, zIIP, zAAP, IFL, or CF attached to the session. It is a workaround for limitations in CA Easytrieve.
EXTSIEZ_CPARR			This is a group variable for one instance of the CPU array structure. It is a workaround for limitations in CA Easytrieve.
EXTSIEZ_CONTM	1	29-32	Number of seconds connected to CP
EXTSIEZ_CPTN	1	33-36	Milliseconds of processor time used, including time for supervisor functions
EXTSIEZ_CPVC	1	37-40	Milliseconds of virtual CPU time used.
EXTSIEZ_VCPTP	1	65	Virtual CPU type code (see note 2 below)
EXTSIEZ_RCPTP	1	66	Real CPU type code (see note 2 below)
EXTSIEZ_CPUAD	1	77-78	CPU address (if the user ID is SYSTEM, this is the real processor address)
EXTSIEZ_RSRVD			Reserved

Notes:

For more information on device class, device type, device model and device features, see Appendix F, "Device Class and Type Codes" in z/VM CP Planning and Administration, Version 5, Release 3 (SC24-6083).
For zIIP and zAAP processors, these fields can be exploited to determine the actual and potential use of special processors. See sample report EZXTV002 for more information.