5. FILES › 5.2 HAR Information Area Files › 5.2.30 CPU Measurement Facility LPAR (HARCML) File › 5.2.30.3 Usage Considerations

5.2.30.3 Usage Considerations

Special considerations or techniques related to using the
HARCML file are provided below.

1.  The SMF type 113 record, used to create the HARCML file,
    is not created by the IBM Resource Measurement Facility
    (RMF). As a result, the STARTTS and ENDTS values for
    DETAIL level records will not exactly match the other RMF
    component database files.

    The Hardware Instrumentation Services (HIS) control
    statements used to activate SMF type 113 record
    collection include a SMFINTVAL=SYNC parameter that
    synchronizes SMF type 113 records interval duration and
    interval boundaries with those used by RMF, but the
    timestamps do not match exactly.

    As a result, at the DETAIL timespan, HARCME file
    observations cannot be exactly merged with CA MICS files
    created from RMF data, such as the HARIPU or HARCPU
    files. If SMFINTVAL=SYNC is used in the HIS control
    statements, however, merging this file with other RMF
    component files at the DAYS and higher timespans will
    provide accurate measurement associations.

2.  Care must be exercised in using the special date and time
    data elements contained in each CA MICS file. As the
    file's granularity increases in higher timespans, certain
    fields lose significance; they should not be used in
    those cases.

    o  HOUR should not be used in MONTHS.
    o  DAY and DAYNAME should not be used in WEEKS, MONTHS.
    o  WEEK should not be used in MONTHS.

3.  ENDTS and STARTTS, when appearing in the DAYS, WEEKS, or
    MONTHS timespans, bound the span of time over which the
    data has been summarized.  STARTTS is the lowest date and
    time and ENDTS is the highest date and time for the data
    summarized.  These data elements have different meanings
    when used in the DETAIL timespan versus the DAYS, WEEKS,
    and MONTHS timespans.  Their purpose in DETAIL is
    described below:

    o  STARTTS represents either the start time of an HIS
       collection run, or the start time boundary of an
       interval record.

    o  ENDTS represents the HIS interval record end time.