MPE/iX Intrinsics Reference Manual (32650-90875)

208 Chapter5
Command Definitions (FCONTROL - FLOCK)
FLABELINFO
mode 16-bit signed integer by value (required)
Passes an option specifying the valid backreferencing to file equations for
the file.
Bits Value/Meaning
0:11 Reserved for future use.
11:1 Symbolic Link Traversal
0
To traverse through symbolic links, if they exist.
1
Do not traversing through symbolic links, if they exist.
12:2 Caller Privilege Level
Allows the caller to pretend to be less privileged. The
privilege level is passed in this field.
14: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 5-6.,
“FLABELINFO Itemnum/Item Values,” on page 209.)
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 .