ChannelMode Property

What mode the channel is operating in.

Syntax

ANSI (Cross Platform)
int GetChannelMode(int iChannelIndex);

Unicode (Windows)
INT GetChannelMode(INT iChannelIndex);

Possible Values

CMT_NORMAL(0), 
CMT_TRANSACTIONAL(1),
CMT_PUBLISH_CONFIRMS(2)
- (int)channelMode:(int)channelIndex;

Possible Values

CMT_NORMAL(0), 
CMT_TRANSACTIONAL(1),
CMT_PUBLISH_CONFIRMS(2)
#define PID_AMQPCLASSIC_CHANNELMODE 8

IPWORKSMQ_EXTERNAL void* IPWORKSMQ_CALL IPWorksMQ_AMQPClassic_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);

IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_AMQPClassic_CheckIndex(void *lpObj, int propid, int arridx);

Default Value

0

Remarks

What mode the channel is operating in.

This property reflects what mode the channel is operating in. Possible values are:

  • cmtNormal (0 - default): Normal mode.
  • cmtTransactional (1): Transaction mode.
  • cmtPublishConfirms (2): Publish confirmations mode.

All channels are in normal mode when they are created; there's nothing special about a channel in normal mode.

Channels can be put in transaction mode using the EnableTransactionMode method. While a channel is in transaction mode, all messages published and acknowledgements sent over it will be part of a transaction, and the server will wait to process them until the transaction is either committed or rolled back.

Channels can be put in publish confirmations mode using the EnablePublishConfirms method. While a channel is in publish confirmations mode, the server will acknowledge each message published by the class. The class will wait to fire the MessageOut event until it receives this acknowledgement. (Note that this mode is only available when the RabbitMQCompatible configuration setting is enabled.)

Note: Switching a channel to transaction or publish confirmations mode is a permanent action; the channel will then remain in that mode for the remainder of its lifetime.

The ChannelIndex parameter specifies the index of the item in the array. The size of the array is controlled by the ChannelCount property.

This property is read-only and not available at design time.

Data Type

Integer

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks MQ 2020 C++ Edition - Version 20.0 [Build 8155]