| Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTEPM
PrologControl Block Contents
Storage Layout
Cross Reference
MRSYTEPM Prolog
DSECT NAME - SYTEPM
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTEPM
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 20 - Extended Channel Measurement Data (per channel)
DESCRIPTION - Provide utilization data & measurement characteristic
data for a valid channel path in the channel subsystem
NOTES:
- This record is generated for a valid channel path defined
in the channel subsystem only when the Channel-Path
Measurement Facility (CPMF) with extended channel measurements
(MTRSYS_SYSECPMF is on) is installed on the system.
If it isn't installed, but CPMF without extended channel
measurements (MTRSYS_SYSCPMF is on) is installed, then the
MRSYTCPM Monitor record will be generated instead of this one.
If both are installed, CPMF with extended channel measurements
(MRSYTEPM) will be used exclusively.
A key difference between the two records is that an MRSYTCPM
contains information for all chpids, while MRSYTEPM contains
information for only one valid chpid.
- When VM is running native, this record will be
generated only when the Channel-Path Measurement
Facility with extended channel measurements is installed.
- When VM is running in an LPAR in Multiple Image Facility
mode, physical channel paths may be shared with other
partitions. The data provided in this record represents
channel utilization attributable to the logical partition
in which VM is running (as well as data for the whole CPC).
- When VM is running second level, the Channel-Path
Measurement Facility with extended channel measurements
is not installed. Thus this record will not be generated.
- SYTEPM_CALOFST1 should always be used to locate the
Channel Utilization Entry (SYTEPM_ECMENTRY) area.
- SYTEPM_CALOFST2 should always be used to locate the
Channel Measurement Characteristics (SYTEPM_CSCCMCBD) area.
- A channel utilization entry is constructed independently, on a
schedule chosen by the channel subsystem (CSS), rather than
at the monitor sample interval. Thus, the analysis program
must look at the timestamp and data in a channel utilization
entry, subtract from them the corresponding values in
the previous record, and then divide to get the data
as a fraction of the interval between the two samplings
*by the CSS* of that channel path's statistics. Two
consequences of this extra "layer" of sampling are:
1) Reducing the monitor sample interval will not necessarily
give finer-grained statistics for channel path usage.
2) Depending on when the monitor samples occur with respect
to the channel subsystem's samples, the intervals between
successive records may vary substantially. For example,
if the channel subsystem samples every 5 seconds and monitor
writes a sample record every 8 seconds, then on average,
three out of five times, the difference between monitor
records will represent 5 seconds of channel-path activity,
and the other two out of five times, the difference will
represent 10 seconds of activity.
Finally, note that the timestamp and data for the
channel path might be identical to that in the previous
record, if the CSS has not updated the information in the
interval. In this case, there is effectively no interval
reported on between this pair of records, a later record
with a different timestamp must be used to compute usage
for the channel path.
- If the SYTEPM_CALINIT bit is ON, then the entry represents the
start of a new reporting "epoch" for the channel path. A
discontinuity in the timer values may have occurred since
the sample in the previous SYTEPM record. That is, the
timestamp and data in this entry are valid, but are not
related to the corresponding values in the previous monitor
record. The values in this record can only be used as a
starting point for the interval between this record and the
one after it. No information can be deduced about the
activity during the period between the time of the previous
record's sample for this channel path and that of this
record's sample.
- The first valid channel utilization entry recorded for each
channel path will always have SYTEPM_CALINIT ON in the
channel measurement characterisitics.
- The data is this record contains information specific to the
channel measurement group (CMG) type. To determine the CMG
type look at SYTEPM_CSCCMCCG field. This value determines the
contents and format of the CMG-dependent channel-measurement-
characteristics area (SYTEPM_CSCCMCMD), and the contents and
format of the channel-utilization entry for the associated
channel path (SYTEPM_ECMCMGD).
MRSYTEPM Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 40 SYTEPM
0 0 Character 0 SYTEPM_MRHDR Record header. See MRRECHDR for
details.
0 0 Character 20 MRHDR
0 0 Unsigned 2 MRHDRLEN record length in bytes
2 2 Unsigned 2 MRHDRZER field of zeros
4 4 Unsigned 1 MRHDRDM domain identifier
5 5 Unsigned 1 *
6 6 Unsigned 2 MRHDRRC record identifier
8 8 Character 8 MRHDRTOD Time at which this record was
built. In time-of-day (TOD) clock
format. See IBM System 370 XA
Principle of Operation for
explanation of format.
16 10 Character 4 *
20 14 Character 0 MRHDR_END End of header
20 14 Character 1 SYTEPM_CALCHPID Channel Path ID
21 15 Character 3 * Reserved and available for IBM
use.
24 18 Signed 4 SYTEPM_CALOFST1 Byte offset, relative to the
start of this record, to
SYTEPM_ECMENTRY.
28 1C Signed 4 SYTEPM_CALLEN1 Byte size of SYTEPM_ECMENTRY
32 20 Signed 4 SYTEPM_CALOFST2 Byte offset, relative to the
start of this record, to
SYTEPM_CSCCMCBD
36 24 Signed 4 SYTEPM_CALLEN2 Byte size of SYTEPM_CSCCMCBD
40 28 Character 0 *
0 0 Structure 32 SYTEPM_ECMENTRY
Channel Utilization Entry
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Bitstring 1 SYTEPM_ECMCUIV Channel-Utilization-Information
Validity (CUIV) - bits of the CUIV
map indicate which words in the
Channel-Utilization Entry contain
valid channel- utilization
information.
1... .... SYTEPM_ECMCUIVW0 Bytes 1-3 of Word 0 contain
valid info (the contents of Byte 0
of Word 0 are always valid).
.1.. .... SYTEPM_ECMCUIVW1 Word 1 contains valid info
..1. .... SYTEPM_ECMCUIVW2 Word 2 contains valid info
...1 .... SYTEPM_ECMCUIVW3 Word 3 contains valid info
.... 1... SYTEPM_ECMCUIVW4 Word 4 contains valid info
.... .1.. SYTEPM_ECMCUIVW5 Word 5 contains valid info
.... ..1. SYTEPM_ECMCUIVW6 Word 6 contains valid info
.... ...1 SYTEPM_ECMCUIVW7 Word 7 contains valid info
1 1 Bitstring 3 SYTEPM_ECMTSTMP Timestamp in units of 128
microseconds. It identifies when
info was last stored in the
channel-utilization entry
4 4 Character 28 SYTEPM_ECMCMGD
4 4 Unsigned 4 SYTEPM_ECMCPBT_CPC CMG 1 - Word 1 Channel-Path-Busy
Time (CPC) - contains the
accumulation of all measured
channel-path-busy intervals for
the associated channel path. If
the CPC is in LPAR mode, this
value includes channel-path-busy
intervals associated with all
LPARs having access to this
channel path.
4 4 Unsigned 4 SYTEPM_ECMCBC_CPC CMG 2 Word 1 Count of Bus Cycles
(CPC) - accumulated count of the
internal bus cycles that have been
used for I/O operations on this
channel path. If the CPC is in
LPAR mode, this count includes the
internal bus cycles that were used
for I/O operations for all LPARs
having access to this channel
path.
4 4 Unsigned 4 SYTEPM_ECMMSNT CMG 3 Word 1 Messages Sent -
accumulated count of the number of
messages that have been sent by
programs, in the issuing logical
partition, when using the
associated channel path.
8 8 Unsigned 4 SYTEPM_ECMCPBT CMG 1 - Word 2 -
Channel-Path-Busy Time - When the
CPC is in LPAR mode this field
contains the accumulation of all
measured channel-path-busy
intervals for this channel path
that are associated with the LPAR
that has access to this
channel-utilization block. If the
CPC is operating in basic mode,
then this field has no meaning.
8 8 Unsigned 4 SYTEPM_ECMCCWU_CPC CMG 2 Word 2 - Count of Channel
Work Units (CPC)- accumulated
count of the number of channel
workunits that have been
performed by this channel path.
If the CPC is in LPAR mode the
count includes the channel
work units that were performed
for all LPARs that have access
to this channel path.
8 8 Unsigned 4 SYTEPM_ECMMSNT_CPC CMG 3 Word 2 - Messages Sent
(CPC) - accumulated count of the
number of messages that have been
sent when using the associated
channel path. The count includes
messages sent for all logical
partitions that have access to the
associated channel path.
12 C Unsigned 4 * CMG 1 Word 3 - Reserved and
available for IBM use.
12 C Unsigned 4 SYTEPM_ECMCCWU CMG 2 Word 3 Count of Channel
Work Units - When the CPC is in
LPAR mode this field contains the
accumulated count of the number of
channel work units that have been
performed by this channel path for
the LPAR that has access to this
channel- utilization block. If the
CPC is operating in basic mode,
then this field has no meaning.
12 C Unsigned 4 SYTEPM_ECMUATS CMG 3 Word 3 - Unsuccessful
Attempts to Send - accumulated
count of the number of
unsuccessful attempts to send
messages by programs in the
issuing logical partition when
using the associated channel path.
This count includes all
unsuccessful attempts to send
messages except when the attempt
failed due to an unavailable
buffer in the receiving logical
partition.
16 10 Unsigned 4 * CMG 1 Word 4 - Reserved and
available for IBM use.
16 10 Unsigned 4 SYTEPM_ECMCDUW_CPC CMG 2 Word 4 - Count of Data
Units Written(CPC) accumulated
count of the number of data units
that have been written using this
channel path. Note: The
channel-measurement-
characteristics block (see
HCPCSCBK) for the associated
channel path specifies the number
of bytes contained in a data unit.
If the CPC is in LPAR mode, the
count includes the data units that
were written for all LPARs that
have access to this channel path.
16 10 Unsigned 4 SYTEPM_ECMURB CMG 3 Word 4 - Unavailable
Receive Buffers - accumulated
count of the number of times
messages sent to the issuing
partition failed due to
unavailable receive buffers in the
issuing logical partition.
20 14 Unsigned 4 * CMG 1 Word 5 - Reserved and
available for IBM use.
20 14 Unsigned 4 SYTEPM_ECMCDUW CMG 2 Word 5 - Count of Data
Units Written - When the CPC is in
LPAR mode this field contains the
accumulated count of the number of
data units that have been written
using this channel path for the
LPAR that has access to this
channel- utilization block. If the
CPC is operating in basic mode,
then this field has no meaning.
20 14 Unsigned 4 SYTEPM_ECMURB_CPC CMG 3 Word 5 - Unavailable
Receive Buffers(CPC) accumulated
count of the number of times
messages sent to a target
partition failed due to
unavailable buffers in in the
target partition. The count
includes all unsuccessful attempts
by programs in all logical
partitions that have access to the
associated channel path.
24 18 Unsigned 4 * CMG 1 Word 6 - Reserved and
available for IBM use.
24 18 Unsigned 4 SYTEPM_ECMCDUR_CPC CMG 2 Word 6 - Count of Data
Units Read (CPC) - accumulated
count of the number of data
units that have been read using
this channel path.
Note: The channel-measurement-
characteristics block (HCPCSCBK)
for the associated channel
path specifies the number of
bytes contained in a data
unit. If the CPC is in LPAR
mode the count includes the
data units that were read for
all LPARs that have access to
this channel path.
24 18 Unsigned 4 SYTEPM_ECMDUS CMG 3 Word 6 - Data Units Sent -
accumulated count of the number of
data units that have been sent by
programs in the issuing logical
partition when using the
associated channel path.
28 1C Unsigned 4 * CMG 1 Word 7 - Reserved and
available for IBM use.
28 1C Unsigned 4 SYTEPM_ECMCDUR CMG 2 Word 7 Count of Data Units
Read - When the CPC is in LPAR
mode this field contains the
accumulated count of the number of
data units that have been read
using this channel path for the
LPAR that has access to this
channel-utilization block. If the
CPC is operating in basic mode,
then this field has no meaning.
28 1C Unsigned 4 SYTEPM_ECMDUS_CPC CMG 3 Word 7 - Data Units Sent
(CPC) - accumulated count of the
number of data units that have
been sent using the associated
channel path. The count includes
all data units sent by all logical
partitions that have access to the
assoc. channel path.
0 0 Structure 28 SYTEPM_CSCCMCBD
Channel-Measurement Characteristics
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Bitstring 1 SYTEPM_CSCCMCFL Flags
1... .... SYTEPM_CSCCMCNV CHPID not valid, no info
.1.. .... SYTEPM_CSCCMCSH Shared Channel Path
..1. .... *
...1 .... *
.... 1... *
.... .1.. *
.... ..1. *
.... ...1 SYTEPM_CALINIT Initial data flag. When this bit
is ON, and SYTEPM_CMCNV is OFF,
the corresponding channel path
data is valid only as the start of
an epoch, i.e., the data in this
entry cannot be used in
conjunction with a previous SYTEPM
record to deduce usage in the
previous interval, because a
discontinuity may have occurred in
the timestamp and data
accumulation.
1 1 Character 2 * Reserved and available for IBM
use.
3 3 Character 1 SYTEPM_CSCCMCCP CHPID
4 4 Bitstring 1 SYTEPM_CSCCMCCV Chan-Meas-Chars Validity
1... .... SYTEPM_CSCCMCV3 Word 3 had valid info
.1.. .... SYTEPM_CSCCMCV4 Word 4 had valid info
..1. .... SYTEPM_CSCCMCV5 Word 5 had valid info
...1 .... SYTEPM_CSCCMCV6 Word 6 had valid info
.... 1... SYTEPM_CSCCMCV7 Word 7 had valid info
.... .1.. *
.... ..1. *
.... ...1 *
5 5 Character 1 * Reserved and available for IBM
use.
6 6 Bitstring 1 SYTEPM_CSCCMMGQ Channel Measurement Group
Qualifier (CMGQ)
7 7 Bitstring 1 SYTEPM_CSCCMCMG Channel Meas Group (CMG)
8 8 Character 4 * Reserved and available for IBM
use.
12 C Character 20 SYTEPM_CSCCMCMD CMG Dependent Area
12 C Unsigned 4 SYTEPM_CSCCMCMB Maximum internal bus cycles per
second, available for I/O
operations on the specified
channel path
16 10 Unsigned 4 SYTEPM_CSCCMCMC Maximum number of channel work
units that can be performed per
second by the specified channel
path
20 14 Unsigned 4 SYTEPM_CSCCMCMW Maximum number of data units
that can be written per second
using the specified channel path
24 18 Unsigned 4 SYTEPM_CSCCMCMR Maximum number of data units
that can be read per second using
the specified channel path
28 1C Unsigned 4 SYTEPM_CSCCMCMU The number of bytes of data that
are contained in a data unit for
the specified channel path
MRSYTEPM Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
SYTEPM 0 40
SYTEPM_CALCHPID 14 1
SYTEPM_CALINIT 0 01
SYTEPM_CALLEN1 1C 4
SYTEPM_CALLEN2 24 4
SYTEPM_CALOFST1 18 4
SYTEPM_CALOFST2 20 4
SYTEPM_CSCCMCBD 0 28
SYTEPM_CSCCMCCP 3 1
SYTEPM_CSCCMCCV 4 1
SYTEPM_CSCCMCFL 0 1
SYTEPM_CSCCMCMB C 4
SYTEPM_CSCCMCMC 10 4
SYTEPM_CSCCMCMD C 20
SYTEPM_CSCCMCMG 7 1
SYTEPM_CSCCMCMR 18 4
SYTEPM_CSCCMCMU 1C 4
SYTEPM_CSCCMCMW 14 4
SYTEPM_CSCCMCNV 0 80
SYTEPM_CSCCMCSH 0 40
SYTEPM_CSCCMCV3 4 80
SYTEPM_CSCCMCV4 4 40
SYTEPM_CSCCMCV5 4 20
SYTEPM_CSCCMCV6 4 10
SYTEPM_CSCCMCV7 4 08
SYTEPM_CSCCMMGQ 6 1
SYTEPM_ECMCBC_CPC 4 4
SYTEPM_ECMCCWU C 4
SYTEPM_ECMCCWU_CPC 8 4
SYTEPM_ECMCDUR 1C 4
SYTEPM_ECMCDUR_CPC 18 4
SYTEPM_ECMCDUW 14 4
SYTEPM_ECMCDUW_CPC 10 4
SYTEPM_ECMCMGD 4 28
SYTEPM_ECMCPBT 8 4
SYTEPM_ECMCPBT_CPC 4 4
SYTEPM_ECMCUIV 0 1
SYTEPM_ECMCUIVW0 0 80
SYTEPM_ECMCUIVW1 0 40
SYTEPM_ECMCUIVW2 0 20
SYTEPM_ECMCUIVW3 0 10
SYTEPM_ECMCUIVW4 0 08
SYTEPM_ECMCUIVW5 0 04
SYTEPM_ECMCUIVW6 0 02
SYTEPM_ECMCUIVW7 0 01
SYTEPM_ECMDUS 18 4
SYTEPM_ECMDUS_CPC 1C 4
SYTEPM_ECMENTRY 0 32
SYTEPM_ECMMSNT 4 4
SYTEPM_ECMMSNT_CPC 8 4
SYTEPM_ECMTSTMP 1 3
SYTEPM_ECMUATS C 4
SYTEPM_ECMURB 10 4
SYTEPM_ECMURB_CPC 14 4
SYTEPM_MRHDR 0 0
This information is
based on z/VM V4R3.0.
Last updated on 11 Jun 2002 at 16:20:55.
Copyright IBM Corporation, 1990, 2002