This command generates displays of raw data using daily and historical data.
ADVISE COLLECT REPORT DUMP_report_keyword[,. . .]
Use the ADVISE COLLECT REPORT command to produce Performance Agent dump reports. The Performance Agent can generate dump reports using either daily or historical data. Dump reports consist of data extracted from the CA database files for a specified time period. You can specify more than one dump report within the same command line.
For a sample of each dump report, see the chapter “Dump Reports”. The following is a keyword list for the types of dump reports available:
DUMP_ALL DUMP_COMMUNICATIONS DUMP_CONFIGURATION DUMP_CPUS DUMP_DATACELLS DUMP_DISKS DUMP_HOTFILES DUMP_METRICS DUMP_PARAMETERS DUMP_PROCESSES DUMP_RULES DUMP_TAPES
You can request different types of dump reports in one command.
Specifies the beginning date and time of a reporting period. The date and time format is the standard DCL format, either absolute or relative. If you do not specify the /BEGINNING qualifier, Performance Agent uses 00:00:00 on the same day for which the ending date and time is specified. If you do not specify an /ENDING qualifier, Performance Agent uses 00:00:00 of the current day as the default beginning time.
Specifies the name of the collection definition, and therefore, the set of data to be used for the report. If you omit this, the report uses the CPD collection definition.
This qualifier is exclusive with the /HISTORY_DESCRIPTOR qualifier.
To view the Collection Definitions available, use the DCL command ADVISE COLLECT SHOW ALL.
Used with the /HISTORY_DESCRIPTOR qualifier to specify which user group family to include in the dump report. The specified family must be saved in the history data. For more information, see the Parameter Editor ADD/HISTORY command.
Specifies the dates and times to be covered by the report from the file you have created. When you create this file, enter dates in the format using one line per day:
DD-MMM-YYYY HH:MM:SS, DD-MMM-YYYY HH:MM:SS
Use the .txt extension when you name the file.
Specifies the ending date and time of a reporting period. The date and time format is the standard DCL format, either absolute or relative. If you do not specify an /ENDING qualifier, Performance Agent defaults to 23:59:59 on the same day for which you specified the beginning date and time or to the current time if the reporting period is for the current day.
Enables you to select processes or disks for dump reports. The strings specified with this qualifier are case sensitive.
|
Keyword |
Meaning |
|---|---|
|
USERNAME=(string[,. . .]) |
With the DUMP_PROCESSES report, generates a report on all processes matching the string. |
|
IMAGENAME=(string[,. . .]) |
With the DUMP_PROCESSES report, generates a report on all images matching the string. Do not specify the device, directory, file extension (exe), or version number. |
|
PROCESSNAME=(string[,. . .]) |
With the DUMP_PROCESSES report, generates a report on all process records matching the string. |
|
UIC=(uic[,. . .]) |
With the DUMP_PROCESSES report, generates a report on all process records with the UIC matching the string. You can use an asterisk (*) in either the group or user field of the specified UIC to include all match variations. |
|
PID=(pid[,. . .]) |
With the DUMP_PROCESSES report, generates a report on all process records matching the specified PID. |
|
VOLUMENAME=(string[,. . .]) |
With the DUMP_DISK report, generates a report on all entries for all disk records with the volume name matching the string. Do not specify any trailing colons. |
|
DEVICENAME=(string[,. . .]) |
With the DUMP_DISK report, generates a report on all entries for all disk records with the device name matching the string. Do not specify any trailing colons. |
Allows you to select history data from the CA database. By default, Performance Agent uses daily data files to supply data for reporting. However, by specifying the name of a history file descriptor, you can select historical data instead.
The history file descriptor must be defined in the parameters file.
Generates a dump report for a specific node or set of nodes. If you do not specify a value for the /NODE_NAMES qualifier, Performance Agent uses the list of nodes specified in the collection definition.
Writes requested reports to the specified file name. If you do not specify the /OUTPUT qualifier, Performance Agent writes the report to the device defined by the logical SYS$OUTPUT. The default file type is .LIS.
Only available when the Performance Manager is also installed, the /RULES qualifier loads information from the rules file to establish user-defined hardware scaling factors. The file-spec must point to an auxiliary knowledge base which has previously been compiled with the ADVISE PERFORMANCE COMPILE command. The default file type is .KB. If the NORULES qualifier is specified no augmentation of the factory rules occur.
Specifies that a subset of CA data is to be used (or not used) to generate dump reports. By default, Performance Agent selects all data between the /BEGINNING time and the /ENDING time.
Set as SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, EVERYDAY, WEEKDAYS, or WEEKENDS.
Is specified as m-n, where m and n are numbers from 0 to 24, and m is less than n. More than one hour range can be specified for a given day. Hour-range is mutually exclusive with the NO option.
If you omit a day keyword, the data for that day is selected. You can prevent data selection for individual days of the week by negating the keyword (for example, NOSUNDAY) or for all of the days of the week by specifying the NOEVERYDAY keyword. Similarly, you can use the values [NO]WEEKDAYS and [NO]WEEKENDS to enable or disable data selection for weekdays and weekends.
You must specify an hour range for any day keyword. Do not include an hour range if you are specifying a negated day keyword, such as NOMONDAY.
Less inclusive keyword values override more inclusive values. For example, MONDAY=10-12 overrides EVERYDAY=8-17 for Monday; however, the Performance Agent collects data from 8:00 a.m. to 5:00 p.m. for all of the other days of the week.
|
Copyright © 2008 CA.
All rights reserved.
|
|