9. PROCESSING › 9.6 VM Monitor Processing Physical Structure

9.6 VM Monitor Processing Physical Structure

VM Monitor Data processing contains two logical sections: the
input raw data module (VMCMXAFI) and the post-processing
module (VMCMXAFU).

The input raw data section consists of two subsections.  The
first subsection sets up the files that will be created,
together with element lengths and formats, as well as
constant values (literals) and work element definitions.
This is followed by %CKRTN1, which performs checkpoint
validation; %VMCLUPX, which calls the second subsection for
data input; and %CKRTN3 for end-of-input processing.

The second input raw data subsection begins at label MXAPROC
and continues to the end of the SAS DATA step.  This
subsection is called by %VMCLUPX for each system defined in
VMCOPS that provides VM Monitor data to CA MICS.  The data
input processing is confined to a single loop that terminates
at end-of-file for each input DD statement.

The data input loop identifies the current input record. If
the current input record is an Event Profile Record (Domain
1/01) or an Interval End Record (Domain 1/11), pending
observations for the VMXSGP file are output.  If the Interval
End Record (Domain 1/11) is the first record encountered,
then an observation is output to the VMXSCF file and it is
used to establish the interval start timestamp, VMCINTTS.

If the first data records input are not from Domain 1,
CA MICS ABENDs with a 998 as the initial configuration data.
Additionally, if a Domain 1/5 record (processor
configuration) is encountered that has information from the
wrong system and VMCOPS specified VERIFY ABORT, an ABEND 998
is taken (CA MICS SYSID checking may also ABEND with code
310).

Following initial monitor domain processing the USRSEL exit
is called.  For Domain 1/05 records, %SYSID is invoked and an
observation is written to the VMXPCF file.  Finally, %CHKRTN2
is called for all records.

The next function reads the remaining data from the input
records and outputs to the appropriate file.  For the VMXVXU
file, the Domain 4/03 record information is held pending a
corresponding Domain 4/04 record.  For the VMX_VT file, the
Domain 4/08 record information is held pending a
corresponding Domain 4/10 record.  For the VMXSGP file,
output occurs prior to the next Domain 0/01 Record (System
Data - Processor).  This is required because each VMXSGP
observation is built from multiple input records that are
adjacent in the input data stream.  For example, information
contained in certain records from Domain 0 (03, 06, 07, 08,
09, 10, 12 and 14) and Domain 3 (10) is held for producing
VMXSGP observations.  For all other files, output is
synchronous with input.  However, many of the files created
at this point are work files that will be merged in the post-
processing section.

The post-processing section contains one subsection per file
built from VM Monitor data.  These subsections provide any
extra file specific processing.  For example, both the VMXPCF
and VMXDCF files have information propagated through all
observations since each observation may have been created
from different input source records.

Post-processing for files containing interval measurements
consists of determining the difference between the values of
rolling counters in chronologically adjacent and ascending
observations.  In addition to a change in the fundamental
unit of measure for a file, a break is recognized when the
duration between two adjacent records is greater than the
interval length multiplied by a macro variable, &VMXINTV.
&VMXINTV is defined at #VMCMSTR at sharedprefix.MICS.SOURCE
with default value of 1.5.  For the VMXVXU and VMXVXT files,
information is obtained from sample data.

Creation of the VMXSPP file involves merging together the
various workfiles (i.e., VMXSPdnn, where d is a domain number
and nn is the record type within that domain) and the VMXPCF
processor configuration information used to propagate
processor specific information through each newly created
observation.

Once the VMXVXU and VMXSPP files have been created,
information is summarized across both files to arrive at
system-wide measures needed for completing the VMXSGP file.
These summarized files, along with the VMXSCF file and the
VMXSGP file, are merged, interval calculations are performed,
and derived elements are computed, completing the
observations for the VMXSGP file.

Once the remaining files have been processed, observations
are aged in the configuration files VMXDCF, VMXSCF, VMXPCF,
VMXACF, VMXXSF, VMXVXF, and VMXSCX.