MPE/iX Commands Reference Manual (32650-90864)

428 Chapter 6
Command Definitions P-R
PAUSE
PAUSE
The PAUSE command allows the current task to be suspended or “sleep” for a specifiec
number of seconds.)
NOTE This command follows the optional MPE/iX command line syntax. Refer to
"Optional Format for MPE/iX Commands" at the beginning of this chapter.
Syntax
PAUSE [num_seconds]
[[ ;JOB= ]jobid]
[ [;INTERVAL=] interval_secs]
[ ;EXIST | WAIT | NOTEXIST]
Parameters
Collectively EXIST, WAIT and NOTEXIST are referred to as the "while_state", since PAUSE
sleeps "while" the specified state is true.
num_seconds If num_seconds is specified without jobid PAUSE sleeps for that many
seconds, or until the process issuing the pause is interrupted by the break
signal. If "jobid" is also supplied then "num_seconds" has a different
meaning. In this case it indicates the maximum duration for the PAUSE
command, such that PAUSE should continue while the selected jobs are in
their "while_state" or when num_seconds has expired, whichever is shortest.
Thus, num_seconds represents the maximum length of the pause. If PAUSE
completes but one or more jobs are still in their "while state" a CIWARN is
reported.
NOTE to pause while a job is in its "while_state" or until num_seconds has expired,
whichever is LONGEST, one can execute the following two commands:
PAUSE x
PAUSE job=y ;z
If after X seconds job Y is still in state Z then the second PAUSE continues
while state Z applies. On the other hand, if after X seconds job Y is not in
state Z then the pause is complete. or equal to zero.
jobid can be one of: [#]Jnnn, [#]Snnn, [ jobname,]user.acct, @, @J, @S. Note if
jobname is included than the jobid must be quoted since the comma is a
command token delimiter.
If the JOB= parameter is specified then PAUSE sleeps while jobid is in its
"while_state". jobid can be an executing, waiting, scheduled job, or a
session. jobid can also name many jobs or sessions. Wildcarding is
supported, and a non-wildcarded [jname,]user.acct can match several jobs or
sessions. The job name value can be " ," or " @," to match all jobs or