All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class tascomm.dts.DTSException 

java.lang.Object
   |
   +----java.lang.Throwable
           |
           +----java.lang.Exception
                   |
                   +----tascomm.dts.DTSException
public class DTSException
extends Exception
Signals that an exception of some sort has occurred during the processing of the requested DTS transaction. This class can be used to handle all failure conditions within DTS transactions. More detailed subclasses for handling specific types of DTS exceptions are also available. For example, if your application needs different processing for network communication failure conditions, it can catch CommunicationException. These exceptions are derived from the Java Exception class. They must be catched by the calling application to prevent the application from terminating.

Version:
1.00, 97/10/21
Author:
Juha Lehtovirta
See Also:
UnknownNodeException, UnknownHandlerException, CommunicationException, SecurityViolationException, CriticalException, DTSMessage

Method Index

o getMessage()
Returns the complete error reply message of this DTSException.
o getReturnCode()
Returns the numeric two-byte error code of this DTSException.

Methods

o getMessage 
 public String getMessage()
Returns the complete error reply message of this DTSException. The reply is returned either by the local communication interface or the remote DTS system. For a comprehensive list of possible return codes and messages, refer to the documentation of the DTS implementation running on the target system.

The following DTS error responses are common for all DTS platforms:

10 Receiver node unknown (UnknownNodeException)
20 Remote subroutine does not exist (UnknownHandlerException)
3x Network communication error (CommunicationException)
40 Invalid DTS header parameters (CriticalException)
70 Security violation (SecurityViolationException)

Return codes starting with number 3 are used to indicate failures in network communication between DTS systems. The second digit depends on the underlying communication protocol in question. The actual message text of the communication error reply provides further information about the error condition.

Returns:
the complete error reply message of this DTSException, including both DTS error code and supplemental error text.
Overrides:
getMessage in class Throwable
o getReturnCode 
 public int getReturnCode()
Returns the numeric two-byte error code of this DTSException. The code is returned either by the local communication interface or the remote DTS system. For a comprehensive list of possible return codes, refer to the documentation of the DTS implementation running on the target system.

Returns:
the numeric two-byte error code of this DTSException. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index