User`s guide

BDOS FUNCTION 22: MAKE FILE
Entry Parameters:
Registers C: 16H
DE: FCB Address
Returned Value:
Registers A: Directory Code
H: Physical or Extended Error
The Make File function creates a new directory entry for a file under the current
user number. It also creates an XFCB for the file if the referenced drive has a direc-
tory label that enables password protection on the drive, and the calling program
assigns a password to the file.
The calling program passes the address of the FCB in register pair DE, with byte 0
of the FCB specifying the drive, bytes 1 through 11 specifying the filename and
filctype, and byte 12 set to the extent number. Usually, byte 12 is set to zero. Byte
32 of the FCB, the cr field, must be initialized to zero, before or after the Make call,
if the intent is to write sequentially from the beginning of the file.
Interface attribute f6' specifies whether a password is to be assigned to the created
file.
f6' = 0 - Do not assign password (default)
f6' = 1 - Assign password to created file
When attribute f6' is set to 1, the calling program must place the password in the
first 8 bytes of the current DMA buffer, and set byte 9 of the DMA buffer to the
password mode (see Function 102). Note that the Make function only interrogates
interface attribute f6' if passwords are activated on the referenced drive. In non-
banked systems, file passwords are not supported, and attribute f6' is never interrogated.
The Make function returns with an error if the referenced FCB names a file that
currently exists in the directory under the current user number.
3-34
BDOS Function Calls CP/M 3 Programmers Guide