 |
» |
|
|
|
The STREAM command submits a batch job for execution. The batch job runs
independently of your session, which enables you to continue working at
your terminal while the batch job is running. You can also use this command
in conjunction with the DATA command to submit data to the system from a
device file. Syntax | |
STREAM [filename][,char]
[;AT = timespec][;DAY = {day-of-week
day-of-month
days-until-month}]
[;DATE = datespec][;IN = [days[,[hours][,minutes]]]]
|
Parameters | |
- filename
Specifies
the ASCII file containing the job commands. The first
character of the first record is assumed to be the replacement character for the
expected colon (:)
that identifies commands. You must have read (R) and lock (L) or
execute (X) file access in order to specify this parameter.
- char
Identifies MPE/iX commands within the input file. It is a
character that substitutes for a colon (:). When you
enter the input file on a device configured to accept jobs or sessions,
this character can be any ASCII non-alphanumeric character except a colon.
The default is an exclamation point (!).
- AT
Specifies the absolute time of day. Execution begins
in the format
HH:MM, where HH is the hour of the day (0<=HH<=24)
and MM are the minutes
of the hour (0<=MM<=60).
If you do not specify DAY and DATE, then:
timespec < NOW---> JOB LOGON TOMORROW
timespec > NOW---> JOB LOGON TODAY
timespec = NOW---> JOB LOGON IMMEDIATELY
WITH EXPLANATORY MESSAGE
|
- DAY
Specifies the absolute day in one of the following forms: - day-of-week
Indicates the day of the week. Permissible values are
SUN[DAY]
MON[DAY]
TUE[SDAY]
WED[NESDAY]
THU[RSDAY]
FRI[DAY]
SAT[URDAY]
|
- day-of-month
Indicates the calendar day of the month expressed
using the integers 1 through 31. If day-of-month is greater than or
equal to the current day-of-month, the current month is
the default.
If day-of-month is less than the current day-of-month, the
day-of-month is deferred until the same day of the next month.
An error message is generated if the day-of-month
does not correspond to the month (for example, if you enter 31 for
February). If you omit day-of-month, the current date is used.
- days-until-month
Indicates
days until the end of the month expressed
using the negative integers -31 through -1. The chosen number specifies
the calendar day from the end of the specified month when
the job will run. For example, a -1 value represents the last day
of the month. If the specified day from the end of the month indicates
a day earlier than the current day, the next month is assumed. For
example, if today is the seventh day
from the end of the month and you enter a -8
value, the job is scheduled for the eighth day from the
end of the next month.
- DATE
Specifies the absolute date in the format mm/dd/yy,
where mm is the month
(1<=mm<=12), dd is the day (1<=dd<=31),
and yy is the year. If you omit this parameter,
the current date is used.
- IN
Specifies the relative date or time in one of the following forms: - days
Indicates the number of days from the current date expressed as
a positive integer.
- hours
Indicates the number of hours from the current time expressed as
a positive integer (0<hours<=23). If you omit this parameter,
zero is used.
- minutes
Indicates the number of minutes from the current time expressed as
a positive integer (0<=minutes<=59). If you omit this
parameter, zero is used.
Operation Notes | |
Usage You can enter this command from a session, a job, a program, or in
break mode. Pressing Break during
an interactively streamed job aborts execution of the job.
Requirements You must have read (R) and lock (L) or
execute (X) file access in order to stream jobs.
The system administrator should assign general users only X access, because
R and L access would allow
general users to obtain security information within the file, such as
passwords and lockwords. You can initiate stream jobs only if the system administrator
has enabled the stream facility by entering the STREAMS console command.
Creating a job stream To create a job file for streaming, do the following: Enter the following command to invoke the EDIT subsystem: Enter the ADD command, then add job file commands, as shown:
/ADD
1 !JOB SMITH,USER.TECH
2 !COMMENT THIS JOB RUNS THE MONTHLY UPDATE PROGRAM
3 !FILE INPUT01=TRANS.DATA.ENGR
4 !FILE MASTER;DEV=TAPE
5 !FILE OUTPUT=NEWFILE.PUB.TECH
6 !RUN UPDPROG
7 !EOJ
8 //
|
Note that the first command is the JOB command and that an exclamation
point (!) precedes each command. Enter the KEEP and END commands to save your file and terminate the
EDITOR subsystem:
Scheduling streamed jobs When you schedule a job for future execution, it enters the SCHED state.
When the specified time arrives, the job enters and remains in the WAIT state
until the system allows the job to execute.
You can specify the time a job is
to enter the WAIT state in absolute or
relative time. The differences are as follows: - Absolute
You specify an exact time for the job using the AT parameter with
or without the DAY or DATE parameter. - Relative
You specify a time offset
from the current time using the IN parameter.
If the time that you specify is the same as the current time, your streamed job
logs on immediately. If the time that you specify is earlier than the
current time and you do not specify DAY and DATE,
a warning message is
generated, and the job is scheduled for the specified time tomorrow; otherwise, you can specify any time in
the current century.
Because of the limited recoverability of scheduled jobs, it is recommended that
you schedule jobs no more than a few days in advance. If you specify DAY or DATE for a job, but do not specify a
time, the job does not enter the WAIT state
at midnight on the specified
day. Instead, the job uses the time
when the STREAM command executes and
enters the WAIT state at that time on the specified day. If the system does not detect any errors,
a job ID appears on your screen. If you include more
than one job in the input file, the system assigns each job
a unique job ID and schedules all of the jobs
at the same time.
Redirecting the listing device If you want the job listing to appear on a device other than the
standard listing device associated with the streaming device, you can
specify this other device using the JOB command as shown:
!JOB USER.TECHPUBS;OUTCLASS=12
|
Terminating interactively streamed jobs To terminate interactive job input,
enter a colon (:). The system responds by displaying the
command interpreter prompt:
>: ** Denotes end of batch job input **
: ** MPE/iX prompts for next command **
|
Pressing Break aborts the execution of this command
and any job currently being entered through the command. Incompletely spooled
disk space returns to the system.
Terminating scheduled streamed jobs You can use the ABORTJOB command to terminate jobs that you have scheduled
for STREAM execution. Refer to the ABORTJOB command for information
on its usage.
Rescheduling system-terminated streamed jobs If the system fails or is intentionally stopped, your stream jobs may be
saved or deleted, depending on the method used to restart the system.
If you have scheduled a job for execution earlier than the system restart,
the job enters the WAIT state and executes when the system parameters allow
it to execute. After the system is restarted, you should first enter the SHOWJOB command
to display the scheduled jobs. Reschedule your stream jobs that do not
appear as scheduled jobs.
Examples | |
The following examples assume that the current date and time are
Monday, June 10, 1991 at 12:00 pm. The examples also
assume that the input file, named JOBFILE, contains a valid STREAM job. To introduce JOBFILE immediately, enter: To introduce JOBFILE at 8:00 am, Tuesday, June 11, enter: To introduce JOBFILE at 8:00 pm, Monday, June 10, enter:
:STREAM JOBFILE; AT=20:00
|
To introduce JOBFILE in eight hours, at 8:00 pm, Monday, June 10, enter: To introduce JOBFILE in one day plus eight hours, at 8:00 pm, Tuesday,
June 11, enter:
Sometimes you may enter a stream job intending it to be introduced at a certain
time, but the system interprets your entry differently than your intentions,
as illustrated in the following examples: - STREAM JOBFILE; DAY=MON; AT=8:00
Since the time specified (8:00 am) is earlier than the current time,
JOBFILE will be introduced at 8:00 am, Monday, June 17.
- STREAM JOBFILE; DAY=5
Since the day of the month (5) is earlier than the current day (8), the
next month is assumed. Since no time was specified,
JOBFILE will be introduced on
Saturday, July 6, at 12:00 pm.
- STREAM JOBFILE; DAY=31
Since June 31 does not exist, the next month is assumed. Since July 31 does
exist, this is a legal command. JOBFILE will be introduced on
Wednesday, July 31, at 12:00 pm. If July 31 did not exist, this command
would cause an error.
- 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
Sunday, June 30, at 12:00 pm.
- STREAM JOBFILE; DAY=-25
The -25 means the twenty-fifth day
from the end of the month. If one
assumes the current month, that implies June 6, but June 6 is
earlier than the current day; therefore, the next month is assumed.
JOBFILE will be introduced on Sunday, July 7, at 12:00 pm.
- STREAM JOBFILE;
DATE=6/8/87; AT=8:00
Since the specified time is earlier
than the current time, this command
is not permissible, and it causes an error.
- STREAM JOBFILE;
DATE=6/8/87; AT=20:00
The specified time is later than the current time, so this command is
permissible. JOBFILE will be introduced
on Monday, June 10, at 8:00 pm.
Related Commands | |
ABORTJOB
JOB
LISTSPF
SHOWJOB
STREAMS
|
|
