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 profileStart of change, group profile or LPAR Capacity groupEnd of change 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.