examples.application
Class Example6
java.lang.Object
|
+--com.ibm.mqe.MQe
|
+--examples.application.ExampleBase
|
+--examples.application.Example6
- All Implemented Interfaces:
- MQeExceptionCodes
- public class Example6
- extends ExampleBase
Extends ExampleBase, Application example base.
Synchronous assured message delivery example.
Example showing how to:
. start a queue manager
. put a message using assured message delivery
. retrieve that message using assured message delivery
Notes:
- This example shows the use of assured message delivery with
queues that are defined as synchronous. Asynchronous queues
provide assured message delivery automatically.
- To be able to provide assured message delivery, a queue must
be defined with a persistent queue store (such as disk). This
allows the message to be recovered after a system restart.
- When an applicaiton uses assured delivery, the application should
ensure that it can cope with a system failure during the delivery
operation. This may mean the application storing delivery state
information which can be used across restarts. This example does
not do this but sets a message expiry so that any half delivered
messages are removed from the queue after the expiry time.
Field Summary |
static short[] |
version
|
Fields inherited from class com.ibm.mqe.MQe |
Admin_Queue_Name, Admin_Reply_Queue_Name, copyright, DeadLetter_Queue_Name, Event_Activate, Event_Attribute, Event_Authenticate, Event_Close, Event_Logoff, Event_Logon, Event_MiniCert_Validate, Event_Queue, Event_QueueManager, Event_UserBase, JMS_Version, MQ_Headers, MQe_Log_Audit_Failure, MQe_Log_Audit_Success, MQe_Log_Error, MQe_Log_Information, MQe_Log_Success, MQe_Log_Warning, Msg_BackoutCount, Msg_CorrelID, Msg_ExpireTime, Msg_LockID, Msg_MsgID, Msg_OriginQMgr, Msg_Priority, Msg_ReplyToQ, Msg_ReplyToQMgr, Msg_Resend, Msg_Style, Msg_Style_Datagram, Msg_Style_Reply, Msg_Style_Request, Msg_Time, Msg_WrapMsg, sccsid, System_Default_Queue_Name |
Fields inherited from interface com.ibm.mqe.MQeExceptionCodes |
Except_Active, Except_AdapterException, Except_AdapterMissingRemoteAddress, Except_Admin_ActionNotSupported, Except_Admin_InvalidField, Except_Admin_NotAdminMsg, Except_AdminAction, Except_Authenticate, Except_BadRequest, Except_BridgeListener, Except_Chnl_Attributes, Except_Chnl_ID, Except_Chnl_Limit, Except_Chnl_Overrun, Except_Closed, Except_Con_AdapterRequired, Except_Con_AliasAlreadyExists, Except_Con_AlreadyExists, Except_Con_InvalidName, Except_Connect_Failure, Except_ConnectonType, Except_Cryptor, Except_Data, Except_Duplicate, Except_JmxProperties, Except_Listener, Except_MessageStore, Except_MiniCertReg_ActivateFailed, Except_MiniCertReg_BadPIN, Except_MiniCertReg_NotOpen, Except_NotActive, Except_NotAllowed, Except_NotFound, Except_NotSupported, Except_PrivateReg_ActivateFailed, Except_PrivateReg_BadPIN, Except_PrivateReg_NotOpen, Except_PublicReg_ActivateFailed, Except_PublicReg_InvalidAddress, Except_PublicReg_InvalidRequest, Except_Q_Full, Except_Q_InvalidName, Except_Q_InvalidPriority, Except_Q_MsgTooLarge, Except_Q_NoMatchingMsg, Except_Q_TargetRegistryRequired, Except_QMgr_Activated, Except_QMgr_AlreadyExists, Except_QMgr_InvalidQMgrName, Except_QMgr_InvalidQName, Except_QMgr_NotActive, Except_QMgr_NotBridgeEnabled, Except_QMgr_NotConfigured, Except_QMgr_QDoesNotExist, Except_QMgr_QExists, Except_QMgr_QNotEmpty, Except_QMgr_RegistryDataVersion, Except_QMgr_UnknownQMgr, Except_QMgr_WrongQType, Except_Reg_AddFailed, Except_Reg_AlreadyExists, Except_Reg_AlreadyOpen, Except_Reg_CRTKeyDecFailed, Except_Reg_CRTKeySignFailed, Except_Reg_DeleteFailed, Except_Reg_DeleteRegistryFailed, Except_Reg_DoesNotExist, Except_Reg_InvalidSession, Except_Reg_ListFailed, Except_Reg_NotDefined, Except_Reg_NotSecure, Except_Reg_NullName, Except_Reg_OpenFailed, Except_Reg_ReadFailed, Except_Reg_RenameFailed, Except_Reg_ResetPINFailed, Except_Reg_SearchFailed, Except_Reg_UpdateFailed, Except_RemoteException, Except_Rule, Except_S_BadIntegrity, Except_S_BadSubject, Except_S_CertificateExpired, Except_S_Cipher, Except_S_InvalidAttribute, Except_S_InvalidSignature, Except_S_MiniCertNotAvailable, Except_S_MissingSection, Except_S_NoPresetKeyAvailable, Except_S_RegistryNotAvailable, Except_Stopped, Except_Syntax, Except_TimeOut, Except_Transporter, Except_TriggerTransmission, Except_Trnsport_QMgr, Except_Trnsport_Request, Except_Type, Except_UdpipAdapterStateException, Except_UdpipAdapterTimeOut, Except_UdpipAdapterUnableToConfirmSuccess, Except_UnCoded, Except_Uncontactable_DontTransmit |
Constructor Summary |
Example6()
Constructor that uses the default queue manager. |
Example6(java.lang.String queueManagerName)
Constructor that uses the queue manager passed in on the command line. |
Example6(java.lang.String qMgrName,
java.lang.String localQMgrIniFile)
Constructor that starts a queue manager with paramters
from an ini file. |
Methods inherited from class com.ibm.mqe.MQe |
abbreviate, alias, asciiToByte, byteToAscii, byteToHex, byteToHex, byteToInt, byteToLong, byteToShort, byteToUnicode, fileSeparator, getEventLogHandler, hexToAscii, hexToByte, intToByte, isCLDC, loadClass, loadObject, log, setEventLogHandler, setLoader, sliceByteArray, type, unicodeToByte, uniqueValue |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
version
public static short[] version
Example6
public Example6()
throws java.lang.Exception
- Constructor that uses the default queue manager.
- Throws:
java.lang.Exception
Example6
public Example6(java.lang.String queueManagerName)
throws java.lang.Exception
- Constructor that uses the queue manager passed in on the command line.
- Parameters:
queueManagerName
- java.lang.String
- Throws:
java.lang.Exception
Example6
public Example6(java.lang.String qMgrName,
java.lang.String localQMgrIniFile)
throws java.lang.Exception
- Constructor that starts a queue manager with paramters
from an ini file. This queue manager is then used as the
access point for interacting with the same or different
queue managers.
- Parameters:
qMgrName
- java.lang.String, queue manager name,
the name of the queue manager to interact with.
The queue manager can be a local or a remote queue
manager.localQMgrIniFile
- java.lang.String, ini file which
contains startup parameters for the local queue
manager.
- Throws:
java.lang.Exception
doIt
public void doIt()
throws java.lang.Exception
- All work is performed in this method.
- Specified by:
doIt
in class ExampleBase
- Returns:
- void
- Throws:
java.lang.Exception
getMessage
public MQeMsgObject getMessage(MQeFields filter)
throws java.lang.Exception
- Get a message and confirm it.
- Parameters:
filter
- An MQeFields Object
- Returns:
- An MQeMsgObject or null.
- Throws:
java.lang.Exception
main
public static void main(java.lang.String[] args)
throws java.lang.Exception
- Starts the application.
- Returns:
- void
- Throws:
java.lang.Exception
putMessage
public boolean putMessage(MQeMsgObject msgObj)
throws java.lang.Exception
- Put a message and confirm it.
- Parameters:
msgObj
- An MQeMsgObject
- Returns:
- Boolean True if put operation is successful. False, otherwise.
- Throws:
java.lang.Exception
setParms
public void setParms()
- Over-ride default parameter settings.
- Specified by:
setParms
in class ExampleBase