5. FILES › 5.2 HAR Information Area Files › 5.2.25 ESS Extent Pool Statistics File (HARXPS) › 5.2.25.3 Usage Considerations

5.2.25.3 Usage Considerations

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

1.  RMF Interval data represented in CA MICS database files
    uses time and duration information common to all RMF
    records for a given SYSID to ensure timestamp consistency
    across different CA MICS database files.

    This consistency allows CA MICS database records from
    different files (such as the HARCPU and HARDVA) to be
    merged together by ENDTS.

    The HARXPS file maintains this consistency.  Data element
    values for STARTTS, ENDTS, HOUR, DAY, INTERVAL, and so on
    are completely synchronized with the same element values
    found in other CA MICS database files generated from RMF
    data produced for the same time interval.  This not only
    aids in the merging of data, but also allows for strict
    minute cut-offs to ensure that data from 9:00-9:59 is
    always summarized into hour 9.

2.  The data in the HARXPS file may not actually represent
    activity exactly bounded by STARTTS and ENDTS.  This is
    because the actual reporting of cache statistics can be
    delayed by device reserve activity.  A unique set of
    Start Time, End Time, and Duration elements are provided
    with the HARXPS file. They represent the true time bounds
    of the data represented.  These elements are listed
    below:

    CACHESTS - Cache Gatherer Start Time Stamp
    CACHEETS - Cache Gatherer End Time Stamp
    CACHEDUR - Cache Gatherer Interval Duration

    All HARXPS observations contain a value in CACHESTS,
    CACHEETS, and CACHEDUR.

3.  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.

4.  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 RMF recording interval start time.
    o  ENDTS represents RMF recording interval end time.

    Remember that in the HARXPS file CACHESTS (Cache Gatherer
    Start Time Stamp) and CACHEETS (Cache Gatherer End Time
    Stamp) represent the true time boundaries of the data,
    and may be slightly different from the boundaries of the
    RMF interval duration.