Part of the identity context of the message; it allows an application to charge for work done as a result of the message.
The default value is MQC.MQACT_NONE.
Part of the identity context of the message; it is information that is defined by the application suite, and can be used to provide additional information about the message or its originator.
The default value is "".
Information defined by the application that can be used to provide additional information about the origin of the message.
The default value is "".
A count of the number of times the message has previously been returned by an MQQueue.Get() call as part of a unit of work, and subsequently backed out.
The default value is zero.
The coded character set identifier of character data in the application message data. The behavior of the ReadString, ReadLine, and WriteString methods is altered accordingly.
The default value for this field is MQC.MQCCSI_Q_MGR. If the default value is used, CharacterSet 1200 (Unicode) is assumed. The following table shows coded character set identifiers and the characterSet values to use:
characterSet | Description |
---|---|
37 | ibm037 |
437 | ibm437 / PC Original |
500 | ibm500 |
819 | iso-8859-1 / latin1 / ibm819 |
1200 | Unicode |
1208 | UTF-8 |
273 | ibm273 |
277 | ibm277 |
278 | ibm278 |
280 | ibm280 |
284 | ibm284 |
285 | ibm285 |
297 | ibm297 |
420 | ibm420 |
424 | ibm424 |
737 | ibm737 / PC Greek |
775 | ibm775 / PC Baltic |
813 | iso-8859-7 / greek / ibm813 |
838 | ibm838 |
850 | ibm850 / PC Latin 1 |
852 | ibm852 / PC Latin 2 |
855 | ibm855 / PC Cyrillic |
856 | ibm856 |
857 | ibm857 / PC Turkish |
860 | ibm860 / PC Portuguese |
861 | ibm861 / PC Icelandic |
862 | ibm862 / PC Hebrew |
863 | ibm863 / PC Canadian French |
864 | ibm864 / PC Arabic |
865 | ibm865 / PC Nordic |
866 | ibm866 / PC Russian |
868 | ibm868 |
869 | ibm869 / PC Modern Greek |
870 | ibm870 |
871 | ibm871 |
874 | ibm874 |
875 | ibm875 |
912 | iso-8859-2 / latin2 / ibm912 |
913 | iso-8859-3 / latin3 / ibm913 |
914 | iso-8859-4 / latin4 / ibm914 |
915 | iso-8859-5 / cyrillic / ibm915 |
916 | iso-8859-8 / hebrew / ibm916 |
918 | ibm918 |
920 | iso-8859-9 / latin5 / ibm920 |
921 | ibm921 |
922 | ibm922 |
930 | ibm930 |
932 | PC Japanese |
933 | ibm933 |
935 | ibm935 |
937 | ibm937 |
939 | ibm939 |
942 | ibm942 |
948 | ibm948 |
949 | ibm949 |
950 | ibm950 / Big 5 Traditional Chinese |
954 | EUCJIS |
964 | ibm964 / CNS 11643 Traditional Chinese |
970 | ibm970 |
1006 | ibm1006 |
1025 | ibm1025 |
1026 | ibm1026 |
1089 | iso-8859-6 / arabic / ibm1089 |
1097 | ibm1097 |
1098 | ibm1098 |
1112 | ibm1112 |
1122 | ibm1122 |
1123 | ibm1123 |
1124 | ibm1124 |
1250 | Windows(R) Latin 2 |
1251 | Windows Cyrillic |
1252 | Windows Latin 1 |
1253 | Windows Greek |
1254 | Windows Turkish |
1255 | Windows Hebrew |
1256 | Windows Arabic |
1257 | Windows Baltic |
1258 | Windows Vietnamese |
1381 | ibm1381 |
1383 | ibm1383 |
2022 | JIS |
5601 | ksc-5601 Korean |
33722 | ibm33722 |
For an MQQueue.Get() call, the correlation identifier of the message to be retrieved. Normally the queue manager returns the first message with a message identifier and correlation identifier that match those specified. The special value MQC.MQCI_NONE allows any correlation identifier to match.
For an MQQueue.Put() call, this specifies the correlation identifier to use.
The default value is MQC.MQCI_NONE.
The number of bytes of message data remaining to be read.
The current cursor position within the message data (the point at which read and write operations take effect).
The representation used for numeric values in the application message data; this applies to binary, packed decimal, and floating point data. The behavior of the read and write methods for these numeric formats is altered accordingly.
The following encodings are defined for binary integers:
The following encodings are defined for packed-decimal integers:
The following encodings are defined for floating-point numbers:
Construct a value for the encoding field by adding together one value from each of these three sections (or using the bitwise OR operator). The default value is:
MQC.MQENC_INTEGER_NORMAL | MQC.MQENC_DECIMAL_NORMAL | MQC.MQENC_FLOAT_IEEE_NORMAL
For convenience, this value is also represented by MQC.MQENC_NATIVE. This setting causes WriteInt() to write a big-endian integer, and ReadInt() to read a big-endian integer. If you set the flag MQC.MQENC_INTEGER_REVERSED flag instead, WriteInt() writes a little-endian integer, and ReadInt() reads a little-endian integer.
A loss in precision can occur when converting from IEEE format floating points to zSeries(R) format floating points.
An expiry time expressed in tenths of a second, set by the application that puts the message. After a message's expiry time has elapsed, it is eligible to be discarded by the queue manager. If the message specified one of the MQC.MQRO_EXPIRATION flags, a report is generated when the message is discarded.
The default value is MQC.MQEI_UNLIMITED, meaning that the message never expires.
Used with a message of type MQC.MQMT_REPORT to indicate the nature of the report. The following feedback codes are defined by the system:
Application-defined feedback values in the range MQC.MQFB_APPL_FIRST to MQC.MQFB_APPL_LAST can also be used.
The default value of this field is MQC.MQFB_NONE, indicating that no feedback is provided.
A format name used by the sender of the message to indicate the nature of the data in the message to the receiver. You can use your own format names, but names beginning with the letters MQ have meanings that are defined by the queue manager. The queue manager built-in formats are:
The default value is MQC.MQFMT_NONE.
A byte string that identifies the message group to which the physical message belongs.
The default value is MQC.MQGI_NONE.
Flags controlling the segmentation and status of a message.
For an MQQueue.Get() call, this field specifies the message identifier of the message to be retrieved. Normally, the queue manager returns the first message with a message identifier and correlation identifier that match those specified. The special value MQC.MQMI_NONE allows any message identifier to match.
For an MQQueue.Put() call, this specifies the message identifier to use. If MQC.MQMI_NONE is specified, the queue manager generates a unique message identifier when the message is put. The value of this member variable is updated after the put, to indicate the message identifier that was used.
The default value is MQC.MQMI_NONE.
The number of bytes of message data in the MQMessage object.
The sequence number of a logical message within a group.
Indicates the type of the message. The following values are currently defined by the system:
Application-defined values can also be used, in the range MQC.MQMT_APPL_FIRST to MQC.MQMT_APPL_LAST.
The default value of this field is MQC.MQMT_DATAGRAM.
In a segmented message, the offset of data in a physical message from the start of a logical message.
The original length of a segmented message.
Message persistence. The following values are defined:
The default value is MQC.MQPER_PERSISTENCE_AS_Q_DEF, which takes the persistence for the message from the default persistence attribute of the destination queue.
The message priority. The special value MQC.MQPRI_PRIORITY_AS_Q_DEF can also be set in outbound messages, in which case the priority for the message is taken from the default priority attribute of the destination queue.
The default value is MQC.MQPRI_PRIORITY_AS_Q_DEF.
The name of the application that put the message. The default value is "".
The type of application that put the message. This can be a system-defined or user-defined value. The following values are defined by the system:
The default value is the special value MQC.MQAT_NO_CONTEXT, which indicates that no context information is present in the message.
The time and date that the message was put.
The name of the queue manager to which reply or report messages should be sent.
The default value is "".
If the value is "" on an MQQueue.put() call, the QueueManager fills in the value.
The name of the message queue to which the application that issued the get request for the message should send MQC.MQMT_REPLY and MQC.MQMT_REPORT messages.
The default value is "".
A report is a message about another message. This member variable enables the application sending the original message to specify which report messages are required, whether the application message data is to be included in them, and how to set the message and correlation identifiers in the report or reply. Any, all, or none of the following report types can be requested:
For each type, only one of the three corresponding values below should be specified, depending on whether the application message data is to be included in the report message.
The valid values are:
You can specify one of the following to control how the message Id is generated for the report or reply message:
You can specify one of the following to control how the correlation Id of the report or reply message is to be set:
You can specify one of the following to control the disposition of the original message when it cannot be delivered to the destination queue:
If no report options are specified, the default is:
MQC.MQRO_NEW_MSG_ID | MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID | MQC.MQRO_DEAD_LETTER_Q
You can specify one or both of the following to request that the receiving application sends a positive action or negative action report message.
The total number of bytes in the message as stored on the message queue from which this message was received.
Part of the identity context of the message; it identifies the user that originated this message.
The default value is "".
The version of the MQMD structure in use.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzav0457 |