SETTIMER
Purpose
SETTIMER displays all scheduled timers. You can add, change, delete, suspend, and reactivate timers.
Syntax
Parameters
- TARGET
- For information on the TARGET parameter, see TARGET Parameter.
- OUTMODE
- For information on the OUTMODE parameter, see OUTMODE Parameter.
Restrictions and Limitations
The SETTIMER command can only be used when SA z/OS® is initialized.
Usage
For instructions on how to add, change, or delete timers, see Setting Timers
in
IBM Z System Automation User's Guide.
Examples
settimer a
panel similar to Figure 1 is displayed. AOFKATI SA z/OS - Command Dialogs Line 1 of 43
Domain ID = IPSFP ---------- SETTIMER ---------- Date = 09/09/08
Operator ID = NETOP1 System = KEY4 Time = 09:21:21
Enter ADD on the COMMAND line to create a new timer entry
or use CMD selections A add, C change, or D delete to delete existing timers.
U Suspend timer, or R Resume to re-activate timer
CMD TIMER-ID SCHEDULED TIME TYPE TASK INTERVAL CLOCK SAVE CTUP
--- -------- ----------------- ----- -------- ------------ ----- ---- ----
MEMSTORE 09/09/08 15:42:03 EVERY AUTO2 000 00:02:00 GMT NO
Cmd: MEMSTORE 5% 5
RGTAMCPU ** SUSPENDED ** CHRON AUTRGTA 000 00:05:00 GMT NO
Cmd: CHRON EVERY=(INTERVAL=(00.05.00)) ROUTE=AUTRGTA ID=RGTAMCPU COMMA
ND='RGTAMCPU'
AOFI000F 09/09/08 15:45:52 AFTER PPT GMT NO
Cmd: AOFRASCD AOFWRK10 AOFRSMTR MONITOR,HGDDSMTR/MTR/KEY4
AOFI0010 09/09/08 15:45:52 AFTER PPT GMT NO
Cmd: AOFRASCD AOFWRK13 AOFRSMTR MONITOR,HGMTRINFORM/MTR/KEY4
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve - The CMD field allows you to add, change, or delete a timer.
Valid values are:
- A
- Add a new timer with the same values as the one selected.
- C
- Change an existing timer.
- D
- Delete a timer.
- U
- Suspend a timer. The timer is deleted from NetView but all its relevant data is kept in common global variables. Only CHRON timers can be suspended.
- R
- Resume (or reactivate) a suspended timer. Timers that are associated with a subsystem have a new timer ID (ITMRxxxx) assigned to them.
- The TIMER-ID field shows the name assigned to the timer. It cannot be ALL or begin with a number or the words SYS, RST, AOF, or ING. Valid characters are A–Z, 0–9, #, @, $, , !, _ and ?.
- The SCHEDULED TIME field shows the next scheduled day and time that this timer is set to expire.
- The TYPE field shows the type of timer. There are three
types:
- After
- Set to occur only after the elapsed time that was specified when the timer was scheduled. For example, if at 12:00 am, you specify 2 hours, the timer will expire at 02:00 pm.
- At
- Set to occur at the specified date and time. Occurs only once.
- Every
- Set to occur at the time intervals indicated in the Interval field, or at a specific time each day or week.
- The TASK field shows the operator where the timer runs.
This can be a primary programmed operator interface task (PPT), an
automation operator, or a human operator. This task must be logged
on when the timer is set and when it expires. It can also specify a group name. Group names must begin with a plus (+) sign. If a group name is specified, the command runs on the first task in the group that is active when the timer expires.Note: Not all commands can run under the PPT.
- The INTERVAL field is only valid for Every type timers. It indicates the time intervals that the timer is set to occur at. For example, a value of 00:30:00 means that the timer will issue the command specified every 30 minutes.
- The CLOCK field specifies the time format. It can be GMT, which means that a local time change does not affect the command processing, or LOCAL, so that the time is to be adjusted automatically when daylight saving time changes, or when the z/OS time is adjusted by an operator for other reasons.
- The SAVE field specifies whether the timer is to be saved to an external file. This allows the timer to be restored after a NetView outage. This applies to timers created using either the customization dialog or the operator interface. Valid values are YES or NO. The default is YES.
- The CTUP field specifies whether to activate the timer
if it occurs at a time when NetView is down. Valid
values are Yes or No. If CTUP is set to YES, the command specified
in the timer definition is issued when NetView is restarted,
if the timer expired while NetView was down. The field can only be set to YES if:
- This is an At type timer (it occurs once at a specific time and date).
- The timer was created using the customization dialog.
- The Save field is set to YES.
- The Cmd field below the timer ID specifies the command to be issued when the timer expires.
Adding a new timer or changing an existing one leads to the Add/Change Timer panel, similar to Figure 2.
AOFKATIR SA z/OS - Command Dialogs
Domain ID = IPSFP ---------- SETTIMER ---------- Date = 11/27/06
Operator ID = NETOP1 Add/Change Timer Time = 12:38:41
Timer ID => MEMSTORE on System : SAT1
Type => EVERY AFTER, AT or EVERY
When?
- Interval => days 0-365 and 00:02:00 hh:mm:ss (AFTER EVERY)
From => hh:mm:ss To hh:mm:ss (EVERY)
- Day of Week => at (AT or EVERY)
- Specific date => mm/dd/yy at (AT)
Task => AUTO2 Operator ID, PPT or Group name
Save => NO No, Yes Timer clock => GMT GMT, LOCAL
Notify =>
Remark =>
CHRON parameters =>
Timer command => MEMSTORE 5% 5
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve To set the timer, fill in the fields (note that if you are changing a timer the Timer ID field cannot be altered).
| Timer Type | Fields |
|---|---|
| AFTER | Interval: The number of days (0–365) to elapse before the timer is run. |
| AT | Day of Week: Specify the day of the week (Monday through Sunday). Only
the first three characters are required (for example, FRI for FRIDAY). Specific date: Specify the date (in mm/dd/yy notation) and time (in hh:mm:ss notation). Hours and seconds default to zero if not entered. If the time begins with an X or multiple Xs instead of a number, the command is set to begin at the next increment of time. |
| EVERY | Interval: The number of days (0–365) to elapse before the timer is run.
From/To: You can also specify the date and time that the interval is to start and to end. If omitted, the timer runs from midnight to midnight. Day of Week: Specify the day of the week (Monday through Sunday). Only the first three characters are required (for example, FRI for FRIDAY). You can also specify DAILY for every day of the week, WEEKDAY, or WEEKEND. |
Use the Notify field to specify the value for CHRON parameter NOTIFY which defines to whom a BNH549I message is sent a notification when certain events occur in the processing of the CHRON command. It supports four event types IGNORE, PURGE, REMOVE and RUN. This field is automatically enclosed in parentheses.
Use the Remark field to specify the value for the CHRON parameter REM which can be any string specifying informational data. The field is automatically enclosed in quotes.
Use the CHRON Parameters field to specify additional CHRON parameters, such as REFRESH or RECOVERY.
You can also specify suboptions of the EVERY parameter such as REMOVE, REMAFTER, DAYSMON, CALENDAR, MXREPEAT, OFF, or FOR.
Enter the command that is to be run when the timer expires in the Timer command field. The command can span the three input fields, which are protected if the timer command does not fit in the fields. You can use the PF4 key to clear the command fields.