Previous Topic: 1.3 Reporting and Inquiry Facilities

Next Topic: 1.5 Product Prerequisites

1.4 Files Overview


The CA MICS Analyzer Option for VM/CMS uses a variety of
source records to build its information areas:

  o The VMC Information Area includes account data from all
    levels of VM systems and monitor data from VM systems.

  o The VMX Information Area includes monitor data from
    VM/ESA and z/VM.

Both information areas maintain system and user measurement
data on service, availability, load, and resource
consumption.  In addition, the VMC Information Area includes
exception data (VMCVXC) from all levels of VM systems.

This section defines the use and content of each CA MICS file
in the VMC and VMX information areas.


+------------------------+
|  VMC Information Area  |
+------------------------+

o  VM User Resource Accounting File (VMCCMU)

   The VMCCMU file quantifies the resources used by virtual
   machine.  The information in this file is derived from VM
   Account record types 01 and C1.

o  VM Device Accounting File (VMCDAC)

   The VMCDAC file identifies the allocation of dedicated
   devices and temporary disk virtual machine (user).  The
   file is created from CP account record types 02, 03, C2,
   and C3.

o  VM RSCS Accounting File (VMCVRA)

   The VMCVRA file quantifies RSCS use attributable to a
   virtual machine.  The information in this file is derived
   from CP account record type C0 as created by RSCS.

o  VM Network Terminal Usage File (VCNA) (VMCNTU)

   The VMCNTU file quantifies VCNA activity attributable to
   virtual machines.  The information in this file is derived
   from CP account record type 07.

o  VM Network Data Transmission File (VMCNDT)

   The VMCNDT file quantifies data moved over virtual devices
   such as IUCV, VCTC, and Guest LAN's attributable to
   virtual machines.  The information in this file is derived
   from CP account record type 0C.

o  VM Exception Activity File (VMCVXC)

   The VMCVXC file quantifies exception activity within the
   VM system.  The information in this file is derived from
   CP account record types 04, 05, 06, 08, and VM and Monitor
   domain 1, records 2, 3, 10, 11, and 12.

+------------------------+
|  VMX Information Area  |
+------------------------+

o  VM System Configuration File (VMXSCF)

   The VMXSCF file identifies system hardware and software
   configurations for the VM system(s) represented in the
   source data.  The information in this file is derived from
   VM Monitor domain 1, records 1, 4, 5, 7, 9 and 17.

o  VM Processor Configuration File (VMXPCF)

   The VMXPCF file identifies CPU-specific configuration
   information for the VM system(s) represented in the source
   data.  This file is created from the VM Monitor domain 1,
   record 5 and from domain 5, records 1, 2, 4, 5, 6 and 7.

o  VM System Global Data File (VMXSGP)

   The VMXSGP file quantifies VM system-level utilization,
   storage, virtual machine states, and communication
   activity.  The information in this file is derived from VM
   Monitor domain 0, records 1-19; domain 1, records 5, 7 and
   17; domain 3, records 1-3, 9, 10, and 14; domain 4,
   records 2 and 3; and domain 5, record 3.

o  VM System Processor Data File (VMXSPP)

   The VMXSPP file quantifies VM and CPU-level utilization,
   storage, virtual machine states, and communication
   activity.  This file is created from VM Monitor domain 0,
   records 1, 2, 4, 5, 11 and 13; domain 3, record 2; and
   domain 5, record 3.

o  VM Device Configuration File (VMXDCF)

   The VMXDCF file identifies I/O configuration information
   for devices and control units.  The information in this
   file is derived from VM Monitor domain 1, record 6; and
   domain 6, records 1, 2, and 5-9.

o  VM Device Activity File (VMXXDV)

   The VMXXDV file quantifies I/O activity and utilization by
   device.  This file is created from VM Monitor domain 1,
   record 6; and domain 6, record 3.

o  VM Device SEEKs Data File (VMXXDS)

   The VMXXDS file quantifies, by device, DASD arm movement
   and frequency of access.  The information in this file is
   derived from VM Monitor domain 7, record 1.

o  VM CPVOL Configuration Data File (VMXACF)

   The VMXACF file identifies VM System volume configuration.
   This file is created from VM Monitor domain 1, record 8;
   and domain 3, record 7.

o  VM CP Owned Volume Data File (VMXCPV)

   The VMXCPV file quantifies the activity on the VM system
   volumes.  The information in this file is derived from VM
   Monitor domain 1, record 8; domain 3, records 4, 7, and
   11.

o  VM User Data Configuration File (VMXVXF)

   The VMXVXF file identifies virtual machines (users) logged
   on and the configuration of the virtual machine.  The
   information in this file is derived from VM Monitor domain
   1, record 15; and domain 4, records 1, 2, and 5-7.

o  VM User Activity Sample Data File (VMXVXU)

   The VMXVXU file quantifies resource consumption of each
   virtual machine based on sampling.  This file is mainly
   created from VM Monitor domain 4, records 2 and 3; and
   domain 3, record 10.  VM Monitor domain 1, record 15, and
   domain 4, record 1 contribute to the user configuration
   information.

o  VM User Activity Event Data File (VMX_VU)

   The VMX_VU file quantifies resource consumption of each
   virtual machine at interaction end.  This file is mainly
   created from VM Monitor domain 4, record 9.  VM Monitor
   domain 1, record 15, and domain 4, record 1 contribute to
   the user configuration information.

o  VM User Transaction Sample Data File (VMXVXT)

   The VMXVXT file quantifies, based on sampling,
   interactions among users, and between users and systems
   services using IUCV and VMCF.  The information in this
   file is mainly derived from VM Monitor domain 4, record 4.
   VM Monitor domain 1, record 15, and domain 4, record 1
   contribute to the user configuration information.

o  VM User Transaction Event Data File (VMX_VT)

   The VMX_VT file quantifies, based on recording individual
   events, interactions among users, and between users and
   systems services using IUCV and VMCF.  This file is mainly
   created from VM Monitor domain 4, records 8 and 10.  VM
   Monitor domain 1, record 15, and domain 4, record 1
   contribute to the user configuration information.

o  VM Channel Path Contention File (VMXCHC)

   The VMXCHC file quantifies utilization, busy conditions,
   and queue lengths of the physical channels.  The
   information in this file is derived from VM Monitor domain
   0, record 9.

o  VM Block Paging Data File (VMXBPG)

   The VMXBPG file provides VM block paging information.
   This file is created from VM Monitor domain 3, record 8.

o  VM Shared Storage Configuration File (VMXXSF)

   The VMXXSF file identifies VM shared system
   configurations.  The information in this file is derived
   from VM Monitor domain 3, records 3, 5 and 6.

o  VM Shared Storage Management File (VMXXSS)

   The VMXXSS file quantifies VM shared system activity.  The
   information in this file is derived from VM Monitor domain
   3, record 3.

o  VM System Timer Pop File (VMXSTP)

   The VMXSTP file identifies system load as reported by the
   VM scheduler at the scheduler interval. This file is
   created from VM Monitor domain 2, record 8.

o  VM DASD Cache Activity File (VMXCDI)

   The VMXCDI file quantifies DASD cache activity for 3880-X3
   and 3990-3 subsystems.  The information in this file is
   mainly derived from VM Monitor domain 6, record 4.  VM
   Monitor domain 1, record 6 contributes to the device
   configuration information of the file.

o  VM Paging Cache Activity File (VMXCDP)

   The VMXCDP file quantifies DASD cache activity for 3880-X1
   controllers.  This file is mainly created from VM Monitor
   domain 6, record 4.  VM Monitor domain 1, record 6
   contributes to the device configuration information of the
   file.

o  VM Logical Partition Activity File (VMXLPR)

   The VMXLPR file quantifies activity for each logical
   partition in the central electronic complex when VM is
   running in a logical partition.  This file is created from
   VM Monitor domain 0, records 15-17.

o  VM LPAR Logical CPU Activity File (VMXLCP)

   The VMXLCP file quantifies activity for each logical CPU
   in the central electronic complex when VM is running in a
   logical partition.  This file is created from VM Monitor
   domain 0, records 15-17.

o  VM Scheduler Parameters File (VMXSCX)

   The VMXSCX file identifies the settings of scheduler
   tuning commands such as SET SRM IAB, SET SRM DSPSLICE, SET
   SRM LDUBUF, and SET SRM STORBUF, etc., for system resource
   management.  This file is created from VM Monitor domain
   1, record 16, and domain 2, record 7.

Figures 1-2 through 1-4 illustrate the structures of the VMC
and VMX Information Areas.

                                +----------------+         +----------------+
                                | VM or z/VM     |         |VM or z/VM      |
                                |     Monitor    |         |    Monitor     |
                                |   Event Data   |         |  Sample Data   |
                                +----------------+         +----------------+
                                         |                          |
INPUT                                    |                          |
 DATA              +---------------+     |    +---------------+     |    +---------------+
  SOURCES          |  VM  Account  |     |    |  VM  Account  |     |    |      VM       |
                   |    Resource   |     |    |    Device     |     |    |  Journaling   |
                   |  Consumption  |     |    |   Occupancy   |     |    |    Records    |
                   |    Records    |     |    |    Records    |     |    |               |
                   +---------------+     |    +---------------+     |    +---------------+
                            |            |             |            |            |
                            |            |             |            |            |
                            +----------------------------------------------------+
                                                       |
                                                       |
                                           +-----------------------+
PRODUCT                                    |         CA MICS       |
 PROCESSING                                |       VM and CMS      |
                                           |        Analyzer       |
                                           +-----------------------+
                                                       |
                                                       |
                                  +------------------------------------------+
                                  |                                          |
                                  |                                          |
                       +---------------------+                    +---------------------+
                       |    CA MICS VMC      |                    |      CA MICS VMX    |
                       |  Information Area   |                    |   Information Area  |
                       |   File Structure    |                    |    File Structure   |
                       +---------------------+                    +---------------------+

Figure 1-2. File Structure (Part 1 of 3)



                                  +-----------------------+
                                  |       CA MICS VMC     |
                                  |   Information Area    |
                                  |    File Structure     |
                                  +-----------------------+
                                              |
                                  +------------------------+
                                  |                        |
                         +-----------------+ +-----------------+
                         |   VM User       | | VM Exception    |
                         |    Resource     | |    Activity     |
                         | Accounting File | |     File        |
                         |    (VMCCMU)     | |    (VMCVXC)     |
                         +-----------------+ +-----------------+
                                  |                   |
                         +-----------------+ +-----------------+
                         |    VM Device    | |    VM Network   |
                         |    Accounting   | |Data Transmission|
                         |       File      | |       File      |
                         |     (VMCDAC)    | |     (VMCNDT)    |
                         +-----------------+ +-----------------+
                                  |
                         +-----------------+
                         |     VM RSCS     |
                         |    Accounting   |
                         |       File      |
                         |     (VMCVRA)    |
                         +-----------------+
                                  |
                         +-----------------+
                         |   VM Network    |
                         | Terminal Usage  |
                         |   File (VCNA)   |
                         |     (VMCNTU)    |
                         +-----------------+

Figure 1-3. File Structure (Part 2 of 3)


+-----------------------+ | CA MICS VMX | | Information Area | | File Structure | +-----------+-----------+ | +----------------------------------+------------------------+--------------------------------+ | | | | | | | +-----------------+ +-----------------+ | +-----------------+ | +-----------------+ +----------------+ | VM Logical | | VM System | | | VM System | | | VM Processor | | VM Logical | | Partition | | Processor | | | Configuration | | | Configuration | | Partition CPU | | Activity Data | | Data File | | | File | | | File | | Activity Data | | (VMXLPR) | | (VMXSPP) | | | (VMXSCF) | | | (VMXPCF) | | (VMXLCP) | +-----------------+ +-----------------+ | +-----------------+ | +-----------------+ +----------------+ | | +----------------------------------+------------------------+---------------------------------+ | | | | | | | +-----------------+ +-----------------+ | +-----------------+ | +----------------+ +----------------+ | VM System | | VM Device | | | VM Device | | | VM Device | | VM Scheduler | | Global Data | | Configuration | | | Activity | | | SEEKs Data | | Parameters | | File | | File | | | File | | | File | | File | | (VMXSGP) | | (VMXDCF) | | | (VMXXDV) | | | (VMXXDS) | | (VMXSCX) | +-----------------+ +-----------------+ | +-----------------+ | +----------------+ +----------------+ | | +-----------+-----------------------------------------------------------------------+-----------+ | | | | | | | +-----------------+ | +-----------------+ +-----------------+ +-----------------+ | +-----------------+ | VM CPVOL | | | VM CP Owned | | VM User Data | | VM User | | | VM User | | Configuration | | | Volume Data | | Configuration | | Activity Sample| | | Transaction | | Data File | | | File | | File | | Data File | | | Sample Data File| | (VMXACF) | | | (VMXCPV) | | (VMXVXF) | | (VMXVXU) | | | (VMXVXT) | +-----------------+ | +-----------------+ +-----------------+ +-----------------+ | +-----------------+ | | +-------------------------------------------------------------------------------------------------+ | | | | | | | | | | +-----------------+ | +-----------------+ | +-----------------+ | +---------------+ | | | VM Channel | | | VM Block | | | VM Shared | | | VM System | | | | Path Contention | | | Paging | | | Storage Mgmt | | | Timer Pop | | | | File | | | Data File | | | File | | | File | | | | (VMXCHC) | | | (VMXBPG) | | | (VMXXSS) | | | (VMXSTP) | | | +-----------------+ | +-----------------+ | +-----------------+ | +---------------+ | | | | | | | | | | | +----------------+ +-----------------+ +----------------+ +------------------+ +-----------------+ | VM Paging | | VM DASD | | VM User | | VM User | | VM Shared | | Cache Activity | | Cache Activity | | Activity Event | | Transaction Event| | Storage Config- | | File | | File | | Data File | | Data File | | uration File | | (VMXCDP) | | (VMXCDI) | | (VMX_VU) | | (VMX_VT) | | (VMXXSF) | +----------------+ +-----------------+ +----------------+ +------------------+ +-----------------+


Figure 1-4. File Structure (Part 3 of 3)