Purpose
Create a new system object and return a
handle to it that can be used with subsequent calls. The system object has
many attributes that can be set or retrieved. SeeSystem object attributes for
more information.
Syntax
UINT CWB_ENTRY cwbCO_CreateSystem(
LPCSTR systemName,
cwbCO_SysHandle *system);
Parameters
- LPCSTR systemName - input
- Pointer to a buffer that contains the NULL-terminated name of the iSeries™ system.
This can be its host name, or the iSeries system's dotted-decimal IP address
itself. It must not be zero length and must not contain blanks. If the name
specified is not a valid iSeries system host name or IP address string (in
the form "nnn.nnn.nnn.nnn"), any connection attempt or security validation
attempt will fail.
- cwbCO_SysHandle *system - output
- The system object handle is returned in this parameter.
Return Codes
The following list shows common return
values:
- CWB_OK
- Successful completion.
- CWB_INVALID_POINTER
- One of the pointer parameters is NULL.
- CWB_INVALID_SYSNAME
- The system name is not valid.
- CWB_RESTRICTED_BY_POLICY
- A policy exists that prohibits the user from creating a system object
for a system not already defined in the System List.
- CWB_NON_REPRESENTABLE_UNICODE_CHAR
- One or more input Unicode characters have no representation in the codepage
that is being used.
Usage
When you are done using the system object,
you must call cwbCO_DeleteSystem to free resources the
system object is using. If you want to create a system object that is like
one you already have, use cwbCO_CreateSystemLike.