MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 5 209
Command Definitions (FCONTROL - FLOCK)
FLABELINFO
(Refer to Table 5-6., “FLABELINFO Itemnum/Item Values,” on page 209.)
Itemnum/item s are paired such that the n th field of the item record
corresponds to the
n th element of the itemnum array.
itemerror 16-bit signed integer array (required)
Returns an error number corresponding to the items specified in the
itemnum array. The itemnum/item and itemerror parameters are paired
such that the
nth element of the itemerror array corresponds to the nth
element of the itemnum array.
If a value in the
itemerror array is negative, a warning exists for the
corresponding item. If the value is positive, an error was detected for the
corresponding item. The absolute value of each value is a file system error
number.
Table 5-6. FLABELINFO Itemnum/Item Values
Item
num
Mnem
onic
Item Description
1 CA File name (8 bytes):
The file name component for the file referenced in formaldesig is returned as
the value. If the file name is not expressible using MPE-only semantics, a file
system error code (391) is returned in the associated itemerror .
2 CA Group name (8 bytes):
The group name component for the filereferenced in formaldesig is returned as
the value. If the group name is not expressible using MPE-only semantics, a file
system error code (391) is returned in the associated itemerror .
3 CA Account name (8 bytes):
The account name component for the file referenced in formaldesig is returned
as the value. If the account name is not expressible using MPE-only semantics, a
file system error code (391) is returned in the associated itemerror .
4 CA File creator name (8 bytes):
An unqualified form of the file owner's name is returned as the value. The file
owner is not necessarily the file's creator.
A symbolic zero (ASCII 48 in decimal) is returned as the file owner for root
directories, MPE accounts, and MPE groups created prior to release 4.5.
If the file is not located in the account where the file owner is a member, a blank
file owner name is returned. Use itemnum =43 to obtain the full file owner name.
5 U32 Security matrix for access:
Returns the file's security matrix. This value does not indicate the actual
security enforced for a file, since group and account security masks can also
restrict access. This field is ignored if an ACD is active on a file.