TIMESTMP keyword
TIMESTMP keyword is required on the ARCHIVE FUNC(PARM) or ARCHIVE FUNC(RECOVER) control statements while recovering database using the Archive Image Copy. This time stamp must exactly match the creation time of the Archive Image Copy that you intend to use for the recovery. You can find the time stamp value in the output of the Archive IC Directory utility (ARUDUTIL).
If you specify TIMESTMP(LASTIC), the Recovery utility uses the last batch image copy (not flagged in error) that is stored in DBRC; it bypasses any online image copies and concurrent image copies. If you specify TIMESTMP(LASTIC) and the last image copy stored in DBRC is not a valid batch image copy, the Recovery utility gets a logical GENJCL error, DBRC issues message DSP0815I NO USABLE IMAGE COPY AVAILABLE FOR RECOVERY, and the job abends with a user 4094.
If you are using a PIT change accumulation (CA) data set as input, the time stamp value you specify depends on the type of PIT CA:
- A time stamp PIT CA is produced by the BMC Change Accumulation utility when the PIT(Y) keyword and the TIMESTMP keyword are specified. If you use this type of PIT CA as input to the Recovery utility, the time stamp that you specify with the TIMESTMP keyword for the Recovery utility must be the same time stamp that was used to produce the time stamp PIT CA. This value is also the CA stop time that is recorded in the RECONs.
- A PIT CA without a time stamp is produced by the BMC Change Accumulation utility when the PIT(Y) keyword is specified but the TIMESTMP keyword is not specified. If you use this type of PIT CA as input to the Recovery utility, you can specify any time stamp that is greater than or equal to the CA stop time.
Uses | Optional on the following control statements:
Required on the following control statements:
|
---|---|
Related keywords | None |
Syntax | TIMESTMP(value) |
Values |
The following time stamp formats are valid:
The variables in these values have the following meanings:
offset Signed (+ or -) four-digit (0000-1159) literal that specifies the hour and minute displacement from UTC (for example, -0600 means six hours less than GMT; +0800 means eight hours greater than UTC). If you do not supply an offset, the product uses the offset as determined from the TIMEZIN value specified in the RECONs. The offset is important when the boundary between daylight savings time and standard time is crossed. If you are performing a recovery to a local time that has a different offset from the current system offset, the time stamp must contain the offset for the local time. This situation applies to PIT recoveries. For a detailed explanation of IMS time stamps, see the IBM IMS documentation.
A fully qualified time stamp must have the following format:
No offset or zone values are allowed in the time stamp while you use the keyword in an Archive Image Copy recovery JCL. |
Default | None |