Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

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 1 lists SOAP fault codes that the SRC VTA returns to the gateway client.

Table 1: 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.

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.

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.

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.

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.

Internally calling "terminateSessions" Method Name

Failed

 

See the fault code for the terminate

Sessions
method for more information.

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

Table 2: 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.

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
.