Accessing Files Programmer's Guide (32650-90885)

36 Chapter2
Creating A File
The HPFOPEN Intrinsic
Default: No array passed (no sequence indicated)
A character placed in the first element designates the delimiter used by
HPFOPEN to search for the end of the character array. The delimiter can
appear again only following the last valid character of the character array,
for example,
%position% (% is the delimiter, position is the designator)
fabcxyzf ( f is the delimiter, abcxyz is the designator)
(ASC) Not used for asynchronous devices.
33/I32 User labels:
Passes the number, in the range 0..254, of user-label records to be created
for the file. Applicable for new disk files only.
Default: 0
This
itemnum may not be specified when creating hierarchical directories.
(ASC) Not used for asynchronous devices.
34I32 Spooler copies:
Passes a value in the range 1..127 indicating the number of copies of the
entire file to be produced by the spooling facility. This option is applicable
to spooled devices only. This option can be specified for a file already
opened (for example, $STDLIST), where the highest value supplied before
the last FCLOSE takes effect. The copies do not appear continuously if the
system operator intervenes or if a file of higher output priority becomes
READY before the last copy is complete. This option is ignored for
nonspooled output devices.
Default: 1
35/I32 File size:
Passes the maximum file capacity:
• For variable-length records, the capacity is expressed in blocks
(
blockitem#=recordsize * blockfactor ).
• For fixed-length and undefined-length records, the capacity is expressed
in logical records.
• The maximum file size for a standard byte stream file is 2 gigabytes
(2,147,483,648 bytes)
• The maximum file size for standard, fixed length record files and
KSAM64 files is 128 gigabyte (137,438,953,472 bytes
• The maximum file size for other standard and KSAM XL files is
4,294,901,759 bytes (4 gigabytes less 64K bytes).
• The maximum file size for a CM KSAM data file is 2 gigabytes and for a
CM KSAM key file, 2 gigabytes.
• The maximum file size of 500 megabytes, for RIO and circular is