cwbCO_CreateSystem

Use the cwbCO_CreateSystem command.

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. See System 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 IBM i name. This can be its host name, or the IBM i dotted-decimal IP address itself. It must not be zero length and must not contain blanks. If the name specified is not a valid IBM i 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.