MPE/iX Intrinsics Reference Manual (32650-90875)

166 Chapter5
Command Definitions (FCONTROL - FLOCK)
FFILEINFO
FFILEINFO
NM and CM callable.
Returns information about a file.
Syntax
I16V I16V *
FFILEINFO(
filenum [, itemnum,item ] [...]);
NOTE Up to five itemnum/item pairs can be specified.
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file for which information is requested.
itemnum 16-bit signed integer by value (optional)
Specifies which
item value is to be returned. (Refer to Table 5-2. on
page 166.)
item type varies (optional)
Returns the value of the item specified in the corresponding
itemnum .
(Refer to Table 5-2. on page 166.)
Table 5-2. FFILEINFO Itemnum/Item Values
Itemnu
m
Item
Type
Item Description
1 CA File designator (28 bytes):
Returns the file designator of the file being referenced in the format:
filename.groupname.accountname Must be >=28 bytes in length. Unused
bytes are filled with right-justified blanks and a nameless file returns an empty
string. The fully qualified name of the file referenced by filenum is returned as
the value of this itemnum . Only names which can be expressed using MPE-only
semantics are returned by this itemnum . If the name of the object referenced by
filenum can not be expressed using MPE-name semanticsa CCL condition code
is returned. Calling FCHECK for filenum after this error occurs will return
FSERR391.