HWICONN — Establish a BCPii connection

Call the HWICONN service to establish a logical connection between the application and a central processor complex (CPC), a CPC image (LPAR), a capacity record, different types of activation profiles, a user-defined image groupStart of change, a group profile or an LPAR Capacity groupEnd of change. This facilitates subsequent services to perform operations that are related to that CPC, image, capacity record, activation profile, a user-defined image groupStart of change, a group profile or an LPAR Capacity groupEnd of change.

BCPii limits the total number of system-wide connections from all BCPii users to be no more than Start of change5000End of change simultaneous connections.

Note: A connection remains active until one of the following occurs:
  • A Disconnect service call (HWIDISC) has been invoked.
  • A parent connection has been disconnected.
  • A loss of connectivity to the associated CPC has been detected by BCPii.
  • The address space of the caller has terminated.
  • The current task of the caller has terminated if the connection has task affinity (TSO/E REXX or ISV-provided REXX execution environments).
  • The BCPii address space has terminated.

Under normal circumstances, a connection remains active indefinitely. Since there are a finite number of total BCPii connections available in the entire system, a BCPii application should disconnect any BCPii connection it no longer needs.

Note: BCPii requires the FACILITY class to be RACLIST-specified. BCPii also automatically transforms the following to all uppercase characters when building the profile names passed to the security product: CPC, image, and caprec values pointed to by the ConnectTypeValue_Ptr.