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

112 Chapter9
KSAM Intrinsics
FLABELINFO
Bits Value/Meaning
0:11 Reserved for future use.
12:1 Symbolic Link Traversal
0
To traverse through symbolic links, if they exist.
1
Do not traversing through symbolic links, if they exist.
13:2 Caller Privilege Level Allows the caller to pretend to be
less privileged. The privilege level is passed in this field.
15:2 File Equations
0
Use file equations if they exist.
1
A file equation must be used.
2
Do not use a file equation.
fserrorcode 16-bit signed integer by reference (required)
Returns a value indicating whether an error or warning occurred when
FLABELINFO attempted to return requested information:
• A value of zero indicates that no errors were encountered.
• A positive value is a file system error code and indicates that an error
was encountered and no information was returned in
item .
• A -1 indicates that an item error or warning has occurred. Check the
itemerror parameter to determine which item(s) has an
error/warning and what it is.
itemnum 16-bit signed integer array (required)
Specifies which
item value is to be returned. (Refer to Table 9-5.)
To indicate the end of the list, place a zero in the element following the last
itemnum .
item record (required)
Returns the value of the item specified in the corresponding
itemnum .(Refer to Table 9-5.)
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.