Initialization Parameters › Initialization Parameter Descriptions › ARCHCHG

ARCHCHG

This parameter allows or prevents the changing of archive date and time using the following user exits: SARSTCUX, SARFVCUX, SARACFUX, SARPAMUX, SARPDFUX.

Syntax:

ARCHCHG=[NO | baseyear] 

Valid values for baseyear are 1980 and greater.

The default is NO.

NO

Specifies that CA View increments the GEN number for the reports, which are based on the standard method and execution of the SARSTC backup task.

baseyear

Indicates a four-digit year that represents the year of the oldest report on the database. When baseyear is specified, CA View calculates the GEN number for the report that is based on the number of days from the baseyear to the archive date. The SEQ is then calculated based on the archive time. The generated sequence number (archive time, in seconds, divided by 1.32922 plus one) ranges from 1 to 65000 and allows new reports to be added in approximate time-of-day sequence. If the sequence number is already in use, the next available sequence number is used.

For example, if ARCHCHG=1980 and the ARCHDATE = 01/01/1980, the generation is set to 1, indicating that this is the first day since the start of the baseyear. Backup cycles still run based on the TIME parameter, but the current generation is no longer incremented by 1. Instead current generation is calculated based on the number of days that occurred from the start of the baseyear to the current date. To change the baseyear after reports are archived, SARDBASE MERGE must be run to resequence the generation numbers that are based on the new value for baseyear.

Note:

The ARCHCHG parameter has the following requirements:

• The ARCHCHG parameter does not affect the reports that are processed by the Xerox Collector.
• When ARCHCHG is set to a baseyear, both the EROPRO and EROOPT parameters must be set to YES. To verify that back-dated reports will not immediately be expired from the data base during the next back-up cycle, review the ERO retention table carefully.
• The ARCHCHG parameter must be set BEFORE any reports are archived to the database; it cannot be changed after reports are archived to the database.

  If you are merging databases with the SARDBASE MERGE control statement and want the ARCHCHG baseyear functionality, you must supply the ARCHCHG=baseyear specification on the SARDBASE MERGE control statement to activate this setting on the merged database.