getSubType()

Retrieve the exception subtype from the exception object.

Syntax

String getSubType()
 

Return values

A String that contains the exception subtype for the current exception. For more information on valid exception subtypes, see the Notes section.

Notes

The getSubType() method retrieves the exception subtype for the current exception. For exceptions whose exception type does not adequately identify the cause of the exception, the exception subtype can provide more information. The following exception types most commonly use exception subtypes:


AppTimeOut
Aconnector was unable to complete communication with its application.
AppLogOnFailure
Aconnector was unable to log in to the application.
AppRetrieveByContentFailed
A Retrieve by non-key values, performed on the application, was not able to find any match.
AppMultipleHits
An application found and retrieved more than one entity in response to a Retrieve request.
AppBusObjDoesNotExist
A Retrieve operation was performed on the application, but the entity that the business object represents does not exist in the application database.
AppRequestNotYetSent
In the case of a parallel connector agent, the request was queued up in the agent master but never got dispatched to the application; therefore, you can resend the request. For more information, see Unsent service call requests.
ServiceCallTransportException
There was an error in the transport, and it cannot be determined with certainty whether the request reached the application. For more information, see Handling runtime transport-related exceptions.
AppUnknown
Any type of error that is not one of the other subtypes. If this exception subtype is present, the application operation requested in the service call might be finished or not finished.

For more information, see Handling particular service-call exceptions.

Important:
The AppTimeOut, AppLogOnFailure, AppRetrieveByContent, AppMultipleHits, and AppUnknown exception subtypes correspond to outcome-status values that an adapter can return to indicate the cause of failure. Older adapters might not support all of the corresponding outcome-status values. Make sure you rigorously test any adapters that are bound to your collaboration with the Test Connector tool to determine the actual outcome-status values they return.

Examples

This section provides examples of retrieve exception subtypes for the following exception types:

Copyright IBM Corp. 2003, 2004