Before you can use the CICS® VR data set list feature, you must
create a data set list.
To create a data set list:
- Create a sequential data set or a member of a PDS. The sequential
data set or PDS must be cataloged and have a fixed or variable record format.
This data set must reside on DASD. Data sets with spanned records are not
supported.
- Add a record for each VSAM sphere that you want to include on the CICS VR
VSAM sphere list. Use the following rules when you create the list:
- Begin the name of the VSAM sphere in the first column of the record.
- Create a separate record for each VSAM sphere that you want to include
in the recovery job.
- You can use the global search characters asterisk '*' and percent sign
'%' in the record. The asterisk represents any number of characters and the
percent sign represents a single character.
For example:
- If a record in the data set contains only the asterisk, all CICS VR registered
VSAM spheres are on the VSAM sphere list and are selected.
- If a record in the data set contains "ACCOUNT.*.*", all CICS VR-registered
VSAM spheres that have a minimum of three qualifiers and have a high-level
qualifier of "ACCOUNT" are on the VSAM sphere list and are selected.
- If a record in the data set contains "ACCOUNT%.%%%", all CICS VR-registered
VSAM spheres that have two qualifiers, a high-level qualifier of "ACCOUNTx"
where x is any character, and a second qualifier of any three characters,
are on the VSAM sphere list and are selected
- No upper limit applies to the number of VSAM sphere name records that
can be included in the data set list file. However, the allocated size of
the data set list file must be large enough to contain all of the required
VSAM sphere name records.
- To create a recovery job for all VSAM spheres listed in the data set by
specifying default recovery parameters, all spheres listed in the data set
must share the following characteristics:
- All of the spheres must have similar backup types such as
the following:
- Logical backup that is known to CICS VR
- Backup on the same DFSMShsm full volume dump
- Either no backup or a recovery job that does not include a step to restore
from a backup
- All of the spheres listed in the data set must use the same time format
on the log; that is, all spheres must use local time format or all spheres
must use Greenwich Mean Time (GMT) format.