MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 5 207
Command Definitions (FCONTROL - FLOCK)
FLABELINFO
FLABELINFO
NM and CM callable.
Returns information from the file label of a disk file.
Syntax
CA I16V I16
FLABELINFO(
formaldesig,mode,fserrorcode ,
I16A REC I16A
itemnum,item,itemerror );
Parameters
formaldesig character array (required)
Passes a formal file designator interpreted according to MPE-escaped
semantics. The file name must be terminated by a nonalphanumeric
character other than a period (.), a slash (/), a hyphen (-), and an
underscore (_). The file referred to by
formaldesig can be either an MPE
file (i.e., one that uses MPE syntax), or it can be an HFS syntax name
beginning with a dot or a slash.
If
formaldesig is an escaped pathname:
• you cannot reference remote files
• it cannot express a name equivalent to
filename : envid
• you cannot use the device parameter ( device = node #) to specify the
remote location of a device
If
formaldesig follows MPE syntax, the file name can include password,
group, and account specifications. The file name can backreference a file
equation and optionally be preceded by an asterisk.
The file referred to by
formaldesig may reside either in an MPE group or
in an HFS directory. For files located in HFS directories, traverse directory
entries (TD) access is required to all directories specified in
formaldesig .
If there is no TD access, FLABELINFO fails and a file system error code
(398) is returned in the
fserrorcode parameter.
If the file can be named using both MPE syntax and HFS syntax (for
example, FILEA.MYGROUP.MYACCT and /MYACCT/MYGROUP/FILEA), the file
can be either permanent or temporary. If a temporary and a permanent file
have the same name, FLABELINFO returns information about the
temporary file only.