FINFO


Syntax:     FINFO(filename, option)

Defn: A CI evaluator function that returns information about
the specified file.

Type: String, integer, or Boolean depending upon option.

Example: FINFO('x.pub',"EXISTS")
Result: TRUE
Example: FINFO('jeff',"eof")
Result: 71495

The following table summarizes the options of the FINFO function.
The description includes the option number, one or more aliases,
the data type, and a brief description of the option.

Num Alias Data Type Option Description
--- ----- --------- ------------------

0 EXIST Boolean Existence of file

1 FULLFNAME String MPE syntax qualified
FULL FILENAME file name
FULLY QUALIFIED FILENAME

-1 FNAME String MPE syntax base file
FILENAME ONLY name

2 GROUP String Group name
GROUPNAME

3 ACCOUNT String Account name
ACCT
ACCOUNTNAME

4 CREATOR String File creator name

5 FMTSECURITY String Security matrix for
FORMATTED SECURITY MATRIX access

-5 SECURITY MATRIX Integer Security matrix for
INTSECURITY access

6 CREATED String File creation date
CREATION DATE
FMTCREATED

-6 CREATION DATE INTEGER Integer File creation date
INTCREATED

7 ACCESSED String Last access date
FMTACCESSED
LAST ACCESS DATE

-7 LAST ACCESS DATE INTEGER Integer Last access date
INTACCESSED

8 MODIFIED String Last modification date
LAST MOD DATE
FMTMODDATE

-8 LAST MOD DATE INTEGER Integer Last modification date
INTMODDATE

9 FILE CODE MNEMONIC String File code of disk file
FMTFCODE
FILE CODE

-9 FCODE Integer File code of disk file
INTFCODE

10 USER LABELS WRITTEN Integer Number of user labels

11 USER LABELS AVAIL Integer Number of user labels
available

12 FILE LIMIT Integer Total number of logical
LIMIT records possible in the
file

13 FORMATTED FOPTIONS String File options
FMTFOPT

-13 FOPTIONS Integer File options
INTFOPT

14 RECORD SIZE Integer Record size
RECSIZE

15 BLOCK SIZE Integer Block size
BLKSIZE

16 MAX EXTENTS Integer Maximum number of
MAXEXT extents

17 LAST EXTENT SIZE Integer Last extent size
LASTEXTSIZE

18 EXTENT SIZE Integer Extent size
EXTSIZE

19 END OF FILE Integer Number of logical
EOF records in file

20 ALLOC TIME String File allocation time
FMTALLOCTIME

-20 ALLOC TIME INTEGER Integer File allocation time
INTALLOCTIME

21 ALLOC DATE String File allocation date
FMTALLOCDATE
ALLOCATED

-21 ALLOC DATE INTEGER Integer File allocation date
INTALLOCDATE

22 NUM OPEN CLOSE RECS Integer Number of open/close
records

23 DEVICE NAME String Device name (8 bytes)
DEV NAME

24 FMTMODTIME String Last modification time
LAST MOD TIME

-24 INTMODTIME Integer Last modification time
LAST MOD TIME

25 FIRST USER LABEL String First user label
(user label 0)

27 UNIQUE FILE ID String Unique file identifier
UFID (UFID)

28 BYTE FILE SIZE Integer Total number of bytes
BYTEFILESIZE allowed in file

29 BYTE DATA OFFSET Integer Start of file offset
DATASTART

30 BYTE RECORD SIZE Integer Record size (indicates
BYTERECSIZE bytes)

31 BYTE BLOCK SIZE Integer Block size (indicates
BYTEBLKSIZE bytes)

32 BYTE EXTENT SIZE Integer Extent size (indicates
BYTEEXTSIZE bytes)

33 LOCKWORD String File lockword

34 VOLUME RESTRICTION String Volume restriction
VOLRESTR

35 VOLUME SET NAME String Volume set names

36 LOGSET ID String Transaction management
LOG SET ID log set identification

37 LDEV Integer Logical device number
LOGICAL DEVICE NUMBER

38 POSIX FULL FILE NAME String Terminated HFS-syntax
POSIXFULLFNAME absolute pathname

39 NUM HARD LINKS Integer The current number of
NUMHARDLINKS hard links to the file

40 ACCESS TIME String Time of last file
FMTACCESSTIME access (clock format)
LAST ACCESS TIME

-40 LAST ACCESS TIME INTEGER Integer Time of last access
INTACCESSTIME (clock format)

41 STATUS CHANGE TIME String Time of last file status
FMTSTATUSCHANGETIME change (clock format)

-41 INTSTATUSCHANGETIME Integer Change Time Integer
CHANGE TIME INTEGER

42 STATUS CHANGE DATE String Date of the last file
FMTSTATUSCHANGEDATE status change
(calendar format)

-42 CHANGE DATE INTEGER Integer Date of last file
INTSTATUSCHANGEDATE access status change
(calendar format)

43 FILE OWNER NAME String File owner
OWNER

44 FILE OWNER ID Integer File owner identifier
UID

45 FILE GROUP NAME String File group
FILEGROUP

46 FILE GROUP ID Integer File group identifier
GID

47 FILE TYPE String File type
FILETYPE

-47 FILE TYPE INTEGER Integer File type
INTFILETYPE

48 RECORD TYPE Integer Record type
RECTYPE

49 BYTE FILE SIZE Integer Current file size
BYTEFILESIZE (in bytes)

50 KSAM VERSION Integer KSAM XL file version
KSAMVERS

51 KSAM LABEL String KSAM XL parameters
KSAMPARAM

52 DEVICE TYPE String MPE/iX device type
DEVTYPE

-52 DEVICE TYPE INTEGER Integer MPE/iX device type
INTDEVTYPE

53 RELEASED Boolean Secured/Released

56 COMPRESSED Boolean Compressed/un-compressed
(HSM)

57 MIGRATED Boolean Migrated/not migrated (HSM)

58 SECTORS Integer Number of sectors in file
NUM SECTORS

59 EXTENTS Integer Number of extends in file
NUM EXTENTS

60 CREATETIME String File creation time, HH:MM
FMTCREATETIME

-60 INTCREATETIME Integer File creation time, HHMMSS
CREATION TIME INTEGER

61 ACCESSORS Integer Number of accessors of file
NUM ACCESSORS