Communicator 3000 MPE/iX Release 6.0 (Platform Software Release C.60.00) (30216-90269)

206 Chapter 10
Technical Articles
CI Enhancements
NOTEXIST means to pause while the matching job or jobs do not
exist. As soon as any jobs matching jobid exist (in any
state) the pause completes. PAUSE might miss finding
short-lived jobs. This is particularly true for a match on
a single job/session number. A more practical use might
be:
PAUSE job=@J;notexist
which means to sleep while no jobs exist. As soon as the
first job is streamed the above pause stops.
Collectively EXIST, WAIT, and NOTEXIST are referred to as the
"while_state," since PAUSE sleeps "while" the specified state condition is
true.
Parameters
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 the 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, 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.
jobid can be one of: [#]Jnnn, [#]Snnn, [jobname,]user.acct, @,
@J, @S. Note if jobname is included then 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 can be ","
or "@," to match all jobs or sessions without a job name.