Measure Reference Manual

Related Commands
PageFunctionCommand
86Displays an active measurementLISTACTIVE
109Specifies the report formatSET REPORT
Usage Notes for All PVUs and RVUs
• The FILE and PROCESS entities display the names of open files. A file can include resources
whose names do not conform to file name syntax, such as a process. To display reports for
these entities, specify the CPU, PIN, and file number of the resource rather than its file name.
For an example, see Examples (page 75).
• If you use the FROM, FOR, or TO clauses to specify a report window to view only a portion
of the measurement data, the LIST command generates the report:
◦ If the data was collected with no collection interval, only entities that started and stopped
within the specified report window are included in the report.
◦ If the data was collected with a collection interval, for each entity you specify, MEASCOM
reads the record written nearest to the beginning of the report window and the record
nearest to the end of the report window. MEASCOM then generates the report from the
differences between the two records. Both records must be within the report window or
within one collection interval of the start or end time of the window.
• You cannot generate a sorted report (BY item-name) if the report output file is a structured
file. The FORMAT option of the REPORT object determines the output format.
• The list options CR-NAME-LEN, CR-NAME-FORM, and CR-NAME-QUAL are valid for the
PROCESSH entity only.
• To obtain external records corresponding to a format that you can handle, see
TEMPLATE-VERSION (page 147).
Usage Notes for H-Series and J-Series PVUs and RVUs
• In H06.25/J06.14 and later RVUs, when generating a report for a data file that has been
split using the MEASFT SPLIT BY TIME command, you should specify FROM and TO options
(within the time period of the TIME-split data file) in the LIST entity-type command to ensure
fidelity between Measure reports done on the original data file with those done on the TIME-split
data file.
• In H06.23/J06.12 and later RVUs, the LIST DISC command for CLIM-attached disks supports
the partition number as an optional DISC specification parameter. The partition number is the
number assigned to a partition within a partitioned disk. Use of PARTITION to specify the
partition number in the IF and BY clauses is also supported.
In addition, the partition number for CLIM-attached disks is displayed by the LIST DISC command
if the partition number was specified for the measurement. See Examples.
• In Measure H04/J02 and later PVUs, the LIST command creates a format 1 or format 2
structured file, depending upon the measurement data file size, if the report output file is a
structured file.
74 MEASCOM Commands