Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
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 FILENAME ONLY String File name
FNAME
FULL FILENAME
FULLFNAME
FULLY QUALIFIED FILENAME
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
FMTSTATUSCHANGETIME status 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
Back to Main Index