670 Chapter 8
Command Definitions SP-Z
STREAM
Pressing Break aborts the execution of this command and any job currently being entered
through the command. Incompletely spooled disk space is returned to the system.
If you make an error while entering the MPE/iX JOB command, you receive an error
message on your job listing device. The system operator, however, receives no indication of
the job or the error.
Terminating Time Scheduled Job
Jobs that have been scheduled for STREAM execution can be terminated with the ABORTJOB
command. Refer to the Introduction to MPE XL for MPE V System Administrators
(30367-90003) for information on using the ABORTJOB command to terminate
time-scheduled jobs.
In order to STREAM a file, you must have READ and LOCK access or EXECUTE access to
that file. However, READ and LOCK access would allow general users to obtain security
information within the file, such as passwords and lockwords. To allow general users to
STREAM the file without giving them access to secure information, you may allow
EXECUTE access only.
NOTE Scheduled jobs survive a START RECOVERY. Any other type of system startup
causes scheduled jobs to be deleted. If a job is scheduled for introduction
earlier than the system startup, the job enters the WAIT state and executes
when the system parameters allow it to execute.
If the system is brought down for any reason, first execute a SHOWJOB
command to show the scheduled jobs. Then reschedule the jobs when the
system is brought back up on anything other than a START RECOVERY.
A scheduled job uses an entry in the JMAT table. Because of the limited
recoverability of scheduled jobs, it is recommended that jobs be scheduled no
more than a few days in advance.
If a user specifies a day or date for a job, but does not specify a time, the job
does not enter the WAIT state at midnight on the specified day. Instead, it
uses the time that the STREAM is executed, and enters the WAIT state at that
time on the specified day.
Use
This command may be issued from a session, job, program, or in BREAK. Pressing Break
aborts the execution of this command and any partially streamed job.
Examples
To stream a job from a disk file, you must name the input file in the STREAM command:
STREAM ABC
If you use a character other than an exclamation point (!) as the substitute command
identifier in your job input, you must identify that character in the STREAM command.
Because you enter this character as the second positional parameter in this command, you
