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, or a user-defined image group. This facilitates subsequent services to perform operations related to that CPC, image, capacity record, activation profile, or a user-defined image group.

BCPii limits the total number of system-wide connections from all BCPii users to be no more than 4096 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.

Start of change 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. End of change

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.