zhmcGetCpcProperties function


zhmcGetCpcProperties

zhmcGetCpcProperties (hmcname, cpc)

Obtains the detailed properties for a CPC. The available properties are summarized in the table below:

se_version

The release level of the Support Element

has_hardware_messages

true if the CPC has outstanding hardware messages.

is_ensemble_member

true if the CPC is a member of an ensemble.

iml_mode

The IML mode type.

next_activaition_profile_name

The name of the activation profile to be used during the next CPC activation.

last_used_activation_profile_name

The name of the activation profile used during the last CPC activation.

machine_model

String containing the machine model.

machine_type

String containing the machine type.

machine_serial_number

String containing the machine serial number.

cpc_serial_number

The CPC serial number.

cpc_node_descriptor

String containing the hexadecimal number mapped to the device location.

is_cbu_installed

Indicates that CBU facility is installed.

is_cbu_activated

Indicates that CBU is activated.

is_real_cbu_available

Indicates that real CBU is available.

cbu_activation_date

Date of the CBU activation, or false if CBU has not been activated.

cbu_expiration_date

Date when the CBU will expire.

cbu_number_of_tests_left

The number of CBU tests remaining.

is_service_required

True if the CPC service is required, that is if the last redundant part of a particular type is being used.

degraded_stratus

An array of strings with the degraded status values.

processor_running_type_type

Indicates how the processor_running_time is being determined.

processor_running_time

THe amount of time, in milliseconds, allowed for logical process to perform jobs on shared processors.

does_wait_state_end_time_slice

true if LPARS should lose their share if the running time when they enter a wait state.

is_on_off_cod_installed

true if On/Off Capacity on Demand is installed.

is_on_off_cod_enabled

true if On/Off Capacity on Demand is enabled.

is_on_off_cod_activated

true if On/Off Capacity on Demand is activiated.

on_off_cod_activationmode

THe date when On/Off Capacity on Demand was activated.

software_model_permanent

String containing the software model for permanent processors.

software_model_permanent_plus_billable

String containing the software model for permanent plus billable processors.

software_model_permanent_plus_temporary

String containing the software model for permanent plus temporary processors.

msu_permanent

Integer containing the MSU value for permanent processors.

msu_permanent_plus_billable

Integer containing the MSU value for permanent plus billable processors.

msu_permanentpermanent_plus_temporary

Integer containing the MSU value for permanent plus temporary processors.

processor_count_general_purpose

The number of active general purpose processors.

processor_count_service_assist

The number of active service assist processors.

processor_count_aap

The number of active zAAP processors.

processor_count_ifl

The number of active IFL processors.

processor_count_icf

The number of active ICF processors.

processor_count_iip

The number of active zIIP processors.

processor_count_defective

The number of defective processors.

processor_count_spare

The number of spare processors.

processor_count_pending

The number of processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_general_purpose

The number of general purpose processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_service_assist

The number of service assist processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_aap

The number of zAAP processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_ifl

The number of IFL processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_icf

The number of ICF processors that will be come active when new hardware is added, or capacity records deactivated.

processor_count_pending_iip

The number of zIIP processors that will be come active when new hardware is added, or capacity records deactivated.

has_temporary_capacity_change_allowed

true if applications are allowed to make changes to temporary capacity, false otherwise.

network_info

A nested object containing the network information

ec-mcl-description

A nested object containing the EC and MCL information.

has_automatic_se_switch_enabled

True if automatic switching between the primary and alternate SEs is enabled.

stp_configuration

Server Time Protocol configuration.

lan_interface1_type

The adapter type for the SEs LAN interface 1.

lan_interface1_address

The MAC address for the SEs LAN interface 1.

lan_interface2_type

The adapter type for the SEs LAN interface 2.

lan_interface2_address

The MAC address for the SEs LAN interface 2.

network1_ipv4_mask

Network IP address mask.

network1_ipv4_pri_addr

Primary IPv4 address.

network1_ipv4_alt_addr

Alternate IPv4 address.

network1_ipv6_alt_addr

Array of objects containing the IPv6 address information.

network2_ipv4_mask

Network IP address mask.

network2_ipv4_pri_addr

Primary IPv4 address.

network2_ipv4_alt_addr

Alternate IPv4 address.

network2_ipv6_alt_addr

Array of objects containing the IPv6 address information.

Parameters:

hmcname

The HMC session name.

cpc

The CPC object as returned by the zhmcGetCpcs function

Returns:

An RDL2 object with the properties set, or false if there was an error.

Example

hmc = "PHXHMC7"
cpcs = zhmcGetCpcs(hmc)
do i = 0 to cpcs.size() - 1
trace("CPC: " & cpcs[i].name, GREEN)
trace(" name: " & cpcs[i].name, GREEN)
props = zhmcGetCpcProperties(hmc, cpcs[i])
trace(" Status: " & cpcs[i].status, GREEN)
trace(" CBU Installed : " & props.is_cbu_installed, GREEN)
trace(" Active IFLs : " & props.processor_count_ifl, GREEN)
end

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*