Enclave Table attributes

An enclave is defined as a transaction that can span multiple dispatchable units (SRBs and tasks) in one or more address spaces and is classified and managed as a unit. The Enclave Table attributes permit you to view information about or create situations that report on the status of various resources belonging to the enclave.

CPU Percent The percentage of regular processor time recently consumed by the enclave. This value cannot be determined for a very recently created enclave, in which case Not available is displayed. In some unusal cases, restarting a transaction can make the value appear as a negative number. In that case, the value NEG is displayed. This value can exceed 100%. The maximum value is n00%, where n is the number of processors (CPUs) assigned to the LPAR or image.

Export Token The 32-byte export token in hexadecimal.

IFA Percent The percentage of IFA recently consumed by the enclave. The determination of this value is not possible for a very recently created enclave. Unusual circumstances involving the restarting of a transaction can make the value on which this number is based appear negative. In that case, NEG is displayed. The value can exceed 100%. The maximum value is n00%*IFA normalization factor, where n is the number of IFAs configured to the LPAR and IFA normalization factor is a multiplier that allows normalization of IFA speeds to standard CP speeds on “knee-capped” processors.

IFA Percent on CP Average percentage of time the system consumes regular CP resource executing IFA work across all regular CPs configured to this LPAR.

Independent Enclave Token If this enclave is a work-dependent enclave, the 8 byte token, in hexadecimal, of the independent enclave that owns it. Note that the entire token is displayed, including any leading 0s. If you are relating this information to information provided by other products, be aware that some products do not display the leading 0s.

Managed System An z/OS operating system in your enterprise that is being monitored by a Tivoli OMEGAMON XE on z/OS agent. Valid value is a character string with a maximum length of 32 bytes.

Number of Work Dependent Enclaves If this enclave is an independent enclave, the number of work-dependent enclaves that it owns.

Owning ASID ID of the owning address space in hexadecimal. This column may contain 0 if the enclave is foreign, or in unusual recovery situations.

Owning JESJOBID The JES job ID of the address space. In the following circumstances, this information is not available:

blank

The owning address space is not using JES services.

*OTHSYS*

The report was produced by a system other than the owning system.

**GONE**

The owning job is no longer executing. This may mean that the owning job's address space no longer exists, or that the address space is now assigned to a different job.

At any one instant in time, both an enclave and its owning address space will or will not exist. However, it is not possible for a Tivoli OMEGAMON XE for z/OS agent to gather all enclave and address space information in one atomic operation. Thus, when an address space owning an enclave has recently ceased to exist, it is possible for the agent to have enclave information and still be unable to locate information associated with the owning address space.

Owning Jobname The job name of the owning address space. This attribute is not available on all levels of z/OS.

Owning System Name of the system where the owning address space is executing. This attribute is not available on all levels of z/OS.

ResGroup The resource group name.

RptClass The report class name.

Status The enclave's status. This value will be one of the following:

Subtype Type of subsystem to which the enclave belongs. This attribute is not available on all levels of z/OS. If the information is not available, the column contains Not available.

SvcClass The service class name.

SvcClass Period The service class period.

Token The 8-byte token name in hexadecimal format. The entire token is displayed including any leading zeroes. If you are relating information in this report to information provided by other products, you should be aware that some products do not display the leading zeroes. The token can be used to RESET the enclave. There is no z/OS command for this function, but it is supported by SDSF.

Total CPU The total CPU consumption in seconds. For a multisystem enclave, this value does not include CPU consumption on systems other than the system that produced the report.

Total IFA Total IFA consumption, in seconds. Valid value is an integer in the range 1 - 2147483647.

Total IFA on CP Total regular processor resource consumption performing work eligible for a zSeries Application Assist Processor (zAAp), in seconds. For a multisystem enclave, zAAP consumed on systems other than the system which produced the report is not included in this figure. Valid value is an integer in the range 1 - 2147483647.

Total zIIP Total System z9 Integrated Information Processor consumption in seconds.

Total zIIP on CP Total standard resource consumed performing work eligible for System z9 Integrated Information Processors (zIIPs), in seconds. For a multisystem enclave, zIIP resources consumed on systems other than the system which produced the report is not included in this figure.

Type The type of enclave. This value can be one of the following types:

Workload The name of the workload.

zIIP on CP Percent The percentage of regular processor resource recently consumed by the enclave performing work eligible for a System z9 Integrated Information Processor (zIIP). The determination of this value is not possible for a very recently created enclave. Unusual circumstances involving the restarting of a transaction can make the value on which this number is based appear negative. In that case, NEG is displayed. The value can exceed 100%. The maximum value is n00%*zIIP normalization factor, where n is the number of zIIPs configured to the LPAR and the zIIP normalization factor is a multiplier that allows normalization of zIIP speeds to standard processor speeds on "knee-capped" processors.

zIIP Percent The percentage of System z9 Integrated Information Processor resources recently consumed by the enclave. The determination of this value is not possible for a very recently created enclave. Unusual circumstances involving the restarting of a transaction can make the value on which this number is based appear negative. In that case, NEG is displayed.