Guardian Procedure Calls Reference Manual

FILE_CREATE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Safeguard Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The FILE_CREATE_ procedure is used to define a new structured or unstructured disk file. The file
can be temporary (and therefore automatically deleted when closed) or permanent. When a
temporary file is created, FILE_CREATE_ returns the file name in a form suitable for passing to the
FILE_OPEN_ procedure.
Some file characteristics, such as alternate keys and partition information, cannot be specified
through this procedure; you must use the FILE_CREATELIST_ procedure to specify them.
Syntax for C Programmers
#include <cextdecs(FILE_CREATE_)>
short FILE_CREATE_ ( char *filename
,short maxlen
,short *filenamelen
,[ short file-code ]
,[ short primary-extent-size ]
,[ short secondary-extent-size ]
,[ short maximum-extents ]
,[ short file-type ]
,[ short options ]
,[ short recordlen ]
,[ unsigned short blocklen ]
,[ short keylen ]
,[ short key-offset ] );
NOTE: In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the CEXTDECS file uses the
unsigned short data type for blocklen. (For a list of the required H06.28/J06.17 SPRs, see
SPR Requirements for Increased Enscribe Limits for the H06.28/J06.17 Release (page 31).) In
earlier RVUs, CEXTDECS uses the short data type for blocklen.
FILE_CREATE_ Procedure 385