character array (optional)
Returns the actual designator of the file being referenced
in the following format:
filename.groupname.accountname
The formaldesignator array must
be at least 28 bytes in length. When the actual designator
is returned, unused bytes in the array are filled with blanks on
the right. A nameless file returns an empty string. Note that all
character arrays must start on a halfword boundary.
The fully qualified name of the file referenced by filenum
is returned as the value of this parameter. Only names which can
be expressed using MPE only semantics are returned. If the name
of the object referenced by filenum cannot
be expressed using MPE name semantics, a CCL condition code is returned.
Calling FCHECK after this error will result in an error.
16-bit unsigned integer by reference (optional)
Returns information about the foption
characteristics that are set through the FOPEN or HPFOPEN call.
The bit settings that designate each of these characteristics are
listed below. Note that not all of the foptions
are meaningful for files on asynchronous devices.
Bits (14:2) —Domain foption.
Domain is meaningless for asynchronous devicefiles. However,
if file redirection was anticipated at the time the file was opened,
these bits may have been set.
- =00
The file is a new file.
- =01
The file is an old permanent file.
- =10
The file is an old temporary file.
- =11
The file is an old file.
Bit (13:1)—ASCII/binary foption.
Note that all files not on disk are treated as ASCII.
Bit (10:3)—Default file designator foption.
- =000
The actual and formal file designators are the same.
- =001
The actual file designator is $STDLIST.
- =010
The actual file designator is $NEWPASS.
- =011
The actual file designator is $OLDPASS.
- =100
The actual file designator is $STDIN.
- =101
The actual file designator is $STDINX.
- =110
The actual file designator is $NULL.
Bits (8:2)—Record format foption.
These bits are not meaningful for asynchronous devices since
all records are of undefined length. However, if redirection was
anticipated, "fixed-length" may have been specified.
- =00
Fixed-length records.
- =01
Variable-length records.
- =10
Undefined-length records.
- =11
Spoolfile.
Bit (7:1)—Carriage control foption.
- =0
No carriage control character expected.
- =1
Carriage Control character expected.
Bit (6:1)—MPE/iX tape label foption.
Not meaningful for asynchronous devices, but may have been
set if file redirection was anticipated.
- =0
Nonlabeled tape.
- =1
Labeled tape.
Bits (5:1)—Disallow :FILE equation
foption.
If this bit is set to 1, any :FILE equation
intended to override the specifications set through the FOPEN or
HPFOPEN call will be ignored.
- =0
Allow :FILE command
- =1
Disallow :FILE command.
Bits (2:3)—File type foption.
Will be set to 000 for asynchronous
devicefiles.
- =000
Standard file (STD).
- =001
Keyed Sequential Access Method file (KSAM).
- =010
Relative I/O file (RIO).
- =100
Circular file (CIR).
- =110
Message file (MSG).
Bits (0:2)—Reserved for MPE/iX. These should be set
to 0.