Question & Answer
Question
Why can't I use the BROWSE MQGET option on "Get Message Options" in MQ FSH? IBM MQ server returns 2036 error (MQRC_NOT_OPEN_FOR_BROWSE).
Cause
The format of "Get Message Option" must be a cumulative value of MQGET options in decimal or hexadecimal format and "Get Message Options" in DataPower MQ FSH does not support Browse functionality. Thus the MQ server returns a 2036 error.
Answer
So how to use the Get Message Option in DataPower MQ Front Side Handler?
The format of "Get Message Option" must be a value in decimal or hexadecimal format and this is a cumulative value of MQGET options.
The format of "Get Message Option" must be a value in decimal or hexadecimal format and this is a cumulative value of MQGET options.
The default value is 1, which means the user wants to use MQGMO_WAIT.
Another example could be a value of 4097, which means the user wants to use MQGMO_WAIT and MQGMO_SYNCPOINT_IF_PERSISTENT options because MQGMO_WAIT is 1 and MQGMO_SYNCPOINT_IF_PERSISTENT is 4096.
Refer to the "MQGMO_* (Get message options and structure)" topic in the "Constants" section of the IBM MQ Knowledge Center for details.
DataPower MQ Front Side Handler (FSH) does not support BROWSE MQGET option in Get Message Options (GMO)
DataPower MQ Frontside, as a specialized MQ client, only implements a set of features defined by MQ Server, which is appropriate for the target use cases and confines to the users to the subset features.
Take MQ Browse function as an example,
MQ Browse function has to be performed on the same MQ context, or it will always browse the first message. For each transaction, DataPower MQ FSH will have a new MQ context to get the message back. Therefore, using Browse in MQ FSH will only browse the first message and is not suitable for DataPower MQ Front Side Handler.
Workaround: Use the mq-queue-depth() and "Browse" attribute of MQ url-open.
For more information and example on the mq-queue-depth() and Browse attribute of url-open (MQ URLs) extension function, refer to the Extension elements and functions documentation, which can be found from the Reference section in the IBM DataPower Gateways Knowledge Center site.
Refer to the "MQGMO_* (Get message options and structure)" topic in the "Constants" section of the IBM MQ Knowledge Center for details.
DataPower MQ Front Side Handler (FSH) does not support BROWSE MQGET option in Get Message Options (GMO)
DataPower MQ Frontside, as a specialized MQ client, only implements a set of features defined by MQ Server, which is appropriate for the target use cases and confines to the users to the subset features.
Take MQ Browse function as an example,
MQ Browse function has to be performed on the same MQ context, or it will always browse the first message. For each transaction, DataPower MQ FSH will have a new MQ context to get the message back. Therefore, using Browse in MQ FSH will only browse the first message and is not suitable for DataPower MQ Front Side Handler.
Workaround: Use the mq-queue-depth() and "Browse" attribute of MQ url-open.
For more information and example on the mq-queue-depth() and Browse attribute of url-open (MQ URLs) extension function, refer to the Extension elements and functions documentation, which can be found from the Reference section in the IBM DataPower Gateways Knowledge Center site.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS9H2Y","label":"IBM DataPower Gateway"},"ARM Category":[{"code":"a8m50000000CdwvAAC","label":"DataPower->Messaging \/ File Transfer (MT)->MQ"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
08 June 2021
UID
swg21422886