Measure Reference Manual

You can use an asterisk as a wildcard to replace an element of the file name. For example:
• $SR8.QUAL.* refers to all files in the subvolume QUAL on the volume $SR8.
• $*.QUAL.STATUS refers to files named STATUS in subvolume QUAL on any volume.
• $SR8.*.* refers to all subvolumes and all files on volume $SR8.
• $*.*.* refers to all files in all subvolumes on all volumes.
You cannot use an asterisk to represent only part of a file-name element. For example, it would be
invalid to specify $SR* as the volume name.
MEASCOM uses the file-system procedures to parse file names. You can also use logical DEFINE
and device names in place of file names. For example, to configure measurement of a FILE entity
whose name is defined by =_myfile:
1+ ADD FILE =_myfile
To configure measurement for the DISC volume corresponding to LDEV 14:
2+ ADD DISC $14
If the file system cannot convert the logical file name to a physical file name, or if the physical
name does not correspond to the specified entity type, an error is returned.
NOTE: Logical device numbers are specific to a given system. If a data file is moved from one
system to another, any existing logical device number for that file becomes invalid.
On systems running G-series and later RVUs, logical device numbers are determined dynamically
at system startup. Therefore, the logical number for a given device is likely to change as other
devices are added to or deleted from the system. For this reason, do not use logical device numbers
in command (OBEY) files or other noninteractive files on systems running G-series and later RVUs.
Abbreviations in Commands
When you enter MEASCOM commands interactively at the + prompt, you can abbreviate the
keywords for commands, objects, attributes, and counter names. For example, instead of entering
STATUS MEASUREMENT, you can enter STAT MEASU.
• MEASCOM matches abbreviations word by word and gives priority to exact matches. For
example, LIST is always recognized as the LIST command, not as an abbreviation of LISTALL.
• MEASCOM recognizes DISK as an alternate spelling for the keyword DISC, so you cannot
use DISK as an abbreviation for DISKFILE.
• For commands, objects, and attributes, MEASCOM compares each abbreviation against all
other commands, objects, and attributes. Each abbreviation you use must be unique. For
example, RE is not accepted as an abbreviation for the RESET command because it also
matches the REPORT object.
• For counter names, MEASCOM compares abbreviations only against other counter names
for the specified entity type. For example, the DISC entity has counters named REQUEST-QTIME
and REQUEST-QLEN-MAX. You could abbreviate these names as REQUEST-QT and
REQUEST-QL. Hyphens are treated as part of the name, not as spaces. You cannot abbreviate
REQUEST-QTIME as REQ-QT.
• As new keywords are added to MEASCOM, you might need to modify the abbreviations you
use.
• You cannot use abbreviations in noninteractive command entry (that is, when you execute a
MEASCOM command from the TACL prompt).
38 MEASCOM Commands