Use the SPHERE command to define which spheres are in the
CA group.
Format

>>-SPHERE--+-NAME--(--sphere name--)-+-------------------------->
'-ALL---------------------'
>--+---------------------------------------------+-------------><
| .-,LOCAL-. |
'-BACKUPTIME--(--date and time--+-,GMT---+--)-'
Keywords
- NAME(sphere name)
- Identifies the name of the
sphere in the change accumulation group. Recovery information is collected
in the change accumulation data set for each sphere that is listed.
At least one SPHERE keyword is required for each CA control statement.
- sphere name
- Defines the name of the sphere. This name is 1–44 characters.
- ALL(sphere name)
- Specifies that CICS® VR
must consolidate all log records for all VSAM spheres that are read
on the log stream by CICS VR.
- BACKUPTIME(date and time,LOCAL|GMT)
- Identifies the date and
time of the backup.
This parameter is optional and
only needs to be specified if CICS VR is unaware of logical backups
created for the data set. CICS VR is aware of backups that
are either registered in the RCDS through notification or exist in
DFSMShsm's inventory. If this parameter is specified, you must update
this date and time each time you create a new data set backup.
- date and time
- Must be in the format yyyy/ddd/hh/mm/ss, where:
- yyyy
- Is the four digit year number (2001)
- ddd
- Is the day of the year (001–366)
- hh
- Is the hour of the day (00–23)
- mm
- Is the number of minutes (00–59)
- ss
- Is the number of seconds (00–59)
You can separate these values with a slash (/),
period (.), or colon (:). You can also omit the separator character.
For example:
BACKUPTIME(2001.159/: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(2001.159), CICS VR assumes that the time segment
is 00:00:00.
- LOCAL
- Specifies that
the date and time are in local format. You can specify LOCAL if you
are using MVS™ log streams. LOCAL is the default value.
- GMT
- Specifies that the date and
time are in Greenwich mean time (GMT) format. You can specify GMT
only if you are using MVS log streams.
Usage notes
Consider the
following when you use the SPHERE command:
- This command is required if the CA command is specified.
- You can specify up to 50 SPHERE commands for each CA command.
- Do not specify duplicate sphere names for a CA group.
- If the ALL keyword is specified, the ONLY keyword
must be specified in the CA command.
- You can specify the BACKUPTIME keyword with the
ALL keyword, the NAME keyword, or keywords, or both. When specified, CICS VR
uses the entered backup times as the earliest time stamp of log records
that must be consolidated.
- If both LOCAL and GMT is specified for the BACKUPTIME
in the Change Accumulation job step, CICS VR
ignores specified BACKUPTIME values as search value on the mvslog
and starts from the beginning of the logstream. Any records for spheres
that are before the specified backuptime are not used in the Change
Accumulation process.