Return codes

When the service completes, one of the following values is returned to the caller:

Return Code in Hexadecimal Equate Symbol	Meaning and Action
00000000 HWIUSS_RC_OK	Meaning: Successful completion. Action: None.
00000001 HWIUSS_RC_PARTIAL_DATA	Meaning: The provided buffer was not large enough to contain all the event data. Action: The request is successful. To receive all the event data, buffer the size of which is at least BytesNeeded must be provided.
00000002 HWIUSS_RC_EVENTS_LOST	Meaning: At least one event was not returned because the program has not been retrieving events timely. Action: The request is successful. To receive all events, the program must make this service call more often or reduce the number of events requested.
00000003 HWIUSS_RC_TIMEOUT	Meaning: No events have occurred in the requested time interval. Action: The request is successful.
00001001 HWIUSS_RC_UNAVAILABLE	Meaning: This error is returned for one of the following reasons, which is written to the diag_commerr field of the DiagArea: CEA (Common Event Adapter) communication is unavailable. (reason x'100') Write access to a socket is denied. (reason x'103') Services are failing in the CEA Server. (reason x'111') Action: The request is rejected. Confirm that the CEA address space has been started and try the request again.
00001004 HWIUSS_RC_BAD_DELIVERYTOKEN	Meaning: The provided delivery token is not valid. Action: The request is rejected. This is a probable coding error.
00001005 HWIUSS_RC_SMALL_BUFFER	Meaning: The provided buffer is not large enough to contain the event data. Action: The request is rejected. This is a probable coding error. Provide a larger buffer and try the request again.
00001008 HWIUSS_RC_COMM_FAILURE	Meaning: An error occurred in z/OS UNIX socket processing. Action: The request is rejected. Verify that the file system is properly configured for z/OS UNIX sockets and try this request again.
00001009 HWIUSS_RC_CEA_INTERNAL_ERROR	Meaning: An internal CEA processing error has occurred. Action: The request is rejected. Consult the DiagArea for the details about this error. If the error persists, contact the IBM Support Center.
0000100A HWIUSS_RC_INPUT_PTR_IS_NULL	Meaning: A null input pointer was found. Action: The request is rejected. Pass a valid pointer to the API and try this request again.
0FFFFFFF HWIUSS_RC_UNEXPECTED_ERROR	Meaning: An unexpected error has occurred. Action: The request is rejected. Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.