To run full recovery for selected VSAM spheres, you can
use the DWWBRC00 sample job in the SDWWCNTL data set. Recovery includes CICS® VR recovery job construction,
restoration of VSAM spheres from registered backups, and CICS VR forward recovery.
The DWWBRC00 sample job contains a single job step that
you can include in any user job. To use it, copy the sample job from
the SDWWCNTL data set and modify the following information:
Update the job card and symbolic parameters for your installation.
Specify the CICS VR recovery
construction input parameters in the DWWSPHIN data set.
Use the following rules when you code the CICSVR recovery
construction input parameters in the DWWSPHIN data set:
Start each input statement in the data set on a new logical 80-byte
record.
You can continue a statement on more than one record and use up
to three logical records for one statement.
The data set uses all the logical record columns from 1 to 80,
so it cannot be numbered.
End each statement with a semicolon.
Each input statement consists of input parameters, which are separated
by commas. Do not continue a parameter value on a subsequent record.
All input parameters are positional. Do not change the order of parameters.
To omit a parameter specification, code a blank followed by a comma
(or a semicolon for the last parameter in a statement). If you do
not specify a parameter, the default value is used.
The data set can include one OPTION input statement, which must
be specified as the first statement. This statement specifies general
options to use for all VSAM spheres that are specified in the RECOVER
input statements.
The data set must include one or more RECOVER input statements.
These statements specify the VSAM spheres to be recovered, where each
statement specifies parameters for one sphere.
OPTION input statement
The OPTION input
statement is optional and specifies general recovery construction
options that are used for all VSAM spheres to be recovered. When specified,
this statement must be the first statement in the DWWSPHIN data set.
Only one OPTION statement can be specified. If this statement is omitted,
the default values are used.
Format
Parameters
SCAN(YES|NO)
Specifies whether CICS VR
scans the registered log of logs before the recovery job is constructed.
Valid values are as follows:
YES
Scan the log of logs. YES is the default value.
NO
Do not scan the log of logs.
LOGTYPE(LOGSTR|COPY)
Specifies the type of log stream for construction of the recovery
job. Valid values are as follows:
LOGSTR
Use the MVS log stream. LOGSTR
is the default value.
COPY
Use the QSAM copy of the MVS log
stream.
TIMEF(LOCAL|GMT)
Specifies the time format for construction of the recovery job.
The default value for the time format is extracted from the Recovery
Control Data Set (RCDS). If this value is not available from the RCDS,
LOCAL is used as the default value. Valid values are as follows:
LOCAL
Specifies that the time is in local format.
GMT
Specifies that the time is in GMT format.
RECOVER input statement
The RECOVER input
statement specifies the recovery parameters for a VSAM sphere to be
recovered. You must specify at least one RECOVER input statement,
and you can specify multiple RECOVER input statements. If an OPTION
input statement is specified, the RECOVER statements must follow this
OPTION statement.
Format
Parameters
sphname
Specifies the MVS data set
name of the VSAM sphere to be forward recovered. This name is 1 -
44 characters.
newsphname
Specifies the name of the target VSAM sphere to be recovered.
The specified name can be 1 - 44 characters. This parameter is optional.
backupname
Specifies the name of the registered logical backup that CICS VR will restore the sphere
from. This name is 1 - 44 characters. This parameter is optional.
If this parameter is omitted, the latest logical backup of the sphere
is used.
VERSION(hsmver)
Specifies that CICS VR
is to restore the sphere from a DFSMShsm backup, where hsmver specifies
the DFSMShsm backup version.
Usage Notes
Consider the following points
when you use the DWWBRC00 sample job:
The DWWBEXEC REXX exec calls programs in the TSO background. To
allow TSO to invoke authorized programs such as IDCAMS and ADRDSSU,
you must add these programs to the AUTHPGM list of the IKJTSO00 member
in SYS1.PARMLIB. For more information, see z/OS TSO/E Customization.
The DWWBEXEC REXX exec uses restore skeletons to embed TSO commands
into the produced recovery job. The sixth character of these skeleton
names is the number 2. CICS VR
provides the following skeletons:
DWWAB2RS
DWWDS2LC
DWWDS2LD
DWWRE2RO
The full recovery process has three phases: job recovery construction,
restoration of VSAM spheres from registered backups, and forward recovery.
If an error occurs at any stage, processing ends and error messages
are placed to the DWWBRC00 output data sets:
The SYSTSPRT data set contains messages that the DWWBEXEC REXX
exec produces during processing of the DWWSPHIN data set, and messages
about completed programs.
The SYSPRINT data set includes output messages that are issued
by invoked utilities such as IDCAMS and ADRDSSU.
The DWWMSG and DWWPRINT data sets contain messages that are issued
by CICS VR recovery construction
and the DWWCO program.
Example
The following figure shows an example
part of the DWWBRC00 sample job that is updated to specify the input
parameters for CICS VR recovery
construction. Figure 1. DWWBRC00 sample with input
parameters specified.
//DWWBRC00 JOB (ACCOUNT),MSGLEVEL=(1,1),MSGCLASS=H,
// NOTIFY=&SYSUID
//*--------------------------------------------------------------*/
//* This sample job invokes exec DWWBEXEC that runs CICSVR ISPF */
//* interface to construct recovery job and then executes it. */
//*--------------------------------------------------------------*/
//* SET SYMBOLIC PARAMETERS
//*
// SET PREF=DWW ! CICSVR RCDS NAME PREFIX
// SET SUFF=PROD ! CICSVR XCF GROUP NAME SUFFIX
// SET HLQ=DWW.V610 ! HLQ FOR CICSVR LIBRARIES
// SET UHLQ=DWW.&SYSUID ! HLQ FOR ISPFILE DATA SET
//*
//ISPFBRC EXEC PGM=IKJEFT01,DYNAMNBR=25,REGION=6M,
// PARM='ISPSTART CMD(%DWWBEXEC &UHLQ) NEWAPPL(DWW)'
//*
//*- - SET RECOVERY CONSTRUCTION INPUT PARAMETERS -*/
//*
//DWWSPHIN DD *,DCB=BLKSIZE=80
OPTION SCAN( NO) , , TIMEF(GMT) ;
RECOVER CICSVR.R52JC011.KSDS01, CICSMVS.KSDS01.NEW, VERSION(1) ;
RECOVER CICSVR.R52JC011.KSDS02 , ,
CICSVR.R52JC011.KSDS02.DSSDUMP ;
RECOVER CICSVR.R52JC011.KSDS03 , CICSMVS.KSDS03.NEW , ;
/*
. . .
Synonyms
The following table lists the input
statements and the acceptable synonyms that can be used in place of
those statements:
