com.ibm.cics.server
Class SoapFault

java.lang.Object
  extended bycom.ibm.cics.server.SoapFault

public class SoapFault
extends java.lang.Object

This class provides the Java interface to CICS SOAPFAULT API.


Field Summary
static int CLIENT
          Use for the faultcode when the fault is caused by the Client
static int RECEIVER
          Use for the faultcode when the fault is caused by the Receiver
static java.lang.String sccsid
           
static int SENDER
          Use for the faultcode when the fault is caused by the Sender
static int SERVER
          Use for the faultcode when the fault is caused by the Server
 
Constructor Summary
SoapFault()
           
 
Method Summary
static void addFaultstring(java.lang.String faultstring, java.lang.String natlang)
          Add a new faultstring to the fault that has been created.
static void addSubcode(java.lang.String subcode)
          Add a new subcode to the fault that has been created.
static void create(int faultcode, java.lang.String faultstring)
          Create a new soapfault.
static void create(int faultcode, java.lang.String faultstring, java.lang.String detail)
          Create a new soapfault.
static void create(int faultcode, java.lang.String faultstring, java.lang.String natlang, java.lang.String detail)
          Create a new soapfault.
static void create(int faultcode, java.lang.String faultstring, java.lang.String natlang, java.lang.String faultactor, java.lang.String role, java.lang.String detail)
          Create a new soapfault.
static void create(java.lang.String faultcodeString, java.lang.String faultstring, java.lang.String natlang, java.lang.String faultactor, java.lang.String role, java.lang.String detail)
          Create a new soapfault.
static void delete()
          Delete deletes a soapfault
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

sccsid

public static final java.lang.String sccsid
See Also:
Constant Field Values

SENDER

public static final int SENDER
Use for the faultcode when the fault is caused by the Sender

See Also:
Constant Field Values

RECEIVER

public static final int RECEIVER
Use for the faultcode when the fault is caused by the Receiver

See Also:
Constant Field Values

CLIENT

public static final int CLIENT
Use for the faultcode when the fault is caused by the Client

See Also:
Constant Field Values

SERVER

public static final int SERVER
Use for the faultcode when the fault is caused by the Server

See Also:
Constant Field Values
Constructor Detail

SoapFault

public SoapFault()
Method Detail

create

public static void create(int faultcode,
                          java.lang.String faultstring,
                          java.lang.String natlang,
                          java.lang.String faultactor,
                          java.lang.String role,
                          java.lang.String detail)
                   throws InvalidRequestException,
                          CCSIDErrorException,
                          LengthErrorException
Create a new soapfault.

Parameters:
faultcode - Use one of SENDER, RECEIVER, CLIENT or SERVER to specify the SOAP fault code.
faultstring - String describing the fault
natlang - the national language of the faultstring, xml:lang value.
faultactor - The soap actor that created the fault
role - The role a SOAP node was acting in when a fault occurs. This only appears in a SOAP 1.2 fault
detail - The application specific error data in namespace qualified tags.
Throws:
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

create

public static void create(int faultcode,
                          java.lang.String faultstring,
                          java.lang.String natlang,
                          java.lang.String detail)
                   throws InvalidRequestException,
                          CCSIDErrorException,
                          LengthErrorException
Create a new soapfault.

Parameters:
faultcode - Use one of SENDER, RECEIVER, CLIENT or SERVER to specify the SOAP fault code.
faultstring - String describing the fault
natlang - the national language of the faultstring, xml:lang value.
detail - The application specific error data in namespace qualified tags.
Throws:
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

create

public static void create(int faultcode,
                          java.lang.String faultstring,
                          java.lang.String detail)
                   throws InvalidRequestException,
                          CCSIDErrorException,
                          LengthErrorException
Create a new soapfault.

Parameters:
faultcode - Use one of SENDER, RECEIVER, CLIENT or SERVER to specify the SOAP fault code.
faultstring - String describing the fault
detail - The application specific error data in namespace qualified tags.
Throws:
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

create

public static void create(int faultcode,
                          java.lang.String faultstring)
                   throws InvalidRequestException,
                          CCSIDErrorException,
                          LengthErrorException
Create a new soapfault.

Parameters:
faultcode - Use one of SENDER, RECEIVER, CLIENT or SERVER to specify the SOAP fault code.
faultstring - String describing the fault
Throws:
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

create

public static void create(java.lang.String faultcodeString,
                          java.lang.String faultstring,
                          java.lang.String natlang,
                          java.lang.String faultactor,
                          java.lang.String role,
                          java.lang.String detail)
                   throws InvalidRequestException,
                          CCSIDErrorException,
                          LengthErrorException
Create a new soapfault.

Parameters:
faultcodeString - String for faultcode to use
faultstring - String describing the fault
natlang - the national language of the faultstring, xml:lang value.
faultactor - The soap actor that created the fault
role - The role a SOAP node was acting in when a fault occurs. This only appears in a SOAP 1.2 fault
detail - The application specific error data in namespace qualified tags.
Throws:
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

addFaultstring

public static void addFaultstring(java.lang.String faultstring,
                                  java.lang.String natlang)
                           throws RecordNotFoundException,
                                  InvalidRequestException,
                                  CCSIDErrorException,
                                  LengthErrorException
Add a new faultstring to the fault that has been created.

Parameters:
faultstring - The new faultstring to add to a fault
natlang - The national language of the faultstring
Throws:
RecordNotFoundException - A NOTFOUND occured
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

addSubcode

public static void addSubcode(java.lang.String subcode)
                       throws RecordNotFoundException,
                              InvalidRequestException,
                              CCSIDErrorException,
                              LengthErrorException
Add a new subcode to the fault that has been created.

Parameters:
subcode - The new subcode string to add to a fault
Throws:
RecordNotFoundException - A NOTFOUND occured
InvalidRequestException - An INVREQ occured
CCSIDErrorException
LengthErrorException - The length of one of the parameters was too large

delete

public static void delete()
                   throws RecordNotFoundException
Delete deletes a soapfault

Throws:
RecordNotFoundException - A NOTFOUND occured