HP 3000 Manuals HP 3000 Manuals
STREAM Command Changes
by Grace Liu
Commercial Systems Division
With this release of MPE XL, the STREAM command schedules and reschedules
jobs more consistently and flexibly. The algorithm for rescheduling a
job with the option DAY or DATE has been modified slightly. However, the
syntax of the command has not changed.
The following are new MPE error and warning messages:
Can't specify a date previous to the current date. (CIERR 6305)
There aren't that many days in this month. Last day of this
month is assumed. (CIWARN 6335)
The following are modified MPE error and warning messages:
Expected a number between 31 and -31 inclusive for the day of
month or day from end of month specification. (CIERR 6321)
Day from the end of month is greater than total number of days in
month. First day of this month is assumed (CIWARN 6323)
ALGORITHM
There are no changes for AT and IN options.
Here are the new strategies in redirecting a scheduled job with DAY
option to a future day, if the time or day has passed:
{dow}
DAY = {dom} [; AT= timespec]
{dem}
dow - Reschedule for the same time of next weekday.
dom - Reschedule for next month, same day and same time.If
DOM specified is greater than total number of days in
next month, last day of next month is assumed.
Note: If DOM is greater than the total number of days in this
month, and time or day hasn't passed yet, reschedule for
the last day of this month.
dem - Reschedule for next month, same time. The day of month
might be slightly different from this month, because it
depends on the total number of days we have for the coming
month. If the positive value of DEM is greater than the
total number of days in the next month, the first day of
the coming month is assumed.
Here are the new strategies in handling the DATE option. This option is
specified in the format mm/dd/yy. It is an absolute date specification.
1. If the date specified is less than the current date, an error
message is generated - CIERR 6305.
2. If the date specified is equal to the current date but the time is
passed, an error message is generated - CIERR 6303.
3. If the date specified is equal to the current date and the time is
not passed, the job is scheduled for the specified time.
4. If the date specified is greater than the current date, the job is
scheduled for the specified date and time.
Example
The following are examples of STREAM command usage. For these examples,
assume that the current date and time are Monday, February 5, 1990, 12:00
p.m.
Current date: February 5, 1990
Weekday: Monday
Time: 12:00 p.m.
:STREAM JOBFILE JOBFILE will be introduced immediately
:STREAM JOBFILE; AT=8:00 JOBFILE will be introduced at 8:00 a.m.
Tuesday, February 6.
:STREAM JOBFILE;AT=20:00 JOBFILE will be introduced at 8:00 p.m.,
Monday, February 5.
:STREAM JOBFILE;IN=,8 JOBFILE will be introduced in eight hours,
at 8:00 p.m., February 5.
:STREAM JOBFILE;IN=1,8 JOBFILE will be introduced in one day plus
eight hours, at 8:00 p.m., Tuesday,
February 6.
:STREAM JOBFILE;DAY=MON;AT=8:00 Since the time specified (8:00 a.m.) is
earlier than the current time, JOBFILE will
be introduced at 8:00 a.m., Monday,
February 12.
:STREAM JOBFILE;DAY=MON;AT=20:00 Since the time specified (8:00 p.m.) is
later than the current time, JOBFILE will
be introduced at 8:00 p.m., Monday,
February 5.
:STREAM JOBFILE;DAY=6;AT=20:00 Since the day of the month(6) is later than
the current day of the month (5), the
current month is assumed. JOBFILE will be
introduced on Tuesday, February 6 at 8:00
p.m.
:STREAM JOBFILE;DAY=4 Since the day of the month is earlier than
the current day (5), next month is assumed.
Since no time was specified, JOBFILE will
be introduced on Sunday, March 4, at 12:00
p.m.
:STREAM JOBFILE;DAY=31 Since there is no February 31, a CIWARN
6335 is given, and the job is scheduled for
last day of this month February 28, at
12:00 p.m.
:STREAM JOBFILE;DAY=-2 The "-2" means the second to last day of
the month, and since no time was specified,
the current time is used. JOBFILE will be
introduced on Tuesday, February 27, at
12:00 p.m.
:STREAM JOBFILE;DATE=2/5/90;AT=8:00 Since the date to run JOBFILE is given in a
mm/dd/yy format, assume user does not want
rescheduling. In this case, date is
current, but time passed, so it is flagged
as an error.
:STREAM JOBFILE;DATE=2/5/90;AT=20:00 The specified time is later than the
current time, so this command is legal.
JOBFILE will be introduced on Monday,
February 5, at 8:00 p.m.
:STREAM JOBFILE;DAY=-24;AT=8:00 The date is today, but the time has passed,
so scheduled for same "DAY" of next month.
JOBFILE will be introduced on March 8, at
8:00 a.m.
:STREAM JOBFILE;DAY=-24 User specifies a day but does not specify a
time, a warning message is generated and
the specified job will log on immediately.
:STREAM JOBFILE;DAY=32 Maximum number of day in a month is 31,
same for DEM, value given couldn't be
greater than 31, else will be flagged as an
error.
:STREAM JOBFILE;DAY=-31 The "-31" means first day of this month.
Since specified day is earlier than current
day, JOBFILE will be introduced on March 1,
12:00 p.m.
:STREAM JOBFILE; DAY=-25 The "-25" means the twenty-fifth day from
the end of the month which implies February
4. But February 4 is earlier than current
day; therefore, the next month is assumed.
JOBFILE will be introduced on March 7,
12:00 p.m.