start_io_job

Starts the execution of the initial task in an I/O job. The task was not started when the I/O job was created.

Syntax, PL/M and C

CALL rq$start$io$job (io_job, except_ptr);

rq_start_io_job (io_job, except_ptr);

Parameter PL/M Data Type C Data Type
io_job SELECTOR SELECTOR
except_ptr POINTER to WORD_16 UINT_16 far *

Parameters

io_job
A token for the I/O job to be started. This is the same token that was returned to create_io_job.

except_ptr
A pointer to a variable declared by the application where the call returns a condition code.

Additional Information

When you call create_io_job, use the task_flags parameter to specify that the task in the new job not run until start_io_job is issued. Then initialize any items that need to be set before the initial task runs. For example, you can create a job, catalog a logical name in the new job's object directory, and then issue start_io_job.

Condition Codes

E_OK 0000H No exceptional conditions occurred.
E_NOT_CONFIGURED 0008H This system call is not part of the present configuration.
E_TIME 0001H The job cannot be started yet, probably because the OS has not finished processing create_io_job.