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.