SOAP Fault Codes for the SRC Volume Tracking Application

When the SRC Volume Tracking Application (VTA) receives a Simple Object Access Protocol (SOAP) request that it cannot handle, it returns a SOAP fault message to the gateway client. This message contains a text string that specifies the SOAP fault code and a text string that provides additional information about the fault code.

Table 59 lists SOAP fault codes that the SRC VTA returns to the gateway client.

Table 59: SRC VTA Methods and SOAP Fault Codes

Method Name	Fault Code	Fault Description	Call Classification	Action	Notes
open Account	soapenv: Server.user Exception	java.lang.IllegalArgumentException: To open an account, an account value object is needed.	Failed	Verify that you passed appropriate values (as specified in the Web Services Description Language [WSDL] file) in the AccountData object.	This exception occurs when the AccountData object is empty.
		Rollback failed:	Failed	Contact the gateway administrator.	This exception occurs when the database connection has timed out.
		Transaction failed	Failed	Contact the gateway administrator.	This exception occurs because the balance parameter is not set in the AccountData object or the database was down when the system was processing the transaction.
		javax.ejb.DuplicateKey Exception: Entity with primary key [jane2@virneo.net] already exists	Failed	Verify that the combination of the subscriberID and accountName is unique because it is the primary key.	Indicates that the client attempted to insert a name or subscriberID that is already in the database.
		javax.ejb.Create Exception: Error checking if entity exists:org.jboss.util. NestedSQLException: Unable to get managed connection for vta-Quota/datasource; - nested throwable: (javax.resource.ResourceException: Unable to get managed connection for vta-Quota/datasource)	Failed	Contact the gateway administrator.	Indicates that the database is not running.
		javax.ejb.Create Exception: Could not create entity: com.mysql. jdbc.exceptions.jdbc4. MySQLIntegrityConstraint ViolationException: Column 'LAST_UPDATE_TIME' cannot be null	Failed	Verify that the value of the last updated time is not null.
		javax.ejb.EJBException: Failed to update database. The transaction was rolled back. Abandoning unprocessed event: net.juniper.smgt.vta. quotadp.UpdateFailed Exception: Db-engine failed to process event: javax.ejb.Transaction RolledbackLocal Exception: To get an account, a subscriberID is needed.	Failed	Contact the gateway administrator.	Indicates that the subscriberID was missing in the AccountData object when the client was creating an account.
change Balance	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To change the balance of an account, a subscriberID is needed	Failed	Verify and pass the existing subscriberID and accountName to update the balance of an account.
		javax.ejb.ObjectNot FoundException: No such entity!	Failed	Verify and pass the existing or valid subscriberID and accountName.
		net.juniper.smgt.vta.data mgr.im.ChangeAccount Exception: Cannot change balance for closed account	Failed	Contact the gateway administrator.	Indicates that the account is already closed.
		javax.ejb.DuplicateKey Exception:Create balance change failed. DuplicateKeyException: subscriberID= Test accountName= BoughtQuota date= 1363847398695	Failed	Contact the gateway administrator.	This exception occurs when an entity EJB object cannot be created because an object with the same key already exists.
		Rollback failed:	Failed	Contact the gateway administrator.	This exception occurs when the database connection has timed out.
		Transaction failed	Failed	Contact the gateway administrator.	This exception occurs if the database was down when the system was processing the request message.
		javax.ejb.EJBException: Failed to update database. The transaction was rolled back. Abandoning unprocessed event: net.juniper.smgt.vta. quotadp.UpdateFailed Exception: Db-engine failed to process event: javax.ejb.Transaction RolledbackLocal Exception: To get an account, a subscriberID is needed.	Failed	Contact the gateway administrator.	Indicates that the subscriberID was missing when the client was modifying the account balance.
change Status	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To change the status of an account, a subscriberID/ an accountName object is needed.	Failed	Verify and pass the existing accountName and subscriberID.
		Rollback failed:	Failed	Contact the gateway administrator.	This exception occurs when the database connection has timed out.
		Transaction failed	Failed	Contact the gateway administrator.	This exception occurs if the database was down when the system was processing the request message.
		javax.ejb.ObjectNotFoundException: No such entity!	Failed	Verify and pass the existing or valid subscriberID and accountName.
cleanUp	soapenv: Server.user Exception	net.juniper.smgt.vta.data mgr.im.DeleteSession Exception: The following closed sessions could not be deleted because they have not subsequently been stopped (format is 'subscriberId:sessionId: sessionIdQualifier'):	Failed	Verify that the session is already closed or stopped.
cleanUp	soapenv: Server.user Exception	net.juniper.smgt.vta.data mgr.im.DeleteSession Exception: The following sessions could not be deleted because they are neither closed nor stopped (format is 'subscriberId:sessionId: sessionIdQualifier= status'):	Failed	Verify that the session is already closed or stopped.
close Account	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To change an account, a subscriberID/ an accountName object is needed.	Failed	Verify and pass the existing accountName and subscriberID.
		javax.ejb.ObjectNotFound Exception: No such entity!	Failed	Verify and pass the existing or valid subscriberID and accountName.
		Internally calling "changeStatus" Method Name	Failed		See the fault codes for the change Status method for more information.
close Account ByName	soapenv: Server.user Exception	Internally calling "changeStatus" Method Name	Failed		See the fault codes for the change Status method for more information.
close Account OfSubs criber	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To close accounts for a subscriber, a subscriberID is needed	Failed	Verify and pass the existing accountName and subscriberID.
close Account OfSubs criber	soapenv: Server.user Exception	Internally calling "changeStatus" Method Name	Failed		See the fault codes for the change Status method for more information.
delete Account	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To change an account, a subscriberID/ an accountName object is needed.	Failed	Verify and pass the existing accountName and subscriberID.
		javax.ejb.ObjectNotFound Exception: No such entity!	Failed	Verify and pass the existing or valid subscriberID and accountName.
		net.juniper.smgt.vta.data mgr.im.DeleteAccount Exception: Cannot delete unclosed account.vta-Quota/AccountLocal: [.JJ.ACC.]	Failed	Close the account before deleting it.
delete Accounts ByName	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete accounts by accountName, an accountName is needed	Failed	Verify and pass the existing accountName to delete an account.
delete Accounts OfSubs criber	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete accounts by subscriber, a subscriberID is needed	Failed	Verify and pass the existing subscriberID to delete an account.
delete Balance Changes	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete balance changes, start time cannot be greater than end time.	Failed	Verify that the start time is not later than the end time.
		java.lang.IllegalArgument Exception: To delete balance changes, account or time period should be specified.	Failed	Verify and pass the existing accountName or time period to delete the balance of an account.
		java.lang.IllegalArgument Exception: To delete balance changes, When account names are specified, subscriberID cannot be null.	Failed	Verify and pass the valid subscriberID when the account names are specified.
delete Session	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete a session, a subscriberID is needed	Failed	Verify and pass the existing subscriberID to delete the session.
		java.lang.IllegalArgument Exception: To delete a session, a sessionId is needed	Failed	Verify and pass the existing sessionId to delete the session.
		net.juniper.smgt.vta.data mgr.im.DeleteSession Exception: The following sessions could not be deleted because they are neither closed nor stopped (format is 'subscriberId:sessionId: sessionIdQualifier= status'):	Failed	Verify that the sessions are neither closed nor stopped before deleting them.
delete Session Balance Changes	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete session balance changes, start time cannot be greater than end time.	Failed	Verify that the start time is not later than the end time.
		java.lang.IllegalArgument Exception: To delete session balance changes, an account or time period should be specified.	Failed	Verify and pass the existing accountName or time period.
		java.lang.IllegalArgument Exception: To delete session balance changes, when account names are specified, subscriberID cannot be null.	Failed	Verify and pass the valid subscriberID when the account names are specified.
delete Sessions	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To delete sessions by sessionId, a sessionId is needed.	Failed	Verify that the valid sessionId was passed to delete the closed sessions.
		net.juniper.smgt.vta.data mgr.im.DeleteSession Exception: The following sessions could not be deleted because they are neither closed nor stopped (format is 'subscriberId:sessionId: sessionIdQualifier= status'):	Failed	Verify that the sessions are neither closed nor stopped before deleting them.
		java.lang.IllegalArgument Exception: To delete session balance changes, start time cannot be greater than end time.	Failed	Verify that the start time is not later than the end time.
		java.lang.IllegalArgument Exception: To delete sessions, a subscriberID or a time period should be specified.	Failed	Verify and pass the existing subscriberID or time period.
get Account	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To get an account, a subscriberID/ accountName is needed.	Failed	Verify and pass the existing or valid subscriberID and accountName.
get Accounts ByName	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To get an account, an accountName is needed.	Failed	Verify and pass the existing or valid accountName.
get Accounts OfSubs criber	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To get accounts of a subscriber, a subscriberID is needed	Failed	Verify and pass the existing or valid subscriberID.
getAll Balance Changes	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To get balance changes, subscriberID and accountName should both be null or not null.	Failed	Verify that both the subscriberID and accountName are null or not null.
		java.lang.IllegalArgument Exception: To get balance changes, start time cannot greater than end time.	Failed	Verify that the start time is not later than the end time.
		java.lang.IllegalArgument Exception: To get balance changes, an account or a time period should be specified.	Failed	Verify and pass the existing or valid accountName or time period to get the balance changes.
get Balance Changes	soapenv: Server.user Exception	Internally calling "getAllBalanceChanges " Method name	Failed		See the fault codes for the getAll Balance Changes method for more information.
get Session	soapenv: Server.user Exception	javax.ejb.ObjectNotFound Exception: No such entity!	Failed	Verify and pass a valid accountName to get the session details.
get Session	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To change an account, a subscriberID/ an accountName object is needed.	Failed	Verify and pass the existing or valid subscriberID and accountNameto get the session details.
get Session Balance Change	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To get a specific session balance change, a subscriberID/ an accountName /a sessionId object is needed.	Failed	Verify and pass a valid subscriberID or accountName or sessionId to get the session balance change details.
get Session Balance Change	soapenv: Server.user Exception	java.lang.IllegalArgument Exception: To get session balance changes by a session, a sessionId is needed.	Failed	Verify and pass the existing or valid sessionId to get the session balance change details.
get Session Balance Changes	soapenv: Server.user Exception	Internally calling "getAllBalanceChanges " Method name	Failed		See the fault codes for the getAll Balance Changes method for more information.
get Sessions	soapenv: Server.user Exception	java.lang.IllegalArgument Exception:To get sessions, a sessionId is needed.	Failed	Verify and pass the existing or valid sessionId.
		java.lang.IllegalArgument Exception: To get sessions for a subscriber, a subscriberID is needed.	Failed	Verify and pass the existing or valid subscriberID.
		java.lang.IllegalArgument Exception: To get sessions, start time cannot greater than end time.	Failed	Verify that the start time is not later than the end time.
terminate Sessions	soapenv: Server.user Exception	javax.ejb.EJBException: Failed to update database. The transaction was rolled back. Abandoning unprocessed event: net.juniper.smgt.vta. quotadp.UpdateFailed Exception: Db-engine failed to process event: javax.ejb.Transaction RolledbackLocalException: To get an account, a subscriberID is needed.	Failed	Verify that the valid subscriberID was passed to terminate the subscriber sessions.
topUp Balance	soapenv: Server.user Exception	Internally calling "terminateSessions" Method Name	Failed		See the fault code for the terminate Sessions method for more information.
update Accounts	Server.user Exception	java.lang.IllegalArgument Exception: accountName must not be null.	Failed	Verify and pass the existing or valid accountName to update the account.
update Accounts	Server.user Exception	Internally calling "terminateSessions" Method Name	Failed		See the fault code for the terminate Sessions method for more information.

Table 60 lists fault codes that are common to the methods associated with the SRC Volume Tracking Application SOAP interface.

Table 60: VTA SOAP Fault Codes Common to Methods

Fault Code	Call Classification	Action	Notes
javax.ejb.Remove Exception	Failed	Contact the gateway administrator.	This exception occurs if the enterprise bean or container does not allow you to remove the EJB object. For more details, see http://docs.oracle. com/javaee/6/api/ javax/ejb/Remove Exception.html.
Server.userException	Failed	Verify that you passed correct arguments in the API.	This exception occurs when the arguments passed in the API does not match the actual arguments in the API.

Fault Code

Call Classification

Action

Notes

javax.ejb.Remove
Exception

Failed

Contact the gateway administrator.

This exception occurs if the enterprise bean or container does not allow you to remove the EJB object.

For more details, see http://docs.oracle.
com/javaee/6/api/
javax/ejb/Remove
Exception.html.

Server.userException

Failed

Verify that you passed correct arguments in the API.

This exception occurs when the arguments passed in the API does not match the actual arguments in the API.

javax.ejb.Finder
Exception

Failed

Contact the gateway administrator.

Indicates that the client failed to find the requested EJB object.

For more details, see http://docs.oracle.
com/javaee/6/api/
javax/ejb/Finder
Exception.html.

SOAP Fault Codes for the SRC Volume Tracking Application

Related Documentation