CHECK: Prevent duplicate recovery runs

Use the CHECK command to prevent a recovery job from running twice in a row.

A step using the CHECK command appears in the generated job automatically if the Prevent duplicate runs option is selected on the CICS VR interface panels.
CHECK-JOBNAME (jobname)SPHERE( spherename) { [ NEWSPHERE( newspherename) ] } { [ STARTTIME( starttime,) { LOCAL | GMT } ] } { [ STOPTIME( stoptime, ) { LOCAL | GMT } ] } { MVSLOGNAME(logname )RETURNCODE(returncode ) }

Keywords

JOBNAME (jobname)
Specifies a 1– to 8 character name of the job containing the step with the recovery utility to be secured from running twice. JOBNAME is a required keyword.
jobname
Specifies the 1– to 8 character jobname specified in the JOB JCL statement of the batch job. The jobname is 1 through 8 alphanumeric or national ($, #, @) characters. The first character must be alphabetic or national ($, #, @).
SPHERE (spherename)
Specifies the same sphere name as in the following recovery utility step, keyword SPHERE. SPHERE is a required keyword.
STARTTIME(start date and time, LOCAL | GMT)
Specifies the same start time value as in following recovery utility step, keyword STARTTIME.

start date and time

Must be in the format yyyy/ddd/hh/mm/ss, where:
  • yyyy is the year
  • 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:

STARTTIME(2007.159/00:30:00)

You cannot substitute commas, blanks, or other similar characters, for the time values, but you can omit values from the right. For example, you can specify day 2007159, time 00:00:00, as follows:

STARTTIME(2007.159)

If you specify the time like this, CICS VR assumes that the day is 2007365 and the time is 00:00:00:
LOCAL
Specifies that the date and time are in local format. LOCAL is the default value.
GMT
Specifies that the date and time are in GMT format.
STOPTIME(stop date and time, LOCAL | GMT)
Specifies the same stop time value as in following recovery utility step, keyword STOPTIME.
stop date and time
Must be in the format yyyy/ddd/hh/mm/ss, where:
  • yyyy is the year
  • 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:
STOPTIME(2007.159/00:30:00)
You cannot substitute commas, blanks, or other similar characters, for the time values, but you can omit values from the right. For example, you can specify day 2007159, time 00:00:00, as follows:
STOPTIME(2007.159)
If you specify the time like this, CICS VR assumes that the day is 2007365 and the time is 00:00:00:
LOCAL
Specifies that the date and time are in local format. LOCAL is the default value.
GMT
Specifies that the date and time are in GMT format.
MVSLOGNAME (logname)
Specifies the same MVS log name as in following recovery utility step, command MVSLOG, keyword NAME. MVSLOGNAME is a required keyword.
logname
Specifies the name of the MVS log stream. The name is 1 – 26 characters.
RETURNCODE (returncode)
Specifies the lowest threshold for the return code of the recovery job, to prevent the following recovery steps from running. For example, if a return code of 4 is specified by this keyword, the following recovery step will not run, if the previous run of the same job completed with return code 4 or higher.
To prevent any duplicate run of the job, specify a return code of 0. RETURNCODE is a required keyword.
Note:
To cancel checking for the duplicate runs, you must remove the specific steps with CHECK invocations from the job.