Refresh Client Information (QZCAREFC, QzcaRefreshClientInfo) API
Required Parameter Group:
1 | Client handle | Input | Char(12) |
2 | Information type | Input | Char(10) |
3 | Time out | Input | Binary(4) |
4 | Error code | I/O | Char(*) |
Service Program: QZCACLT
Default Public Authority: *EXCLUDE
Threadsafe: No
The client management support APIs have been deprecated. It is recommended that applications use the QIBM_QZCA_SNMPTRAP exit point to detect new clients and the snmpGet_v3(), snmpGetbulk_v3(), and snmpGetnext_v3() APIs to retrieve client information.
The Refresh Client Information (OPM, QZCAREFC; ILE, QzcaRefreshClientInfo) API allows applications to refresh hardware, software, or all information stored on the server with the information stored on the client.
Authorities and Locks
- API Public Authority
- *EXCLUDE
Required Parameter Group
- Client handle
- INPUT; CHAR(12)
A unique key to identify this managed node. This parameter was returned in the client handle assigned parameter on the Add Client API.
- Information type
- INPUT; CHAR(10)
The information that should be refreshed on the server.
*ALL Client details, hardware, and software information should be refreshed on the server. *HDW Only hardware information needs to be refreshed on the server. *SFW Only software information needs to be refreshed on the server.
- Time out
- INPUT; BINARY(4)
The amount of time to wait for a client response. The value specified is in units of seconds. Valid values are 1 through 100.
Note: This is not a time-out value for this API. It is a time-out for each SNMP call that this API makes to the client.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Error Messages
Message ID | Error Message Text |
---|---|
CPFA835 E | Time-out parameter not correct. |
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. |
CPF5E87 E | Information type not valid. |
CPF5E88 E | Parameter length not valid. |
CPF5E89 E | Client handle does not exist. |
CPF5E8E E | Unable to contact client. |
CPF5E94 E | Client information not refreshed. |
CPF5E95 E | Internal processing error. |
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. |
API introduced: V3R6
[ Back to top | Client Management Support APIs | APIs by category ]