Measure Reference Manual

FILE
The FILE entity measures the I/O operations performed by a user process on an explicitly opened
file (logical file access).
In Measure G09 and later PVUs, the FILE entity supports the use of OSS file pathnames in place
of Guardian file names. It also displays OSS file pathnames in FILE reports and provides direct
mapping between external structured records and OSSNAMES structured record output. OSS file
pathnames can be used to specify the name of the file being opened or the program file name of
the process opening the file.
In Measure G11 and later PVUs, the FILE entity displays ANSI SQL names in FILE reports.
In Measure H01 and later PVUs, MEASCOM accepts ANSI SQL names in FILE entity specifications.
PageTopic
227Measure and OSS file opens
228OSS naming conventions
230ANSI SQL naming conventions
230Entity specification syntax for FILE entities
233DDL records for FILE entities
235DDL field definitions for FILE entities
243Usage notes for FILE entities
244Command examples: OSS file opens
Measure and OSS File Opens
The FILE entity includes a number of FILE relationships available to OSS. OSS FILE open types
include:
DescriptionOSS File Type
OSS disk files with names in the OSS hierarchical name spaceOSS regular files
IPC mechanism for communication between processesOSS pipes
Named pipes, with names available in the OSS name spaceOSS FIFO
IPC mechanism using OSS AF_INET or OSS AF_UNIX socketsOSS sockets
The FILE entity does not record OSS opens of OSS directories, TTY devices, and /dev/null. For
details on the aggregate counters used for these objects, see PROCESS (page 291). OSS file
instrumentation is generally at the system call level rather than the library call level. Existing Guardian
TCP/IP sockets instrumentation is unchanged. Process file opens are recorded, but no socket level
information is available.
The two significant differences between the support of OSS file opens in the FILE entity and that of
Guardian file opens are:
• The timing of counter record creation
• Naming conventions used to identify OSS file open objects
FILE 227