|
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 252 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 232 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.
048 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.
252 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 V5R1.0.
Last updated on 13 Sep 2004 at 11:25:22.
Copyright IBM Corporation, 1990, 2004