All Packages Class Hierarchy This Package Previous Next Index
Class com.ibm.as400.access.BaseDataQueue
java.lang.Object
|
+----com.ibm.as400.access.BaseDataQueue
- public abstract class BaseDataQueue
- extends Object
- implements Serializable
The BaseDataQueue class represents an AS/400 data queue object.
-
BaseDataQueue()
- Constructs a BaseDataQueue object.
-
BaseDataQueue(AS400, String)
- Constructs a BaseDataQueue object.
-
addDataQueueListener(DataQueueListener)
- Adds a listener to be notified when a data queue event occurs.
-
addObjectListener(ObjectListener)
- Adds a listener to be notified when an object event occurs.
-
addPropertyChangeListener(PropertyChangeListener)
- Adds a listener to be notified when the value of any bound property changes.
-
addVetoableChangeListener(VetoableChangeListener)
- Adds a listener to be notified when the value of any constrained property changes.
-
clear()
- Removes all entries from the data queue.
-
delete()
- Deletes the data queue.
-
getCcsid()
- Returns the CCSID used for the data in this data queue.
-
getDescription()
- Returns the text description of the data queue.
-
getForceToAuxiliaryStorage()
- Returns a value that indicates if entries are forced to auxiliary storage.
-
getMaxEntryLength()
- Returns the maximum entry length of the data queue.
-
getName()
- Returns the name of the data queue.
-
getPath()
- Returns the full integrated file system path name of the data queue.
-
getSaveSenderInformation()
- Returns whether sender information is stored with each data queue entry.
-
getSystem()
- Returns the AS400 object representing the system on which the data queue exists.
-
isFIFO()
- Returns a value that indicates if entries are read in FIFO order.
-
refreshAttributes()
- Refreshes the attributes of the data queue.
-
removeDataQueueListener(DataQueueListener)
- Removes a data queue listener.
-
removeObjectListener(ObjectListener)
- Removes a object listener.
-
removePropertyChangeListener(PropertyChangeListener)
- Removes a property change listener.
-
removeVetoableChangeListener(VetoableChangeListener)
- Removes a vetoable change listener.
-
setCcsid(int)
- Sets the CCSID to use for the data in this data queue.
-
setPath(String)
- Sets the fully qualified integrated file system path name of the data queue.
-
setSystem(AS400)
- Sets the system on which the data queue exists.
-
toString()
- Returns the String representation of this data queue object.
BaseDataQueue
public BaseDataQueue()
- Constructs a BaseDataQueue object. The system and path properties will need to be set before using any method requiring a connection to the AS/400.
BaseDataQueue
public BaseDataQueue(AS400 system,
String path)
- Constructs a BaseDataQueue object. It uses the specified system and path. Depending on how the AS400 object was constructed, the user may need to be prompted for the system name, user ID, or password when any method requiring a connection to the AS/400 is done.
- Parameters:
- system - The AS/400 system on which the data queue exists.
- path - The fully qualified integrated file system path name of the data queue.
addDataQueueListener
public void addDataQueueListener(DataQueueListener listener)
- Adds a listener to be notified when a data queue event occurs.
- Parameters:
- listener - The listener.
addObjectListener
public void addObjectListener(ObjectListener listener)
- Adds a listener to be notified when an object event occurs.
- Parameters:
- listener - The listener.
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)
- Adds a listener to be notified when the value of any bound property changes.
- Parameters:
- listener - The listener.
addVetoableChangeListener
public void addVetoableChangeListener(VetoableChangeListener listener)
- Adds a listener to be notified when the value of any constrained property changes.
- Parameters:
- listener - The listener.
clear
public void clear() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Removes all entries from the data queue.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
delete
public void delete() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Deletes the data queue.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
getCcsid
public int getCcsid()
- Returns the CCSID used for the data in this data queue.
- Returns:
- The CCSID used for the data in this data queue.
getDescription
public String getDescription() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Returns the text description of the data queue.
- Returns:
- The text description of the data queue.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
getForceToAuxiliaryStorage
public boolean getForceToAuxiliaryStorage() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Returns a value that indicates if entries are forced to auxiliary storage. If true, entries are immediately written to permanent storage. If false, written entries may be kept in memory and could be lost in the case of a power outage.
- Returns:
- true if entries are immediately written to permanent storage; false otherwise.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
getMaxEntryLength
public int getMaxEntryLength() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Returns the maximum entry length of the data queue.
- Returns:
- The maximum entry length of the data queue.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
getName
public String getName()
- Returns the name of the data queue.
- Returns:
- The data queue name.
getPath
public String getPath()
- Returns the full integrated file system path name of the data queue.
- Returns:
- The fully-qualified data queue name.
getSaveSenderInformation
public boolean getSaveSenderInformation() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Returns whether sender information is stored with each data queue entry.
- Returns:
- true if sender information is saved; false otherwise.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
getSystem
public AS400 getSystem()
- Returns the AS400 object representing the system on which the data queue exists.
- Returns:
- The system on which the data queue exists.
isFIFO
public boolean isFIFO() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Returns a value that indicates if entries are read in FIFO order. Returns true if entries are read off the data queue in FIFO order. Returns false if entries are read off the data queue in LIFO order.
- Returns:
- true if entries are read off the data queue in FIFO order; false otherwise.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
refreshAttributes
public void refreshAttributes() throws AS400SecurityException, ErrorCompletingRequestException, IOException, IllegalObjectTypeException, InterruptedException, ObjectDoesNotExistException
- Refreshes the attributes of the data queue.
- Throws: AS400SecurityException
- If a security or authority error occurs.
- Throws: ConnectionDroppedException
- If the connection is dropped unexpectedly.
- Throws: ErrorCompletingRequestException
- If an error occurs before the request is completed.
- Throws: IOException
- If an error occurs while communicating with the AS/400.
- Throws: IllegalObjectTypeException
- If the AS/400 object is not the required type.
- Throws: InterruptedException
- If this thread is interrupted.
- Throws: ObjectDoesNotExistException
- If the AS/400 object does not exist.
- Throws: ServerStartupException
- If the AS/400 server cannot be started.
- Throws: UnknownHostException
- If the AS/400 system cannot be located.
removeDataQueueListener
public void removeDataQueueListener(DataQueueListener listener)
- Removes a data queue listener.
- Parameters:
- listener - The listener.
removeObjectListener
public void removeObjectListener(ObjectListener listener)
- Removes a object listener.
- Parameters:
- listener - The listener.
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
- Removes a property change listener.
- Parameters:
- listener - The listener.
removeVetoableChangeListener
public void removeVetoableChangeListener(VetoableChangeListener listener)
- Removes a vetoable change listener.
- Parameters:
- listener - The listener.
setCcsid
public void setCcsid(int ccsid) throws PropertyVetoException
- Sets the CCSID to use for the data in this data queue.
- Parameters:
- ccsid - The CCSID to use for the data in this data queue.
- Throws: PropertyVetoException
- If the change is vetoed.
setPath
public void setPath(String path) throws PropertyVetoException
- Sets the fully qualified integrated file system path name of the data queue.
- Parameters:
- path - The fully qualified integrated file system path name of the data queue.
- Throws: PropertyVetoException
- If the change is vetoed.
setSystem
public void setSystem(AS400 system) throws PropertyVetoException
- Sets the system on which the data queue exists.
- Parameters:
- system - The AS/400 system on which the data queue exists.
- Throws: PropertyVetoException
- If the change is vetoed.
toString
public String toString()
- Returns the String representation of this data queue object.
- Returns:
- The String representation of this data queue object.
- Overrides:
- toString in class Object
All Packages Class Hierarchy This Package Previous Next Index