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 (QZCAREFC, QzcaRefreshClientInfo) 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 4 through 45 |
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 may be an IPv4 or IPv6 address.
An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the 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. |
TCP1901 E | Internet address &2 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. |
[ Back to top | Client Management Support APIs | APIs by category ]