SPHERE: Define spheres

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

Format

Read syntax diagramSkip visual syntax diagram
>>-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.

Reference Reference

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/spherec.html