7. PARAMETERS › 7.3 Unit Level Parameters › 7.3.4 Database Space Modeling (DBMODEL) › 7.3.4.1 Data Retention Specifications (FILE Statements)

7.3.4.1 Data Retention Specifications (FILE Statements)

Data retention specifications tell the CA MICS database how
many cycles of each file in each supported timespan are to be
saved both in online and archive modes.  Figure 7-10 is the
worksheet for collecting this information.

The worksheet is organized by information area.  Each file in
the area is listed by name.  For each file, a line is
formatted to allow six definitions in the online database and
two in the archive database:

o The online database files quantify the number of cycles of
  data that is maintained in the DETAIL, DAYS, WEEKS,
  MONTHS, and YEARS timespans and the TABLES data area.

o The two definitions for the archive database files quantify
  the number of cycles of data to be retained, up to the
  cutoff limit defined.  The archive definitions have no
  impact on the size of the database and can be specified
  whethert the weekly and/or monthly archive history
  files have actually been activated (see Section 2.3.3,
  CA MICS JCL Planning and Parameters, of the PIOM).

The worksheet formats provide an underscored area for the
user's definition, followed by the recommended value, shown
within parentheses.  If the underscored area contains a value
of 00, the file is not supported for the indicated timespan.
To add support, perform database tailoring as
described in Section 6.2, Tailoring the Database, of the
System Modification Guide (SMG).

When specifying a retention limit, remember that the number
may never be zero if the file has been defined to be active
in the timespan.

EXAMPLE

The FILE statements listed below illustrate how to enter the
information:

FILE VCA VCADAA 10 33 00 06 00 02 000 024
FILE VCA VCA_VS 10 33 00 06 00 02 000 024
FILE VCA VCAVOA 10 33 00 06 00 02 000 024
FILE VCA VCADCS 00 33 00 00 00 00 000 000
FILE VCA HFSDIR 10 33 00 06 00 00 000 024

FILE HSM HSMMIG 10 33 00 06 00 02 000 024
FILE HSM HSMVOL 10 33 00 06 00 02 000 024
FILE HSM HSMTAP 60 33 00 06 00 02 000 024
FILE HSB HSBBAC 10 33 00 06 00 02 000 024

                            +--------------------------------------------------------------------------+
                            | INSTALLATION PREPARATION WORKSHEET: Database Data Retention Definitions  |
                            |                                                                          |
                            | PARMS Library Member is DBMODEL                                          |
                            |                                                                          |
                            | Reference:  Section 7.3.4.1                                              |
                            +------+-----------------------------------------------+-------------------+
                            |      |           Online Database Retention           |  Archive Cutoff   |
                            | File |DETAIL    DAYS   WEEKS   MONTHS  YEARS  TABLES | WEEKS    MONTHS   |
                            | Name |                                               |                   |
                            +------+-----------------------------------------------+-------------------+
                            |HFSDIR| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |VCADAA| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |VCA_VS| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |VCAVOA| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |VCADCS| 00(00)  __(33)  00(00)  __(00)   0(0)  00(00) |000 (000) 000 (000)|
                            +------+-----------------------------------------------+-------------------+
                            |HSMMIG| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |HSMVOL| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |HSMTAP| __(60)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) ___ (024)|
                            |HSBBAC| __(10)  __(33)  00(00)  __(06)   0(2)  00(00) |000 (000) 000 (000)|
                            +------+-----------------------------------------------+-------------------+

  Figure 7-10. Data Retention Specifications Worksheet