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

Chapter 9 81
KSAM Intrinsics
FFILEINFO
FFILEINFO
Returns information about a file.
Syntax
I16V I16V *
FFILEINFO(
filenum [, itemnum,item ] [...]);
NOTE Up to five itemnum/item pairs can be specified.
Parameters
filenum 16-bit signed integer by value (required)
Passes the file number of the file for which information is requested.
itemnum 16-bit signed integer by value (optional)
Specifies which
item value is to be returned. (Refer to Table 9-2.)
item type varies (optional)
Returns the value of the item specified in the corresponding
itemnum .
(Refer to Table 9-2.)
Table 9-2. FFILEINFO Itemnum/Item Values
Item
num
Item
Type
Item Description
1 CA File designator (28 bytes): Returns the file designator of the file being referenced
in the format:
filename.groupname.accountname
Must be >=28 bytes in length. Unused bytes are filled with right-justified blanks
and a nameless file returns an empty string.
The fully qualified name of the file referenced by filenum is returned as the value
of this itemnum . Only names which can be expressed using MPE-only semantics
are returned by this itemnum . If the name of the object referenced by filenum can
not be expressed using MPE-name semantics a CCL condition code is returned.
Calling FCHECK for filenum after this error occurs will result in error.