Inspect Address Space CPU Use

These attributes provide the Inspect data for the active task control blocks (TCBs) within the selected address space. You cannot use these attributes to create situations.

ASID IN Used to pass the ID of the address space to be inspected to the agent.

CSECT Address Hexadecimal address of the control section (CSECT) in storage within the owning load module. If Inspect is unable to determine the CSECT name, the value of this field will be the same as the load module address.

CPU % of CSECT CPU percentage usage for this granular section of the control section (CSECT). If the name of the CSECT is unknown, this value will be the same as Load Module. Valid value is a number in the range 0.0 - 100.0.

CSECT CPU % of Job CPU usage for this control section (CSECT) as a percentage of the CPU usage for all task control blocks (TCBS) in the address space. This value will be the same as Load Module CPU % of Job if CSECT name is unknown, since in that case the CSECT is mapped to the entire load module. Valid value is an integer in the range 0.0 - 100.0. This value will be 100% if the CSECT name is unknown, since the CSECT is then mapped to the entire load module.

CSECT CPU % of Load Module CPU usage for this control section (CSECT) as a percentage of the CPU usage for the owning load module. This value will be 100% if the CSECT name is unknown, since the CSECT is then mapped to the entire load module. Valid value is a number in the range 0.0 - 100.0.

CSECT CPU % of TCB CPU usage for this control section (CSECT) as a percentage of the CPU usage for the owning task control block (TCB). This value will be the same as Load Module CPU % of TCB if the CSECT name is unknown, since in this case the CSECT is mapped to the entire load module.Valid value is a number in the range 0.0 - 100.0.

CSECT Name Name of the control section (CSECT) within the load module in which Inspect detected the execution. This column is blank if Inspect is unable to determine the load library that the module was loaded from. This may occur if the module was loaded from a link list library. Valid value is a string of up to 8 characters.

CSECT Offset in Load Module Offset of the control section in the load module. Valid value is a hexadecimal number in the range 0 - 7FFFFFFF.

Initial Program Name of the top level program that was attached to create this task control block (TCB). If the target address space is a CICS TS 1.3 or higher region, this field may contain the CICS transaction ID and task number instead. Valid value is a string of up to 8 characters.

Interval The time, in milliseconds, between samples taken by the Inspect agent. Valid value is an integer in the range 0-2147483647.

INTERVAL IN Used to specify the sampling interval to the agent. Valid value is an integer in the range 0-2147483647.

Jobname Used by the Inspect agent to check that the same job is still running in the target address space. Valid value is a string of up to 8 characters.

Load Module Address Address of the load module in the target address space. A value of *-CSA-* indicates that execution was in code resident in the common storage area; a value of *-ECSA-* indicates that execution was in code resident in the extended common storage area. A zero indicates that Inspect could not determine the load module name.

Load Module ASID Decimal Decimal ID of the address space when execution was seen to be in an address space other than the one being inspected.

Load Module ASID Hex Hexadecimal ID of the address space when execution was seen to be in an address space other than the one being inspected.

Load Module ASID Jobname Name of the job running within the address space when execution was seen to be in an address space other than the one being inspected. Valid value is a string of up to 8 characters.

Load Module CPU % of Job CPU usage for this load module as a percentage of the total CPU time seen by Inspect for all task control blocks (TCBs) in the address space. Valid value is a nubmer in the range 0.0 - 100.0.

Load Module CPU % of TCB CPU usage for this load module as a percentage of the total CPU time seen by Inspect for the owning task control block (TCB). Valid value is a number in the range 0.0 - 100.0.

Load Module Name The name of the load module that Inspect saw was executing when it took one or more samples. This field may contain *-CSA-* or *-ECSA-* if execution was within resident code within the CSA or ECSA. It may contain *-UNKN-* if Inspect was unable to determine the load module name. Valid value is a string of up to 8 characters.

Managed System A z/OS operating system in your enterprise that is being monitored by Tivoli OMEGAMON XE on z/OS. Valid value is a string of up to 32 characters, in the format <plexname>:<smfid>:MVSSYS.

Message Text of messages issued by the agent. Valid value is a string of up to 80 characters.

Offset in CSECT Offset in the control section (CSECT) of the granular CPU usage. Valid value is an integer in the range 0-2147483647.

Row An incrementing number returned for each row of data, starting at 1. This value is used to restore the data order in the table if you have sorted the data display by another column. This attribute is for internal use only. It should not be used in situations or queries.

Samples Number of samples to be taken by the Inspect agent.

SAMPLES IN Used to pass to the agent the number of samples to be taken. Valid value is an integer in the range 0-2147483647.

Samples Taken Number of samples taken by the Inspect process. The Inspect process ends when the number of samples taken equals the number of samples specified to be taken by the Inspect process in the SAMPLES IN parameter, or when the job in the address space being inspected ends, in which case the number of samples used will be less than SAMPLES IN and Samples. Valid value is an integer in the range 0-2147483647.

Samples Used Number of samples used to create the Inspect data, that is, the number of samples where the Inspect agent saw the target address space actually using CPU. You can use this value to determine the statistical accuracy of the sampled Inspect data. Valid value is an integer in the range 0-2147483647.

TCB Address Address of the task control block (TCB) within the target address space, in hexadecimal.

TCB CPU % of Job The percentage of CPU usage for this task control block (TCB), as a percentage of all the CPU time seen by Inspect for all TCBs in the address space. Valid value is a number in the range 0.0 - 100.0.

TCB Ended Indicates if task control block (TCB) ended (Yes) or not (blank) while Inspect was running.