Previous Topic: Display Monitor History

Next Topic: Analyze Monitor Results

Invoke a Monitor for an Active Job

CA Mainframe Application Tuner allows you to start or to view information about a monitor for any job, Started Task, or TSO user currently executing in the system. From the Primary Option Menu, select Option 2 to display the Active Jobs panel.

CA MAT ------------------------- Active Jobs ------------- Row 1 to 11 of 774 COMMAND ===> SCROLL ===> CSR Primary commands: STAtus Server ID: MATUNER Status: ACTIVE Line commands: M - Display Monitoring Criteria Local SYSID: SYSO I - Invoke Monitor S - Display Active Select Command Sysplex A/S Cur CPU EXCP LC Jobname Stepname Procstep SysName ASID Type Pos REAL Rate Rate SMFID ________ ________ ________ ________ _____ ____ ___ ____ _____ _____ _____ >------------------------------------------------------------------------------ __ *MASTER* SYSI 1 STC NS 1633 SYSI __ *MASTER* SYSM 1 STC NS 3210 SYSM __ *MASTER* SYSO 1 STC NS 5721 SYSO __ PCAUTH PCAUTH SYSI 2 STC NS 55 SYSI __ PCAUTH PCAUTH SYSM 2 STC NS 55 SYSM __ PCAUTH PCAUTH SYSO 2 STC NS 56 SYSO __ RASP RASP SYSI 3 STC NS 120 SYSI __ RASP RASP SYSM 3 STC NS 122 SYSM __ RASP RASP SYSO 3 STC NS 122 SYSO __ TRACE TRACE SYSI 4 STC NS 113 SYSI __ TRACE TRACE SYSM 4 STC NS 137 SYSM

The section Active Job Fields contains a description for each field in the Active Jobs panel. Fields marked with an asterisk (*) are excluded from view by default.

To display these fields, you must use the CUST primary command.

To monitor a job by using default monitoring criteria:

  1. Type I in the LC field next to the profile name of the job that you want to monitor.
  2. Press Enter.

To monitor a job by using criteria other than the defaults:

  1. Type M in the LC field next to the profile name of the monitor definition that you want to invoke.
  2. Press Enter.

    The Monitoring Criteria panel is displayed. The profile name will be the same as the job name.

  3. Change the monitoring criteria as needed
  4. Press End to save your changes, or type CANCEL on the COMMAND line and press Enter to return to the Active Jobs panel without starting a monitor.
  5. Type I in the LC field next to the profile name of the job
  6. Press Enter.

    After a monitor has been invoked for an active job, you can display its progress or cancel the request by using the STAtus primary command. For more information, see Display Monitor Request Status.

    If multiple active address spaces have the same job name, you must invoke the monitor from the Active Jobs panel to ensure that the correct address space is monitored.

Jobname

Job name of the address space.

Stepname

Job step name or TSO procedure name for TSO users.

Procstep

Procedure step name or terminal name for TSO users.

Sysplex SysName

One- to eight-character name that is associated with the currently running system within the sysplex.

ASID

Numeric identifier, between 1 and 32766, of the address space.

ASID (hex)

Hexadecimal identifier of the address space.

This number can be between x'0001' and x'FFFF'.

A/S Type

Type of address space:

Cur Pos

Current position of the job. Possible values are as follows:

Dsp Pri

Dispatching priority of the address space.

This value determines the ability of the address space to gain control of the CPU resource when competing with other jobs in the system.

REAL

The total amount of storage backed by central (real) storage that is currently in use by the address space.

CPU Rate

Percentage of CPU time that is used by the job.

The value is updated when you press Enter and indicates the CPU Rate since the last time you pressed Enter. The value is adjusted for multiple CPUs, if applicable.

Excp Rate

Number of SSCH instructions issued per second for the current transaction or job step.

CPU Time

Amount of processor time, including both TCB and SRB, that is used by the current job step.

TCB Time

Amount of TCB processor time in seconds that is used by the current job step.

SRB Time

Amount of SRB time in seconds that is used by the current job step.

Delta CPU Time

Number of CPU seconds that is used by the job.

The value is updated when you press Enter and indicates the number of CPU seconds that were used since the last time you pressed Enter. The value is adjusted for multiple CPUs, if applicable.

Delta TCB Time

Number of TCB seconds that were used by the job.

The value is updated when you press Enter and indicates the number of TCB seconds that were used since the last time you pressed Enter.

Delta SRB Time

Number of SRB seconds that were used by the job.

The value is updated when you press Enter and indicates the number of SRB seconds that were used since the last time you pressed Enter.

EXCP Count

Total number of EXCPs that were issued by the current job step.

Delta EXCP

Number of SSCH instructions that were issued by the job.

The value is updated when you press Enter and indicates the number of SSCH instructions that were issued since the last time you pressed Enter.

Scroll right to display the following fields:
SMFID

One- to four- character name assigned with the currently running system.

The SMFID is written as a field in any SMF record that is created by this system.

FF Bel

Number of fixed-storage frames below 16 megabytes that are held by the job.

If the data gathered for this value is not valid, this field is blank. Fixed storage refers to frames in central storage that cannot be paged-out. Fixed storage is used by programs that cannot tolerate a page fault.

X M

Cross memory address space.

This field contains an X for address spaces considered to be 'cross memory address spaces'. An X implies that the address space provides services that are used by other address spaces, and that the address space is accessed in cross memory mode. If the address space is not a cross memory address space, this field is blank.

Priv FF

Number of private fixed-storage frames that are held by the job.

If the data gathered for this value is not valid, this field is blank.

Prf Grp

One-to-four digit number of the performance group that is associated with the address space.

Performance groups are used to assign specific service objectives and execution priority to a group of address spaces.

Dmn

One-to-three digit number of the domain.

A domain is a collection of performance groups that is defined by a system administrator.

Lst Swp

Last swap out that is associated with the job.

If the current position of the job is NS, IN, or PR, this field is blank. Possible values are as follows:

Service Class

One-to-eight character name of the service class.

A service class is a group of work within a workload with similar performance goals and characteristics; for example, average response time. You can further divide a service class into performance periods. Periods assign different service objectives and execution priorities to a transaction within a service class, based on the transaction's resource consumption.

Service Period

Performance period of a service class.

Possible values range from 1 to 8, which specify varying performance goals and characteristics of transactions of a service class. While executing and consuming resources, transactions can move to a higher period.

Workload

One-to-eight character name of the workload that is assigned to the address space.

A workload is a group of work to be monitored, managed, and reported. It consists of one or more service classes.

Resource Group

One-to-eight character name of the resource group.

Assigning a service class to a resource group effectively guarantees a minimum capacity and sets a maximum capacity for the transactions belonging to the service class.