NET/MASTER Management Services (MS) Operator's Guide

Issuing Timer Commands
Issuing NonStop NET/MASTER MS Commands
106379 Tandem Computers Incorporated 3–7
Timer commands execute under your authority level, even if you route them to be
executed under another NonStop NET/MASTER MS user.
Note Timer commands included in an NCL procedure that executes during system startup execute under the
authority level of the NonStop NET/MASTER MS user who is bringing up the NonStop NET/MASTER MS
application.
Limiting the Number of
Times a Command Is
Executed
Include a LIMIT operand in your timer command string to limit the number of times a
command executes. A limit counter is incremented each time the command is
executed. After reaching the specified limit, NonStop NET/MASTER MS purges the
command from the timer queue.
Note If you include a PMSG=YES operand in your timer command string, a message is displayed when the
command is purged from the timer queue.
If you include a ROUTE operand in your timer command string, and the command is not executed
because the target user is not logged on, the limit counter is not incremented.
The following example executes the SHOW USERS command every 10 minutes for a
total of five times starting at 1:30 p.m :
AT 13:30 EVERY :10 LIMIT 5 CMD=SHOW USERS
To display the limit and the number of times a command has already executed, issue a
SHOW TIMER command.
Purging a Timer Command Use the following PURGE commands to explicitly purge timer commands from the
timer queue.
Purge all timer commands owned by your user ID by using the PURGE
TIMER=OWN command.
Purge all timer commands in the queue by using the PURGE TIMER=ALL
command (provided you have sufficient authority).
Purge a particular timer command by using either the user-supplied timer ID or
the system-generated timer ID number to identify the command with the PURGE
TIMER={
user-timer-ID
|
system-timer-ID
} command.
To purge several individual timer commands, repeat the TIMER operand. For
example:
PURGE TIMER=12 TIMER=15 TIMER=OCSUSERS
returns the following confirmation messages in the message display area:
NNM1737 TIMER COMMAND ID NUMBER 12 PURGED
NNM1737 TIMER COMMAND ID NUMBER 15 PURGED
NNM1737 TIMER COMMAND ID NUMBER OCSUSERS PURGED
Issue a SHOW TIMER command to display the purge IDs and timer IDs (if assigned)
of all commands in the timer queue.