Accessing Files Programmer's Guide (32650-90885)

44 Chapter2
Creating A File
The HPFOPEN Intrinsic
Reference Manual.) This option allows the specification of options available
in the FILE command.
The
formaldesig
parameter and
filereference
parameter can contain
embedded command interpreter variables and expressions. However, there
cannot be more than 8-characters in each of these components (
filename,
lockword, groupname, accountname
) including the command
interpreter variable and expression characters.
Default: No string passed
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:
%fileequation%
(% is the delimiter,
fileequation
is the
designator)
fabcxyzf
(
f
is the delimiter,
abcxyz
is the designator)
The
formaldesignator
in the file equation string must belong to the MPE
name space. The
filerefence
in the file equation string is interpreted
using MPE-escaped semantics. Both the
formaldesignator
and the
filereference
in the file equation string may also contain embedded
command interpreter variables or expressions.
53/I32 ASCII/binary:
Passes a value indicating whether ASCII or binary code is to be used for a
new file when it is written to a device that supports both codes. For disk
files, this affects padding that can occur when issuing a direct-write
intrinsic call (FWRITEDIR) to a record that lies beyond the current logical
end-of-file indicator. By default, magnetic tape and files are treated as
ASCII files. This option is applicable only at file creation.
The following values are valid:
0 Binary file
1 ASCII file
Default: 0
(ASC) Not used for asynchronous devices.
54/REC KSAM parm:
Passes a record that defines the keys for a new KSAM file.
(KSAM XL and KSAM64) For KSAM XL and KSAM64 files, refer to the
parm
parameter discussion in the Using KSAM XL.
(KSAM/3000) The record must be at least 34 bytes in size. For details,
refer to the
ksamparam
parameter discussion in the KSAM/3000 Reference
Manual.
Default: No record passed