Previous Topic: 2.3.1.10 Complex-Level Time Zone Definitions (CPLXZONE)

Next Topic: 2.3.1.10.2 Holiday Time Zones

2.3.1.10.1 Standard Time Zones

Whether or not you have appropriately defined your standard
time zones will determine whether you can meet your
installation's analysis and reporting requirements when they
call for using data from the WEEKS, MONTHS, and YEARS
time-spans.  This is because the time granularity of data in
those levels of summarization is no finer than to the ZONE
(HOUR within ZONE for WEEKS).  For example, if you are asked
for a long-term study of off-prime CPU utilization that
treats weekdays and weekends separately and off-prime
weekdays and weekends are not separate ZONEs in the database,
you will not be able to do it from the CA MICS data readily
at hand.

Standard zones may not overlap with other standard zones, but
of necessity they will overlap with all holiday zones.  The
holiday zone always takes precedence.  Note that a holiday
zone number may be the same as a standard zone number,
allowing, for example, holidays to be lumped in with your
"graveyard" shift.

The format of a statement which defines a standard time zone
is:

    ZONE n day1 day2 hour1 hour2 sf 'description of zone'

The following describes the parameters on this statement.

ZONE NUMBER

     A number from 1 to 9, which identifies the time zone.
     Note that while this specification is numeric, the data
     element ZONE is a one-byte character field in the
     CA MICS database files.

     There is no requirement that ZONE NUMBERs be defined
     consecutively (e.g., 1, 2, 5, and 7 would be
     acceptable), nor is there a requirement that they be
     defined in numeric order.  It is recommended that the
     zones be defined in order of importance, with the most
     important defined as 1.

STARTING DAY

     The name of the first day within the CA MICS standard
     week (SUN through SAT) which is to be included in this
     zone definition.  Days are identified by the values SUN,
     MON, TUE, WED, THU, FRI, or SAT.  When specifying a
     single day, that day's name will be given here and as
     the "ending day" as well.


ENDING DAY

     The name of the last day within the CA MICS standard
     week (SUN through SAT) which is to be included in this
     zone definition.  Days are identified by the values SUN,
     MON, TUE, WED, THU, FRI, or SAT.  When specifying a
     single day, that day's name will be given here and as
     the "starting day" as well.  Note that a range of days
     may not reverse the normal (MICS) order of the days from
     SUN through SAT.  In other words, one could not specify
     the range FRI through SUN since the specification is not
     in the order of SUN through SAT.  The only exception to
     this rule is that weekends may be specified as starting
     on Saturday and ending on Sunday.

BEGINNING HOUR OF THE DAY

     The first hour in each of the days specified above which
     is to be included in the zone definition.  Hours are
     specified as numbers from 00 to 23, and they are
     inclusive.

ENDING HOUR OF THE DAY

     The last hour in each of the days specified above which
     is to be included in the zone definition.  Hours are
     specified as numbers from 00 to 23, and they are
     inclusive.  When only one hour is to be included, both
     beginning and ending hours must be specified, and they
     will be identical.  To define a time zone of 8 am to 5
     pm, you would code '08 16', which tells CA MICS to
     include all times between 8:00 am (inclusive) up through
     4:59:59.99 pm (16:59:59.99).

SERVICE FACTOR (sf):

     The service factor is specified to allow differential
     zone accounting by Accounting and Chargeback.  It allows
     a discount or surcharge factor to be specified for
     particular zones to reflect the time of day that the
     service was provided.  For more information on the
     service factor, see the documentation for Accounting and
     Chargeback.  The allowable range of values for the
     service factor is 0.1 through 99.9.  If multiple ZONE
     statements are required for one zone, then a '+' must be
     specified on all but the first statement for that zone.
     The first statement for each zone must always contain a
     service factor value.  This parameter MUST be specified
     even if Accounting and Chargeback is not installed.

ZONE NAME

     The 1 to 40 character name to use for reporting purposes
     when this Time Zone is displayed.  The name may not
     contain percent signs or apostrophes.  This parameter is
     required on the first ZONE statement for a given zone
     number.  It is optional on subsequent statements for
     that same zone number and in any case is ignored.