IMFEXEC HMC QUERY
REXX stem variables are returned, LINE.0 contains the number of stem variables named LINE.nnn.
Refer to the IBM documentation about the BCPii and see the IBM documentation System z Application Programming Interfaces for the explanation of each attribute.
Some attributes can return different values when called with different tokens. For example QUERY(name) returns different values when called with a CPC token or an Image token or a Reset Activation Profile token, and so on. The possible items for the QUERY keyword are described in the following table. For more information, see the section "Defined CPC attributes" in the IBM documentation System z Application Programming Interfaces.
Attributes for the QUERY keyword
Name of attribute | Description | Value returned |
|---|---|---|
NAME | Name of the object represented by the Token | Character string |
ERRSTAT | Status Error | TRUE, FALSE |
BUSYSTAT | Busy | TRUE, FALSE |
MSGSTAT | Message Indicator | TRUE, FALSE |
OPERSTAT | Current Status; see hwmca_status_* | OPERATING, NOTOPERATING, NOPOWER, NOTACTIVATED, EXCEPTIONS, STATUSCHECK, SERVICE, LINKNOTACTIVE, POWERSAVE, SERIOUSALERT, ALERT, ENVALERT,SERVICEREQ, DEGRADED, STORAGEEXCEEDED, LOGOFFTIMEOUT, FORCEDSLEEP, IMAGENOTOPERATING, IMAGENOTACTIVATED, IMAGENOTCAPABLE, UNKNOWN |
ACCSTAT | Acceptable Status | OPERATING, NOTOPERATING, NOPOWER, NOTACTIVATED, EXCEPTIONS, STATUSCHECK, SERVICE, LINKNOTACTIVE, POWERSAVE, SERIOUSALERT, ALERT, ENVALERT,SERVICEREQ, DEGRADED, STORAGEEXCEEDED, LOGOFFTIMEOUT, FORCEDSLEEP, IMAGENOTOPERATING, IMAGENOTACTIVATED, IMAGENOTCAPABLE, UNKNOWN |
APROF | Activation profile name | Character string |
LUAPROF | Last used Activation profile name | Character string |
OBJTYPE | Object type; see hwmca_cpc_* | CPCGROUP, CPCIMAGEGROUP, CPCUSERGROUP, CPCIMAGEUSERGROUP, CPCOBJECT, CPCIMAGEOBJECT, CFOBJECT, ACTPROFILERESET, ACTPROFILEIMAGE, ACTPROFILELOAD, ACTPROFILEGROUP, CAPACITYRECORD, VMGROUP, VMOBJECT |
IMLMODE | IML mode, see hwmca_iml_* | ESA390, S370, FM, FMAE, HM, HMEA, HMEX, LPAR, ESA390TPF, CFPROD, FMEX, HMAS, LINUXO, ZVM |
IPADDR | Internet address (nnn.nnn.nnn.nnn) | Character string |
SNAADDR | SNA address (netid.netname) | Character string |
MMODEL | Machine model | Character string |
MTYPE | Machine type | Character string |
MSERIAL | Machine serial | Character string |
CPCSERIAL | CPC serial number | Character string |
CPCID | CPC identifier, node descriptor | Character string |
RESERVEID | Name of the application that currently holds the reserve | Character string, zero length if no application holds the reserve |
SVCEREQD | Service required indicator | TRUE, FALSE |
CBUINSTD | CBU installed | TRUE, FALSE |
CBUENABLD | CBU enabled | TRUE, FALSE |
CBUACTIVE | CBU active | TRUE, FALSE |
CBUACTDT | CBU activation date | Character string |
CBUEXPDT | CBU expiration date | Character string |
CBUTESTAR | CBU tests left | Number |
CBUREALAL | Real CBU activation available | TRUE, FALSE |
PRUNTYPE | Processor running time type, hwmca_determined_*, whether the processor running time is dynamically determined by the system or set to a constant value by the user | SYSTEM, USER |
PRUNTIME | Processor running time (milliseconds), the amount of continuous time allowed for logical processors to perform jobs on shared processors | Number |
PRUNTSEW | Processor running time slice end wait behavior, determines whether CPC Images lose their share of running time when they enter a wait state | TRUE, FALSE |
OOCINST | On/Off Capacity on Demand (On/Off CoD) installed | TRUE, FALSE |
OOCACT | On/Off Capacity on Demand (On/Off CoD) activated | TRUE, FALSE |
OOCENAB | On/Off Capacity on Demand (On/Off CoD) enabled | TRUE, FALSE |
OOCADT | On/Off Capacity on Demand (On/Off CoD) activation date | Character string |
PCPCSWM | Permanent CPC software model | Character string |
PPBPSWM | Permanent plus billable processor software model | Character string |
PPTPSWM | Permanent plus all temporary processor software model | Character string |
PCPCMSU | Permanent CPC MSU (millions of service units) value | Number |
PPBPMSU | Permanent plus billable processor MSU value | Number |
PPTPMSU | Permanent plus all temporary processor MSU value | Number |
NUMGPP | Number of General Purpose (GP) processors | Number |
NUMSAP | Number of Service Assist (SAP) processors | Number |
NUMIFAP | Number of Applications Assist (AAP) processors | Number |
NUMIFLP | Number of Integrated Facility for LINUX (IFL) processors | Number |
NUMICFP | Number of Internal Coupling Facility (ICF) processors | Number |
NUMIIPP | Number of Integrated Information processors (zIIP) | Number |
NUMFLTYP | Number of faulty processors | Number |
NUMSPARE | Number of spare processors | Number |
NUMPENDP | Number of processors pending activation | Number |
CAPCHGALLWD | Temporary Capacity change allowed | TRUE/FALSE |
DGRSTAT | Degraded indicator; see hwmca_degraded_* | NOTDEGRADED, MEM, MBA, NODE, RING, CBU, MRU, AMBIENT, MRUIML |
CPCNAME | Name of the CPC for this image | Character string |
OSNAME | Operating System name in this image, if known (such as MVS sysname) | Character string |
OSTYPE | Operating System type, if known | Character string |
OSLEVEL | Level of the Operating System | Character string |
SYSPLEX | MVS Sysplex name | Character string |
CLUSTER | LPAR cluster name | Character string |
PARTITIONID | Partition identifier | Number |
DEFCAP | Defined Capacity (MSUs) | Number |
SGPIPW | Initial processing weight for shared General Purpose processors | Number |
SGPIPWCAP | Initial processing weight for shared General Purpose processors is a Cap | TRUE/FALSE |
SGPPWMIN | Minimum weight for shared General Purpose processors | Number |
SGPPWMAX | Maximum weight for shared General Purpose processors | Number |
SGPPW | Current weight for shared General Purpose processors | Number |
SGPPWCAP | Current weight for shared General Purpose processors is a Cap | TRUE/FALSE |
WLM | WLM (WorkLoad Manager) is allowed to change the processing weight | TRUE/FALSE |
IFAIPW | Initial processing weight for shared Application Assist processors | Number |
IFAIPWCAP | Initial processing weight for shared Application Assist processors is a Cap | TRUE/FALSE |
IFAPWMIN | Minimum weight for shared Application Assist processors | Number |
IFAPWMAX | Maximum weight for shared Application Assist processors | Number |
IFAPW | Current weight for shared Application Assist processors | Number |
IFAPWCAP | Current weight for shared Application Assist processors is a Cap | TRUE/FALSE |
IFLIPW | Initial processing weight for shared Integrated Facility for LINUX processors | Number |
IFLIPWCAP | Initial processing weight for shared Integrated Facility for LINUX processors is a Cap | TRUE/FALSE |
IFLPWMIN | Minimum weight for shared Integrated Facility for LINUX processors | Number |
IFLPWMAX | Maximum weight for shared Integrated Facility for LINUX processors | Number |
IFLPW | Current weight for shared Integrated Facility for LINUX processors | Number |
IFLPWCAP | Current weight for shared Integrated Facility for LINUX processors is a Cap | TRUE/FALSE |
ICFIPW | Initial processing weight for shared Internal Coupling Facility processors | Number |
ICFIPWCAP | Initial processing weight for shared Internal Coupling Facility processors is a Cap | TRUE/FALSE |
ICFPWMIN | Minimum weight for shared Internal Coupling Facility processors | Number |
ICFPWMAX | Maximum weight for shared Internal Coupling Facility processors | Number |
ICFPW | Current weight for shared Internal Coupling Facility processors | Number |
ICFPWCAP | Current weight for shared Internal Coupling Facility processors is a Cap | TRUE/FALSE |
IIPIPW | Initial processing weight for shared Integrated Information processors | Number |
IIPIPWCAP | Initial processing weight for shared Integrated Information processors is a Cap | TRUE/FALSE |
IIPPWMIN | Minimum weight for shared Integrated Information processors | Number |
IIPPWMAX | Maximum weight for shared Integrated Information processors | Number |
IIPPW | Current weight for shared Integrated Information processors | Number |
IIPPWCAP | Current weight for shared Integrated Information processors is a Cap | TRUE/FALSE |
IPLTOKEN | IPL Token | Character string |
PSWS | Program Status Words (PSWs) | Character string |
GROUPPROFILECAPACITY | Workload unit capacity for the group profile associated with an image | Number |
RECID | Record Identifier of a Capacity Record | Character string |
RECTYPE | Type of Capacity Record | CBU, OOCOD, PLANNEDEVENT, LOANER |
ACTSTAT | Status of the Capacity Record | NOTACTIVATED, REAL, TEST, CANBEACTIVATED |
ACTDATE | Activation date of the Capacity Record | Character string |
EXPDATE | Expiration date of the Capacity Record | Character string |
ACTEXP | Expiration date of the additional capacity provided by the Capacity Record | Character string |
MAXRADS | Maximum real additional capacity days allowed by the Capacity Record | Number |
MAXTADS | Maximum test additional capacity days allowed by the Capacity Record | Number |
REMRADS | Remaining real additional capacity days allowed by the Capacity Record | Number |
REMTADS | Remaining test additional capacity days allowed by the Capacity Record | Number |
OOCODREC | Retrieve the Capacity Record, which is returned as a XML string | Character string |
IOCDS | IOCDS for the Reset Activation Profile | Character string |
IPLADDRESS | IPL Address for the Image Activation Profile | Character string |
IPLPARM | IPL Parameter for the Image Activation Profile | Character string |
IPLTYPE | IPL type for the image or load activation profile | STANDARD, SCSI, SCSIDUMP |
WWPORTNAME | Worldwide port name | Character string |
BOOTPGMSELECTOR | Boot program selector | Number |
LUNUM | Logical unit number for the image or load activation profile | Character string |
BOOTRECBLKADDR | Boot record logical block address value for the image or load activation profile. | Character string |
OPSYSLOADPARM | Operating system specific load parameters for the image or load activation profile | Character string |
GROUPPROFNAME | Name of the group capacity profile that is to be used for the CPC Image object activated with the image activation profile | Character string |
LOADATACTIVATION | The CPC Image object activated with this image activation profile will be loaded (IPLed) at the end of the activation | TRUE/FALSE |
CENTRALSTOR | The initial amount of central storage (in megabytes) to be used for the CPC Image object activated with this image activation profile | Number |
RESCENTRALSTOR | The reserved amount of central storage (in megabytes) to be used for the CPC Image object activated with this image activation profile | Number |
EXPANDEDSTOR | The initial amount of expanded storage (in megabytes) to be used for the CPC Image object activated with this image activation profile | Number |
RESEXPANDEDSTOR | The reserved amount of expanded storage (in megabytes) to be used for the CPC Image object activated with this image activation profile | Number |
NUMGPP2 | The number of dedicated general purpose processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESGPP2 | The number of reserved dedicated general purpose processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMIFA | The number of dedicated Application Assist processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESIFA | The number of reserved dedicated Application Assist processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMIFL | The number of dedicated Integrated Facility for LINUX processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESIFL | The number of reserved dedicated Integrated Facility for LINUX processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMICF | The number of dedicated Internal Coupling Facility processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESICF | The number of reserved dedicated Internal Coupling Facility processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMZIIP | The number of dedicated Integrated Information processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESZIIP | The number of reserved dedicated Integrated Information processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMSHAREDGPP | The number of shared general purpose processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESSHAREDGPP | The number of reserved shared general purpose processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMSHAREDIFA | The number of shared Appliction Assist processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESSHAREDIFA | The number of reserved shared Application Assist processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMSHAREDIFL | The number of shared Integrated Facility for LINUX processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESSHAREDIFL | The number of reserved shared Integrated Facility for LINUX processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMICF | The number of dedicated Internal Coupling Facility processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESICF | The number of reserved dedicated Internal Coupling Facility processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMZIIP | The number of dedicated Integrated Information processors to be used for the CPC Image object activated with this image activation profile | Number |
NUMRESZIIP | The number of reserved dedicated Integrated Information processors to be used for the CPC Image object activated with this image activation profile | Number |