Guardian Procedure Calls Reference Manual

FILE_CREATELIST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Item Codes
Considerations
OSS Considerations
Related Programming Manuals
Summary
The FILE_CREATELIST_ 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_CREATELIST_ returns the file name in a form suitable for passing to
the FILE_OPEN_ procedure.
FILE_CREATELIST_ allows you to specify certain file characteristics, such as alternate keys and
partition information, that cannot be specified through the FILE_CREATE_ procedure.
Syntax for C Programmers
#include <cextdecs(FILE_CREATELIST_)>
short FILE_CREATELIST_ ( char *filename
,short maxlen
,short *filenamelen
,short *item-list
,short number-of-items
,short *values
,unsigned short values-length
,[ short *error-item ] );
NOTE: In H06.28/J06.17 RVUs with specific SPRs and later RVUs, the CEXTDECS file uses the
unsigned short data type for values-length. (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 values-length.
Syntax for TAL Programmers
error := FILE_CREATELIST_ ( filename:maxlen ! i,o:i
,filenamelen ! i,o
,item-list ! i
,number-of-items ! i
,values ! i
,values-length ! i
,[ error-item ] ); ! o
392 Guardian Procedure Calls (F)