Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 113
KSAM Intrinsics
FLABELINFO
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 9-5. FLABELINFO Itemnum/Item Values
Itemnum Mnemonic 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 file
referenced 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.
6 U16 File creation date: The date in CALENDAR intrinsic format. Either
creator (C) or manager (AM if file is within account, otherwise SM)
access required.
Zero is returned as the creation date for root directories, MPE accounts,
and MPE groups created prior to release 4.5.