| |
Submit a Task
Input |
Output |
AX |
CBh |
01h |
+Event
Handle / -Error Code |
AX |
BX |
|
|
|
|
BX |
CX |
|
|
|
|
CX |
DS:DX |
Pointer
to ASCIIZ Control File |
|
|
DX |
The Submit a Task function (01H) schedules a send, a polled send, a polled
receive, a group send, or a group polled receive event. Before invoking
this function, you must first create a Control File for the event (and a
group file if the event is a group send or group polled receive event).
The function adds this Control File to the Task Queue. The event handle
returned by this function is a positive integer that must be used in all
subsequent references to this event.
Once the event is completed, the Resident Manager automatically moves the
Control File for the event from the Task Queue to the Log Queue (that is,
copies the Control File from the Task Queue to the Log Queue, renames the
copy, and deletes the original Control File from the Task Queue). For
Polled Receive events, a copy of the Control File is also placed in the
Receive Queue. (The following information is new for V1.2.) For group
events, the parent Control File and the Group File are moved to the Log
Queue when the task is complete.
Note: Files associated with a event must remain in existence until the
event is complete or an error results.
See Also 15h 02h 0Ah 0Bh 0Ch 0Dh 10h 11h Error Codes |