Before CA MAT begins monitoring a program, create a monitor definition that describes the target program and the observation criteria.
Follow these steps:
The Monitor Definition panel opens.
CA MAT --------------------------- Monitor Definition --------- Row 1 to 1 of 1 COMMAND ===> SCROLL ===> CSR Primary commands: ADD xxxx, STAtus Server ID: MATUNER Status: ACTIVE Line commands: S - Select A - Analyze Normal D - Delete I - Invoke AL - Analyze All DD - Delete w/dsns H - History AA - Analyze Active B - Batch Reports C - Copy AW - Analyze Wait V - CSV Reports X - Export Monitor Data J - Display Job Card LC Profile Status Schedule Runs Description Jobname Stepname| ________ __________ ________ ____ _________________________ ________ ________ >------------------------------------------------------------------------------- *********************************************************** End of Table *******
The list of commands available on the Monitor Definition panel are as follows:
Adds the monitor definition to the Monitor Definition panel.
Note: For more information, see Add a Monitor Definition.
Displays information about the progress of the observation and sampling process that is associated with all monitor requests.
Note: For more information, see Display Monitor Request Status.
Lets you select an existing monitor definition you want to edit.
Note: For more information, see Edit a Monitor Definition.
Starts a monitor from the TSO client using the existing monitoring criteria.
Note: For more information, see Invoke a Monitor from the TSO Client.
Displays the Monitor History panel, which lists information about each monitor session invoked for the monitor profile selected. From here, you might analyze the data that is gathered during any monitor session.
For more information, see Display Monitor History.
Lets you create multiple versions of the same monitor definition without having to retype all the monitoring criteria.
Note: For more information, see Copy a Monitor Definition.
Displays information that is not directly related to the target application is eliminated. Data is reported as follows:
The following samples are eliminated from analysis: Non-dispatched (.NONDISP), No CPU available (.DISPWT), Processor Delay (.PROCDLY), Page wait (.PAGEWT), Swapped (.SWAPWT), and No activity (.OTHERWT). These samples are considered for the overall OverView activity percentages and runtimes.
CodeView and related histograms are sorted based on Active percentages, not total percentages. The Visual field reflects the Active percent only. Wait samples are included. Percentages are calculated on total samples; all activity values have equal weight.
Allows you to compare delays occurring when the program is executing in both active and wait states.
Percentages are calculated based on all samples.
Allows you to analyze information and calculate the percentages based on samples where the program was actively using CPU. Samples that contain only wait information are filtered out, which allows you to make normalized CPU comparisons of program activity.
Allows you to analyze information and calculate percentages based on samples where the program was in a wait state. Samples that contain only active information are filtered out which allows you to make normalized comparisons of program wait activity.
Removes the monitor definition and the monitor’s history but does not delete the associated monitor data sets.
Note: For more information, see Delete a Monitor Definition.
Deletes the data sets that were created by monitoring sessions under that definition and then deletes the monitor definition
Note: For more information, see Delete a Monitor Definition.
Lets you generate batch reports any time after you invoke the monitor and data collection has been completed.
Note: For more information, see Submit a Job to Generate Batch Reports.
Accesses the CSV Reporting panel that allows you to submit a batch job to create comma-separated value output of analysis reports for the selected profile. These reports can be imported for use with the Spreadsheet Converter.
Note: For more information, see Create Spreadsheet Reports.
Displays the batch reports job card that is associated with the selected Monitor profile.
Creates an export file of the monitor data set suitable for electronic transmission. Use this command when sending monitor data to CA Technical Support.
The fields on the Monitor Definition panel are described next.
Defines the profile name that is specified when you created the monitor definition.
This field is also referred to as the Monitor Definition name.
Displays the status of the monitor request.
Status is refreshed each time you press Enter. Status contains one of the following values:
Indicates that the request has been submitted to CA MAT but the target is not active. CA MAT is waiting for an opportunity to begin monitoring the target application.
Indicates that theCA MAT is actively monitoring the indicated target. (Observations are being taken and samples are being collected.)
Indicates that the monitor definition is available, but the Server Space has not been requested to begin monitoring.
Indicates that the request is no longer tracked by the Server Space. Output data is available in the monitor data set.
Indicates that the request is no longer tracked by the Server Space. The output data set is not found.
Indicates that communications could not be established with the Server Space. The Server Space might need to be activated.
Displays the name of an associated schedule for the monitor to run.
Displays the number of monitor invocations after the definition was created.
This value is the number of data sets that are available in the Monitor History panel.
Displays the text describing the monitor definition.
Indicates whether a preset series of reports are created in batch mode after the monitor is complete.
Displays the name of the job to be monitored
Displays the name of the procedure step to be monitored if the job step uses a cataloged or in-stream procedure.
Displays the name of the job step to be monitored.
If no cataloged procedure is used, displays the step name on the EXEC statement that invoked the program. If a cataloged procedure is used, displays the name of the step that invoked the procedure.
Displays the name of the program on the JCL EXEC statement of the job to be monitored.
Indicates if the profile has multistep monitoring specified.
Indicates if the profile specifies that the entire job step is to be monitored.
Displays the date of the last monitor to be analyzed.
Displays the time of the last monitor to be analyzed.
Displays the data set name of the file to monitor for each profile.
This name generally contains variables. For a complete description, see Add a Monitor Definition.
Data set name of the monitor data set with variables substituted.
Specifies that the tasks identified by these names are included in the monitor.
No other tasks are monitored.
Specifies that the tasks identified by these names are excluded from the monitor.
All other tasks are monitored.
Displays the number of milliseconds between observations.
CA MAT calculates this number and adjusts it during the monitoring period.
Displays the number of observations requested.
Displays the amount of time in seconds that the job step is monitored.
Displays the delay in seconds for startup of the monitor request.
You might want to specify a delay to skip monitoring the initialization functions within the job step.
Displays the number of monitoring sessions to be started for a single execution of a job step.
When a monitor session reaches its target observation count, CA MAT closes the monitor data set, and continues monitoring with a new monitor data set. When a monitor data set is closed, it is available for analysis. This process is known as successive monitoring.
The number is specified on the Job Monitoring Criteria panel, which appears from the All Jobs field of the Monitoring Criteria panel.
To specify successive monitoring, enter a value equal to or greater than 1 in the following field:
Run up to 0 monitors per job step execution
Displays the number of times a monitor is run for a job step.
This field allows for multiple monitor runs for only one invocation.
The number is specified on the "Job Monitoring Criteria" panel (which appears from the All Jobs field of the Monitoring Criteria panel).
To specify recurrent monitoring, enter a value equal to or greater than 1 in the following field:
Monitor this job the next 0 times it runs
Displays the start of a time range during which the monitor request is valid.
If the job step to be monitored ends before the start time, the monitor does not start. If the job step is running at the start time, monitoring begins at that time.
Displays the end time of a time range during which the monitor request is. valid
If the job step to be monitored does not start before the end time, the monitor request is canceled.
Displays the name of the exit routine for monitoring non-DB2 databases.
Displays the name of the exit routine for monitoring 4GL languages.
Specifies the target systems in a sysplex where a job is monitored.
Blank specifies local system only. "*" specifies all systems in the sysplex.
Specifies that the transaction codes are to be monitored for IMS and CICS jobs only.
Specifies that the terminal IDs are to be monitored for IMS and CICS jobs only.
Specifies that the user IDs to be monitored for IMS and CICS jobs only.
Specifies that information about the DB2 access path selection is to be collected for DB2 SQL statements.
Specifies whether the plan or package statements are to be extracted from the DB2 catalog or directly extracted from the DB2 control blocks when monitoring a DB2 application.
Displays the type of transaction processing system, if any, that was monitored for IMS and CICS jobs only.
Specifies the name of an alternate DDNAME from which the monitored program loads other programs.
CA MAT requires the location of program load modules to obtain the information required to display CSECT offsets during analysis.
Specifies whether to enable PSW sampling when a WebSphere application server application is monitored.
Specify Y to enable this feature, N to disable it.
Disabling this feature reduces the amount of data collected. CA MAT analysis is limited to WebSphere data only.
Defines the TSO User ID of the creator of this monitor definition.
Defines the date on which this monitor definition was created.
Defines the time at which this monitor definition was created.
Defines the TSO User ID of the last person to change this monitor definition.
Defines the date on which this monitor definition was last changed.
Defines the time at which this monitor definition was last changed.
|
Copyright © 2012 CA Technologies.
All rights reserved.
|
|