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


Copyright © 1985 to 2022 Beta Systems                            Last modified: Wednesday, January 05, 2022 .