Guardian Procedure Calls Reference Manual

maximum-extents
input
INT:value
is the maximum number of extents to be allocated for the file. The minimum and default value
is 16. See Considerations for the upper limit on this value.
unstructured-buffer-size
input
INT:value
declares the internal buffer size to be used for an unstructured file. Must be 512, 1024, 2048,
or 4096. The default is 4096 bytes.
open-defaults
input
INT:value
specifies the file label default values for various open attributes.
Verify writes off (default).0<0>
Verify write on.1
System automatically selects serial or parallel writes.0<1>
Serial mirror writes only.1
Buffered writes enabled (default for audited files).0<2>
Write-thru (default for nonaudited files).1
Audit compression off (default).0<3>
Audit compression on.1
Condition Code Settings
indicates that the CREATE failed (call FILEINFO or FILE_GETINFO_ ).< (CCL)
indicates that the file was created successfully.= (CCE)
indicates that the device is not a disk.> (CCG)
Considerations
• File pointer action
The end-of-file pointer is set to zero after the file is created.
• Disk allocation with CREATE
Execution of the CREATE procedure does not allocate any disk area; it only provides an entry
into the volume's directory, indicating that the file exists.
• CREATE failure
If the CREATE fails (that is, condition code other than CCE returns), the reason for the failure
can be determined by calling the FILEINFO or FILE_GETINFO_ procedure and passing -1 as
the filenum parameter.
• 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)
CREATE Procedure (Superseded by FILE_CREATELIST_ Procedure) 235