3.17.4.1.13 Journal (Opnum 19)

  • Article

The Journal method is received by the server in an RPC_REQUEST packet. In response, the server MUST return a flag combining the represented Message.PositiveJournalingRequested and Message.NegativeJournalingRequested properties.

 [propget] HRESULT Journal(
   [out, retval] long* plJournal
 );

plJournal: A pointer to a long integer that identifies the journaling setting for the message. This parameter corresponds to the MQMSGJOURNAL (section 2.2.2.12) enum.

Return Values: The method MUST return S_OK (0x00000000) on success or an implementation-specific error HRESULT on failure.

When processing this call, the server MUST follow these guidelines:

  • Define posJournalRequested as MQMSG_JOURNAL_NONE.

  • If the represented Message.PositiveJournalingRequested is equal to True:

    • Set posJournalRequested equal to MQMSG_JOURNAL.

  • Define negJournalRequested as MQMSG_JOURNAL_NONE.

  • If the represented Message.NegativeJournalingRequested is equal to True:

    • Set negJournalRequested equal to MQMSG_DEADLETTER.

  • Set the plJournal output parameter to the value of (posJournalRequested | negJournalRequested).