Atari ST series Technical Reference Manual page 278

Fcreate()
Creates a new file, or if the specified file already exists, truncates it to
length 0. The file is opened, and a 16-bit handle is returned that can be
used for further access to the file, f w-
C macro format
char *fname;
int handle, attr;
handle = Fcreate(fname, attr);
Machine language format
move.w attr, - (sp)
move.l fname, - (sp)
move.w #$3C, - (sp)
#1
trap
addq.l
#8,sp
Inputs
attr word
Interpretation of
attr
Bit Number Bit Value
0 1
1 2
2 4
3 8
fname long
Results
D O handle
word
See also
Fopen()
270
Fcreate
Create File
A flag that specifies the file's attributes.
flag:
Description
Read-only file (can't be deleted or written to)
Hidden file (excluded from normal directory
searches)
System file (excluded from normal directory
searches)
Volume label (can only exist in root)
A pointer to a null-terminated ASCII
string containing the name of the file to
create.
If the function succeeds, a 16-bit handle value. If
not, a negative GEMDOS error number.
Opcode = 60 ($3C)