| 1 | Client handle assigned | Output | Char(12) |
| 2 | Client handle requested | Input | Char(12) |
| 3 | Client ID | Input | Char(*) |
| 4 | Community name | Input | Char(*) |
| 5 | Connectivity information | Input | Char(*) |
| 6 | Error code | I/O | Char(*) |
The Add Client (OPM, QZCAADDC; ILE, QzcaAddClient) API allows applications to make clients known to the server. Use the Refresh Client Information API to retrieve more information about the client.
New clients have a system status of unknown until the Update Client Information (QZCAUPDC, QzcaUpdateClientInfo) API is used to indicate *ACTIVE or *INACTIVE.
A unique key to identify this managed client. This parameter returns either the value of the client handle requested if one was specified, or a generated value for this client if one was not specified.
A unique key to identify this managed client. For ILE, this parameter can be omitted. If it is omitted a unique key is generated by this API. A NULL-terminated string is required if it is specified. For OPM, this is a required parameter. If this parameter is less than 12 bytes, it is padded with hexadecimal zeros.
An administratively assigned system name for this managed client. By convention, this is the client's fully qualified domain name. A NULL-terminated string is required for this parameter. The length of client ID is 1 through 255.
A relationship between an SNMP agent and a set of SNMP managers that is used for authentication, access-control, and proxy. A NULL-terminated string is required for this parameter. The length of the community name is 1 through 255.
The connection information used to contact the client. For the format of this parameter, see Format for Connectivity Information Parameter.
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
The connectivity information parameter has the following format. For detailed descriptions of the fields in the table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(1) | Node type |
| 1 | 1 | CHAR(3) | Reserved |
| 4 | 4 | BINARY(4) | Length of node name |
| 8 | 8 | CHAR(*) | Node name |
Length of node name. The length of the node name.
Valid values follow:
| Node Type | Description |
| 3 | The length is 7 through 15 |
Node name. The name of the node. The format is dependent on the node type.
Valid values follow:
| Node Type | Description |
| 3 | An internet address. The internet address is
specified in the form nnn.nnn.nnn.nnn, where nnn is an integer ranging from 0
through 255.
Note: An internet address of 000.000.000.000 or 255.255.255.255 is treated as an invalid address. |
Node type. The type of connection.
The following values are valid:
| Node Type | Description |
| 3 | Host address |
Reserved. An ignored field.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C1E E | Required parameter &1 omitted. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPF5E81 E | Client ID already exists. |
| CPF5E82 E | Client handle already exists. |
| CPF5E84 E | Node type not valid. |
| CPF5E85 E | Node name length not valid. |
| CPF5E88 E | Parameter length not valid. |
| CPF5E95 E | Internal processing error. |
| CPF96B8 E | Internet address &1 not valid. |
| CPF9845 E | Error occurred while opening file &1. |
| CPF9846 E | Error while processing file &1 in library &2. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| Top | Client Management Support APIs | APIs by category |