The FI (File Information) command reports information about open files that are owned by the specified tasks.
Syntax
Explanation
<mix number list> FI
The report displays information about each file being used by the programs specified in the mix number list. The information includes the kind of file (such as disk or printer), the type of I/O operations performed, the number of read and write operations and total transactions performed on the file, the I/O time used by the file, and the title of the file. This information is intended to help you estimate the amount of work a program has completed and how much longer it needs to run.
If the file being reported on is a foreign file (that is, the physical file resides at a remote host), the KIND attribute is not displayed and the file title is displayed as “Foreign File.”
<mix number list> FI −
Use the minus sign (−) modifier to display large values of I/O time and to display large values of read, write, and transaction counts. If the minus sign (−) modifier is omitted, the details for each file are shown on a single line.
<mix number list> FI VSS2
<mix number list> FI VSS3
Reports the following VSS-2 or VSS-3 migration information for each disk file:
-
Read-Modify-Write count
-
Write count
-
Read-Modify-Write to Write ratio
-
BLOCKSIZE attribute value
-
FILESTRUCTURE attribute value
-
FRAMESIZE attribute value
-
TITLE attribute value
The display is limited to disk files, and for each file displays only the items in the preceding list. The display does not include the other types of data items reported by the simple <mix number list> FI command.
| Note: | For any file that an application has opened at a remote host, the FI command displays only the file title and none of the other attributes. On the line below the file title, the display includes the message “Foreign file - cannot analyze file attributes.” |
For information about VSS disk formats, refer to the Peripherals Information File.
Examples
Example 1
This example shows a report for one mix number. If the number of reads, writes, or transactions is larger than 999,999, the number is displayed as “***.” If the time is larger than 999:59:59, the time is displayed as “***:**:**.”
9886 FI
4 files for mix 9886 Kind Use Reads Writes Trans Time File Title Pack I/O 3 7 10 0:00:00 *SYSTEM/COMS/MARC/COMMAN Pack I/O 0 0 0 0:00:00 *SYSTEM/COMS/MARC/COMMAN Pack Out 0 28 28 0:00:01 *TANKFILE/COMMANDER ON D Pack In 16 0 16 0:00:01 *SYSTEM/MARC/MENUGRAPH/E
| Note: | Because Reads, Writes and Time each refer to a count of physical operations, and Transaction (Trans) to a count of logical operations, the physical count does not necessarily equal the logical count. Unsuccessful operations such as end-of-file results are included with the logical count and thus contribute to the inequality between the logical and physical counts. |
Example 2
This example shows a report for one mix number with larger counts requested. If the minus sign (−) modifier is used, times up to 1,000,000 hours and transaction counts up to 10,000,000,000 can be displayed.
3154 FI -
2 files for mix 3154 Kind Use Reads Writes Trans Time Pack Out 9,863 887,674 8,876,748 2:00:25 (ADM)FI/EXAMPLE ON USER. Pack In 1,441,801 0 14,418,000 0:17:50 (ADM)FI/EXAMPLE ON USER.
Example 3
This example shows a report for one mix number, with VSS-2 information requested:
9886 FI VSS2
4 files for mix 9886
RMW Write Ratio File Frame Block File Title
Count Count Structure Size Size
0 100 0% ALIGNED180 48 720 FILE/1
File attributes support VSS-2 logical-physical alignment.
FAMILY PERIPH is made up of 180-byte and VSS-2 disks.
25 125 20% ALIGNED180 48 720 FILE/2
File opened for direct I/O - cannot analyze file attributes.
FAMILY USERS is made up of VSS-2 disks.
16 100 16% ALIGNED180 48 512 FILE/3
File attributes do not support VSS-2 logical-physical alignment.
FAMILY DISK is made up of VSS-2 disks.
FILE/4
Foreign file - cannot analyze file attributes.