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.
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: The program is not authorized to access CEA services. Action: The request is rejected. Determine if 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.
00001003 HWIUSS_RC_MAX_CLIENTS	Meaning: The maximum number of CEA clients has been reached. Action: The request is rejected. Determine if other CEA clients can be stopped. If so, try this request again.
00001007 HWIUSS_RC_SAF_NOTDEF_CONNECT	Meaning: The SAF profile CEA.CONNECT is not defined. Action: The request is rejected. Add the CEA.CONNECT 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. Consult the DiagArea for more specifics regarding the error. Search problem reporting data bases for a fix for the problem. If no fix exists, contact the IBM Support Center.