Measure Reference Manual

FILE^OPEN^DESC
is the descriptor for DISCOPEN or FILE entities and provides fields for describing EDIT files, object
files, and temporary files. Separate descriptors are used to specify OSS file pathnames and ANSI
SQL names:
• To specify OSS file pathnames for the DISCOPEN and FILE entities, use the template
FILE^OPEN^OSS^DESC (page 469).
• To specify ANSI SQL names for the DISCOPEN and FILE entities, use the template
FILE^OPEN^ANSI^DESC (page 471).
In addition, two other descriptors are used by the FILE entity to provide fields for describing the
process owning the open and the opener process (its process name and program file):
FILE^OPEN^DESC^D10 (page 469) and FILE^OPEN^OSS^DESC^D10 (page 470).
Theses separate entity descriptor formats are also all distinguished by their length.
Number of BytesEntity Descriptor
46FILE^OPEN^DESC
76FILE^OPEN^OSS^DESC
80FILE^OPEN^DESC^D10
110 or 140FILE^OPEN^OSS^DESC^D10
164FILE^OPEN^ANSI^DESC
Struct File^open^desc (*);
Begin
Int Type; ! Entity type
Int Len; ! Byte length of this record
Int Opener^CPU; ! Opener's CPU
Int Opener^PIN; ! Opener's PIN
Int File^number; ! File ACB number
Int OCB^number = File^number; ! Discopen OCB
Int File^name[0:11]; ! File name being opened
Int DP^CPU; ! Disc process' cpu number (primary or backup)
Int File^open^type = DP^CPU; ! Type of file open
Int System^number; ! Of remote file or remote opener.
Int System^name[0:3] ! Of remote file or remote opener; Set
! to all blanks for local system files
! or openers
End;
type
INT:value:1
is one of:
Numeric IdentifierLiteralEntity Type
5FILEOP^TFILE
6DFILEOP^TDISCOPEN
A positive type value includes the specified entities in the measurement configuration. A
negative type value excludes the specified entities from measurement. For an example, see
Specifying Entity Descriptors (page 376).
len
INT:value:1
is the length in bytes of this descriptor. len is 46.
FILE^OPEN^DESC 467