Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] 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 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
    .

    Modified: 2016-05-19