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.
00001000 HWIUSS_RC_HWIEVENT_FAILURE	Meaning: The resultant HWIEVENT service call failed. Action: The request is rejected. The DiagArea contains the failure data. Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.
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.
00001002 HWIUSS_RC_NO_AUTH	Meaning: This error is returned for one of the following reasons, which is written to the diag_commerr field of the DiagArea: The program is not authorized to access CEA services. (reason x'102') The program is not authorized to monitor the requested event. (reason x'10E') Action: The request is rejected. Determine whether the program needs access to CEA services. If so, grant the required access to the proper resources and try this request again. See Setting up event notification for BCPii z/OS UNIX applications for further information.
00001004 HWIUSS_RC_BAD_DELIVERYTOKEN	Meaning: The provided delivery token is not valid. Action: The request is rejected. This is a probable coding error.
00001006 HWIUSS_RC_SAF_NOTDEF_EVENT	Meaning: The SAF profile CEA.SUBSCRIBE.ENF_0068* is not defined. Action: The request is rejected. Add the proper CEA.SUBSCRIBE.ENF_0068* profile to the SERVAUTH class and try this 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.