Use the RECOVER command to tell CICS® VR to forward recover a VSAM sphere.
>>-RECOVER----SPHERE--(--sphere name--)----+-,ONLY---------+----> +-,FIRST--------+ +-,INTERMEDIATE-+ '-,LAST---------' >--+--------------------------------------------------+---------> | .-,LOCAL-. | '-STARTTIME--(--start date and time--+-,GMT---+--)-' >--+------------------------------------------------+-----------> | .-,LOCAL-. | '-STOPTIME--(--stop date and time--+-,GMT---+--)-' >--+-----------------------------------------------+------------> | .-,LOCAL-. | '-STARTTOD--(--start time of day--+-,GMT---+--)-' >--+---------------------------------------------+--------------> | .-,LOCAL-. | '-STOPTOD--(--stop time of day--+-,GMT---+--)-' >--+--------------------------------------+--+--------+---------> '-NEWSPHERE--(--updated sphere name--)-' '-SHADOW-' >--+---------+--+---------------------------+-------------------> '-APPLYCA-' | .-REDO---. | '-STARTAT--(--+-DSNAME-+--)-' >--+----------------------------------------+-------------------> +-VERSION--(--DFSMShsm version number--)-+ '-HSMDATE--(--date--)--------------------' >--+----------------------+--+------------------+---------------> '-VOLUME--(--volume--)-' '-UNIT--(--unit--)-' >--+--------------+--+--------+---------------------------------> '-AUTOJOURNALS-' '-REMOTE-' >--+-------------------------------------+----------------------> '-ONLINEBACKUPNAME--(--backup name--)-' .-,-----------------------------. V | >----+---------------------------+-+----------------------------> '-FILEID--(--file ddname--)-' .-,-----------------------------. V | >----+---------------------------+-+--+----------+------------->< '-CICSID--(--CICS applid--)-' '-NOTIEUPS-'
STARTTIME(01.159/22:23:00)
You cannot substitute commas, blanks, and so on, for the time values, but you can omit values from the right. For example, if you specify STARTTIME(01.159), CICS VR assumes that the time segment is 00:00:00.
CICS VR interprets year values (yy) in the range 00–85 to be years 2000–2085, and year values in the range 86–99 to be years 1986–1999.
STOPTIME(01.159/00:30:00)
STOPTIME(01.159)
If
you specify this, CICS VR assumes that the day is
01365 and the time is 23:59:59: STOPTIME(01)
CICS VR
assumes that these values are for day 01159, and time 16:59:59: STOPTIME(0115916)
CICS VR interprets year values (yy) in the range 00–85 to be years 2000–2085, and year values in the range 86–99 to be years 1986–1999.
STARTTOD(AC47C0403792C101)
STOPTOD(AC47C0403792C101)
This keyword is optional, except when the SHADOW keyword is also specified, because SHADOW processing must always be performed against a copy of the VSAM sphere.
If NEWSPHERE is specified, CICS VR forward recovery processing applies all log records written for the VSAM data set specified on the SPHERE keyword to the data set specified on the NEWSPHERE keyword.
If NEWSPHERE is omitted, CICS VR forward recovery processing applies all log records written for the VSAM data set specified on the SPHERE keyword, to that same data set.
If the VERSION or HSMDATE keyword has also been specified, CICS VR calls DFSMShsm utilities to restore the sphere to the name specified in the NEWSPHERE keyword.
The concept is that the first time (run 1) that you run a shadow forward recovery, the backup is restored and some amount of the forward recovery log is applied. Subsequent shadow forward recovery runs (2 - n) apply more of the forward recovery log with the intent to keep the shadow copy as current as possible.
CICS VR saves the status of the shadow forward recovery in the RCDS, so the subsequent shadow forward recovery runs (2 - n) must not specify a start and stop time and must be run frequently, so as to minimize the log records to be applied.
When a problem occurs and a real forward recovery is required, the CICS VR shadow can be copied to replace the user data set.
If you are using the CICS VR VSAM batch logger to log the updates that are made to VSAM spheres by batch jobs, you must also add the REMOTE keyword to the RECOVER command. The REMOTE keyword specifies that the log records written by the CICS VR VSAM batch logger must be included during shadow recovery processing.
APPLYCA indicates to CICS VR that there is change accumulation data that is relative to this data set that needs to be applied during forward recovery processing. If there is no change accumulation data set or CICS VR detects an error with the CA data set, the APPLYCA keyword is ignored.
If you use the STARTAT keyword without the STARTTIME keyword, STARTAT is ignored.
The STARTAT keyword has no synonyms.
The AUTOJOURNALS keyword is optional, and if it is not specified, CICS VR only applies log records produced by CICS TS forward recovery logging, Transactional VSAM, and CICS VR batch logging during forward recovery processing.
The AUTOJOURNALS keyword is only valid for VSAM spheres that were updated by CICS TS, and it is ignored when recovering VSAM spheres that were not updated by CICS TS.
The REMOTE keyword must not be added to the RECOVER command if the SHADOW keyword has not been added.
If the above conditions are true, specify the ONLINEBACKUPNAME keyword to ensure that CICS VR uses the proper forward recovery start time. CICS VR uses the forward recovery start time that is stored in the RCDS for the specified backup. The STARTTIME keyword is therefore optional when the ONLINEBACKUPNAME keyword is specified.
The CICS VR panel interface automatically adds the ONLINEBACKUPNAME keyword to the produced RECOVER command if the backup selected for restore meets the criteria specified above.
A CICS file definition associates a unique 1-8 character ddname with every VSAM data set defined to the region. When a VSAM data set is opened, CICS writes the full data set name and corresponding ddname (along with other information) into a tieup (TUR) log record. In all subsequent after-image log records, only the ddname is used to reference the data set.
CICS VR forward recovery therefore always begins by reading a tieup log record. This allows CICS VR to relate all after-image log records to the appropriate VSAM sphere.
In rare cases when a tieup log record does not exist for a VSAM data set, traditional CICS VR recovery is not able to associate after-image log records with a VSAM sphere. The optional FILEID and CICSID keywords can be specified to inform CICS VR of this file ddname and data set name relation for each CICS region that is normally obtained from a tieup log record.
More than one file ddname can be specified, separated by a comma. For each file ddname specified, a corresponding CICS applid must be specified in the CICSID keyword. CICS VR does not limit the number of file ddname and CICS applid pairs that can be specified.
FILEID(ACCTBASE, ACCTAIX1)
CICSID(CICSPRD1, CICSPRD2)
CICS VR forward recovery processing
interprets this example as follows: To ensure proper forward recovery when a tieup log record is not available, all active opens, against all of the VSAM sphere components, base cluster and alternate indexes, from all CICS regions, at the specified forward recovery start time, must be specified in the FILEID and CICSID fields.
Refer to the FILEID keyword description for information about how and when to use the FILEID and CICSID optional keywords.
More than one CICS applid can be specified, separated by a comma. For each file ddname specified, a corresponding CICS applid must be specified in the CICSID keyword. CICS VR does not limit the number of file ddname and CICS applid pairs that can be specified. The FILEID keyword description has an example of how CICS VR interprets multiple file ddname and CICS applid pairs.
To ensure proper forward recovery when a tieup log record is not available, all active opens, against all of the VSAM sphere components, base cluster and alternate indexes, from all CICS regions, at the specified forward recovery start time, must be specified in the FILEID and CICSID fields.
A backup is taken to forward recover the VSAM sphere specified in this RECOVER command. If no tieups were written when the backup was taken, this keyword must be specified.
If NOTIEUPS is specified, CICS VR uses information gathered during a log-of-log scan to determine which logged records to use during forward recovery. If you use this keyword, make sure that a log-of-log scan has been performed after the STARTTIME specified for this vsam sphere.
RECOVER -
ONLY -
VERSION(01) -
APPLYCA -
SPHERE(PAYROLL.MONTH5.BASE)
Forward recovery processing is requested for the VSAM sphere named in the SPHERE keyword.
Because no STARTTIME or STARTTOD keyword is specified, recovery starts after the first TUR at the first after-image that is encountered on the logs for that VSAM sphere.
Because no STOPTIME or STOPTOD keywords are specified, recovery stops when all logs have been exhausted.
The ONLY keyword tells CICS VR that only one RECOVER step is needed.
The VERSION keyword tells CICS VR to restore the VSAM sphere from DFSMShsm backup Version 1.
The APPLYCA keyword tells CICS VR to apply the change accumulation data if a change accumulation data set exists.
RECOVER -
ONLY -
STARTTIME(08.001/11:59:59) -
STOPTIME(08.002/11:59:59) -
APPLYCA -
STARTAT(DSNAME) -
SPHERE(CA.BASE02)
Forward recovery processing is requested for the VSAM sphere that is named in the SPHERE keyword.
The ONLY keyword tells CICS VR that only one RECOVER step is needed.
Because no VERSION or HSMDATE keywords are specified, CICS VR assumes that the user has restored a backup copy of the VSAM sphere using a product other than DFSMShsm; for example, using DFSMSdss, prior to the forward recovery. The STARTTTIME value must be prior to the initial tie-up record in the forward recovery log.
The STARTTIME keyword tells CICS VR to start the recovery on 01.001 at 11:59:59.
The STOPTIME keyword tells CICS VR to stop the recovery on 01.002 at 11:59:59.
The APPLYCA keyword tells CICS VR to apply the change accumulation data if a change accumulation data set exists.
The STARTAT keyword tells CICS VR to start the recovery at the first TUR after the time specified that is in the STARTTIME keyword.
RECOVER -
ONLY -
STARTTOD(B5E727FC28544000) -
VERSION(1) -
VOLUME(TSO001) -
UNIT(3390) -
APPLYCA -
SPHERE(CA.BASE02)
Forward recovery processing is requested for the VSAM sphere named in the SPHERE keyword.
The ONLY keyword tells CICS VR that only one RECOVER step is needed.
The STARTTOD keyword tells CICS VR to begin the recovery at the value specified by the hex TOD STARTTOD keyword. This value is in the default, local format.
Because no STOPTIME or STOPTOD keywords are specified, recovery stops when all logs have been exhausted.
The VERSION keyword tells CICS VR to restore the VSAM sphere from DFSMShsm backup Version 1.
The VOLUME and UNIT keywords tell CICS VR that the VSAM sphere is restored to volume TSO001 on a 3390 disk.
The APPLYCA keyword tells CICS VR to apply the change accumulation data if a change accumulation data set exists.
RECOVER -
SHADOW -
NEWSPHERE(PAYROLL.MONTH5.SHADOW) -
SPHERE(PAYROLL.MONTH5.BASE)
Forward recovery processing is requested for the VSAM sphere named in the SPHERE keyword.
The SHADOW keyword tells CICS VR that the data set specified with NEWSPHERE is a shadow copy of the data set specified on the SPHERE keyword. You can use a shadow copy as a replacement to the user's VSAM sphere.
RECOVER -
SPHERE(PROD.SALES) -
AUTOJOURNALS -
STARTTIME(07.325/11:59:59)
Forward recovery processing is requested for the VSAM sphere named in the SPHERE keyword.
The AUTOJOURNALS keyword tells CICS VR to forward recover the VSAM sphere PROD.SALES only from log records produced by CICS TS autojournaling.
The STARTTIME keyword tells CICS VR to use only log records that have a time stamp later than or equal to 03.325/11:59:59 (local time format).
The following table provides the RECOVER commands or keywords along with acceptable synonyms that can be used in place of the commands or keywords.
Command or keyword | Synonyms |
---|---|
RECOVER | RO, RECO, RECONLY, RECOV |
CICSID | APPLID |
FILEID | DDNAME |
NEWSPHERE | NEWSPH, NEWDATASETNAME, NEWDSNAME, NEWDSN |
ONLINEBACKUPNAME | BACKUPDATASETNAME, BACKUPNAME, BACKUPDATASET |
SPHERE | SPH, DATASETNAME, DSNAME, DSN |
STARTTIME | STARTDATETIME, STARTDATE, START |
STOPTIME | STOPDATETIME, STOPDATE, STOP |
VERSION | VER |