|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRSYTCPC
PrologControl Block Contents
Cross Reference
MRSYTCPC Prolog
DSECT NAME - SYTCPC
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRSYTCPC
DESCRIPTIVE NAME - Monitor Sample Record
Domain 0 - System Domain
Record 9 - Physical Channel Path Contention Data
DESCRIPTION - Channel Path Contention data, based entirely
on high frequency sampling, shows the number of
times that each channel path was busy.
NOTES:
- This data is high-frequency sampling data collected by
issuing the STORE CHANNEL PATH STATUS instruction which
tests the status (busy or not busy) of all possible channel
paths. The rate of high-frequency sampling is determined
(or defaulted) by the MONITOR SAMPLE RATE command.
- When VM is running in an LPAR in Multiple Image Facility
mode, physical channel paths may be shared with other
partitions. This record reflects total usage of the physical
channel paths by all partitions. Logical channel path
utilization data for this VM partition is provided in
MRSYTCPM (domain 0, record 18) or MRSYTEPM (domain 0, record 20)
- The STORE CHANNEL PATH STATUS instruction is not useful
for providing channel path utilization data for FICON
channels. Therefore, if you are looking for information
on channel path utilization for FICON channels, the
information is provided in MRSYTCPM (domain 0, record 18)
or MRSYTEPM (domain 0, record 20).
- Starting with the z990 processor, the STORE CHANNEL PATH
STATUS instruction used to create this monitor record
will no longer return valid information. Please refer
to MRSYTEPM (domain 0, record 20) for valid channel
path utilization data.
MRSYTCPC Control Block Contents
Offsets
Dec Hex Type Len Name (Dim) Description
0 0 Structure 1252 SYTCPC start of monitor record
0 0 Character 0 SYTCPC_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 1232 SYTCPC_HFSAMPLE
20 14 Unsigned 4 SYTCPC_HFCOUNT Number of samples taken
24 18 Unsigned 4 SYTCPC_HFCHBUSY(0:255) Number of times the
corresponding channel path
was busy. Each index number
of this array corresponds to
its channel path number, 0 to
255. Example: HFCHBUSY(51) =
the number of times that
channel path no. 51 was busy.
1048 418 Unsigned 4 SYTCPC_HFCHSIM(0:50) Number of times the
corresponding number of
channel paths were
simultaneously busy. Each
index number from 0 to 49
corresponds to the total
number of channel paths that
were busy. Example:
HFCHSIM(23) = the number of
times that 23 channel paths
were active at one time. For
index number 50, this is the
number of times that 50 or
more channel paths were
simultaneously busy.
1252 4E4 Character 0 SYTCPC_END
MRSYTCPC 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
SYTCPC 0 1252
SYTCPC_END 4E4 0
SYTCPC_HFCHBUSY 18 1024
SYTCPC_HFCHSIM 418 204
SYTCPC_HFCOUNT 14 4
SYTCPC_HFSAMPLE 14 1232
SYTCPC_MRHDR 0 0
This information is
based on z/VM V6R2.0.
Last updated on 23 Nov 2011 at 15:33:04.
Copyright IBM Corporation, 1990, 2011