Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-166
CREATE Procedure
(Superseded by FILE_CREATELIST_ Procedure )
•
Upper limit for maximum-extents
There is no guarantee that a file will be created successfully if you specify a value
greater than 500 for
maximum-extents.
In addition, CREATE returns error 21 if the values for
primary-extent-size,
secondary-extent-size, and maximum-extents yield a file size greater than
(2**32) - 4096 bytes (approximately four gigabytes), or a partition size greater than
2**31 bytes (two gigabytes).
•
Altering file security
The file is created with the caller’s process file security that can be examined and
set with the PROCESSFILESECURITY procedure. Once a file has been created,
its file security can be altered by opening the file and issuing the appropriate
SETMODE and SETMODENOWAIT functions.
•
Odd unstructured files
An odd unstructured file permits reading and writing of odd byte counts and
positioning to an odd byte address.
When creating unstructured files, the value passed for
file-type.<12>
determines how all subsequent reading, writing, and positioning operations to the
file work.
If
file-type.<12> is passed as 1 and file-type.<13:15> is all zeros, an odd
unstructured file is created.
If
file-type.<12> is passed as 1, the values of record-specifier, read-
count, and write-count are all interpreted exactly; for example, a write-
count or read-count of 7 transfers exactly 7 bytes.
•
Even unstructured files
If
file-type.<13:15> is passed to CREATE and is all zeros (specifying an
unstructured file), and
file-type.<12> is 0, then an even unstructured file is
created.
If
file-type.<12> is passed as 0, the values of read-count and write-
count are each rounded up to an even number before the operation begins; for
example, a
write-count or read-count of 7 is rounded up to 8, and 8 bytes
are transferred.
A file must be positioned to an even byte address; otherwise, FILEINFO or
FILE_GETINFO_ returns a file-system error (bad address).
If you use the FUP CREATE or the TACL CREATE command to create the file, it
creates an even unstructured file by default.