OPSWAIT Command Processor—Suspend CLIST or REXX Processing

POI Command Processors › OPSWAIT Command Processor—Suspend CLIST or REXX Processing

OPSWAIT Command Processor—Suspend CLIST or REXX Processing

The OPSWAIT command processor enables you to suspend processing of a CLIST or REXX program until one of the following time events occurs:

A time interval
A specific time of day
An event time interval

OW is the abbreviation of OPSWAIT.

The OPSWAIT command processor has the following format:

OPSWAIT
{FOR(interval)|UNTIL(hh:mm:ss)|SYNCH(hh:mm:ss)}
[MAXTIME(hh:mm:ss)]

FOR

Use this keyword to delay CLIST or REXX program processing for a specific amount of time, either a number of seconds or an hh:mm:ss (hours, minutes, seconds) value. The following examples show how to specify these intervals:

To wait for half a second, specify the following value:
```
FOR(.5)
```
To wait for 23 seconds, specify the following value:
```
FOR(23)
```
To wait for two hundred seconds, specify the following value:
```
FOR(200)
```
To wait for five minutes and 25 seconds, specify the following value:
```
FOR(5:25)
```
To wait for two hours and 15 minutes, specify the following value:
```
FOR(2:15:00)
```

Note: When specifying an interval as seconds without colons, you can use up to two decimal places to indicate fractions of seconds.

UNTIL

Use this keyword to delay CLIST or REXX program processing until a specific time of day. If the specified time has already passed, the OPSWAIT command either terminates or waits until the correct time of day tomorrow, depending on the value of the MAXTIME keyword. For example, suppose that the current time is 13:23:00:

To wait for six minutes, specify the following value:
```
UNTIL(13:29:00)
```
To wait for 23 hours and 52 minutes, specify the following value:
```
UNTIL(13:15) MAXTIME(23:59:59)
```
To not wait at all, specify the following value:
```
UNTIL(13:15) MAXTIME(2:00:00)
```

SYNCH

Use this keyword to delay CLIST or REXX program processing until the start of a specified time interval. This interval can be the start of the next minute, next five-minute period, next hour, and so on. For example, suppose that the current time is 13:23:00:

To wait until the next 30-second interval starts (at 13:23:30), specify the following value:
```
SYNCH(30)
```
To wait until the next minute begins (at 13:24:00), specify the following value:
```
SYNCH(1:00)
```
To wait until the next two-hour interval starts (at 14:00:00), specify the following value:
```
SYNCH(2:00:00)
```

MAXTIME

(Optional) Use this keyword to define the maximum amount of time that the OPSWAIT command is allowed to delay CLIST or REXX program processing by specifying either a value in hh:mm:ss format or the number of seconds (with up to two decimal places to indicate fractions of seconds).

If the command exceeds the specified maximum wait time, then it does not wait and a return code 8 is issued.

If this keyword is not specified, then the default maximum wait time of 8 hours is used.

Tell Technical Publications how we can improve this information