RGRUN - Run cycle segment
Each run cycle in a run cycle group. The run cycles of a run cycle group are based on rules only. The segment contains the fixed part plus the rule definition.
- Type
- Required input. The type can be one of the following:
- R
- Regular run cycle that identifies times and days when the application runs.
- E
- Exclusion run cycle that identifies times and days when the application does NOT run. If you specify a particular day and time as an exclusion run cycle, no occurrences of the application are generated for that day and time, regardless of what is generated by a regular or normal run cycle. Run cycles are used in conjunction; exclusion run cycles are used to suppress run days generated by regular or normal run cycles.
- A
- Rule-based run cycle group or subset. Applies to all the run cycles within a run cycle group or a run cycle group subset.
- D
- Exclusion rule-based run cycle group or subset. Applies to all the run cycles within a run cycle group or a run cycle group subset.
- Free day rule
- Required input for all run cycles, which indicates how run days
are treated:
- E
- Free days excluded; only work days are taken into account
- 1
- Free days included; run on the nearest day before the free day
- 2
- Free days included; run on the nearest day after the free day
- 3
- Free days included; run on the free day
- 4
- Free days included; do not run at all.
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name | Description |
| 0 | (0) | STRUCTURE | 160 | RGRUN | RUN CYCLE SECTION |
| 0 | (0) | CHARACTER | 8 | RGRNAME | RULE NAME |
| 8 | (8) | CHARACTER | 6 | RGRVALF | RUN CYCLE VALID-FROM |
| 14 | (E) | CHARACTER | 6 | RGRVALT | RUN CYCLE VALID-TO |
| 20 | (14) | CHARACTER | 50 | RGRDESC | RUN CYCLE DESCRIPTION |
| 70 | (46) | CHARACTER | 1 | RGRRULE | RULE FOR WORK/FREE DAYS |
| 71 | (47) | CHARACTER | 1 | RGRTYPE | TYPE (R | E | A | D) |
| 72 | (48) | CHARACTER | 4 | RGRIAT | INPUT ARRIVAL TIME |
| 76 | (4C) | UNSIGNED | 1 | RGRUNVERS | RECORD VERSION NUMBER |
| 77 | (4D) | CHARACTER | 3 | * | RESERVED |
| 80 | (50) | CHARACTER | 16 | RGRJVTAB | JCL VARIABLE TABLE |
| 96 | (60) | CHARACTER | 4 | * | RESERVED |
| 100 | (64) | SIGNED | 2 | RGRIRDLEN | RULE DEFINITION LENGTH |
| 102 | (66) | CHARACTER | 4 | RGRREPEATEVERY | REPEAT EVERY |
| 106 | (6A) | CHARACTER | 4 | RGRREPEATENDT | REPEAT END TIME |
| 110 | (6E) | CHARACTER | 8 | RGRSETID | RUN CYCLE CORRELATOR |
| 118 | (76) | CHARACTER | 16 | RGRCALENDAR | RUN CYCLE CALENDAR |
| 134 | (86) | CHARACTER | 2 | * | RESERVED |
| 136 | (88) | SIGNED | 4 | RGDD | DEADLINE DAY RELATIVE TO START |
| 140 | (8C) | CHARACTER | 4 | RGDT | DEADLINE TIME |
| 144 | (90) | CHARACTER | 16 | * | RESERVED |
| 160 | (A0) | CHARACTER | * | RGRIADALL | RULE DEFINITION |
| Offsets | |||||
|---|---|---|---|---|---|
| Dec | Hex | Type | Len | Name | Description |
| 160 | (A0) | STRUCTURE | * | RGRIADALL | RULE DEFINITION |
| 160 | (A0) | SIGNED | 4 | RGRULEL | RULE LENGTH (RGRULEL + RGRULET) |
| 164 | (A4) | CHARACTER | * | RGRULET | RULE TEXT |
RGRIRDLEN identifies the length of the rule definition. The RGRIADALL structure contains a fullword copy of RGRIRDLEN (RGRULEL), which is followed by the rule text. RGRULEL must specify the same length as RGRIRDLEN. You can insert comments or extra blanks when creating a rule, but these characters are not saved in the RG database.