Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

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

Table 55: 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 56 lists fault codes that are common to the methods associated with the SRC Volume Tracking Application SOAP interface.

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

Related Documentation

Modified: 2017-08-03