HMC query functions

RDL provides the ability to query many attributes available on the IBM HMC. These attributes include lists of the CPCs, Images, the various activation profiles, as well as the individual attributes of each of the HMC objects. This page contains a list of these functions as well as sample uses of a few of the functions.

These functions use the Application Programming Interfaces as described in System z Application Programming Interfaces (SB10-7030-14a), available on the HMC in the Library section of Additional Resources and on IBM's Resource Link. This document contains detailed information about each of the RDL functions. The API document should be consulted to understand the exact meaning of each attribute and function.

The HMC maintains several objects that can be accessed from RDL. These objects are documented in chapter 4 of the System z Application Programming Interfaces document. Each section of this page corresponds to a section in the document. Each function described on this page corresponds to an individual attribute of an object.

Most functions described here work properly when SecureHMC is configured to use a zManager-enabled HMC. Some of the return values are slightly different and are noted here.

Important

The functions described here are included with BMC AMI Ops SecureHMC. This product is required to use these functions.

Console

The console functions to obtain information pertaining to the HMC itself. Each console function takes a single parameter, which is the name of the HMC as defined in BMC AMI Ops SecureHMC.

Example:

function getConsoleName()

hmcname = hmcGetConName("HMC1")

sendMessageToAllUsers("HMC1 console name is " & hmcname)

return 0

Attribute Name	Get Function	Set Function
Name	hmcGetConName
SNA Address	hmcGetConSNAaddr
Group Contents	hmcGetConContents
Version	hmcGetConVersion
IP Address	hmcGetConIpAddrs
Engineering Change (EC)/Microcode Level (MCL)	hmcGetConEcInfo

CPC

The CPC functions obtain attributes of a single CPC. The hmcGetCpcList returns an array containing the names of all CPCs managed by the HMC. All other CPC "get" functions take two parameters and the CPC "set" functions take three.

hmcGetCpcList

hmcGetCpcList (hmcName)

Returns a list of the CPCs managed by the HMC. Each item in the list is a string that can be used to identify the CPC to the other CPC get and set functions.

Parameter:

hmcName - The name of the HMC.

Returns:

An array containing the names of all CPCs managed by the HMC.

Example:

function listCpcs()

cpcs = hmcGetCpcList("HMC1")

return 0

Attribute Name	Get Function	Set Function
Name	hmcGetDefcpcObjName
Status Error	hmcGetDefcpcObjStatusError
Busy	hmcGetDefcpcObjBusy
Message Indicator	hmcGetDefcpcObjMessageIndicator
Status Error	hmcGetDefcpcObjStatus
Acceptable Status	hmcGetDefcpcObjAccptStatus	hmcSetDefcpcObjAccptStatus
IML Mode	hmcGetDefcpcObjIMLmode
Activation Profile Name	hmcGetDefcpcObjActProfile	hmcSetDefcpcObjActProfile
Last Used Activation Profile	hmcGetDefcpcObjLastUsedActProfile
Internet Address	hmcGetDefcpcObjInternetAddr,
SNA Address	hmcGetDefcpcObjSNAaddr
Computer (Machine) model	hmcGetDefcpcObjCompModel
Computer (machine) type	hmcGetDefcpcObjCompType
Computer (machine) serial	hmcGetDefcpcObjCompSerial
CPC serial number	hmcGetDefcpcObjCPCSerial
CPC Identifier	hmcGetDefcpcObjCPCid
Object Type	hmcGetDefcpcObjObjectType
List of reset activation profiles	hmcGetDefcpcObjResetProfile
List of image activation profiles	hmcGetDefcpcObjImageProfile
List of load activation profiles	hmcGetDefcpcObjLoadProfile
CBU Installed	hmcGetDefcpcObjCBU
CBU activated	hmcGetDefcpcObjCBUActivate
CBU activation date	hmcGetDefcpcObjCBUActDate
CBU expiration date	hmcGetDefcpcObjCBUExpDate
Number of CBU tests left	hmcGetDefcpcObjNumCBUTests
Real activation available	hmcGetDefcpcObjRealCBU
Reserve ID	hmcGetDefcpcObjReserveID
Service required indicator	hmcGetDefcpcObjServReq
Degraded indicator	hmcGetDefcpcObjDegraded
CBU Enabled	hmcGetDefcpcObjCBUEnabled
List of cluster members	hmcGetDefcpcObjClusterList
Processor running time type	hmcGetDefcpcProcessorRunningTimeType	hmcSetDefcpcProcessorRunningTimeType
Processor running time	hmcGetDefcpcProcessorRunningTime	hmcSetDefcpcProcessorRunningTime
End timeslice if CPC image enters a wait state	hmcGetDefcpcProcessorRunningTimeWaitState	hmcSetDefcpcProcessorRunningTimeWaitState
On/Off CoD Installed	hmcGetDefcpcObjOOCoDInstalled
On/Off CoD activated	hmcGetDefcpcObjOOCoDActivated
On/Off CoD enabled	hmcGetDefcpcObjOOCoDEnabled
On/Off CoD activated date	hmcGetDefcpcObjOOCoDActDate
List of group profiles	hmcGetDefcpcObjGroupProfile
Temporary capacity records	hmcGetDefcpcObjCapacityRecords
Permanent software model	hmcGetDefcpcObjPermSoftwareModel
Permanent plus billable software model	hmcGetDefcpcObjPermBillableSoftwareModel
Permanent plus all temporary software model	hmcGetDefcpcObjPermAllSoftwareModel
Permanent MSU	hmcGetDefcpcObjPermMsu
Permanent plus billable MSU	hmcGetDefcpcObjPermBillableMsu
Permanent plus all temporary MSU	hmcGetDefcpcObjPermAllMsu
General purpose processors	hmcGetDefcpcObjNumCPs
Service assist processors	hmcGetDefcpcObjNumSAPs
Application Assist Processor (AAP) processors	hmcGetDefcpcObjNumIFAs
Integrated Facility for Linux (IFL) processors	hmcGetDefcpcObjNumIFLs
Internal Coupling Facility (ICF) processors	hmcGetDefcpcObjNumICFs
Integrated Information Processors (zIIP) processors	hmcGetDefcpcObjNumIIPs
Defective processors	hmcGetDefcpcObjNumDefectiveProcessors
Spare processors	hmcGetDefcpcObjNumSpareProcessors
Pending processors	hmcGetDefcpcObjNumPendingProcessors
Temporary capacity change allowed	hmcGetDefcpcObjCapacityChangeAllowed
Version	hmcGetDefcpcObjVersion
Internet Protocol (IP) addresses	hmcGetDefcpcObjIpAddrs
Engineering Change (EC)/Microcode Level (MCL)	hmcGetDefcpcObjectEcInfo
Automatic switch enabled	hmcGetDefcpcObjectAutoSwitchEnabled
Server Time Protocol (STP) configuration	hmcGetDefcpcObjectSTPConfig
Pending General Purpose Processors	hmcGetDefcpcObjNumPendingGenProcessors
Pending Service Assist Processors	hmcGetDefcpcObjNumPendingSAPProcessors
Pending Application Assist Processor (AAP) Processors	hmcGetDefcpcObjNumPendingIFAProcessors
Pending Integrated Facility for Linux (IFL) Processors	hmcGetDefcpcObjNumPendingIFLProcessors
Pending Internal Coupling Facility (ICF) Processors	hmcGetDefcpcObjNumPendingICFProcessors
Pending Integrated Information Processors (zIIP) Processors	hmcGetDefcpcObjNumPendingIIPProcessors

Image

The Image functions obtain attributes of a single CPC. The hmcGetImageList returns an array containing the names of all CPCs managed by the HMC. All other CPC "get" functions take two parameters and the CPC "set" functions take three.

hmcGetImageList

hmcGetImageList(hmcName)

Returns a list of the Images managed by the HMC. Each item in the list is a string that can be used to identify the Image to the other Image get and set functions.

Parameter:

hmcName - The name of the HMC.

Returns:

An array containing the names of all Images managed by the HMC.

Example:

function listCpcs()

images = hmcGetImageList("HMC1")

return 0

Attribute Name	Get Function	Set Function
Name	hmcGetImgObjName	hmcSetImgObjName
Parent Name	hmcGetCpcimgObjParent	hmcSetCpcimgObjParent
Operating System Name	hmcGetCpcimgObjOSName	hmcSetCpcimgObjOSName
Operating System Type	hmcGetCpcimgObjOSType	hmcSetCpcimgObjOSType
Operating System Level	hmcGetCpcimgObjOSLevel	hmcSetCpcimgObjOSLevel
Sysplex Name	hmcGetCpcimgObjSysplexName	hmcSetCpcimgObjSysplexName
Status Error	hmcGetCpcimgObjStatusError	hmcSetCpcimgObjStatusError
Busy	hmcGetCpcimgObjBusy	hmcSetCpcimgObjBusy
Message Indicator	hmcGetCpcimgObjMessageIndicator
Status	hmcGetCpcimgObjStatus	hmcSetCpcimgObjStatus
Acceptable Status	hmcGetCpcimgObjAccptStatus	hmcSetCpcimgObjAccptStatus
IML Partition Activation Mode	hmcGetCpcimgObjIMLmode	hmcSetCpcimgObjIMLmode
Activation Profile name	hmcGetCpcimgObjActProfile	hmcSetCpcimgObjActProfile
Last Used Activation Profile	hmcGetCpcimgObjLastUsedActProfile
Object Type	hmcGet
Initial Processing Weight	hmcGetCpcimgObjInitProcWeight	hmcSetCpcimgObjInitProcWeight
Initial Processing Weight Capped	hmcGetCpcimgObjInitProcWeightCapped	hmcSetCpcimgObjInitProcWeightCapped
Minimum Processing Weight	hmcGetCpcimgObjMinProcWeight	hmcSetCpcimgObjMinProcWeight
Maximum Processing Weight	hmcGetCpcimgObjMaxProcWeight	hmcSetCpcimgObjMaxProcWeight
Current Processing Weight	hmcGetCpcimgObjCurProcWeight
Current Processing Weight Capped	hmcGetCpcimgObjCurProcWeightCapped
Workload Manager Enabled	hmcGetCpcimgObjWLManager	hmcSetCpcimgObjWLManager
Defined Capacity	hmcGetCpcimgObjDefCapacity	hmcSetCpcimgObjDefCapacity
Cluster Name	hmcGetCpcimgObjClusterName
Partition Identifier	hmcGetCpcimgobjPartitionId
Initial Application Assist Processor processing weight	hmcGetCpcimgObjInitIFAProcWeight	hmcSetCpcimgObjInitIFAProcWeight
Initial Application Assist Processor processing weight capped	hmcGetCpcimgObjInitIFAProcWeightCapped	hmcSetCpcimgObjInitIFAProcWeightCapped
Minimum Application Assist Processor processing weight	hmcGetCpcimgObjMinIFAProcWeight	hmcSetCpcimgObjMinIFAProcWeight
Maximum Application Assist Processor processing weight	hmcGetCpcimgObjMaxIFAProcWeight	hmcSetCpcimgObjMaxIFAProcWeight
Current Application Assist Processor processing weight	hmcGetCpcimgObjCurIFAProcWeight
Current Application Assist Processor processing weight capped	hmcGetCpcimgObjCurIFAProcWeightCapped
Initial IFL processing weight	hmcGetCpcimgObjInitIFLProcWeight	hmcSetCpcimgObjInitIFLProcWeight
Initial IFL Processing Weight Capped	hmcGetCpcimgObjInitIFLProcWeightCapped	hmcSetCpcimgObjInitIFLProcWeightCapped
Minimum IFL Processing Weight	hmcGetCpcimgObjMinIFLProcWeight	hmcSetCpcimgObjMinIFLProcWeight
Maximum IFL Processing Weight	hmcGetCpcimgObjMaxIFLProcWeight	hmcSetCpcimgObjMaxIFLProcWeight
Current IFL Processing Weight	hmcGetCpcimgObjCurIFLProcWeight
Current IFL Processing Weight Capped	hmcGetCpcimgObjCurIFLProcWeightCapped
Initial Integrated Information processing weight	hmcGetCpcimgObjInitIIPProcWeight	hmcSetCpcimgObjInitIIPProcWeight
Initial Integrated Information Processing Weight Capped	hmcGetCpcimgObjInitIIPProcWeightCapped	hmcSetCpcimgObjInitIIPProcWeightCapped
Minimum Integrated Information Processing Weight	hmcGetCpcimgObjMinIIPProcWeight	hmcSetCpcimgObjMinIIPProcWeight
Maximum Integrated Information Processing Weight	hmcGetCpcimgObjMaxIIPProcWeight	hmcSetCpcimgObjMaxIIPProcWeight
Current Integrated Information Processing Weight	hmcGetCpcimgObjCurIIPProcWeight
Current Integrated Information Processing Weight Capped	hmcGetCpcimgObjCurIIPProcWeightCapped
Program Status Word (PSW) Information	hmcGetCpcimgObjPswInfo	hmcSetCpcimgObjPswInfo
Program Status Word (PSW) Information Disabled Wait Trap	hmcGetCpcimgObjPswCpInfo
IPL Token	hmcGetCpcimgIPLToken
Group Profile Capacity	hmcGetCpcimgIPLToken	hmcSetCpcimgIPLToken
Last Used Load Address	hmcGetCpcimgObjLastLoadAddr	Warning Important Not supported under zManager
Last Used Load Parameter	hmcGetCpcimgObjLastLoadParm	Warning Important Not supported under zManager

Coupling facility

The Coupling facility functions obtain attributes of a single Coupling Facility. The hmcGetImageList returns an array containing the names of all coupling facilities within a CPC.

hmcGetCouplingFacilityList

hmcGetCouplingFacilityList(hmcName)

Returns a list of the Coupling Facilities managed by the HMC. Each item in the list is a string that can be used to identify the Coupling Facility to the other Coupling Facility get and set functions.

Parameters:

hmcName - The name of the HMC.

Returns:

An array containing the names of all Coupling Facilities managed by the HMC.

Example:

hmcName = "HMC1"

cfList = hmcGetCouplingFacilityList(hmcName)

do i = 0 to cfList.size() - 1

   initProcWeight = hmcGetCfObjInitProcWeight(hncName, cfList[i])

   trace("CF: " & cfList[i] & ", initial processing weight = " & initProcWeight, GREEN)

end

hmcName = "HMC1"

cfList = hmcGetCouplingFacilityList(hmcName)

do i = 0 to cfList.size() - 1

   initProcWeight = hmcGetCfObjInitProcWeight(hncName, cfList[i])

   trace("CF: " & cfList[i] & ", initial processing weight = " & initProcWeight, GREEN)

end

Attribute Name	Get Function	Set Function
Name	hmcGetCfObjName
Parent name	hmcGetCfObjParentName
Status error	hmcGetCfObjStatusError
Busy	hmcGetCfObjBusy
Message indicator	hmcGetCfObjMessageIndicator
Status	hmcGetCfObjStatus
Acceptable status	hmcGetCfObjAccptStatus	hmcSetCfObjAccptStatus
Activation profile name	hmcGetCfObjActProfile
Last used activation profile	hmcGetCfObjLastUsedActProfile
Object type	hmcGet
Initial processing weight	hmcGetCfObjInitProcWeight	hmcSetCfObjInitProcWeight
Initial processing weight capped	hmcGetCfObjInitProcWeightCapped	hmcSetCfObjInitProcWeightCapped
Minimum processing weight	hmcGetCfObjMinProcWeight	hmcSetCfObjMinProcWeight
Maximum processing weight	hmcGetCfObjMaxProcWeight	hmcSetCfObjMaxProcWeight
Current processing weight	hmcGetCfObjCurProcWeight
Current processing weight capped	hmcGetCfObjCurProcWeightCapped
WorkLoad manager enabled	hmcGetCfObjWLManager	hmcSetCfObjWLManager
Defined capacity	hmcGetCfObjDefCapacity	hmcSetCfObjDefCapacity
Partition identifier	hmcGetCfObjPartitionId
Initial Internal Coupling Facility processing weight	hmcGetCfObjIcfProcWeight	hmcSetCfObjIcfProcWeight
Initial Internal Coupling Facility processing weight capped	hmcGetCfObjIcfProcWeightCapped	hmcSetCfObjIcfProcWeightCapped
Minimum Internal Coupling Facility processing weight	hmcGetCfObjIcfMinProcWeight	hmcSetCfObjIcfMinProcWeight
Maximum Internal Coupling Facility processing weight	hmcGetCfObjIcfMaxProcWeight	hmcSetCfObjIcfMaxProcWeight
Current Internal Coupling Facility processing weight	hmcGetCfObjIcfCurProcWeight
Current Internal Coupling Facility processing weight capped	hmcGetCfObjIcfCurProcWeightCapped
Program Status Word (PSW) information	hmcGetCfObjPswInfo

Reset activation profile

Reset act overview.

Example:

hmcName = "HMC1"

target = "P00F3ECC:CF1"

value = hmcGetResetactIOCDS(hmcName, target)

trace("resetactIOCDS : " & value, GREEN)

if value == false &&

hmcGetLastError() != false then

trace("ERROR: " & hmcGetLastError(),RED)

endif

Attribute Name	Get Function	Set Function
Name	hmcGetResetactName
Object Type	hmcGetResetactObjectType
IOCDS	hmcGetResetactIOCDS	hmcSetResetactIOCDS
Processor Running Time Type	hmcGetResetactProcessorRunningTimeType	hmcSetResetactProcessorRunningTimeType
Processor Running Time	hmcGetResetactProcessorRunningTime	hmcSetResetactProcessorRunningTime
End timeslice of CPC image enters a wait state	hmcGetResetactProcessorRunningTimeWaitState	hmcSetResetactProcessorRunningTimeWaitState
Description	hmcGetResetactDescription	hmcSetResetactDescription

Image activation profile

Image act overview.

Example:

hmcName = "HMC1"

value = hmcGetImageActivationProfileList(hmcName, "P00F1ECC")

if hmcGetLastError() == false then

trace("Image act profs returned " & value, GREEN) if value.size() > 0 then

do i = 0 to value.size() - 1

procWeight = hmcGetImgactInitProcWeight(hmcName, value[i])

if procWeight == false && hmcGetLastError() != false then

trace("ERROR: " & hmcGetLastError(),RED) else

trace("Initial processor weight for : " & value[i] & " is " & procWeight, GREEN)

endif

end

endif

else

trace ("hmcGetResetActivationProfileList error: " & hmcGetLastError(), RED)

endif

Attribute Name	Get Function	Set Function
Name	hmcGetImgactName
Object type	hmcGetImgactObjectType
IPL address	hmcGetImgactIPLaddr	hmcSetImgactIPLaddr
IPL parameter	hmcGetImgactIPLpar	hmcSetImgactIPLpar
Initial processing weight	hmcGetImgactInitProcWeight	hmcSetImgactInitProcWeight
Initial processing weight capped	hmcGetImgactInitProcWeightCapped	hmcSetImgactInitProcWeightCapped
Minimum processing weight	hmcGetImgactMinProcWeight	hmcSetImgactMinProcWeight
Maximum processing weight	hmcGetImgactMaxProcWeight	hmcSetImgactMaxProcWeight
WorkLoad manager enabled	hmcGetImgactWLManager	hmcSetImgactWLManager
NA	hmcGetImgactCurProcWeight
NA	hmcGetImgactCurProcWeightCapped
Defined capacity	hmcGetImgactDefCapacity	hmcSetImgactDefCapacity
IPL type	hmcGetImgactIplType	hmcSetImgactIplType
Worldwide port name	hmcGetImgactWorldWideName	hmcSetImgactWorldWideName
Boot program selector	hmcGetImgactDiskPartitionId	hmcSetImgactDiskPartitionId
Logical unit number	hmcGetImgactLogicalUnitNumber	hmcSetImgactLogicalUnitNumber
Boot record logical block address	hmcGetImgactMbrLba	hmcSetImgactMbrLba
Operating system-specific load parameters	hmcGetImgactOsParms	hmcSetImgactOsParms
Initial Application Assist Processor processing weight	hmcGetImgactInitIFAProcWeight	hmcSetImgactInitIFAProcWeight
Initial Application Assist Processor processing weight capped	hmcGetImgactInitIFAProcWeightCapped	hmcSetImgactInitIFAProcWeightCapped
Minimum Application Assist Processor processing weight	hmcGetImgactMinIFAProcWeight	hmcSetImgactMinIFAProcWeight
Maximum Application Assist Processor processing weight	hmcGetImgactMaxIFAProcWeight	hmcSetImgactMaxIFAProcWeight
Initial Integrated Facility for Linux processing weight	hmcGetImgactInitIFLProcWeight	hmcSetImgactInitIFLProcWeight
Initial Integrated Facility for Linux Processing weight capped	hmcGetImgactInitIFLProcWeightCapped	hmcSetImgactInitIFLProcWeightCapped
Minimum Integrated Facility for Linux processing weight	hmcGetImgactMinIFLProcWeight	hmcSetImgactMinIFLProcWeight
Maximum Integrated Facility for Linux processing weight	hmcGetImgactMaxIFLProcWeight	hmcSetImgactMaxIFLProcWeight
Initial Internal Coupling Facility processing weight	hmcGetImgactInitICFProcWeight	hmcSetImgactInitICFProcWeight
Initial Internal Coupling Facility processing weight capped	hmcGetImgactInitICFProcWeightCapped	hmcSetImgactInitICFProcWeightCapped
Minimum Internal Coupling Facility processing weight	hmcGetImgactMinICFProcWeight	hmcSetImgactMinICFProcWeight
Maximum Internal Coupling Facility processing weight	hmcGetImgactMaxICFProcWeight	hmcSetImgactMaxICFProcWeight
Initial Integrated Information Processors processing weight	hmcGetImgactInitIIPProcWeight	hmcSetImgactInitIIPProcWeight
Initial Integrated Information Processors processing weight capped	hmcGetImgactInitIIPProcWeightCapped	hmcSetImgactInitIIPProcWeightCapped
Minimum Integrated Information Processors processing weight	hmcGetImgactMinIIPProcWeight	hmcSetImgactMinIIPProcWeight
Maximum Integrated Information Processors processing weight	hmcGetImgactMaxIIPProcWeight	hmcSetImgactMaxIIPProcWeight
Group profile name	hmcGetImgactGroupProfile	hmcSetImgactGroupProfile
Load at activation	hmcGetImgactLoadAtActivation	hmcSetImgactLoadAtActivation
Central storage	hmcGetImgactCentralStorage	hmcSetImgactCentralStorage
Reserved central storage	hmcGetImgactCentralStorageReserved	hmcSetImgactCentralStorageReserved
Expanded storage	hmcGetImgactExpandedStorage	hmcSetImgactExpandedStorage
Reserved expanded storage	hmcGetImgactExpandedStorageReserved	hmcSetImgactExpandedStorageReserved
Number of dedicated general-purpose processors	hmcGetImgactNumDedicatedCps	hmcSetImgactNumDedicatedCps
Number of reserved dedicated general-purpose processors	hmcGetImgactNumDedicatedCpsReserved	hmcSetImgactNumDedicatedCpsReserved
Number of dedicated Application Assist Processor (AAP) processors	hmcGetImgactNumDedicatedIFAs	hmcSetImgactNumDedicatedIFAs
Number of reserved dedicated Application Assist Processor (AAP) Processors	hmcGetImgactNumDedicatedIFAsReserved	hmcSetImgactNumDedicatedIFAsReserved
Number of dedicated Integrated Facility for Linux (IFL) processors	hmcGetImgactNumDedicatedIFLs	hmcSetImgactNumDedicatedIFLs
Number of reserved dedicated Integrated Facility for Linux (IFL) processors	hmcGetImgactNumDedicatedIFLsReserved	hmcSetImgactNumDedicatedIFLsReserved
Number of dedicated Internal Coupling Facility (ICF) processors	hmcGetImgactNumDedicatedICFs	hmcSetImgactNumDedicatedICFs
Number of reserved dedicated Internal Coupling Facility (ICF) processors	hmcGetImgactNumDedicatedICFsReserved	hmcSetImgactNumDedicatedICFsReserved
Number of dedicated Integrated Information Processors (zIIP) processors	hmcGetImgactNumDedicatedIIPs	hmcSetImgactNumDedicatedIIPs
Number of reserved dedicated Integrated Information Processors (zIIP) processors	hmcGetImgactNumDedicatedIIPsReserved	hmcSetImgactNumDedicatedIIPsReserved
Number of shared general-purpose processors	hmcGetImgactNumSharedCps	hmcSetImgactNumSharedCps
Number of reserved shared general-purpose processors	hmcGetImgactNumSharedCpsReserved	hmcSetImgactNumSharedCpsReserved
Number of shared Application Assist Processor (AAP) processors	hmcGetImgactNumSharedIFAs	hmcSetImgactNumSharedIFAs
Number of reserved shared Application Assist Processor (AAP) processors	hmcGetImgactNumSharedIFAsReserved	hmcSetImgactNumSharedIFAsReserved
Number of shared Integrated Facility for Linux (IFL) processors	hmcGetImgactNumSharedIFLs	hmcSetImgactNumSharedIFLs
Number of reserved shared Integrated Facility for Linux (IFL) processors	hmcGetImgactNumSharedIFLsReserved	hmcSetImgactNumSharedIFLsReserved
Number of shared Internal Coupling Facility (ICF) processors	hmcGetImgactNumSharedICFs	hmcSetImgactNumSharedICFs
Number of reserved shared Internal Coupling Facility (ICF) processors	hmcGetImgactNumSharedICFsReserved	hmcSetImgactNumSharedICFsReserved
Number of shared Integrated Information Processors (zIIP) processors	hmcGetImgactNumSharedIIPs	hmcSetImgactNumSharedIIPs
Number of reserved shared Integrated Information Processors (zIIP) processors	hmcGetImgactNumSharedIIPsReserved	hmcSetImgactNumSharedIIPsReserved
Basic CPU counter authorization control	hmcGetImgactCpuCounterBasicEnabled	hmcSetImgactCpuCounterBasicEnabled
Problem state CPU counter authorization control	hmcGetImgactCpuCounterProblemStateEnabled	hmcSetImgactCpuCounterProblemStateEnabled
Crypto activity CPU counter authorization control	hmcGetImgactCpuCounterCryptoActivityEnabled	hmcSetImgactCpuCounterCryptoActivityEnabled
Extended CPU counter authorization control	hmcGetImgactCpuCounterExtendedEnabled	hmcSetImgactCpuCounterExtendedEnabled
Coprocessor group CPU counter authorization control	hmcGetImgactCpuCounterCoprocessorGroupEnabled	hmcSetImgactCpuCounterCoprocessorGroupEnabled
Basic CPU sampling authorization control	hmcGetImgactCpuSamplingBasicEnabled	hmcSetImgactCpuSamplingBasicEnabled
Permit AES key import functions	hmcGetImgactPermitAESImport	hmcSetImgactPermitAESImport
Permit DEA key import functions	hmcGetImgactPermitDEAImport	hmcSetImgactPermitDEAImport
Description	hmcGetImgactDescription	hmcSetImgactDescription
Partition Identifier	hmcGetImgactPartitionIdentifier	hmcSetImgactPartitionIdentifier
Operating mode	hmcGetImgactOperatingMode	hmcSetImgactOperatingMode
Clock type	hmcGetImgactClockType	hmcSetImgactClockType
Time offset days	hmcGetImgactTimeOffsetDays	hmcSetImgactTimeOffsetDays
Time offset hours	hmcGetImgactTimeOffsetHours	hmcSetImgactTimeOffsetHours
Time offset minutes	hmcGetImgactTimeOffsetMinutes	hmcSetImgactTimeOffsetMinutes
Time offset increase or decrease	hmcGetImgactTimeOffsetIncrease	hmcSetImgactTimeOffsetIncrease
LICCC validation	hmcGetImgactLicccValidationEnabled	hmcSetImgactLicccValidationEnabled
Global performance data control	hmcGetImgactGlobalPerformanceDataControl	hmcSetImgactGlobalPerformanceDataControl
Input/Output configuration control	hmcGetImgactIOConfigurationControl	hmcSetImgactIOConfigurationControl
Cross partition authority control	hmcGetImgactCrossPartitionAuthority	hmcSetImgactCrossPartitionAuthority
Logical partition isolation control	hmcGetImgactLogicalPartitionIsolation	hmcSetImgactLogicalPartitionIsolation

Load activation profile

Load act overview.

Example:

hmcName = "HMC1"

cpcName = "P00F1ECC"

loadActProfile = hmcGetLoadActivationProfileList(hmcName, cpcName)

if hmcGetLastError() == false then

trace("Load act profs returned " & value, GREEN)

if value.size() > 0 then

do i = 0 to value.size() - 1 value = hmcGetLoadactIplType(hmcName, target)

trace("loadactIplType : " & value, GREEN)

if value == false && hmcGetLastError() != false then

trace("ERROR: " & hmcGetLastError(),RED)

endif

end

endif

else

trace("hmcGetResetActivationProfileList error: " & hmcGetLastError(), RED)

endif

Attribute Name	Get Function	Set Function
Name	hmcGetLoadactName
Object type	hmcGetLoadactObjectType
IPL address	hmcGetLoadactIPLaddr	hmcSetLoadactIPLaddr
IPL parameter	hmcGetLoadactIPLpar	hmcSetLoadactIPLpar
IPL type	hmcGetLoadactIplType	hmcSetLoadactIplType
Worldwide port name	hmcGetLoadactWorldWideName	hmcSetLoadactWorldWideName
Boot program selector	hmcGetLoadactDiskPartitionId	hmcSetLoadactDiskPartitionId
Logical unit number	hmcGetLoadactLogicalUnitNumber	hmcSetLoadactLogicalUnitNumber
Boot record logical block address	hmcGetLoadactMbrLba	hmcSetLoadactMbrLba
Operating system-specific load parameters	hmcGetLoadactOsParms	hmcSetLoadactOsParms
Store Status	hmcGetLoadactStoreStatus	hmcSetLoadactStoreStatus
Load Type	hmcGetLoadactLoadType	hmcSetLoadactLoadType
Description	hmcGetLoadactDescription	hmcSetLoadactDescription

Group profile object

Attribute Name	Get Function	Set Function
Name
Name	hmcGetGrpactName
Object type	hmcGetGrpactObjectType
Capacity	hmcGetGrpactCapacity	hmcSetGrpactCapacity
Description	hmcGetGrpactDescription	hmcSetGrpactDescription

Capacity record object

Attribute Name	Get Function	Set Function
Object type
Object type	hmcGetCaprecObjectType
Record identifier	hmcGetCaprecRecordId
Record type	hmcGetCaprecType
Activation status	hmcGetCaprecActStatus
Activation date	hmcGetCaprecActDate
Record expiration date	hmcGetCaprecExpireDate
Activation expiration date	hmcGetCaprecActExpireDate
Maximum real days	hmcGetCaprecMaxRealActDays
Maximum test days	hmcGetCaprecMaxTestActDays
Remaining real days	hmcGetCaprecRemainingRealActDays
Remaining test days	hmcGetCaprecRemainingTestActDays
NA	hmcGetCaprecChangeType
NA	hmcGetCaprecRecordChangeType
Remaining number of real activations	hmcGetCaprecRemainingRealCount
Remaining number of test activations	hmcGetCaprecRemainingTestCount

HMC query functions

Console

Example:

CPC

hmcGetCpcList

Example:

Image

hmcGetImageList

Coupling facility

hmcGetCouplingFacilityList

Example:

Reset activation profile

Example:

Image activation profile

Example:

Load activation profile

Example:

Group profile object

Capacity record object

BMC AMI Ops Console Management, BMC AMI Ops Console Automation, and BMC AMI Ops SecureHMC 4.1

On this page