Return Status Values

Error handling is provided via values known as Return Status values. On execution of all methods, an associated Return Status value indicates whether the method was successful or erroneous, and the reason for the error, if any.

The following table indicates the common return status classes for IsupMgr and IsupProbe methods, and their returned values.

The isOK() method can be used to check for successful completion.

Table 12-3 Probe Return Status Values

Status Class	Value	Reason
`InitStatus`	`NO_ERROR`	No error has occurred during Isupmgr initialization.
	`ALREADY_CREATED`	IsupMgr already exists.
	`NO_MORE_MEMORY`	Problem occurred during memory allocation for the IsupMgr.
	`NO_ISUP_CONFIG`	Access to the HP OpenCall SS7 ISUP configuration file has been denied.
	`BAD_ISUP_CONFIG`	Erroneous or missing configuration file provided for IsupMgr initialization.
	`INTERNAL_ERROR`	An internal HP OpenCall SS7 ISUP error has occurred.
`CnxStatus`	`NO_ERROR`	No error for connection.
	`CNX_CLOSED`	SS7 stack connection closed.
	`API_BUSY`	Switchover in progress.
	`INTERNAL_ERROR`	Internal HP OpenCall SS7 ISUP IPC error has occurred.
CreateStatus	`NO_ERROR`	Probe/connection created.
	`NO_MORE_MEMORY`	Problem occurred during memory allocation for the Probe object.
	`MAX_PROBE_NUMBER_ EXCEEDED`	Maximum number of Probes has been reached.
	`ALREADY_CREATED`	A Probe already exists for this LPC.
	`LPC_NOT_FOUND`	LPC not found in configuration file.
	`INVALID_CLASSNAME`	Unknown SS7 stack classname.
	`INVALID_SET_NAME`	An invalid name for the set of messages has been associated with a specific LPC.
	`WRONG_PROBE_TYPE`	Different Probe type declared in HP OpenCall SS7 ISUP configuration file.
	`INTERNAL_ERROR`	Internal HP OpenCall SS7 ISUP IPC error has occurred.
`DestroyStatus`	`NO_ERROR`	Probe/connection destroyed.
`DestroyStatus`	`ALREADY_DESTROYED`	Probe was previously destroyed.
OpenStatus	`NO_ERROR`	Probe/connection open.
	`NO_CONFIG`	Configuration file could not be accessed.
	`BAD_GLOBAL_CONFIG`	SS7 stack name not found in parsed configuration file. The classname should be checked.
	`CONNECT_INIT`	Connection attempt rejected.
	`API_BUSY`	High Availability switchover in progress.
	`ALREADY_OPEN`	Probe/connection is already open.
	`INTERNAL_ERROR`	Internal HP OpenCall SS7 ISUP IPC error has occurred.
	`BAD_CNX_TYPE`	Connection type is wrong (should be primary or secondary)
CloseStatus	`NO_ERROR`	Probe/connection closed.
	`PROBE_NOT_OPEN`	Probe object not connected to the SS7 stack.
	`ALREADY_CLOSED`	Probe object already closed.
	`IPC_SEND_FULL`	IPC socket to SS7 stack is congested.
	`CLOSE_FAILED`	Unable to close the SS7 stack connection.
	`INTERNAL_ERROR`	Internal HP OpenCall SS7 ISUP IPC error has occurred.

For information on return values related to creating and exchanging messages, refer to the IsupMgr(3) man page.

Return Status Values

Technical documentation

» Table of Contents

» Index