HWILIST — Retrieve HMC and BCPii configuration-related information

Call the HWILIST service to retrieve hardware management console (HMC) and BCPii configuration-related information. Depending on which information is requested, the data returned by this service can be used on subsequent BCPii service calls to take the following actions:
  • Connect to a central processor complex (CPC), image (LPAR), capacity record (CAPREC), reset activation profile, image activation profile, load activation profile, group profile or LPAR Capacity group using the HWICONN API.
  • Register for the proper events (HWIEVENT) using the HWIEVENT API.
  • Connect to the local CPC or image.
  • Connect to a user-defined image group.
Note: A returned CPC name does not guarantee that an application will be able to connect to that particular resource using the HWICONN API. Connecting to a CPC involves setup issues such as setting up connectivity to a support element and defining the necessary BCPii community name on both the support element and the security product. For more information about the steps that need to be completed before connectivity to a particular CPC is complete, see Setting up connectivity to the support element and Community name defined in the security product for each CPC. Start of changeIn addition, if the CPC configuration changes, the previously returned list may include CPC names which are no longer valid. A new HWILIST should be issued to retrieve the most current information.End of change