|
Websphere MQ Everyplace | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.ibm.mqe.MQe | +--com.ibm.mqe.MQeFields | +--com.ibm.mqe.MQeMsgObject | +--com.ibm.mqe.MQeAdminMsg | +--com.ibm.mqe.administration.MQeQueueAdminMsg | +--com.ibm.mqe.administration.MQeRemoteQueueAdminMsg | +--com.ibm.mqe.administration.MQeHomeServerQueueAdminMsg
This class is used to manage Websphere MQ Everyplace home server queues.
The class extends MQeRemoteQueueAdminMsg
which
provides most of the administration capability for remote queues. This class adds
additional actions and features for managing home server queues.
A home-server queue definition identifies a store-and-forward queue on a remote queue manager.The home-server queue then pulls any messages that are destined for the home-server queue’s local queue manager, off the store-and-forward queue. Multiple home-server queue definitions may be defined on a single queue manager, where each one is associated with a different remote queue manager.
Home-server queues normally reside on a device and are typically set to pull messages from a server whenever the device connects to the network. When a message is pulled from the server, the message is then put on the correct target local queue. If the target queue does not exist then a rule is called which allows the message to be placed on a dead letter queue.
A home server queue can be requested to check for pending messages by:
Queue_QTimerInterval
that causes
a regular check for messages on the server whilst connectivity is available.
When network connectivity is not available or a network outage occurs
the polling will stop and not restart until the queue is triggered using the
MQeQueueManager.triggerTransmission()
method.
MQeQueueManager.triggerTransmission()
method
is called.
User replaceable rules can be used to control whether the home server queue is allowed to check for pending messages.
Home-server queues have an important role in enabling devices to receive messages over client-server channels particularly in environments where it is not possible for a server to establish a connection to a device.
For information on basic administration concepts see MQeAdminMsg
and for basic information on managing queues see
MQeQueueAdminMsg
and
MQeRemoteQueueAdminMsg
.
Field Summary | |
static java.lang.String |
Queue_QTimerInterval
String used to identify the field in the message representing the poll time interval. |
Fields inherited from class com.ibm.mqe.administration.MQeRemoteQueueAdminMsg |
Queue_CloseIdle, Queue_DefaultTransporter, Queue_Transporter, Queue_TransporterXOR |
Fields inherited from class com.ibm.mqe.administration.MQeQueueAdminMsg |
Queue_Active, Queue_Asynchronous, Queue_AttrRule, Queue_Authenticator, Queue_Compressor, Queue_CreationDate, Queue_Cryptor, Queue_CurrentSize, Queue_Description, Queue_Expiry, Queue_FileDesc, Queue_MaxMsgSize, Queue_MaxQSize, Queue_Mode, Queue_NoLimit, Queue_Priority, Queue_QAliasNameList, Queue_QMgrName, Queue_RegistryNone, Queue_RegistryQMgr, Queue_RegistryQueue, Queue_Rule, Queue_Synchronous, Queue_TargetRegistry |
Fields inherited from class com.ibm.mqe.MQeAdminMsg |
Action_AddAlias, Action_Create, Action_Delete, Action_Inquire, Action_InquireAll, Action_RemoveAlias, Action_Start, Action_Stop, Action_Unknown, Action_Update, Admin_Action, Admin_Class, Admin_Errors, Admin_MaxAttempts, Admin_Name, Admin_Parms, Admin_RC, Admin_Reason, Admin_TargetQMgr, RC_Fail, RC_Mixed, RC_Success |
Fields inherited from class com.ibm.mqe.MQeFields |
ArraySeparator, TypeArrayElements, TypeAscii, TypeBoolean, TypeByte, TypeDouble, TypeFields, TypeFloat, TypeInt, TypeLong, TypeShort, TypeUnicode, TypeUnTyped |
Constructor Summary | |
MQeHomeServerQueueAdminMsg()
Default constructor. |
|
MQeHomeServerQueueAdminMsg(java.lang.String qMgrName,
java.lang.String qName)
This constructor takes the name of the queue that is to be managed and puts it into the admin msg. |
Methods inherited from class com.ibm.mqe.administration.MQeQueueAdminMsg |
addAlias, changeAlias, removeAlias, setName |
Methods inherited from class com.ibm.mqe.MQeAdminMsg |
characteristics, create, delete, duplicate, getAction, getErrorFields, getFieldInError, getInputFields, getMaxAttempts, getName, getOutputFields, getRC, getReason, getTargetQMgr, inquire, inquireAll, setAction, setMaxAttempts, setName, setTargetQMgr, update |
Methods inherited from class com.ibm.mqe.MQeMsgObject |
getMsgUIDFields, getOriginQMgr, getTimeStamp, putOriginQMgr, resetMsgUIDFields, unwrapMsgObject |
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, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final java.lang.String Queue_QTimerInterval
Setting a poll interval in causes check every n milliseconds for
messages on the server whilst connectivity is available. When network
connectivity is not available or a network outage occurs the polling will
stop and not restart until the queue is triggered using the
MQeQueueManager.triggerTransmission()
method.
The default is 0 which means that the home server queue will not poll.
The field is of type long.
Constructor Detail |
public MQeHomeServerQueueAdminMsg() throws java.lang.Exception
public MQeHomeServerQueueAdminMsg(java.lang.String qMgrName, java.lang.String qName) throws java.lang.Exception
This constructor uses the MQeQueueAdminMsg.setName(String,String)
method to
put the name into the administratoin message parameters field
qMgrName
- name of the target queue managerqName
- name of the Queue
java.lang.Exception
MQeQueueAdminMsg.setName(String, String)
|
Websphere MQ Everyplace | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |