|
| |
Open a File
|
Input |
Output |
| AX |
CBh |
07h |
Zero
/ -Error Code |
AX |
| BX |
Event
Handle |
DOS
File Handle for this File |
BX |
| CX |
Receive
File Number |
|
|
CX |
| DX |
|
Queue |
|
|
DX |
Receive File Number: This file number specifies which file to open 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 - The Control File. The format of this file is
described earlier in this document.
1 - First received file. Corresponds to the first
file in the list of received filenames (file
transfer record 0).
2 - Second received file.
3 - Third received file.
n - nth received file.
Queue: 0 - Open Control File in Task Queue.
1 - Open Control File in Receive Queue or the
received data file specified in the CX register.
2 - Open Control File in Log Queue.
3 - Open group file in Task Queue (V1.2)
4 - Open group file in Log Queue (V1.2)
After you obtain an event handle (by either scanning a Queue using the Find
First Entry in the Queue (05H) and Find Next Entry in the Queue (06H)
functions or by creating a event using the Submit a Task (01H) function),
you can use the Open a File function (07H) to access the DOS file
corresponding to the event. For events in the Task and Log Queues, this
function opens the Control File for the event. For events in the Receive
Queue, this function opens either the Control File or one of the received
data files.
This function opens the desired file in read-only mode and returns an
ordinary DOS file handle. The application should use the normal DOS
function (3EH) to close that handle when it is finished with it.
See Also 08h 09h 14h Error Codes |