User`s guide

If the Make function is successful, it activates the referenced FCB for file opera-
tions by opening the FCB, and initializes both the directory entry and the referenced
FCB to an empty file. It also initializes all file attributes to zero. In addition, Function
22 makes a Creation date and time stamp for the file if the following conditions are
satisfied: the referenced drive has a directory label that requests Creation date and
time stamping and the FCB extent number field is equal to zero. Function 22 also
makes an Update stamp if the directory label requests update stamping and the FCB
extent field is equal to zero.
If the referenced drive contains a directory label that enables password protection,
and if interface attribute f6' has been set to 1, the Make function creates an XFCB
for the file. In addition, Function 22 also assigns the password, and password mode
placed in the first nine bytes of the DMA, to the XFCB.
Upon return, the Make function returns a directory code in register A with the
value 0 if the make operation is successful, or OFFH, 25S decimal, if no directory
space is available. Register H is set to zero in both of these cases. If a physical or
extended error is encountered, the Make function performs different actions depend-
ing on the BDOS error mode (see Function 45). If the BDOS error mode is the
default mode, a message identifying the error is displayed at the console, and the
calling program is terminated. Otherwise, the Make function returns to the calling
program with register A set to OFFH, and register H set to one of the following
physical or extended error codes:
01 : Disk I/O error
02 : Read-Only disk
04 : Invalid drive error
08 : File already exists
09 : ? in filename or filetype field
3-35
BDOS Function Calls CP/M 3 Programmers Guide