Delete a File                                 

Input

Output

AX CBh 08h  Zero / -Error Code AX
BX  Event Handle     BX
CX  Receive File Number     CX
DX   Queue     DX
  Receive File Number: This number specifies which file to delete among those
                       associated with a receive event.  This number applies
                       only to events in the Receive Queue and is ignored for
                       events in the Task and Log Queues.  The number is
                       interpreted as follows:

                       0 - Delete all files associated with the specified
                           Control File (including the Control File).
                       1 - Delete the first received file associated with
                           the event handle.
                       2 - Delete the second received file associated with
                           the event handle.
                       n - Delete the nth received file associated with
                           the event handle.

  Queue:               0 - Delete Control File in Task Queue and
                           corresponding Group File, if it exists.
                       1 - Delete a file or files associated with an event
                           in the Receive Queue.
                       2 - Delete Control File in Log Queue and
                           corresponding Group Log File if it exists.

  The Delete a File function (08H) deletes one or more files in a specific
  Queue.

  Note:     The delete files flag (offset 140) in the Control File
            for an event can cause the Resident Manager to automatically
            delete all the files associated with the event after the
            event has been successfully completed (flag set to 1) or
            after the event has been attempted (flag set to 2).

See Also 09h 14h Error Codes


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