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 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 ]