Operands
NAme schdid
- Specifies the name of the schedule.
ACTION actnid
- Specifies the name of the action to associate with the schedule. This action must have been previously defined using the DEFACTN command or the built-in action NULL.
WHEN mm
- Specifies the processing time is hourly. The action is scheduled at mm minutes of the hour.
WHEN hh:mm
- Specifies the processing time is daily. The action is scheduled at hh:mm time of the day. For example, 01:30 refers to 1:30 A.M., and 13:30 refers to 1:30 P.M.
EVERY hh:mm
- Specifies the processing time is based on an interval. The interval is every hh:mm of the day starting with Operations Manager startup, configuration file reload, or DEFSCHD definition.
WHEN dow-hh:mm
- Specifies the processing time is weekly. The action is scheduled on a specific
"dow" or day of the week (
MON
,TUE
,WED
,THU
,FRI
,SAT
, orSUN
) at hh:mm time of the day. WHEN dd-hh:mm
- Specifies the processing time is monthly. The action is scheduled on dd day of the month at hh:mm time of the day.
WHEN EM-hh:mm
- Specifies the processing time is monthly. The action is scheduled on the last day of the month at hh:mm time of the day.
WHEN cntdow-hh:mm
- Specifies the processing time is monthly. The action is scheduled on the specified day at
hh:mm time of the day.
- The cnt can be
1ST
,2ND
,3RD
,4TH
,5TH
, orLST
. - The dow can be
MON
,TUES
,WED
,THU
,FRI
,SAT
,SUN
,WKD
(week day), orWKE
(weekend day).
- The cnt can be
WHEN mm/dd-hh:mm
- Specifies the processing time is yearly. The action is scheduled on mm/dd of the year at hh:mm time of the day.
WHEN Iwk-d-hh:mm
- Specifies the processing time is based upon the ISO week number.
- The wk value can be a week number (01-53), the first week (FW), last week (LW), even-numbered week (EV), or odd-numbered week (OD).
- The d value is the ISO "day of the week" number (1-7). The days are numbered from 1 (Monday) through 7 (Sunday).
- The action is scheduled at hh:mm time of the day.
WHEN NOW+hh:mm
- Specifies the processing time to be once, after a delay of hh:mm from
now. The hh:mm may range from
+00:00
to+23:59
. If omitted, the default is+00:00
. WHEN yyyy/mm/dd-hh:mm
- Specifies the processing time to be once on the specified date and time. The action is not scheduled if the date entered has already occurred or never occurs.
PARM parm
- Specifies the parameter or list of parameters to be passed to the ACTION when it is scheduled to
run. The value(s) may be entered as parm, but must be enclosed in quotation marks
(
'parm'
) if there is more than one blank-delimited value. The DEFACTN command can use the parameter through the&p
substitution variable. The parameter is also available to any chained action routine that is defined in theNEXTACTN
operand on the DEFACTN command. DAYS MTWTFSSH
- Specifies the days of the week (Monday-Sunday) and if the schedule is active on holidays. For the schedule to be active on a day of the week and holiday, the corresponding location must contain the asterisk (*) symbol. The default is all days and holidays (********). See DEFDATE for information on defining holidays.
HOURS h,h,...,h
- Specifies the hours of the day the schedule is active. Any of
the values from
0
to23
may appear in the comma-separated list. Up to 24 values may be present. The default is all hours. ENV procenv[,procsys]
- Specifies that the processing environment and system of the action is to be overridden with the values assigned to procenv and procsys. See DEFACTN for more information on overriding the processing environment and system, and valid values for procenv and procsys.
LIMIT count,interval[,lmactn]
- Specifies that the processing of the schedule's ACTION is limited to count
times within interval period of time. Optionally, this command processes the
alternate action specified by lmtactn if the limit condition is encountered.
- The value for count must be from 0 to 999999.
- When specified as a single positive integer, the value for interval must be
from 0 to 999999 seconds. You can also use the format
of
ddd-hh:mm:ss
, which specifies the interval value in days (ddd), hours (hh), minutes (mm), and seconds (ss). The maximum value for this input format is 999-23:59:59.For example, a LIMIT of 4 times in 10 seconds could be specified as:
LIMIT '4,10' OR LIMIT '4,000-00:00:10'
- A value of 0 for count and interval indicates that no processing limit should be applied. If count or interval are 0, both count and interval must be 0, and the lmtactn value omitted. If count and interval are non-zero, the alternate action lmtactn may be specified. The action lmtactn is only processed once if the limit condition is encountered within an interval.
Note: If the LIMIT operand is omitted, the default count and interval are obtained from the DEFOPTN command, EMONLIM operand. SYSGRP groupid
- Specifies that this schedule is only applicable for systems where the local system name is in the group named groupid.
EXSYSGRP groupid
- Specifies that this schedule is only applicable for systems where the local system name is not in the group named groupid.
MAXDEFER n
- Specifies the number of minutes the schedule may be delayed from the beginning of the processing
due to
CONFLICT
. If a schedule is not able to begin before theMAXDEFER
value is reached, the schedule is advanced to the next processing time. The default is0
minutes. CONFLICT schid,schid,...,schid
- Specifies up to 16 conflicting schedules. If any of the specified
schedules are processing, this schedule is deferred from processing.
The schedule is then checked every minute until
MAXDEFER
is reached.