Following are descriptions of the messages issued by the Inspect agent and displayed in the Agent Messages view of the Inspect Address Space CPU Use workspace.
KM3IN001I NO CPU ACTIVITY WAS DETECTED BY INSPECT
The Inspect agent did not see any CPU activity when it looked at the target address space. The target address space may be consuming CPU time but Inspect only considers it if it sees the address space executing during a sample since it needs to assign the CPU time to a component within the address space.
System action: None.
User Action: Refresh the workspace to run Inspect again.
KM3IN002E ASID PASSED TO INSPECT IS ZERO
The address space ID passed to the Inspect agent by the query was zero. Either the Inspect workspace was invoked from the physical navigation tree or the address space was not assigned to the query by the link.
System action: No data is returned.
User action: Determine why the address space ID value being passed to the query is zero. Possibly the workspace linkage has been changed.
KM3IN003E ASID PASSED TO INSPECT IS INVALID
The address space ID passed to the Inspect agent by the query was not a valid address space number on the z/OS system. The link to the Inspect workspace may be assigning the incorrect field to the ASID parameter of the query.
System action: No data is returned.
User action: Determine why the ASID value being passed to the query is invalid. Possibly the workspace linkage has been changed
KM3IN004I ADDRESS SPACE PRIORITY GREATER THAN INSPECT
The priority of the target address space is greater than that of the Candle Management Server in which the Inspect agent is executing. Inspect may not obtain enough CPU cycles to collect a reasonable sample of data from the target address space.
System action: Processing continues.
User Action: None
KM3IN005I DATA COLLECTION MAY BE INCOMPLETE
Part two of message KM3IN004I informing the user of the consequences of the priority difference.
System action: Processing continues.
User Action: None
KM3IN006E SAMPLER TASK ABENDED WITH CODE code
The Inspect agent sampler program task ABENDed with the specified code.
System action: No data is returned.
User Action: Determine the cause of the ABEND and possibly obtain a system dump of the ABEND.
KM3IN007E SELECTED JOB NOT IN TARGET ADDRESS SPACE
The Inspect agent will check that the job name passed is executing within the target ASID. If not either the wrong job name or ASID was passed by the link to the workspace or the job may have ended. If the job has not ended, check that the link to the Inspect workspace is passing the correct values to the Inspect query.
System action: No data is returned.
User Action: If the job has not ended, check that the link to the Inspect workspace is passing the correct values to the Inspect query.
KM3IN008I GRANULARITY SET TO size
The Inspect agent attempts to limit the amount of detail returned to the client to about 100 rows of data by dynamically calculating the "grain" size used split each CSECT of code into "blocks" to which CPU activity is attributed.
Since the user cannot know in advance how diverse the execution activity map will be, nor the sizes of the load modules and CSECT that have activity, nor even which modules and CSECTs will have activity, it is not reasonable to allow the user to set this parameter before the Inspect agent is executed, therefore the Inspect agent attempts to calculate a suitable size once all the Inspect data has been collected.
Size is displayed as a hexadecimal value.
System Action: Processing continues.
User Action: None
KM3IN009E ATTACH OF program FAILED WITH RC=rc
The Inspect agent attempted to attach the Inspect sampling program program as a separate MVS task within the Candle Management Server address space but the ATTACH failed with return code rc.
System action: No data is returned.
User Action: Determine the meaning of the return code for the ATTACH function and correct the error.
KM3IN010I INSPECT WAS NOT EXECUTED
Part to of messages KM3IN009E and KM3IN011E. Explains that no data was collected because of the error reported by the previous message.
KM3IN011E UNABLE TO LOAD program
The Inspect agent attempted to load the Inspect sampling program but the load operation failed.
System action: No data is returned.
User Action: Determine the cause of the failure to load pogram by scanning the Candle Management Server and z/OS logs for any appropriate messages.
KM3IN012E OPEN ERROR FOR DATASET dsn
The Inspect agent attempts to obtain CSECT information for each load module by accessing and load libraries allocated to the job step TCB of the target address space.
The Inspect agent was unable to open the specified dataset. System action: Processing continues:
User Action: The person responsible for Candle Management Server operations on the target host should browse the Candle Management Server and z/OS logs to determine the cause of the failure.
KM3IN013I SOME CSECT DATA MAY NOT BE AVAILABLE
Part two of messages KM3IN012E, KM3IN013E, KM3IN015E and KM3IN016E. Indicates that CSECT information may not be available for some load modules due to the previous error.
KM3IN014E UNABLE TO ALLOCATE DATASET dsn
The Inspect agent attempts to obtain CSECT information for each load module by accessing and load libraries allocated to the job step TCB of the target address space.
The Inspect agent was unable to allocate the specified dataset.
System action: Processing continues.
User Action: The person responsible for Candle Management Server operations on the target host should browse the Candle Management Server and z/OS logs to determine the cause of the failure.
KM3IN015E UNABLE TO READ FORMAT 1 DSCB FOR DATASET dsn
The Inspect agent attempts to obtain CSECT information for each load module by accessing and load libraries allocated to the job step TCB of the target address space.
The Inspect agent was unable to read the format 1 DSCB for the specified dataset.
System action: Processing continues.
User Action: The person responsible for Candle Management Server operations on the target host should browse the Candle Management Server and z/OS logs to determine the cause of the failure.
KM3IN016E UNABLE TO SUPPORT PDSE FOR DATASET dsn
The Inspect agent attempts to obtain CSECT information for each load module by accessing and load libraries allocated to the job step TCB of the target address space.
The Inspect agent determined that the specified dataset was a PDSE but the IEWBIND program could not be loaded by the Inspect agent.
System action: Processing continues.
User Action: The person responsible for Candle Management Server operations on the target host should browse the Candle Management Server and z/OS logs to determine why IEWBIND could not be located by the Inspect agent.