5. FILES › 5.3 IDMS Information Area Files › 5.3.4 IDMS System Incident File (IDMSIN) › 5.3.4.3 Usage Considerations

5.3.4.3 Usage Considerations

This section identifies usage considerations and techniques
for accessing the IDMS System Incident File (IDMSIN).

Retained elements, as identified in the element list, are
only accurate in the DETAIL timespan.  They may be of value
in summarized timespans, but the user should be aware that
they lose significance after summarization.

Using the special date and time data elements requires
special care.  As the file's granularity increases in higher
timespans, certain fields lose significance and should not be
used, namely:

o  HOUR should not be used in MONTHS or YEARS.
o  DAY and DAYNAME should not be used in MONTHS or YEARS.
o  WEEK should not be used in MONTHS.

The data elements STARTTS and ENDTS have different meanings
when used in the DETAIL timespan versus their meanings in
the DAYS, WEEKS, MONTHS, and YEARS timespans.  In the DETAIL
timespan, STARTTS indicates the earliest date and time,
while ENDTS indicates the latest date and time, for the
summarized data.  In the DAYS, WEEKS, MONTHS, and YEARS
timespans, both STARTTS and ENDTS denote the span of time
over which data have been summarized.

The DURATION data element represents the elapsed time of the
individual transaction records in the IDMSIN file.  In
summarized timespans, DURATION represents the sum of DURATION
of the individual transaction records that contributed to the
summarized observation.  DURATION is calculated as the
difference between the End Time (PMHETIME) and the Start Time
(PMHSTIME) fields from the CA-IDMS Performance Monitor header
record.

In all IDMS Analyzer files except the IDMSIN file, the
STARTTS and ENDTS data elements do not reflect the Start Time
and End Time of the individual transactions.  Instead,
STARTTS and ENDTS are adjusted to represent the start and end
of the time interval within which the transactions executed.
In the IDMSIN file, however, STARTTS and ENDTS are equal to
the start and end times of the individual transaction
records.