iSeries™ Access for Windows® does not require pre-configuration of an iSeries server connection to connect to and use that system. For this reason, programs that need to connect to an iSeries server (either explicitly, by calling cwbCO_Connect, or implicitly, as the result of a call to a different API such as cwbRC_RunCmd) do not need to check to see if the connection has been pre-configured. Therefore, the above API no longer should be necessary.
Most iSeries Access for Windows APIs work with iSeries System Objects, rather than with iSeries server names. There can be multiple iSeries System Objects created and connected to the same iSeries server within the same process. The cwbCO_IsSystemConnected API will return an indication of whether at least one System Object is connected to the iSeries server, within the current process. The cwbCO_IsConnected API is used to determine if a specific iSeries System Object is connected.
Most iSeries Access for Windows APIs work with iSeries System Objects, rather than with iSeries server names. There can be multiple iSeries System Objects created and connected to the same iSeries server, within the same process, but using different user IDs. The cwbCO_GetUserID API will return the user ID of the first iSeries System Object, in the current process, for the specified iSeries server. The cwbCO_GetUserIDEx API will return the user ID for a specific iSeries System Object.
The behavior of these APIs is the same. However, use of the cwbCO_GetHostVersionEx API is more efficient.