ANSI C, C++

#include <dcdami.h>
int dc_dam_create (char *fname, int blksize, int blknum,
                   int pnum, DCLONG flags)

K&R C

#include <dcdami.h>
int dc_dam_create (fname, blksize, blknum, pnum, flags)
char     *fname;
int      blksize;
int      blknum;
int      pnum;
DCLONG   flags;

The function dc_dam_create() allocates a physical file to the OpenTP1 file system.

The size of a physical file is (block length + 8) x (number of blocks + 1).

Calling the function dc_dam_iopen() is unnecessary after the function dc_dam_create() is called.

The following functions cannot be called after the function dc_dam_create() is called:

• dc_dam_get()
• dc_dam_bseek()
• dc_dam_dget()
• dc_dam_dput()

The size of an output buffer is (block length + 8) x (number of blocks collectively processed).

fname

Specify the name of a physical file to be created in the OpenTP1 file system, with a path name. The path name must be within (special file name + 14) bytes.

blksize

Specify the length of a physical file block.

blknum

Specify the number of physical file blocks.

pnum

Specify the number of blocks collectively processed which is used as an input/output unit.

flags

Specify the access permissions of the owner, the owner group, and another UAP. The access permissions must be specified with the values shown below or the bit strings shown in parentheses.

DCDAM_READ_OWNER (00400): The read permission of the owner is specified.

DCDAM_WRITE_OWNER (00200): The write permission of the owner is specified.

DCDAM_READ_GROUP (00040): The read permission of the group owner is specified.

DCDAM_WRITE_GROUP (00020): The write permission of the group owner is specified.

DCDAM_READ_OTHERS (00004): The read permission of another UAP is specified.

DCDAM_WRITE_OTHERS (00002): The write permission of another UAP is specified.

The following values are assumed when DCNOFLAGS is specified:

DCDAM_READ_OWNER (00400)

DCDAM_WRITE_OWNER (00200)

DCDAM_READ_GROUP (00040)

DCDAM_READ_OTHERS (00004)